Dwarf Fortress Wiki - User contributions [en]

Talk:Weapon

2025-12-07T01:00:05Z

DikbutDaGrate: /* Combat Formulae - What is "min"? */ new section

== Quality and its effects ==
In the section [[Weapon#Quality_and_strange_moods|Quality and strange moods]] it is mentioned that quality affects sharpness (base quality has "50%" sharpness, for example). I can't find any source for that, and it's a bit confusing. Later, on the [[Weapon#Combat_formulae|Combat formulae]] section, that sharpness percentage is no longer used. In that section, I interpret that the used value is the raws number (divided by 10.000) and the weapon quality multiplier. If my understanding is correct, then either the sharpness % is not used (in which case I don't know why it would be there) or there is something missing to understand it correctly. --[[User:Jose96xd|Jose96xd]] ([[User talk:Jose96xd|talk]]) 14:10, 24 October 2024 (UTC)
:The "source" for weapon quality affecting sharpness is an analysis of the game's code - all weapons (and ammo, siege ammo, trap components, tools, and small rocks) have a "current_edge" property, and it's initialized to 50-100% of the material's MAX_EDGE based on its quality level. Exactly how that sharpness works into the damage formula, I don't know. --[[User:Quietust|Quietust]] ([[User talk:Quietust|talk]]) 01:53, 25 October 2024 (UTC)
:It's in the second formula as "Sha * w_quality", though it looks to me like the explanation for w_quality should use the percentages instead of the multipliers.[[User:Ziusudra|Ziusudra]] ([[User talk:Ziusudra|talk]]) 02:04, 25 October 2024 (UTC)
:That actually makes sense since the multipliers it mentions currently (x1 base quality, x3 artifact) seem to be about the probability to hit. I have programmed the formulas and can easily change stuff and will try to gather experimental data. --[[User:Jose96xd|Jose96xd]] ([[User talk:Jose96xd|talk]]) 07:41, 25 October 2024 (UTC)
:I have run some tests. With base-quality iron spears, math using the current weapon quality (x1 base quality, x3 artifact) should penetrate steel armor, but it doesn't. If we use the sharp quality multiplier (50% base quality, 100% artifact), the results of the experiments and the math match. I believe that's the proper number to use in the formula. I'm going to change this page and the material science page (since the formula comes from there). If there is any other place that also uses this formula (with the x1, x3 rather than the %) it should be changed too. --[[User:Jose96xd|Jose96xd]] ([[User talk:Jose96xd|talk]]) 10:19, 25 October 2024 (UTC)
::Be careful when changing the formulas - your latest modification actually '''changes the numerical result''', which means it might be incorrect now. --[[User:Quietust|Quietust]] ([[User talk:Quietust|talk]]) 12:52, 25 October 2024 (UTC)
::I don't think I follow. There is no section with numerical results for the edge condition, so I don't know what you mean. The previous formula (or at least my implementation of it) didn't match the experimental results, and it didn't make logical sense for the "hit chance" to be the one multiplying the sharpness of the material (basically, before the sharpness % weren't used anywhere). --[[User:Jose96xd|Jose96xd]] ([[User talk:Jose96xd|talk]]) 13:09, 25 October 2024 (UTC)

== Combat Formulae - What is "min"? ==

Under projectile math, "min" is not addressed in the listing out all of the combat math variables, and it is unclear what it represents.

Great pick/raw

2025-12-07T00:34:17Z

DikbutDaGrate: Added raws for Great Pick

[ITEM_WEAPON:ITEM_WEAPON_PICK_GREAT]
[NAME:great pick:great picks]
[SIZE:4000]
[SKILL:MINING]
[TWO_HANDED:275000]
[MINIMUM_SIZE:225000]
[MATERIAL_SIZE:12]
[ATTACK:EDGE:100:4000:strike:strikes:NO_SUB:2000]
[ATTACK_PREPARE_AND_RECOVER:3:3]

Creature token

2025-11-21T02:43:09Z

DikbutDaGrate: Update NIGHT_CREATURE token description

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

The <code>[OBJECT:CREATURE]</code> [[token]] begins the definition of a ''Dwarf Fortress'' [[creature]] [[raw file]]. Each creature definition that follows begins with the {{token|creature|c|creature ID}} token, and the creature's exact properties and behavior are then specified by the use of further creature tokens. All known creature tokens are listed below.

Vanilla creature definitions can be found in <code>[[Game folder|<Dwarf Fortress>]]\data\vanilla\vanilla_creatures\</code>.
Creature ID is also used with [[graphics token]]s to make customizable [[graphics set]]s.

The [[caste]] tokens allow defining sub-species within the broader creature definition, including true biological castes and lesser variations, such as sexes. Creature tokens can either be 'Creature' or 'CASTE-only' type which can only be applied to creature or caste respectively, or 'CASTE' which can be applied to both. In the table bellow, creature type distinguishes tokens that can be applied to creature only, caste only, and both ('creature', 'CASTE-only', and 'CASTE' respectively)

__NOTOC__
{{clear}}
{{alphabetical TOC|style=margin: 1em auto;}}

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

|-
| {{text anchor|ADOPTS_OWNER}}
| Caste
|
| Prevents the tamed creature from being made available for adoption, instead allowing it to automatically adopt whoever it wants. The basic requirements for adoption are intact, and the creature will only adopt individuals who have a [[preference]] for their species. Used by [[cat]]s in the vanilla game. When {{k|v}}iewing a tame creature with this token, the message "This animal isn't interested in your wishes" will appear instead of "This [adorable] animal can't work" or "This animal is waiting to be trained".

|-
| {{text anchor|ALCOHOL_DEPENDENT}}
| Caste
|
| Makes the creature need [[alcohol]] to get through the working day; it will choose to drink booze instead of [[water]] if possible. Going sober for too long reduces speed.

|-
| {{text anchor|ALL_ACTIVE}}
| Caste
|
| When set, the creature will appear at any time of day. Overrides {{token|DIURNAL|c}}, {{token|NOCTURNAL|c}}, {{token|CREPUSCULAR|c}}, {{token|MATUTINAL|c}}, and {{token|VESPERTINE|c}}.

|-
| {{text anchor|ALTTILE}}
| Creature
|
*'character' or tile number
| If set, the creature will blink between its {{token|TILE|c}} and its ALTTILE.

|-
| {{text anchor|AMBUSHPREDATOR}}
| Caste
|
| Makes the creature start out hidden and remain near its original location until its prey draws near. When combined with {{token|WEBBER|c}}, causes them to lay gigantic webs near their spawn location, though only for creatures present during embark.

|-
| {{text anchor|AMPHIBIOUS}}
| Caste
|
| Allows a creature to breathe both in and out of [[water]] (unlike {{token|AQUATIC|c}}) - does not prevent drowning in [[magma]].

|-
| {{text anchor|APP_MOD_DESC_RANGE}}
| Appearance Modifier
|
*Range (6 values, low to high)
| Based on info from [http://www.bay12forums.com/smf/index.php?topic=113762.msg3473069#msg3473069 Wannabehero on the forums]: When used with an appearance modifier token (BP_APPEARANCE_MODIFIER or BODY_APPEARANCE_MODIFIER), tells the game what numeric ranges to map to which descriptors.

The game uses 7 descriptor levels for each modifier, with the center one generally being to omit the thing from the creature description entirely. The six values in APP_MOD_DESC_RANGE define the boundaries between each described range. If this is not specified it uses the numbers 10:50:95:105:150:190.

|-
| {{text anchor|APP_MOD_GENETIC_MODEL}}
| Appearance Modifier
|
*Model (Accepts DOMINANT_MORE, DOMINANT_LESS, and MIX)
| Defines a genetic model for the relevant appearance modifier(s). May or may not do anything significant at present.

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

|-
| {{text anchor|APP_MOD_NOUN}}
| Appearance Modifier
|
*noun
*SINGULAR or PLURAL
| Creates a noun for the appearance, and whether it is singular or plural.

|-
| {{text anchor|APP_MOD_RATE}}
| Appearance Modifier
|
*Rate (integer)
*Scale (DAILY, YEARLY)
*min (growth)
*max (growth)
*start year
*start day
*end year
*end day
| Setting the growth rate of the modifier. The last two tokens can be replaced by NO_END to have growth continue indefinitely.

|-
| {{text anchor|APPLY_CREATURE_VARIATION}}
| Caste
|
*creature variation ID
*(optional) any amount of arbitrary arguments
| Applies the specified [[creature variation token|creature variation]]. See [[Creature_variation_token#Arguments_and_conditional_tokens]] for how the subsequent arguments may be used.

|-
| {{text anchor|APPLY_CURRENT_CREATURE_VARIATION}}
| Special
|
| Applies the effects of all pending {{token|CV_ADD_TAG|c}} and {{token|CV_REMOVE_TAG|c}} tokens that have been defined in the current creature.

|-
| {{text anchor|AQUATIC}}
| Caste
|
| Enables the creature to breathe in water, but causes it to air-drown on dry land.

|-
| {{text anchor|ARENA_RESTRICTED}}
| Caste
|
| Causes the creature to be excluded from the [[object testing arena]]'s creature spawning list. Typically applied to spoileriffic creatures.

|-
| {{text anchor|ARTIFICIAL_HIVEABLE}}
| Creature
|
| Enables the creature to be kept in artificial [[hive]]s by [[beekeeper]]s.

|-
| {{text anchor|AT_PEACE_WITH_WILDLIFE}}
| Caste
|
| Prevents the creature from attacking or frightening creatures with the {{Token|NATURAL|c}} tag.

|-
| {{text anchor|ATTACK}}
| Caste
|
*token
*selection criteria (it's complicated)
| Defines the attack name, and the body part used. See [[#Attack Tokens|below]] for valid subtokens
'''Example:''' 
<code>[ATTACK:GORE:BODYPART:BY_CATEGORY:HORN]</code> 
''GORE'' = name of the attack 
''BODYPART:BY_CATEGORY:HORN'' = the horn is used to attack (presuming the creature has one)

|-
| {{text anchor|ATTACK_TRIGGER}}
| Caste
|
*population
*exported wealth
*created wealth
| Specifies when a [[megabeast]] or [[semi-megabeast]] will attack the fortress. The attacks will start occurring when all of the requirements are met. Setting a value to 0 disables the trigger.

|}

{{alphabetical TOC|style=margin: 1em auto;}}

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

|-
| {{text anchor|BABY}}
| Caste
|
*integer
| Age at which creature is considered a child, the default is zero. One can think of this as the duration of the baby stage.

|-
| {{text anchor|BABYNAME}}
| Caste
|
*singular
*plural
| Defines a new name for a creature in baby state at the caste level. For non-caste-specific baby names, see {{token|GENERAL_BABY_NAME|c}}.

|-
| {{text anchor|BEACH_FREQUENCY}}
| Caste
|
*integer
| Creature may be subject to [[beaching]], becoming stranded on [[Beach|shores]], where they will eventually air-drown. The number indicates the frequency of the occurrence. Presumably requires the creature to be {{token|AQUATIC|c}}. Used by [[orca]]s, [[sperm whale]]s and [[sea nettle jellyfish]] in the vanilla game.

|-
| {{text anchor|BENIGN}}
| Caste
|
| The creature is non-aggressive by default, and will never automatically be engaged by companions or soldiers, running away from any creatures that are not friendly to it, and will only defend itself if it becomes enraged. Can be thought of as the counterpoint of the {{token|LARGE_PREDATOR|c}} tag. When tamed, animals with this tag will be useless for fortress defense.

This and {{token|TRADE_CAPACITY|c}} are required for {{token|PACK_ANIMAL|c}} to function properly, if an animal contains the aforementioned requirements without this tag: items loaded by the merchants will be dropped upon departure.

|-
| {{text anchor|BIOME}}
| Creature
|
* [[biome token]]
| Select a [[biome]] the creature may appear in.

|-
| {{text anchor|BLOOD}}
| Caste
|
* <[[material token]]>
* <[[Material_definition_token#Material_States|material state]]>
| Specifies what the creature's blood is made of.

|-
| {{text anchor|BLOODSUCKER}}
| Caste
|
| Causes [[vampire]]-like behaviour; the creature will suck the [[Creature_token#BLOOD|blood]] of unconscious victims when its [[Syndrome#TIME_SINCE_SUCKED_BLOOD|thirst for blood]] grows sufficiently large. When controlling the creature in adventure mode, this can be done at will. Seems to be required to make the creature denouncable (in-world) as a creature of the night.

|-
| {{text anchor|BODY}}
| Caste
|
*body parts
| Draws body parts from OBJECT:BODY files (such as body_default.txt)
'''Example:''' 
[BODY:BODY_WITH_HEAD_FLAG:HEART:GUTS:BRAIN:MOUTH] 
This is the body from a [[purring maggot]]. It creates a body with head, a heart, some guts, a brain, and a mouth. That's all a maggot needs.

The body parts need to be listed in an order such that any parent part appears before its connected children. For example [BODY:HEART:BODY_WITH_HEAD_FLAG] produces a "Body Token Recognized But Could Not Connect: HEART" error because HEART can't find any UPPERBODY(s) to connect to. Switching the order to [BODY:BODY_WITH_HEAD_FLAG:HEART] fixes the problem because now the UPPERBODY is created before the HEART tries to connect to it.

'''If the body is left undefined, the creature (or caste) will be tagged as [DOES_NOT_EXIST].''' {{verify}}

|-
| {{text anchor|BODY_APPEARANCE_MODIFIER}}
| Caste
|
*ATTRIBUTE
*lowest
*lower
*low
*median
*high
*higher
*highest
| These body modifiers give individual creatures different characteristics. In the case of HEIGHT, BROADNESS and LENGTH, the modifier is also a percentage change to the BODY_SIZE of the individual creature. The seven numbers afterward give a distribution of ranges. Each interval has an equal chance of occurring.
'''Example:''' 
[BODY_APPEARANCE_MODIFIER:HEIGHT:90:95:98:100:102:105:110] 
''HEIGHT'' : marks the height to be changed 
''90:95:98:100:102:105:110'' : sets the range from the shortest (90% of the average height) to the tallest (110% of the average height) creature variation.

|-
| {{text anchor|BODY_DETAIL_PLAN}}
| Caste
|
*PlanName
*Arguments
| Loads a plan from 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:''' 
[BODY_DETAIL_PLAN:VERTEBRATE_TISSUE_LAYERS:SKIN:FAT:MUSCLE:BONE:CARTILAGE] 
This creates the detailed body of a [[fox]], the skin, fat, muscle, bones and cartilage out of the vertebrate tissues. 
A [[Purring maggot|maggot]] would only need: 
''[BODY_DETAIL_PLAN:EXOSKELETON_TISSUE_LAYERS:SKIN:FAT:MUSCLE]''

|-
| {{text anchor|BODY_SIZE}}
| Caste
|
*years
*days
*size
| Sets size at a given age. Size is in cubic centimeters, and for normal body materials, is roughly equal to the creature's average weight in grams.
'''Example:''' 
[BODY_SIZE:0:0:10000] 
[BODY_SIZE:1:168:50000] 
[BODY_SIZE:12:0:220000] 
This describes the size of a [[minotaur]]. Its birth size would be 10,000 cm3 (~10 kg). At 1 year and 168 days old it would be 50,000 cm3 (~50 kg). And as an adult (at 12 years old) it would be 220,000 cm3 and weigh roughly 220 kg.

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

|-
| {{text anchor|BONECARN}}
| Caste
|
| Creature eats bones. Implies {{token|CARNIVORE|c}}. Currently does not work due to a bug ({{Bug|11069}}).

|-
| {{text anchor|BP_ADD_TYPE}}
| Caste
|
| Adds a type to a body part - used with {{token|SET_BP_GROUP|c}}. In vanilla DF, this is used for adding the type '[[Body token#GELDABLE|GELDABLE]]' to the lower body of certain [[cat|creatures]].

|-
| {{text anchor|BP_APPEARANCE_MODIFIER}}
| Caste
|
*QUALITY
*lowest
*lower
*low
*median
*high
*higher
*highest
| Sets up the breadth of possibilities for appearance qualities for a selected BP group. EG. Eyes (CLOSE_SET, DEEP_SET, ROUND_VS_NARROW, LARGE_IRIS),Lips (THICKNESS), Nose (BROADNESS, LENGTH, UPTURNED, CONVEX), Ear (SPLAYED_OUT, HANGING_LOBES, BROADNESS, HEIGHT), Tooth (GAPS), Skull (HIGH_CHEEKBONES, BROAD_CHIN, JUTTING CHIN, SQUARE_CHIN), Neck (DEEP_VOICE, RASPY_VOICE), Head (BROADNESS, HEIGHT)

|-
| {{text anchor|BP_REMOVE_TYPE}}
| Caste
|
| Removes a type from a body part. Used with {{token|SET_BP_GROUP|c}}.

|-
| {{text anchor|BUILDINGDESTROYER}}
| Caste
|
*1 or 2
| Allows a creature to destroy furniture and buildings. Value [1] targets mostly doors, hatches, furniture and the like. Value [2] targets anything not made with the {{k|b}} + {{k|C}} commands.
|}

{{alphabetical TOC|style=margin: 1em auto;}}

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

|-
| {{text anchor|CAN_DO_INTERACTION}}
| Caste
|
*interaction token
| The creature can perform an interaction. See [[interaction token]].

|-
| {{text anchor|CAN_LEARN}}
| Caste
|
| The creature gains [[skill]]s and can have [[labor|professions]]. If a member of a civilization (even a pet) has this token, it'll need to eat, drink and sleep. Note that this token makes the creature unable to be eaten 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. A creature with at least this token or the {{token|CAN_SPEAK|c}} token will be able to have [[Personality value|values]] and [[Personality goal|goals]].

|-
| {{text anchor|CAN_SPEAK}}
| Caste
|
| Can [[talking|talk]]. Note that this is not necessary for a creature to gain social skills but to make friends in fortress mode. A creature with at least this token or the {{token|CAN_LEARN|c}} token will be able to have [[Personality value|values]] and [[Personality goal|goals]].

|-
| {{text anchor|CANNOT_CLIMB}}
| Caste
|
| Creature cannot [[climber|climb]], even if it has free grasp parts.

|-
| {{text anchor|CANNOT_JUMP}}
| Caste
|
| Creature cannot [[jump]].

|-
| {{text anchor|CANNOT_UNDEAD}}
| Caste
|
| Acts like {{token|NOT_LIVING|c}}, except that {{token|OPPOSED_TO_LIFE|c}} creatures will attack them.

|-
| {{text anchor|CANOPENDOORS}}
| Caste
|
| Defunct, as doors cannot be set as tightly closed anymore.

|-
| {{text anchor|CARNIVORE}}
| Caste
|
| Creature ''only'' eats [[meat]]. If the creature goes on rampages in worldgen, it will often devour the people/animals it kills.

|-
| {{text anchor|CASTE}}
| Creature
|
*name
| Defines a [[caste]].

|-
| {{text anchor|CASTE_ALTTILE}}
| Caste
|
*tile number or "letter"
| Caste-specific {{token|ALTTILE|c}}. Requires {{token|CASTE_TILE|c}}.

|-
| {{text anchor|CASTE_COLOR}}
| Caste
|
*fg
*bg
*brightness
| Caste-specific {{token|COLOR|c}}.

|-
| {{text anchor|CASTE_GLOWCOLOR}}
| Caste
|
*fg
*bg
*brightness
| Caste-specific {{token|GLOWCOLOR|c}}.

|-
| {{text anchor|CASTE_GLOWTILE}}
| Caste
|
*tile value or "letter"
| Caste-specific {{token|GLOWTILE|c}}.

|-
| {{text anchor|CASTE_NAME}}
| Caste
|
*singular
*plural
*adjective
| While {{token|NAME|c}} describes the name of the species, {{token|CASTE_NAME|c}} names individuals of the species. Unlike other caste-specific descriptions, this token is required, even for creatures without separate castes. If left undefined, the creature will not show up in the [[arena]] and members of the species will be labeled as "nothing".

|-
| {{text anchor|CASTE_PROFESSION_NAME}}
| Caste
|
*[[Unit type token]] (Profession)
*singular
*plural
| Caste-specific {{token|PROFESSION_NAME|c}}.

|-
| {{text anchor|CASTE_SOLDIER_ALTTILE}}
| Caste
|
*'character' or tile number
| Caste-specific {{token|SOLDIER_ALTTILE|c}}. Requires {{token|CASTE_SOLDIER_TILE|c}}.

|-
| {{text anchor|CASTE_SOLDIER_TILE}}
| Caste
|
*'character' or tile number
| Caste-specific {{token|CREATURE_SOLDIER_TILE|c}}.

|-
| {{text anchor|CASTE_TILE}}
| Caste
|
* tile number or "letter"
| Caste-specific {{token|CREATURE_TILE|c}}.

|-
| {{text anchor|CAVE_ADAPT}}
| Caste
|
| Causes the creature to develop [[cave adaptation]].

Allows for creature's race to be involved in jokes that end in "And the [race] saw the sun and vomited on the spot!"

|-
| {{text anchor|CDI}}
| Caste
|
*Varies
| Specifies interaction details following a {{token|CAN_DO_INTERACTION|c}} token. See [[interaction token]].

|-
| {{text anchor|CHANGE_BODY_SIZE_PERC}}
| Caste
|
*integer
| Multiplies body size by a factor of (integer)%. 50 halves size, 200 doubles.

|-
| {{text anchor|CHANGE_FREQUENCY_PERC}}
| Creature
|
*integer
| Multiplies frequency by a factor of (integer)%.

|-
| {{text anchor|CHILD}}
| Caste
|
*integer
| Age at which creature is considered an adult - one can think of this as the duration of the [[children|child]] stage. Allows the creature's offspring to be rendered fully tame if [[animal trainer|trained]] during their childhood.

|-
| {{text anchor|CHILDNAME}}
| Caste
|
*singular
*plural
| Defines a new name for a creature in the child state at the caste level. For non-caste-specific child names, see {{token|GENERAL_CHILD_NAME|c}}.

|-
| {{text anchor|CLUSTER_NUMBER}}
| Creature
|
*min
*max
| The minimum/maximum numbers of how many creatures per spawned cluster. Vermin fish with this token in combination with temperate ocean and river biome tokens [http://www.bay12forums.com/smf/index.php?topic=51864.msg1122319#msg1122319 will perform seasonal migrations]. Defaults to 1:1 if not specified.

|-
| {{text anchor|CLUTCH_SIZE}}
| Caste
|
*min
*max
|Number of [[egg]]s laid in one sitting.

|-
| {{text anchor|COLONY_EXTERNAL}}
| Caste
|
| Caste hovers around colony.

|-
| {{text anchor|COLOR}}
| Creature
|
*foreground
*background
*brightness
| Color of the creature's tile. (See [[Color]] for usage.)

|-
| {{text anchor|COMMON_DOMESTIC}}
| Caste
|
| When combined with any of {{token|PET|c}}, {{token|PACK_ANIMAL|c}}, {{token|WAGON_PULLER|c}} and/or {{token|MOUNT|c}}, the creature is guaranteed to be domesticated by any [[civilization]] with {{token|COMMON_DOMESTIC_PET|e}}, {{token|COMMON_DOMESTIC_PACK|e}}, {{token|COMMON_DOMESTIC_PULL|e}} and/or {{token|COMMON_DOMESTIC_MOUNT|e}} respectively. Such civilizations will always have access to the creature, even in the absence of wild populations. This token is invalid on {{token|FANCIFUL|c}} creatures.

|-
| {{text anchor|CONVERTED_SPOUSE}}
| Caste
|
| Creatures of this caste's species with the {{token|SPOUSE_CONVERTER|c}} and {{token|NIGHT_CREATURE_HUNTER|c}} tokens will kidnap {{token|SPOUSE_CONVERSION_TARGET|c}}s of an appropriate sex and convert them into castes with CONVERTED_SPOUSE.

|-
| {{text anchor|COOKABLE_LIVE}}
| Caste
|
| Set this to allow the creature to be cooked in meals while it is still alive, as well as when it's dead but not yet [[fishery|cleaned]]. Used by some water-dwelling vermin such as [[mussel]]s, [[nautilus]]es and [[oyster]]s. Currently does not work correctly when applied to non-{{token|FISHITEM|c}} vermin.{{bug|13200}}

|-
| {{text anchor|CRAZED}}
| Caste
|
| Creature is '[[insanity|berserk]]' and will attack all other creatures, except members of its own species that '''also''' have the CRAZED tag. It will show {{DFtext|Berserk|4:1}} in the [[unit list]]. Berserk creatures go on rampages during [[world generation|worldgen]] much more frequently than non-berserk ones.

|-
| {{text anchor|COPY_TAGS_FROM}}
| Special
|
*creature ID
| Copies another specified creature. This will override any definitions made before it; essentially, it makes this creature identical to the other one, which can then be modified. Often used in combination with {{token|APPLY_CREATURE_VARIATION|c}} to import standard variations from a file. The vanilla [[giant animal]]s and [[animal person|animal people]]s are examples of this token combination.

|-
| {{text anchor|CREATURE}}
| Creature
|
*creature ID
| A unique, arbitrary identifier that begins the definition of each new creature, and is used to reference the creature in other tokens and raws.

|-
| {{text anchor|CREATURE_CLASS}}
| Caste
|
*classname
| An arbitrary creature classification. Can be set to anything, but the only vanilla uses are GENERAL_POISON (used in syndromes), EDIBLE_GROUND_BUG (used as targets for {{token|GOBBLE_VERMIN_CLASS|c}}), MAMMAL, and POISONOUS (both used for kobold pet eligibility). A single creature can have multiple classes.

The full list of tokens that use creature classes is:

* Creature tokens: {{token|GOBBLE_VERMIN_CLASS|c}}, {{token|GOBBLE_VERMIN_CLASS|c}}
* Interaction tokens: {{token|IT_AFFECTED_CLASS|in}}, {{token|IT_IMMUNE_CLASS|in}}
* Animal definition (Entity) tokens: {{token|ANIMAL_CLASS|e}}, {{token|ANIMAL_FORBIDDEN_CLASS|e}}
* Position (Entity) token: {{token|ALLOWED_CLASS|po}}
* Syndrome tokens: {{token|SYN_AFFECTED_CLASS|sy}}, {{token|SYN_IMMUNE_CLASS|sy}}, {{token|CE_SENSE_CREATURE_CLASS|sy}}
|-
| {{text anchor|CREATURE_SOLDIER_TILE}}
| Creature
|
*'character' or tile number
| Creatures active in their civilization's [[military]] will use this tile instead.

|-
| {{text anchor|CREATURE_TILE}}
| Creature
|
*'character' or tile number
| The symbol of the creature in ASCII mode.

|-
| {{text anchor|CREPUSCULAR}}
| Caste
|
| When set, the creature will appear at dawn (between 4:30 AM and 6:00 AM) and in the evening (between 8:00 PM and 10:05 PM) in [[Adventurer mode]].

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

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

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

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

|-
| {{text anchor|CV_REMOVE_TAG}}
| Special
|
*TAG NAME
| Removes a tag. Used in conjunction with creature variation templates.
|}

{{alphabetical TOC|style=margin: 1em auto;}}

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

|-
| {{text anchor|DEMON}}
| Caste
|
| Found on generated [[demon]]s.

At least 1 demon generated, or custom must have the {{token|FLIER|c}} token in order for the [[Underworld|horrifying screams]] event to trigger.

|-
| {{text anchor|DESCRIPTION}}
| Caste
|
*text
| A brief description of the creature type, as displayed when viewing the creature's description/[[Thoughts and preferences|thoughts & preferences]] screen.

|-
| {{text anchor|DIE_WHEN_VERMIN_BITE}}
| Caste
|
| Causes the creature to die upon attacking. Used by [[honey bee]]s to simulate them dying after using their stingers.

|-
| {{text anchor|DIFFICULTY}}
| Caste
|
*integer
| Increases experience gain during adventure mode. Creatures with a difficulty of 11 or higher are not assigned for quests in adventure mode.

|-
| {{text anchor|DIURNAL}}
| Caste
|
| When set, the creature will only appear during the day (between 6:00 AM and 8:00 PM) in [[Adventurer mode]].

|-
| {{text anchor|DIVE_HUNTS_VERMIN}}
| Caste
|
| The creature hunts vermin by diving from the air. On tame creatures, it has the same effect as {{token|HUNTS_VERMIN|c}}. Found on [[peregrine falcon]]s.

|-
| {{text anchor|DOES_NOT_EXIST}}
| Creature
|
| Adding this token to a creature prevents it from appearing in generated worlds (unless it's marked as [[Entity_token#ANIMAL_ALWAYS_PRESENT|always present]] for a particular civilisation). For example, adding it to [[dog]]s will lead to worlds being generated without dogs in them. Also removes the creature from the [[object testing arena]]'s spawn list. If combined with {{token|FANCIFUL|c}}, artistic depictions of the creature will occur regardless. Used by [[centaur]]s, [[chimera]]s and [[griffon]]s in the vanilla game.

Note: a creature tagged as DOES_NOT_EXIST can still be [[Interaction_token#I_EFFECT|summoned]] successfully, as long as it has a body defined in its raws [http://www.bay12forums.com/smf/index.php?topic=165213.msg8086938#msg8086938], or, another creature can [[Syndrome#CE_BODY_TRANSFORMATION|transform]] into it.
|}

{{alphabetical TOC|style=margin: 1em auto;}}

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

|-
| {{text anchor|EBO_ITEM}}
| Caste
|
*[[item token]]
*[[material token]] (ANY_HARD_STONE can be used for the material)
| Defines the item that the creature drops upon being [[butcher|butchered]]. Used with {{token|EXTRA_BUTCHER_OBJECT|c}}.

|-
| {{text anchor|EBO_SHAPE}}
| Caste
|
*gem shape
| The shape of the creature's extra [[butcher|butchering]] drop. Used with {{token|EXTRA_BUTCHER_OBJECT|c}}.

|-
| {{text anchor|EGG_MATERIAL}}
| Caste
|
* <[[material token]]>
* <[[Material_definition_token#Material_States|material state]]>
| Defines the material composition of [[egg]]s laid by the creature. [[creature_token#LAYS_EGGS|Egg-laying]] creatures in the default game define this 3 times, using LOCAL_CREATURE_MAT:EGGSHELL, LOCAL_CREATURE_MAT:EGG_WHITE, and then LOCAL_CREATURE_MAT:EGG_YOLK. Eggs will be made out of eggshell. Edibility is determined by tags on whites or yolk, but they otherwise do not exist.

|-
| {{text anchor|EGG_SIZE}}
| Caste
|
*size
| Determines the size of laid [[egg]]s. Doesn't affect hatching or cooking, but bigger eggs will be heavier, and may take longer to be hauled depending on the hauler's strength.

|-
| {{text anchor|EQUIPMENT_WAGON}}
| Creature
|
| Makes the creature appear as a large 3×3 [[wagon]] responsible for carrying trade goods, pulled by two {{token|WAGON_PULLER|c}} creatures and driven by a merchant.

|-
| {{text anchor|EQUIPS}}
| Caste
|
| Allows the creature to wear or wield items.

|-
| {{text anchor|EVIL}}
| Creature
|
| The creature is considered evil and will only show up in evil biomes. Civilizations with {{token|USE_EVIL_ANIMALS|e}} can domesticate them regardless of exotic status. Has no effect on cavern creatures except to restrict taming. A civilization with evil creatures can colonize evil areas.

Civilizations which list evil creatures as one of their main population options will potentially emerge following an underworld mining disaster, with the added caveat that a demon will be in charge of the civ. The rules which govern which noble position the demon in charge adopts however, are unclear. It either picks one of the predefined positions, or simply makes its own.

|-
| {{text anchor|EXTRA_BUTCHER_OBJECT}}
| Caste
|
* [[Body token#CATEGORY|BY_CATEGORY]] or [[Body token#CONTYPE|BY_TYPE]] or [[Body token#BP|BY_TOKEN]]
* TYPE, CATEGORY, or TOKEN
| The creature drops an additional object when [[butcher|butchered]], as defined by {{token|EBO_ITEM|c}} and {{token|EBO_SHAPE|c}}. Used for [[gizzard stone]]s in default creatures. For some materials, needs to be defined after caste definitions with SELECT_CASTE:ALL{{Bug|6355}}

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

|-
| {{text anchor|EXTRAVISION}}
| Caste
|
| The creature can see regardless of whether it has working eyes and has full 360 degree vision, making it impossible to strike the creature from a blind spot in combat. Invisible creatures will also be seen, namely [[intelligent undead]] using a "vanish" power.
|}

{{alphabetical TOC|style=margin: 1em auto;}}

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

|-
| {{text anchor|FANCIFUL}}
| Creature
|
| The creature is a thing of legend and known to all civilizations. Its materials cannot be requested or preferred. The tag also adds some art value modifiers. Used by a [[Fanciful|number of creatures]]. Conflicts with {{token|COMMON_DOMESTIC|c}}.

|-
| {{text anchor|FEATURE_ATTACK_GROUP}}
| Caste
|
| Found on [[Animal people#Subterranean animal people|subterranean animal-man]] tribals. Currently defunct. In previous versions{{verify}}, it caused these creatures to crawl out of chasms and underground rivers.

|-
| {{text anchor|FEATURE_BEAST}}
| Caste
|
| Found on [[forgotten beast]]s. Presumably makes it act as such, initiating underground attacks on fortresses, or leads to the pop-up message upon encountering one{{verify}}. Displays the creature's {{token|DESCRIPTION|c}} in its [[legends mode]] entry and hides the creature from displaying in a world_sites_and_pops file. Does not create historical figures like generated forgotten beasts do.

Requires specifying a {{token|BIOME|c}} in which the creature will live, and both surface and subterranean biomes are allowed. Does not stack with {{token|LARGE_ROAMING|c}} and if both are used the creature will not spawn. Appears to be incompatible with {{token|DEMON|c}} even if used in separate castes.

|-
| {{text anchor|FEMALE}}
| Caste
|
| Makes the creature biologically female, enabling her to [[Breeding|bear young]]. Usually specified inside a caste.

|-
| {{text anchor|FIREIMMUNE}}
| Caste
|
| Makes the creature immune to [[Interaction_token#FIREBALL|FIREBALL]] and [[Interaction_token#FIREJET|FIREJET]] attacks, and allows it to path through high temperature zones, like lava or fires. Does not, by itself, make the creature immune to the damaging effects of burning in [[fire]], and does not prevent general heat damage or melting on its own (this would require adjustments to be made to the creature's body [[Material_definition_token|materials]] - see the [[Dragon/raw|dragon raws]] for an example).

|-
| {{text anchor|FIREIMMUNE_SUPER}}
| Caste
|
| Like {{token|FIREIMMUNE|c}}, but also renders the creature immune to [[Interaction_token#DRAGONFIRE|DRAGONFIRE]] attacks.

|-
| {{text anchor|FISHITEM}}
| Caste
|
| The creature's corpse is a single [[Item_token#FISH_RAW|FISH_RAW]] food item that needs to be cleaned (into a [[Item_token#FISH|FISH]] item) at a [[fishery]] to become edible. Before being cleaned the item is referred to as "raw". The food item is categorized under "fish" on the food and stocks screens, and when uncleaned it is sorted under "raw fish" in the stocks (but does not show up on the food screen).
Without this or {{token|COOKABLE_LIVE|c}}, [[fishing|fished]] vermin will turn into food the same way as non-vermin creatures, resulting in multiple units of food (meat, brain, lungs, eyes, spleen etc.) from a single fished vermin. These units of food are categorized as meat by the game.

|-
| {{text anchor|FIXED_TEMP}}
| Caste
|
*temperature
| The creature's body is constantly at this temperature, heating up or cooling the surrounding area. Alters the temperature of the creature's inventory and all adjacent tiles, [[Temperature|with all the effects that this implies]] - may trigger wildfires at high enough values. Also makes the creature immune to extreme heat or cold, as long as the temperature set is not harmful to the materials that the creature is made from. Corpses and body parts of creatures with a fixed temperature maintain their temperature even after death.

Note that temperatures of 12000 and higher may cause [[path|pathfinding]] issues in fortress mode.

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

|-
| {{text anchor|FLIER}}
| Caste
|
| Allows a creature to fly, independent of it having wings or not. Fortress Mode pathfinding only partially incorporates flying - flying creatures need a land path to exist between them and an area in order to access it, but as long as one such path exists, they do not need to use it, instead being able to fly over intervening obstacles. Winged creatures with this token can lose their ability to fly if their wings are crippled or severed. Winged creatures without this token will be unable to fly. (A 'wing' in this context refers to any body part with its own [[Body_token#FLIER|FLIER]] token).

At least 1 [[Demon]] must have the flier token in order for the [[Underworld|horrifying screams]] event to trigger.

|-
| {{text anchor|FREQUENCY}}
| Creature
|
*number, max 100
| The {{token|FREQUENCY|c}} value plays two separate roles. The first is in determining the initial distribution of creatures across the world map. Each creature is randomly assigned a single x, y co-ordinate on the world map, which act as the epicenter for that creature's distribution. A square is drawn around that x, y co-ordinate with a Manhattan radius equal to the {{token|FREQUENCY|c}} value divided by 100 times the world map size. For example, in a 256 by 256 size world map, the [[lion]] might be assigned 14, 112. The [[lion]] has {{token|FREQUENCY:5|c}}, and so a square is drawn by moving 13 tiles in each direction from the [[lion]]'s x, y co-ordinate. This is the [[lion]]'s "territory".

Each sub-region in the world will attempt to fill lists of wildlife. There are five lists - {{token|VERMIN_GROUNDER|c}}, {{token|VERMIN_SOIL|c}}, {{token|VERMIN_SOIL_COLONY|c}}, {{token|LARGE_ROAMING|c}}, and {{token|LARGE_PREDATOR|c}}, corresponding with the relevant tokens. The game will attempt to place seven creatures in each list for each sub-region. The game will select the seven nearest valid creatures. Creatures are valid for sub-region's list if they have the requisite token for that list, if they have the valid token for that sub-region's biome (for example, the [lion] can only be selected for {{token|BIOME:SAVANNA_TROPICAL|c}}, {{token|BIOME:GRASSLAND_TROPICAL|c}}, and {{token|BIOME:SHRUBLAND_TROPICAL|c}}, and if their "territory" as defined by their random epicenter and {{token|FREQUENCY|c}} radius overlaps with that sub-region. These lists then determine the creatures that can actually appear within that sub-region during gameplay.

There are some exceptions to the above. If the game was not capable of filling all seven entries in a list, it will drop the overlapping territory requirement, and simply pull the nearest creature which has the correct token and biome availability. Conversely, if a creature has an epicenter but has not appeared on any of the list for any of the world map's sub-regions, the creature will be assigned to the relevant list for the nearest appropriate sub-region - meaning it is occasionally possible to have lists of eight creatures or more. This is more common in smaller worlds where there are less possible sub-regions to be assigned towards. Creatures with the {{token|GOOD|c}} and {{token|EVIL|c}} tokens ignore the epicenter distribution system altogether. They are always capable of appearing in appropriate biomes which are {{token|GOOD|b}} or {{token|EVIL|b}} respectively. This is not true for {{token|SAVAGE|c}}, which acts more like the biome tokens. Creatures with {{token|UBIQUITOUS|c}} have a "territory" which covers the entire map, regardless of their epicenter (although they can still fail to be chosen if there are 7 creatures which are eligible and have nearer epicenters to the sub-region in question).

The second use for {{token|FREQUENCY|c}} is to determine how often a creature actually appears on map. In Fortress Mode, the game will try and spawn large wildlife (creatures with {{token|LARGE_ROAMING|c}} or {{token|LARGE_PREDATOR|c}} in fairly regular waves. These waves include {{token|LARGE_ROAMING|c}}, {{token|LARGE_ROAMING|c}} combined with {{token|FLIER|c}}, {{token|LARGE_PREDATOR|c}}, and {{token|CURIOUS_BEAST|c}} - so a [[lion]] does not compete for selection with a [[gazelle]]. When the game decides it needs to spawn in a fresh wave of e.g. {{token|LARGE_ROAMING|c}} creatures, it will select one of the creatures available to it from the lists for that sub-region at random, with all creatures weighted equally. Once it has selected a creature, it then effectively rolls a d100 against the relevant creature's {{token|FREQUENCY|c}}. If the d100 is equal to the creature's {{token|FREQUENCY|c}} or less, that creature is then spawned in. If the d100 is above the creature's {{token|FREQUENCY|c}}, the game returns to the relevant list and selects again. {{token|UBIQUITOUS|c}} acts as {{token|FREQUENCY:100|c}} for these purposes - in other words, the creature cannot fail the d100 check and will always be spawned in if it is selected from the list.

|}

{{alphabetical TOC|style=margin: 1em auto;}}

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

|-
| {{text anchor|GAIT}}
| Caste
|
* <gait type>
* <gait name>
* <max [[Gait#Speed|speed]]>
* <build up time>
* <max turning [[Gait#Speed|speed]]>
* <start [[Gait#Speed|speed]]>
* <energy expenditure>
* <gait flag(s)>
| Defines a gait by which the creature can move. See [[Gait]] for more information. Specifically, you likely want to use one of the existing STANDARD_X_GAITS creature variations, as described in [[Gait#Gaits_and_Modding|this subsection]].

* <max speed> indicates the maximum [[Gait#Speed|speed]] achievable by a creature using this gait
* <start speed> indicates the creature's speed when it starts moving using this gait
* <build up time> indicates how long it will take for a creature using this gait to go from <start speed> to <max speed>. For example, a value of 10 means that it should be able to reach the maximum speed by moving 10 [[tile]]s in a straight line over even terrain.
* <max turning speed> indicates the maximum speed permissible when the creature suddenly changes its direction of motion. The creature's speed will be reduced to <max turning speed> if travelling at a higher speed than this before turning.
* <energy expenditure> indicates how energy-consuming the gait is. Higher values cause the creature to tire out faster. Persistent usage of a high-intensity gait will eventually lead to exhaustion and [[Status_icon#Non-flashing|collapse]].

'''NO_BUILD_UP''' can be specified instead of a <start speed> value to make the <max speed> instantly achievable upon initiating movement (this is equivalent to a <build up time> of 0). Note that <build up time> and <max turning speed> are both ignored if specified alongside this (as NO_BUILD_UP trumps <build up time> and preserves <max speed> whilst turning, and <max turning speed> cannot exceed <max speed>) so it is permissible to omit them so long as they are '''both''' omitted together.

It's possible to specify a <start speed> greater than the <max speed>; the moving creature will decelerate towards its <max speed> in this case.

'''valid gait types:'''
*'''WALK''' 
Used for moving normally over ground tiles.

*'''CRAWL''' 
Used for moving over ground tiles whilst [[Status_icon#Non-flashing|prone]].

*'''SWIM''' 
Used for moving through tiles containing [[water]] or [[magma]] at a [[Water#Depth|depth]] of at least 4/7.

*'''FLY''' 
Used for moving through [[open space]].

*'''CLIMB''' 
Used for moving whilst [[Climber|climbing]].

'''valid gait flags:'''
* '''AGILITY''' 
Speeds/slows movement depending on the creature's [[Attribute#Agility|Agility]] stat.

* '''STRENGTH''' 
Speeds/slows movement depending on the creature's [[Attribute#Strength|Strength]] stat.

* '''LAYERS_SLOW''' 
Makes [[Tissue_definition_token#THICKENS_ON_ENERGY_STORAGE|THICKENS_ON_ENERGY_STORAGE]] and [[Tissue_definition_token#THICKENS_ON_STRENGTH|THICKENS_ON_STRENGTH]] tissue layers slow movement depending on how thick they are. Adding the STRENGTH gait flag counteracts the impact of the latter layer.

* '''STEALTH_SLOWS:'''<percentage> 
Slows movement by the specified percentage when the creature is [[Ambusher|sneaking]].

|-
| {{text anchor|GENERAL_BABY_NAME}}
| Creature
|
*singular
*plural
| Like {{token|BABYNAME|c}}, but applied regardless of caste.

|-
| {{text anchor|GENERAL_CHILD_NAME}}
| Creature
|
*singular
*plural
| Like {{token|CHILDNAME|c}}, but applied regardless of caste.

|-
| {{text anchor|GENERAL_MATERIAL_FORCE_MULTIPLIER}}
| Caste
|
*value A
*value B
| Has the same function as {{token|MATERIAL_FORCE_MULTIPLIER|c}}, but applies to all attacks instead of just those involving a specific material. Appears to be overridden by MATERIAL_FORCE_MULTIPLIER ([[werebeast]]s, for example, use both tokens to provide resistance to all materials, with one exception to which they are especially vulnerable).

|-
| {{text anchor|GENERATED}}
| Creature
|
| Found on procedurally generated creatures like [[forgotten beast]]s, [[titan]]s, [[demon]]s, [[angel]]s, and [[night creature]]s. Cannot be specified in user-defined raws.

|-
| {{text anchor|GETS_INFECTIONS_FROM_ROT}}
| Caste
|
| Makes the creature get [[Health_care#Infection|infections]] from necrotic tissue.

|-
| {{text anchor|GETS_WOUND_INFECTIONS}}
| Caste
|
| Makes the creature's wounds become [[Health_care#Infection|infected]] if left untreated for too long.

|-
| {{text anchor|GLOWCOLOR}}
| Creature
|
*foreground
*background
*brightness
| The colour of the creature's {{token|GLOWTILE|c}}.

|-
| {{text anchor|GLOWTILE}}
| Creature
|
*ascii character
| If present, the being glows in the dark (generally used for Adventurer 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 {{token|CASTE_GLOWTILE|c}} instead.

|-
| {{text anchor|GNAWER}}
| Caste
|
*verb
| The creature can and will gnaw its way out of [[animal trap]]s and [[cage]]s using the specified verb, depending on the material from which it is made (normally wood).

|-
| {{text anchor|GOBBLE_VERMIN_CLASS}}
| Caste
|
*class
| The creature eats vermin of the specified class.

|-
| {{text anchor|GOBBLE_VERMIN_CREATURE}}
| Caste
|
*creature
*caste
| The creature eats a specified [[vermin]].

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

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

|-
| {{text anchor|GO_TO_TAG}}
| Special
|
| When using tags from an existing creature, inserts new tags ''before'' the specified tag.

|-
| {{text anchor|GOOD}}
| Creature
|
| Creature is considered good and will only show up in good biomes - [[unicorn]]s, for example. Civilizations with {{token|USE_GOOD_ANIMALS|e}} can domesticate them regardless of exotic status. Has no effect on cavern creatures except to restrict taming. A civilization that has good creatures can colonise good areas in world-gen.

|-
| {{text anchor|GRASSTRAMPLE}}
| Caste
|
*value
| The value determines how rapidly [[grass]] is trampled when a creature steps on it - a value of 0 causes the creature to never damage grass, while a value of 100 causes grass to be trampled as rapidly as possible. Defaults to 5.

|-
| {{text anchor|GRAVITATE_BODY_SIZE}}
| Caste
|
*target value
| Used in Creature Variants. This token changes the adult body size to the average of the old adult body size and the target value and scales all intermediate growth stages by the same factor.

|-
| {{text anchor|GRAZER}}
| Caste
|
*number
| The creature is a grazer - if tamed in fortress mode, it needs a pasture to survive. The higher the number, the less frequently it needs to eat in order to live. Not used since 0.40.12, replaced by {{token|STANDARD_GRAZER|c}} to fix {{bugl|4113}}.
|}

{{alphabetical TOC|style=margin: 1em auto;}}

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

|-
| {{text anchor|HABIT}}
| Caste
|
*type
*probability
| Defines certain behaviors for the creature. The habit types are:
*COLLECT_TROPHIES
*COOK_PEOPLE
*COOK_VERMIN
*GRIND_VERMIN
*COOK_BLOOD
*GRIND_BONE_MEAL
*EAT_BONE_PORRIDGE
*USE_ANY_MELEE_WEAPON
*GIANT_NEST
*COLLECT_WEALTH.
These require the creature to have a {{token|LAIR|c}} to work properly, and also don't seem to work on creatures who are not a {{token|SEMIMEGABEAST|c}}, {{token|MEGABEAST|c}}, or{{token|NIGHT_CREATURE_HUNTER|c}}.

|-
| {{text anchor|HABIT_NUM}}
| Caste
|
*number or TEST_ALL
| "If you set HABIT_NUM to a number, it should give you that exact number of habits according to the weights.".{{cite forum|60554/1719248}} All lists of HABITs are preceded by [HABIT_NUM:TEST_ALL]

|-
| {{text anchor|HAS_NERVES}}
| Caste
|
| The creature has nerves in its muscles. Cutting the muscle tissue can sever motor and sensory nerves, disabling the limb.

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

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

|-
| {{text anchor|HOMEOTHERM}}
| Caste
|
*number or NONE
| Default 'NONE'. The creature's normal body [[temperature]]. Creature ceases maintaining temperature on death unlike fixed material temperatures. Provides minor protection from environmental temperature to the creature.

|-
| {{text anchor|HUNTS_VERMIN}}
| Caste
|
| Creature hunts and kills nearby [[vermin]], randomly walking between places with food laying on the ground or in stockpiles, to check for possible [VERMIN_EATER] vermin, but they'll kill any other vermin too. Do not include this creature token on an intelligent entity that you intend to play as in fortress mode because it will prevent them from feeding themselves.

|}

{{alphabetical TOC|style=margin: 1em auto;}}

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

|-
| {{text anchor|IMMOBILE}}
| Caste
|
| The creature cannot move. Found on [[sponge]]s. Will also stop a creature from breeding in fortress mode (MALE and FEMALE are affected, if one is IMMOBILE; no breeding will happen).

|-
| {{text anchor|IMMOBILE_LAND}}
| Caste
|
| The creature is immobile while on land. Only works on {{token|AQUATIC|c}} creatures which can't breathe on land.

|-
| {{text anchor|IMMOLATE}}
| Caste
|
| The creature radiates [[fire]]. It will ignite, and potentially completely destroy, items the creature is standing on. Also gives the vermin a high chance of escaping from [[animal trap]]s and [[cage]]s made of any flammable materials (specifically ones that could be ignited by magma).

|-
| {{text anchor|INTELLIGENT}}
| Caste
|
| Alias for {{token|CAN_SPEAK|c}} + {{token|CAN_LEARN|c}}.

|-
| {{text anchor|ITEMCORPSE}}
| Caste
|
* [[item token]]
* [[material token]]
| Determines if the creature leaves behind a non-standard corpse (i.e. wood, statue, bars, stone, pool of liquid, etc.). [[Ethics]] may prevent actually using the item in jobs or reactions.

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

{{alphabetical TOC|style=margin: 1em auto;}}

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

|-
| {{text anchor|LAIR}}
| Caste
|
*type
*probability
| Found on megabeasts, semimegabeasts, and night creatures. The creature will seek out sites of this type and take them as lairs. The lair types are:
*SIMPLE_BURROW
*SIMPLE_MOUND
*WILDERNESS_LOCATION
*SHRINE
*LABYRINTH

|-
| {{text anchor|LAIR_CHARACTERISTIC}}
| Caste
|
*characteristic
*probability
| Defines certain features of the creature's lair. The only valid characteristic is HAS_DOORS.

|-
| {{text anchor|LAIR_HUNTER}}
| Caste
|
| This creature will actively hunt adventurers in its lair.

|-
| {{text anchor|LAIR_HUNTER_SPEECH}}
| Caste
|
*speech file
| What this creature says while hunting adventurers in its lair.

|-
| {{text anchor|LARGE_PREDATOR}}
| Caste
|
| Will attack other creatures that are smaller than it. Tamed large predators will still attack wildlife. In [[fortress mode]], only one group of "large predators" (possibly two groups on "savage" maps) will appear on any given map. In [[adventurer mode]], large predators will try to ambush and attack you (and your party will attack them back). When tamed, large predators tend to be much more aggressive to enemies than non-large predators, making them a good choice for an animal army. They may go on rampages in worldgen, and adventurers may receive quests to kill them. Also, they can be mentioned in the intro paragraph when starting a fortress e.g. "ere the wolves get hungry."
A single biome supports 7 large predator species, picking randomly and rolling a d100 under its {{token|FREQUENCY|c}} to add it until all 7 slots are filled.

Incompatible with {{token|PACK_ANIMAL|c}} on a technicality, if included: hauled items are likely to be dropped upon entering the map (even if {{token|TRADE_CAPACITY|c}} is present) in contrast to when the merchants depart.

|-
| {{text anchor|LARGE_ROAMING}}
| Creature
|
| This is the core requisite tag allowing the creature to spawn as a wild animal in the appropriate biomes. Requires specifying a {{token|BIOME|c}} in which the creature will spawn. Does not require specifying a frequency, population number, or cluster number.

This tag stacks with {{token|MEGABEAST|c}}, {{token|SEMIMEGABEAST|c}}, or {{token|NIGHT_CREATURE_HUNTER|c}}; if used with one of these tags, the creature will spawn as both a boss and as a wild animal. This tag does not stack with {{token|FEATURE_BEAST|c}} and if both are used the creature will not spawn. This tag is unaffected by {{token|DEMON|c}}.

|-
| {{text anchor|LAYS_EGGS}}
| Caste
|
| Creature lays [[egg]]s instead of giving birth to live young.

|-
| {{text anchor|LAYS_UNUSUAL_EGGS}}
| Caste
|
* [[item token]]
* [[material token]]
| Creature lays the specified item instead of regular eggs.

|-
| {{text anchor|LIGAMENTS}}
| Caste
|
* [[material token]]
*healing rate
| The creature has ligaments in its {{token|CONNECTIVE_TISSUE_ANCHOR|td}} tissues (bone or chitin by default). Cutting the bone/chitin tissue severs the ligaments, disabling motor function if the target is a limb.

|-
| {{text anchor|LIGHT_GEN}}
| Caste
|
| A vermin featuring this tag will remain visible to an adventurer even at night.

Subterranean vermin which feature this token will flicker in unexposed and unrevealed cavern layers while playing in Fortress Mode.

|-
| {{text anchor|LIKES_FIGHTING}}
| Caste
|
| The creature will attack enemies rather than flee from them. This tag has the same effect on player-controlled creatures - including modded dwarves. Retired as of v0.40.14 in favor of {{token|LARGE_PREDATOR|c}}.

|-
| {{text anchor|LISP}}
| Caste
|
| Creature uses "sssssnake talk" (multiplies 'S' when talking - "My name isss Recisssiz."). Used by [[Serpent man|serpent men]] and [[Reptile man|reptile men]] in the vanilla game. C's with the same pronunciation (depending on the word) are not affected by this token.

|-
| {{text anchor|LITTERSIZE}}
| Caste
|
* minimum
* maximum
| Determines the number of offspring per one birth; default 1-3, not used in vanilla raws. See also {{token|MULTIPLE_LITTER_RARE|c}}.

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

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

|-
| {{text anchor|LOCKPICKER}}
| Caste
|
| Lets a creature open [[door]]s that are set to forbidden in fortress mode.

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

|-
| {{text anchor|LOW_LIGHT_VISION}}
| Caste
|
*number
| Determines how well a creature can see in the dark - higher is better. Dwarves have 10000, which amounts to perfect nightvision.
|}

{{alphabetical TOC|style=margin: 1em auto;}}

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

|-
| {{text anchor|MAGICAL}}
| Caste
|
| According to Toady One, this is completely interchangeable with {{token|AT_PEACE_WITH_WILDLIFE|c}} and might have been used in very early versions of the game by wandering wizards or the ent-type tree creatures that used to be animated by elves. [http://www.bay12forums.com/smf/index.php?topic=169696.msg8316954#msg8316954]

|-
| {{text anchor|MAGMA_VISION}}
| Caste
|
| The creature is able to see while submerged in [[magma]].

|-
| {{text anchor|MALE}}
| Caste
|
| Makes the creature biologically male. Usually declared inside a caste.

|-
| {{text anchor|MANNERISM|MANNERISM_*}}
| Caste
|
*occasionally body part
| Adds a possible mannerism to the creature's profile. See [[creature mannerism token]] for further info.

|-
| {{text anchor|MATERIAL}}
| Creature
|
*material id
| Begins defining a new local material. Follow this with standard material definition tokens to define the material.

|-
| {{text anchor|MATERIAL_FORCE_MULTIPLIER}}
| Caste
|
*[[Material token]]
*value A
*value B
| When struck with a weapon made of the specified material, the force exerted will be multiplied by A/B, thus making the creature more or less susceptible to this material. For example, if A is 2 and B is 1, the force exerted by the defined material will be doubled. If A is 1 and B is 2, it will be halved instead. See also {{token|GENERAL_MATERIAL_FORCE_MULTIPLIER|c}}, which can be used to make this sort of effect applicable to all materials.

|-
| {{text anchor|MATUTINAL}}
| Caste
|
| When set, the creature will only appear at dawn (between 4:30 AM and 6:00 AM) in [[Adventurer mode]].

|-
| {{text anchor|MAXAGE}}
| Caste
|
*min
*max
| Determines the creature's natural lifespan, using the specified minimum and maximum age values (in years). Each individual creature with this token is generated with a predetermined date (calculated down to the exact [[time|tick]]!) between these values, at which it is destined to die of old age, should it live long enough. Note that the probability of death at any given age does not increase as the creature gets older [http://i.imgur.com/A1A4aA9.png].
Creatures which lack this token are naturally immortal. The [[Syndrome#CE_ADD_TAG|NO_AGING]] syndrome tag will prevent death by old age from occurring. Also note that, among civilized creatures, castes which lack this token will refuse to marry others with it, and vice versa.

|-
| {{text anchor|MEANDERER}}
| Caste
|
| Makes the creature slowly stroll around, unless it's in combat or performing a job. If combined with {{token|CAN_LEARN|c}}, will severely impact their [[pathfinding]] and lead the creature to move extremely slowly when not performing any task. Problematically applies to animal people based on the animal and war trained animals{{bug|9588}}.

|-
| {{text anchor|MEGABEAST}}
| Caste
|
| A 'boss' creature. A small number of the creatures are created during worldgen, their histories and descendants (if any) will be tracked in worldgen (as opposed to simply 'spawning'), and they will occasionally go on rampages, potentially leading to worship if they attack the same place multiple times. Their presence and number will also influence age names. When appearing in fortress mode, they will have a pop-up message announcing their arrival. They will remain hostile to military even after being tamed.{{bug|10731}} See [[megabeast]] page for more details.

Requires specifying a {{token|BIOME|c}} in which the creature will live. Subterranean biomes appear to not be allowed. Does stack with {{token|LARGE_ROAMING|c}} and if both are used the creature will spawn as both historical bosses and as wild animals.

|-
| {{text anchor|MENT_ATT_CAP_PERC}}
| Caste
|
*[[Attribute|ATTRIBUTE]] Token
*Cap %
|Default is 200. This means you can increase your attribute to 200% of its starting value (or the average value + your starting value if that is higher).

|-
| {{text anchor|MENT_ATT_RANGE}}
| Caste
|
*[[Attribute|ATTRIBUTE]]
*lowest
*lower
*low
*median
*high
*higher
*highest
| Sets up a [[Attribute#Soul_attributes|mental attribute]]'s range of values (0-5000). All mental attribute ranges default to 200:800:900:1000:1100:1300:2000.

|-
| {{text anchor|MENT_ATT_RATES}}
| Caste
|
*[[Attribute|ATTRIBUTE]] Token
*cost to improve
*unused counter rate
*rust counter rate
*demotion counter rate
| [[Attribute#Soul_attributes|Mental attribute]] gain/decay rates. Lower numbers in the last three slots make decay occur faster. Defaults are 500:4:5:4.

|-
| {{text anchor|MILKABLE}}
| Caste
|
* [[material token]]
* frequency
| Allows the creature to be [[milk]]ed in the [[farmer's workshop]]. The frequency is the amount of [[time|ticks]] the creature needs to "recharge" (i.e. how much time needs to pass before it can be milked again). Does not work on [[#CAN_LEARN|sentient]] creatures, regardless of [[ethics]].

|-
| {{text anchor|MISCHIEVIOUS}}
| Caste
|
| Alias for {{token|MISCHIEVOUS|c}}.

|-
| {{text anchor|MISCHIEVOUS}}
| Caste
|
| The creature spawns [[stealth]]ed and will attempt to path into the fortress, pulling any [[lever]]s it comes across. It will be invisible on the map and [[unit list]] until spotted by a citizen, at which point the game will pause and recenter on the creature. Used by [[gremlin]]s in the vanilla game. "They go on little missions to mess with various fortress buildings, not just levers."

|-
| {{text anchor|MODVALUE}}
| Caste
|
| Seemingly no longer used.

|-
| {{text anchor|MOUNT}}
| Caste
|
| Creature may be used as a [[mount]]. No use for the player in fortress mode, but enemy sieging forces may arrive with cavalry. Mounts are usable in adventure mode.

|-
| {{text anchor|MOUNT_EXOTIC}}
| Caste
|
| Creature may be used as a [[mount]], but civilizations cannot domesticate it in worldgen without certain exceptions.

|-
| {{text anchor|MULTIPART_FULL_VISION}}
| Caste
|
| Allows the creature to have all-around vision, as long as it has multiple heads that can see.

|-
| {{text anchor|MULTIPLE_LITTER_RARE}}
| Caste
|
| Makes the species usually produce a single offspring per birth, with a 1/500 chance of using the {{token|LITTERSIZE|c}} as usual. Requires {{token|FEMALE|c}}.

|-
| {{text anchor|MUNDANE}}
| Creature
|
| Marks if the creature is an actual real-life creature. Only used for age-names at present.
|}

{{alphabetical TOC|style=margin: 1em auto;}}

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

|-
| {{text anchor|NAME}}
| Creature
|
*singular
*plural
*adjective
| The generic name for any creature of this type - will be used for referring to the species in the abstract, such as the default material prefix. For labeling individual creatures, {{token|CASTE_NAME|c}} is necessary. If left undefined, the creature will be labeled as "nothing" by the game.

Some examples of adjective use:
* "super''dwarven'' strength"
* "the ''dwarven'' hillocks of X"
* Deity species as in "''feline'' deity"
* Megabeast attacks in worldgen. One with multiple dragons being a "''draconic'' rampage"

|-
| {{text anchor|NATURAL}}
| Caste
|
| Animal is considered to be natural. NATURAL animals will not engage creatures tagged with {{token|AT_PEACE_WITH_WILDLIFE|c}} in combat unless they are members of a hostile entity and vice-versa.

|-
| {{text anchor|NATURAL_ANIMAL}}
| Caste
|
| Alias of {{token|NATURAL|c}}.

|-
| {{text anchor|NATURAL_SKILL}}
| Caste
|
*[[Skill_token|Skill token]]
*value
| The creature possesses the specified [[skill]] at this level inherently - that is, it begins with the skill at this level, and the skill may never rust below that. A value of 15 is legendary.

|-
| {{text anchor|NIGHT_CREATURE}}
| Caste
|
| Creatures with this token can appear as [[experiment|experiments]]. Causes the creature to count as {{token|NOT_LIVING|c}}.

Killing a creature featuring this token provides one point of "hero" reputation. Adds the creature's description as part of the initial summary of their historical figure in legends mode. People will react to creatures with this token as a night creature (natch). In adventure mode, ambushes involving these units will say "Night creature!" instead of "Ambush!"

Prevents creature behavior enabled by {{token|LARGE_PREDATOR|c}}.

Removes the high nature value check imposed by {{token|LOCAL_POPS_PRODUCE_HEROES|c}}.

Prevents the AI from using ANIMATE interactions, unless the newly-animated{{token|OPPOSED_TO_LIFE|c}}undead will not attack them. The check for this is specifically whether the unit is:
*a ghost
*an animated unit
*a unit with the {{token|NO_AGING|c}} token added via {{token|CE_ADD_TAG|c}}. (This allows for the default exclusion of elves and goblins, unless raised as intelligent undead.)

|-
| {{text anchor|NIGHT_CREATURE_BOGEYMAN}}
| Caste
|
| Creatures with this token can appear in [[bogeyman|bogeyman ambushes]] in [[adventure mode]], where they adopt classical bogeyman traits such as stalking the adventurer and vaporising when dawn breaks. Such traits do not manifest if the creature is encountered outside of a bogeyman ambush (for instance, as a megabeast or a civilised being). In addition, their corpses and severed body parts turn into [[smoke]] after a short while. Note that setting the "Number of Bogeyman Types" in [[advanced world generation]] to 0 will only remove randomly-generated bogeymen.

|-
| {{text anchor|NIGHT_CREATURE_EXPERIMENTER}}
| Caste
|
| Found on some [[necromancer]]s. Creatures with this tag may periodically "perform horrible experiments" offscreen, during which they can use creature-targeting interactions with an <code>[[Interaction_token#I_SOURCE|[I_SOURCE:EXPERIMENT]]]</code> tag on living creatures in their area. Worlds are generated with a list of procedurally-generated experiments, allowing necromancers to turn living people and animals into [[Infected_ghoul|ghouls]] and [[Experiment|other experimental creatures]], and these will automatically be available to all experimenters; it does not appear possible to prevent this. You can mod in your own custom experiment interactions, but these are used very infrequently due to the large number of generated experiments.

|-
| {{text anchor|NIGHT_CREATURE_HUNTER}}
| Caste
|
| Found on [[night troll]]s and [[werebeast]]s. Implies that the creature is a [[night creature]], and shows its description in [[legends mode]] entry. The creature is always hostile and will start [[no quarter]] combat with any nearby creatures, except for members of its own race. Note that this tag does not override the creature's normal behavior in [[fortress mode]] except for the aforementioned aggression, and doesn't prevent the creature from fleeing the battles it started. It also removes the creature's materials from stockpile settings list, making them be stored there regardless of settings.

Does stack with {{token|LARGE_ROAMING|c}} and if both are used the creature will spawn as both historical hunters and as wild animals; this requires specifying a {{token|BIOME|c}} in which the creature will live, and subterranean biomes are allowed.

This tag causes the usual behaviour of werebeasts in worldgen, that is, fleeing towns upon being cursed and conducting raids from a lair. If this tag is absent from a deity curse, the accursed will simply be driven out of towns in a similar manner to [[vampire]]s. When paired with SPOUSE_CONVERTER, a very small population of the creature will be created during worldgen (sometimes only a single individual will be created), and their histories will be tracked (that is, they will not spawn spontaneously later, they must either have children or convert other creatures to increase their numbers). The creature will settle in a lair and go on rampages during worldgen. It will actively attempt to seek out potential conversion targets to abduct, convert, and have children with (if possible).

|-
| {{text anchor|NIGHT_CREATURE_NIGHTMARE}}
| Caste
|
| Found on [[nightmare]]s. Corpses and severed body parts derived from creatures with this token turn into [[smoke]] after a short while.

|-
| {{text anchor|NO_AUTUMN}}
| Caste
|
| The creature caste does not appear in [[Calendar|autumn]].

|-
| {{text anchor|NO_CONNECTIONS_FOR_MOVEMENT}}
| Caste
|
| Creature doesn't require connected body parts to move{{verify}}; generally used on undead creatures with connections that have rotted away.

|-
| {{text anchor|NO_DIZZINESS}}
| Caste
|
| Creature cannot become [[Symptom#Dizziness|dizzy]].

|-
| {{text anchor|NO_DRINK}}
| Caste
|
| Creature does not need to drink.

|-
| {{text anchor|NO_EAT}}
| Caste
|
| Creature does not need to [[food|eat]].

|-
| {{text anchor|NO_FEVERS}}
| Caste
|
| Creature cannot suffer [[Symptom#Fever|fevers]].

|-
| {{text anchor|NO_GENDER}}
| Caste
|
| The creature is biologically sexless, making it unable to [[breeding|breed]].

|-
| {{text anchor|NO_PHYS_ATT_GAIN}}
| Caste
|
| The creature cannot raise any [[Attribute#Body_attributes|physical attributes]].

|-
| {{text anchor|NO_PHYS_ATT_RUST}}
| Caste
|
| The creature cannot lose any [[Attribute#Body_attributes|physical attributes]].

|-
| {{text anchor|NO_SLEEP}}
| Caste
|
| Creature does not need to sleep, but can still be rendered unconscious by other means.

|-
| {{text anchor|NO_SPRING}}
| Caste
|
| The creature caste does not appear in [[Calendar|spring]].

|-
| {{text anchor|NO_SUMMER}}
| Caste
|
| The creature caste does not appear in [[Calendar|summer]].

|-
| {{text anchor|NO_THOUGHT_CENTER_FOR_MOVEMENT}}
| Caste
|
| The bodyparts of this creature don't need to be connected to an organ with the {{token|THOUGHT|body}} tag in order to have motor function. Generally used on creatures that don't have brains. If a creature doesn't have a thought part and doesn't have this token, it will be unable to grasp or stand. Nautilus men experience this issue in vanilla.

|-
| {{text anchor|NO_UNIT_TYPE_COLOR}}
| Caste
|
| Prevents creature from selecting its color based on its profession (e.g. Miner, Hunter, Wrestler).

|-
| {{text anchor|NO_VEGETATION_PERTURB}}
| Caste{{Verify}}
|
| Likely prevents the creature from leaving broken vegetation tracks.{{Verify}}

|-
| {{text anchor|NO_WINTER}}
| Caste
|
| The creature caste does not appear in [[Calendar|winter]].

|-
| {{text anchor|NOBONES}}
| Caste
|
| Creature has no bones.

|-
| {{text anchor|NOBREATHE}}
| Caste
|
| Creature doesn't need to breathe or have {{token|BREATHE|body}}parts in its body, nor can it drown or be strangled. Creatures living in magma must have this tag, otherwise they will drown.

|-
| {{text anchor|NOCTURNAL}}
| Caste
|
| When set, the creature will only appear at night (after 10:05 PM and before 4:30 AM) in [[Adventurer mode]].

|-
| {{text anchor|NOEMOTION}}
| Caste
|
| Creature has no emotions, thus; it is immune to the effects of [[stress]] and unable to rage, and its [[need]]s cannot be fulfilled in any way. Used on [[undead]] in the vanilla game.

|-
| {{text anchor|NOEXERT}}
| Caste
|
| Creature can't become tired or over-exerted from taking too many combat actions, or moving at full speed for extended periods of time.

|-
| {{text anchor|NOFEAR}}
| Caste
|
| Creature doesn't feel fear and will never flee from battle, and will be immune to [[ghost]]s' attempts to 'scare it to death'. Additionally, it causes [[bogeyman|bogeymen]] and [[nightmare]]s to become friendly towards the creature.

|-
| {{text anchor|NOMEAT}}
| Caste
|
| Creature will not be hunted or fed to wild beasts.

|-
| {{text anchor|NONAUSEA}}
| Caste
|
| Creature isn't nauseated by gut hits and cannot vomit.

|-
| {{text anchor|NOPAIN}}
| Caste
|
| Creature doesn't feel pain.

|-
| {{text anchor|NOSKIN}}
| Caste
|
| Creature will not drop a hide when [[butcher|butchered]].

|-
| {{text anchor|NOSKULL}}
| Caste
|
| Creature will not drop a skull on butchering, rot, or decay of severed head.

|-
| {{text anchor|NOSMELLYROT}}
| Caste
|
| Does not produce [[miasma]] when rotting.

|-
| {{text anchor|NOSTUCKINS}}
| Caste
|
| Weapons can't get stuck in the creature.

|-
| {{text anchor|NOSTUN}}
| Caste
|
| Creature can't be stunned and knocked unconscious by pain or head injuries. Creatures with this tag never wake up from sleep in Fortress Mode. If this creature needs to sleep while playing, it will die.

|-
| {{text anchor|NOT_BUTCHERABLE}}
| Caste
|
| Corpses from this creature cannot be [[butcher|butchered]]. Does not prevent the creature from being slaughtered while alive, however.

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

|-
| {{text anchor|NOTHOUGHT}}
| Caste
|
| Creature doesn't require a {{token|THOUGHT|body}} body part to survive. Has the added effect of preventing speech, though directly controlling creatures that would otherwise be capable of speaking allows them to engage in conversation.
|}

{{alphabetical TOC|style=margin: 1em auto;}}

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

|-
| {{text anchor|ODOR_LEVEL}}
| Caste
|
*number
| How easy the creature is to [[smell]]. The higher the number, the easier the creature is to sniff out. Defaults to 50. Vanilla creatures have values from 0 (undetectable) to 90 (noticeable by humans and dwarves).

|-
| {{text anchor|ODOR_STRING}}
| Caste
|
*string
| What the creature [[smell]]s like. If no odor string is defined, the creature name (not the caste name) is used.

|-
| {{text anchor|OPPOSED_TO_LIFE}}
| Caste
|
| Is hostile to all creatures except undead and other non-living ones and will show {{DFtext|Opposed to life|0:1}} in the [[unit list]]. Used by [[undead]] in the vanilla game. Functions without the {{token|NOT_LIVING|c}} token, and seems to imply said token as well. Undead will not be hostile to otherwise-living creatures given this token. Living creatures given this token will attack living creatures that lack it, while ignoring other living creatures that also have this token.

|-
| {{text anchor|ORIENTATION}}
| Caste
|
*MALE/FEMALE
*disinterested chance
*casual chance
*strong chance
| Determines caste's likelihood of having sexual attraction to certain sexes. Values default to 75:20:5 for the same sex and 5:20:75 for the opposite sex. The first value indicates how likely to be entirely uninterested in the sex, the second decides if the creature will be able to become lovers with that sex, the third decides whether they will be able to marry in worldgen and post-worldgen world activities (which implies being able to become lovers). Marriage seems to be able to happen in fort mode play regardless, as long as they are lovers first.

|-
| {{text anchor|OUTSIDER_CONTROLLABLE}}
| Caste
|
| Lets you play as an [[Adventurer_mode_character_creation#Outsider|outsider]] of this species in adventure mode.

|}

{{alphabetical TOC|style=margin: 1em auto;}}

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

|-
| {{text anchor|PACK_ANIMAL}}
| Caste
|
| Allows the creature to be used as a pack animal. Used by [[trading|merchants]] without wagons and adventurers. Also prevents creature from dropping hauled items on its own -- do ''not'' use for player-controllable creatures! May lead to the creature being domesticated during worldgen, even if it doesn't have {{token|COMMON_DOMESTIC|c}}.

Creatures with this tag but without {{token|BENIGN|c}}, and/or with {{token|LARGE_PREDATOR|c}} leads to hauled items being dropped.

|-
| {{text anchor|PARALYZEIMMUNE}}
| Caste
|
| The creature is immune to all [[Syndrome#CE_PARALYSIS|paralyzing]] special attacks.

|-
| {{text anchor|PATTERNFLIER}}
| Caste
|
| Used to control the bat riders with paralyze-dart blowguns that flew through the 2D chasm. Doesn't do anything now.

|-
| {{text anchor|PCG_LAYERING}}
| Creature
|
*[[Procedural graphics layer|Layering type]]
| Adds a layer to the current {{token|PROCEDURAL_CREATURE_GRAPHICS|c}} definition.

|-
| {{text anchor|PEARL}}
| Caste
|
| Does nothing.

|-
| {{text anchor|PENETRATEPOWER}}
| Caste
|
*value
| Controls the ability of [[vermin]] to find a way into containers when they are eating food from your stockpiles.

Objects made of most materials (e.g. metal) roll a number from 0-100, and if the resulting number is greater than the penetrate power, their contents escape for the time being. Objects made of [[wood]], [[leather]], [[amber]], or [[coral]] roll 0-95, and items made of [[cloth]] roll 0-90.

|-
| {{text anchor|PERSONALITY}}
| Caste
|
*ATTRIBUTE
*lowest
*median
*highest
| Determines the range and chance of personality facets. Standard is 0:50:100. See [[personality facet]] for more info.

|-
| {{text anchor|PET}}
| Caste
|
| Allows the creature to be [[Animal_trainer|tamed]] in Fortress mode. Prerequisite for all other working animal roles. Civilizations that encounter it in worldgen will tame and domesticate it for their own use. Adding this to civilization members will classify them as pets instead of citizens, with all the [[Fun|problems]] that entails. However, you can solve these problems using the popular plugin [https://dffd.bay12games.com/file.php?id=13095| Dwarf Therapist], which is completely unaffected by the tag.

|-
| {{text anchor|PET_EXOTIC}}
| Caste
|
| Allows the creature to be [[Animal_trainer|tamed]] in Fortress mode. Prequisite for all other working animal roles. Civilizations cannot domesticate it in worldgen, with certain exceptions. More difficult to tame?{{verify}} Adding this to civilization members will classify them as pets instead of citizens, with all the [[Fun|problems]] that entails. ([[Gremlin|Example]]).

|-
| {{text anchor|PETVALUE}}
| Caste
|
*value
| How valuable a tamed animal is. Actual cost in points in the embarking screen is 1+(PETVALUE/2) for an untrained animal, 1+PETVALUE for a war/hunting one.

|-
| {{text anchor|PETVALUE_DIVISOR}}
| Caste
|
*value
| Divides the creature's {{token|PETVALUE|c}} by the specified number. Used by [[honey bee]]s to prevent a single hive from being worth a fortune.

|-
| {{text anchor|PHYS_ATT_CAP_PERC}}
| Caste
|
*[[Attribute|ATTRIBUTE]] Token
*Cap %
|Default is 200. This means you can increase your attribute to 200% of its starting value (or the average value + your starting value if that is higher).

|-
| {{text anchor|PHYS_ATT_RANGE}}
| Caste
|
*[[Attribute|ATTRIBUTE]]
*lowest
*lower
*low
*median
*high
*higher
*highest
| Sets up a [[Attribute#Body_attributes|physical attribute]]'s range of values (0-5000). All physical attribute ranges default to 200:700:900:1000:1100:1300:2000.

|-
| {{text anchor|PHYS_ATT_RATES}}
| Caste
|
*[[Attribute|ATTRIBUTE]] Token
*cost to improve
*unused counter rate
*rust counter rate
*demotion counter rate
| [[Attribute#Body_attributes|Physical attribute]] gain/decay rates. Lower numbers in the last three slots make decay occur faster. Defaults for STRENGTH, AGILITY, TOUGHNESS, and ENDURANCE are 500:3:4:3, while RECUPERATION and DISEASE_RESISTANCE default to 500:NONE:NONE:NONE.

|-
| {{text anchor|PLUS_BP_GROUP}}
| Caste
|
*BY_TYPE, BY_CATEGORY, or BY_TOKEN
*body type, category, or token
| Adds a body part group to selected body part group. Presumably used immediately after {{token|SET_BP_GROUP|c}}.

|-
| {{text anchor|PLUS_MATERIAL}}
| Creature
|
*material
| Adds a material to selected materials. Used immediately after {{token|SELECT_MATERIAL|c}}.

|-
| {{text anchor|POP_RATIO}}
| Caste
|
*number (max 100000)
| Weighted population of caste; Lower is rarer. Not to be confused with {{token|FREQUENCY|c}}. A weight of 0 will{{version|51.06 experimental}} prevent a caste from spawning naturally. Regardless of pop ratio, [[Position token|Position]]s that only allow a certain caste can force it to spawn.

|-
| {{text anchor|POPULATION_NUMBER}}
| Creature
|
*min
*max
| The minimum/maximum numbers of how many of these creatures are present in each world map tile of the appropriate region. Defaults to 1:1 if not specified. If the creature's chosen {{token|CLUSTER_NUMBER|c}} happens to be larger, it will be used instead.

|-
| {{text anchor|POWER}}
| Caste
|
| Allows the being to represent itself as a deity, allowing it to become the leader of a civilized group. Not used by any creatures in the vanilla game. Requires {{token|CAN_SPEAK|c}} to actually do anything more than settle at a location (e.g. write books, lead armies, profane temples). Doesn't appear to do anything for creatures that are already civilized. Once the creature ascends to a position of leadership, it will proceed to act as a standard ruler for their entity and fulfill the same functions (hold tournaments, tame creatures, etc.).

|-
| {{text anchor|PREFSTRING}}
| Creature
|
*string
| Sets what other creatures [[Preferences|prefer]] about this creature. "Urist likes dwarves for their beards." Multiple entries will be chosen from at random. Creatures lacking a PREFSTRING token will never appear under another's preferences.

|-
| {{text anchor|PROCEDURAL_CREATURE_GRAPHICS}}
| Creature
|
* [[Graphics_token#Basic_creature_sprite_types|Sprite type]] or Caste then sprite type
| Makes the creature have procedural graphics built for it, like forgotten beasts/demons/titans/experiments. Must be associated with PCG_LAYERING tokens.

|-
| {{text anchor|PROFESSION_NAME}}
| Creature
|
*[[Unit type token]] (Profession)
*singular
*plural
| The generic name for members of this profession, at the creature level. In order to give members of specific castes different names for professions, use {{token|CASTE_PROFESSION_NAME|c}} instead.

|-
| {{text anchor|PRONE_TO_RAGE}}
| Caste
|
*Chance
| Creature has a percentage chance to flip out at visible non-friendly creatures. Enraged creatures attack anything regardless of timidity and get a strength bonus to their hits. This is what makes [[badger]]s so hardcore.

|-
| {{text anchor|PUS}}
| Caste
|
* <[[material token]]>
* <[[Material_definition_token#Material_States|material state]]>
| The creature has pus. Specifies the stuff secreted by [[Health_care#Infection|infected wounds]].
|}

{{alphabetical TOC|style=margin: 1em auto;}}

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

|-
| {{text anchor|RELSIZE}}
| Caste
|
*BY_CATEGORY, BY_TYPE, BY_TOKEN
*body category, type, or token
*Relsize
| Specifies a new relative size for a part than what is stated in the body plan. For example, dwarves have larger livers.

|-
| {{text anchor|REMAINS}}
| Caste
|
*singular
*plural
| What the creature's [[remains]] are called.

|-
| {{text anchor|REMAINS_COLOR}}
| Caste
|
| What color the creature's [[remains]] are.

|-
| {{text anchor|REMAINS_ON_VERMIN_BITE_DEATH}}
| Caste
|
| Goes with {{token|VERMIN_BITE|c}} and {{token|DIE_WHEN_VERMIN_BITE|c}}, the vermin creature will leave remains on death when biting. Leaving this tag out will cause the creature to disappear entirely after it bites.

|-
| {{text anchor|REMAINS_UNDETERMINED}}
| Caste
|
| Nothing.

|-
| {{text anchor|REMOVE_MATERIAL}}
| Creature
|
*material token
| Removes a material from the creature.

|-
| {{text anchor|REMOVE_TISSUE}}
| Creature
|
*tissue token
| Removes a tissue from the creature.

|-
| {{text anchor|RETRACT_INTO_BP}}
| Caste
|
*BY_TYPE, BY_CATEGORY or BY_TOKEN
*body type, [[Body_token#CATEGORY|category]], or [[Body_token#BP|token]]
*Second person ("You") retract verb text
*Third person ("The giant snail") retract verb text
*Second person cancel retract text
*Third person cancel retract text
| The creature will retract into the specified body part(s) when threatened. It will be unable to move or attack, but enemies will only be able to attack the specified body part(s). When one of the specified body part is severed off, the creature automatically unretracts and cannot retract anymore. More than one body part can be selected by using BY_TYPE or BY_CATEGORY.

Second-person descriptions are used for adventurer mode natural ability. "<pro_pos>" can be used in the descriptions, being replaced with the proper pronoun (or lack thereof) in-game.

Undead curled up creatures are buggy, specifically those that retract into their upper bodies: [[echidna]]s, [[hedgehog]]s and [[pangolin]]s.{{bug|11463}}{{bug|10519}} The upper body is prevented from collapsing by a separate body part (the middle spine), which cannot be attacked when the creature is retracted. See {{token|PREVENTS_PARENT_COLLAPSE|bo}}. Living creatures eventually succumb to blood loss, but undead creatures do not. Giant creatures also take a very long time to bleed out.
|-
| {{text anchor|RETURNS_VERMIN_KILLS_TO_OWNER}}
| Creature
|
| Cat behavior. If it kills a vermin creature and has an owner, it carries the remains in its mouth and drops them at their feet. Requires {{token|HUNTS_VERMIN|c}}.

|-
| {{text anchor|ROOT_AROUND}}
| Caste
|
*BY_TYPE, BY_CATEGORY or BY_TOKEN
*body type, [[Body_token#CATEGORY|category]], or [[Body_token#BP|token]]
*Second person ("You") verb text
*Third person ("The hen") verb text
| Creature will occasionally root around in the grass, looking for insects. Used for flavor in Adventurer Mode, spawns vermin edible for this creature in Fortress Mode. Creatures missing the specified body part will be unable to perform this action. The action produces a message (visible in adventure mode) in the form:

{{DFtext|[creature] [verb text] the [description of creature's location].|6:0}}

In adventure mode, the "rooting around" ability will be included in the "natural abilities" menu, represented by its second person verb text.

|}

{{alphabetical TOC|style=margin: 1em auto;}}

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

|-
| {{text anchor|SAVAGE}}
| Creature
|
| The creature will only show up in "savage" biomes. Has no effect on cavern creatures. Cannot be combined with {{token|GOOD|c}} or {{token|EVIL|c}}.

|-
| {{text anchor|SECRETION}}
| Caste
|
*<[[material token]]>
*<[[Material_definition_token#Material_States|material state]]>
*BY_TOKEN / BY_CATEGORY / BY_TYPE
*<[[Body_token#BP|body part ID]]> / <[[Body_token#CATEGORY|category]]> or ALL / <type (e.g. [[Body_token#GRASP|GRASP]])>
*<[[Body_detail_plan_token#BP_LAYERS|tissue layer]]> or ALL
*<trigger>
| Causes the specified tissue layer(s) of the indicated body part(s) to secrete the designated material. A size 100 ('covering') [[contaminant]] is created over the affected body part(s) in its specified material state (and at the temperature appropriate to this state) when the trigger condition is met, as long as one of the secretory tissue layers is still intact. Valid triggers are:
*'''CONTINUOUS'''
Secretion occurs once every 40 [[time|ticks]] in [[fortress mode]], and every tick in [[adventurer mode]].
*'''EXERTION'''
Secretion occurs continuously (at the rate described above) whilst the creature is at minimum {{Tile|Tired|6:1}} following physical exertion. Note that this cannot occur if the creature has {{token|NOEXERT|c}}.
*'''EXTREME_EMOTION'''
Secretion occurs continuously (as above) whilst the creature is distressed. Cannot occur in creatures with {{token|NOEMOTION|c}}.

|-
| {{text anchor|SELECT_ADDITIONAL_CASTE}}
| Creature
|
*<caste>
| Adds an additional previously defined caste to the selection. Used after {{token|SELECT_CASTE|c}}.

|-
| {{text anchor|SELECT_CASTE}}
| Creature
|
*<caste> or ALL
| Selects a previously defined caste

|-
| {{text anchor|SELECT_MATERIAL}}
| Creature
|
*<[[material token]]>
| Selects a locally defined material. Can be ALL.

|-
| {{text anchor|SELECT_TISSUE}}
| Creature
|
*tissue token
| Selects a tissue for editing.

|-
| {{text anchor|SEMIMEGABEAST}}
| Caste
|
| Essentially the same as {{token|MEGABEAST|c}}, but more of them are created during worldgen. See the [[semi-megabeast]] page for details.

|-
| {{text anchor|SENSE_CREATURE_CLASS}}
| Caste
|
* <[[Creature_token#CREATURE_CLASS|creature class]]>
* [[Tilesets|<tile value or character>]]
* [[Color#Color_values|<foreground color>:<background color>:<foreground brightness>]]
| Gives the creature the ability to sense creatures belonging to the specified [[Creature_token#CREATURE_CLASS|creature class]] even when they lie far beyond line of sight, including through walls and floors. It also appears to reduce or negate the combat penalty of [[Wound#Blindness|blind]] units when fighting creatures they can sense. In [[adventure mode]], the specified tile will be used to represent sensed creatures when they cannot be seen directly.

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

|-
| {{text anchor|SKILL_LEARN_RATE}}
| Caste
|
*<[[skill_token]]>
*<percentage>
| The rate at which this creature learns this skill. Requires {{token|CAN_LEARN|c}} or {{token|INTELLIGENT|c}} to function.

|-
| {{text anchor|SKILL_LEARN_RATES}}
| Caste
|
*<percentage>
| The rate at which this creature learns all skills. Requires {{token|CAN_LEARN|c}} or {{token|INTELLIGENT|c}} to function.

|-
| {{text anchor|SKILL_RATE}}
| Caste
|
*[[skill_token]]
*<% of improvement points gained>
*<unused counter rate>
*<rust counter rate>
*<demotion counter rate>
| Like {{token|SKILL_RATES|c}}, but applies to individual skills instead. Requires {{token|CAN_LEARN|c}} or {{token|INTELLIGENT|c}} to function.

|-
| {{text anchor|SKILL_RATES}}
| Caste
|
*<% of improvement points gained>
*<unused counter rate>
*<rust counter rate>
*<demotion counter rate>
| Affects skill gain and decay. Lower numbers in the last three slots make decay occur faster ([SKILL_RATES:100:1:1:1] would cause rapid decay). The counter rates may also be replaced with NONE.
Default is [SKILL_RATES:100:8:16:16]. Requires {{token|CAN_LEARN|c}} or {{token|INTELLIGENT|c}} to function.

|-
| {{text anchor|SKILL_RUST_RATE}}
| Caste
|
*[[skill_token]]
*value
*value
*value
| The rate at which this skill decays. Lower values cause the skill to decay faster. Requires {{token|CAN_LEARN|c}} or {{token|INTELLIGENT|c}} to function.

|-
| {{text anchor|SKILL_RUST_RATES}}
| Caste
|
*value
*value
*value
| The rate at which all skills decay. Lower values cause the skills to decay faster. Requires {{token|CAN_LEARN|c}} or {{token|INTELLIGENT|c}} to function.

|-
| {{text anchor|SLAIN_CASTE_SPEECH}}
| Caste
|
*[[Speech file|text set]]
| Caste-specific {{token|SLAIN_SPEECH|c}}.

|-
| {{text anchor|SLAIN_SPEECH}}
| Creature
|
*[[Speech file|text set]]
| Boasting speeches relating to killing this creature. Examples include [[text_dwarf.txt/raw|text_dwarf.txt]] (<code>[SLAIN_SPEECH:SLAIN_DWARF]</code>) and text_elf.txt (<code>[SLAIN_SPEECH:SLAIN_ELF]</code>) in data\vanilla\vanilla_creatures\objects.

|-
| {{text anchor|SLOW_LEARNER}}
| Caste
|
| Shorthand for {{token|CAN_LEARN|c}} + <code>[[Creature_token#SKILL_LEARN_RATES|[SKILL_LEARN_RATES:50]]]</code>.{{verify}} Used by a number of 'primitive' creatures (like [[ogre]]s, [[giant]]s and [[troglodyte]]s) in the vanilla game. Applicable to player races. Prevents a player from recruiting nobility, even basic ones. Subterranean creatures with this token combined with {{token|EVIL|c}} will become servants of goblins in their civilizations, in the style of [[troll]]s.

|-
| {{text anchor|SMALL_REMAINS}}
| Caste
|
| Creature leaves "[[item token#REMAINS|remains]]" instead of a corpse. Used by [[vermin]].

|-
| {{text anchor|SMELL_TRIGGER}}
| Caste
|
*value
| Determines how keen a creature's sense of smell is - lower is better. At 10000, a creature cannot smell at all.

|-
| {{text anchor|SOLDIER_ALTTILE}}
| Creature
|
*'character' or tile number
| If this creature is active in its civilization's military, it will blink between its default tile and this one.

|-
| {{text anchor|SOUND}}
| Caste
|
* Sound application (currently accepts ALERT or PEACEFUL_INTERMITTENT)
* Sound range (in tiles)
* Sound delay (lower values = sound is produced more often)
* VOCALIZATION or NONE (determines whether the sound requires breathing or not)
* First-person description
* Third-person description
* Description when out of sight
| Creature makes sounds periodically, which can be heard in Adventure mode.
* First-person reads "You '''bark'''"
* Third-person reads "The [[capybara]] '''barks'''"
* Out of sight reads "You hear '''a loud bark'''"
with the text in bold being the description arguments of the token.

|-
| {{text anchor|SOURCE_HFID}}
| Creature
|
*Integer
| Found on generated [[angel]]s. This is the historical figure ID of the deity with which the angel is associated. Since HFIDs are not predictable before worldgen, this isn't terribly usable in mods.

|-
| {{text anchor|SPECIFIC_FOOD}}
| Caste
|
* PLANT or CREATURE
* Plant/creature ID
| Creature will only appear in biomes with this plant or creature available. Grazers given a specific type of grass (such as [[panda]]s and [[bamboo]]) will only eat that grass and nothing else, risking starvation if there's none available.

|-
| {{text anchor|SPHERE}}
| Creature
|
* [[Sphere#Available_spheres|sphere]]
| Sets what religious spheres the creature is aligned to, for purposes of being worshipped via the {{token|POWER|c}} token. Also affects the creature's name.

|-
| {{text anchor|SPOUSE_CONVERSION_TARGET}}
| Caste
|
| This creature can be converted by a night creature with {{token|SPOUSE_CONVERTER|c}}.

|-
| {{text anchor|SPOUSE_CONVERTER}}
| Caste
|
| If the creature has the {{token|NIGHT_CREATURE_HUNTER|c}} tag, it will kidnap {{token|SPOUSE_CONVERSION_TARGET|c}}s and transform them into the caste of its species with the {{token|CONVERTED_SPOUSE|c}} tag during worldgen. It may also start families this way.

|-
| {{text anchor|SPREAD_EVIL_SPHERES_IF_RULER}}
| Caste
|
| If the creature rules over a [[site]], it will cause the local landscape to be corrupted into [[Surroundings#Evil|evil surroundings]] associated with the creature's [[Creature_token#SPHERE|sphere]]s. The creature must have at least one of the following [[sphere]]s for this to take effect: BLIGHT, DEATH, DISEASE, DEFORMITY, NIGHTMARES. The first three kill vegetation, while the others sometimes do. The last two get [[Plant_token#EVIL|evil plants]] and [[Creature_token#EVIL|evil animals]] sometimes. NIGHTMARES gets [[bogeyman|bogeymen]]. [http://www.bay12forums.com/smf/index.php?topic=169696.msg8162224#msg8162224] Used by [[demon]]s in the vanilla game.

|-
| {{text anchor|STANCE_CLIMBER}}
| Caste
|
| Caste does not require <code>[[Body_token#GRASP|[GRASP]]]</code> body parts to climb -- it can climb with <code>[[Body_token#STANCE|[STANCE]]]</code> parts instead.

|-
| {{text anchor|STANDARD_GRAZER}}
| Caste
|
| Acts as {{token|GRAZER|c}} but set to 20000*G*(max size)^(-3/4), where G defaults to 100 but can be set in d_init, and the whole thing is trapped between 150 and 3 million. Used for all grazers in the default creature raws.

|-
| {{text anchor|STRANGE_MOODS}}
| Caste
|
| The creature will get [[strange mood]]s in fortress mode and can produce artifacts.

|-
| {{text anchor|SUPERNATURAL}}
| Caste
|
| Gives the creature knowledge of any secrets with <code>[[Interaction_token#IS_SECRET|[SUPERNATURAL_LEARNING_POSSIBLE]]]</code> that match its [[Creature_token#SPHERE|spheres]] and also prevents it from becoming a [[vampire]] or [[werebeast]]. Other effects are unknown.

|-
| {{text anchor|SWIMS_INNATE}}
| Caste
|
| The creature naturally knows how to swim perfectly and does not use the [[swimmer]] skill, as opposed to {{token|SWIMS_LEARNED|c}} below. However, Fortress mode AI never paths into water anyway, so it's less useful there.

|-
| {{text anchor|SWIMS_LEARNED}}
| Caste
|
| The creature swims only as well as their present [[Swimmer|swimming skill]] allows them to.

|-
| {{text anchor|SYNDROME_DILUTION_FACTOR}}
| Caste
| <[[Syndrome#SYN_IDENTIFIER|syndrome identifier]]>:<percentage>
| Dilutes the effects of syndromes which have the specified identifier. A percentage of 100 is equal to the regular syndrome effect severity, higher percentages reduce severity.
|}

{{alphabetical TOC|style=margin: 1em auto;}}

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

|-
| {{text anchor|TENDONS}}
| Caste
|
* [[material token]]
*healing rate
| The creature has tendons in its {{token|CONNECTIVE_TISSUE_ANCHOR|td}} tissues (bone or chitin by default). Cutting the bone/chitin tissue severs the tendons, disabling motor function if the target is a limb.

|-
| {{text anchor|THICKWEB}}
| Caste
|
| The creature's [[web]]s can catch larger creatures.

|-
| {{text anchor|TISSUE}}
| Creature
|
*name
| Begins defining a tissue in the creature file. Follow this with standard tissue definition tokens to define the tissue properties.

|-
| {{text anchor|TISSUE_LAYER}}
| Caste
|
*BY_TYPE, BY_CATEGORY, BY_TOKEN
*TYPE,CATEGORY, or TOKEN
*TISSUE
*LOCATION
| Adds the tissue layer to wherever it is required.
Non-argument Locations can be FRONT, RIGHT, LEFT, TOP, BOTTOM. Argument locations are AROUND and CLEANS, requiring a further body part and a % of coverage/cleansing

|-
| {{text anchor|TISSUE_LAYER_OVER}}
| Caste
|
*BY_TYPE, BY_CATEGORY, BY_TOKEN
*TYPE,CATEGORY, or TOKEN
*TISSUE
*LOCATION
| Alias for TISSUE_LAYER

|-
| {{text anchor|TISSUE_LAYER_UNDER}}
| Caste
|
*BY_TYPE, BY_CATEGORY, BY_TOKEN
*TYPE,CATEGORY, or TOKEN
*TISSUE
| Adds the tissue layer under a given part.
For example, an [[iron man]] has a gaseous poison within, and this tissue (GAS is its name) has the token [TISSUE_LEAKS] and its state is GAS, so when you puncture the iron outside and damage this tissue it leaks gas (can have a syndrome by using a previous one in the creature sample.) [TISSUE_LAYER_UNDER:BY_CATEGORY:ALL:{tissue}] {tissue} is what will be under the TISSUE_LAYER; here is an example Tissue from the 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]

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

|-
| {{text anchor|TRADE_CAPACITY}}
| Caste
|
*number
| How much the creature can carry when used by merchants. 1000 by default. Completely ignored if the animal does not also have PACK_ANIMAL or WAGON, instead using BODY_SIZE^(2/3)/20, even if they're a pack animal due to ANIMAL_ALWAYS_PACK_ANIMAL.

|-
| {{text anchor|TRAINABLE}}
| Caste
|
| Shortcut for {{token|TRAINABLE_HUNTING|c}} + {{token|TRAINABLE_WAR|c}}.

|-
| {{text anchor|TRAINABLE_HUNTING}}
| Caste
|
| Can be [[Animal trainer|trained]] as a hunting beast, increasing speed.

|-
| {{text anchor|TRAINABLE_WAR}}
| Caste
|
| Can be [[Animal trainer|trained]] as a war beast, increasing strength and endurance.

|-
| {{text anchor|TRANCES}}
| Caste
|
| Allows the creature to go into [[martial trance]]s. Used by dwarves in the vanilla game.

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

|-
| {{text anchor|TRIGGERABLE_GROUP}}
| Creature
|
*min
*max
| A large swarm of vermin can be disturbed, usually in adventurer mode.

|-
| {{text anchor|TSU_NOUN}}
| Caste
|
*noun
*SINGULAR or PLURAL
| Noun for the {{token|TISSUE_STYLE_UNIT|c}}, used in the description of the tissue layer's style.
|}

{{alphabetical TOC|style=margin: 1em auto;}}

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

|-
| {{text anchor|UBIQUITOUS}}
| Creature
|
| Creature will occur in every region with the correct biome. Does not apply to {{token|EVIL|c}}/{{token|GOOD|c}} tags. Supersedes {{token|FREQUENCY|c}} for the purposes of distributing populations through the map, they are present in every part of the valid biome. Respects {{token|FREQUENCY|c}} for the frequency of unit [[Creature token#CLUSTER_NUMBER|cluster]] spawns being of this species.

|-
| {{text anchor|UNDERGROUND_DEPTH}}
| Creature
|
*mindepth
*maxdepth
| Depth that the creature appears underground. Numbers can be from 0 to 5. 0 is actually 'above ground' and can be used if the creature is to appear both above and below ground. Values from 1-3 are the respective [[cavern]] levels, 4 is the [[magma sea]] and 5 is the [[HFS]]. A single argument may be used instead of min and max. [[Demon]]s use only 5:5; user-defined creatures with both this depth and {{token|FLIER}} will take part in the initial wave from the HFS alongside generated demons, but without {{token|FLIER}} they will only spawn from the map edges. Civilizations that can use underground plants or animals will only export (via the embark screen or caravans) things that are available at depth 1.

|-
| {{text anchor|UNDERSWIM}}
| Caste
|
| The creature is displayed as blue when in [[Water#Depth|7/7 water]]. Used on fish and amphibious creatures which swim under the water.

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

|-
| {{text anchor|USE_CASTE}}
| Creature
|
*new caste token
*old caste token
| Defines a new caste derived directly from a previous caste. The new caste inherits all properties of the old one. The effect of this tag is automatic if one has not yet defined any castes: "Any caste-level tag that occurs before castes are explicitly declared is saved up and placed on any caste that is declared later, unless the caste is explicitly derived from another caste."
Roostre: "When DF detects duplicate tokens in the raws of the same object, a failsafe seems to kick in; it takes the bottom-most of the duplicates, and disregards the others. In the case of tokens added by a mod, it prioritizes the duplicate in the mod." This means that if a tag is defined in the base-caste and redefined in the derived caste, the derived tag overwrites the base tag.

|-
| {{text anchor|USE_MATERIAL}}
| Creature
|
*new material ID
*old material ID
| Defines a new local creature material and populates it with all properties defined in the specified local creature material.

|-
| {{text anchor|USE_MATERIAL_TEMPLATE}}
| Creature
|
*new material token
*material template
| Defines a new local creature material and populates it with all properties defined in the specified template. [http://www.bay12forums.com/smf/index.php?topic=175437.msg8441368#msg8441368 There seems to be a limit of 200 materials per creature].

|-
| {{text anchor|USE_TISSUE}}
| Creature
|
*new tissue token
*old tissue id
| Defines a new local creature tissue and populates it with all properties defined in the local tissue specified in the second argument.

|-
| {{text anchor|USE_TISSUE_TEMPLATE}}
| Creature
|
*new tissue token
*tissue template
| Loads a tissue template listed in OBJECT:TISSUE_TEMPLATE files, such as tissue_template_default.txt.

|-
| {{text anchor|UTTERANCES}}
| Creature
|
| Changes the language of the creature into unintelligible 'kobold-speak', which creatures of other species will be unable to understand. If a civilized creature has this and is not part of a {{token|SKULKING|e}} civ, it will tend to start wars with all nearby civilizations and will be unable to make peace treaties due to 'inability to communicate'.
|}

{{alphabetical TOC|style=margin: 1em auto;}}

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

|-
| {{text anchor|VEGETATION}}
| Caste
|
| Like {{token|AT_PEACE_WITH_WILDLIFE}}, but also makes the creature more valued in artwork by civilisations with the PLANT [[sphere]]. [http://www.bay12forums.com/smf/index.php?topic=169696.msg8316954#msg8316954] Used by [[grimeling]]s in the vanilla game.

|-
| {{text anchor|VERMIN_BITE}}
| Caste
|
*chance of occurrence{{verify}}
*verb (bitten, stung, etc.)
* [[material token]]
* [[Material_definition_token#Material_States|material state]]
| Enables vermin to bite other creatures, injecting the specified material. See {{token|SPECIALATTACK_INJECT_EXTRACT|c}} for details about injection - this token presumably works in a similar manner.{{verify}}

|-
| {{text anchor|VERMIN_EATER}}
| Creature
|
| The vermin creature will attempt to eat exposed food. See {{token|PENETRATEPOWER|c}}. Distinct from {{token|VERMIN_ROTTER|c}}.

|-
| {{text anchor|VERMIN_FISH}}
| Creature
|
| The vermin appears in [[water]] and will attempt to swim around.

|-
| {{text anchor|VERMIN_GROUNDER}}
| Creature
|
| The creature appears in "general" surface ground locations. Note that this doesn't stop the creature from flying if it can (most vermin birds have this tag).

|-
| {{text anchor|VERMIN_HATEABLE}}
| Caste
|
| Some dwarves will [[Preferences|hate]] the creature and get unhappy thoughts when around it. See the [[Hateable|list of hateable vermin]] for details.

|-
| {{text anchor|VERMIN_MICRO}}
| Caste
|
| This makes the creature move in a swarm of creatures of the same race as it (e.g. swarm of flies, swarm of ants).

|-
| {{text anchor|VERMIN_NOFISH}}
| Caste
|
| The creature cannot be caught by [[fishing]].

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

|-
| {{text anchor|VERMIN_NOTRAP}}
| Caste
|
| The creature cannot be caught in baited [[animal trap]]s; however, a "[[Trapper|catch live land animal]]" task may still be able to capture one if a dwarf finds one roaming around.

|-
| {{text anchor|VERMIN_ROTTER}}
| Creature
|
| The vermin are attracted to rotting stuff and loose food left in the open and cause unhappy thoughts to dwarves who encounter them. Present on flies, knuckle worms, acorn flies, and blood gnats.

|-
| {{text anchor|VERMIN_SOIL}}
| Creature
|
| The creature randomly appears near dirt or mud, and may be uncovered by creatures that have the {{token|ROOT_AROUND|c}} interaction such as [[goose|geese]] and [[chicken]]s. Dwarves will ignore the creature when given the "Capture live land animal" task.

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

|-
| {{text anchor|VERMINHUNTER}}
| Caste
|
| Old shorthand for "does cat stuff". Contains {{token|AT_PEACE_WITH_WILDLIFE|c}} + {{token|RETURNS_VERMIN_KILLS_TO_OWNER|c}} + {{token|HUNTS_VERMIN|c}} + {{token|ADOPTS_OWNER|c}}.

|-
| {{text anchor|VESPERTINE}}
| Caste
|
| When set, the creature will only appear in the evening (between 8:00 PM and 10:05 PM) in [[Adventurer mode]].

|-
| {{text anchor|VIEWRANGE}}
| Caste
|
*value
| Value should determine how close you have to get to a critter before it attacks (or prevents adv mode travel etc.) Default is 20.

|-
| {{text anchor|VISION_ARC}}
| Caste
|
*binocular vision arc
*non-binocular vision arc
| The width of the creature's vision arcs, in degrees (i.e. 0 to 360). The first number is binocular vision, the second is non-binocular vision. Binocular vision has a minimum of about 10 degrees, monocular, a maximum of about 350 degrees. Values past these limits will be accepted, but will default to ~10 degrees and ~350 degrees respectively. Defaults are 60:120.
|}

{{alphabetical TOC|style=margin: 1em auto;}}

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

|-
| {{text anchor|WAGON_PULLER}}
| Caste
|
| Allows the creature to pull caravan wagons. If a civilization doesn't have access to any, it is restricted to trading with pack animals.

|-
| {{text anchor|WEBBER}}
| Caste
|
* [[material token]]
| Allows the creature to create [[web]]s, and defines what the webs are made of.

|-
| {{text anchor|WEBIMMUNE}}
| Caste
|
| The creature will not get caught in thick [[web]]s. Used by creatures who can shoot thick webs (such as [[giant cave spider]]s) in order to make them immune to their own attacks.
|}

==Attack Tokens==

Attacks can use four different part selection criteria. Except for TISSUE_LAYER, the base game makes use of all of these in its attacks.

{| {{prettytable}}
|- bgcolor="#ddd"
! width="20%" | Part type token
! width="30%" | Arguments
! width="60%" | Description

|-
| {{text anchor|BODYPART}}
|
* BY_TYPE/BY_TOKEN/BY_CATEGORY
* type/token/category
| This attack uses a particular body part; for example, ATTACK:PUNCH:BODYPART:BY_TYPE:GRASP will make it use any part that can hold onto an object.

|-
| {{text anchor|TISSUE_LAYER}}
|
* BY_TYPE/BY_TOKEN/BY_CATEGORY
* type/token/category
* tissue layer
| This attack uses a specific tissue layer on a specific body part; ATTACK:SCRATCH:TISSUE_LAYER:BY_TYPE:GRASP:BONE will make it use the bone of the hands.

|-
| {{text anchor|CHILD_BODYPART_GROUP}}
|
* BY_TYPE/BY_TOKEN/BY_CATEGORY
* type/token/category
* BY_TYPE/BY_TOKEN/BY_CATEGORY
* type/token/category
| Uses a body part that is subordinate to another; ATTACK:SLAP:CHILD_BODYPART_GROUP:BY_CATEGORY:ARM_LOWER:BY_TYPE:GRASP will make it use every hand attached to each lower arm (so it will generate one attack per lower arm, each of which will use every hand on that arm, assuming there are multiple hands per arm).

|-
| {{text anchor|CHILD_TISSUE_LAYER_GROUP}}
|
* BY_TYPE/BY_TOKEN/BY_CATEGORY
* type/token/category
* BY_TYPE/BY_TOKEN/BY_CATEGORY
* type/token/category
* tissue layer
| As CHILD_BODYPART_GROUP, but specifying a tissue, too; ATTACK:BITE:CHILD_BODYPART_GROUP:BY_CATEGORY:HEAD:BY_CATEGORY:TOOTH

|}

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

|-
| {{text anchor|ATTACK_SKILL}}
| Caste
|
*[[Skill token]]
| Defines the skill used by the attack.

|-
| {{text anchor|ATTACK_VERB}}
| Caste
|
*2nd person
*3rd person
| Descriptive text for the attack.

|-
| {{text anchor|ATTACK_CONTACT_PERC}}
| Caste
|
*% value
| The contact area of the attack, measured in % of the body part's volume. Note that all attack percentages can be more than 100%.

|-
| {{text anchor|ATTACK_PENETRATION_PERC}}
| Caste
|
*% value
| The penetration value of the attack, measured in % of the body part's volume. Requires ATTACK_FLAG_EDGE. Maximum value: 15000.

|-
| {{text anchor|ATTACK_PRIORITY}}
| Caste
|
*MAIN or SECOND
| Usage frequency. MAIN attacks are 100 times more frequently chosen than SECOND. Opportunity attacks ignore this preference.

|-
| {{text anchor|ATTACK_VELOCITY_MODIFIER}}
| Caste
|
*number
| The velocity multiplier of the attack, multiplied by 1000.

|-
| {{text anchor|ATTACK_FLAG_CANLATCH}}
| Caste
|
| Attacks that damage tissue have the chance to latch on in a wrestling hold. The grabbing bodypart can then use the "shake around" wrestling move, causing severe, armor-bypassing tensile damage according to the attacker's body volume.

|-
| {{text anchor|ATTACK_FLAG_WITH}}
| Caste
|
| Displays the name of the body part used to perform an attack while announcing it, e.g. "The weaver punches the bugbat with his right hand".

|-
| {{text anchor|ATTACK_FLAG_EDGE}}
| Caste
|
| The attack is edged, with all the effects on physical resistance and contact area that it entails.

|-
| {{text anchor|ATTACK_PREPARE_AND_RECOVER}}
| Caste
|
* Preparation time
* Recovery time
| Determines the length of time to prepare this attack and until one can perform this attack again. Values appear to be calculated in adventure mode ticks.

|-
| {{text anchor|ATTACK_FLAG_BAD_MULTIATTACK}}
| Caste
|
| Multiple strikes with this attack cannot be performed effectively.

|-
| {{text anchor|ATTACK_FLAG_INDEPENDENT_MULTIATTACK}}
| Caste
|
| Multiple strikes with this attack can be performed with no penalty. The creature will use all attacks with this token at once.

|-
| {{text anchor|SPECIALATTACK_INJECT_EXTRACT}}
| Caste
|
*<[[material token]]>
*<[[Material_definition_token#Material_States|material state]]>
*<min quantity>
*<max quantity>
| When added to an attack, causes the attack to inject the specified material into the victim's bloodstream. Once injected, the material will participate in [[temperature|thermal]] exchange within the creature - injecting something like molten [[iron]] (INORGANIC:IRON:LIQUID) would cause most unmodded creatures to melt (note that some of the injected material also [[contaminant|splatters]] over the bodypart used to carry out the attack, so it should be protected appropriately). If the injected material has an associated [[syndrome]] with the [[Syndrome#SYN_INJECTED|[SYN_INJECTED]]] token, it will be transmitted to the victim. If the attack is blunt, the injected material lacks the [[Material definition token#ENTERS_BLOOD|[ENTERS_BLOOD]]] token, the attacked bodypart has no [[Tissue_definition_token#VASCULAR|[VASCULAR]]] tissues, or the victim is bloodless, the material will splatter over the attacked body part instead.

|-
| {{text anchor|SPECIALATTACK_INTERACTION}}
| Caste
|
*interaction
| When this attack lands successfully, a specified interaction will take effect on the target creature. The attack must break the target creature's skin in order to work. This will take effect in worldgen as well. If the attack would break skin, the interaction will occur '''before the attack actually lands'''.

|-
| {{text anchor|SPECIALATTACK_SUCK_BLOOD}}
| Caste
|
*min
*max
| Successful attack draws out an amount of blood randomized between the min and max value. Beware that this '''will''' trigger any ingestion syndromes attached to the target creature's blood - for example, using this attack on a vampire will turn you into one too.
|}

==Tissue Layer Tokens==
Tissue layers are added to a creature's body parts by the creature tokens [[#TISSUE_LAYER|TISSUE_LAYER]], [[#TISSUE_LAYER_OVER|TISSUE_LAYER_OVER]], [[#TISSUE_LAYER_UNDER|TISSUE_LAYER_UNDER]], and the body detail plan token [[#TL_LAYERS|TL_LAYERS]].

These tissue layers are not the same thing as tissues, which are defined at creature level, but rather applications of the tissues. If the SKIN tissue of a creature is the more general and abstract notion of what skin is for that creature, then a tissue layer may be the "actual" skin on the creature's nose, head, or second toe. As most creatures have more than one body part, tissue layers are normally selected en masse.

Some tissue layer tokens are analogous to tissue definition tokens, e.g. [[#TL_CONNECTS|TL_CONNECTS]] to [[tissue_definition_token#CONNECTS|CONNECTS]].

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

|-
| {{text anchor|SELECT_TISSUE_LAYER}}
| Caste
|
*TISSUE
*BY_CATEGORY, BY_TYPE, BY_TOKEN
*Location - category, type, or token | Selects a tissue at a location
* (optional) FRONT, BACK, LEFT, RIGHT, TOP, BOTTOM, AROUND.
| Begins a selection of tissue layers.
[SELECT_TISSUE_LAYER:HEART:BY_TYPE:HEART]

|-
| {{text anchor|PLUS_TISSUE_LAYER}}
| Caste
|
*TISSUE
*BY_CATEGORY, BY_TYPE, BY_TOKEN
*Location - category, type, or token
| Adds tissue layers to those selected.

|-
| {{text anchor|SET_TL_GROUP}}
| Caste
|
*TISSUE
*BY_CATEGORY, BY_TYPE, BY_TOKEN
*Location - category, type, or token
*tissue
| Begins a selection of tissue layers. Only usable for descriptor and cosmetic purposes.

Research has implied it may be redundant with SELECT_TISSUE_LAYER, as the latter allows for cosmetics as well as "functional" tokens such as TL_MAJOR_ARTERIES. Vanilla raws still use SET_TL_GROUP though, for all cosmetic purposes. More research is needed on this subject.

|-
| {{text anchor|PLUS_TL_GROUP}}
| Caste
|
*BY_CATEGORY, BY_TYPE, BY_TOKEN
*Location - category, type, or token
*tissue
| Adds tissue layers to those selected. Like SET_TL_GROUP, it may be redundant even if used in the vanilla raws.

|-
| {{text anchor|SET_LAYER_TISSUE}}
| Caste
|
*TISSUE
| Sets a selected tissue layer to be made of a different tissue.

|-
| {{text anchor|SHEARABLE_TISSUE_LAYER}}
| Caste
|
* tissue modifier
* required value
| Tissue layer can be sheared for its component material. The specified modifier must be at least of the desired value for shearing to be possible (for example, a [[llama]]'s wool must have a LENGTH of 300 before it is shearable).

|-
| {{text anchor|TISSUE_LAYER_APPEARANCE_MODIFIER}}
| Caste
|
*QUALITY
*lowest
*lower
*low
*median
*high
*higher
*highest
| Sets the range of qualities, including LENGTH, DENSE, HIGH_POSITION, CURLY, GREASY, WRINKLY

|-
| {{text anchor|TISSUE_STYLE_UNIT}}
| Caste
|
*tissue style unit ID
*shaping
| Sets tissue layer to be the target of TISSUE_STYLE token specified for an entity, works only on entity members. Mostly used with tissues HAIR, BEARD, MOUSTACHE, SIDEBURNS.

|-
| {{text anchor|TL_COLOR_MODIFIER}}
| Caste
|
*COLOR
*freq
*COLOR
*freq etc.
| Creates a list of colors/color patterns, giving each a relative frequency. If the given color or pattern does not exist, the tissue is described as being "transparent".

|-
| {{text anchor|TLCM_GENETIC_MODEL}}
| Caste
|
| The way the color modifier is passed on to offspring. May or may not work right now.{{verify}}

|-
| {{text anchor|TLCM_IMPORTANCE}}
| Caste
|
*number
| Presumably modifies the importance of the tissue layer color modifier, for description purposes.
HOWEVER using this appears to remove all mention of colour from creature descriptions. It does not appear in any default creatures.

|-
| {{text anchor|TLCM_NOUN}}
| Caste
|
*name
*SINGULAR or PLURAL
| Names the tissue layer color modifier, and determines the noun. Also used by [[Utility:Stonesense|Stonesense]] for colouring body parts.

|-
| {{text anchor|TLCM_TIMING}}
| Caste
|
*ROOT
*start change window years
*days
*end change window years
*days
| Determines the point in the creature's life when the color change begins and ends.

|-
| {{text anchor|TL_CONNECTS}}
| Caste
|
| Gives the CONNECTS attribute to selected layers.

|-
| {{text anchor|TL_HEALING_RATE}}
| Caste
|
*value
| Changes the HEALING_RATE of the selected tissue layers.

|-
| {{text anchor|TL_MAJOR_ARTERIES}}
| Caste
|
| Gives the "major arteries" attribute to selected layers. Used to add massive bleeding properties to the throat, made from skin.

|-
| {{text anchor|TL_PAIN_RECEPTORS}}
| Caste
|
*value
| Changes the number of pain receptors for selected tissue layers.

|-
| {{text anchor|TL_RELATIVE_THICKNESS}}
| Caste
|
*value
| Changes the relative thickness for selected tissue layers.

|-
| {{text anchor|TL_VASCULAR}}
| Caste
|
*value
| Sets a new VASCULAR value (which modulates bleeding) for selected tissue layers.

|}

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

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

Combat skill

2025-10-04T19:56:43Z

DikbutDaGrate: Yes, bashing with shield trains misc. object user skill.

{{Quality|Exceptional}}
{{av}}
[[File:combat_skill_preview.png|right]]

'''Combat skills''' are a collection of different but interrelated [[skill]]s that, without exception, have an impact on dwarves' and other creatures' [[combat]] effectiveness.

== General combat skills==
General combat skills are a category of skills that are collectively unrelated to whether a dwarf (''or [[human]], perhaps [[elf|leaf-lover]]'') is using weapons or armor, but are useful for combat.
* '''[[Archer]]''' - increases with the use of any ranged attack, including throwing. Its exact function is unknown, except that it was shown to decrease the probability of an enemy dodging a ranged attack. Aside from that, it can serve as an indicator of how much ranged weapons are used.
* '''Biter''' - increases whenever a character chooses to bite an opponent. This is probably the most effective attack for a creature whose biting causes a [[syndrome]], but some [[Immigration|immigrants]] will arrive with this skill as well, and unarmed combatants will occasionally learn a little of this skill when they choose to bite during a combat. Goring with horns and tusks also uses the biting skill.
* '''Dodger''' - aids creatures in avoidance, causing enemies to miss more often. Scanning of combat reports suggest that dodging is very common and effective - assuming that messages referring to dodging are in essence caused by the dodger skill. Dodging can, unfortunately, cause dwarves to fall through Z-levels into [[deep pit]]s, [[water]], or even [[magma]]; they do not attempt to avoid dodging into perilous locales. Dodging can even be done while lying on the ground, making it a particularly valuable skill.
* '''Fighter''' - increases with each melee attack (from or to a target), no matter what kind of weapon is used, and can increase rather quickly. It influences weapon accuracy, though to a lesser extent than particular weapon skills.
* '''Kicker''' - increased by kicking in unarmed combat. Stance strikes from kicking and tail slapping tend to have a blunt [[attack type]], though stings from a [[bark scorpion man]] will also rely on the kicking skill.
* '''Striker''' - increased by throwing punches and scratching with claws or nails in unarmed combat. Creatures with pincers will snatch at targets instead.
* '''[[Wrestling|Wrestler]]''' - pertains to incapacitating enemies by holding limbs. Wrestlers are generally unable to kill ''much'', but they ''may'' make killing easier for their armed comrades - and their punches do kill fellow dwarves when tantruming. Wrestlers can strangle enemies unconscious, break joints, and even take away weapons and armor, but the AI is rather unlikely to do so (making [[adventurer mode|adventurer]]-wrestlers much more effective).
* '''[[Observer]]''' - used to note and anticipate the attacks of enemies. Skilled observers are less likely to be surprised by an opponent's charge, for instance, and less likely to receive a penalty for being attacked from the side. In adventure mode, higher levels of the skill also give more information - which arm/weapon the opponent is using for its next attack, for example.

Your "deflection roll" is based on your armor use skill, but in the first calculation, your dodge roll counts more and replaces your deflection roll if it is higher. That roll is thrown into an equation with the hit roll to get the "squareness" of the attack from 0 to 20. There's some pure luck at this stage, though, and the squareness can sometimes be increased regardless of the rolls. Later, the same deflection roll is used directly with relevant worn items one by one to modify attack momentum using the material/etc. -- dodge rolls don't enter into this. Item familiarity can increase this deflection bonus.

In addition to speed, high armor skill also decreases your "clunkiness" with heavy worn objects. The clunkiness sum applies a minus to many skill rolls (mostly combat, but a few non-combat skills).

== Equipment skills ==
[[File:armor_skill_preview.png|right]]Equipment skills are associated with the use of non-weapon equipment, and as a class increase dwarven survivability.
* '''Armor User''' - related to how well a dwarf moves in [[armor]], and increases whenever a dwarf wearing armor attacks or is attacked, with triple the gain if the dwarf was actually struck on their armor. Higher levels of this skill reduces the encumbrance penalties of armor, allowing dwarves wearing full steel plate and shield to move at normal speed. Arena testing also indicates that armor users become tired less easily than non-armor wearers (300 vs 100 announcements vs bronze colossus). Because even leather [[clothes]] count as armor, this skill often appears at dabbling level on civilians who briefly struggle with a [[kobold]] [[thief]] or predatory animals. A creature with a [[Modding|tough enough body]] will also gain armor user skill when glancing blows are struck to their bare flesh([[Metal|?]]), though anything durable enough to do that would have little need for normal armor. Armor User skill possibly used for shield-based attacks.
{| style="margin: 0 auto; border: 1px solid black; border-spacing: 0"
|-
| width="33%" style="border-right: 1px solid black;" |
{| width="100%"
! align="left" |Skill level !! align="left" |Armor weight
|-
| Novice/Dabbling || align="left" |×1.0
|-
| Adequate (2) || align="left" |×0.8125
|-
| Competent (3) || align="left" |×0.75
|-
| Skilled (4) || align="left" |×0.6875
|-
| Proficient (5) || align="left" |×0.625
|}
| width="33%" style="border-right: 1px solid black;" |
{| width="100%"
! align="left" |Skill level !! align="left" |Armor weight
|-
| Talented (6) || align="left" |×0.5625
|-
| Adept (7) || align="left" |×0.5
|-
| Expert (8) || align="left" |×0.4375
|-
| Professional (9) || align="left" |×0.375
|-
| Accomplished (10) || align="left" |×0.3125
|}
| width="33%" |
{| width="100%"
! align="left" |Skill level !! align="left" |Armor weight
|-
| Great (11) || align="left" |×0.25
|-
| Master (12) || align="left" |×0.1875
|-
| High Master (13) || align="left" |×0.125
|-
| Grand Master (14) || align="left" |×0.0625
|-
| Legendary (15+) || align="left" |×0.0
|}
|}{{verify}}

* '''Shield User''' - increases whenever a dwarf uses a [[shield]] or [[buckler]] to block an attack, which is often. Shields increase the survivability of dwarves a great deal, and can block anything from a [[goblin]] axe to [[dragonfire]].

== Weapon skills ==
[[File:weapon_skill_preview.png|right]]Weapon skills are associated with the use of a particular [[weapon]] type, even if that weapon type is "thrown [[vomit]]" in adventure mode. Arena testing indicates weapon skill is more powerful per-point than any other combat skill (assuming the appropriate weapon is equipped!), it contributes to offensive ability and parrying. The name of many of these skills is dependent on species: a dwarven spear user will be known as a 'Speardwarf'. The fighter skill does everything these do, but less.
* '''Axeman''' - allows characters to use [[battle axe]]s, [[great axe]]s, and [[halberd]]s more effectively.
* '''Blowgunner''' - allows characters to use [[blowgun]]s more effectively.
* '''Bowman''' - allows characters to use [[bow]]s more effectively. ("Bowdwarf" for dwarves).
* '''[[Crossbowman]]''' - allows characters to use [[crossbow]]s more effectively. ('Marksdwarf' for dwarves).
* '''Hammerman''' - allows characters to use [[maul]]s and [[war hammer]]s more effectively, as well as [[crossbow]]s in melee.
* '''Knife User''' - allows characters to use large [[dagger]]s and knives more effectively.
* '''Lasher''' - allows characters to use [[whip]]s and [[scourge]]s more effectively.
* '''Maceman''' - allows characters to use [[flail]]s, [[mace]]s, and [[morningstar]]s more effectively.
* '''[[Miner]]''' - not strictly a weapon skill, but allows characters to use [[pick]]s more effectively as weapons. This is also the only moodable combat-usable skill.
* '''Misc. Object User''' - allows characters to use objects like tables and chairs (''etc.'') more effectively as weapons. In fortress mode, dwarves will often use this skill when attacking with held [[goblet]]s. It also is used with shields, making it useful if a military dwarf is disarmed (either literally or not).
* '''Pikeman''' - allows characters to use [[Pike (weapon)|pike]]s more effectively.
* '''Spearman''' - allows characters to use [[spear]]s more effectively.
* '''Swordsman''' - allows characters to use [[long sword]]s, [[scimitar]]s, [[short sword]]s, and [[two-handed sword]]s more effectively, as well as blowguns and bows in melee.
* '''[[Thrower]]''' - allows characters to throw miscellaneous objects more effectively. Throwing is still as hilariously overpowered as in previous versions - you can, for instance, kill a charging elephant with thrown water. This generally isn't seen in fortress mode, other than the occasional dwarf going on a tantrum and throwing whatever is in their hands.

== See also ==
* [[User:Shinziril#Skills|Outstanding research]] on several combat skills by Shinziril
* A scientific test of how the Archer and Marksdwarf skills affect ranged combat: [http://www.bay12forums.com/smf/index.php?topic=117284.0 Dwarven Research: A Study of the 'Archer' and 'Marksdwarf' Skills]
*A [[Advanced Marksdwarf Training Guide|Marksdwarf Training Guide]] is available to handle many issues and confusion relating to marksdwarves, as well as provide methods to get them more reliably training and firing.
* [http://www.bay12forums.com/smf/index.php?topic=134779.0 Dwarven Research: A Study on Shielding] Explains everything you need to know about shields.

{{skills}}
{{Category|Combat Skills| }}

Animal trainer

2025-08-20T21:55:47Z

DikbutDaGrate: /* Animal knowledge */ Updated citations. Cites two separate Toady One responses. Prior citation listed was practically a fictious reference from all the way in 2013.

{{Quality|Fine}}
{{av}}
{{v50_skill
| color = 2:0
| graphic = [[File:green_sprite_icon.png]]
| graphicmargin = 106px
| skill = Animal Trainer
| profession = [[Ranger]]
| job name = [[Animal training]]
| tasks =
* Train [[dog|war animal]]
* Train [[dog|hunting animal]]
* Train large animal
* Train small animal
| workshop = [[Vermin catcher's shop]]
| attributes =
* Agility
* Toughness
* Endurance
* Intuition
* Patience
* Empathy
}}

'''Animal trainer''' is the skill associated with the '''animal training''' [[labor]]. An animal trainer works with [[animal]]s, either training wild ones or training certain species for war or hunting. They also train certain kinds of captured live [[vermin]].

The Pets/Livestock tab of the citizen information menu ({{menu icon|u}}) has a list of all animals that belong to your civilization, and are tame, trained, or trainable. Each animal on the list can be assigned a trainer, who will then train (if needed) the animal, increase its training (if not already tame) or train it for war or hunting (if selected for hunting or training). Which animals are known and how well can be checked with the "Overall Training" button in the lower right corner of the "Pets/Livestock" tab. There is no way to tame a specific type of vermin.

An [[Activity_zone#Animal_training|animal training zone]] or [[Activity_zone#Pen/Pasture|pasture]] is required for all training activities for animals. Taming vermin instead requires a [[vermin catcher's shop]].

== Domesticating wild animals ==
=== Capture ===
[[File:animal_train_comic.png|thumb|200px|right|The butchers have it worse, they gotta 'obtain' the dogs' leather. Art by p3ach_tea]]In order to train an animal, you must first have an animal to train, so before you can do any training, you must capture some wild animals. Which animals appear at your fortress (and thus which animals you can train, besides the [[Caverns|subterranean]] creatures that are randomly present) is dependent upon your [[surroundings]], which is in turn dependent upon the local [[biome]] or biomes, if your fortress overlaps multiple [[region]]s.

Wild [[creature]]s can only be captured by [[cage trap]]s; as above-ground traffic is, as a rule, unrestricted, and as creatures can enter and exit the map from any direction, the only reliable way to force wildlife into your cages is to build a lot of them. The same is true of the [[caverns]], although since they are usually not nearly so expansive, capturing passing creatures is a little easier; on the other hand, you have to be much more worried about exposing your dwarves to the various subterranean nasties. Note that [[animal trap]]s are ''not'' used in this role, but are instead used by [[trapper]]s to capture live [[vermin]], and thus, surprisingly enough, trappers are not involved in the trapping of actual creatures.

Just because you have a creature stowed away in your cages [[stockpile]], does not mean that it can be trained, as only creatures with the {{token|PET|c}} or {{token|PET_EXOTIC|c}} [[creature token]] can be trained. Most creatures have one of the two flags, but there are exceptions, notably some underground creatures. Sentient creatures (such as [[goblin]]s or [[animal people]]), [[forgotten beast]]s and [[titan]]s are among the creatures that can never be trained or tamed. Additionally, {{token|TRAPAVOID|c}} creatures ignore cage traps entirely. Captured [[siege|war]] [[mount]]s and any other [[name]]d enemies of your civilization can also be trained, but they will, regardless of training level, remain hostile to your civilization and will, if released from bondage, attack your units without mercy; even worse, these creatures [http://www.bay12forums.com/smf/index.php?topic=111357.0 may cause] a [[loyalty cascade]] if you order your [[military]] to deal with the situation.{{bug|6051}} To make use of captured creatures that you cannot or do not want to train, see [[live training]] and [[mass pitting]].

=== Training ===
{| style="text-align:center; float:right; margin:8px;" class=wikitable
! '''Designation'''
! '''Description'''
|-
| Wild || Not Tame
|-
| Semi-wild || Semi-wild
|-
| Trained || Trained
|-
| -Trained- || Well-trained
|-
| +Trained+ || Skillfully trained
|-
| *Trained* ||Expertly trained
|-
| ≡Trained≡ || Exceptionally trained
|-
| ☼Trained☼ || Masterfully trained
|-
| Domesticated || Tame
|}

Once you have a captured, trainable creature trapped in a cage, you can start training it. You will need an [[Activity zone#Animal training|animal training zone]] and some [[plants]] or [[meat]] depending on whether the animal is herbivorous or carnivorous. To have your animal trainer begin training a wild animal, use {{menu icon|u}} to open the citizen information screen and select the animal menu. Scroll through the list until your captured wild animal is selected and use the whistle icon to set a trainer to train it. Note that if a caged animal is fed a plant, [[seed]]s will stay in the cage. This has no effect on training, but if you later release the animal, you will need to [[Activity zone#Garbage Dump|dump]] the seeds from the cage before it can be reused.

The trainer will bring food to the cage and perform the initial training, setting the animal to one of the trained levels (see table at right). A fully wild animal must be trained from its cage, but once an animal has been initially trained and it is no longer wild, it may be safely released from its cage (and preferably assigned to an enclosed [[pasture]] or [[restraint]], to keep it hemmed in case problems arise later).

A notable exception from "training levels" are animals which are a member of a species your civilization already has domesticated. Only a few of them can occur in the wild to be captured - e.g. [[water buffalo]] and [[turkey]]. Such creatures become fully tame upon the completion of training, and after that they will never require or receive training again, even if assigned to a trainer.

Only wild animals can be trained in a cage. If you want your animal trainer to provide further training you must release the trained animal. Alternatively, with a difficult-to-train animal or a poor trainer, you may want to leave the animal in its cage. A caged animal will eventually revert to its wild state, at which point your trainer will perform the initial training again, safely giving your trainer experience and your civilization more knowledge about the animal. Note that {{token|GRAZER|c}}animals need a pasture to survive, and will die if left to linger in a cage for too long.

The overall difficulty and time required to train an animal is roughly proportional to its [[List of creatures by pet value|pet value]]. As a general guideline, animals with pet values of less than 100 are easy to train, those with values of 100+ take some effort and a few years to train well, and creatures with pet values of 1000+ such as [[dragon]]s are very slow to train.

Adult trained animals will slowly revert to their wild origins over time, and must be permanently scheduled for training (through the Pets/Livestock tab in [[Creatures menu]] {{menu icon|u}}) to ensure they remain friendly, through regular re-training. Trained animals have a quality associated to their training that affects how long they will retain composure before reverting to the wild, but which may have other effects as well. The last state an animal reaches before it becomes fully wild is semi-wild, which prompts an [[announcement]].

Dwarves will instinctively know when their animal training partners need retraining, and will prioritize doing so, but will obviously not be able to if they are [[wound|injured]], experiencing a [[strange mood]], or are otherwise unable to reach their trainees. If you assign a single dwarf to an animal (Any available trainer is also an option) only that dwarf will ever attempt to train or retrain the creature, so care must be taken to keep your trainers healthy and available.

Trading animals brought by [[merchants]] will immediately make them belong to the receiving party. This means that if another civilization brought them as tame animals, and you buy them, they will retain their tame status and will never revert to a wild state. This is also true when you seize the animals, or kill all the merchants. Note that killing all the merchants will '''not''' make the pack animals a part of your civilization, and will become "friendly" and wander around the map. Also, animals that become yours in this way will be in cages at first, so you will have to release them in some way. Due to a bug, the only way to do this is pasturing them and then removing them from the pasture. This is very important if they are grazers as they will starve due to the lack of grass in the cage.

=== Animal knowledge ===

When training animals that your [[civilization]] has never domesticated before, successful training will result in some knowledge being transferred to your civilization every time the dwarven [[caravan]] returns to the mountainhomes. Although a number of farm animals are domesticated by your civilization from the beginning of the game, your fortress cannot individually "civilization-level" domesticate a species.{{cite forum|169696/7990286}}{{cite forum|169696/8134419}}

Every tame animal job increases overall fort training points for that animal by 10, and the fort training knowledge levels are attained at 30, 100, 250 and 500 (it zeroes points when it increases level). War and hunting jobs are also worth 10 points, but a maintenance job is only worth 3. If your fort level is higher than the civ level for a given animal, 10 points of knowledge are transferred with each caravan that gets off the map (so it'd take 88 years worth of caravans to bring the civ all the way up to "expert", but just 3 years to get every subsequent fort to start at "few facts").

The fort level of knowledge has a strong effect on in-fort training. When attempting to train an animal, a skill roll will be matched against a threshold that depends on animal knowledge.
For instance, if you know nothing about the animal, the animal training roll must be 30 to get past semi-wild and 100 to be masterfully trained (with 40/50/65/80 for the others). As you gain knowledge, the thresholds become lower and easier to attain:

*"Few facts": 20/30/40/60/70/90
*"Familiar": 15/20/30/50/60/80
*"Knowledgeable": 10/15/25/40/50/70
*"Expert": 5/10/20/30/40/60

The calculations for skill rolls are complicated, but by these numbers, your trainers are almost twice as good at expert-level fort knowledge, if they weren't already great trainers in their own right (in which case they'll probably crack 100 most times without help).

{|class="wikitable" style="width:80%; align:center"
! Announcement
! Training level in {{k|z}} screen
|-
| {{Gametext|The dwarves of (civ) now know a few facts about (animal) training.|cyan}}
| {{DFtext|A few facts|red}}
|-
| {{Gametext|The dwarves of (civ) have attained a general familiarity with (animal) training methods.|cyan}}
| {{DFtext|General familiarity|yellow}}
|-
| {{Gametext|The dwarves of (civ) are now quite knowledgeable (animal) trainers.|cyan}}
| {{DFtext|Knowledgeable|white}}
|-
| {{Gametext|The dwarves of (civ) are now expert (animal) trainers.|cyan}}
| {{DFtext|Expert|cyan}}
|-
| {{center|-}}
|{{DFtext|Domesticated|lime}}
|}

=== Taming children ===
Animals who can be trained and possess a child state (allowed by the {{token|CHILD}} token) can produce a fully tamed population. Note that animals cannot get pregnant in cages (in fact, this is one of the ''few'' times they can't), so you'll have to move past the initial training stage to have them.

Animals born from a partially-trained mother will not revert to a wild state while they are still children: for example, if a wild female [[wolf]] is captured and trained up to the +T+ level, and gives birth, the pups may forget this "inherited" training, but will never go lower than Semi-Wild while they're still pups. They can, and will, revert to a wild state when they become adult wolves, though going back to a fully wild state will still take some time after they've reached adulthood. The training level of the father does not count for anything when it comes to the child.

Animal children always become fully tame upon receiving training ''once''. This not only allows making children of trained mothers fully tame, it also allows instant taming of caught animal children or of children born in captivity to fully wild mothers. Only children can be permanently tamed, and once the young animal grows up the opportunity for this will no longer be available.[http://www.bay12forums.com/smf/index.php?topic=121150.0 1] Once an animal child becomes fully tame, it will never require training again, nor will it receive any even if assigned to a trainer - this means taming children gives you a fully tame population at the cost of removing a source of experience from your trainers.

Animals in ''Dwarf Fortress'' give birth in one of two ways, either with live birth, or by laying and incubating [[egg]]s. Child-bearing animals that give birth to their young is easy: with an adjacent male of the species, children may be conceived, inheriting their mother's pasture status in the process. Egg-layers are more complicated: The female must be adjacent to a male for fertilization, there must be an open constructed [[nest box]] for the female to occupy and lay a clutch of eggs in, and they and the mother must remain undisturbed during the process as the mother must incubate her eggs; even training is inadmissible. Thus the eggs must be [[forbid]]den and the mother should have her trainer de-assigned during the duration of her stay; they also will ''not'' inherit their mother's pasture status.[http://www.bay12forums.com/smf/index.php?topic=121150.0 1] The resultant children will have the taming status of their mother when they were ''laid'', not hatched.

Creatures missing the {{token|CHILD}} token are considered adults at birth. Because of it, they can never be rendered fully tame and will require re-training for the rest of their lives {{bug|7983}}. Examples of such creatures include [[crundle]]s, [[giant cave spider]]s and [[hydra]]s. Previously [[dragon]]s could not be tamed, however with the release of the steam version, they were given the {{token|CHILD}} token and are now considered adults at age 10, thus allowing [[dragon]]s to be fully tamed by a fortress.

==Animal AI==
If a trained animal is "stray", that is, it's not a pet, it will (usually) wander around your fortress randomly, spending most of its time in meeting areas, and attacking any hostiles that it comes across or wild animals that are attacking citizens. Animals with the {{token|LARGE_PREDATOR}} token are somewhat more aggressive than animals lacking this token, and are more likely to attack hostiles, while animals with a {{token|BENIGN}} token will simply run away from any hostiles, which makes them useless for [[Attack|dwarven]] defense, but they can be used as arrow fodder to keep the enemy entertained while you're bunkering in. Grazing animals should be assigned to a [[pasture]] because they will otherwise starve to death.

A pet or work animal, if not assigned to a pasture, will alternate between following its owner and visiting [[meeting area]]s. Should their owner die, the animal may instead be seen alternating between meeting areas and visiting the site of their death (even if their body is no longer there).

==Hunting/War training==
Some trained animals can receive additional training for hunting or for war, for which you need a [[Zone#Animal_Training|training zone]] and a dwarf with the animal training labor enabled. Then you can go to your Pets/Livestock list and find your trainable animal. Trainable animals are those where you see either war training or hunting training icons in the middle column. If you wish you can also select a particular trainer to perform this task with the first icon in the column.

Some domesticated animal juveniles, such as puppies, are unable to be trained until they reach adulthood, at which point they only need hunting/war training once in their training zone.

===Train a hunting animal===
''This Animal hunts at will.''

This requires an [[Cage|uncaged]] trainable animal with {{token|TRAINABLE|c}} or {{token|TRAINABLE_HUNTING|c}}, an animal training activity zone, and an animal trainer. Note that an animal that is in a pasture can only be trained if the zone is also in the same [[pasture]]. Hunting animals can be assigned to follow a hunter and assist in the hunting process; once assigned they cannot be unassigned. They are intrinsically faster and more agile than a regular animal, and can [[ambusher|sneak]] alongside their partner, but are not as strong as a war animal.

=== Train a war animal ===
''This Animal is waiting for conflict.''

This requires an [[Cage|uncaged]] trainable animal with {{token|TRAINABLE|c}} or {{token|TRAINABLE_WAR|c}}, an animal training activity zone, and an animal trainer. [[Pasture|Pastured]] animals can only be trained if the zone is located within their pasture. War animals are significantly stronger than their untrained counterparts; war dogs make excellent companions when starting a fortress, when you can't spare many dwarves for fighting.

Like hunting animals, they can be assigned to individual dwarves the same way, and cannot be unassigned; combined with their strength, this makes them effective expendable bodyguards for any dwarf likely to see danger or who you feel is valuable enough to be worth protecting. Even if they fail to defeat an attacker, they can often buy their charge time to escape or for additional reinforcements to arrive.

== Bonding ==
As animal trainers work with an animal, they may become [[Relationships|bonded]] to it ("formed a bond with an animal training partner"), and this relationship is visible in the dwarf's relationships screen. This happens even if the dwarf is not specifically assigned to the animal and appears to disregard training quality. The death of a bonded animal results in a bad thought for the trainer ("has lost an animal training partner to tragedy"), whose exact severity is unknown but fairly significant. It is unknown whether working with a bonded animal gives a happy thought similar to the one gained from talking to a friend.

An animal trainer with a preference for the animal may adopt and name the animal at the time of training, even if the animal is not designated for adoption. This leaves the trainer highly susceptible to the bad "pet death" thought, renders the animal inedible, and eventually requires an extra coffin. It may be advisable to disable animal training on any trainer with such a preference, especially for war training.

== Trainable war/hunting animals ==
The following creatures can be trained into war or hunting animals once they are tamed. Bigger animals ''tend'' to be stronger in combat. For comparison, an average adult dwarf is size 60,000.

{| class="wikitable sortable"
! Animal
! Size (cm³)
! Pet value
! Notes
|-
|[[Bobcat]]
|8,000
|75
|Too small ≈
|-
|[[Mandrill]]
|20,000
|50
|^
|-
|[[Lynx]]
|25,000
|75
|^ ≈
|-
|[[Ocelot]]
|25,000
|100
|^ ≈
|-
|[[Dog]]
|30,000
|30
|^ ♪
|-
|[[Cheetah]]
|50,000
|200
|^ ♪ ≈
|-
|[[Leopard]]
|50,000
|100
|^ ♪ ≈
|-
|[[Jaguar]]
|75,000
|100
|† ♪ ≈
|-
|[[Gorilla]]
|150,000
|500
|† ≈
|-
|[[Giant bat]]
|200,000
|750
|♪ Hunting only
|-
|[[Giant cave swallow]]
|200,000
|700
|♪ Hunting only
|-
|[[Grizzly bear]]
|200,000
|500
|† ♪ ≈
|-
|[[Lion]]
|200,000
|200
|† ♪ ≈
|-
|[[Tiger]]
|225,000
|200
|† ♪ ≈
|-
|[[Giant bobcat]]
|256,320
|500
|☼ ≈
|-
|[[Giant mandrill]]
|341,800
|500
|☼
|-
|[[Giant lynx]]
|377,750
|500
|☼ ≈
|-
|[[Giant ocelot]]
|377,750
|500
|☼ ≈
|-
|[[Polar bear]]
|400,000
|500
|☼ ≈
|-
|[[Giant cheetah]]
|560,000
|200
|☼ ♪ ≈
|-
|[[Giant leopard]]
|560,000
|100
|☼ ♪ ≈
|-
|[[Giant jaguar]]
|750,000
|100
|☼ ♪ ≈
|-
|[[Gigantic panda]]
|1,160,900
|1,000
|☼ ‼ ≈
|-
|[[Giant grizzly bear]]
|1,700,000
|500
|☼ ♪ ≈
|-
|[[Giant lion]]
|1,700,000
|200
|☼ ♪ ≈
|-
|[[Giant tiger]]
|1,900,000
|200
|☼ ♪ ≈
|-
|[[Rhinoceros]]
|3,000,000
|500
|☼ ♪ ‼ ≈ War only
|-
|[[Giant polar bear]]
|3,268,000
|500
|☼ ≈
|-
|[[Jabberer]]
|4,500,000
|1,500
|☼
|-
|[[Elephant]]
|5,000,000
|500
|☼ ‼ ≈
|-
|[[Cave dragon]]
|15,000,000
|10,000
|☼ ○
|-
|[[Roc]]
|20,000,000
|10,000
|☼ ♪ [[Megabeast]]
|-
|[[Giant rhinoceros]]
|24,000,000
|500
|☼ ♪ ‼ ≈ War only
|-
|[[Dragon]]
|25,000,000
|10,000
|☼ [[Megabeast]]
|-
|[[Giant elephant]]
|40,000,000
|500
|☼ ‼ ≈
|}

: ☼ — ''Recommended choice for armies due to their great size.''
: † — ''Recommended choice for bodyguards, stalls most creatures enough to give dwarves time to escape safely.''
: ^ — ''Recommended choice for fort patrols and supporting dwarves in small skirmishes. Effective in very large numbers.''
: ♪ — ''Recommended hunting companions for their speed and mobility. Smaller animals also sneak more successfully.''
: ‼ — ''Poor choice for training due to their voracious appetites for [[grass]].''
: ≈ — ''Possesses the {{token|MEANDERER}} token, which severely slows their movement speed. Will likely fall behind any moving squad and miss offensive combat situations due to it.''
: ○ — ''Offspring are born adults and cannot be fully tamed. They also grow extremely slowly.''
: [[Megabeast]]s — ''While extremely powerful, megabeasts are currently hostile to all military dwarves, regardless of training level.''{{Verify}} {{bug|10731}}

Remember to keep a breeding pair out of harm's way if you want more of a particular animal, in case the ones in service die.

==Training water creatures==
With a great deal of effort and some clever engineering, it is possible to capture, train, and butcher water creatures.[http://www.bay12forums.com/smf/index.php?topic=75780.0 2] Water creatures can survive indefinitely in [[cage]]s, but will drown at water levels below 4/7 while dwarves will cancel tasks at water levels at or above 4/7, making training extremely tricky. This basic problem can be solved with one of the more interesting bugs in the game: [[ghost]] trainers.[http://www.bay12forums.com/smf/index.php?topic=127659 3] It is currently unknown what bug causes this, but some animal trainers that are killed and never [[burial|buried]] or [[memorial]]ized will continue to perform their job from the grave. This removes the fundamental problem of water depth incompatibility and makes the task much easier. An easier solution, however, would be [[vampire]] animal trainers: they are unbreathing and will path through such water normally, so long as there is no flow. Taming water creatures in vanilla is fairly useless, however, as without [[modding]] they never have children, nor can they receive war (or hunting, however that would work) training.

==Training hostile creatures==

Training hostile creatures like enemy [[mount]]s does not cancel their hostility. While the job is completed and the animal trainer gains experience, the trained creature remains hostile to your civilization and will attack your dwarves. A creature will also be hostile if it becomes an enemy of your civilization, for instance if it killed one of your dwarves before. The rule of thumb is: if it has a [[name]], it's hostile, don't release it from its cage. Though, if you know how it got the name, wild animals that get names from killing other named entities like forgotten beasts, invaders, uninvited guests, etc. will still be friendly after training.

However, it does seem that the offspring of hostile creatures belong to your civilization, because trained mounts <s>amusingly</s> disturbingly attack and subsequently kill their offspring at birth. If you are careful and [[stupid dwarf trick|ingenious]] enough, you can separate the parents and children at birth.

Note that hostile egg-layers, such as [[cave crocodile]]s, might not use [[nest box]]es and therefore generate no offspring.

==Handling dangerous creatures==

Only dwarves with the animal trainer labor active will move non-trained (wild or hostile) captive creatures to a chain or to another cage. This restriction only applies to non-trained creatures and only to the "chain large creature" and "cage large creature" jobs. Throwing such a creature into a pit or pond can be done by anybody, and the chaining and caging of trained creatures is similarly unrestricted.

==Taming vermin==

First, a [[trapper]] needs to catch vermin in an animal trap. A few types of vermin can escape from wooden traps, such as the [[hamster]], so it might be a good idea to use only metal traps. An animal trainer will train a vermin at a vermin catcher's shop. Unlike animals, vermin do not have training levels - they are either tame or not tame. Taming vermin does not pass civilization-wide experience with that vermin to the parent civilization, like taming animals does. Taming requires a food item. Vermin cannot be trained for war or hunting.

There isn't much purpose to taming vermin. It allows vermin to be adopted as pets, but few dwarves have a preference for vermin, so they will rarely be adopted. Vermin don't breed like animals do, so there is no need to have a tame pair to produce offspring. [[Animal dissector]]s can't make [[extract]]s from tame vermin, though there isn't much reason to make extracts either. Tame vermin have little value so they aren't of much use for export either. Taming vermin does give experience to animal trainers, so they can improve their skill in a fort with few animals, especially since vermin are inexhaustible.

==Taming intelligent creatures==

If you mod the game to have trainable intelligent creatures (or if you find a [[gremlin]]) they may be captured in cage traps and trained. However, several things differ from when training other creatures, as training sapients display a number of strange behaviors.

First off, the game will consider any trained (or semi-wild) sentient an inhabitant of your fortress (or at least partially so). This will increase your population count, which likely has the same effects as when the count is increased by [[immigration|immigrants]] arriving or [[children|babies]] being born. The trained creature will be considered a peasant in the z-screen. Despite this, the trained creature cannot work, as it is impossible to set any labor preferences. Neither can they be enlisted to the militia or have any pets. Once trained, they will be subject to hunger, thirst and drowsiness, and as such will require food, drink and sleep to survive. The creature will pick up and wear [[clothes]], but only if they are the right [[size]].

It is impossible to view their general stats screen, trying to do so will only bring you to a simple description of the creature as with any other non-inhabitant of your fort. It might not be possible to view the creature's thoughts, but they still exist, proven by the fact that the trained creature can become [[insane]]. Having the creatures socialize with your dwarves, and each other, as well as [[Keeping_your_dwarves_unstressed|all the other countermeasures to prevent insanity]] seems to prevent this though. As caged creatures cannot do any of these actions, keeping trained creatures in [[cage]]s for elongated periods of time is advised against.

It is normally impossible to give the trained creature a nickname, causing individuals of the same species to be difficult to tell apart, but if you train them for hunting or war and then assign them to one of your dwarves, they will obtain a [[name]]. The further implications of doing so are not known as of yet. Trained sapients may be assigned for butchering (which is otherwise impossible), but their returns are completely unusable and will just be taken to the nearest [[refuse]] [[stockpile]] to rot away.

Because they tend to go wherever they please, a trained intelligent creature will rarely be at a training zone out of their own volition, making re-training them difficult. Depending on how well they're trained, it brings the risk of them going wild again, potentially leading to their escape or for them to attack your dwarves due to becoming hostile. The animal trainer assigned to train these creatures may also be stuck at the training zone waiting for the creature's arrival, potentially leading to hunger and thirst. Making use of [[burrow]]s to force the creature into the training zone is an option, as the training itself will be done as long as the creature and the trainer are within the zone for a few moments.

A trained intelligent creature will only become fully controllable if it applies for [[citizenship]] in your fortress, in which case they'll be able to perform labors and their stats screen will give you full descriptions of their person and personalities. Whether trained sapients apply for citizenship in the same manner as [[visitor]]s do (2 years after becoming part of the fortress) and if they still require training after applying for citizenship requires verification.

==Bugs==

* Capturing and training [[siege|war]] [[mount]]s [http://www.bay12forums.com/smf/index.php?topic=111357.0 may cause] a [[loyalty cascade]] if your [[military]] has to put them down.{{bug|6051}}
* Trained [[flying|fliers]] may swap positions with dwarves, leaving the dwarves stranded in an inaccessible area.{{bug|3371}}
* Training herbivores leaves [[seed]]s in [[cage]]s, which must be manually removed.{{bug|201}}
* Creatures lacking the {{token|CHILD}} tag are impossible to tame. {{bug|7983}} You can work around this by adding {{token|CHILD|c|X}} to the raws for that animal. Replace X with years creature is a child.
* [[Megabeast]]s and active [[squad]]s attack each other on sight, regardless of the former's training level, making [[dragon]]s, [[hydra]]s and [[roc]]s unusable without excessive micromanaging.{{Verify}} {{bug|10731}}

{{skills}}

Giant giraffe

2025-07-17T06:32:18Z

DikbutDaGrate: giant giraffe bug

{{Quality|Fine}}
{{Creaturelookup/0
|image=giant_giraffe_sprite.png
|contrib=no
|bone=70-102
|meat=150-223
|fat=41-58
|eye=2
|lung=12-20
|heart=3-5
|intestine=20-30
|liver=6-10
|tripe=6-10
|sweetbread=3-5
|spleen=3-5
|kidney=6-10
|brain=6-10
|skull=1
|tooth=1
|horns=2
|skin=hide
}}
{{av}}
{{new in v0.42}}
{{creaturedesc}}
'''Giant giraffes''' are gargantuan versions of the [[giraffe]], a long-necked [[grazer]] found roaming [[savage]] [[tropical]] [[savanna]]s and [[shrubland]]s. Being a [[giant animal|giant creature]], giant giraffes provide an absurd amount of (extremely valuable, being 5x the value of common [[domestic animal]]s) [[butchering]] returns, but also are an animal that you do not want [[Creature#Agitation|agitated]].

Giant giraffes also make decent [[exotic pet]]s, but their real value lies as a staple of the [[meat industry]].

Due to an error, giant giraffes walk far slower than they can stroll. Their strolling speed is equal to 60 kph, much greater than either their trot or canter speed. As a consequence, giant giraffes are very difficult to chase, as they will never get tired from maintaining this speed. They may also sneak at this speed without suffering penalty to their stealth, but will likely never abuse this in game.

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

Giraffe

2025-07-17T06:31:22Z

DikbutDaGrate: Giraffe bug

{{Quality|Superior|00:49, 18 February 2023 (CST)}}
{{Creaturelookup/0
|image=giraffe_sprites.png
|meat=21-31
|fat=13
|lung=2
|heart=1
|intestine=2-3
|liver=1
|tripe=1
|sweetbread=1
|spleen=1
|kidney=2
|brain=1
|eye=2
|skull=1
|horn=2
|skin=hide
|bone=20-24
|contrib=no
|wiki=yes}}
{{av}}
{{creaturedesc}}

'''Giraffes''' are huge [[Creature|animals]] found in [[tropical]] [[savanna]]s and [[shrubland]]s, where they appear in herds of 3-7 individuals. They're over 16 times heavier than the average [[dwarf]], but are generally benign and timid creatures who flee rather than fight, but if they do fight, their large size can allow them to easily dispatch a lone [[hunter]] who ventures too close; in combat, their hooves and mass make a good [[natural weapon]]. A new born giraffe is called a ''calf''.

Giraffes can be captured in [[cage]] [[trap]]s and [[Animal trainer|trained]] into valuable exotic [[pet]]s. Their large size means they provide great amounts of returns when [[butcher]]ed, making them good targets for a [[meat industry]]. Products made from giraffe parts are [[item value|worth]] 5 times more than those made from common animals. They take 10 years to reach adulthood, but are fully grown by the age of 5. When trained, giraffes become [[grazer]]s, and as such they'll require a constant source of [[grass]] to survive; tree browsing has yet to be implemented, so giraffes will not deforest your surroundings, though the ability for them to browse trees is a planned feature. Giraffes are [[mount]]s and may be used against you during [[siege]]s, in which case, their large size will truly become a problem to your fortress.

Due to an error, giraffes walk far slower than they can stroll. Their strolling speed is equal to 60 kph, much greater than either their trot or canter speed. As a consequence, giraffes are very difficult to chase, as they will never get tired from maintaining this speed. They may also sneak at this speed without suffering penalty to their stealth, but will likely never abuse this in game.

Some dwarves [[Preferences|like]] giraffes for their ''long necks''.

[[File:GiraffaCamelopardalisTippelskirchi-Masaai-Mara.JPG|thumb|center|400px|Admired for their ''long necks'']]

{{Gamedata}}
{{Creatures}}
{{Category|Animals}}

Weapon

2025-06-24T02:22:43Z

DikbutDaGrate: Fork don't get 1.25x velocity.

{{av}}
:''This page deals entirely with manufactured weapons. For natural weapons, see [[Natural weapon]].''
[[File:weapons_sprites_preview.png|right]]A '''weapon''', in the sense described on this page, is any [[item]] specifically designed to be wielded in [[combat]] against others. In [[fortress mode]], weapons can be made at a [[metalsmith's forge]] (all metal weapons, including [[crossbow]]s, and [[bolt]]s in stacks of 25) using a single bar of metal*, a [[bowyer's workshop]] ([[wood|wooden]] and [[bone]] crossbows and bolts in stacks of 25 or 5 respectively) with a single [[log]] or [[bone]], or at a [[craftsdwarf's workshop]] (obsidian short swords* only) with one stone of obsidian plus one log.

: (* No "wooden handle" is required for most non-wooden weapons. The unique [[obsidian]] option for [[short sword]]s is the sole exception to this. Any metal weapons, including short swords made from metal, need no wood for their production.)
Graphically, each weapon's color palette will change according to the material used to make them.

Many creatures with a humanoid form ([[giant]], [[magma man|magma men]], [[animal people]], etc.), or even some non-humanoid creatures with hands can also wield weapons, which can be seen in the items tab after clicking on a creature, although their sprite will not reflect this. This is because only dwarves, humans, elves, goblins and kobolds currently have dedicated sprites to resemble what they're wearing and wielding.

== Basics ==
=== Native vs. foreign ===
In fortress mode, weapons can be split into two categories: those that you can produce, and those that you can't. [[Weaponsmith]]s can produce seven types of native weapons at a [[metalsmith's forge]], but there are also fourteen foreign weapons that can be found in the hands of enemy combatants, or bought from trading caravans (note, however, that due to bugs, several foreign weapons currently are effectively unusable by dwarves). These may use skills your dwarves are unfamiliar with, it is impossible to buy them in bulk, and they are of variable quality and material. Like all weapons, they tend to be expensive as trade goods, and may be worth using if you can secure a high-quality specimen (see [[#Quality and strange moods|Quality]] below). Since they are common for other nations, it is important to understand their properties when you have to fight enemies wielding them.

=== Types of weapons ===
{{main|Attack types}}
Mechanically, all weapon attacks are separated into "edge" and "blunt" types, although these can be further split into four practical categories:
*Slashing
*Piercing
*Crushing
*Ranged

(Weapons that are native to dwarven culture, that dwarves can create for themselves, are listed first, with ''foreign weapons'', types that must be looted off dead enemies or traded for, listed in parentheses and italics. Dwarves can use many types of foreign weapons, but finding a good-[[quality]] one is rare.)

====Slashing weapons====
* [[battle axe]]s, [[short sword]]s ''(also [[scimitar]]s, [[scourge]]s, [[great axe]]s, [[halberd]]s, [[long sword]]s and [[two-handed sword]]s)''

These work by concentrating their force along a sharp edge, allowing them to cut gashes in or to completely sever body parts. Severing is most likely when the body part's thickness is smaller than the weapon's contact edge. They make the quickest work of unarmored opponents who are not tremendously large. They are far less effective against armored targets, however, as armor will usually prevent the cutting, converting strikes into weaker blunt damage. An advantage of severing parts is that they cannot be targetted again, allowing dwarves to better focus on more vital parts.

'''Short swords''' are, generally speaking, less effective than axes. Although categorized as a "slashing" weapon, analysis of combat statistics shows that short swords also deliver piercing and bludgeoning blows (the latter from the butt-end of the handle). However, they do all of these less effectively than other weapons in those categories, making them the "Jack of all trades, master of none" weapon. However, if going against heavily armored opponents, they do have that occasional piercing attack as an advantage over axes, if only that. Also, if [[obsidian]] is available (along with spare wood), obsidian short swords can be produced outside of the usual metal industry chain of production.

====Crushing weapons====
* [[war hammer]]s, [[mace]]s, training weapon attacks (see below), melee attacks with [[crossbow]]s ''(also [[flail]]s, [[maul]]s, [[whip]]s)''

Also known as "blunt" or "bludgeoning" weapons, these work by concentrating their force behind a tiny, blunt point, (notably, war hammers have half the contact area of spears), smashing right through armor and breaking bones beneath their blows. As broken bones cause extreme pain, living creatures that can feel it will often "give in" to it and fall unconscious very quickly. Attacks against such helpless targets will always result in perfectly accurate and perfectly square strikes to the head, which will usually cause fatal brain injury. Nevertheless, blunt weapons are still slower to kill unarmored enemies than slashing weapons are.

====Piercing weapons====
* [[spear]]s, [[pick]]s, [[crossbow]] bolts ''(also [[dagger]]s, [[Pike (weapon)|pikes]], [[morningstar]], [[arrow]]s and [[blowdart]]s)''

These work by concentrating their force at a point, allowing them to punch through armor and damage internal organs. They often get stuck in the opponent, forcing their wielder to spend valuable time pulling the weapon back out between uses.

====Ranged weapons====
* [[crossbow]]s ''(also [[bow]]s and [[blowgun]]s)''

These are effectively lightweight piercing weapons which work from a distance. When opponents engage the user in melee, the users are then forced to wield these weapons as melee weapons. Ranged weapons depend on shoot force and the material composition of the ammunition to deal damage. Best used against light to medium armored targets. All ranged ammunition deals "edged" damage. Wielding any of these as melee weapons is not recommended.

====Training weapons====

There exists one more umbrella category of weapon: the so-called "'''training weapon'''". Training weapons are wooden, and are made at a [[carpenter's workshop]]. Training axes, spears, and short swords can be constructed in fortress mode. They all do blunt impact damage, but only a tiny amount due to the poor [[material science|material properties]] of wood for a combat weapon. While every weapon is actually safe to use in [[Training|sparring]], the primary purpose of training weapons in fortress mode is to allow your dwarves to start training before you have a working metal industry. They can also be used during live combat exercises (beating upon a disarmed goblin, etc.) to extend the training session's length. Finally, they may be issued to the guards to reduce the lethality of a [[justice|criminal beating]].

=== Weapon skill ===
{{main|Combat skill#Weapon skill}}
Every type of weapon has its own associated [[military]] [[skill]]. The higher a dwarf is in his skill with a weapon, the better he will be able to use it in combat, connecting hammer blows to more advantageous sweet spots and sending spears right through enemy hearts and lungs with greater accuracy. The higher the weapon skill, the better at fighting the dwarf will be.

Once a dwarf has reached "Great" skill in a certain weapon, they become '''[weapon] lords''' for that specific weapon. They will love fighting and will no longer complain about long patrol duties. Weapon skill is trained in fighting enemies in combat, demonstrations, and combat drills, but if you leave your dwarves shield-less, a [[danger room]] will train their skill very, very quickly. Note that this does not quite work for marksdwarves - danger rooming ranged weapons increases their melee skill, increasing their hammerdwarf skill, although [[Cross-training|this may be the point]].

=== Attachment ===
A dwarf that has used a particular weapon for a long time will grow [[Attachment|attached]] to it, equipping it whenever their uniform allows them to. This is fine if they are wielding a ☼steel mace☼, but a major problem if they are wielding what is meant to be a training weapon (be it a wooden axe or a copper spear). You can avoid this pitfall by not using training weapons and not forging weapons until you have real weaponsmithing underway. These events generate [[announcement]]s. If a dwarf does become attached, you can easily force him to relinquish the weapon by assigning a 'specific weapon' instead in his equipment view.

In addition, dwarves that reach a certain number or level of kills, or train long enough with a weapon, will name it. This prompts a major announcement. The weapon in question may have no kills associated with it (legendary dwarves occasionally name their weapons while training with them). Once named, the weapon will appear in the artifact list, albeit in blue. It is unknown if named weapons perform better than unnamed weapons. Dwarves may also become attached to shields and name them in the same way.

=== Quality and strange moods ===
The [[quality]] of a weapon has a significant impact on its combat performance, as well as its [[value]].

{{:Item quality/Table}}

Weaponsmithing is a [[moodable]] profession, which means that you can get [[artifact]] weapons. Artifact weapons have a 3x combat bonus and can be made out of a wide range of materials; ordinarily a [[hippo]] [[bone]] spear is impossible, but a moody dwarf can create one with a stack of hippo bone. Artifact weapons made of totally inappropriate materials are inferior to regular ones made of weapons-grade metal, although the exact balance is still under discussion. As with other moodable skills, a dwarf who creates an artifact using the weaponsmith skill stands a [[Strange mood#Skills_and_workshops|high chance]] of becoming a legendary weaponsmith.

=== Weapons as tools ===
[[Hunter]]s use crossbows, [[wood cutter]]s use [[battle axe]]s, and [[miner]]s use [[pick]]s. They must be in possession of these items to do their jobs, and it's as simple as that.

Hunters gain [[marksdwarf]] skill from hunting, but wood cutters do not gain [[axedwarf]] weapon skill from cutting trees. Miners gain [[mining]] skill, which is not considered a military skill, but is used as a weapon skill when fighting with a pick. A dwarf using a weapon as a tool will not use the same tool as a military weapon, instead dropping their tool to pick up another for military use.{{bug|1451}} Dwarves may carry only one weapon as a tool at a time; for example, woodcutters/hunters will drop their axes then go and pick up crossbows every time they begin hunting.

=== Ammunition ===
:''Main article: [[Ammunition]]''

[[Crossbow]]s and other ranged weapons require [[ammunition]] (in the case of the crossbow, [[bolt]]s). This ammunition is carried in a [[quiver]] in packs of about 25, and when they run out they will switch to using their ranged weapons as crude hammers. It's often a good idea to try to get them to retreat once they run out of ammo — crossbows are meant for shooting, not bashing.

=== Secondary weapons ===
Although it sounds like a cool idea, equipping a marksdwarf with a backup short sword "just in case" doesn't often work, as dwarves are just as quick to run up to their foes and start bashing them with a crossbow as they are to draw their swords and do it properly.

=== "Best" weapon choices ===
To put it simply, the combat system behind ''Dwarf Fortress'' is ''very'' complicated. It's not just a question of ''"What is the weapon with the biggest number?"'' - no such thing here. If you want technical specifics, that's addressed in the bottom half of this article (and elsewhere), but for now, from both study of the formulae and observed behavior, there are some patterns for what weapons seem to work "best" against certain targets, and what don't, and (basically) why.

''Dwarf Fortress'' combat is rarely "one-shot", nor is it a long process of whittling away a huge pile of "hit points" (which do not exist in DF). Your best tactic is to try to quickly cripple or stun an opponent, so that you can then deliver a killing blow against a (momentarily) defenseless target, and then move on to the next opponent. The recommended weapons are chosen with this in mind.

==== Superior metal rule ====
As a general rule, if a weapon slashes or pierces, it wants to be made from a "better" metal than the [[armor]] it's trying to penetrate. If it is, it goes through more easily; if it is equal, it has some problems, and if it's inferior, it has some real problems. That does '''not''' mean that a copper spear can't hurt a superior-metal-clad target - just understand that the odds drop compared to weapons of equal metal, and, similarly, superior weapons start to ignore armor of inferior metal.

Also, note that this effectively works in steps - copper is weak against bronze/iron targets, but feeble against steel.

(Note: In this section, if 2 metals are equivalent to each other, they will be placed together in parentheses for ease of comparison.)

* [[steel]], the clear best*
* ([[bronze]] or [[iron]]), very respectable, roughly equivalent** to each other
* [[copper]], a distant third
* [[silver]], a ''very'' distant last (included only because silver is listed to make slashing/piercing weapons)

: (* There is also [[adamantine]], which is late game only, in a different league from the rest. That is not the subject of a "basic" discussion.)
: (** There are some "X weapon vs Y armor" situations where iron is slightly better, but a couple where bronze is actually better than iron - but each is a very specific case. "Roughly equivalent" is a good rule of thumb.)

Ranged attacks (for dwarves, [[crossbow]]s, but also bows and arrows for enemies) are also piercing, and suffer even more from the "superior metal" rule, especially since everything except adamantine has essentially equal density when it comes to bolts due to their max velocity and force. It can be very disheartening to see all those cheap bolts bounce off their armored targets when it matters most.

Note that [[Attack_types#Blunt_weapons|blunt]] weapons, such as [[mace]]s or [[war hammer]]s, do '''''not''''' follow this rule. For them, generally speaking, "heavier is better", so [[density|denser]] metals, such as silver, perform well, although the hardness of steel makes it another strong performer. In terms of which is actually better, it depends on the skill level of the dwarf swinging the weapon. Unskilled dwarves are much better off using steel because of its lower weight; silver tires them out far too quickly. This means blunt weapons made of steel are good for militias, or any squad that doesn't do much dedicated training. For more skilled dwarves, however, silver's weight tends to tire the wielder out much slower now, and the extra damage per hit makes it better than steel in this case. This means that if you have a squad that trains for most of the year, they will make much better use of a silver blunt weapon than a steel one. For the other weapons-grade metals, they are all a close third to these and are perfectly serviceable, as the small differences in density do not matter that much. Rare heavy artifact blunt weapons from [[gold]] or, better, [[platinum]], do only slightly more damage (despite being 273% the density of steel, platinum only gets about 1% more momentum), but with the greater weight comes a greater risk of tiring out the wielder in a long fight.[http://www.bay12forums.com/smf/index.php?topic=181479]

==== vs. unarmored ====
This includes most wild [[animal]]s, [[siege]]-mounts, [[thief|thieves]], [[kobold]]s, etc. Leather/bone armor helps against animal attacks, not against metal weapons.

It may also include some [[semi-megabeast]]s and [[megabeast]]s, depending on specifics.

* recommended weapon: any sharp weapon

Most unarmored creatures are biological beings much larger than dwarf, a situation where spear excels at reaching the vitals. Axes have 60% the penetration and swords 40% of the penetration of spears, but much larger areas, which leads to much more bleeding and more chance of pulping. In theory, all edged weapons follow the "superior metal" rule, but, against unarmored targets, skin and bone will always lose to ''any'' edged metal weapon - even silver! (However, see "vs. undead", below.)

Blunt weapons can break bones, which stuns the target and allows a killing blow, but removing a limb is obviously better. War hammers break bones more easily than maces, causing pain, though maces achieve total pulping blows sooner. However, unless you're facing small enemies even the best blunt weapon is going to lose to the worst sharp weapon.

Crossbows can hit a vital organ, knee or guts if lucky, but otherwise are slow to cripple and may get off only 2-3 shots before melee combat begins. They are, however, excellent for chasing down fleeing targets, making them ideal against various thieves/wildlife.

And the bonus lesson here is... armor your military.

==== vs. [[armor]]ed ====

Usually showing up only during a [[siege]] or [[ambush]]. [[Quality]] has a significant effect, but copper chain pieces have much less stopping power than bronze/iron plate pieces.

* recommended weapon: steel spear
* other choices: any steel sharp weapon, any warhammer or pick

Your typical goblin or human sieges will never have steel. Even when undead have it, the coverage is only partial.

Steel spears are the only edged weapon that can consistently pierce armor. Unless held by an extremely strong dwarf or made of adamantine, a sword will have difficulty getting through a breastplate, and an axe '''never''' will.

Steel swords have biggest variety of attacks, allowing them to both stab organs and remove limbs. Picks have the velocity of a blunt weapon with the edge of a sharp weapon, giving them extra punch. Functionally, having "superior metal" will make the battle much like removing enemy armor.

(Note also that piercing weapons have a chance to get stuck in an opponent, which can lead to [[wrestling]] to get the weapon out, or to apply more punishment.)

Blunt weapons work on flexible chain just as well as against an unarmored opponent, and can deform solid armor (which is everything "not chain") to land a killing blow. Warhammers are superior to maces in penetrating solid, "non-chain" armor and breaking bones.

Slashing weapons really suffer here, and especially so against non-chain targets. It's critical that they be superior metal if you want any chance of them having much reliable effect against heavy armor. A lucky blow can still take a limb, but often slashing blows just do little more than anger the target, even with steel.

Crossbows suffer doubly from superior metal issues against chain, and it only gets worse against plate [http://www.bay12forums.com/smf/index.php?topic=160814.msg7192083#msg7192083 3]

==== vs. [[undead]] ====

* recommended weapon: mace or war hammer if you want to have a single corpse, axe if you want efficiency.
* other choices: sword will do a fine job.

u/MrNorrelDoesHisPart:

"Maces did indeed perform the best in terms of creating the smallest number of additional reanimated opponents. They always scored perfectly and thus don’t have a margin of error. Axes produced the largest number of additional reanimated opponents, and spears produced relatively few reanimated body parts...(However) Axes and spears tie for fastest and maces come a distant third. Although it is true that an axe is much messier than a mace, it seems that an axe’s greater killing ability more than compensates for this problem. Maces thus appear to be the best choice when cleanliness is a priority but the worst choice when combat efficiency is important."

*Newest Dwarven [https://www.reddit.com/r/dwarffortress/comments/11bh54h/combat_science_iii_fighting_the_undead/ !!Science!!] shows that while axe create a messy pile of reanimated corpse, the axe generally takes only 1/3 the time to kill all the reanimated bits. Therefore without considering the extra hauling labor, battle axe is the superior solution to reanimated corpse.

War hammers can be preferable to maces when fighting living enemies that you don't want to resurrect. Killing a living enemy with a war hammer will usually result in a mangled corpse just like in the case of maces, but a war hammer will deal more damage due to its superior ability to penetrate outer layers and damage internal organs and bones, as well as better ability to stun enemies. An axe can still kill unarmored living creatures faster, but it will cut off limbs and head which can later resurrect. Resurrected body parts are often easy to kill, even for unarmed dwarves (although sometimes they are significantly stronger, such as a resurrected neck killing multiple dwarves), but can generate job cancellation spam and unhappy thoughts from being attacked by the dead. Also, resurrected body parts may need to be killed many times before they are mangled, even when using maces or war hammers.

==== vs. Undead megabeast and other large fleshy creatures ====

** recommended weapon if has access to steel: large army with steel spears.
** recommended weapon if has access to adamantine: adamantine axe.
** unrecomended weapon: anything inferior than steel.

The result varies between axe, spear and sword. When a squad of 4 armored dwarves fight an undead cyclops with metal inferior to adamantine, only the ones armed with steel spears have a chance of winning. The squads with axe, mace and sword stand no fighting chance.

With an adamantine weapon, however, axe and sword outperforms spear. Even one grandmaster axedwarf with an adamantine axe stands a chance to defeat the undead cyclops.

==== vs. others ====
This category consists of the rare "not like anything else" creature, the type you get when you breach the [[cavern]]s or [[magma]] (or deeper), or once your fortress is large enough to get their attention.

* recommended weapon: (varies)
* other choices: any steel axe (depending), crossbow (from behind fortifications), whip

There are many different types here, and no one approach works for all. Some are merely gigantic but (more or less) "normal", but many are non-organic, and most enjoy the "[[No Pain|don't feel pain]]" tag, including [[titan]]s, [[forgotten beast]]s, [[bronze colossus]]es, [[Iron man|iron men]], and [[HFS|hidden fun stuff]]. Many of these enemies ''have'' no internal organs while being huge, weakening the effectiveness of pain and pierce. Some are still flesh and blood, and they're functionally like unarmored wildlife, but some are made from some material that may be very difficult to slash at.* In the worst case of being made of steel, it leaves chipping away at the target until they collapse from cumulative damage, which means either penetrating a LOT of armor (warhammer or ideally whip) or breaking everything (mace). Some few megabeasts are metal (e.g. [[bronze colossus]]), and the "superior metal" rule goes ''strongly'' in effect there - use steel sharp weapons for them, though whip would be best if you don't have those.

(* although a forgotten beast made of, for instance, "mud" is laughably easy to kill)

Ranged attacks are useful for taking care of the ones who are unapproachable themselves while being incredibly fragile. And at the very least, you're at less risk when raining down bolts from above, even if it won't do much damage.

==== Final verdict ====
Now, all that said, overall, if you had to choose one "least worst" weapon, it would probably have to be... the steel short sword. It has no true counters, no enemy it cannot ever defeat - while axes falls to iron men and copper armor and maces/hammers/spears falls to big creatures. If you cannot get steel, a second option would be the goblin-made whip, which is still somewhat effective against bronze colossuses and big beasts, and maces and hammers will always be effective no matter what they're made of.

Outside that, for edged/piercing weapons (axe, spear, bolts, and sword) against unarmored (and non-"unusual" targets) any metal will be overpowered, easily cutting/chopping/piercing all equally. Soft targets aside, make edged/piercing weapons out of the best metal you can (steel > iron > bronze > copper > silver) for use against armor, if/when you meet that. Crushing weapons (in order: hammer, mace, and crossbow in melee) can be any metal, steel being quite a bit better for untrained dwarves, and silver being the best for trained dwarves. If you want to add megabeasts into the consideration, go with steel to be safe, for any weapon type.

= Technical =
From here down, there are tables of values pulled from the raws, some technical analyses, a few statistical observations, and some solid and speculative inferences and conclusions.

Insert obligatory "math warning" here.

== Weapons ==
=== Native weapons ===
{| class="wikitable" border="border"
! Type
! Graphic
! Size
! Attack
! [[Attack type]]
! Contact Area
! Penetration
! Velocity
! Skill Used
! Hands Used
! [[Weaponsmith|Metal]]
! [[Bowyer|Wood]]
! [[Bowyer|Bone]]
! [[Stone crafter|Obsidian]]
|- valign="top"
|rowspan="3"| [[battle axe|Battle Axe]]
|rowspan="3"| [[File:battle_axe_sprite.png]]
|rowspan="3"| 800
| Hack || Edge || 40000 || 6000 || 1.25×
|rowspan="3"| Axe
|rowspan="3"| one
|rowspan="3"| Yes
|rowspan="3"| No
|rowspan="3"| No
|rowspan="3"| No
|-
| Flat slap || Blunt || 40000 || (6000) || 1.25×
|-
| Pommel strike || Blunt || 100 || (1000) || 1.0×
|-
| [[Crossbow]] (Melee)
| [[File:crossbow_sprite.png]]
| 400
| Bash || Blunt || 10000 || (4000) || 1.25×
| Hammer
| two
| Yes
| Yes
| Yes
| No
|-
| [[Mace]]
| [[File:mace_sprite.png]]
| 800
| Bash || Blunt || 20 || (200) || 2.0×
| Mace
| one
| Yes
| No
| No
| No
|-
| [[Pick]] (foreign)
| [[File:pickaxe_sprite.png]]
| 500
| Strike || Edge || 100 || 4000 || 2.0×
| Mining
| one
| Yes
| No
| No
| No
|- valign="top"
|rowspan="4"| [[short sword|Short Sword]]
|rowspan="4"| [[File:short_sword_sprite.png]]
|rowspan="4"| 300
| Slash || Edge || 20000 || 4000 || 1.25×
|rowspan="4"| Sword
|rowspan="4"| one
|rowspan="4"| Yes
|rowspan="4"| No
|rowspan="4"| No
|rowspan="4"| Yes
|-
| Stab || Edge || 50 || 2000 || 1.0×
|-
| Flat slap || Blunt || 20000 || (4000) || 1.25×
|-
| Pommel strike || Blunt || 100 || (1000) || 1.0×
|- valign="top"
|rowspan="2"| [[Spear]]
|rowspan="2"| [[File:spear_sprite.png]]
|rowspan="2"| 400
| Stab || Edge || 20 || 10000 || 1.0×
|rowspan="2"| Spear
|rowspan="2"| one
|rowspan="2"| Yes
|rowspan="2"| No
|rowspan="2"| No
|rowspan="2"| No
|-
| Shaft bash || Blunt || 10000 || (6000) || 1.25×
|-
| [[war hammer|War Hammer]]
| [[File:war_hammer_sprite.png]]
| 400
| Bash || Blunt || 10 || (200) || 2.0×
| Hammer
| one
| Yes
| No
| No
| No
|}

Note that although the [[pick]] is a foreign weapon, it can be produced by dwarves and is therefore considered native.{{bug|680}}

=== Details ===
*If you find your dwarves wearing more than one weapon – or any unwanted [[armor]], for that matter – one way to get rid of them is to dump the weapon from their {{k|v}}-{{k|i}} inventory screen. This does not always work, as they might re-equip the item. Another option is to remove any weapons and/or shields listed on their military equip screen. This too does not always work. At least "left-handedness" seems to not pose a problem. If you cancel the work by {{k|v}}-{{k|p}} and selecting a job that needs a tool they will sometimes put it back in the pile. Example: Miners use picks, cancel their mining job and they will put the pick away AFTER you ordered it to be dumped.
* Using weapons is much more effective than unarmed combat – an untrained swordsdwarf with an [[iron]] weapon can defeat a grand master [[wrestler]], provided neither is wearing armor. Larger weapons tend to do more damage due to the [[Material science#Attack Momentum|momentum formula]]
* The size for a weapon is its volume in cm3.
* Attacks of type EDGE will either slice or pierce their target, depending on the contact area and penetration depth, while BLUNT attacks tend to damage internal organs without necessarily causing significant damage to outer layers.
* The contact area represents the area of contact of the weapon, and the penetration determines how deep the attack goes (and is apparently ignored entirely for BLUNT attacks – indicated by numbers in parentheses). The game does not distinguish between "piercing" and "slashing" attacks, despite this page using those terms often--the only difference is that piercing weapons have small contact area and slashing ones have large contact area. Penetration tends to be the same between either, but large contact area makes it much more difficult for weapons to get through armor--armor that a spear can barely pierce would require '''400 times''' as much momentum for an axe to pierce.
* The velocity is a direct multiplier on the attack's [[Material science#Attack Momentum|momentum]] - for example, war hammers have a 2x velocity multiplier, presumably to model the fact that the hammer's mass is concentrated at the tip which, when combined with a long handle, permits swinging it harder than a weapon whose mass is evenly distributed (such as a sword).
* Crossbows can be made of metal, wood, and bone. Metal crossbows are made by a [[weaponsmith]] at a [[forge]], while wood and bone crossbows are made by a [[bowyer]] at a [[bowyer's workshop]]. The material of a crossbow does not affect its firing ability, only its melee damage. A dwarf's marksmanship skill is only affected by the core [[item quality|quality]] of the bow. This may be a consideration when deciding which dwarf you want outfitting your marksdwarves: a [[experience|legendary]] bowyer is a better choice than a proficient weaponsmith.
* Dwarves will never select a pick for a weapon if allowed "individual choice." You must specify picks as part of their uniform, or on the individual equip screen, if you wish to utilize them as weapons.

=== Training weapons ===
All [[training weapon]]s must be made of [[wood]] at the [[carpenter's workshop]].

{| class="wikitable" border="border"
|-
! Type
! Graphic
! Size
! Attack
! [[Attack type]]
! Contact Area
! Penetration
! Velocity
! Skill Used
|- valign="top"
|rowspan="3"| Training Axe
|rowspan="3"| [[File:training_axe_sprite.png]]
|rowspan="3"| 800
| Hack || Blunt || 30000 || (6000) || 1.25×
|rowspan="3"| Axe
|-
| Flat slap || Blunt || 30000 || (6000) || 1.25×
|-
| Pommel strike || Blunt || 100 || (1000) || 1.0×
|- valign="top"
|rowspan="4"| Training Sword
|rowspan="4"| [[File:training_sword_sprite.png]]
|rowspan="4"| 300
| Slash || Blunt || 20000 || (4000) || 1.25×
|rowspan="4"| Sword
|-
| Stab || Blunt || 50 || (2000) || 1.0×
|-
| Flat slap || Blunt || 20000 || (4000) || 1.25×
|-
| Pommel strike || Blunt || 100 || (1000) || 1.0×
|- valign="top"
|rowspan="2"| Training Spear
|rowspan="2"| [[File:training_spear_sprite.png]]
|rowspan="2"| 400
| Stab || Blunt || 200 || (10000) || 1.0×
|rowspan="2"| Spear
|-
| Shaft bash || Blunt || 10000 || (6000) || 1.25×
|}

=== Foreign weapons ===
Using any multi-grasp weapon in a single hand (i.e. with a shield in the other hand) without being of the proper size/broadness (which dwarves in Fortress Mode almost never are), gives you a disability to hit - do not equip two-handed swords with a shield, for instance. '''The game will not stop you from doing this''', so be wary about it.

In Adventurer Mode, however, if your character passes the one-handed check for single-handing a multi-grasp weapon, it is possible to wield a two-handed sword, or any multi-grasp weapon, in one hand without penalty (allowing for the simultaneous use of a shield). For example, if you create a human character, and manage to spawn into a world with a "broad body" or a "tall body" in the character description, you will be able to single-hand any multi-grasp weapon (and will be forced to, much like you are forced to single-hand any single-grasp weapon), which allows for the simultaneous, disability-free use of a shield, thus making your damage and defensive capabilities much higher than they would be with a single-grasp weapon and shield. Note that upping Strength to Superior (and eventually Superhuman) will make all attacks more likely to deal extra damage, making cutting off the limbs of your enemies much easier.

{| class="wikitable" border="border"
|-
! Type
! Graphic
! Size
! Attack
! [[Attack type]]
! Contact Area
! Penetration
! Velocity
! Skill Used
! Used by
! Hands Used (average human)
|- valign="top"
|rowspan="4"| [[Two-handed sword]]
|rowspan="4"| [[File:two_handed_sword_sprite.png]]
|rowspan="4"| 900
| Slash || Edge || 100000 || 8000 || 1.25×
|rowspan="4"| Sword
|rowspan="4"| [[Goblin]], [[Human]]
|rowspan="4"| Multi-grasp
|-
| Stab || Edge || 50 || 4000 || 1.0×
|-
| Flat slap || Blunt || 100000 || (8000) || 1.25×
|-
| Pommel strike || Blunt || 100 || (1000) || 1.0×
|- valign="top"
| [[Blowgun]] (Melee)
| [[File:blowgun_sprite.png]]
| 150
| Bash || Blunt || 10000 || (4000) || 1.25×
| Sword
| Subterranean [[animal people]]
| Single-grasp
|- valign="top"
| [[Bow]] (Melee)
| [[File:bow_sprite.png]]
| 300
| Bash || Blunt || 10000 || (4000) || 1.25×
| Sword
| [[Elf]], [[Goblin]], [[Human]], [[Kobold]]
| Single-grasp
|- valign="top"
| [[Flail]]
| [[File:flail_sprite.png]]
| 500
| Bash || Blunt || 200 || (4000) || 2.5×
| Mace
| [[Goblin]], [[Human]]
| Single-grasp
|- valign="top"
|rowspan="3"| [[great axe|Great Axe]]
|rowspan="3"| [[File:great_axe_sprite.png]]
|rowspan="3"| 1300
| Hack || Edge || 60000 || 8000 || 1.25×
|rowspan="3"| Axe
|rowspan="3"| [[Goblin]], [[Human]]
|rowspan="3"| Multi-grasp
|-
| Flat slap || Blunt || 60000 || (8000) || 1.25×
|-
| Pommel strike || Blunt || 100 || (1000) || 1.0×
|- valign="top"
|rowspan="3"| [[Halberd]]
|rowspan="3"| [[File:halberd_sprite.png]]
|rowspan="3"| 1200
| Slash || Edge || 20000 || 8000 || 1.25×
|rowspan="3"| Axe
|rowspan="3"| [[Goblin]], [[Human]]
|rowspan="3"| Multi-grasp
|-
| Stab || Edge || 50 || 2000 || 1.0×
|-
| Shaft bash || Blunt || 20000 || (6000) || 1.25×
|- valign="top"
|rowspan="3"| [[Dagger]] (Large)
|rowspan="3"| [[File:dagger_sprite.png]]
|rowspan="3"| 200
| Slash || Edge || 1000 || 800 || 1.25×
|rowspan="3"| Dagger
|rowspan="3"| [[Goblin]], [[Kobold]]
|rowspan="3"| Single-grasp
|-
| Stab || Edge || 5 || 1000 || 1.0×
|-
| Pommel strike || Blunt || 20 || (600) || 1.0×
|- valign="top"
|rowspan="4"| [[long sword|Long Sword]]
|rowspan="4"| [[FIle:long_sword_sprite.png]]
|rowspan="4"| 700
| Slash || Edge || 60000 || 6000 || 1.25×
|rowspan="4"| Sword
|rowspan="4"| [[Elf]], [[Goblin]], [[Human]]
|rowspan="4"| Single-grasp
|-
| Stab || Edge || 50 || 3000 || 1.0×
|-
| Flat slap || Blunt || 60000 || (6000) || 1.25×
|-
| Pommel strike || Blunt || 100 || (1000) || 1.0×
|- valign="top"
| [[Maul]]
| [[File:maul_sprite.png]]
| 1300
| Bash || Blunt || 100 || (6000) || 2.0×
| Hammer
| [[Goblin]], [[Human]]
| Multi-grasp
|- valign="top"
|rowspan="2"| [[Morningstar]]
|rowspan="2"| [[File:morningstar_sprite.png]]
|rowspan="2"| 500
| Bash || Edge || 10 || 500 || 2.0×
|rowspan="2"| Mace
|rowspan="2"| [[Goblin]], [[Human]]
|rowspan="2"| Single-grasp
|-
| Pommel strike || Blunt || 50 || (1000) || 1.0×
|- valign="top"
|rowspan="2"| [[pike (weapon)|Pike]]
|rowspan="2"| [[File:pike_weapon_sprite.png]]
|rowspan="2"| 800
| Stab || Edge || 20 || 12000 || 1.0×
|rowspan="2"| Pike
|rowspan="2"| [[Goblin]], [[Human]]
|rowspan="2"| Multigrasp
|-
| Shaft bash || Blunt || 10000 || (6000) || 1.25×
|- valign="top"
|rowspan="4"| [[Scimitar]]
|rowspan="4"| [[File:scimitar_sprite.png]]
|rowspan="4"| 300
| Slash || Edge || 20000 || 4000 || 1.25×
|rowspan="4"| Sword
|rowspan="4"| [[Goblin]], [[Human]]
|rowspan="4"| Single-grasp
|-
| Stab || Edge || 50 || 2000 || 1.0×
|-
| Flat slap || Blunt || 20000 || (4000) || 1.25×
|-
| Pommel strike || Blunt || 50 || (1000) || 1.0×
|- valign="top"
| [[Scourge]]
| [[File:scourge_sprite.png]]
| 300
| Lash || Edge || 10 || 50 || 2.0×
| Whip
| [[Goblin]]
| Single-grasp
|- valign="top"
| [[Whip]]
| [[File:whip_sprite.png]]
| 100
| Lash || Blunt || 1 || (10) || 5.0×
| Whip
| [[Goblin]], [[Human]]
| Single-grasp
|- valign="top"
|rowspan="3"| Stone axe
|rowspan="3"|[[File:stone_axe_sprite.png]]
|rowspan="3"| 400
| Hack || Edge || 800 || 400 || 1.25×
|rowspan="3"| Axe
|rowspan="3"| Player in [[adventurer mode]]
|rowspan="3"| Single-grasp
|-
| Slap|| Blunt || 800|| 400 || 1.25×
|-
| Strike || Blunt || 20|| 400 || 1.0×
|- valign="top"
|rowspan="3"| Carving knife
|rowspan="3"|[[File:carving_knife_sprite.png]]
|rowspan="3"| 150
| Slash || Edge || 800 || 600 || 1.25×
|rowspan="3"| Dagger
|rowspan="3"| Non-warrior NPCs in [[adventurer mode]]
|rowspan="3"| Single-grasp
|-
| Stab || Edge || 4 || 800 || 1.0×
|-
| Strike|| Blunt || 15|| 400 || 1.0×
|- valign="top"
|rowspan="3"| Boning knife
|rowspan="3"|[[File:boning_knife_sprite.png]]
|rowspan="3"| 50
| Slash || Edge || 500 || 300 || 1.25×
|rowspan="3"| Dagger
|rowspan="3"| Non-warrior NPCs in [[adventurer mode]]
|rowspan="3"| Single-grasp
|-
| Stab || Edge || 2 || 400 || 1.0×
|-
| Strike|| Blunt || 10 || 200 || 1.0×
|- valign="top"
|rowspan="3"| Slicing knife
|rowspan="3"|[[File:slicing_knife_sprite.png]]
|rowspan="3"| 150
| Slash || Edge || 900 || 700|| 1.25×
|rowspan="3"| Dagger
|rowspan="3"| Non-warrior NPCs in [[adventurer mode]]
|rowspan="3"| Single-grasp
|-
| Stab || Edge || 3 || 900 || 1.0×
|-
| Strike|| Blunt || 15 || 400 || 1.0×
|- valign="top"
|rowspan="3"| Meat cleaver
|rowspan="3"|[[File:meat_cleaver_sprite.png]]
|rowspan="3"| 300
| Hack|| Edge || 800 || 400 || 1.25×
|rowspan="3"| Axe
|rowspan="3"| Non-warrior NPCs in [[adventurer mode]]
|rowspan="3"| Single-grasp
|-
| Clap || Blunt || 800 || 400 || 1.25×
|-
| Strike || Blunt || 20 || 400 || 1.0×
|- valign="top"
|rowspan="2"| Carving fork
|rowspan="2"| [[File:carving_fork_sprite.png]]
|rowspan="2"| 150
| Stab|| Edge || 1 || 100 || 1.0×
|rowspan="2"| Dagger
|rowspan="2"| Non-warrior NPCs in [[adventurer mode]]
|rowspan="2"| Single-grasp
|-
| Strike || Blunt || 15 || 400 || 1.0×
|}

===Special variations===
Some rare entities have their own [[divine equipment|procedurally generated variations]] of weapons. Currently, these weapons are produced by copying the default properties of the "base" weapon, and adding an adjective ("bulky", "large-headed", "branching", etc.) or renaming the weapon altogether ("blade", "curved sword"). Dwarves in [[strange mood]]s which select from all weapons with a certain tag may produce one of these procedurally generated weapons. Since they retain the properties of their base items, these weapons should be as usable as a standard weapon of the base type.

== Size ==

Weapons have a minimum size to use at all, and a minimum size to use one-handed. Adult dwarves vary in size between 33750 and 93750 (average 60000) based on their height and broadness. Unfortunately, this is currently bugged in fortress mode.{{Bug|0005812}} 'One-handed' vs. 'two-handed' checks are performed correctly, but 'can wield' vs. 'can't wield' ignores height and broadness modifiers. So dwarves in fortress mode will never equip two-handed swords, great axes, halberds, mauls, or pikes. Other weapons have a minimum wielding size of less than 60000, and are wielded one-handed if the individual dwarf is large enough. See [http://www.bay12forums.com/smf/index.php?topic=119068.msg3790913#msg3790913 this] forum post.

The following table shows approximately how many dwarves ''should be'' able to use each weapon one- or two-handed (see [http://www.bay12forums.com/smf/index.php?topic=101379.msg3029579#msg3029579 this forum post] for details), with all fractional numbers being approximate. While there are seven categories each for height and broadness, the number used is chosen randomly from within each category.

Note that there are other factors (such as fat and muscle mass) affecting dwarf size, and e.g. [[DFHack]] {{k|Alt}}+{{k|I}} will take them into account, but (at least in adventure mode) only base height and broadness appear to determine weapon wieldability.

Additionally, even if a creature is large enough to wield a weapon with one hand/appendage, it is still possible to wield it with both/more through [[Wrestling#Bugs|wrestling]] by first lodging it into a target, then grabbing it with a free hand/appendage, and then pulling it free.

Where the size checking bug affects weapon wielding for dwarves, correct approximate figures are given in brackets.
{| class="wikitable sortable" border="border"
|-
! Type
! Min Size
(Two-Handed)
! Min Size
(One-Handed)
! Dwarves
Can't Wield
! Dwarves Wield
Two-Handed
! Dwarves Wield
One-Handed
|- valign="top"
| [[battle axe|Battle Axe]]
| 42500
| 47500
| 1/49 (0)
| 10/49 (11/49)
| 38/49
|- valign="top"
| [[Crossbow]] (Melee)
| 15000
| 0
| -
| -
| 49/49
|- valign="top"
| [[Mace]]
| 32500
| 37500
| -
| 1/49
| 48/49
|- valign="top"
| [[Pick]]
| 42500
| 47500
| 1/49 (0)
| 10/49 (11/49)
| 38/49
|- valign="top"
| [[short sword|Short Sword]]
| 32500
| 37500
| -
| 1/49
| 48/49
|- valign="top"
| [[Spear]]
| 5000
| 47500
| -
| 11/49
| 38/49
|- valign="top"
| [[war hammer|War Hammer]]
| 32500
| 37500
| -
| 1/49
| 48/49
|- valign="top"
| Training Axe
| 42500
| 47500
| 1/49 (0)
| 10/49 (11/49)
| 38/49
|- valign="top"
| Training Sword
| 32500
| 37500
| -
| 1/49
| 48/49
|- valign="top"
| Training Spear
| 42500
| 47500
| 1/49 (0)
| 10/49 (11/49)
| 38/49
|- valign="top"
| [[two-handed sword|2H Sword]]
| 62500
| 77500
| 32/49 (ALL)
| 14/49 (0)
| 3/49 (0)
|- valign="top"
| [[Blowgun]] (Melee)
| 15000
| 0
| -
| -
| 49/49
|- valign="top"
| [[Bow]] (Melee)
| 15000
| 0
| -
| -
| 49/49
|- valign="top"
| [[Flail]]
| 42500
| 47500
| 1/49 (0)
| 10/49 (11/49)
| 38/49
|- valign="top"
| [[great axe|Great Axe]]
| 62500
| 77500
| 32/49 (ALL)
| 14/49 (0)
| 3/49 (0)
|- valign="top"
| [[Halberd]]
| 62500
| 77500
| 32/49 (ALL)
| 14/49 (0)
| 3/49 (0)
|- valign="top"
| [[Dagger]] (Large)
| 5000
| 27500
| -
| -
| 49/49
|- valign="top"
| [[long sword|Long Sword]]
| 52500
| 57500
| 11/49 (0)
| 7/49 (18/49)
| 31/49
|- valign="top"
| [[Maul]]
| 62500
| 77500
| 32/49 (ALL)
| 14/49 (0)
| 3/49 (0)
|- valign="top"
| [[Morningstar]]
| 32500
| 37500
| -
| 1/49
| 48/49
|- valign="top"
| [[pike (weapon)|Pike]]
| 62500
| 77500
| 32/49 (ALL)
| 14/49 (0)
| 3/49 (0)
|- valign="top"
| [[Scimitar]]
| 32500
| 37500
| -
| 1/49
| 48/49
|- valign="top"
| [[Scourge]]
| 22500
| 27500
| -
| -
| 49/49
|- valign="top"
| [[Whip]]
| 22500
| 27500
| -
| -
| 49/49
|}

==Material==

Weapons and armor (with a few exceptions) can only be forged from weapon-grade metals (adamantine, steel, iron, silver, bronze, bismuth bronze, copper, and divine metal), wood, or bone. The exceptions include obsidian short-swords and items created during a strange mood.

{{v0.31 material metal table head}}

{{v0.31 material metal table row|name=Adamantine|color={{Tile|/|3:1}}3:3:1|source=[[Raw adamantine]]|notes= |soliddensity=0.200|mp=25000|val=300|valinc=+50|impactyield=5000|impactfracture=5000|impactelasticity=0|shearyield=5000|shearfracture=5000|shearelasticity=0
}}

{{v0.31 material metal table row|name=Divine metal|notes= |soliddensity=1.0|val=300|impactyield=1000|impactfracture=2000|impactelasticity=0|shearyield=1000|shearfracture=2000|shearelasticity=0
}}

{{v0.31 material metal table row|name=Steel|color={{Tile|/|0:1}}0:7:1|source=[[Iron]] + [[Pig iron]] + [[flux]] stone + [[fuel]] '''!'''|notes= |soliddensity=7.85|val=30|valinc=+20|mp=12718|impactyield=1505|impactfracture=2520|impactelasticity=940|shearyield=430|shearfracture=720|shearelasticity=215
}}

{{v0.31 material metal table row|name=Bismuth bronze|color={{Tile|/|6:1}}6:6:1|source=2 [[Copper]] + 1 [[Tin]] + 1 [[Bismuth]] '''!'''|notes= |soliddensity=8.25|val=6|valinc=+4|mp=11868|impactyield=602|impactfracture=843|impactelasticity=547|shearyield=172|shearfracture=241|shearelasticity=156
}}

{{v0.31 material metal table row|name=Bronze|color={{Tile|/|6:0}}6:4:0|source=[[Tin]] + [[Copper]]|notes= |soliddensity=8.25|val=5|valinc=+3|mp=11868|impactyield=602|impactfracture=843|impactelasticity=547|shearyield=172|shearfracture=241|shearelasticity=156
}}

{{v0.31 material metal table row|name=Iron|color={{Tile|/|0:1}}0:7:1|source=[[Hematite]], [[Limonite]], [[Magnetite]]|notes= |soliddensity=7.85|mp=12768|val=10|valinc=+2|impactyield=542|impactfracture=1080|impactelasticity=319|shearyield=155|shearfracture=310|shearelasticity=189
}}

{{v0.31 material metal table row|name=Copper|color={{Tile|/|6:0}}6:4:0|source=[[Native copper]], [[Malachite]], [[Tetrahedrite]]|notes= |soliddensity=8.93|mp=11952|val=2|valinc=+0, +0, -1*|impactyield=245|impactfracture=770|impactelasticity=175|shearyield=70|shearfracture=220|shearelasticity=145
}}

{{v0.31 material metal table row|name=Silver|color={{Tile|/|7:1}}7:7:1|source=[[Native silver]], [[Horn silver]], [[Galena]] (50%), [[Tetrahedrite]] (20%) |notes= |soliddensity=10.49|mp=11731|val=10|valinc=+0, +0, +5*, +7*|impactyield=350|impactfracture=595|impactelasticity=350|shearyield=100|shearfracture=170|shearelasticity=333
}}

{{v0.31 material metal table row|name=Platinum|color={{Tile|/|7:1}}7:7:1|source=[[Native platinum]]|notes= Only available as artifact weapons.|soliddensity=21.4|mp=13182|val=40|valinc=+?, +?, +?, +?|impactyield=350|impactfracture=700|impactelasticity=152|shearyield=100|shearfracture=200|shearelasticity=164
}}

{{v0.31 material metal table row|name=Bone|color={{Tile|/|7:1}}7:7:1|source=Creatures|notes= |soliddensity=0.50|mp=NONE(burn at 10250)|val=1|valinc=+?, +?, +?, +?|impactyield=200|impactfracture=200|impactelasticity=100|shearyield=115|shearfracture=130|shearelasticity=100
}}

{{v0.31 material metal table row|name=Wood|color={{Tile|/|6:0}}7:7:1|source=Trees|notes= |soliddensity=0.50|mp=NONE(burn at 10250)|val=1|valinc=+?, +?, +?, +?|impactyield=10|impactfracture=10|impactelasticity=1000|shearyield=40|shearfracture=40|shearelasticity=1000
}}

{{v0.31 material metal table row|name=Shell|color={{Tile|/|2:0}}7:7:1|source=Creatures|notes= Only available as artifact weapons.|soliddensity=0.50|mp=NONE(burn at 10250)|val=1|valinc=+?, +?, +?, +?|impactyield=200|impactfracture=200|impactelasticity=100|shearyield=115|shearfracture=130|shearelasticity=100
}}

{{v0.31 material metal table row|name=Leather|color={{Tile|/|2:0}}7:7:1|source=Creatures|notes= Material data added for comparison.|soliddensity=0.50|mp=NONE(burn at 10250)|val=1|valinc=+?, +?, +?, +?|impactyield=10|impactfracture=10|impactelasticity=50000|shearyield=25|shearfracture=25|shearelasticity=50000
}}

{{v0.31 material metal table row|name=Obsidian|color={{Tile|/|0:1}}7:7:1|source=Lava|notes= Only available for Short Swords.|soliddensity=2.67|mp=13600|val=3|valinc=+0|impactyield=1000|impactfracture=1000|impactelasticity=2222|shearyield=35|shearfracture=35|shearelasticity=114
}}

{{v0.31 material metal table row|name=Crystal glass|color={{Tile|/|7:1}}7:7:1|source=Sand|notes= Only available as trap components.|soliddensity=2.6|mp=13600|val=10|valinc=+0|impactyield=1000|impactfracture=1000|impactelasticity=2222|shearyield=33|shearfracture=33|shearelasticity=113
}}

{{v0.31 material metal table row|name=Clear glass|color={{Tile|/|3:0}}7:7:1|source=Sand|notes= Only available as trap components.|soliddensity=2.6|mp=13600|val=5|valinc=+0|impactyield=1000|impactfracture=1000|impactelasticity=2222|shearyield=33|shearfracture=33|shearelasticity=113
}}

{{v0.31 material metal table row|name=Green glass|color={{Tile|/|2:0}}7:7:1|source=Sand|notes= Only available as trap components.|soliddensity=2.6|mp=13600|val=2|valinc=+0|impactyield=1000|impactfracture=1000|impactelasticity=2222|shearyield=33|shearfracture=33|shearelasticity=113
}}

|}

*''Combat information'' is used internally by the game to determine the combat properties of weapons and armor made from this metal:
**'''Density''': Used in conjunction with other factors - heavier weapons (higher numbers) hit with a bit more force, very light weapons tend to have less penetration. Value shown here is g/cm3, which is the raw value divided by 103
**'''Impact yield''': Used for blunt-force combat; ''higher'' is better for blunt weapons, but ''lower'' is better for armor. This is the raw value divided by 103 (i.e., kPa).
**'''Impact fracture''': Used for blunt-force combat; ''higher'' is better. This is the raw value divided by 103 (i.e., kPa).
**'''Impact elasticity''' (or '''strain at yield'''): Used for blunt-force combat; ''lower'' is better. This is the raw value.
**'''Shear yield''': Used for cutting calculations in combat; ''higher'' is better. This is the raw value divided by 103 (i.e., kPa).
**'''Shear fracture''': Used for cutting calculations in combat; ''higher'' is better. This is the most important indicator of edged strength. This is the raw value divided by 103 (i.e., kPa).
**'''Shear elasticity''' (or '''strain at yield'''): Used for cutting calculations in combat; ''lower'' is better. This is the raw value.

*General Term Explanations (from Wikipedia)
**'''Yield Strength''' - The stress at which material strain changes from elastic deformation to plastic deformation, causing it to deform permanently.
**'''Fracture Strength''' - The stress coordinate on the stress-strain curve at the point of rupture.
**'''Stress''' - Force per area = F/A
**'''Strain''' - Deformation of a solid due to stress = Stress/Young's Modulus

=== Explanation ===
* '''Yield Strength''' is the amount of stress required to permanently deform (bend) a material (plastic deformation).
* '''Fracture Strength''' is the amount of stress required to permanently break (rupture) a material.
* '''Elasticity''' or '''Strain at yield''' is the amount of deformation (bending) that occurs at the yield point.

=== Implications ===
Yield strength combined with strain at yield can tell what a material will do under stress (be it from a hammer, axe, or arrow); higher yield means that it takes more stress to deform, while lower strain at yield means that it will deform less when stress is applied.

== Combat formulae ==

Penetration is poorly understood, but most of the rest of combat is fairly well understood. Maybe it defines how deep a blade may go through layers of armor and flesh and bones and even cut off limbs. This may explain why it does not apply for blunt attacks that do not go through layers.

First, you need to calculate your weapon's momentum.

Melee Weapon Momentum: M = Skill * Size * Str * Vel / (106 * (1 + i_Size/(w_density*w_size) ))
* Dwarf Melee Momentum: M = 0.06 * Str * Vel / (1 + i_Size/(w_density*w_size) )
* Quick attacks halve melee momentum, wild and heavy attacks multiply it by 1.5
* Attacking a prone opponent in melee doubles momentum.

Ranged Weapon Momentum: M = (w_density*w_size)/105 * min(105*(SHOOT_FORCE/20)/(w_density*w_size), SHOOT_MAXVEL/10)
* Bow and Crossbow Momentum: M = (w_density*150)/105 * min(105/(w_density*3), 20)
** If 20 is smaller because the ammunition is density 1666 or less, M = w_density*3/100 = w_density*0.03
** If 20 is larger because the ammunition is density 1667 or larger, M = 50
* Blowgun Momentum: M = (w_density*20)/105 * min(105/(w_density*4), 100)
** If 100 is smaller because the ammunition is density 250 or less, M = w_density/50 = w_density*0.02
** If 100 is larger because the ammunition is density 251 or more, M = 5

where:
* '''M''' is the momentum.
* '''Skill''' is a gradual multiplier based on skill level, from 1x base up to 2x at Grand Master.
* '''Str''' is the creature's strength (e.g. 1250 for the average dwarf)
* '''Vel''' is the weapon's velocity modifier if present (e.g. 1.25x, 2x)
* '''Size''' is the average creature size (e.g. 60000 for dwarves)
* '''i_Size''' is the specific creature's size
** Dwarves range from a minimum size of 33750 to a maximum size of 93750, with an average size of 60000.
* '''w_density''' is the weapon's material's density for melee weapons, or the ammunition's density for ranged weapons
* '''w_size''' is the weapon's size for melee weapons, or the ammunition's size for ranged weapons
* '''SHOOT_FORCE''' is the ranged weapon's SHOOT_FORCE constant, which is used to determine its maximum momentum.
* '''SHOOT_MAXVEL''' is the ranged weapon's SHOOT_MAXVEL constant, which is used to determine its maximum velocity, where ammo momentum = ammo mass * ammo velocity.

An edged weapon undergoes the following comparison:

M >= (aSY/wSY + (A+1)*aSF/wSF) * (10 + 2*a_quality) / (Sha * w_quality),

where:
* '''aSY''' is the armor's SHEAR_YIELD, which is based on its material
* '''wSY''' is the weapon's SHEAR_YIELD, which is based on its material
* '''aSF''' is the armor's SHEAR_FRACTURE, which is based on its material
* '''wSF''' is the weapon's SHEAR_FRACTURE, which is based on its material
* '''A''' is attack [[Material science#Contact_Area|contact area]]
* '''Sha''' is weapon material [[edge|sharpness]] multiplier (1x for most metals, 1.2x for [[divine metal]], 1.5x for [[glass]], 2x for [[obsidian]], 10x for [[adamantine]] and 0.1x for all other materials)
* '''w_quality''' is weapon [[quality]] sharpness multiplier (0.5x for normal quality, 0.7x for fine, 1x for masterwork, etc.)
* '''a_quality''' is armor [[quality]] multiplier

Expressed in the above terms,

* 0.06 * Str * Vel / (1 + i_Size/(w_density*w_size)) >= (aSY/wSY + (A+1)*aSF/wSF) * (10 + 2*Qa) / (Sha * w_quality)
* 0.06 * Sha * w_quality * Str * Vel / (1 + i_Size/(w_density*w_size)) >= (aSY/wSY + (A+1)*aSF/wSF) * (10 + 2*a_quality)
* 0.06 * Sha * w_quality * Str * Vel / ((1 + i_Size/(w_density*w_size)) * (10 + 2*a_quality)) >= aSY/wSY + (A+1)*aSF/wSF

Because Shear Yield and Shear Fracture are always within a power of 10 of each other for actually available materials, but the smallest possible A value is 20 (a blowgun dart, which is smaller than the smallest item of clothing/armor a dwarf can wear), this means that in practice, Shear Fracture is significantly more important than Shear Yield, and you can reliably compare weapons and armor without paying attention to Shear Yield. In both cases, higher is better on both weapons and armor, as is quality. Sharpness only matters to the weapon, and smaller contact area is better for the attacker.

If the test is passed, attack momentum is decreased by some 5% and the layer is considered punctured/severed, and the process continues to the next layer, including working through layers of the defender's body. If the test is failed, the attack becomes blunt for this layer.

If the attack is blunt, either due to starting off blunt or due to failing the above test, it is then subjected to this test:

2 * w_size * wIY > A * a_density

where:
* '''a_density''' is the armor material's density
* '''wIY''' is the weapon's impact yield in MPa (i.e. raw value divided by 106). {{verify}}

Failure means the attack bounces off, meaning denser, larger armor resists blunt attacks better, but larger blunt weapons with smaller contact areas and higher impact yields get through armor better. This also means adamantine armor is some of the worst in the game at outright deflecting attacks, due to its poor density, but this is not typically relevant, as impact yields are typically at least 10 times larger than density values for the actual metals available, so this step is routinely passed by most weapons regardless of relative materials.

On success, the following test is applied:

M >= (2*aIF - aIY) * (2 + 0.4*a_quality) * A,

where:
* '''aIF''' is the armor's impact fracture in MPa (i.e. raw value divided by 106)
* '''aIY''' is the armor's impact yield in MPa (i.e. raw value divided by 106).

Note that the armor wants as high impact fracture as possible to make this test fail. The armor also wants low impact yield, although the weapon's impact fracture does not matter, and high quality and high contact area.

On a success, attack momentum is decreased by some 5% and the layer is considered punctured/severed, and the process continues to the next layer, including working through layers of the defender's body. If the attack was edged, it becomes edged again. On a failure, the momentum is multiplied by SHEAR_STRAIN_AT_YIELD/50000 for edged attacks or IMPACT_STRAIN_AT_YIELD/50000 for blunt attacks, then it becomes *permanently* blunt, and is passed on to the next layer. This means most rigid metal armor will reduce blocked attacks by 98%-99%, but elastic armor, such as a mail shirt, has both strain at yield values raised to 50000, so it multiplies by 1 at this step (i.e. does nothing to the momentum, but does still convert it to blunt) regardless of material.

== Combat testing ==
In regards to edged weaponry: [[adamantine]] and [[steel]] take first and a distant second place respectively, with [[iron]] a slightly less distant third best material in the game, nearly matched by the [[bronze]]s. Beyond that is [[copper]], the second worst material, and [[silver]] is the worst weapon material available (and due to the existence of training weapons, not even useful in that regard).

Additionally, with regards to blunt weapons, almost all of the non-adamantine materials perform equally well, with a very slight edge towards steel and silver. Here is the thread with the details: [http://www.bay12forums.com/smf/index.php?topic=53571.0].

Keep in mind that, given how unbelievably complicated this system is, very little should be taken as word of law yet.

{| class="wikitable"
|-
!
! Best
! Better
! Good
! Fair
! Poor
! Terrible
! Notes
|-
| Armor
| Adamantine
| Steel
| Iron
| Bronze, Bismuth Bronze
| Copper
|
|
|-
| Edged Weapons
| Adamantine
| Steel
| Iron
| Bronze, Bismuth Bronze
| Copper
| Silver
| For piercing iron armor, copper is better than bronze, but when piercing copper or bronze armor, bronze is better than copper.
|-
| Ammunition
| Steel, Iron, Bronze, Bismuth Bronze, Copper, Silver
|
| Adamantine
|
|
|
| Adamantine bolts deflect off of adamantine armor, but otherwise their performance is on par with bolts made out of other metals.
|-
| Blunt Weapons
| Platinum, Slade
| Steel, Silver
| Copper, Bismuth Bronze, Bronze, Iron
|
|
| Adamantine
| All six standard weapon metals perform nearly identically. Steel has a slightly higher rate of critical wounds, while silver is slightly more likely to penetrate armor. Platinum (only available as [[artifact]] weapons) has twice the density of silver and several other improved properties, making it the best metal for impact weapons, though very limited in production. Adamantine's light weight makes it a terrible choice for blunt weapons, roughly the same as making a weapon out of [[featherwood]] or cork.
|}

Cross referencing this table with the table at the top of this section seems to indicate that low densities, high impact fractures, and high shear fractures contribute to the killing power of edged weapons.

===Analysis===
Testing of weapons (15 dwarves-versus-15 dwarves combat) in the [[object testing arena]] shows that the best dwarven-made weapon against unarmored humanoids is the battle axe, while the war hammer performs the best against armored targets.

Even in 15×(steel armor+silver war hammer) versus 15×(adamantine armor+adamantine battle axe) matches, hammerdwarves won with less than 50% casualties (mostly one-strike kills). However, when the dwarves in question were without armor or only wearing leather/cloth, the result was inverted — axedwarves won with less than 50% casualties. In battles against megabeasts, 6 silver hammerdwarves were barely able to scratch a [[bronze colossus]] (attacks were glancing away) due to bronze being a better "weapon" material.

This is because silver has the highest solid density of all materials that can regularly be made into weapons by dwarves. Tests show that indeed [[gold]] and [[platinum]] (increasingly dense) do increasing amounts of damage, and that war hammers remain the tool of choice, however they can only be produced by a moody dwarf (and a very lucky one at that).

For more on ranged ammunition see the forum thread [http://www.bay12forums.com/smf/index.php?topic=116151.0 Dwarven Research: A Comparison Study on the Effectiveness of Bolts vs Armors].

More arena tests are available in the [[Main:Military testing|Military testing]] article.

==Bugs==
*Equipping weapons/armor on military is erratic. This is likely due to a single piece of weapons/armor being erroneously assigned to multiple dwarves and seems to occur when dwarves are upgrading their equipment or going on raids. Removing and reassigning equipment for all military dwarves can temporarily fix this problem.{{Bug|535}}
*'One-handed' vs. 'two-handed' checks are performed correctly, but 'can wield' vs. 'can't wield' ignores height and broadness modifiers, so dwarves in Fortress mode cannot equip two-handed swords, great axes, halberds, mauls, or pikes.{{bug|5812}}
*In the Premium version, the sprite sheets for equipped gear are mostly incomplete. The material of equipped gear is currently distinguished for [[dwarf|dwarves]], for [[elf|elves']] and [[kobold|kobolds']] [[armor]] (including metal armor), and for elves' wooden weapons; everything else has a default, 'gray' color palette.
*The Premium version has placeholder sprites for equipped artifact gear (which can be any material), but these are not used for gear of nonstandard materials spawned in the [[object testing arena]], resulting in creatures that use them appearing un-equipped.

==See also==
* [[User:Shinziril#Weapons_and_Armor|Outstanding research]] on weapons and armor by Shinziril

{{Weapons}}
{{Industry}}
{{Category|Weapons}}

Vermin

2025-06-24T00:13:00Z

DikbutDaGrate: Moon snail was listed as no capture. However, it can be caught due to vermin grounder.

{{av}}
{{Quality|Exceptional|1:00, 2 Februaru 2023 (UTC)}}
[[File:vermin_sprites_preview.png|right]]'''Vermin''' includes small land [[creature]]s such as [[rat]]s, [[bat]]s, and [[lizard]]s, and also the type of [[fish]] which are caught by [[fisherdwarf|fisherdwarves]]. They are below 2 kg (4 lb) in size, much smaller than [[cat]]s. Vermin are hard to see, but can be noted if you are particularly observant, as they will occasionally blink into and out of view on the screen. Unlike other non-vermin creatures, they cannot be selected and have their attributes viewed.

The main distinctions between vermin and creatures are that vermin:
# Cannot be engaged in [[combat]] or trigger [[trap]]s, save those specifically made to trap them, though some (such as the [[cave spider]]) can bite and inflict syndromes;
# Do not usually provide [[meat]] or [[bone]]s. Exceptions are the [[creepy crawler]], which can be butchered, and the [[purring maggot]] which can be milked;
# Do not breed, but "spawn", spontaneously appearing in their natural environment or [[biome]]. Some types of vermin are inexhaustible and will always be able to spawn, regardless of how many are killed or captured;
# Are sometimes "[[hateable]]", meaning dwarves can have an anti-[[preference]], which gives them a negative [[thought]] when they see the hated vermin.
{{catbox}}
Vermin can be problematic, as many types feed on [[stockpile]]s, thus making it more difficult to keep enough [[food]] and [[alcohol|drink]] to survive. Vermin can be hunted by [[cat]]s and [[peregrine falcon]]s to reduce this problem, though the [[remains]] will still need to be [[Activity zone#Garbage Dump|removed]]. Cats and falcons can be [[pasture]]d at the relevant stockpiles to further reduce the problem.

Some vermin can be captured in [[animal trap]]s, but those with the {{token|VERMIN_NOTRAP|c}} token can only be caught with a "Capture a Live Land Animal" job, while those with the {{token|VERMIN_SOIL|c}} token will be ignored for that job. Once caught, some can be trained as [[pet]]s. A few particular captured vermin can be used to produce [[extract]]s using a glass [[vial]] and the [[animal dissector]] labor. Captured [[purring maggot]]s can also be [[milk]]ed at a farmer's workshop. Vermin don't die of old age at all - if you capture one, it should last forever.

Captured vermin can be assigned to built cages, but not to pastures.

Graphically, the sprites of some flying vermin, such as the [[acorn fly]], [[fly]], [[blood gnat]], [[honey bee]], [[mosquito]] and [[pixie|pixies]], will resemble multiple bugs of that type in a single tile; they can be seen in amounts of one, three, five and nine; depending on how large the swarm is. Dwarves will eat vermin if no other [[food]] source is available, resulting in an unhappy [[thought]]. Most vermin cannot be spawned in the [[object testing arena]], as those are not able to engage in combat anyway.

In [[adventure mode]], you can reveal the location of previously-hidden, nearby vermin by pressing {{Adv menu icon|L}}. Your character can also pick up vermin if they are on the same tile. Attempting to ''eat'' any collected vermin, however, will make a unique message appear: {{DFtext|No. That's disgusting.|2:0}}, unless the character is actually starving.

==Reading the Table==
{{v50_creaturecurrent table head}}
|}
The above columns indicate, in order:
*'''Graphic:''' The sprite assigned to the creature; seen only in the [[premium version#Premium_version_.282020.E2.80.93Present.29|premium version]]s.
*'''Tile:''' The symbol assigned to the vermin, how you will see it without a graphic set.
*'''Name:''' The name of the vermin as it shows up in-game.
*'''Playable:''' Whether the vermin is playable in any of the game modes. As of now, no vermin are playable.
*'''Hostile:''' Whether the vermin is hostile to the player. As of now, no vermin are hostile to dwarves.
*'''Food Source:''' If "Yes" then the vermin can be turned into food when processed in a [[fishery]].
*'''Adult Body Size:''' The average size of the vermin when an adult. This can be anywhere from 1 for a [[fly]], to 2,000 for a [[fox squirrel]]. More or less equals the creature's weight in grams.
*'''Pet Value:''' This is the value the vermin can be bought and sold for as a [[pet]], during [[trading]].
*'''Biome:''' Where the vermin can be found.
*'''Features:''' Any special features the vermin possesses, these can include alignment and special properties. The value after 'Eater' indicates the vermin's [[Creature_token#PENETRATEPOWER|container penetration value]].

==Vermin==
{{v50_creaturecurrent table head|class="wikitable sortable"}}
{{v50_creaturecurrent table row|graphic=[[File:acorn_fly_sprite_anim.gif]]|name=Acorn fly|symbol=·|color=6:0:1|food=No|playable=No|hostile=N/A|size=20|value=0|biome=Any pool|note=Savage, no trap, attracted to rot}}
{{v50_creaturecurrent table row|name=Anchovy|symbol=α|color=7:0:1|food=Yes|playable=No|hostile=N/A|size=200|value=0|biome=Temperate oceans|note=No trap}}
{{v50_creaturecurrent table row|name=Anole|symbol=∙|color=2:0:1|food=No|playable=No|hostile=N/A|size=90|value=10|biome=Any tropical forest|note=}}
{{v50_creaturecurrent table row|name=Ant|symbol=∙|color=7:0:0|food=No|playable=No|hostile=N/A|size=1|value=0|biome=Not freezing|note=No trap}}
{{v50_creaturecurrent table row|name=Axolotl|symbol=∙|color=5:0:0|food=No|playable=No|hostile=N/A|size=200|value=10|biome=Tropical saltwater, brackish and freshwater lakes|note=}}
{{v50_creaturecurrent table row|name=Banded knifefish|symbol=α|color=6:0:0|food=Yes|playable=No|hostile=N/A|size=200|value=0|biome=Tropical freshwater lakes and rivers|note=No trap}}
{{v50_creaturecurrent table row|name=Bark scorpion|symbol=∙|color=6:0:1|food=No|playable=No|hostile=N/A|size=3|value=0|biome=Tropical grasslands, savannas, shrublands, coniferous forests and any desert|note=Hateable}}
{{v50_creaturecurrent table row|name=Bat|symbol=∙|color=0:0:1|food=No|playable=No|hostile=N/A|size=100|value=10|biome=Not freezing, subterranean chasms|note=Hateable}}
{{v50_creaturecurrent table row|name=Bat ray|symbol=ò|color=7:0:0|food=Yes|playable=No|hostile=N/A|size=200|value=0|biome=Temperate and tropical oceans|note=No trap}}
{{v50_creaturecurrent table row|name=Beetle|symbol=·|color=4:0:0|food=No|playable=No|hostile=N/A|size=1|value=0|biome=Not freezing|note=No trap, no capture}}
{{v50_creaturecurrent table row|name=Black bullhead|symbol=α|color=6:0:0|food=Yes|playable=No|hostile=N/A|size=200|value=0|biome=Temperate brackish and freshwater lakes|note=No trap}}
{{v50_creaturecurrent table row|graphic=[[File:blood_gnat_sprite_anim.gif]]|name=Blood gnat|symbol=·|color=4:0:1|food=No|playable=No|hostile=N/A|size=1|value=0|biome=Any pool|note=Hateable, no trap, evil, attracted to rot}}
{{v50_creaturecurrent table row|name=Blue jay|symbol=∙|color=1:0:1|food=No|playable=No|hostile=N/A|size=100|value=30|biome=Temperate grasslands, savannas, shrublands, broadleaf and coniferous forests|note=}}
{{v50_creaturecurrent table row|name=Brook lamprey|symbol=~|color=3:0:0|food=Yes|playable=No|hostile=N/A|size=200|value=0|biome=Temperate saltwater, brackish and freshwater lakes, tropical oceans|note=No trap}}
{{v50_creaturecurrent table row|name=Brown bullhead|symbol=α|color=6:0:0|food=Yes|playable=No|hostile=N/A|size=200|value=0|biome=Temperate brackish and freshwater lakes|note=No trap}}
{{v50_creaturecurrent table row|name=Brown recluse spider|symbol=∙|color=6:0:0|food=No|playable=No|hostile=N/A|size=1|value=0|biome=Temperate broadleaf forests|note=Hateable, produces [[web]]}}
{{v50_creaturecurrent table row|name=Bumblebee|symbol=·|color=6:0:1|food=No|playable=No|hostile=N/A|size=1|value=0|biome=Not freezing|note=No trap}}
{{v50_creaturecurrent table row|name=Bushtit|symbol=∙|color=6:0:0|food=No|playable=No|hostile=N/A|size=5|value=30|biome=Any temperate forest|note=}}
{{v50_creaturecurrent table row|name=Cap hopper|symbol=∙|color=2:0:0|food=No|playable=No|hostile=N/A|size=200|value=10|biome=Subterranean water|note=}}
{{v50_creaturecurrent table row|name=Cardinal|symbol=∙|color=4:0:1|food=No|playable=No|hostile=N/A|size=50|value=30|biome=Temperate grasslands, savannas, shrublands, broadleaf and coniferous forests|note=}}
{{v50_creaturecurrent table row|name=Cave fish|symbol=α|color=7:0:1|food=Yes|playable=No|hostile=N/A|size=1000|value=0|biome=Subterranean water|note=No trap}}
{{v50_creaturecurrent table row|name=Cave lobster|symbol=¥|color=7:0:1|food=Yes|playable=No|hostile=N/A|size=600|value=0|biome=Subterranean water|note=}}
{{v50_creaturecurrent table row|name=Cave spider|symbol=∙|color=7:0:0|food=No|playable=No|hostile=N/A|size=50|value=0|biome=Subterranean water and chasm|note=Hateable, produces web}}
{{v50_creaturecurrent table row|name=Cave swallow|symbol=∙|color=0:0:1|food=No|playable=No|hostile=N/A|size=100|value=30|biome=Subterranean chasm|note=}}
{{v50_creaturecurrent table row|name=Chameleon|symbol=∙|color=2:0:1|food=No|playable=No|hostile=N/A|size=150|value=10|biome=Any tropical forest, tropical shrublands and savannas, any desert|note=}}
{{v50_creaturecurrent table row|name=Char|symbol=α|color=0:0:1|food=Yes|playable=No|hostile=N/A|size=200|value=0|biome=Temperate freshwater rivers and lakes|note=No trap}}
{{v50_creaturecurrent table row|name=Chipmunk|symbol=∙|color=6:0:0|food=No|playable=No|hostile=N/A|size=300|value=10|biome=Any temperate forest|note=}}
{{v50_creaturecurrent table row|name=Clown loach|symbol=α|color=6:0:1|food=Yes|playable=No|hostile=N/A|size=200|value=0|biome=Tropical freshwater rivers and lakes|note=No trap}}
{{v50_creaturecurrent table row|name=Clownfish|symbol=α|color=4:0:1|food=Yes|playable=No|hostile=N/A|size=200|value=0|biome=Tropical oceans|note=No trap}}
{{v50_creaturecurrent table row|name=Cockatiel|symbol=∙|color=7:0:1|food=No|playable=No|hostile=N/A|size=90|value=30|biome=Any desert, temperate grasslands|note=}}
{{v50_creaturecurrent table row|name=Creepy crawler|symbol=*|color=6:0:0|food=Yes|playable=No|hostile=N/A|size=1000|value=20|biome=Underground chasm|note=Evil, attracted to rot, butcherable}}
{{v50_creaturecurrent table row|name=Crow|symbol=∙|color=0:0:1|food=No|playable=No|hostile=N/A|size=500|value=10|biome=Temperate forests, grasslands, savannas, shrublands and wetlands, taiga|note=}}
{{v50_creaturecurrent table row|name=Cuttlefish|symbol=♂|color=6:0:0|food=Yes|playable=No|hostile=N/A|size=1000|value=10|biome=Any ocean|note=}}
{{v50_creaturecurrent table row|name=Damselfly|symbol=∙|color=3:0:1|food=No|playable=No|hostile=N/A|size=1|value=0|biome=Any pool|note=No trap}}
{{v50_creaturecurrent table row|name=Demon rat|symbol=∙|color=4:0:0|food=No|playable=No|hostile=N/A|size=300|value=20|biome=Not freezing|note=Evil, eater 3}}
{{v50_creaturecurrent table row|name=Dragonfly|symbol=∙|color=3:0:1|food=No|playable=No|hostile=N/A|size=1|value=0|biome=Any pool|note=No trap}}
{{v50_creaturecurrent table row|name=Fairy|symbol=∙|color=6:0:1|food=No|playable=No|hostile=N/A|size=100|value=10|biome=All except pools, rivers, and underground|note=No trap, good, [[fanciful]]}}
{{v50_creaturecurrent table row|name=Fire snake|symbol=∙|color=6:0:1|food=No|playable=No|hostile=N/A|size=1000|value=10|biome=Subterranean lava|note=Hateable}}
{{v50_creaturecurrent table row|name=Firefly|symbol=∙|color=2:0:1|food=No|playable=No|hostile=N/A|size=1|value=0|biome=Not freezing|note=No trap}}
{{v50_creaturecurrent table row|name=Flounder|symbol=α|color=6:0:0|food=Yes|playable=No|hostile=N/A|size=200|value=0|biome=Temperate oceans|note=No trap}}
{{v50_creaturecurrent table row|name=Fluffy wambler|symbol=∙|color=7:0:1|food=No|playable=No|hostile=N/A|size=2000|value=20|biome=Any land|note=Good, eater 1}}
{{v50_creaturecurrent table row|graphic=[[File:fly_sprite_anim.gif]]|name=Fly|symbol=·|color=0:0:1|food=No|playable=No|hostile=N/A|size=1|value=0|biome=Not freezing, any pool|note=Hateable, no trap, attracted to rot}}
{{v50_creaturecurrent table row|name=Flying squirrel|symbol=∙|color=6:0:0|food=No|playable=No|hostile=N/A|size=200|value=10|biome=Any temperate forest|note=}}
{{v50_creaturecurrent table row|name=Fox squirrel|symbol=∙|color=6:0:0|food=No|playable=No|hostile=N/A|size=2000|value=100|biome=Any temperate forest|note=Savage}}
{{v50_creaturecurrent table row|name=Glasseye|symbol=α|color=4:0:1|food=Yes|playable=No|hostile=N/A|size=200|value=0|biome=Tropical oceans|note=No trap}}
{{v50_creaturecurrent table row|name=Grackle|symbol=∙|color=0:0:1|food=No|playable=No|hostile=N/A|size=120|value=30|biome=Temperate grasslands and savannas|note=}}
{{v50_creaturecurrent table row|name=Grasshopper|symbol=·|color=2:0:1|food=No|playable=No|hostile=N/A|size=1|value=0|biome=Not freezing|note=No trap}}
{{v50_creaturecurrent table row|name=Gray squirrel|symbol=∙|color=7:0:0|food=No|playable=No|hostile=N/A|size=300|value=10|biome=Any temperate forest|note=}}
{{v50_creaturecurrent table row|name=Green tree frog|symbol=∙|color=2:0:1|food=No|playable=No|hostile=N/A|size=100|value=10|biome=Temperate freshwater lakes, pools, swamps and marshes|note=}}
{{v50_creaturecurrent table row|name=Guppy|symbol=α|color=1:0:1|food=Yes|playable=No|hostile=N/A|size=200|value=0|biome=Tropical brackish, saltwater and freshwater lakes and rivers|note=No trap}}
{{v50_creaturecurrent table row|name=Hagfish|symbol=~|color=6:0:0|food=Yes|playable=No|hostile=N/A|size=200|value=0|biome=Arctic and temperate oceans|note=No trap}}
{{v50_creaturecurrent table row|name=Hake|symbol=α|color=7:0:1|food=Yes|playable=No|hostile=N/A|size=200|value=0|biome=Arctic and temperate oceans|note=No trap}}
{{v50_creaturecurrent table row|name=Hamster|symbol=∙|color=7:0:0|food=No|playable=No|hostile=N/A|size=150|value=10|biome=Not freezing|note=Hateable, eater 2}}
{{v50_creaturecurrent table row|name=Hedgehog|symbol=∙|color=6:0:0|food=No|playable=No|hostile=N/A|size=800|value=10|biome=Temperate shrublands and savannas|note=}}
{{v50_creaturecurrent table row|name=Herring|symbol=α|color=3:0:1|food=Yes|playable=No|hostile=N/A|size=200|value=0|biome=Arctic and temperate oceans|note=No trap}}
{{v50_creaturecurrent table row|graphic=[[File:honey_bee_sprite_anim.gif]]|name=Honey bee|symbol=·|color=6:0:1|food=No|playable=No|hostile=N/A|size=1|value=1|biome=Not freezing|note=Usable for [[beekeeping industry]], no trap}}
{{v50_creaturecurrent table row|name=Jumping spider|symbol=·|color=0:0:1|food=No|playable=No|hostile=N/A|size=1|value=0|biome=Not freezing|note=Hateable}}
{{v50_creaturecurrent table row|name=Knuckle worm|symbol=~|color=0:0:1|food=No|playable=No|hostile=N/A|size=1000|value=100|biome=Not freezing|note=Evil}}
{{v50_creaturecurrent table row|name=Large roach|symbol=∙|color=6:0:0|food=No|playable=No|hostile=N/A|size=1|value=5|biome=Not freezing|note=Hateable, eater 2, no trap}}
{{v50_creaturecurrent table row|name=Leech|symbol=~|color=0:0:1|food=No|playable=No|hostile=N/A|size=100|value=10|biome=Any lake and pool|note=Hateable, no trap, no capture}}
{{v50_creaturecurrent table row|name=Leopard gecko|symbol=∙|color=6:0:1|food=No|playable=No|hostile=N/A|size=50|value=10|biome=Any desert|note=}}
{{v50_creaturecurrent table row|name=Lion tamarin|symbol=∙|color=6:0:1|food=No|playable=No|hostile=N/A|size=620|value=10|biome=Tropical moist broadleaf forests|note=}}
{{v50_creaturecurrent table row|name=Lizard|symbol=∙|color=6:0:0|food=No|playable=No|hostile=N/A|size=200|value=10|biome=Not freezing|note=Hateable, eater 1}}
{{v50_creaturecurrent table row|name=Lorikeet|symbol=∙|color=4:0:1|food=No|playable=No|hostile=N/A|size=200|value=30|biome=Tropical moist broadleaf forests, mangrove swamps|note=}}
{{v50_creaturecurrent table row|name=Louse|symbol=·|color=6:0:0|food=No|playable=No|hostile=N/A|size=1|value=0|biome=Not freezing|note=No trap, no capture}}
{{v50_creaturecurrent table row|name=Lungfish|symbol=α|color=6:0:0|food=Yes|playable=No|hostile=N/A|size=200|value=0|biome=Tropical brackish, saltwater and freshwater lakes, rivers and pools|note=No trap}}
{{v50_creaturecurrent table row|name=Mackerel|symbol=α|color=7:0:0|food=Yes|playable=No|hostile=N/A|size=200|value=0|biome=Arctic and temperate oceans|note=No trap}}
{{v50_creaturecurrent table row|name=Magpie|symbol=∙|color=0:0:1|food=No|playable=No|hostile=N/A|size=200|value=30|biome=Temperate grasslands, savannas and shrublands|note=}}
{{v50_creaturecurrent table row|name=Mantis|symbol=·|color=2:0:1|food=No|playable=No|hostile=N/A|size=1|value=0|biome=Not freezing|note=No trap}}
{{v50_creaturecurrent table row|name=Masked lovebird|symbol=∙|color=2:0:1|food=No|playable=No|hostile=N/A|size=90|value=30|biome=Any tropical forest|note=}}
{{v50_creaturecurrent table row|name=Moghopper|symbol=∙|color=6:0:0|food=No|playable=No|hostile=N/A|size=300|value=20|biome=Any pool|note=Savage, only usable creature for [[fish dissector]]s}}
{{v50_creaturecurrent table row|name=Monarch butterfly|symbol=∙|color=4:0:1|food=No|playable=No|hostile=N/A|size=1|value=0|biome=Not freezing|note=No trap}}
{{v50_creaturecurrent table row|name=Moon snail|symbol=∙|color=4:0:1|food=No|playable=No|hostile=N/A|size=200|value=10|biome=Temperate oceans|note=Hateable, no trap}}
{{v50_creaturecurrent table row|graphic=[[File:mosquito_sprite_anim.gif]]|name=Mosquito|symbol=·|color=0:0:1|food=No|playable=No|hostile=N/A|size=1|value=0|biome=Not freezing, any pool|note=Hateable, no trap}}
{{v50_creaturecurrent table row|name=Moth|symbol=∙|color=6:0:0|food=No|playable=No|hostile=N/A|size=1|value=0|biome=Not freezing|note=No trap}}
{{v50_creaturecurrent table row|name=Mussel|symbol=m|color=7:0:1|food=Yes|playable=No|hostile=N/A|size=200|value=10|biome=Any ocean, lake and river|note=Hateable, shell source}}
{{v50_creaturecurrent table row|name=Nautilus|symbol=♂|color=4:0:1|food=Yes|playable=No|hostile=N/A|size=500|value=10|biome=Any ocean|note=shell source}}
{{v50_creaturecurrent table row|name=Olm|symbol=∙|color=7:0:1|food=No|playable=No|hostile=N/A|size=200|value=10|biome=Subterranean water|note=}}
{{v50_creaturecurrent table row|name=Oriole|symbol=∙|color=6:0:1|food=No|playable=No|hostile=N/A|size=40|value=30|biome=Temperate broadleaf forests|note=}}
{{v50_creaturecurrent table row|name=Oyster|symbol=o|color=7:0:1|food=Yes|playable=No|hostile=N/A|size=200|value=10|biome=Any ocean|note=Hateable, shell source}}
{{v50_creaturecurrent table row|name=Parakeet|symbol=∙|color=2:0:1|food=No|playable=No|hostile=N/A|size=120|value=30|biome=Tropical grasslands, savannas, shrublands and forests|note=}}
{{v50_creaturecurrent table row|name=Peach-faced lovebird|symbol=∙|color=2:0:1|food=No|playable=No|hostile=N/A|size=60|value=30|biome=Temperate grasslands, savannas, shrublands and broadleaf forests|note=}}
{{v50_creaturecurrent table row|name=Perch|symbol=α|color=7:0:1|food=Yes|playable=No|hostile=N/A|size=200|value=0|biome=Temperate freshwater rivers and lakes|note=No trap}}
{{v50_creaturecurrent table row|name=Phantom spider|symbol=∙|color=7:0:1|food=No|playable=No|hostile=N/A|size=500|value=0|biome=Temperate and tropical forests|note=Evil, produces web}}
{{v50_creaturecurrent table row|graphic=[[File:pixie_sprite_anim.gif]]|name=Pixie|symbol=·|color=3:0:1|food=No|playable=No|hostile=N/A|size=1|value=10|biome=All except pools, rivers, and underground|note=No trap, good, [[fanciful]]}}
{{v50_creaturecurrent table row|name=Pond turtle|symbol=☼|color=2:0:0|food=Yes|playable=No|hostile=N/A|size=500|value=10|biome=Any pool|note=shell source}}
{{v50_creaturecurrent table row|name=Purring maggot|symbol={|color=7:0:1|food=No|playable=No|hostile=N/A|size=1000|value=10|biome=Underground chasm|note=Hateable, produces [[milk]]}}
{{v50_creaturecurrent table row|name=Rainbow trout|symbol=α|color=2:0:1|food=Yes|playable=No|hostile=N/A|size=200|value=0|biome=Temperate freshwater rivers and lakes|note=No trap}}
{{v50_creaturecurrent table row|name=Rat|symbol=∙|color=0:0:1|food=No|playable=No|hostile=N/A|size=300|value=10|biome=Not freezing|note=Hateable, eater 2}}
{{v50_creaturecurrent table row|name=Red squirrel|symbol=∙|color=6:0:0|food=No|playable=No|hostile=N/A|size=300|value=10|biome=Any temperate forest|note=}}
{{v50_creaturecurrent table row|graphic=[[File:red-winged_blackbird_sprite.png]]|name=Red-winged blackbird|symbol=∙|color=0:0:1|food=No|playable=No|hostile=N/A|size=50|value=30|biome=Temperate salwater and freshwater marshes|note=}}
{{v50_creaturecurrent table row|name=Sailfin molly|symbol=α|color=2:0:0|food=Yes|playable=No|hostile=N/A|size=200|value=0|biome=Temperate brackish, saltwater and freshwater lakes, rivers and pools|note=No trap}}
{{v50_creaturecurrent table row|name=Salmon|symbol=α|color=4:0:1|food=Yes|playable=No|hostile=N/A|size=200|value=0|biome=Temperate brackish, saltwater and freshwater lakes, temperate oceans|note=No trap}}
{{v50_creaturecurrent table row|name=Sea nettle jellyfish|symbol=Ω|color=6:0:0|food=Yes|playable=No|hostile=N/A|size=200|value=10|biome=Temperate oceans|note=No trap}}
{{v50_creaturecurrent table row|name=Seahorse|symbol=α|color=2:0:0|food=Yes|playable=No|hostile=N/A|size=200|value=0|biome=Temperate and tropical oceans|note=No trap}}
{{v50_creaturecurrent table row|name=Shad|symbol=α|color=3:0:1|food=Yes|playable=No|hostile=N/A|size=200|value=0|biome=Temperate brackish, saltwater and freshwater lakes, temperate and arctic oceans|note=No trap}}
{{v50_creaturecurrent table row|name=Skink|symbol=∙|color=7:0:0|food=No|playable=No|hostile=N/A|size=500|value=10|biome=Any desert, temperate and tropical|note=}}
{{v50_creaturecurrent table row|name=Slug|symbol=~|color=6:0:0|food=No|playable=No|hostile=N/A|size=1|value=10|biome=Not freezing|note=Hateable, no trap, no capture}}
{{v50_creaturecurrent table row|name=Snail|symbol=∙|color=7:0:0|food=No|playable=No|hostile=N/A|size=1|value=10|biome=Not freezing|note=Hateable, no trap, no capture}}
{{v50_creaturecurrent table row|name=Sole|symbol=α|color=6:0:0|food=Yes|playable=No|hostile=N/A|size=200|value=0|biome=Temperate and arctic oceans|note=No trap}}
{{v50_creaturecurrent table row|name=Sparrow|symbol=∙|color=6:0:0|food=No|playable=No|hostile=N/A|size=30|value=30|biome=Any grassland, savanna, shrubland, temperate and tropical forest, desert and wetland|note=}}
{{v50_creaturecurrent table row|name=Spotted ratfish|symbol=α|color=6:0:0|food=Yes|playable=No|hostile=N/A|size=200|value=0|biome=Temperate oceans|note=No trap}}
{{v50_creaturecurrent table row|name=Squid|symbol=♂|color=7:0:1|food=Yes|playable=No|hostile=N/A|size=200|value=10|biome=Any ocean|note=}}
{{v50_creaturecurrent table row|name=Steelhead trout|symbol=α|color=3:0:1|food=Yes|playable=No|hostile=N/A|size=200|value=0|biome=Temperate brackish, saltwater and freshwater lakes, temperate and arctic oceans|note=No trap}}
{{v50_creaturecurrent table row|name=Termite|symbol=·|color=7:0:1|food=No|playable=No|hostile=N/A|size=1|value=0|biome=Not freezing|note=No trap}}
{{v50_creaturecurrent table row|name=Thornback ray|symbol=ò|color=6:0:0|food=Yes|playable=No|hostile=N/A|size=200|value=0|biome=Temperate and tropical oceans|note=No trap}}
{{v50_creaturecurrent table row|name=Thrips|symbol=·|color=7:0:1|food=No|playable=No|hostile=N/A|size=1|value=0|biome=Not freezing|note=No trap, no capture}}
{{v50_creaturecurrent table row|name=Tick|symbol=·|color=0:0:1|food=No|playable=No|hostile=N/A|size=1|value=0|biome=Not freezing|note=No trap, no capture}}
{{v50_creaturecurrent table row|name=Toad|symbol=∙|color=2:0:0|food=No|playable=No|hostile=N/A|size=200|value=10|biome=Any pool|note=Hateable}}
{{v50_creaturecurrent table row|name=Two-legged rhino lizard|symbol=∙|color=7:0:0|food=No|playable=No|hostile=N/A|size=1000|value=20|biome=Any land|note=Savage, eater 2}}
{{v50_creaturecurrent table row|name=White-spotted puffer|symbol=α|color=7:0:0|food=Yes|playable=No|hostile=N/A|size=200|value=0|biome=Tropical oceans|note=No trap}}
{{v50_creaturecurrent table row|name=Worm|symbol=~|color=7:0:0|food=No|playable=No|hostile=N/A|size=100|value=10|biome=Any temperate, any tropical, taiga|note=Hateable, no trap, no capture}}
{{v50_creaturecurrent table row|name=Wren|symbol=∙|color=6:0:0|food=No|playable=No|hostile=N/A|size=40|value=30|biome=Any grassland, savanna, shrubland, forest, desert and wetland|note=}}
{{v50_creaturecurrent table row|name=Yellow bullhead|symbol=α|color=6:0:0|food=Yes|playable=No|hostile=N/A|size=200|value=0|biome=Temperate brackish and freshwater lakes|note=No trap}}
|}

'''Note:''' All vermin with 0 value in the above table don't have the [PET_VALUE:#] tag.

{{Translation
| dwarven = bomik
| elvish = nirica
| goblin = otod
| human = strilu
}}

{{Vermin}}
{{Category|Vermin|0}}

[[ru:DF2012:Vermin]]

Creature token

2025-06-24T00:05:14Z

DikbutDaGrate: Added information on evil creatures effect on entity mechanics

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

The <code>[OBJECT:CREATURE]</code> [[token]] begins the definition of a ''Dwarf Fortress'' [[creature]] [[raw file]]. Each creature definition that follows begins with the {{token|creature|c|creature ID}} token, and the creature's exact properties and behavior are then specified by the use of further creature tokens. All known creature tokens are listed below.

Vanilla creature definitions can be found in <code>[[Game folder|<Dwarf Fortress>]]\data\vanilla\vanilla_creatures\</code>.
Creature ID is also used with [[graphics token]]s to make customizable [[graphics set]]s.

The [[caste]] tokens allow defining sub-species within the broader creature definition, including true biological castes and lesser variations, such as sexes. Creature tokens can either be 'Creature' or 'CASTE-only' type which can only be applied to creature or caste respectively, or 'CASTE' which can be applied to both. In the table bellow, creature type distinguishes tokens that can be applied to creature only, caste only, and both ('creature', 'CASTE-only', and 'CASTE' respectively)

__NOTOC__
{{clear}}
{{alphabetical TOC|style=margin: 1em auto;}}

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

|-
| {{text anchor|ADOPTS_OWNER}}
| Caste
|
| Prevents the tamed creature from being made available for adoption, instead allowing it to automatically adopt whoever it wants. The basic requirements for adoption are intact, and the creature will only adopt individuals who have a [[preference]] for their species. Used by [[cat]]s in the vanilla game. When {{k|v}}iewing a tame creature with this token, the message "This animal isn't interested in your wishes" will appear instead of "This [adorable] animal can't work" or "This animal is waiting to be trained".

|-
| {{text anchor|ALCOHOL_DEPENDENT}}
| Caste
|
| Makes the creature need [[alcohol]] to get through the working day; it will choose to drink booze instead of [[water]] if possible. Going sober for too long reduces speed.

|-
| {{text anchor|ALL_ACTIVE}}
| Caste
|
| When set, the creature will appear at any time of day. Overrides {{token|DIURNAL|c}}, {{token|NOCTURNAL|c}}, {{token|CREPUSCULAR|c}}, {{token|MATUTINAL|c}}, and {{token|VESPERTINE|c}}.

|-
| {{text anchor|ALTTILE}}
| Creature
|
*'character' or tile number
| If set, the creature will blink between its {{token|TILE|c}} and its ALTTILE.

|-
| {{text anchor|AMBUSHPREDATOR}}
| Caste
|
| Makes the creature start out hidden and remain near its original location until its prey draws near. When combined with {{token|WEBBER|c}}, causes them to lay gigantic webs near their spawn location, though only for creatures present during embark.

|-
| {{text anchor|AMPHIBIOUS}}
| Caste
|
| Allows a creature to breathe both in and out of [[water]] (unlike {{token|AQUATIC|c}}) - does not prevent drowning in [[magma]].

|-
| {{text anchor|APP_MOD_DESC_RANGE}}
| Appearance Modifier
|
*Range (6 values, low to high)
| Based on info from [http://www.bay12forums.com/smf/index.php?topic=113762.msg3473069#msg3473069 Wannabehero on the forums]: When used with an appearance modifier token (BP_APPEARANCE_MODIFIER or BODY_APPEARANCE_MODIFIER), tells the game what numeric ranges to map to which descriptors.

The game uses 7 descriptor levels for each modifier, with the center one generally being to omit the thing from the creature description entirely. The six values in APP_MOD_DESC_RANGE define the boundaries between each described range. If this is not specified it uses the numbers 10:50:95:105:150:190.

|-
| {{text anchor|APP_MOD_GENETIC_MODEL}}
| Appearance Modifier
|
*Model (Accepts DOMINANT_MORE, DOMINANT_LESS, and MIX)
| Defines a genetic model for the relevant appearance modifier(s). May or may not do anything significant at present.

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

|-
| {{text anchor|APP_MOD_NOUN}}
| Appearance Modifier
|
*noun
*SINGULAR or PLURAL
| Creates a noun for the appearance, and whether it is singular or plural.

|-
| {{text anchor|APP_MOD_RATE}}
| Appearance Modifier
|
*Rate (integer)
*Scale (DAILY, YEARLY)
*min (growth)
*max (growth)
*start year
*start day
*end year
*end day
| Setting the growth rate of the modifier. The last two tokens can be replaced by NO_END to have growth continue indefinitely.

|-
| {{text anchor|APPLY_CREATURE_VARIATION}}
| Caste
|
*creature variation ID
*(optional) any amount of arbitrary arguments
| Applies the specified [[creature variation token|creature variation]]. See [[Creature_variation_token#Arguments_and_conditional_tokens]] for how the subsequent arguments may be used.

|-
| {{text anchor|APPLY_CURRENT_CREATURE_VARIATION}}
| Special
|
| Applies the effects of all pending {{token|CV_ADD_TAG|c}} and {{token|CV_REMOVE_TAG|c}} tokens that have been defined in the current creature.

|-
| {{text anchor|AQUATIC}}
| Caste
|
| Enables the creature to breathe in water, but causes it to air-drown on dry land.

|-
| {{text anchor|ARENA_RESTRICTED}}
| Caste
|
| Causes the creature to be excluded from the [[object testing arena]]'s creature spawning list. Typically applied to spoileriffic creatures.

|-
| {{text anchor|ARTIFICIAL_HIVEABLE}}
| Creature
|
| Enables the creature to be kept in artificial [[hive]]s by [[beekeeper]]s.

|-
| {{text anchor|AT_PEACE_WITH_WILDLIFE}}
| Caste
|
| Prevents the creature from attacking or frightening creatures with the {{Token|NATURAL|c}} tag.

|-
| {{text anchor|ATTACK}}
| Caste
|
*token
*selection criteria (it's complicated)
| Defines the attack name, and the body part used. See [[#Attack Tokens|below]] for valid subtokens
'''Example:''' 
<code>[ATTACK:GORE:BODYPART:BY_CATEGORY:HORN]</code> 
''GORE'' = name of the attack 
''BODYPART:BY_CATEGORY:HORN'' = the horn is used to attack (presuming the creature has one)

|-
| {{text anchor|ATTACK_TRIGGER}}
| Caste
|
*population
*exported wealth
*created wealth
| Specifies when a [[megabeast]] or [[semi-megabeast]] will attack the fortress. The attacks will start occurring when all of the requirements are met. Setting a value to 0 disables the trigger.

|}

{{alphabetical TOC|style=margin: 1em auto;}}

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

|-
| {{text anchor|BABY}}
| Caste
|
*integer
| Age at which creature is considered a child, the default is zero. One can think of this as the duration of the baby stage.

|-
| {{text anchor|BABYNAME}}
| Caste
|
*singular
*plural
| Defines a new name for a creature in baby state at the caste level. For non-caste-specific baby names, see {{token|GENERAL_BABY_NAME|c}}.

|-
| {{text anchor|BEACH_FREQUENCY}}
| Caste
|
*integer
| Creature may be subject to [[beaching]], becoming stranded on [[Beach|shores]], where they will eventually air-drown. The number indicates the frequency of the occurrence. Presumably requires the creature to be {{token|AQUATIC|c}}. Used by [[orca]]s, [[sperm whale]]s and [[sea nettle jellyfish]] in the vanilla game.

|-
| {{text anchor|BENIGN}}
| Caste
|
| The creature is non-aggressive by default, and will never automatically be engaged by companions or soldiers, running away from any creatures that are not friendly to it, and will only defend itself if it becomes enraged. Can be thought of as the counterpoint of the {{token|LARGE_PREDATOR|c}} tag. When tamed, animals with this tag will be useless for fortress defense.

This and {{token|TRADE_CAPACITY|c}} are required for {{token|PACK_ANIMAL|c}} to function properly, if an animal contains the aforementioned requirements without this tag: items loaded by the merchants will be dropped upon departure.

|-
| {{text anchor|BIOME}}
| Creature
|
* [[biome token]]
| Select a [[biome]] the creature may appear in.

|-
| {{text anchor|BLOOD}}
| Caste
|
* <[[material token]]>
* <[[Material_definition_token#Material_States|material state]]>
| Specifies what the creature's blood is made of.

|-
| {{text anchor|BLOODSUCKER}}
| Caste
|
| Causes [[vampire]]-like behaviour; the creature will suck the [[Creature_token#BLOOD|blood]] of unconscious victims when its [[Syndrome#TIME_SINCE_SUCKED_BLOOD|thirst for blood]] grows sufficiently large. When controlling the creature in adventure mode, this can be done at will. Seems to be required to make the creature denouncable (in-world) as a creature of the night.

|-
| {{text anchor|BODY}}
| Caste
|
*body parts
| Draws body parts from OBJECT:BODY files (such as body_default.txt)
'''Example:''' 
[BODY:BODY_WITH_HEAD_FLAG:HEART:GUTS:BRAIN:MOUTH] 
This is the body from a [[purring maggot]]. It creates a body with head, a heart, some guts, a brain, and a mouth. That's all a maggot needs.

The body parts need to be listed in an order such that any parent part appears before its connected children. For example [BODY:HEART:BODY_WITH_HEAD_FLAG] produces a "Body Token Recognized But Could Not Connect: HEART" error because HEART can't find any UPPERBODY(s) to connect to. Switching the order to [BODY:BODY_WITH_HEAD_FLAG:HEART] fixes the problem because now the UPPERBODY is created before the HEART tries to connect to it.

'''If the body is left undefined, the creature (or caste) will be tagged as [DOES_NOT_EXIST].''' {{verify}}

|-
| {{text anchor|BODY_APPEARANCE_MODIFIER}}
| Caste
|
*ATTRIBUTE
*lowest
*lower
*low
*median
*high
*higher
*highest
| These body modifiers give individual creatures different characteristics. In the case of HEIGHT, BROADNESS and LENGTH, the modifier is also a percentage change to the BODY_SIZE of the individual creature. The seven numbers afterward give a distribution of ranges. Each interval has an equal chance of occurring.
'''Example:''' 
[BODY_APPEARANCE_MODIFIER:HEIGHT:90:95:98:100:102:105:110] 
''HEIGHT'' : marks the height to be changed 
''90:95:98:100:102:105:110'' : sets the range from the shortest (90% of the average height) to the tallest (110% of the average height) creature variation.

|-
| {{text anchor|BODY_DETAIL_PLAN}}
| Caste
|
*PlanName
*Arguments
| Loads a plan from 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:''' 
[BODY_DETAIL_PLAN:VERTEBRATE_TISSUE_LAYERS:SKIN:FAT:MUSCLE:BONE:CARTILAGE] 
This creates the detailed body of a [[fox]], the skin, fat, muscle, bones and cartilage out of the vertebrate tissues. 
A [[Purring maggot|maggot]] would only need: 
''[BODY_DETAIL_PLAN:EXOSKELETON_TISSUE_LAYERS:SKIN:FAT:MUSCLE]''

|-
| {{text anchor|BODY_SIZE}}
| Caste
|
*years
*days
*size
| Sets size at a given age. Size is in cubic centimeters, and for normal body materials, is roughly equal to the creature's average weight in grams.
'''Example:''' 
[BODY_SIZE:0:0:10000] 
[BODY_SIZE:1:168:50000] 
[BODY_SIZE:12:0:220000] 
This describes the size of a [[minotaur]]. Its birth size would be 10,000 cm3 (~10 kg). At 1 year and 168 days old it would be 50,000 cm3 (~50 kg). And as an adult (at 12 years old) it would be 220,000 cm3 and weigh roughly 220 kg.

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

|-
| {{text anchor|BONECARN}}
| Caste
|
| Creature eats bones. Implies {{token|CARNIVORE|c}}. [[Adventurer mode|Adventurers]] with this token are currently unable to eat bones.{{Bug|11069}}

|-
| {{text anchor|BP_ADD_TYPE}}
| Caste
|
| Adds a type to a body part - used with {{token|SET_BP_GROUP|c}}. In vanilla DF, this is used for adding the type '[[Body token#GELDABLE|GELDABLE]]' to the lower body of certain [[cat|creatures]].

|-
| {{text anchor|BP_APPEARANCE_MODIFIER}}
| Caste
|
*QUALITY
*lowest
*lower
*low
*median
*high
*higher
*highest
| Sets up the breadth of possibilities for appearance qualities for a selected BP group. EG. Eyes (CLOSE_SET, DEEP_SET, ROUND_VS_NARROW, LARGE_IRIS),Lips (THICKNESS), Nose (BROADNESS, LENGTH, UPTURNED, CONVEX), Ear (SPLAYED_OUT, HANGING_LOBES, BROADNESS, HEIGHT), Tooth (GAPS), Skull (HIGH_CHEEKBONES, BROAD_CHIN, JUTTING CHIN, SQUARE_CHIN), Neck (DEEP_VOICE, RASPY_VOICE), Head (BROADNESS, HEIGHT)

|-
| {{text anchor|BP_REMOVE_TYPE}}
| Caste
|
| Removes a type from a body part. Used with {{token|SET_BP_GROUP|c}}.

|-
| {{text anchor|BUILDINGDESTROYER}}
| Caste
|
*1 or 2
| Allows a creature to destroy furniture and buildings. Value [1] targets mostly doors, hatches, furniture and the like. Value [2] targets anything not made with the {{k|b}} + {{k|C}} commands.
|}

{{alphabetical TOC|style=margin: 1em auto;}}

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

|-
| {{text anchor|CAN_DO_INTERACTION}}
| Caste
|
*interaction token
| The creature can perform an interaction. See [[interaction token]].

|-
| {{text anchor|CAN_LEARN}}
| Caste
|
| The creature gains [[skill]]s and can have [[labor|professions]]. If a member of a civilization (even a pet) has this token, it'll need to eat, drink and sleep. Note that this token makes the creature unable to be eaten 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. A creature with at least this token or the {{token|CAN_SPEAK|c}} token will be able to have [[Personality value|values]] and [[Personality goal|goals]].

|-
| {{text anchor|CAN_SPEAK}}
| Caste
|
| Can [[talking|talk]]. Note that this is not necessary for a creature to gain social skills but to make friends in fortress mode. A creature with at least this token or the {{token|CAN_LEARN|c}} token will be able to have [[Personality value|values]] and [[Personality goal|goals]].

|-
| {{text anchor|CANNOT_CLIMB}}
| Caste
|
| Creature cannot [[climber|climb]], even if it has free grasp parts.

|-
| {{text anchor|CANNOT_JUMP}}
| Caste
|
| Creature cannot [[jump]].

|-
| {{text anchor|CANNOT_UNDEAD}}
| Caste
|
| Acts like {{token|NOT_LIVING|c}}, except that {{token|OPPOSED_TO_LIFE|c}} creatures will attack them.

|-
| {{text anchor|CANOPENDOORS}}
| Caste
|
| Defunct, as doors cannot be set as tightly closed anymore.

|-
| {{text anchor|CARNIVORE}}
| Caste
|
| Creature ''only'' eats [[meat]]. If the creature goes on rampages in worldgen, it will often devour the people/animals it kills.

|-
| {{text anchor|CASTE}}
| Creature
|
*name
| Defines a [[caste]].

|-
| {{text anchor|CASTE_ALTTILE}}
| Caste
|
*tile number or "letter"
| Caste-specific {{token|ALTTILE|c}}. Requires {{token|CASTE_TILE|c}}.

|-
| {{text anchor|CASTE_COLOR}}
| Caste
|
*fg
*bg
*brightness
| Caste-specific {{token|COLOR|c}}.

|-
| {{text anchor|CASTE_GLOWCOLOR}}
| Caste
|
*fg
*bg
*brightness
| Caste-specific {{token|GLOWCOLOR|c}}.

|-
| {{text anchor|CASTE_GLOWTILE}}
| Caste
|
*tile value or "letter"
| Caste-specific {{token|GLOWTILE|c}}.

|-
| {{text anchor|CASTE_NAME}}
| Caste
|
*singular
*plural
*adjective
| While {{token|NAME|c}} describes the name of the species, {{token|CASTE_NAME|c}} names individuals of the species. Unlike other caste-specific descriptions, this token is required, even for creatures without separate castes. If left undefined, the creature will not show up in the [[arena]] and members of the species will be labeled as "nothing".

|-
| {{text anchor|CASTE_PROFESSION_NAME}}
| Caste
|
*[[Unit type token]] (Profession)
*singular
*plural
| Caste-specific {{token|PROFESSION_NAME|c}}.

|-
| {{text anchor|CASTE_SOLDIER_ALTTILE}}
| Caste
|
*'character' or tile number
| Caste-specific {{token|SOLDIER_ALTTILE|c}}. Requires {{token|CASTE_SOLDIER_TILE|c}}.

|-
| {{text anchor|CASTE_SOLDIER_TILE}}
| Caste
|
*'character' or tile number
| Caste-specific {{token|CREATURE_SOLDIER_TILE|c}}.

|-
| {{text anchor|CASTE_TILE}}
| Caste
|
* tile number or "letter"
| Caste-specific {{token|CREATURE_TILE|c}}.

|-
| {{text anchor|CAVE_ADAPT}}
| Caste
|
| Causes the creature to develop [[cave adaptation]].

Allows for creature's race to be involved in jokes that end in "And the [race] saw the sun and vomited on the spot!"

|-
| {{text anchor|CDI}}
| Caste
|
*Varies
| Specifies interaction details following a {{token|CAN_DO_INTERACTION|c}} token. See [[interaction token]].

|-
| {{text anchor|CHANGE_BODY_SIZE_PERC}}
| Caste
|
*integer
| Multiplies body size by a factor of (integer)%. 50 halves size, 200 doubles.

|-
| {{text anchor|CHANGE_FREQUENCY_PERC}}
| Creature
|
*integer
| Multiplies frequency by a factor of (integer)%.

|-
| {{text anchor|CHILD}}
| Caste
|
*integer
| Age at which creature is considered an adult - one can think of this as the duration of the [[children|child]] stage. Allows the creature's offspring to be rendered fully tame if [[animal trainer|trained]] during their childhood.

|-
| {{text anchor|CHILDNAME}}
| Caste
|
*singular
*plural
| Defines a new name for a creature in the child state at the caste level. For non-caste-specific child names, see {{token|GENERAL_CHILD_NAME|c}}.

|-
| {{text anchor|CLUSTER_NUMBER}}
| Creature
|
*min
*max
| The minimum/maximum numbers of how many creatures per spawned cluster. Vermin fish with this token in combination with temperate ocean and river biome tokens [http://www.bay12forums.com/smf/index.php?topic=51864.msg1122319#msg1122319 will perform seasonal migrations]. Defaults to 1:1 if not specified.

|-
| {{text anchor|CLUTCH_SIZE}}
| Caste
|
*min
*max
|Number of [[egg]]s laid in one sitting.

|-
| {{text anchor|COLONY_EXTERNAL}}
| Caste
|
| Caste hovers around colony.

|-
| {{text anchor|COLOR}}
| Creature
|
*foreground
*background
*brightness
| Color of the creature's tile. (See [[Color]] for usage.)

|-
| {{text anchor|COMMON_DOMESTIC}}
| Caste
|
| When combined with any of {{token|PET|c}}, {{token|PACK_ANIMAL|c}}, {{token|WAGON_PULLER|c}} and/or {{token|MOUNT|c}}, the creature is guaranteed to be domesticated by any [[civilization]] with {{token|COMMON_DOMESTIC_PET|e}}, {{token|COMMON_DOMESTIC_PACK|e}}, {{token|COMMON_DOMESTIC_PULL|e}} and/or {{token|COMMON_DOMESTIC_MOUNT|e}} respectively. Such civilizations will always have access to the creature, even in the absence of wild populations. This token is invalid on {{token|FANCIFUL|c}} creatures.

|-
| {{text anchor|CONVERTED_SPOUSE}}
| Caste
|
| Creatures of this caste's species with the {{token|SPOUSE_CONVERTER|c}} and {{token|NIGHT_CREATURE_HUNTER|c}} tokens will kidnap {{token|SPOUSE_CONVERSION_TARGET|c}}s of an appropriate sex and convert them into castes with CONVERTED_SPOUSE.

|-
| {{text anchor|COOKABLE_LIVE}}
| Caste
|
| Set this to allow the creature to be cooked in meals while it is still alive, as well as when it's dead but not yet [[fishery|cleaned]]. Used by some water-dwelling vermin such as [[mussel]]s, [[nautilus]]es and [[oyster]]s. Currently does not work correctly when applied to non-{{token|FISHITEM|c}} vermin.{{bug|13200}}

|-
| {{text anchor|CRAZED}}
| Caste
|
| Creature is '[[insanity|berserk]]' and will attack all other creatures, except members of its own species that '''also''' have the CRAZED tag. It will show {{DFtext|Berserk|4:1}} in the [[unit list]]. Berserk creatures go on rampages during [[world generation|worldgen]] much more frequently than non-berserk ones.

|-
| {{text anchor|COPY_TAGS_FROM}}
| Special
|
*creature ID
| Copies another specified creature. This will override any definitions made before it; essentially, it makes this creature identical to the other one, which can then be modified. Often used in combination with {{token|APPLY_CREATURE_VARIATION|c}} to import standard variations from a file. The vanilla [[giant animal]]s and [[animal person|animal people]]s are examples of this token combination.

|-
| {{text anchor|CREATURE}}
| Creature
|
*creature ID
| A unique, arbitrary identifier that begins the definition of each new creature, and is used to reference the creature in other tokens and raws.

|-
| {{text anchor|CREATURE_CLASS}}
| Caste
|
*classname
| An arbitrary creature classification. Can be set to anything, but the only vanilla uses are GENERAL_POISON (used in syndromes), EDIBLE_GROUND_BUG (used as targets for {{token|GOBBLE_VERMIN_CLASS|c}}), MAMMAL, and POISONOUS (both used for kobold pet eligibility). A single creature can have multiple classes.

The full list of tokens that use creature classes is:

* Creature tokens: {{token|GOBBLE_VERMIN_CLASS|c}}, {{token|GOBBLE_VERMIN_CLASS|c}}
* Interaction tokens: {{token|IT_AFFECTED_CLASS|in}}, {{token|IT_IMMUNE_CLASS|in}}
* Animal definition (Entity) tokens: {{token|ANIMAL_CLASS|e}}, {{token|ANIMAL_FORBIDDEN_CLASS|e}}
* Position (Entity) token: {{token|ALLOWED_CLASS|po}}
* Syndrome tokens: {{token|SYN_AFFECTED_CLASS|sy}}, {{token|SYN_IMMUNE_CLASS|sy}}, {{token|CE_SENSE_CREATURE_CLASS|sy}}
|-
| {{text anchor|CREATURE_SOLDIER_TILE}}
| Creature
|
*'character' or tile number
| Creatures active in their civilization's [[military]] will use this tile instead.

|-
| {{text anchor|CREATURE_TILE}}
| Creature
|
*'character' or tile number
| The symbol of the creature in ASCII mode.

|-
| {{text anchor|CREPUSCULAR}}
| Caste
|
| When set, the creature will appear at dawn (between 4:30 AM and 6:00 AM) and in the evening (between 8:00 PM and 10:05 PM) in [[Adventurer mode]].

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

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

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

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

|-
| {{text anchor|CV_REMOVE_TAG}}
| Special
|
*TAG NAME
| Removes a tag. Used in conjunction with creature variation templates.
|}

{{alphabetical TOC|style=margin: 1em auto;}}

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

|-
| {{text anchor|DEMON}}
| Caste
|
| Found on generated [[demon]]s.

At least 1 demon generated, or custom must have the {{token|FLIER|c}} token in order for the [[Underworld|horrifying screams]] event to trigger.

|-
| {{text anchor|DESCRIPTION}}
| Caste
|
*text
| A brief description of the creature type, as displayed when viewing the creature's description/[[Thoughts and preferences|thoughts & preferences]] screen.

|-
| {{text anchor|DIE_WHEN_VERMIN_BITE}}
| Caste
|
| Causes the creature to die upon attacking. Used by [[honey bee]]s to simulate them dying after using their stingers.

|-
| {{text anchor|DIFFICULTY}}
| Caste
|
*integer
| Increases experience gain during adventure mode. Creatures with a difficulty of 11 or higher are not assigned for quests in adventure mode.

|-
| {{text anchor|DIURNAL}}
| Caste
|
| When set, the creature will only appear during the day (between 6:00 AM and 8:00 PM) in [[Adventurer mode]].

|-
| {{text anchor|DIVE_HUNTS_VERMIN}}
| Caste
|
| The creature hunts vermin by diving from the air. On tame creatures, it has the same effect as {{token|HUNTS_VERMIN|c}}. Found on [[peregrine falcon]]s.

|-
| {{text anchor|DOES_NOT_EXIST}}
| Creature
|
| Adding this token to a creature prevents it from appearing in generated worlds (unless it's marked as [[Entity_token#ANIMAL_ALWAYS_PRESENT|always present]] for a particular civilisation). For example, adding it to [[dog]]s will lead to worlds being generated without dogs in them. Also removes the creature from the [[object testing arena]]'s spawn list. If combined with {{token|FANCIFUL|c}}, artistic depictions of the creature will occur regardless. Used by [[centaur]]s, [[chimera]]s and [[griffon]]s in the vanilla game.

Note: a creature tagged as DOES_NOT_EXIST can still be [[Interaction_token#I_EFFECT|summoned]] successfully, as long as it has a body defined in its raws [http://www.bay12forums.com/smf/index.php?topic=165213.msg8086938#msg8086938], or, another creature can[[Syndrome#CE_BODY_TRANSFORMATION|transform]] into it.
|}

{{alphabetical TOC|style=margin: 1em auto;}}

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

|-
| {{text anchor|EBO_ITEM}}
| Caste
|
*[[item token]]
*[[material token]] (ANY_HARD_STONE can be used for the material)
| Defines the item that the creature drops upon being [[butcher|butchered]]. Used with {{token|EXTRA_BUTCHER_OBJECT|c}}.

|-
| {{text anchor|EBO_SHAPE}}
| Caste
|
*gem shape
| The shape of the creature's extra [[butcher|butchering]] drop. Used with {{token|EXTRA_BUTCHER_OBJECT|c}}.

|-
| {{text anchor|EGG_MATERIAL}}
| Caste
|
* <[[material token]]>
* <[[Material_definition_token#Material_States|material state]]>
| Defines the material composition of [[egg]]s laid by the creature. [[creature_token#LAYS_EGGS|Egg-laying]] creatures in the default game define this 3 times, using LOCAL_CREATURE_MAT:EGGSHELL, LOCAL_CREATURE_MAT:EGG_WHITE, and then LOCAL_CREATURE_MAT:EGG_YOLK. Eggs will be made out of eggshell. Edibility is determined by tags on whites or yolk, but they otherwise do not exist.

|-
| {{text anchor|EGG_SIZE}}
| Caste
|
*size
| Determines the size of laid [[egg]]s. Doesn't affect hatching or cooking, but bigger eggs will be heavier, and may take longer to be hauled depending on the hauler's strength.

|-
| {{text anchor|EQUIPMENT_WAGON}}
| Creature
|
| Makes the creature appear as a large 3×3 [[wagon]] responsible for carrying trade goods, pulled by two {{token|WAGON_PULLER|c}} creatures and driven by a merchant.

|-
| {{text anchor|EQUIPS}}
| Caste
|
| Allows the creature to wear or wield items.

|-
| {{text anchor|EVIL}}
| Creature
|
| The creature is considered evil and will only show up in evil biomes. Civilizations with {{token|USE_EVIL_ANIMALS|e}} can domesticate them regardless of exotic status. Has no effect on cavern creatures except to restrict taming. A civilization with evil creatures can colonize evil areas.

Civilizations which list evil creatures as one of their main population options will potentially emerge following an underworld mining disaster, with the added caveat that a demon will be in charge of the civ. The rules which govern which noble position the demon in charge adopts however, are unclear. It either picks one of the predefined positions, or simply makes its own.

|-
| {{text anchor|EXTRA_BUTCHER_OBJECT}}
| Caste
|
* [[Body token#CATEGORY|BY_CATEGORY]] or [[Body token#CONTYPE|BY_TYPE]] or [[Body token#BP|BY_TOKEN]]
* TYPE, CATEGORY, or TOKEN
| The creature drops an additional object when [[butcher|butchered]], as defined by {{token|EBO_ITEM|c}} and {{token|EBO_SHAPE|c}}. Used for [[gizzard stone]]s in default creatures. For some materials, needs to be defined after caste definitions with SELECT_CASTE:ALL{{Bug|6355}}

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

|-
| {{text anchor|EXTRAVISION}}
| Caste
|
| The creature can see regardless of whether it has working eyes and has full 360 degree vision, making it impossible to strike the creature from a blind spot in combat. Invisible creatures will also be seen, namely [[intelligent undead]] using a "vanish" power.
|}

{{alphabetical TOC|style=margin: 1em auto;}}

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

|-
| {{text anchor|FANCIFUL}}
| Creature
|
| The creature is a thing of legend and known to all civilizations. Its materials cannot be requested or preferred. The tag also adds some art value modifiers. Used by a [[Fanciful|number of creatures]]. Conflicts with {{token|COMMON_DOMESTIC|c}}.

|-
| {{text anchor|FEATURE_ATTACK_GROUP}}
| Caste
|
| Found on [[Animal people#Subterranean animal people|subterranean animal-man]] tribals. Currently defunct. In previous versions{{verify}}, it caused these creatures to crawl out of chasms and underground rivers.

|-
| {{text anchor|FEATURE_BEAST}}
| Caste
|
| Found on [[forgotten beast]]s. Presumably makes it act as such, initiating underground attacks on fortresses, or leads to the pop-up message upon encountering one{{verify}}. Hides the creature from displaying in a world_sites_and_pops file. Does not create historical figures like generated forgotten beasts do.

Requires specifying a {{token|BIOME|c}} in which the creature will live, and both surface and subterranean biomes are allowed. Does not stack with {{token|LARGE_ROAMING|c}} and if both are used the creature will not spawn. Appears to be incompatible with {{token|DEMON|c}} even if used in separate castes.

|-
| {{text anchor|FEMALE}}
| Caste
|
| Makes the creature biologically female, enabling her to [[Breeding|bear young]]. Usually specified inside a caste.

|-
| {{text anchor|FIREIMMUNE}}
| Caste
|
| Makes the creature immune to [[Interaction_token#FIREBALL|FIREBALL]] and [[Interaction_token#FIREJET|FIREJET]] attacks, and allows it to path through high temperature zones, like lava or fires. Does not, by itself, make the creature immune to the damaging effects of burning in [[fire]], and does not prevent general heat damage or melting on its own (this would require adjustments to be made to the creature's body [[Material_definition_token|materials]] - see the [[Dragon/raw|dragon raws]] for an example).

|-
| {{text anchor|FIREIMMUNE_SUPER}}
| Caste
|
| Like {{token|FIREIMMUNE|c}}, but also renders the creature immune to [[Interaction_token#DRAGONFIRE|DRAGONFIRE]] attacks.

|-
| {{text anchor|FISHITEM}}
| Caste
|
| The creature's corpse is a single [[Item_token#FISH_RAW|FISH_RAW]] food item that needs to be cleaned (into a [[Item_token#FISH|FISH]] item) at a [[fishery]] to become edible. Before being cleaned the item is referred to as "raw". The food item is categorized under "fish" on the food and stocks screens, and when uncleaned it is sorted under "raw fish" in the stocks (but does not show up on the food screen).
Without this or {{token|COOKABLE_LIVE|c}}, [[fishing|fished]] vermin will turn into food the same way as non-vermin creatures, resulting in multiple units of food (meat, brain, lungs, eyes, spleen etc.) from a single fished vermin. These units of food are categorized as meat by the game.

|-
| {{text anchor|FIXED_TEMP}}
| Caste
|
*temperature
| The creature's body is constantly at this temperature, heating up or cooling the surrounding area. Alters the temperature of the creature's inventory and all adjacent tiles, [[Temperature|with all the effects that this implies]] - may trigger wildfires at high enough values. Also makes the creature immune to extreme heat or cold, as long as the temperature set is not harmful to the materials that the creature is made from. Corpses and body parts of creatures with a fixed temperature maintain their temperature even after death.

Note that temperatures of 12000 and higher may cause [[path|pathfinding]] issues in fortress mode.

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

|-
| {{text anchor|FLIER}}
| Caste
|
| Allows a creature to fly, independent of it having wings or not. Fortress Mode pathfinding only partially incorporates flying - flying creatures need a land path to exist between them and an area in order to access it, but as long as one such path exists, they do not need to use it, instead being able to fly over intervening obstacles. Winged creatures with this token can lose their ability to fly if their wings are crippled or severed. Winged creatures without this token will be unable to fly. (A 'wing' in this context refers to any body part with its own [[Body_token#FLIER|FLIER]] token).

At least 1 [[Demon]] must have the flier token in order for the [[Underworld|horrifying screams]] event to trigger.

|-
| {{text anchor|FREQUENCY}}
| Creature
|
*number, max 100
| Determines the chances of a creature appearing within its environment, with higher values resulting in more frequent appearance. Also affects the chance of a creature being brought in a caravan for trading.
This value is used multiply to determine the rarity of animal populations. A creature with [FREQUENCY:50] will appear in 50% of valid biomes, and be present in 50% of the area within those biomes.
When a [[Creature token#CLUSTER_NUMBER|cluster]] spawns, the game effectively considers all creatures that can possibly appear and uses the FREQUENCY value as a ''weight'' - for example, if there are three creatures with frequencies 10/25/50, the creature with [FREQUENCY:50] will appear approximately 58.8% of the time. Defaults to 50 if not specified. Not to be confused with {{token|POP_RATIO|c}}.
|}

{{alphabetical TOC|style=margin: 1em auto;}}

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

|-
| {{text anchor|GAIT}}
| Caste
|
* <gait type>
* <gait name>
* <max [[Gait#Speed|speed]]>
* <build up time>
* <max turning [[Gait#Speed|speed]]>
* <start [[Gait#Speed|speed]]>
* <energy expenditure>
* <gait flag(s)>
| Defines a gait by which the creature can move. See [[Gait]] for more information. Specifically, you likely want to use one of the existing STANDARD_X_GAITS creature variations, as described in [[Gait#Gaits_and_Modding|this subsection]].

* <max speed> indicates the maximum [[Gait#Speed|speed]] achievable by a creature using this gait
* <start speed> indicates the creature's speed when it starts moving using this gait
* <build up time> indicates how long it will take for a creature using this gait to go from <start speed> to <max speed>. For example, a value of 10 means that it should be able to reach the maximum speed by moving 10 [[tile]]s in a straight line over even terrain.
* <max turning speed> indicates the maximum speed permissible when the creature suddenly changes its direction of motion. The creature's speed will be reduced to <max turning speed> if travelling at a higher speed than this before turning.
* <energy expenditure> indicates how energy-consuming the gait is. Higher values cause the creature to tire out faster. Persistent usage of a high-intensity gait will eventually lead to exhaustion and [[Status_icon#Non-flashing|collapse]].

'''NO_BUILD_UP''' can be specified instead of a <start speed> value to make the <max speed> instantly achievable upon initiating movement (this is equivalent to a <build up time> of 0). Note that <build up time> and <max turning speed> are both ignored if specified alongside this (as NO_BUILD_UP trumps <build up time> and preserves <max speed> whilst turning, and <max turning speed> cannot exceed <max speed>) so it is permissible to omit them so long as they are '''both''' omitted together.

It's possible to specify a <start speed> greater than the <max speed>; the moving creature will decelerate towards its <max speed> in this case.

'''valid gait types:'''
*'''WALK''' 
Used for moving normally over ground tiles.

*'''CRAWL''' 
Used for moving over ground tiles whilst [[Status_icon#Non-flashing|prone]].

*'''SWIM''' 
Used for moving through tiles containing [[water]] or [[magma]] at a [[Water#Depth|depth]] of at least 4/7.

*'''FLY''' 
Used for moving through [[open space]].

*'''CLIMB''' 
Used for moving whilst [[Climber|climbing]].

'''valid gait flags:'''
* '''AGILITY''' 
Speeds/slows movement depending on the creature's [[Attribute#Agility|Agility]] stat.

* '''STRENGTH''' 
Speeds/slows movement depending on the creature's [[Attribute#Strength|Strength]] stat.

* '''LAYERS_SLOW''' 
Makes [[Tissue_definition_token#THICKENS_ON_ENERGY_STORAGE|THICKENS_ON_ENERGY_STORAGE]] and [[Tissue_definition_token#THICKENS_ON_STRENGTH|THICKENS_ON_STRENGTH]] tissue layers slow movement depending on how thick they are. Adding the STRENGTH gait flag counteracts the impact of the latter layer.

* '''STEALTH_SLOWS:'''<percentage> 
Slows movement by the specified percentage when the creature is [[Ambusher|sneaking]].

|-
| {{text anchor|GENERAL_BABY_NAME}}
| Creature
|
*singular
*plural
| Like {{token|BABYNAME|c}}, but applied regardless of caste.

|-
| {{text anchor|GENERAL_CHILD_NAME}}
| Creature
|
*singular
*plural
| Like {{token|CHILDNAME|c}}, but applied regardless of caste.

|-
| {{text anchor|GENERAL_MATERIAL_FORCE_MULTIPLIER}}
| Caste
|
*value A
*value B
| Has the same function as {{token|MATERIAL_FORCE_MULTIPLIER|c}}, but applies to all attacks instead of just those involving a specific material. Appears to be overridden by MATERIAL_FORCE_MULTIPLIER ([[werebeast]]s, for example, use both tokens to provide resistance to all materials, with one exception to which they are especially vulnerable).

|-
| {{text anchor|GENERATED}}
| Creature
|
| Found on procedurally generated creatures like [[forgotten beast]]s, [[titan]]s, [[demon]]s, [[angel]]s, and [[night creature]]s. Cannot be specified in user-defined raws.

|-
| {{text anchor|GETS_INFECTIONS_FROM_ROT}}
| Caste
|
| Makes the creature get [[Health_care#Infection|infections]] from necrotic tissue.

|-
| {{text anchor|GETS_WOUND_INFECTIONS}}
| Caste
|
| Makes the creature's wounds become [[Health_care#Infection|infected]] if left untreated for too long.

|-
| {{text anchor|GLOWCOLOR}}
| Creature
|
*foreground
*background
*brightness
| The colour of the creature's {{token|GLOWTILE|c}}.

|-
| {{text anchor|GLOWTILE}}
| Creature
|
*ascii character
| If present, the being glows in the dark (generally used for Adventurer 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 {{token|CASTE_GLOWTILE|c}} instead.

|-
| {{text anchor|GNAWER}}
| Caste
|
*verb
| The creature can and will gnaw its way out of [[animal trap]]s and [[cage]]s using the specified verb, depending on the material from which it is made (normally wood).

|-
| {{text anchor|GOBBLE_VERMIN_CLASS}}
| Caste
|
*class
| The creature eats vermin of the specified class.

|-
| {{text anchor|GOBBLE_VERMIN_CREATURE}}
| Caste
|
*creature
*caste
| The creature eats a specified [[vermin]].

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

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

|-
| {{text anchor|GO_TO_TAG}}
| Special
|
| When using tags from an existing creature, inserts new tags ''before'' the specified tag.

|-
| {{text anchor|GOOD}}
| Creature
|
| Creature is considered good and will only show up in good biomes - [[unicorn]]s, for example. Civilizations with {{token|USE_GOOD_ANIMALS|e}} can domesticate them regardless of exotic status. Has no effect on cavern creatures except to restrict taming. A civilization that has good creatures can colonise good areas in world-gen.

|-
| {{text anchor|GRASSTRAMPLE}}
| Caste
|
*value
| The value determines how rapidly [[grass]] is trampled when a creature steps on it - a value of 0 causes the creature to never damage grass, while a value of 100 causes grass to be trampled as rapidly as possible. Defaults to 5.

|-
| {{text anchor|GRAVITATE_BODY_SIZE}}
| Caste
|
*target value
| Used in Creature Variants. This token changes the adult body size to the average of the old adult body size and the target value and scales all intermediate growth stages by the same factor.

|-
| {{text anchor|GRAZER}}
| Caste
|
*number
| The creature is a grazer - if tamed in fortress mode, it needs a pasture to survive. The higher the number, the less frequently it needs to eat in order to live. Not used since 0.40.12, replaced by {{token|STANDARD_GRAZER|c}} to fix {{bugl|4113}}.
|}

{{alphabetical TOC|style=margin: 1em auto;}}

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

|-
| {{text anchor|HABIT}}
| Caste
|
*type
*probability
| Defines certain behaviors for the creature. The habit types are:
*COLLECT_TROPHIES
*COOK_PEOPLE
*COOK_VERMIN
*GRIND_VERMIN
*COOK_BLOOD
*GRIND_BONE_MEAL
*EAT_BONE_PORRIDGE
*USE_ANY_MELEE_WEAPON
*GIANT_NEST
*COLLECT_WEALTH.
These require the creature to have a {{token|LAIR|c}} to work properly, and also don't seem to work on creatures who are not a {{token|SEMIMEGABEAST|c}}, {{token|MEGABEAST|c}}, or{{token|NIGHT_CREATURE_HUNTER|c}}.

|-
| {{text anchor|HABIT_NUM}}
| Caste
|
*number or TEST_ALL
| "If you set HABIT_NUM to a number, it should give you that exact number of habits according to the weights.".{{cite forum|60554/1719248}} All lists of HABITs are preceded by [HABIT_NUM:TEST_ALL]

|-
| {{text anchor|HAS_NERVES}}
| Caste
|
| The creature has nerves in its muscles. Cutting the muscle tissue can sever motor and sensory nerves.

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

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

|-
| {{text anchor|HOMEOTHERM}}
| Caste
|
*number or NONE
| Default 'NONE'. The creature's normal body [[temperature]]. Creature ceases maintaining temperature on death unlike fixed material temperatures. Provides minor protection from environmental temperature to the creature.

|-
| {{text anchor|HUNTS_VERMIN}}
| Caste
|
| Creature hunts and kills nearby [[vermin]], randomly walking between places with food laying on the ground or in stockpiles, to check for possible [VERMIN_EATER] vermin, but they'll kill any other vermin too. Do not include this creature token on an intelligent entity that you intend to play as in fortress mode because it will prevent them from feeding themselves.

|}

{{alphabetical TOC|style=margin: 1em auto;}}

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

|-
| {{text anchor|IMMOBILE}}
| Caste
|
| The creature cannot move. Found on [[sponge]]s. Will also stop a creature from breeding in fortress mode (MALE and FEMALE are affected, if one is IMMOBILE; no breeding will happen).

|-
| {{text anchor|IMMOBILE_LAND}}
| Caste
|
| The creature is immobile while on land. Only works on {{token|AQUATIC|c}} creatures which can't breathe on land.

|-
| {{text anchor|IMMOLATE}}
| Caste
|
| The creature radiates [[fire]]. It will ignite, and potentially completely destroy, items the creature is standing on. Also gives the vermin a high chance of escaping from [[animal trap]]s and [[cage]]s made of any flammable materials (specifically ones that could be ignited by magma).

|-
| {{text anchor|INTELLIGENT}}
| Caste
|
| Alias for {{token|CAN_SPEAK|c}} + {{token|CAN_LEARN|c}}.

|-
| {{text anchor|ITEMCORPSE}}
| Caste
|
* [[item token]]
* [[material token]]
| Determines if the creature leaves behind a non-standard corpse (i.e. wood, statue, bars, stone, pool of liquid, etc.). [[Ethics]] may prevent actually using the item in jobs or reactions.

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

{{alphabetical TOC|style=margin: 1em auto;}}

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

|-
| {{text anchor|LAIR}}
| Caste
|
*type
*probability
| Found on megabeasts, semimegabeasts, and night creatures. The creature will seek out sites of this type and take them as lairs. The lair types are:
*SIMPLE_BURROW
*SIMPLE_MOUND
*WILDERNESS_LOCATION
*SHRINE
*LABYRINTH

|-
| {{text anchor|LAIR_CHARACTERISTIC}}
| Caste
|
*characteristic
*probability
| Defines certain features of the creature's lair. The only valid characteristic is HAS_DOORS.

|-
| {{text anchor|LAIR_HUNTER}}
| Caste
|
| This creature will actively hunt adventurers in its lair.

|-
| {{text anchor|LAIR_HUNTER_SPEECH}}
| Caste
|
*speech file
| What this creature says while hunting adventurers in its lair.

|-
| {{text anchor|LARGE_PREDATOR}}
| Caste
|
| Will attack other creatures that are smaller than it. Tamed large predators will still attack wildlife. In [[fortress mode]], only one group of "large predators" (possibly two groups on "savage" maps) will appear on any given map. In [[adventurer mode]], large predators will try to ambush and attack you (and your party will attack them back). When tamed, large predators tend to be much more aggressive to enemies than non-large predators, making them a good choice for an animal army. They may go on rampages in worldgen, and adventurers may receive quests to kill them. Also, they can be mentioned in the intro paragraph when starting a fortress e.g. "ere the wolves get hungry."
A single biome supports 7 large predator species, picking randomly and rolling a d100 under its {{token|FREQUENCY|c}} to add it until all 7 slots are filled.

Incompatible with {{token|PACK_ANIMAL|c}} on a technicality, if included: hauled items are likely to be dropped upon entering the map (even if {{token|TRADE_CAPACITY|c}} is present) in contrast to when the merchants depart.

|-
| {{text anchor|LARGE_ROAMING}}
| Creature
|
| This is the core requisite tag allowing the creature to spawn as a wild animal in the appropriate biomes. Requires specifying a {{token|BIOME|c}} in which the creature will spawn. Does not require specifying a frequency, population number, or cluster number.

This tag stacks with {{token|MEGABEAST|c}}, {{token|SEMIMEGABEAST|c}}, or {{token|NIGHT_CREATURE_HUNTER|c}}; if used with one of these tags, the creature will spawn as both a boss and as a wild animal. This tag does not stack with {{token|FEATURE_BEAST|c}} and if both are used the creature will not spawn. This tag is unaffected by {{token|DEMON|c}}.

|-
| {{text anchor|LAYS_EGGS}}
| Caste
|
| Creature lays [[egg]]s instead of giving birth to live young.

|-
| {{text anchor|LAYS_UNUSUAL_EGGS}}
| Caste
|
* [[item token]]
* [[material token]]
| Creature lays the specified item instead of regular eggs.

|-
| {{text anchor|LIGAMENTS}}
| Caste
|
* [[material token]]
*healing rate
| The creature has ligaments in its {{token|CONNECTIVE_TISSUE_ANCHOR|td}} tissues (bone or chitin by default). Cutting the bone/chitin tissue severs the ligaments, disabling motor function if the target is a limb.

|-
| {{text anchor|LIGHT_GEN}}
| Caste
|
| A vermin featuring this tag will remain visible to an adventurer even at night.

Subterranean vermin which feature this token will flicker in unexposed and unrevealed cavern layers while playing in Fortress Mode.

|-
| {{text anchor|LIKES_FIGHTING}}
| Caste
|
| The creature will attack enemies rather than flee from them. This tag has the same effect on player-controlled creatures - including modded dwarves. Retired as of v0.40.14 in favor of {{token|LARGE_PREDATOR|c}}.

|-
| {{text anchor|LISP}}
| Caste
|
| Creature uses "sssssnake talk" (multiplies 'S' when talking - "My name isss Recisssiz."). Used by [[Serpent man|serpent men]] and [[Reptile man|reptile men]] in the vanilla game. C's with the same pronunciation (depending on the word) are not affected by this token.

|-
| {{text anchor|LITTERSIZE}}
| Caste
|
* minimum
* maximum
| Determines the number of offspring per one birth; default 1-3, not used in vanilla raws. See also {{token|MULTIPLE_LITTER_RARE|c}}.

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

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

|-
| {{text anchor|LOCKPICKER}}
| Caste
|
| Lets a creature open [[door]]s that are set to forbidden in fortress mode.

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

|-
| {{text anchor|LOW_LIGHT_VISION}}
| Caste
|
*number
| Determines how well a creature can see in the dark - higher is better. Dwarves have 10000, which amounts to perfect nightvision.
|}

{{alphabetical TOC|style=margin: 1em auto;}}

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

|-
| {{text anchor|MAGICAL}}
| Caste
|
| According to Toady One, this is completely interchangeable with {{token|AT_PEACE_WITH_WILDLIFE|c}} and might have been used in very early versions of the game by wandering wizards or the ent-type tree creatures that used to be animated by elves. [http://www.bay12forums.com/smf/index.php?topic=169696.msg8316954#msg8316954]

|-
| {{text anchor|MAGMA_VISION}}
| Caste
|
| The creature is able to see while submerged in [[magma]].

|-
| {{text anchor|MALE}}
| Caste
|
| Makes the creature biologically male. Usually declared inside a caste.

|-
| {{text anchor|MANNERISM|MANNERISM_*}}
| Caste
|
*occasionally body part
| Adds a possible mannerism to the creature's profile. See [[creature mannerism token]] for further info.

|-
| {{text anchor|MATERIAL}}
| Creature
|
*material id
| Begins defining a new local material. Follow this with standard material definition tokens to define the material.

|-
| {{text anchor|MATERIAL_FORCE_MULTIPLIER}}
| Caste
|
*[[Material token]]
*value A
*value B
| When struck with a weapon made of the specified material, the force exerted will be multiplied by A/B, thus making the creature more or less susceptible to this material. For example, if A is 2 and B is 1, the force exerted by the defined material will be doubled. If A is 1 and B is 2, it will be halved instead. See also {{token|GENERAL_MATERIAL_FORCE_MULTIPLIER|c}}, which can be used to make this sort of effect applicable to all materials.

|-
| {{text anchor|MATUTINAL}}
| Caste
|
| When set, the creature will only appear at dawn (between 4:30 AM and 6:00 AM) in [[Adventurer mode]].

|-
| {{text anchor|MAXAGE}}
| Caste
|
*min
*max
| Determines the creature's natural lifespan, using the specified minimum and maximum age values (in years). Each individual creature with this token is generated with a predetermined date (calculated down to the exact [[time|tick]]!) between these values, at which it is destined to die of old age, should it live long enough. Note that the probability of death at any given age does not increase as the creature gets older [http://i.imgur.com/A1A4aA9.png].
Creatures which lack this token are naturally immortal. The [[Syndrome#CE_ADD_TAG|NO_AGING]] syndrome tag will prevent death by old age from occurring. Also note that, among civilized creatures, castes which lack this token will refuse to marry others with it, and vice versa.

|-
| {{text anchor|MEANDERER}}
| Caste
|
| Makes the creature slowly stroll around, unless it's in combat or performing a job. If combined with {{token|CAN_LEARN|c}}, will severely impact their [[pathfinding]] and lead the creature to move extremely slowly when not performing any task. Problematically applies to animal people based on the animal and war trained animals{{bug|9588}}.

|-
| {{text anchor|MEGABEAST}}
| Caste
|
| A 'boss' creature. A small number of the creatures are created during worldgen, their histories and descendants (if any) will be tracked in worldgen (as opposed to simply 'spawning'), and they will occasionally go on rampages, potentially leading to worship if they attack the same place multiple times. Their presence and number will also influence age names. When appearing in fortress mode, they will have a pop-up message announcing their arrival. They will remain hostile to military even after being tamed.{{bug|10731}} See [[megabeast]] page for more details.

Requires specifying a {{token|BIOME|c}} in which the creature will live. Subterranean biomes appear to not be allowed. Does stack with {{token|LARGE_ROAMING|c}} and if both are used the creature will spawn as both historical bosses and as wild animals.

|-
| {{text anchor|MENT_ATT_CAP_PERC}}
| Caste
|
*[[Attribute|ATTRIBUTE]] Token
*Cap %
|Default is 200. This means you can increase your attribute to 200% of its starting value (or the average value + your starting value if that is higher).

|-
| {{text anchor|MENT_ATT_RANGE}}
| Caste
|
*[[Attribute|ATTRIBUTE]]
*lowest
*lower
*low
*median
*high
*higher
*highest
| Sets up a [[Attribute#Soul_attributes|mental attribute]]'s range of values (0-5000). All mental attribute ranges default to 200:800:900:1000:1100:1300:2000.

|-
| {{text anchor|MENT_ATT_RATES}}
| Caste
|
*[[Attribute|ATTRIBUTE]] Token
*cost to improve
*unused counter rate
*rust counter rate
*demotion counter rate
| [[Attribute#Soul_attributes|Mental attribute]] gain/decay rates. Lower numbers in the last three slots make decay occur faster. Defaults are 500:4:5:4.

|-
| {{text anchor|MILKABLE}}
| Caste
|
* [[material token]]
* frequency
| Allows the creature to be [[milk]]ed in the [[farmer's workshop]]. The frequency is the amount of [[time|ticks]] the creature needs to "recharge" (i.e. how much time needs to pass before it can be milked again). Does not work on [[#CAN_LEARN|sentient]] creatures, regardless of [[ethics]].

|-
| {{text anchor|MISCHIEVIOUS}}
| Caste
|
| Alias for {{token|MISCHIEVOUS|c}}.

|-
| {{text anchor|MISCHIEVOUS}}
| Caste
|
| The creature spawns [[stealth]]ed and will attempt to path into the fortress, pulling any [[lever]]s it comes across. It will be invisible on the map and [[unit list]] until spotted by a citizen, at which point the game will pause and recenter on the creature. Used by [[gremlin]]s in the vanilla game. "They go on little missions to mess with various fortress buildings, not just levers."

|-
| {{text anchor|MODVALUE}}
| Caste
|
| Seemingly no longer used.

|-
| {{text anchor|MOUNT}}
| Caste
|
| Creature may be used as a [[mount]]. No use for the player in fortress mode, but enemy sieging forces may arrive with cavalry. Mounts are usable in adventure mode.

|-
| {{text anchor|MOUNT_EXOTIC}}
| Caste
|
| Creature may be used as a [[mount]], but civilizations cannot domesticate it in worldgen without certain exceptions.

|-
| {{text anchor|MULTIPART_FULL_VISION}}
| Caste
|
| Allows the creature to have all-around vision, as long as it has multiple heads that can see.

|-
| {{text anchor|MULTIPLE_LITTER_RARE}}
| Caste
|
| Makes the species usually produce a single offspring per birth, with a 1/500 chance of using the {{token|LITTERSIZE|c}} as usual. Requires {{token|FEMALE|c}}.

|-
| {{text anchor|MUNDANE}}
| Creature
|
| Marks if the creature is an actual real-life creature. Only used for age-names at present.
|}

{{alphabetical TOC|style=margin: 1em auto;}}

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

|-
| {{text anchor|NAME}}
| Creature
|
*singular
*plural
*adjective
| The generic name for any creature of this type - will be used for referring to the species in the abstract, such as the default material prefix. For labeling individual creatures, {{token|CASTE_NAME|c}} is necessary. If left undefined, the creature will be labeled as "nothing" by the game.

Some examples of adjective use:
* "super''dwarven'' strength"
* "the ''dwarven'' hillocks of X"
* Deity species as in "''feline'' deity"
* Megabeast attacks in worldgen. One with multiple dragons being a "''draconic'' rampage"

|-
| {{text anchor|NATURAL}}
| Caste
|
| Animal is considered to be natural. NATURAL animals will not engage creatures tagged with {{token|AT_PEACE_WITH_WILDLIFE|c}} in combat unless they are members of a hostile entity and vice-versa.

|-
| {{text anchor|NATURAL_ANIMAL}}
| Caste
|
| Alias of {{token|NATURAL|c}}.

|-
| {{text anchor|NATURAL_SKILL}}
| Caste
|
*[[Skill_token|Skill token]]
*value
| The creature possesses the specified [[skill]] at this level inherently - that is, it begins with the skill at this level, and the skill may never rust below that. A value of 15 is legendary.

|-
| {{text anchor|NIGHT_CREATURE}}
| Caste
|
| Creatures with this token can appear as [[experiment|experiments]]. Causes the creature to count as {{token|NOT_LIVING|c}}. Killing a creature featuring this token provides one point of "hero" reputation. Adds the creature's description as part of the initial summary of their historical figure in legends mode. People will react to creatures with this token as a night creature (natch). In adventure mode, ambushes involving these units will say "Night creature!" instead of "Ambush!"

Prevents creature behavior enabled by {{token|LARGE_PREDATOR|c}}

Prevents the AI from using ANIMATE interactions, unless the newly-animated{{token|OPPOSED_TO_LIFE|c}}undead will not attack them. The check for this is specifically whether the unit is:
*a ghost
*an animated unit
*a unit with the {{token|NO_AGING|c}} token added via {{token|CE_ADD_TAG|c}}. (This allows for the default exclusion of elves and goblins, unless raised as intelligent undead.)

''This token should not be confused with other NIGHT_CREATURE_X tokens.''
''This token is not well understood at the present time.''

|-
| {{text anchor|NIGHT_CREATURE_BOGEYMAN}}
| Caste
|
| Creatures with this token can appear in [[bogeyman|bogeyman ambushes]] in [[adventure mode]], where they adopt classical bogeyman traits such as stalking the adventurer and vaporising when dawn breaks. Such traits do not manifest if the creature is encountered outside of a bogeyman ambush (for instance, as a megabeast or a civilised being). In addition, their corpses and severed body parts turn into [[smoke]] after a short while. Note that setting the "Number of Bogeyman Types" in [[advanced world generation]] to 0 will only remove randomly-generated bogeymen.

|-
| {{text anchor|NIGHT_CREATURE_EXPERIMENTER}}
| Caste
|
| Found on some [[necromancer]]s. Creatures with this tag may periodically "perform horrible experiments" offscreen, during which they can use creature-targeting interactions with an <code>[[Interaction_token#I_SOURCE|[I_SOURCE:EXPERIMENT]]]</code> tag on living creatures in their area. Worlds are generated with a list of procedurally-generated experiments, allowing necromancers to turn living people and animals into [[Infected_ghoul|ghouls]] and [[Experiment|other experimental creatures]], and these will automatically be available to all experimenters; it does not appear possible to prevent this. You can mod in your own custom experiment interactions, but these are used very infrequently due to the large number of generated experiments.

|-
| {{text anchor|NIGHT_CREATURE_HUNTER}}
| Caste
|
| Found on [[night troll]]s and [[werebeast]]s. Implies that the creature is a [[night creature]], and shows its description in [[legends mode]] entry. The creature is always hostile and will start [[no quarter]] combat with any nearby creatures, except for members of its own race. Note that this tag does not override the creature's normal behavior in [[fortress mode]] except for the aforementioned aggression, and doesn't prevent the creature from fleeing the battles it started. It also removes the creature's materials from stockpile settings list, making them be stored there regardless of settings.

Does stack with {{token|LARGE_ROAMING|c}} and if both are used the creature will spawn as both historical hunters and as wild animals; this requires specifying a {{token|BIOME|c}} in which the creature will live, and subterranean biomes are allowed.

This tag causes the usual behaviour of werebeasts in worldgen, that is, fleeing towns upon being cursed and conducting raids from a lair. If this tag is absent from a deity curse, the accursed will simply be driven out of towns in a similar manner to [[vampire]]s. When paired with SPOUSE_CONVERTER, a very small population of the creature will be created during worldgen (sometimes only a single individual will be created), and their histories will be tracked (that is, they will not spawn spontaneously later, they must either have children or convert other creatures to increase their numbers). The creature will settle in a lair and go on rampages during worldgen. It will actively attempt to seek out potential conversion targets to abduct, convert, and have children with (if possible).

|-
| {{text anchor|NIGHT_CREATURE_NIGHTMARE}}
| Caste
|
| Found on [[nightmare]]s. Corpses and severed body parts derived from creatures with this token turn into [[smoke]] after a short while.

|-
| {{text anchor|NO_AUTUMN}}
| Caste
|
| The creature caste does not appear in [[Calendar|autumn]].

|-
| {{text anchor|NO_CONNECTIONS_FOR_MOVEMENT}}
| Caste
|
| Creature doesn't require connected body parts to move{{verify}}; generally used on undead creatures with connections that have rotted away.

|-
| {{text anchor|NO_DIZZINESS}}
| Caste
|
| Creature cannot become [[Symptom#Dizziness|dizzy]].

|-
| {{text anchor|NO_DRINK}}
| Caste
|
| Creature does not need to drink.

|-
| {{text anchor|NO_EAT}}
| Caste
|
| Creature does not need to [[food|eat]].

|-
| {{text anchor|NO_FEVERS}}
| Caste
|
| Creature cannot suffer [[Symptom#Fever|fevers]].

|-
| {{text anchor|NO_GENDER}}
| Caste
|
| The creature is biologically sexless, making it unable to [[breeding|breed]].

|-
| {{text anchor|NO_PHYS_ATT_GAIN}}
| Caste
|
| The creature cannot raise any [[Attribute#Body_attributes|physical attributes]].

|-
| {{text anchor|NO_PHYS_ATT_RUST}}
| Caste
|
| The creature cannot lose any [[Attribute#Body_attributes|physical attributes]].

|-
| {{text anchor|NO_SLEEP}}
| Caste
|
| Creature does not need to sleep, but can still be rendered unconscious by other means.

|-
| {{text anchor|NO_SPRING}}
| Caste
|
| The creature caste does not appear in [[Calendar|spring]].

|-
| {{text anchor|NO_SUMMER}}
| Caste
|
| The creature caste does not appear in [[Calendar|summer]].

|-
| {{text anchor|NO_THOUGHT_CENTER_FOR_MOVEMENT}}
| Caste
|
| The bodyparts of this creature don't need to be connected to an organ with the {{token|THOUGHT|body}} tag in order to have motor function. Generally used on creatures that don't have brains. If a creature doesn't have a thought part and doesn't have this token, it will be unable to grasp or stand. Nautilus men experience this issue in vanilla.

|-
| {{text anchor|NO_UNIT_TYPE_COLOR}}
| Caste
|
| Prevents creature from selecting its color based on its profession (e.g. Miner, Hunter, Wrestler).

|-
| {{text anchor|NO_VEGETATION_PERTURB}}
| Caste{{Verify}}
|
| Likely prevents the creature from leaving broken vegetation tracks.{{Verify}}

|-
| {{text anchor|NO_WINTER}}
| Caste
|
| The creature caste does not appear in [[Calendar|winter]].

|-
| {{text anchor|NOBONES}}
| Caste
|
| Creature has no bones.

|-
| {{text anchor|NOBREATHE}}
| Caste
|
| Creature doesn't need to breathe or have {{token|BREATHE|body}}parts in its body, nor can it drown or be strangled. Creatures living in magma must have this tag, otherwise they will drown.

|-
| {{text anchor|NOCTURNAL}}
| Caste
|
| When set, the creature will only appear at night (after 10:05 PM and before 4:30 AM) in [[Adventurer mode]].

|-
| {{text anchor|NOEMOTION}}
| Caste
|
| Creature has no emotions, thus; it is immune to the effects of [[stress]] and unable to rage, and its [[need]]s cannot be fulfilled in any way. Used on [[undead]] in the vanilla game.

|-
| {{text anchor|NOEXERT}}
| Caste
|
| Creature can't become tired or over-exerted from taking too many combat actions, or moving at full speed for extended periods of time.

|-
| {{text anchor|NOFEAR}}
| Caste
|
| Creature doesn't feel fear and will never flee from battle, and will be immune to [[ghost]]s' attempts to 'scare it to death'. Additionally, it causes [[bogeyman|bogeymen]] and [[nightmare]]s to become friendly towards the creature.

|-
| {{text anchor|NOMEAT}}
| Caste
|
| Creature will not be hunted or fed to wild beasts.

|-
| {{text anchor|NONAUSEA}}
| Caste
|
| Creature isn't nauseated by gut hits and cannot vomit.

|-
| {{text anchor|NOPAIN}}
| Caste
|
| Creature doesn't feel pain.

|-
| {{text anchor|NOSKIN}}
| Caste
|
| Creature will not drop a hide when [[butcher|butchered]].

|-
| {{text anchor|NOSKULL}}
| Caste
|
| Creature will not drop a skull on butchering, rot, or decay of severed head.

|-
| {{text anchor|NOSMELLYROT}}
| Caste
|
| Does not produce [[miasma]] when rotting.

|-
| {{text anchor|NOSTUCKINS}}
| Caste
|
| Weapons can't get stuck in the creature.

|-
| {{text anchor|NOSTUN}}
| Caste
|
| Creature can't be stunned and knocked unconscious by pain or head injuries. Creatures with this tag never wake up from sleep in Fortress Mode. If this creature needs to sleep while playing, it will die.

|-
| {{text anchor|NOT_BUTCHERABLE}}
| Caste
|
| Corpses from this creature cannot be [[butcher|butchered]]. Does not prevent the creature from being slaughtered while alive, however.

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

|-
| {{text anchor|NOTHOUGHT}}
| Caste
|
| Creature doesn't require a {{token|THOUGHT|body}} body part to survive. Has the added effect of preventing speech, though directly controlling creatures that would otherwise be capable of speaking allows them to engage in conversation.
|}

{{alphabetical TOC|style=margin: 1em auto;}}

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

|-
| {{text anchor|ODOR_LEVEL}}
| Caste
|
*number
| How easy the creature is to [[smell]]. The higher the number, the easier the creature is to sniff out. Defaults to 50. Vanilla creatures have values from 0 (undetectable) to 90 (noticeable by humans and dwarves).

|-
| {{text anchor|ODOR_STRING}}
| Caste
|
*string
| What the creature [[smell]]s like. If no odor string is defined, the creature name (not the caste name) is used.

|-
| {{text anchor|OPPOSED_TO_LIFE}}
| Caste
|
| Is hostile to all creatures except undead and other non-living ones and will show {{DFtext|Opposed to life|0:1}} in the [[unit list]]. Used by [[undead]] in the vanilla game. Functions without the {{token|NOT_LIVING|c}} token, and seems to imply said token as well. Undead will not be hostile to otherwise-living creatures given this token. Living creatures given this token will attack living creatures that lack it, while ignoring other living creatures that also have this token.

|-
| {{text anchor|ORIENTATION}}
| Caste
|
*MALE/FEMALE
*disinterested chance
*casual chance
*strong chance
| Determines caste's likelihood of having sexual attraction to certain sexes. Values default to 75:20:5 for the same sex and 5:20:75 for the opposite sex. The first value indicates how likely to be entirely uninterested in the sex, the second decides if the creature will be able to become lovers with that sex, the third decides whether they will be able to marry in worldgen and post-worldgen world activities (which implies being able to become lovers). Marriage seems to be able to happen in fort mode play regardless, as long as they are lovers first.

|-
| {{text anchor|OUTSIDER_CONTROLLABLE}}
| Caste
|
| Lets you play as an [[Adventurer_mode_character_creation#Outsider|outsider]] of this species in adventure mode.

|}

{{alphabetical TOC|style=margin: 1em auto;}}

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

|-
| {{text anchor|PACK_ANIMAL}}
| Caste
|
| Allows the creature to be used as a pack animal. Used by [[trading|merchants]] without wagons and adventurers. Also prevents creature from dropping hauled items on its own -- do ''not'' use for player-controllable creatures! May lead to the creature being domesticated during worldgen, even if it doesn't have {{token|COMMON_DOMESTIC|c}}.

Creatures with this tag but without {{token|BENIGN|c}}, and/or with {{token|LARGE_PREDATOR|c}} leads to hauled items being dropped.

|-
| {{text anchor|PARALYZEIMMUNE}}
| Caste
|
| The creature is immune to all [[Syndrome#CE_PARALYSIS|paralyzing]] special attacks.

|-
| {{text anchor|PATTERNFLIER}}
| Caste
|
| Used to control the bat riders with paralyze-dart blowguns that flew through the 2D chasm. Doesn't do anything now.

|-
| {{text anchor|PCG_LAYERING}}
| Creature
|
*[[Procedural graphics layer|Layering type]]
| Adds a layer to the current {{token|PROCEDURAL_CREATURE_GRAPHICS|c}} definition.

|-
| {{text anchor|PEARL}}
| Caste
|
| Does nothing.

|-
| {{text anchor|PENETRATEPOWER}}
| Caste
|
*value
| Controls the ability of [[vermin]] to find a way into containers when they are eating food from your stockpiles.

Objects made of most materials (e.g. metal) roll a number from 0-100, and if the resulting number is greater than the penetrate power, their contents escape for the time being. Objects made of [[wood]], [[leather]], [[amber]], or [[coral]] roll 0-95, and items made of [[cloth]] roll 0-90.

|-
| {{text anchor|PERSONALITY}}
| Caste
|
*ATTRIBUTE
*lowest
*median
*highest
| Determines the range and chance of personality facets. Standard is 0:50:100. See [[personality facet]] for more info.

|-
| {{text anchor|PET}}
| Caste
|
| Allows the creature to be [[Animal_trainer|tamed]] in Fortress mode. Prerequisite for all other working animal roles. Civilizations that encounter it in worldgen will tame and domesticate it for their own use. Adding this to civilization members will classify them as pets instead of citizens, with all the [[Fun|problems]] that entails. However, you can solve these problems using the popular plugin [https://dffd.bay12games.com/file.php?id=13095| Dwarf Therapist], which is completely unaffected by the tag.

|-
| {{text anchor|PET_EXOTIC}}
| Caste
|
| Allows the creature to be [[Animal_trainer|tamed]] in Fortress mode. Prequisite for all other working animal roles. Civilizations cannot domesticate it in worldgen, with certain exceptions. More difficult to tame?{{verify}} Adding this to civilization members will classify them as pets instead of citizens, with all the [[Fun|problems]] that entails. ([[Gremlin|Example]]).

|-
| {{text anchor|PETVALUE}}
| Caste
|
*value
| How valuable a tamed animal is. Actual cost in points in the embarking screen is 1+(PETVALUE/2) for an untrained animal, 1+PETVALUE for a war/hunting one.

|-
| {{text anchor|PETVALUE_DIVISOR}}
| Caste
|
*value
| Divides the creature's {{token|PETVALUE|c}} by the specified number. Used by [[honey bee]]s to prevent a single hive from being worth a fortune.

|-
| {{text anchor|PHYS_ATT_CAP_PERC}}
| Caste
|
*[[Attribute|ATTRIBUTE]] Token
*Cap %
|Default is 200. This means you can increase your attribute to 200% of its starting value (or the average value + your starting value if that is higher).

|-
| {{text anchor|PHYS_ATT_RANGE}}
| Caste
|
*[[Attribute|ATTRIBUTE]]
*lowest
*lower
*low
*median
*high
*higher
*highest
| Sets up a [[Attribute#Body_attributes|physical attribute]]'s range of values (0-5000). All physical attribute ranges default to 200:700:900:1000:1100:1300:2000.

|-
| {{text anchor|PHYS_ATT_RATES}}
| Caste
|
*[[Attribute|ATTRIBUTE]] Token
*cost to improve
*unused counter rate
*rust counter rate
*demotion counter rate
| [[Attribute#Body_attributes|Physical attribute]] gain/decay rates. Lower numbers in the last three slots make decay occur faster. Defaults for STRENGTH, AGILITY, TOUGHNESS, and ENDURANCE are 500:3:4:3, while RECUPERATION and DISEASE_RESISTANCE default to 500:NONE:NONE:NONE.

|-
| {{text anchor|PLUS_BP_GROUP}}
| Caste
|
*BY_TYPE, BY_CATEGORY, or BY_TOKEN
*body type, category, or token
| Adds a body part group to selected body part group. Presumably used immediately after {{token|SET_BP_GROUP|c}}.

|-
| {{text anchor|PLUS_MATERIAL}}
| Creature
|
*material
| Adds a material to selected materials. Used immediately after {{token|SELECT_MATERIAL|c}}.

|-
| {{text anchor|POP_RATIO}}
| Caste
|
*number (max 100000)
| Weighted population of caste; Lower is rarer. Not to be confused with {{token|FREQUENCY|c}}. A weight of 0 will{{version|51.06 experimental}} prevent a caste from spawning naturally. Regardless of pop ratio, [[Position token|Position]]s that only allow a certain caste can force it to spawn.

|-
| {{text anchor|POPULATION_NUMBER}}
| Creature
|
*min
*max
| The minimum/maximum numbers of how many of these creatures are present in each world map tile of the appropriate region. Defaults to 1:1 if not specified.

|-
| {{text anchor|POWER}}
| Caste
|
| Allows the being to represent itself as a deity, allowing it to become the leader of a civilized group. Not used by any creatures in the vanilla game. Requires {{token|CAN_SPEAK|c}} to actually do anything more than settle at a location (e.g. write books, lead armies, profane temples). Doesn't appear to do anything for creatures that are already civilized. Once the creature ascends to a position of leadership, it will proceed to act as a standard ruler for their entity and fulfill the same functions (hold tournaments, tame creatures, etc.).

|-
| {{text anchor|PREFSTRING}}
| Creature
|
*string
| Sets what other creatures [[Preferences|prefer]] about this creature. "Urist likes dwarves for their beards." Multiple entries will be chosen from at random. Creatures lacking a PREFSTRING token will never appear under another's preferences.

|-
| {{text anchor|PROCEDURAL_CREATURE_GRAPHICS}}
| Creature
|
* [[Graphics_token#Basic_creature_sprite_types|Sprite type]] or Caste then sprite type
| Makes the creature have procedural graphics built for it, like forgotten beasts/demons/titans/experiments. Must be associated with PCG_LAYERING tokens.

|-
| {{text anchor|PROFESSION_NAME}}
| Creature
|
*[[Unit type token]] (Profession)
*singular
*plural
| The generic name for members of this profession, at the creature level. In order to give members of specific castes different names for professions, use {{token|CASTE_PROFESSION_NAME|c}} instead.

|-
| {{text anchor|PRONE_TO_RAGE}}
| Caste
|
*Chance
| Creature has a percentage chance to flip out at visible non-friendly creatures. Enraged creatures attack anything regardless of timidity and get a strength bonus to their hits. This is what makes [[badger]]s so hardcore.

|-
| {{text anchor|PUS}}
| Caste
|
* <[[material token]]>
* <[[Material_definition_token#Material_States|material state]]>
| The creature has pus. Specifies the stuff secreted by [[Health_care#Infection|infected wounds]].
|}

{{alphabetical TOC|style=margin: 1em auto;}}

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

|-
| {{text anchor|RELSIZE}}
| Caste
|
*BY_CATEGORY, BY_TYPE, BY_TOKEN
*body category, type, or token
*Relsize
| Specifies a new relative size for a part than what is stated in the body plan. For example, dwarves have larger livers.

|-
| {{text anchor|REMAINS}}
| Caste
|
*singular
*plural
| What the creature's [[remains]] are called.

|-
| {{text anchor|REMAINS_COLOR}}
| Caste
|
| What color the creature's [[remains]] are.

|-
| {{text anchor|REMAINS_ON_VERMIN_BITE_DEATH}}
| Caste
|
| Goes with {{token|VERMIN_BITE|c}} and {{token|DIE_WHEN_VERMIN_BITE|c}}, the vermin creature will leave remains on death when biting. Leaving this tag out will cause the creature to disappear entirely after it bites.

|-
| {{text anchor|REMAINS_UNDETERMINED}}
| Caste
|
| Nothing.

|-
| {{text anchor|REMOVE_MATERIAL}}
| Creature
|
*material token
| Removes a material from the creature.

|-
| {{text anchor|REMOVE_TISSUE}}
| Creature
|
*tissue token
| Removes a tissue from the creature.

|-
| {{text anchor|RETRACT_INTO_BP}}
| Caste
|
*BY_TYPE, BY_CATEGORY or BY_TOKEN
*body type, [[Body_token#CATEGORY|category]], or [[Body_token#BP|token]]
*Second person ("You") retract verb text
*Third person ("The giant snail") retract verb text
*Second person cancel retract text
*Third person cancel retract text
| The creature will retract into the specified body part(s) when threatened. It will be unable to move or attack, but enemies will only be able to attack the specified body part(s). When one of the specified body part is severed off, the creature automatically unretracts and cannot retract anymore. More than one body part can be selected by using BY_TYPE or BY_CATEGORY.

Second-person descriptions are used for adventurer mode natural ability. "<pro_pos>" can be used in the descriptions, being replaced with the proper pronoun (or lack thereof) in-game.

Undead curled up creatures are buggy, specifically those that retract into their upper bodies: [[echidna]]s, [[hedgehog]]s and [[pangolin]]s.{{bug|11463}}{{bug|10519}} The upper body is prevented from collapsing by a separate body part (the middle spine), which cannot be attacked when the creature is retracted. See {{token|PREVENTS_PARENT_COLLAPSE|bo}}. Living creatures eventually succumb to blood loss, but undead creatures do not. Giant creatures also take a very long time to bleed out.
|-
| {{text anchor|RETURNS_VERMIN_KILLS_TO_OWNER}}
| Creature
|
| Cat behavior. If it kills a vermin creature and has an owner, it carries the remains in its mouth and drops them at their feet. Requires {{token|HUNTS_VERMIN|c}}.

|-
| {{text anchor|ROOT_AROUND}}
| Caste
|
*BY_TYPE, BY_CATEGORY or BY_TOKEN
*body type, [[Body_token#CATEGORY|category]], or [[Body_token#BP|token]]
*Second person ("You") verb text
*Third person ("The hen") verb text
| Creature will occasionally root around in the grass, looking for insects. Used for flavor in Adventurer Mode, spawns vermin edible for this creature in Fortress Mode. Creatures missing the specified body part will be unable to perform this action. The action produces a message (visible in adventure mode) in the form:

[creature] [verb text] the [description of creature's location]

In adventure mode, the "rooting around" ability will be included in the "natural abilities" menu, represented by its second person verb text.

|}

{{alphabetical TOC|style=margin: 1em auto;}}

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

|-
| {{text anchor|SAVAGE}}
| Creature
|
| The creature will only show up in "savage" biomes. Has no effect on cavern creatures. Cannot be combined with {{token|GOOD|c}} or {{token|EVIL|c}}.

|-
| {{text anchor|SECRETION}}
| Caste
|
*<[[material token]]>
*<[[Material_definition_token#Material_States|material state]]>
*BY_TOKEN / BY_CATEGORY / BY_TYPE
*<[[Body_token#BP|body part ID]]> / <[[Body_token#CATEGORY|category]]> or ALL / <type (e.g. [[Body_token#GRASP|GRASP]])>
*<[[Body_detail_plan_token#BP_LAYERS|tissue layer]]> or ALL
*<trigger>
| Causes the specified tissue layer(s) of the indicated body part(s) to secrete the designated material. A size 100 ('covering') [[contaminant]] is created over the affected body part(s) in its specified material state (and at the temperature appropriate to this state) when the trigger condition is met, as long as one of the secretory tissue layers is still intact. Valid triggers are:
*'''CONTINUOUS'''
Secretion occurs once every 40 [[time|ticks]] in [[fortress mode]], and every tick in [[adventurer mode]].
*'''EXERTION'''
Secretion occurs continuously (at the rate described above) whilst the creature is at minimum {{Tile|Tired|6:1}} following physical exertion. Note that this cannot occur if the creature has {{token|NOEXERT|c}}.
*'''EXTREME_EMOTION'''
Secretion occurs continuously (as above) whilst the creature is distressed. Cannot occur in creatures with {{token|NOEMOTION|c}}.

|-
| {{text anchor|SELECT_ADDITIONAL_CASTE}}
| Creature
|
*<caste>
| Adds an additional previously defined caste to the selection. Used after {{token|SELECT_CASTE|c}}.

|-
| {{text anchor|SELECT_CASTE}}
| Creature
|
*<caste> or ALL
| Selects a previously defined caste

|-
| {{text anchor|SELECT_MATERIAL}}
| Creature
|
*<[[material token]]>
| Selects a locally defined material. Can be ALL.

|-
| {{text anchor|SELECT_TISSUE}}
| Creature
|
*tissue token
| Selects a tissue for editing.

|-
| {{text anchor|SEMIMEGABEAST}}
| Caste
|
| Essentially the same as {{token|MEGABEAST|c}}, but more of them are created during worldgen. See the [[semi-megabeast]] page for details.

|-
| {{text anchor|SENSE_CREATURE_CLASS}}
| Caste
|
* <[[Creature_token#CREATURE_CLASS|creature class]]>
* [[Tilesets|<tile value or character>]]
* [[Color#Color_values|<foreground color>:<background color>:<foreground brightness>]]
| Gives the creature the ability to sense creatures belonging to the specified [[Creature_token#CREATURE_CLASS|creature class]] even when they lie far beyond line of sight, including through walls and floors. It also appears to reduce or negate the combat penalty of [[Wound#Blindness|blind]] units when fighting creatures they can sense. In [[adventure mode]], the specified tile will be used to represent sensed creatures when they cannot be seen directly.

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

|-
| {{text anchor|SKILL_LEARN_RATE}}
| Caste
|
*<[[skill_token]]>
*<percentage>
| The rate at which this creature learns this skill. Requires {{token|CAN_LEARN|c}} or {{token|INTELLIGENT|c}} to function.

|-
| {{text anchor|SKILL_LEARN_RATES}}
| Caste
|
*<percentage>
| The rate at which this creature learns all skills. Requires {{token|CAN_LEARN|c}} or {{token|INTELLIGENT|c}} to function.

|-
| {{text anchor|SKILL_RATE}}
| Caste
|
*[[skill_token]]
*<% of improvement points gained>
*<unused counter rate>
*<rust counter rate>
*<demotion counter rate>
| Like {{token|SKILL_RATES|c}}, but applies to individual skills instead. Requires {{token|CAN_LEARN|c}} or {{token|INTELLIGENT|c}} to function.

|-
| {{text anchor|SKILL_RATES}}
| Caste
|
*<% of improvement points gained>
*<unused counter rate>
*<rust counter rate>
*<demotion counter rate>
| Affects skill gain and decay. Lower numbers in the last three slots make decay occur faster ([SKILL_RATES:100:1:1:1] would cause rapid decay). The counter rates may also be replaced with NONE.
Default is [SKILL_RATES:100:8:16:16]. Requires {{token|CAN_LEARN|c}} or {{token|INTELLIGENT|c}} to function.

|-
| {{text anchor|SKILL_RUST_RATE}}
| Caste
|
*[[skill_token]]
*value
*value
*value
| The rate at which this skill decays. Lower values cause the skill to decay faster. Requires {{token|CAN_LEARN|c}} or {{token|INTELLIGENT|c}} to function.

|-
| {{text anchor|SKILL_RUST_RATES}}
| Caste
|
*value
*value
*value
| The rate at which all skills decay. Lower values cause the skills to decay faster. Requires {{token|CAN_LEARN|c}} or {{token|INTELLIGENT|c}} to function.

|-
| {{text anchor|SLAIN_CASTE_SPEECH}}
| Caste
|
*[[Speech file|text set]]
| Caste-specific {{token|SLAIN_SPEECH|c}}.

|-
| {{text anchor|SLAIN_SPEECH}}
| Creature
|
*[[Speech file|text set]]
| Boasting speeches relating to killing this creature. Examples include [[text_dwarf.txt/raw|text_dwarf.txt]] (<code>[SLAIN_SPEECH:SLAIN_DWARF]</code>) and text_elf.txt (<code>[SLAIN_SPEECH:SLAIN_ELF]</code>) in data\vanilla\vanilla_creatures\objects.

|-
| {{text anchor|SLOW_LEARNER}}
| Caste
|
| Shorthand for {{token|CAN_LEARN|c}} + <code>[[Creature_token#SKILL_LEARN_RATES|[SKILL_LEARN_RATES:50]]]</code>.{{verify}} Used by a number of 'primitive' creatures (like [[ogre]]s, [[giant]]s and [[troglodyte]]s) in the vanilla game. Applicable to player races. Prevents a player from recruiting nobility, even basic ones. Subterranean creatures with this token combined with {{token|EVIL|c}} will become servants of goblins in their civilizations, in the style of [[troll]]s.

|-
| {{text anchor|SMALL_REMAINS}}
| Caste
|
| Creature leaves "[[item token#REMAINS|remains]]" instead of a corpse. Used by [[vermin]].

|-
| {{text anchor|SMELL_TRIGGER}}
| Caste
|
*value
| Determines how keen a creature's sense of smell is - lower is better. At 10000, a creature cannot smell at all.

|-
| {{text anchor|SOLDIER_ALTTILE}}
| Creature
|
*'character' or tile number
| If this creature is active in its civilization's military, it will blink between its default tile and this one.

|-
| {{text anchor|SOUND}}
| Caste
|
* Sound application (currently accepts ALERT or PEACEFUL_INTERMITTENT)
* Sound range (in tiles)
* Sound delay (lower values = sound is produced more often)
* VOCALIZATION or NONE (determines whether the sound requires breathing or not)
* First-person description
* Third-person description
* Description when out of sight
| Creature makes sounds periodically, which can be heard in Adventure mode.
* First-person reads "You '''bark'''"
* Third-person reads "The [[capybara]] '''barks'''"
* Out of sight reads "You hear '''a loud bark'''"
with the text in bold being the description arguments of the token.

|-
| {{text anchor|SOURCE_HFID}}
| Creature
|
*Integer
| Found on generated [[angel]]s. This is the historical figure ID of the deity with which the angel is associated. Since HFIDs are not predictable before worldgen, this isn't terribly usable in mods.

|-
| {{text anchor|SPECIFIC_FOOD}}
| Caste
|
* PLANT or CREATURE
* Plant/creature ID
| Creature will only appear in biomes with this plant or creature available. Grazers given a specific type of grass (such as [[panda]]s and [[bamboo]]) will only eat that grass and nothing else, risking starvation if there's none available.

|-
| {{text anchor|SPHERE}}
| Creature
|
* [[Sphere#Available_spheres|sphere]]
| Sets what religious spheres the creature is aligned to, for purposes of being worshipped via the {{token|POWER|c}} token. Also affects the creature's name.

|-
| {{text anchor|SPOUSE_CONVERSION_TARGET}}
| Caste
|
| This creature can be converted by a night creature with {{token|SPOUSE_CONVERTER|c}}.

|-
| {{text anchor|SPOUSE_CONVERTER}}
| Caste
|
| If the creature has the {{token|NIGHT_CREATURE_HUNTER|c}} tag, it will kidnap {{token|SPOUSE_CONVERSION_TARGET|c}}s and transform them into the caste of its species with the {{token|CONVERTED_SPOUSE|c}} tag during worldgen. It may also start families this way.

|-
| {{text anchor|SPREAD_EVIL_SPHERES_IF_RULER}}
| Caste
|
| If the creature rules over a [[site]], it will cause the local landscape to be corrupted into [[Surroundings#Evil|evil surroundings]] associated with the creature's [[Creature_token#SPHERE|sphere]]s. The creature must have at least one of the following [[sphere]]s for this to take effect: BLIGHT, DEATH, DISEASE, DEFORMITY, NIGHTMARES. The first three kill vegetation, while the others sometimes do. The last two get [[Plant_token#EVIL|evil plants]] and [[Creature_token#EVIL|evil animals]] sometimes. NIGHTMARES gets [[bogeyman|bogeymen]]. [http://www.bay12forums.com/smf/index.php?topic=169696.msg8162224#msg8162224] Used by [[demon]]s in the vanilla game.

|-
| {{text anchor|STANCE_CLIMBER}}
| Caste
|
| Caste does not require <code>[[Body_token#GRASP|[GRASP]]]</code> body parts to climb -- it can climb with <code>[[Body_token#STANCE|[STANCE]]]</code> parts instead.

|-
| {{text anchor|STANDARD_GRAZER}}
| Caste
|
| Acts as {{token|GRAZER|c}} but set to 20000*G*(max size)^(-3/4), where G defaults to 100 but can be set in d_init, and the whole thing is trapped between 150 and 3 million. Used for all grazers in the default creature raws.

|-
| {{text anchor|STRANGE_MOODS}}
| Caste
|
| The creature will get [[strange mood]]s in fortress mode and can produce artifacts.

|-
| {{text anchor|SUPERNATURAL}}
| Caste
|
| Gives the creature knowledge of any secrets with <code>[[Interaction_token#IS_SECRET|[SUPERNATURAL_LEARNING_POSSIBLE]]]</code> that match its [[Creature_token#SPHERE|spheres]] and also prevents it from becoming a [[vampire]] or [[werebeast]]. Other effects are unknown.

|-
| {{text anchor|SWIMS_INNATE}}
| Caste
|
| The creature naturally knows how to swim perfectly and does not use the [[swimmer]] skill, as opposed to {{token|SWIMS_LEARNED|c}} below. However, Fortress mode AI never paths into water anyway, so it's less useful there.

|-
| {{text anchor|SWIMS_LEARNED}}
| Caste
|
| The creature swims only as well as their present [[Swimmer|swimming skill]] allows them to.

|-
| {{text anchor|SYNDROME_DILUTION_FACTOR}}
| Caste
| <[[Syndrome#SYN_IDENTIFIER|syndrome identifier]]>:<percentage>
| Dilutes the effects of syndromes which have the specified identifier. A percentage of 100 is equal to the regular syndrome effect severity, higher percentages reduce severity.
|}

{{alphabetical TOC|style=margin: 1em auto;}}

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

|-
| {{text anchor|TENDONS}}
| Caste
|
* [[material token]]
*healing rate
| The creature has tendons in its {{token|CONNECTIVE_TISSUE_ANCHOR|td}} tissues (bone or chitin by default). Cutting the bone/chitin tissue severs the tendons, disabling motor function if the target is a limb.

|-
| {{text anchor|THICKWEB}}
| Caste
|
| The creature's [[web]]s can catch larger creatures.

|-
| {{text anchor|TISSUE}}
| Creature
|
*name
| Begins defining a tissue in the creature file. Follow this with standard tissue definition tokens to define the tissue properties.

|-
| {{text anchor|TISSUE_LAYER}}
| Caste
|
*BY_TYPE, BY_CATEGORY, BY_TOKEN
*TYPE,CATEGORY, or TOKEN
*TISSUE
*LOCATION
| Adds the tissue layer to wherever it is required.
Non-argument Locations can be FRONT, RIGHT, LEFT, TOP, BOTTOM. Argument locations are AROUND and CLEANS, requiring a further body part and a % of coverage/cleansing

|-
| {{text anchor|TISSUE_LAYER_OVER}}
| Caste
|
*BY_TYPE, BY_CATEGORY, BY_TOKEN
*TYPE,CATEGORY, or TOKEN
*TISSUE
*LOCATION
| Alias for TISSUE_LAYER

|-
| {{text anchor|TISSUE_LAYER_UNDER}}
| Caste
|
*BY_TYPE, BY_CATEGORY, BY_TOKEN
*TYPE,CATEGORY, or TOKEN
*TISSUE
| Adds the tissue layer under a given part.
For example, an [[iron man]] has a gaseous poison within, and this tissue (GAS is its name) has the token [TISSUE_LEAKS] and its state is GAS, so when you puncture the iron outside and damage this tissue it leaks gas (can have a syndrome by using a previous one in the creature sample.) [TISSUE_LAYER_UNDER:BY_CATEGORY:ALL:{tissue}] {tissue} is what will be under the TISSUE_LAYER; here is an example Tissue from the 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]

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

|-
| {{text anchor|TRADE_CAPACITY}}
| Caste
|
*number
| How much the creature can carry when used by merchants. 1000 by default. Completely ignored if the animal does not also have PACK_ANIMAL or WAGON, instead using BODY_SIZE^(2/3)/20, even if they're a pack animal due to ANIMAL_ALWAYS_PACK_ANIMAL.

|-
| {{text anchor|TRAINABLE}}
| Caste
|
| Shortcut for {{token|TRAINABLE_HUNTING|c}} + {{token|TRAINABLE_WAR|c}}.

|-
| {{text anchor|TRAINABLE_HUNTING}}
| Caste
|
| Can be [[Animal trainer|trained]] as a hunting beast, increasing speed.

|-
| {{text anchor|TRAINABLE_WAR}}
| Caste
|
| Can be [[Animal trainer|trained]] as a war beast, increasing strength and endurance.

|-
| {{text anchor|TRANCES}}
| Caste
|
| Allows the creature to go into [[martial trance]]s. Used by dwarves in the vanilla game.

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

|-
| {{text anchor|TRIGGERABLE_GROUP}}
| Creature
|
*min
*max
| A large swarm of vermin can be disturbed, usually in adventurer mode.

|-
| {{text anchor|TSU_NOUN}}
| Caste
|
*noun
*SINGULAR or PLURAL
| Noun for the {{token|TISSUE_STYLE_UNIT|c}}, used in the description of the tissue layer's style.
|}

{{alphabetical TOC|style=margin: 1em auto;}}

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

|-
| {{text anchor|UBIQUITOUS}}
| Creature
|
| Creature will occur in every region with the correct biome. Does not apply to {{token|EVIL|c}}/{{token|GOOD|c}} tags. Supersedes {{token|FREQUENCY|c}} for the purposes of distributing populations through the map, they are present in every part of the valid biome. Respects {{token|FREQUENCY|c}} for the frequency of unit [[Creature token#CLUSTER_NUMBER|cluster]] spawns being of this species.

|-
| {{text anchor|UNDERGROUND_DEPTH}}
| Creature
|
*mindepth
*maxdepth
| Depth that the creature appears underground. Numbers can be from 0 to 5. 0 is actually 'above ground' and can be used if the creature is to appear both above and below ground. Values from 1-3 are the respective [[cavern]] levels, 4 is the [[magma sea]] and 5 is the [[HFS]]. A single argument may be used instead of min and max. [[Demon]]s use only 5:5; user-defined creatures with both this depth and {{token|FLIER}} will take part in the initial wave from the HFS alongside generated demons, but without {{token|FLIER}} they will only spawn from the map edges. Civilizations that can use underground plants or animals will only export (via the embark screen or caravans) things that are available at depth 1.

|-
| {{text anchor|UNDERSWIM}}
| Caste
|
| The creature is displayed as blue when in [[Water#Depth|7/7 water]]. Used on fish and amphibious creatures which swim under the water.

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

|-
| {{text anchor|USE_CASTE}}
| Creature
|
*new caste token
*old caste token
| Defines a new caste derived directly from a previous caste. The new caste inherits all properties of the old one. The effect of this tag is automatic if one has not yet defined any castes: "Any caste-level tag that occurs before castes are explicitly declared is saved up and placed on any caste that is declared later, unless the caste is explicitly derived from another caste."
Roostre: "When DF detects duplicate tokens in the raws of the same object, a failsafe seems to kick in; it takes the bottom-most of the duplicates, and disregards the others. In the case of tokens added by a mod, it prioritizes the duplicate in the mod." This means that if a tag is defined in the base-caste and redefined in the derived caste, the derived tag overwrites the base tag.

|-
| {{text anchor|USE_MATERIAL}}
| Creature
|
*new material ID
*old material ID
| Defines a new local creature material and populates it with all properties defined in the specified local creature material.

|-
| {{text anchor|USE_MATERIAL_TEMPLATE}}
| Creature
|
*new material token
*material template
| Defines a new local creature material and populates it with all properties defined in the specified template. [http://www.bay12forums.com/smf/index.php?topic=175437.msg8441368#msg8441368 There seems to be a limit of 200 materials per creature].

|-
| {{text anchor|USE_TISSUE}}
| Creature
|
*new tissue token
*old tissue id
| Defines a new local creature tissue and populates it with all properties defined in the local tissue specified in the second argument.

|-
| {{text anchor|USE_TISSUE_TEMPLATE}}
| Creature
|
*new tissue token
*tissue template
| Loads a tissue template listed in OBJECT:TISSUE_TEMPLATE files, such as tissue_template_default.txt.

|-
| {{text anchor|UTTERANCES}}
| Creature
|
| Changes the language of the creature into unintelligible 'kobold-speak', which creatures of other species will be unable to understand. If a civilized creature has this and is not part of a {{token|SKULKING|e}} civ, it will tend to start wars with all nearby civilizations and will be unable to make peace treaties due to 'inability to communicate'.
|}

{{alphabetical TOC|style=margin: 1em auto;}}

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

|-
| {{text anchor|VEGETATION}}
| Caste
|
| Like {{token|AT_PEACE_WITH_WILDLIFE}}, but also makes the creature more valued in artwork by civilisations with the PLANT [[sphere]]. [http://www.bay12forums.com/smf/index.php?topic=169696.msg8316954#msg8316954] Used by [[grimeling]]s in the vanilla game.

|-
| {{text anchor|VERMIN_BITE}}
| Caste
|
*chance of occurrence{{verify}}
*verb (bitten, stung, etc.)
* [[material token]]
* [[Material_definition_token#Material_States|material state]]
| Enables vermin to bite other creatures, injecting the specified material. See {{token|SPECIALATTACK_INJECT_EXTRACT|c}} for details about injection - this token presumably works in a similar manner.{{verify}}

|-
| {{text anchor|VERMIN_EATER}}
| Creature
|
| The vermin creature will attempt to eat exposed food. See {{token|PENETRATEPOWER|c}}. Distinct from {{token|VERMIN_ROTTER|c}}.

|-
| {{text anchor|VERMIN_FISH}}
| Creature
|
| The vermin appears in [[water]] and will attempt to swim around.

|-
| {{text anchor|VERMIN_GROUNDER}}
| Creature
|
| The creature appears in "general" surface ground locations. Note that this doesn't stop the creature from flying if it can (most vermin birds have this tag).

|-
| {{text anchor|VERMIN_HATEABLE}}
| Caste
|
| Some dwarves will [[Preferences|hate]] the creature and get unhappy thoughts when around it. See the [[Hateable|list of hateable vermin]] for details.

|-
| {{text anchor|VERMIN_MICRO}}
| Caste
|
| This makes the creature move in a swarm of creatures of the same race as it (e.g. swarm of flies, swarm of ants).

|-
| {{text anchor|VERMIN_NOFISH}}
| Caste
|
| The creature cannot be caught by [[fishing]].

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

|-
| {{text anchor|VERMIN_NOTRAP}}
| Caste
|
| The creature cannot be caught in baited [[animal trap]]s; however, a "[[Trapper|catch live land animal]]" task may still be able to capture one if a dwarf finds one roaming around.

|-
| {{text anchor|VERMIN_ROTTER}}
| Creature
|
| The vermin are attracted to rotting stuff and loose food left in the open and cause unhappy thoughts to dwarves who encounter them. Present on flies, knuckle worms, acorn flies, and blood gnats.

|-
| {{text anchor|VERMIN_SOIL}}
| Creature
|
| The creature randomly appears near dirt or mud, and may be uncovered by creatures that have the {{token|ROOT_AROUND|c}} interaction such as [[goose|geese]] and [[chicken]]s. Dwarves will ignore the creature when given the "Capture live land animal" task.

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

|-
| {{text anchor|VERMINHUNTER}}
| Caste
|
| Old shorthand for "does cat stuff". Contains {{token|AT_PEACE_WITH_WILDLIFE|c}} + {{token|RETURNS_VERMIN_KILLS_TO_OWNER|c}} + {{token|HUNTS_VERMIN|c}} + {{token|ADOPTS_OWNER|c}}.

|-
| {{text anchor|VESPERTINE}}
| Caste
|
| When set, the creature will only appear in the evening (between 8:00 PM and 10:05 PM) in [[Adventurer mode]].

|-
| {{text anchor|VIEWRANGE}}
| Caste
|
*value
| Value should determine how close you have to get to a critter before it attacks (or prevents adv mode travel etc.) Default is 20.

|-
| {{text anchor|VISION_ARC}}
| Caste
|
*binocular vision arc
*non-binocular vision arc
| The width of the creature's vision arcs, in degrees (i.e. 0 to 360). The first number is binocular vision, the second is non-binocular vision. Binocular vision has a minimum of about 10 degrees, monocular, a maximum of about 350 degrees. Values past these limits will be accepted, but will default to ~10 degrees and ~350 degrees respectively. Defaults are 60:120.
|}

{{alphabetical TOC|style=margin: 1em auto;}}

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

|-
| {{text anchor|WAGON_PULLER}}
| Caste
|
| Allows the creature to pull caravan wagons. If a civilization doesn't have access to any, it is restricted to trading with pack animals.

|-
| {{text anchor|WEBBER}}
| Caste
|
* [[material token]]
| Allows the creature to create [[web]]s, and defines what the webs are made of.

|-
| {{text anchor|WEBIMMUNE}}
| Caste
|
| The creature will not get caught in thick [[web]]s. Used by creatures who can shoot thick webs (such as [[giant cave spider]]s) in order to make them immune to their own attacks.
|}

==Attack Tokens==

Attacks can use four different part selection criteria. Except for TISSUE_LAYER, the base game makes use of all of these in its attacks.

{| {{prettytable}}
|- bgcolor="#ddd"
! width="20%" | Part type token
! width="30%" | Arguments
! width="60%" | Description

|-
| {{text anchor|BODYPART}}
|
* BY_TYPE/BY_TOKEN/BY_CATEGORY
* type/token/category
| This attack uses a particular body part; for example, ATTACK:PUNCH:BODYPART:BY_TYPE:GRASP will make it use any part that can hold onto an object.

|-
| {{text anchor|TISSUE_LAYER}}
|
* BY_TYPE/BY_TOKEN/BY_CATEGORY
* type/token/category
* tissue layer
| This attack uses a specific tissue layer on a specific body part; ATTACK:SCRATCH:TISSUE_LAYER:BY_TYPE:GRASP:BONE will make it use the bone of the hands.

|-
| {{text anchor|CHILD_BODYPART_GROUP}}
|
* BY_TYPE/BY_TOKEN/BY_CATEGORY
* type/token/category
* BY_TYPE/BY_TOKEN/BY_CATEGORY
* type/token/category
| Uses a body part that is subordinate to another; ATTACK:SLAP:CHILD_BODYPART_GROUP:BY_CATEGORY:ARM_LOWER:BY_TYPE:GRASP will make it use every hand attached to each lower arm (so it will generate one attack per lower arm, each of which will use every hand on that arm, assuming there are multiple hands per arm).

|-
| {{text anchor|CHILD_TISSUE_LAYER_GROUP}}
|
* BY_TYPE/BY_TOKEN/BY_CATEGORY
* type/token/category
* BY_TYPE/BY_TOKEN/BY_CATEGORY
* type/token/category
* tissue layer
| As CHILD_BODYPART_GROUP, but specifying a tissue, too; ATTACK:BITE:CHILD_BODYPART_GROUP:BY_CATEGORY:HEAD:BY_CATEGORY:TOOTH

|}

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

|-
| {{text anchor|ATTACK_SKILL}}
| Caste
|
*[[Skill token]]
| Defines the skill used by the attack.

|-
| {{text anchor|ATTACK_VERB}}
| Caste
|
*2nd person
*3rd person
| Descriptive text for the attack.

|-
| {{text anchor|ATTACK_CONTACT_PERC}}
| Caste
|
*% value
| The contact area of the attack, measured in % of the body part's volume. Note that all attack percentages can be more than 100%.

|-
| {{text anchor|ATTACK_PENETRATION_PERC}}
| Caste
|
*% value
| The penetration value of the attack, measured in % of the body part's volume. Requires ATTACK_FLAG_EDGE. Maximum value: 15000.

|-
| {{text anchor|ATTACK_PRIORITY}}
| Caste
|
*MAIN or SECOND
| Usage frequency. MAIN attacks are 100 times more frequently chosen than SECOND. Opportunity attacks ignore this preference.

|-
| {{text anchor|ATTACK_VELOCITY_MODIFIER}}
| Caste
|
*number
| The velocity multiplier of the attack, multiplied by 1000.

|-
| {{text anchor|ATTACK_FLAG_CANLATCH}}
| Caste
|
| Attacks that damage tissue have the chance to latch on in a wrestling hold. The grabbing bodypart can then use the "shake around" wrestling move, causing severe, armor-bypassing tensile damage according to the attacker's body volume.

|-
| {{text anchor|ATTACK_FLAG_WITH}}
| Caste
|
| Displays the name of the body part used to perform an attack while announcing it, e.g. "The weaver punches the bugbat with his right hand".

|-
| {{text anchor|ATTACK_FLAG_EDGE}}
| Caste
|
| The attack is edged, with all the effects on physical resistance and contact area that it entails.

|-
| {{text anchor|ATTACK_PREPARE_AND_RECOVER}}
| Caste
|
* Preparation time
* Recovery time
| Determines the length of time to prepare this attack and until one can perform this attack again. Values appear to be calculated in adventure mode ticks.

|-
| {{text anchor|ATTACK_FLAG_BAD_MULTIATTACK}}
| Caste
|
| Multiple strikes with this attack cannot be performed effectively.

|-
| {{text anchor|ATTACK_FLAG_INDEPENDENT_MULTIATTACK}}
| Caste
|
| Multiple strikes with this attack can be performed with no penalty. The creature will use all attacks with this token at once.

|-
| {{text anchor|SPECIALATTACK_INJECT_EXTRACT}}
| Caste
|
*<[[material token]]>
*<[[Material_definition_token#Material_States|material state]]>
*<min quantity>
*<max quantity>
| When added to an attack, causes the attack to inject the specified material into the victim's bloodstream. Once injected, the material will participate in [[temperature|thermal]] exchange within the creature - injecting something like molten [[iron]] (INORGANIC:IRON:LIQUID) would cause most unmodded creatures to melt (note that some of the injected material also [[contaminant|splatters]] over the bodypart used to carry out the attack, so it should be protected appropriately). If the injected material has an associated [[syndrome]] with the [[Syndrome#SYN_INJECTED|[SYN_INJECTED]]] token, it will be transmitted to the victim. If the attack is blunt, the injected material lacks the [[Material definition token#ENTERS_BLOOD|[ENTERS_BLOOD]]] token, the attacked bodypart has no [[Tissue_definition_token#VASCULAR|[VASCULAR]]] tissues, or the victim is bloodless, the material will splatter over the attacked body part instead.

|-
| {{text anchor|SPECIALATTACK_INTERACTION}}
| Caste
|
*interaction
| When this attack lands successfully, a specified interaction will take effect on the target creature. The attack must break the target creature's skin in order to work. This will take effect in worldgen as well. If the attack would break skin, the interaction will occur '''before the attack actually lands'''.

|-
| {{text anchor|SPECIALATTACK_SUCK_BLOOD}}
| Caste
|
*min
*max
| Successful attack draws out an amount of blood randomized between the min and max value. Beware that this '''will''' trigger any ingestion syndromes attached to the target creature's blood - for example, using this attack on a vampire will turn you into one too.
|}

==Tissue Layer Tokens==
Tissue layers are added to a creature's body parts by the creature tokens [[#TISSUE_LAYER|TISSUE_LAYER]], [[#TISSUE_LAYER_OVER|TISSUE_LAYER_OVER]], [[#TISSUE_LAYER_UNDER|TISSUE_LAYER_UNDER]], and the body detail plan token [[#TL_LAYERS|TL_LAYERS]].

These tissue layers are not the same thing as tissues, which are defined at creature level, but rather applications of the tissues. If the SKIN tissue of a creature is the more general and abstract notion of what skin is for that creature, then a tissue layer may be the "actual" skin on the creature's nose, head, or second toe. As most creatures have more than one body part, tissue layers are normally selected en masse.

Some tissue layer tokens are analogous to tissue definition tokens, e.g. [[#TL_CONNECTS|TL_CONNECTS]] to [[tissue_definition_token#CONNECTS|CONNECTS]].

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

|-
| {{text anchor|SELECT_TISSUE_LAYER}}
| Caste
|
*TISSUE
*BY_CATEGORY, BY_TYPE, BY_TOKEN
*Location - category, type, or token | Selects a tissue at a location
* (optional) FRONT, BACK, LEFT, RIGHT, TOP, BOTTOM, AROUND.
| Begins a selection of tissue layers.
[SELECT_TISSUE_LAYER:HEART:BY_TYPE:HEART]

|-
| {{text anchor|PLUS_TISSUE_LAYER}}
| Caste
|
*TISSUE
*BY_CATEGORY, BY_TYPE, BY_TOKEN
*Location - category, type, or token
| Adds tissue layers to those selected.

|-
| {{text anchor|SET_TL_GROUP}}
| Caste
|
*TISSUE
*BY_CATEGORY, BY_TYPE, BY_TOKEN
*Location - category, type, or token
*tissue
| Begins a selection of tissue layers. Only usable for descriptor and cosmetic purposes.

Research has implied it may be redundant with SELECT_TISSUE_LAYER, as the latter allows for cosmetics as well as "functional" tokens such as TL_MAJOR_ARTERIES. Vanilla raws still use SET_TL_GROUP though, for all cosmetic purposes. More research is needed on this subject.

|-
| {{text anchor|PLUS_TL_GROUP}}
| Caste
|
*BY_CATEGORY, BY_TYPE, BY_TOKEN
*Location - category, type, or token
*tissue
| Adds tissue layers to those selected. Like SET_TL_GROUP, it may be redundant even if used in the vanilla raws.

|-
| {{text anchor|SET_LAYER_TISSUE}}
| Caste
|
*TISSUE
| Sets a selected tissue layer to be made of a different tissue.

|-
| {{text anchor|SHEARABLE_TISSUE_LAYER}}
| Caste
|
* tissue modifier
* required value
| Tissue layer can be sheared for its component material. The specified modifier must be at least of the desired value for shearing to be possible (for example, a [[llama]]'s wool must have a LENGTH of 300 before it is shearable).

|-
| {{text anchor|TISSUE_LAYER_APPEARANCE_MODIFIER}}
| Caste
|
*QUALITY
*lowest
*lower
*low
*median
*high
*higher
*highest
| Sets the range of qualities, including LENGTH, DENSE, HIGH_POSITION, CURLY, GREASY, WRINKLY

|-
| {{text anchor|TISSUE_STYLE_UNIT}}
| Caste
|
*tissue style unit ID
*shaping
| Sets tissue layer to be the target of TISSUE_STYLE token specified for an entity, works only on entity members. Mostly used with tissues HAIR, BEARD, MOUSTACHE, SIDEBURNS.

|-
| {{text anchor|TL_COLOR_MODIFIER}}
| Caste
|
*COLOR
*freq
*COLOR
*freq etc.
| Creates a list of colors/color patterns, giving each a relative frequency. If the given color or pattern does not exist, the tissue is described as being "transparent".

|-
| {{text anchor|TLCM_GENETIC_MODEL}}
| Caste
|
| The way the color modifier is passed on to offspring. May or may not work right now.{{verify}}

|-
| {{text anchor|TLCM_IMPORTANCE}}
| Caste
|
*number
| Presumably modifies the importance of the tissue layer color modifier, for description purposes.
HOWEVER using this appears to remove all mention of colour from creature descriptions. It does not appear in any default creatures.

|-
| {{text anchor|TLCM_NOUN}}
| Caste
|
*name
*SINGULAR or PLURAL
| Names the tissue layer color modifier, and determines the noun. Also used by [[Utility:Stonesense|Stonesense]] for colouring body parts.

|-
| {{text anchor|TLCM_TIMING}}
| Caste
|
*ROOT
*start change window years
*days
*end change window years
*days
| Determines the point in the creature's life when the color change begins and ends.

|-
| {{text anchor|TL_CONNECTS}}
| Caste
|
| Gives the CONNECTS attribute to selected layers.

|-
| {{text anchor|TL_HEALING_RATE}}
| Caste
|
*value
| Changes the HEALING_RATE of the selected tissue layers.

|-
| {{text anchor|TL_MAJOR_ARTERIES}}
| Caste
|
| Gives the "major arteries" attribute to selected layers. Used to add massive bleeding properties to the throat, made from skin.

|-
| {{text anchor|TL_PAIN_RECEPTORS}}
| Caste
|
*value
| Changes the number of pain receptors for selected tissue layers.

|-
| {{text anchor|TL_RELATIVE_THICKNESS}}
| Caste
|
*value
| Changes the relative thickness for selected tissue layers.

|-
| {{text anchor|TL_VASCULAR}}
| Caste
|
*value
| Sets a new VASCULAR value (which modulates bleeding) for selected tissue layers.

|}

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

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

Creature token

2025-06-23T23:44:11Z

DikbutDaGrate: Inspected verification request on demon tag - info was false.

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

The <code>[OBJECT:CREATURE]</code> [[token]] begins the definition of a ''Dwarf Fortress'' [[creature]] [[raw file]]. Each creature definition that follows begins with the {{token|creature|c|creature ID}} token, and the creature's exact properties and behavior are then specified by the use of further creature tokens. All known creature tokens are listed below.

Vanilla creature definitions can be found in <code>[[Game folder|<Dwarf Fortress>]]\data\vanilla\vanilla_creatures\</code>.
Creature ID is also used with [[graphics token]]s to make customizable [[graphics set]]s.

The [[caste]] tokens allow defining sub-species within the broader creature definition, including true biological castes and lesser variations, such as sexes. Creature tokens can either be 'Creature' or 'CASTE-only' type which can only be applied to creature or caste respectively, or 'CASTE' which can be applied to both. In the table bellow, creature type distinguishes tokens that can be applied to creature only, caste only, and both ('creature', 'CASTE-only', and 'CASTE' respectively)

__NOTOC__
{{clear}}
{{alphabetical TOC|style=margin: 1em auto;}}

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

|-
| {{text anchor|ADOPTS_OWNER}}
| Caste
|
| Prevents the tamed creature from being made available for adoption, instead allowing it to automatically adopt whoever it wants. The basic requirements for adoption are intact, and the creature will only adopt individuals who have a [[preference]] for their species. Used by [[cat]]s in the vanilla game. When {{k|v}}iewing a tame creature with this token, the message "This animal isn't interested in your wishes" will appear instead of "This [adorable] animal can't work" or "This animal is waiting to be trained".

|-
| {{text anchor|ALCOHOL_DEPENDENT}}
| Caste
|
| Makes the creature need [[alcohol]] to get through the working day; it will choose to drink booze instead of [[water]] if possible. Going sober for too long reduces speed.

|-
| {{text anchor|ALL_ACTIVE}}
| Caste
|
| When set, the creature will appear at any time of day. Overrides {{token|DIURNAL|c}}, {{token|NOCTURNAL|c}}, {{token|CREPUSCULAR|c}}, {{token|MATUTINAL|c}}, and {{token|VESPERTINE|c}}.

|-
| {{text anchor|ALTTILE}}
| Creature
|
*'character' or tile number
| If set, the creature will blink between its {{token|TILE|c}} and its ALTTILE.

|-
| {{text anchor|AMBUSHPREDATOR}}
| Caste
|
| Makes the creature start out hidden and remain near its original location until its prey draws near. When combined with {{token|WEBBER|c}}, causes them to lay gigantic webs near their spawn location, though only for creatures present during embark.

|-
| {{text anchor|AMPHIBIOUS}}
| Caste
|
| Allows a creature to breathe both in and out of [[water]] (unlike {{token|AQUATIC|c}}) - does not prevent drowning in [[magma]].

|-
| {{text anchor|APP_MOD_DESC_RANGE}}
| Appearance Modifier
|
*Range (6 values, low to high)
| Based on info from [http://www.bay12forums.com/smf/index.php?topic=113762.msg3473069#msg3473069 Wannabehero on the forums]: When used with an appearance modifier token (BP_APPEARANCE_MODIFIER or BODY_APPEARANCE_MODIFIER), tells the game what numeric ranges to map to which descriptors.

The game uses 7 descriptor levels for each modifier, with the center one generally being to omit the thing from the creature description entirely. The six values in APP_MOD_DESC_RANGE define the boundaries between each described range. If this is not specified it uses the numbers 10:50:95:105:150:190.

|-
| {{text anchor|APP_MOD_GENETIC_MODEL}}
| Appearance Modifier
|
*Model (Accepts DOMINANT_MORE, DOMINANT_LESS, and MIX)
| Defines a genetic model for the relevant appearance modifier(s). May or may not do anything significant at present.

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

|-
| {{text anchor|APP_MOD_NOUN}}
| Appearance Modifier
|
*noun
*SINGULAR or PLURAL
| Creates a noun for the appearance, and whether it is singular or plural.

|-
| {{text anchor|APP_MOD_RATE}}
| Appearance Modifier
|
*Rate (integer)
*Scale (DAILY, YEARLY)
*min (growth)
*max (growth)
*start year
*start day
*end year
*end day
| Setting the growth rate of the modifier. The last two tokens can be replaced by NO_END to have growth continue indefinitely.

|-
| {{text anchor|APPLY_CREATURE_VARIATION}}
| Caste
|
*creature variation ID
*(optional) any amount of arbitrary arguments
| Applies the specified [[creature variation token|creature variation]]. See [[Creature_variation_token#Arguments_and_conditional_tokens]] for how the subsequent arguments may be used.

|-
| {{text anchor|APPLY_CURRENT_CREATURE_VARIATION}}
| Special
|
| Applies the effects of all pending {{token|CV_ADD_TAG|c}} and {{token|CV_REMOVE_TAG|c}} tokens that have been defined in the current creature.

|-
| {{text anchor|AQUATIC}}
| Caste
|
| Enables the creature to breathe in water, but causes it to air-drown on dry land.

|-
| {{text anchor|ARENA_RESTRICTED}}
| Caste
|
| Causes the creature to be excluded from the [[object testing arena]]'s creature spawning list. Typically applied to spoileriffic creatures.

|-
| {{text anchor|ARTIFICIAL_HIVEABLE}}
| Creature
|
| Enables the creature to be kept in artificial [[hive]]s by [[beekeeper]]s.

|-
| {{text anchor|AT_PEACE_WITH_WILDLIFE}}
| Caste
|
| Prevents the creature from attacking or frightening creatures with the {{Token|NATURAL|c}} tag.

|-
| {{text anchor|ATTACK}}
| Caste
|
*token
*selection criteria (it's complicated)
| Defines the attack name, and the body part used. See [[#Attack Tokens|below]] for valid subtokens
'''Example:''' 
<code>[ATTACK:GORE:BODYPART:BY_CATEGORY:HORN]</code> 
''GORE'' = name of the attack 
''BODYPART:BY_CATEGORY:HORN'' = the horn is used to attack (presuming the creature has one)

|-
| {{text anchor|ATTACK_TRIGGER}}
| Caste
|
*population
*exported wealth
*created wealth
| Specifies when a [[megabeast]] or [[semi-megabeast]] will attack the fortress. The attacks will start occurring when all of the requirements are met. Setting a value to 0 disables the trigger.

|}

{{alphabetical TOC|style=margin: 1em auto;}}

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

|-
| {{text anchor|BABY}}
| Caste
|
*integer
| Age at which creature is considered a child, the default is zero. One can think of this as the duration of the baby stage.

|-
| {{text anchor|BABYNAME}}
| Caste
|
*singular
*plural
| Defines a new name for a creature in baby state at the caste level. For non-caste-specific baby names, see {{token|GENERAL_BABY_NAME|c}}.

|-
| {{text anchor|BEACH_FREQUENCY}}
| Caste
|
*integer
| Creature may be subject to [[beaching]], becoming stranded on [[Beach|shores]], where they will eventually air-drown. The number indicates the frequency of the occurrence. Presumably requires the creature to be {{token|AQUATIC|c}}. Used by [[orca]]s, [[sperm whale]]s and [[sea nettle jellyfish]] in the vanilla game.

|-
| {{text anchor|BENIGN}}
| Caste
|
| The creature is non-aggressive by default, and will never automatically be engaged by companions or soldiers, running away from any creatures that are not friendly to it, and will only defend itself if it becomes enraged. Can be thought of as the counterpoint of the {{token|LARGE_PREDATOR|c}} tag. When tamed, animals with this tag will be useless for fortress defense.

This and {{token|TRADE_CAPACITY|c}} are required for {{token|PACK_ANIMAL|c}} to function properly, if an animal contains the aforementioned requirements without this tag: items loaded by the merchants will be dropped upon departure.

|-
| {{text anchor|BIOME}}
| Creature
|
* [[biome token]]
| Select a [[biome]] the creature may appear in.

|-
| {{text anchor|BLOOD}}
| Caste
|
* <[[material token]]>
* <[[Material_definition_token#Material_States|material state]]>
| Specifies what the creature's blood is made of.

|-
| {{text anchor|BLOODSUCKER}}
| Caste
|
| Causes [[vampire]]-like behaviour; the creature will suck the [[Creature_token#BLOOD|blood]] of unconscious victims when its [[Syndrome#TIME_SINCE_SUCKED_BLOOD|thirst for blood]] grows sufficiently large. When controlling the creature in adventure mode, this can be done at will. Seems to be required to make the creature denouncable (in-world) as a creature of the night.

|-
| {{text anchor|BODY}}
| Caste
|
*body parts
| Draws body parts from OBJECT:BODY files (such as body_default.txt)
'''Example:''' 
[BODY:BODY_WITH_HEAD_FLAG:HEART:GUTS:BRAIN:MOUTH] 
This is the body from a [[purring maggot]]. It creates a body with head, a heart, some guts, a brain, and a mouth. That's all a maggot needs.

The body parts need to be listed in an order such that any parent part appears before its connected children. For example [BODY:HEART:BODY_WITH_HEAD_FLAG] produces a "Body Token Recognized But Could Not Connect: HEART" error because HEART can't find any UPPERBODY(s) to connect to. Switching the order to [BODY:BODY_WITH_HEAD_FLAG:HEART] fixes the problem because now the UPPERBODY is created before the HEART tries to connect to it.

'''If the body is left undefined, the creature (or caste) will be tagged as [DOES_NOT_EXIST].''' {{verify}}

|-
| {{text anchor|BODY_APPEARANCE_MODIFIER}}
| Caste
|
*ATTRIBUTE
*lowest
*lower
*low
*median
*high
*higher
*highest
| These body modifiers give individual creatures different characteristics. In the case of HEIGHT, BROADNESS and LENGTH, the modifier is also a percentage change to the BODY_SIZE of the individual creature. The seven numbers afterward give a distribution of ranges. Each interval has an equal chance of occurring.
'''Example:''' 
[BODY_APPEARANCE_MODIFIER:HEIGHT:90:95:98:100:102:105:110] 
''HEIGHT'' : marks the height to be changed 
''90:95:98:100:102:105:110'' : sets the range from the shortest (90% of the average height) to the tallest (110% of the average height) creature variation.

|-
| {{text anchor|BODY_DETAIL_PLAN}}
| Caste
|
*PlanName
*Arguments
| Loads a plan from 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:''' 
[BODY_DETAIL_PLAN:VERTEBRATE_TISSUE_LAYERS:SKIN:FAT:MUSCLE:BONE:CARTILAGE] 
This creates the detailed body of a [[fox]], the skin, fat, muscle, bones and cartilage out of the vertebrate tissues. 
A [[Purring maggot|maggot]] would only need: 
''[BODY_DETAIL_PLAN:EXOSKELETON_TISSUE_LAYERS:SKIN:FAT:MUSCLE]''

|-
| {{text anchor|BODY_SIZE}}
| Caste
|
*years
*days
*size
| Sets size at a given age. Size is in cubic centimeters, and for normal body materials, is roughly equal to the creature's average weight in grams.
'''Example:''' 
[BODY_SIZE:0:0:10000] 
[BODY_SIZE:1:168:50000] 
[BODY_SIZE:12:0:220000] 
This describes the size of a [[minotaur]]. Its birth size would be 10,000 cm3 (~10 kg). At 1 year and 168 days old it would be 50,000 cm3 (~50 kg). And as an adult (at 12 years old) it would be 220,000 cm3 and weigh roughly 220 kg.

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

|-
| {{text anchor|BONECARN}}
| Caste
|
| Creature eats bones. Implies {{token|CARNIVORE|c}}. [[Adventurer mode|Adventurers]] with this token are currently unable to eat bones.{{Bug|11069}}

|-
| {{text anchor|BP_ADD_TYPE}}
| Caste
|
| Adds a type to a body part - used with {{token|SET_BP_GROUP|c}}. In vanilla DF, this is used for adding the type '[[Body token#GELDABLE|GELDABLE]]' to the lower body of certain [[cat|creatures]].

|-
| {{text anchor|BP_APPEARANCE_MODIFIER}}
| Caste
|
*QUALITY
*lowest
*lower
*low
*median
*high
*higher
*highest
| Sets up the breadth of possibilities for appearance qualities for a selected BP group. EG. Eyes (CLOSE_SET, DEEP_SET, ROUND_VS_NARROW, LARGE_IRIS),Lips (THICKNESS), Nose (BROADNESS, LENGTH, UPTURNED, CONVEX), Ear (SPLAYED_OUT, HANGING_LOBES, BROADNESS, HEIGHT), Tooth (GAPS), Skull (HIGH_CHEEKBONES, BROAD_CHIN, JUTTING CHIN, SQUARE_CHIN), Neck (DEEP_VOICE, RASPY_VOICE), Head (BROADNESS, HEIGHT)

|-
| {{text anchor|BP_REMOVE_TYPE}}
| Caste
|
| Removes a type from a body part. Used with {{token|SET_BP_GROUP|c}}.

|-
| {{text anchor|BUILDINGDESTROYER}}
| Caste
|
*1 or 2
| Allows a creature to destroy furniture and buildings. Value [1] targets mostly doors, hatches, furniture and the like. Value [2] targets anything not made with the {{k|b}} + {{k|C}} commands.
|}

{{alphabetical TOC|style=margin: 1em auto;}}

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

|-
| {{text anchor|CAN_DO_INTERACTION}}
| Caste
|
*interaction token
| The creature can perform an interaction. See [[interaction token]].

|-
| {{text anchor|CAN_LEARN}}
| Caste
|
| The creature gains [[skill]]s and can have [[labor|professions]]. If a member of a civilization (even a pet) has this token, it'll need to eat, drink and sleep. Note that this token makes the creature unable to be eaten 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. A creature with at least this token or the {{token|CAN_SPEAK|c}} token will be able to have [[Personality value|values]] and [[Personality goal|goals]].

|-
| {{text anchor|CAN_SPEAK}}
| Caste
|
| Can [[talking|talk]]. Note that this is not necessary for a creature to gain social skills but to make friends in fortress mode. A creature with at least this token or the {{token|CAN_LEARN|c}} token will be able to have [[Personality value|values]] and [[Personality goal|goals]].

|-
| {{text anchor|CANNOT_CLIMB}}
| Caste
|
| Creature cannot [[climber|climb]], even if it has free grasp parts.

|-
| {{text anchor|CANNOT_JUMP}}
| Caste
|
| Creature cannot [[jump]].

|-
| {{text anchor|CANNOT_UNDEAD}}
| Caste
|
| Acts like {{token|NOT_LIVING|c}}, except that {{token|OPPOSED_TO_LIFE|c}} creatures will attack them.

|-
| {{text anchor|CANOPENDOORS}}
| Caste
|
| Defunct, as doors cannot be set as tightly closed anymore.

|-
| {{text anchor|CARNIVORE}}
| Caste
|
| Creature ''only'' eats [[meat]]. If the creature goes on rampages in worldgen, it will often devour the people/animals it kills.

|-
| {{text anchor|CASTE}}
| Creature
|
*name
| Defines a [[caste]].

|-
| {{text anchor|CASTE_ALTTILE}}
| Caste
|
*tile number or "letter"
| Caste-specific {{token|ALTTILE|c}}. Requires {{token|CASTE_TILE|c}}.

|-
| {{text anchor|CASTE_COLOR}}
| Caste
|
*fg
*bg
*brightness
| Caste-specific {{token|COLOR|c}}.

|-
| {{text anchor|CASTE_GLOWCOLOR}}
| Caste
|
*fg
*bg
*brightness
| Caste-specific {{token|GLOWCOLOR|c}}.

|-
| {{text anchor|CASTE_GLOWTILE}}
| Caste
|
*tile value or "letter"
| Caste-specific {{token|GLOWTILE|c}}.

|-
| {{text anchor|CASTE_NAME}}
| Caste
|
*singular
*plural
*adjective
| While {{token|NAME|c}} describes the name of the species, {{token|CASTE_NAME|c}} names individuals of the species. Unlike other caste-specific descriptions, this token is required, even for creatures without separate castes. If left undefined, the creature will not show up in the [[arena]] and members of the species will be labeled as "nothing".

|-
| {{text anchor|CASTE_PROFESSION_NAME}}
| Caste
|
*[[Unit type token]] (Profession)
*singular
*plural
| Caste-specific {{token|PROFESSION_NAME|c}}.

|-
| {{text anchor|CASTE_SOLDIER_ALTTILE}}
| Caste
|
*'character' or tile number
| Caste-specific {{token|SOLDIER_ALTTILE|c}}. Requires {{token|CASTE_SOLDIER_TILE|c}}.

|-
| {{text anchor|CASTE_SOLDIER_TILE}}
| Caste
|
*'character' or tile number
| Caste-specific {{token|CREATURE_SOLDIER_TILE|c}}.

|-
| {{text anchor|CASTE_TILE}}
| Caste
|
* tile number or "letter"
| Caste-specific {{token|CREATURE_TILE|c}}.

|-
| {{text anchor|CAVE_ADAPT}}
| Caste
|
| Causes the creature to develop [[cave adaptation]].

Allows for creature's race to be involved in jokes that end in "And the [race] saw the sun and vomited on the spot!"

|-
| {{text anchor|CDI}}
| Caste
|
*Varies
| Specifies interaction details following a {{token|CAN_DO_INTERACTION|c}} token. See [[interaction token]].

|-
| {{text anchor|CHANGE_BODY_SIZE_PERC}}
| Caste
|
*integer
| Multiplies body size by a factor of (integer)%. 50 halves size, 200 doubles.

|-
| {{text anchor|CHANGE_FREQUENCY_PERC}}
| Creature
|
*integer
| Multiplies frequency by a factor of (integer)%.

|-
| {{text anchor|CHILD}}
| Caste
|
*integer
| Age at which creature is considered an adult - one can think of this as the duration of the [[children|child]] stage. Allows the creature's offspring to be rendered fully tame if [[animal trainer|trained]] during their childhood.

|-
| {{text anchor|CHILDNAME}}
| Caste
|
*singular
*plural
| Defines a new name for a creature in the child state at the caste level. For non-caste-specific child names, see {{token|GENERAL_CHILD_NAME|c}}.

|-
| {{text anchor|CLUSTER_NUMBER}}
| Creature
|
*min
*max
| The minimum/maximum numbers of how many creatures per spawned cluster. Vermin fish with this token in combination with temperate ocean and river biome tokens [http://www.bay12forums.com/smf/index.php?topic=51864.msg1122319#msg1122319 will perform seasonal migrations]. Defaults to 1:1 if not specified.

|-
| {{text anchor|CLUTCH_SIZE}}
| Caste
|
*min
*max
|Number of [[egg]]s laid in one sitting.

|-
| {{text anchor|COLONY_EXTERNAL}}
| Caste
|
| Caste hovers around colony.

|-
| {{text anchor|COLOR}}
| Creature
|
*foreground
*background
*brightness
| Color of the creature's tile. (See [[Color]] for usage.)

|-
| {{text anchor|COMMON_DOMESTIC}}
| Caste
|
| When combined with any of {{token|PET|c}}, {{token|PACK_ANIMAL|c}}, {{token|WAGON_PULLER|c}} and/or {{token|MOUNT|c}}, the creature is guaranteed to be domesticated by any [[civilization]] with {{token|COMMON_DOMESTIC_PET|e}}, {{token|COMMON_DOMESTIC_PACK|e}}, {{token|COMMON_DOMESTIC_PULL|e}} and/or {{token|COMMON_DOMESTIC_MOUNT|e}} respectively. Such civilizations will always have access to the creature, even in the absence of wild populations. This token is invalid on {{token|FANCIFUL|c}} creatures.

|-
| {{text anchor|CONVERTED_SPOUSE}}
| Caste
|
| Creatures of this caste's species with the {{token|SPOUSE_CONVERTER|c}} and {{token|NIGHT_CREATURE_HUNTER|c}} tokens will kidnap {{token|SPOUSE_CONVERSION_TARGET|c}}s of an appropriate sex and convert them into castes with CONVERTED_SPOUSE.

|-
| {{text anchor|COOKABLE_LIVE}}
| Caste
|
| Set this to allow the creature to be cooked in meals while it is still alive, as well as when it's dead but not yet [[fishery|cleaned]]. Used by some water-dwelling vermin such as [[mussel]]s, [[nautilus]]es and [[oyster]]s. Currently does not work correctly when applied to non-{{token|FISHITEM|c}} vermin.{{bug|13200}}

|-
| {{text anchor|CRAZED}}
| Caste
|
| Creature is '[[insanity|berserk]]' and will attack all other creatures, except members of its own species that '''also''' have the CRAZED tag. It will show {{DFtext|Berserk|4:1}} in the [[unit list]]. Berserk creatures go on rampages during [[world generation|worldgen]] much more frequently than non-berserk ones.

|-
| {{text anchor|COPY_TAGS_FROM}}
| Special
|
*creature ID
| Copies another specified creature. This will override any definitions made before it; essentially, it makes this creature identical to the other one, which can then be modified. Often used in combination with {{token|APPLY_CREATURE_VARIATION|c}} to import standard variations from a file. The vanilla [[giant animal]]s and [[animal person|animal people]]s are examples of this token combination.

|-
| {{text anchor|CREATURE}}
| Creature
|
*creature ID
| A unique, arbitrary identifier that begins the definition of each new creature, and is used to reference the creature in other tokens and raws.

|-
| {{text anchor|CREATURE_CLASS}}
| Caste
|
*classname
| An arbitrary creature classification. Can be set to anything, but the only vanilla uses are GENERAL_POISON (used in syndromes), EDIBLE_GROUND_BUG (used as targets for {{token|GOBBLE_VERMIN_CLASS|c}}), MAMMAL, and POISONOUS (both used for kobold pet eligibility). A single creature can have multiple classes.

The full list of tokens that use creature classes is:

* Creature tokens: {{token|GOBBLE_VERMIN_CLASS|c}}, {{token|GOBBLE_VERMIN_CLASS|c}}
* Interaction tokens: {{token|IT_AFFECTED_CLASS|in}}, {{token|IT_IMMUNE_CLASS|in}}
* Animal definition (Entity) tokens: {{token|ANIMAL_CLASS|e}}, {{token|ANIMAL_FORBIDDEN_CLASS|e}}
* Position (Entity) token: {{token|ALLOWED_CLASS|po}}
* Syndrome tokens: {{token|SYN_AFFECTED_CLASS|sy}}, {{token|SYN_IMMUNE_CLASS|sy}}, {{token|CE_SENSE_CREATURE_CLASS|sy}}
|-
| {{text anchor|CREATURE_SOLDIER_TILE}}
| Creature
|
*'character' or tile number
| Creatures active in their civilization's [[military]] will use this tile instead.

|-
| {{text anchor|CREATURE_TILE}}
| Creature
|
*'character' or tile number
| The symbol of the creature in ASCII mode.

|-
| {{text anchor|CREPUSCULAR}}
| Caste
|
| When set, the creature will appear at dawn (between 4:30 AM and 6:00 AM) and in the evening (between 8:00 PM and 10:05 PM) in [[Adventurer mode]].

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

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

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

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

|-
| {{text anchor|CV_REMOVE_TAG}}
| Special
|
*TAG NAME
| Removes a tag. Used in conjunction with creature variation templates.
|}

{{alphabetical TOC|style=margin: 1em auto;}}

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

|-
| {{text anchor|DEMON}}
| Caste
|
| Found on generated [[demon]]s.

At least 1 demon generated, or custom must have the {{token|FLIER|c}} token in order for the [[Underworld|horrifying screams]] event to trigger.

|-
| {{text anchor|DESCRIPTION}}
| Caste
|
*text
| A brief description of the creature type, as displayed when viewing the creature's description/[[Thoughts and preferences|thoughts & preferences]] screen.

|-
| {{text anchor|DIE_WHEN_VERMIN_BITE}}
| Caste
|
| Causes the creature to die upon attacking. Used by [[honey bee]]s to simulate them dying after using their stingers.

|-
| {{text anchor|DIFFICULTY}}
| Caste
|
*integer
| Increases experience gain during adventure mode. Creatures with a difficulty of 11 or higher are not assigned for quests in adventure mode.

|-
| {{text anchor|DIURNAL}}
| Caste
|
| When set, the creature will only appear during the day (between 6:00 AM and 8:00 PM) in [[Adventurer mode]].

|-
| {{text anchor|DIVE_HUNTS_VERMIN}}
| Caste
|
| The creature hunts vermin by diving from the air. On tame creatures, it has the same effect as {{token|HUNTS_VERMIN|c}}. Found on [[peregrine falcon]]s.

|-
| {{text anchor|DOES_NOT_EXIST}}
| Creature
|
| Adding this token to a creature prevents it from appearing in generated worlds (unless it's marked as [[Entity_token#ANIMAL_ALWAYS_PRESENT|always present]] for a particular civilisation). For example, adding it to [[dog]]s will lead to worlds being generated without dogs in them. Also removes the creature from the [[object testing arena]]'s spawn list. If combined with {{token|FANCIFUL|c}}, artistic depictions of the creature will occur regardless. Used by [[centaur]]s, [[chimera]]s and [[griffon]]s in the vanilla game.

Note: a creature tagged as DOES_NOT_EXIST can still be [[Interaction_token#I_EFFECT|summoned]] successfully, as long as it has a body defined in its raws [http://www.bay12forums.com/smf/index.php?topic=165213.msg8086938#msg8086938], or, another creature can[[Syndrome#CE_BODY_TRANSFORMATION|transform]] into it.
|}

{{alphabetical TOC|style=margin: 1em auto;}}

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

|-
| {{text anchor|EBO_ITEM}}
| Caste
|
*[[item token]]
*[[material token]] (ANY_HARD_STONE can be used for the material)
| Defines the item that the creature drops upon being [[butcher|butchered]]. Used with {{token|EXTRA_BUTCHER_OBJECT|c}}.

|-
| {{text anchor|EBO_SHAPE}}
| Caste
|
*gem shape
| The shape of the creature's extra [[butcher|butchering]] drop. Used with {{token|EXTRA_BUTCHER_OBJECT|c}}.

|-
| {{text anchor|EGG_MATERIAL}}
| Caste
|
* <[[material token]]>
* <[[Material_definition_token#Material_States|material state]]>
| Defines the material composition of [[egg]]s laid by the creature. [[creature_token#LAYS_EGGS|Egg-laying]] creatures in the default game define this 3 times, using LOCAL_CREATURE_MAT:EGGSHELL, LOCAL_CREATURE_MAT:EGG_WHITE, and then LOCAL_CREATURE_MAT:EGG_YOLK. Eggs will be made out of eggshell. Edibility is determined by tags on whites or yolk, but they otherwise do not exist.

|-
| {{text anchor|EGG_SIZE}}
| Caste
|
*size
| Determines the size of laid [[egg]]s. Doesn't affect hatching or cooking, but bigger eggs will be heavier, and may take longer to be hauled depending on the hauler's strength.

|-
| {{text anchor|EQUIPMENT_WAGON}}
| Creature
|
| Makes the creature appear as a large 3×3 [[wagon]] responsible for carrying trade goods, pulled by two {{token|WAGON_PULLER|c}} creatures and driven by a merchant.

|-
| {{text anchor|EQUIPS}}
| Caste
|
| Allows the creature to wear or wield items.

|-
| {{text anchor|EVIL}}
| Creature
|
| The creature is considered evil and will only show up in evil biomes. Civilizations with {{token|USE_EVIL_ANIMALS|e}} can domesticate them regardless of exotic status. Has no effect on cavern creatures except to restrict taming. A civilization with evil creatures can colonise evil areas.

|-
| {{text anchor|EXTRA_BUTCHER_OBJECT}}
| Caste
|
* [[Body token#CATEGORY|BY_CATEGORY]] or [[Body token#CONTYPE|BY_TYPE]] or [[Body token#BP|BY_TOKEN]]
* TYPE, CATEGORY, or TOKEN
| The creature drops an additional object when [[butcher|butchered]], as defined by {{token|EBO_ITEM|c}} and {{token|EBO_SHAPE|c}}. Used for [[gizzard stone]]s in default creatures. For some materials, needs to be defined after caste definitions with SELECT_CASTE:ALL{{Bug|6355}}

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

|-
| {{text anchor|EXTRAVISION}}
| Caste
|
| The creature can see regardless of whether it has working eyes and has full 360 degree vision, making it impossible to strike the creature from a blind spot in combat. Invisible creatures will also be seen, namely [[intelligent undead]] using a "vanish" power.
|}

{{alphabetical TOC|style=margin: 1em auto;}}

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

|-
| {{text anchor|FANCIFUL}}
| Creature
|
| The creature is a thing of legend and known to all civilizations. Its materials cannot be requested or preferred. The tag also adds some art value modifiers. Used by a [[Fanciful|number of creatures]]. Conflicts with {{token|COMMON_DOMESTIC|c}}.

|-
| {{text anchor|FEATURE_ATTACK_GROUP}}
| Caste
|
| Found on [[Animal people#Subterranean animal people|subterranean animal-man]] tribals. Currently defunct. In previous versions{{verify}}, it caused these creatures to crawl out of chasms and underground rivers.

|-
| {{text anchor|FEATURE_BEAST}}
| Caste
|
| Found on [[forgotten beast]]s. Presumably makes it act as such, initiating underground attacks on fortresses, or leads to the pop-up message upon encountering one{{verify}}. Hides the creature from displaying in a world_sites_and_pops file. Does not create historical figures like generated forgotten beasts do.

Requires specifying a {{token|BIOME|c}} in which the creature will live, and both surface and subterranean biomes are allowed. Does not stack with {{token|LARGE_ROAMING|c}} and if both are used the creature will not spawn. Appears to be incompatible with {{token|DEMON|c}} even if used in separate castes.

|-
| {{text anchor|FEMALE}}
| Caste
|
| Makes the creature biologically female, enabling her to [[Breeding|bear young]]. Usually specified inside a caste.

|-
| {{text anchor|FIREIMMUNE}}
| Caste
|
| Makes the creature immune to [[Interaction_token#FIREBALL|FIREBALL]] and [[Interaction_token#FIREJET|FIREJET]] attacks, and allows it to path through high temperature zones, like lava or fires. Does not, by itself, make the creature immune to the damaging effects of burning in [[fire]], and does not prevent general heat damage or melting on its own (this would require adjustments to be made to the creature's body [[Material_definition_token|materials]] - see the [[Dragon/raw|dragon raws]] for an example).

|-
| {{text anchor|FIREIMMUNE_SUPER}}
| Caste
|
| Like {{token|FIREIMMUNE|c}}, but also renders the creature immune to [[Interaction_token#DRAGONFIRE|DRAGONFIRE]] attacks.

|-
| {{text anchor|FISHITEM}}
| Caste
|
| The creature's corpse is a single [[Item_token#FISH_RAW|FISH_RAW]] food item that needs to be cleaned (into a [[Item_token#FISH|FISH]] item) at a [[fishery]] to become edible. Before being cleaned the item is referred to as "raw". The food item is categorized under "fish" on the food and stocks screens, and when uncleaned it is sorted under "raw fish" in the stocks (but does not show up on the food screen).
Without this or {{token|COOKABLE_LIVE|c}}, [[fishing|fished]] vermin will turn into food the same way as non-vermin creatures, resulting in multiple units of food (meat, brain, lungs, eyes, spleen etc.) from a single fished vermin. These units of food are categorized as meat by the game.

|-
| {{text anchor|FIXED_TEMP}}
| Caste
|
*temperature
| The creature's body is constantly at this temperature, heating up or cooling the surrounding area. Alters the temperature of the creature's inventory and all adjacent tiles, [[Temperature|with all the effects that this implies]] - may trigger wildfires at high enough values. Also makes the creature immune to extreme heat or cold, as long as the temperature set is not harmful to the materials that the creature is made from. Corpses and body parts of creatures with a fixed temperature maintain their temperature even after death.

Note that temperatures of 12000 and higher may cause [[path|pathfinding]] issues in fortress mode.

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

|-
| {{text anchor|FLIER}}
| Caste
|
| Allows a creature to fly, independent of it having wings or not. Fortress Mode pathfinding only partially incorporates flying - flying creatures need a land path to exist between them and an area in order to access it, but as long as one such path exists, they do not need to use it, instead being able to fly over intervening obstacles. Winged creatures with this token can lose their ability to fly if their wings are crippled or severed. Winged creatures without this token will be unable to fly. (A 'wing' in this context refers to any body part with its own [[Body_token#FLIER|FLIER]] token).

At least 1 [[Demon]] must have the flier token in order for the [[Underworld|horrifying screams]] event to trigger.

|-
| {{text anchor|FREQUENCY}}
| Creature
|
*number, max 100
| Determines the chances of a creature appearing within its environment, with higher values resulting in more frequent appearance. Also affects the chance of a creature being brought in a caravan for trading.
This value is used multiply to determine the rarity of animal populations. A creature with [FREQUENCY:50] will appear in 50% of valid biomes, and be present in 50% of the area within those biomes.
When a [[Creature token#CLUSTER_NUMBER|cluster]] spawns, the game effectively considers all creatures that can possibly appear and uses the FREQUENCY value as a ''weight'' - for example, if there are three creatures with frequencies 10/25/50, the creature with [FREQUENCY:50] will appear approximately 58.8% of the time. Defaults to 50 if not specified. Not to be confused with {{token|POP_RATIO|c}}.
|}

{{alphabetical TOC|style=margin: 1em auto;}}

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

|-
| {{text anchor|GAIT}}
| Caste
|
* <gait type>
* <gait name>
* <max [[Gait#Speed|speed]]>
* <build up time>
* <max turning [[Gait#Speed|speed]]>
* <start [[Gait#Speed|speed]]>
* <energy expenditure>
* <gait flag(s)>
| Defines a gait by which the creature can move. See [[Gait]] for more information. Specifically, you likely want to use one of the existing STANDARD_X_GAITS creature variations, as described in [[Gait#Gaits_and_Modding|this subsection]].

* <max speed> indicates the maximum [[Gait#Speed|speed]] achievable by a creature using this gait
* <start speed> indicates the creature's speed when it starts moving using this gait
* <build up time> indicates how long it will take for a creature using this gait to go from <start speed> to <max speed>. For example, a value of 10 means that it should be able to reach the maximum speed by moving 10 [[tile]]s in a straight line over even terrain.
* <max turning speed> indicates the maximum speed permissible when the creature suddenly changes its direction of motion. The creature's speed will be reduced to <max turning speed> if travelling at a higher speed than this before turning.
* <energy expenditure> indicates how energy-consuming the gait is. Higher values cause the creature to tire out faster. Persistent usage of a high-intensity gait will eventually lead to exhaustion and [[Status_icon#Non-flashing|collapse]].

'''NO_BUILD_UP''' can be specified instead of a <start speed> value to make the <max speed> instantly achievable upon initiating movement (this is equivalent to a <build up time> of 0). Note that <build up time> and <max turning speed> are both ignored if specified alongside this (as NO_BUILD_UP trumps <build up time> and preserves <max speed> whilst turning, and <max turning speed> cannot exceed <max speed>) so it is permissible to omit them so long as they are '''both''' omitted together.

It's possible to specify a <start speed> greater than the <max speed>; the moving creature will decelerate towards its <max speed> in this case.

'''valid gait types:'''
*'''WALK''' 
Used for moving normally over ground tiles.

*'''CRAWL''' 
Used for moving over ground tiles whilst [[Status_icon#Non-flashing|prone]].

*'''SWIM''' 
Used for moving through tiles containing [[water]] or [[magma]] at a [[Water#Depth|depth]] of at least 4/7.

*'''FLY''' 
Used for moving through [[open space]].

*'''CLIMB''' 
Used for moving whilst [[Climber|climbing]].

'''valid gait flags:'''
* '''AGILITY''' 
Speeds/slows movement depending on the creature's [[Attribute#Agility|Agility]] stat.

* '''STRENGTH''' 
Speeds/slows movement depending on the creature's [[Attribute#Strength|Strength]] stat.

* '''LAYERS_SLOW''' 
Makes [[Tissue_definition_token#THICKENS_ON_ENERGY_STORAGE|THICKENS_ON_ENERGY_STORAGE]] and [[Tissue_definition_token#THICKENS_ON_STRENGTH|THICKENS_ON_STRENGTH]] tissue layers slow movement depending on how thick they are. Adding the STRENGTH gait flag counteracts the impact of the latter layer.

* '''STEALTH_SLOWS:'''<percentage> 
Slows movement by the specified percentage when the creature is [[Ambusher|sneaking]].

|-
| {{text anchor|GENERAL_BABY_NAME}}
| Creature
|
*singular
*plural
| Like {{token|BABYNAME|c}}, but applied regardless of caste.

|-
| {{text anchor|GENERAL_CHILD_NAME}}
| Creature
|
*singular
*plural
| Like {{token|CHILDNAME|c}}, but applied regardless of caste.

|-
| {{text anchor|GENERAL_MATERIAL_FORCE_MULTIPLIER}}
| Caste
|
*value A
*value B
| Has the same function as {{token|MATERIAL_FORCE_MULTIPLIER|c}}, but applies to all attacks instead of just those involving a specific material. Appears to be overridden by MATERIAL_FORCE_MULTIPLIER ([[werebeast]]s, for example, use both tokens to provide resistance to all materials, with one exception to which they are especially vulnerable).

|-
| {{text anchor|GENERATED}}
| Creature
|
| Found on procedurally generated creatures like [[forgotten beast]]s, [[titan]]s, [[demon]]s, [[angel]]s, and [[night creature]]s. Cannot be specified in user-defined raws.

|-
| {{text anchor|GETS_INFECTIONS_FROM_ROT}}
| Caste
|
| Makes the creature get [[Health_care#Infection|infections]] from necrotic tissue.

|-
| {{text anchor|GETS_WOUND_INFECTIONS}}
| Caste
|
| Makes the creature's wounds become [[Health_care#Infection|infected]] if left untreated for too long.

|-
| {{text anchor|GLOWCOLOR}}
| Creature
|
*foreground
*background
*brightness
| The colour of the creature's {{token|GLOWTILE|c}}.

|-
| {{text anchor|GLOWTILE}}
| Creature
|
*ascii character
| If present, the being glows in the dark (generally used for Adventurer 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 {{token|CASTE_GLOWTILE|c}} instead.

|-
| {{text anchor|GNAWER}}
| Caste
|
*verb
| The creature can and will gnaw its way out of [[animal trap]]s and [[cage]]s using the specified verb, depending on the material from which it is made (normally wood).

|-
| {{text anchor|GOBBLE_VERMIN_CLASS}}
| Caste
|
*class
| The creature eats vermin of the specified class.

|-
| {{text anchor|GOBBLE_VERMIN_CREATURE}}
| Caste
|
*creature
*caste
| The creature eats a specified [[vermin]].

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

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

|-
| {{text anchor|GO_TO_TAG}}
| Special
|
| When using tags from an existing creature, inserts new tags ''before'' the specified tag.

|-
| {{text anchor|GOOD}}
| Creature
|
| Creature is considered good and will only show up in good biomes - [[unicorn]]s, for example. Civilizations with {{token|USE_GOOD_ANIMALS|e}} can domesticate them regardless of exotic status. Has no effect on cavern creatures except to restrict taming. A civilization that has good creatures can colonise good areas in world-gen.

|-
| {{text anchor|GRASSTRAMPLE}}
| Caste
|
*value
| The value determines how rapidly [[grass]] is trampled when a creature steps on it - a value of 0 causes the creature to never damage grass, while a value of 100 causes grass to be trampled as rapidly as possible. Defaults to 5.

|-
| {{text anchor|GRAVITATE_BODY_SIZE}}
| Caste
|
*target value
| Used in Creature Variants. This token changes the adult body size to the average of the old adult body size and the target value and scales all intermediate growth stages by the same factor.

|-
| {{text anchor|GRAZER}}
| Caste
|
*number
| The creature is a grazer - if tamed in fortress mode, it needs a pasture to survive. The higher the number, the less frequently it needs to eat in order to live. Not used since 0.40.12, replaced by {{token|STANDARD_GRAZER|c}} to fix {{bugl|4113}}.
|}

{{alphabetical TOC|style=margin: 1em auto;}}

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

|-
| {{text anchor|HABIT}}
| Caste
|
*type
*probability
| Defines certain behaviors for the creature. The habit types are:
*COLLECT_TROPHIES
*COOK_PEOPLE
*COOK_VERMIN
*GRIND_VERMIN
*COOK_BLOOD
*GRIND_BONE_MEAL
*EAT_BONE_PORRIDGE
*USE_ANY_MELEE_WEAPON
*GIANT_NEST
*COLLECT_WEALTH.
These require the creature to have a {{token|LAIR|c}} to work properly, and also don't seem to work on creatures who are not a {{token|SEMIMEGABEAST|c}}, {{token|MEGABEAST|c}}, or{{token|NIGHT_CREATURE_HUNTER|c}}.

|-
| {{text anchor|HABIT_NUM}}
| Caste
|
*number or TEST_ALL
| "If you set HABIT_NUM to a number, it should give you that exact number of habits according to the weights.".{{cite forum|60554/1719248}} All lists of HABITs are preceded by [HABIT_NUM:TEST_ALL]

|-
| {{text anchor|HAS_NERVES}}
| Caste
|
| The creature has nerves in its muscles. Cutting the muscle tissue can sever motor and sensory nerves.

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

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

|-
| {{text anchor|HOMEOTHERM}}
| Caste
|
*number or NONE
| Default 'NONE'. The creature's normal body [[temperature]]. Creature ceases maintaining temperature on death unlike fixed material temperatures. Provides minor protection from environmental temperature to the creature.

|-
| {{text anchor|HUNTS_VERMIN}}
| Caste
|
| Creature hunts and kills nearby [[vermin]], randomly walking between places with food laying on the ground or in stockpiles, to check for possible [VERMIN_EATER] vermin, but they'll kill any other vermin too. Do not include this creature token on an intelligent entity that you intend to play as in fortress mode because it will prevent them from feeding themselves.

|}

{{alphabetical TOC|style=margin: 1em auto;}}

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

|-
| {{text anchor|IMMOBILE}}
| Caste
|
| The creature cannot move. Found on [[sponge]]s. Will also stop a creature from breeding in fortress mode (MALE and FEMALE are affected, if one is IMMOBILE; no breeding will happen).

|-
| {{text anchor|IMMOBILE_LAND}}
| Caste
|
| The creature is immobile while on land. Only works on {{token|AQUATIC|c}} creatures which can't breathe on land.

|-
| {{text anchor|IMMOLATE}}
| Caste
|
| The creature radiates [[fire]]. It will ignite, and potentially completely destroy, items the creature is standing on. Also gives the vermin a high chance of escaping from [[animal trap]]s and [[cage]]s made of any flammable materials (specifically ones that could be ignited by magma).

|-
| {{text anchor|INTELLIGENT}}
| Caste
|
| Alias for {{token|CAN_SPEAK|c}} + {{token|CAN_LEARN|c}}.

|-
| {{text anchor|ITEMCORPSE}}
| Caste
|
* [[item token]]
* [[material token]]
| Determines if the creature leaves behind a non-standard corpse (i.e. wood, statue, bars, stone, pool of liquid, etc.). [[Ethics]] may prevent actually using the item in jobs or reactions.

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

{{alphabetical TOC|style=margin: 1em auto;}}

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

|-
| {{text anchor|LAIR}}
| Caste
|
*type
*probability
| Found on megabeasts, semimegabeasts, and night creatures. The creature will seek out sites of this type and take them as lairs. The lair types are:
*SIMPLE_BURROW
*SIMPLE_MOUND
*WILDERNESS_LOCATION
*SHRINE
*LABYRINTH

|-
| {{text anchor|LAIR_CHARACTERISTIC}}
| Caste
|
*characteristic
*probability
| Defines certain features of the creature's lair. The only valid characteristic is HAS_DOORS.

|-
| {{text anchor|LAIR_HUNTER}}
| Caste
|
| This creature will actively hunt adventurers in its lair.

|-
| {{text anchor|LAIR_HUNTER_SPEECH}}
| Caste
|
*speech file
| What this creature says while hunting adventurers in its lair.

|-
| {{text anchor|LARGE_PREDATOR}}
| Caste
|
| Will attack other creatures that are smaller than it. Tamed large predators will still attack wildlife. In [[fortress mode]], only one group of "large predators" (possibly two groups on "savage" maps) will appear on any given map. In [[adventurer mode]], large predators will try to ambush and attack you (and your party will attack them back). When tamed, large predators tend to be much more aggressive to enemies than non-large predators, making them a good choice for an animal army. They may go on rampages in worldgen, and adventurers may receive quests to kill them. Also, they can be mentioned in the intro paragraph when starting a fortress e.g. "ere the wolves get hungry."
A single biome supports 7 large predator species, picking randomly and rolling a d100 under its {{token|FREQUENCY|c}} to add it until all 7 slots are filled.

Incompatible with {{token|PACK_ANIMAL|c}} on a technicality, if included: hauled items are likely to be dropped upon entering the map (even if {{token|TRADE_CAPACITY|c}} is present) in contrast to when the merchants depart.

|-
| {{text anchor|LARGE_ROAMING}}
| Creature
|
| This is the core requisite tag allowing the creature to spawn as a wild animal in the appropriate biomes. Requires specifying a {{token|BIOME|c}} in which the creature will spawn. Does not require specifying a frequency, population number, or cluster number.

This tag stacks with {{token|MEGABEAST|c}}, {{token|SEMIMEGABEAST|c}}, or {{token|NIGHT_CREATURE_HUNTER|c}}; if used with one of these tags, the creature will spawn as both a boss and as a wild animal. This tag does not stack with {{token|FEATURE_BEAST|c}} and if both are used the creature will not spawn. This tag is unaffected by {{token|DEMON|c}}.

|-
| {{text anchor|LAYS_EGGS}}
| Caste
|
| Creature lays [[egg]]s instead of giving birth to live young.

|-
| {{text anchor|LAYS_UNUSUAL_EGGS}}
| Caste
|
* [[item token]]
* [[material token]]
| Creature lays the specified item instead of regular eggs.

|-
| {{text anchor|LIGAMENTS}}
| Caste
|
* [[material token]]
*healing rate
| The creature has ligaments in its {{token|CONNECTIVE_TISSUE_ANCHOR|td}} tissues (bone or chitin by default). Cutting the bone/chitin tissue severs the ligaments, disabling motor function if the target is a limb.

|-
| {{text anchor|LIGHT_GEN}}
| Caste
|
| A vermin featuring this tag will remain visible to an adventurer even at night.

Subterranean vermin which feature this token will flicker in unexposed and unrevealed cavern layers while playing in Fortress Mode.

|-
| {{text anchor|LIKES_FIGHTING}}
| Caste
|
| The creature will attack enemies rather than flee from them. This tag has the same effect on player-controlled creatures - including modded dwarves. Retired as of v0.40.14 in favor of {{token|LARGE_PREDATOR|c}}.

|-
| {{text anchor|LISP}}
| Caste
|
| Creature uses "sssssnake talk" (multiplies 'S' when talking - "My name isss Recisssiz."). Used by [[Serpent man|serpent men]] and [[Reptile man|reptile men]] in the vanilla game. C's with the same pronunciation (depending on the word) are not affected by this token.

|-
| {{text anchor|LITTERSIZE}}
| Caste
|
* minimum
* maximum
| Determines the number of offspring per one birth; default 1-3, not used in vanilla raws. See also {{token|MULTIPLE_LITTER_RARE|c}}.

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

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

|-
| {{text anchor|LOCKPICKER}}
| Caste
|
| Lets a creature open [[door]]s that are set to forbidden in fortress mode.

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

|-
| {{text anchor|LOW_LIGHT_VISION}}
| Caste
|
*number
| Determines how well a creature can see in the dark - higher is better. Dwarves have 10000, which amounts to perfect nightvision.
|}

{{alphabetical TOC|style=margin: 1em auto;}}

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

|-
| {{text anchor|MAGICAL}}
| Caste
|
| According to Toady One, this is completely interchangeable with {{token|AT_PEACE_WITH_WILDLIFE|c}} and might have been used in very early versions of the game by wandering wizards or the ent-type tree creatures that used to be animated by elves. [http://www.bay12forums.com/smf/index.php?topic=169696.msg8316954#msg8316954]

|-
| {{text anchor|MAGMA_VISION}}
| Caste
|
| The creature is able to see while submerged in [[magma]].

|-
| {{text anchor|MALE}}
| Caste
|
| Makes the creature biologically male. Usually declared inside a caste.

|-
| {{text anchor|MANNERISM|MANNERISM_*}}
| Caste
|
*occasionally body part
| Adds a possible mannerism to the creature's profile. See [[creature mannerism token]] for further info.

|-
| {{text anchor|MATERIAL}}
| Creature
|
*material id
| Begins defining a new local material. Follow this with standard material definition tokens to define the material.

|-
| {{text anchor|MATERIAL_FORCE_MULTIPLIER}}
| Caste
|
*[[Material token]]
*value A
*value B
| When struck with a weapon made of the specified material, the force exerted will be multiplied by A/B, thus making the creature more or less susceptible to this material. For example, if A is 2 and B is 1, the force exerted by the defined material will be doubled. If A is 1 and B is 2, it will be halved instead. See also {{token|GENERAL_MATERIAL_FORCE_MULTIPLIER|c}}, which can be used to make this sort of effect applicable to all materials.

|-
| {{text anchor|MATUTINAL}}
| Caste
|
| When set, the creature will only appear at dawn (between 4:30 AM and 6:00 AM) in [[Adventurer mode]].

|-
| {{text anchor|MAXAGE}}
| Caste
|
*min
*max
| Determines the creature's natural lifespan, using the specified minimum and maximum age values (in years). Each individual creature with this token is generated with a predetermined date (calculated down to the exact [[time|tick]]!) between these values, at which it is destined to die of old age, should it live long enough. Note that the probability of death at any given age does not increase as the creature gets older [http://i.imgur.com/A1A4aA9.png].
Creatures which lack this token are naturally immortal. The [[Syndrome#CE_ADD_TAG|NO_AGING]] syndrome tag will prevent death by old age from occurring. Also note that, among civilized creatures, castes which lack this token will refuse to marry others with it, and vice versa.

|-
| {{text anchor|MEANDERER}}
| Caste
|
| Makes the creature slowly stroll around, unless it's in combat or performing a job. If combined with {{token|CAN_LEARN|c}}, will severely impact their [[pathfinding]] and lead the creature to move extremely slowly when not performing any task. Problematically applies to animal people based on the animal and war trained animals{{bug|9588}}.

|-
| {{text anchor|MEGABEAST}}
| Caste
|
| A 'boss' creature. A small number of the creatures are created during worldgen, their histories and descendants (if any) will be tracked in worldgen (as opposed to simply 'spawning'), and they will occasionally go on rampages, potentially leading to worship if they attack the same place multiple times. Their presence and number will also influence age names. When appearing in fortress mode, they will have a pop-up message announcing their arrival. They will remain hostile to military even after being tamed.{{bug|10731}} See [[megabeast]] page for more details.

Requires specifying a {{token|BIOME|c}} in which the creature will live. Subterranean biomes appear to not be allowed. Does stack with {{token|LARGE_ROAMING|c}} and if both are used the creature will spawn as both historical bosses and as wild animals.

|-
| {{text anchor|MENT_ATT_CAP_PERC}}
| Caste
|
*[[Attribute|ATTRIBUTE]] Token
*Cap %
|Default is 200. This means you can increase your attribute to 200% of its starting value (or the average value + your starting value if that is higher).

|-
| {{text anchor|MENT_ATT_RANGE}}
| Caste
|
*[[Attribute|ATTRIBUTE]]
*lowest
*lower
*low
*median
*high
*higher
*highest
| Sets up a [[Attribute#Soul_attributes|mental attribute]]'s range of values (0-5000). All mental attribute ranges default to 200:800:900:1000:1100:1300:2000.

|-
| {{text anchor|MENT_ATT_RATES}}
| Caste
|
*[[Attribute|ATTRIBUTE]] Token
*cost to improve
*unused counter rate
*rust counter rate
*demotion counter rate
| [[Attribute#Soul_attributes|Mental attribute]] gain/decay rates. Lower numbers in the last three slots make decay occur faster. Defaults are 500:4:5:4.

|-
| {{text anchor|MILKABLE}}
| Caste
|
* [[material token]]
* frequency
| Allows the creature to be [[milk]]ed in the [[farmer's workshop]]. The frequency is the amount of [[time|ticks]] the creature needs to "recharge" (i.e. how much time needs to pass before it can be milked again). Does not work on [[#CAN_LEARN|sentient]] creatures, regardless of [[ethics]].

|-
| {{text anchor|MISCHIEVIOUS}}
| Caste
|
| Alias for {{token|MISCHIEVOUS|c}}.

|-
| {{text anchor|MISCHIEVOUS}}
| Caste
|
| The creature spawns [[stealth]]ed and will attempt to path into the fortress, pulling any [[lever]]s it comes across. It will be invisible on the map and [[unit list]] until spotted by a citizen, at which point the game will pause and recenter on the creature. Used by [[gremlin]]s in the vanilla game. "They go on little missions to mess with various fortress buildings, not just levers."

|-
| {{text anchor|MODVALUE}}
| Caste
|
| Seemingly no longer used.

|-
| {{text anchor|MOUNT}}
| Caste
|
| Creature may be used as a [[mount]]. No use for the player in fortress mode, but enemy sieging forces may arrive with cavalry. Mounts are usable in adventure mode.

|-
| {{text anchor|MOUNT_EXOTIC}}
| Caste
|
| Creature may be used as a [[mount]], but civilizations cannot domesticate it in worldgen without certain exceptions.

|-
| {{text anchor|MULTIPART_FULL_VISION}}
| Caste
|
| Allows the creature to have all-around vision, as long as it has multiple heads that can see.

|-
| {{text anchor|MULTIPLE_LITTER_RARE}}
| Caste
|
| Makes the species usually produce a single offspring per birth, with a 1/500 chance of using the {{token|LITTERSIZE|c}} as usual. Requires {{token|FEMALE|c}}.

|-
| {{text anchor|MUNDANE}}
| Creature
|
| Marks if the creature is an actual real-life creature. Only used for age-names at present.
|}

{{alphabetical TOC|style=margin: 1em auto;}}

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

|-
| {{text anchor|NAME}}
| Creature
|
*singular
*plural
*adjective
| The generic name for any creature of this type - will be used for referring to the species in the abstract, such as the default material prefix. For labeling individual creatures, {{token|CASTE_NAME|c}} is necessary. If left undefined, the creature will be labeled as "nothing" by the game.

Some examples of adjective use:
* "super''dwarven'' strength"
* "the ''dwarven'' hillocks of X"
* Deity species as in "''feline'' deity"
* Megabeast attacks in worldgen. One with multiple dragons being a "''draconic'' rampage"

|-
| {{text anchor|NATURAL}}
| Caste
|
| Animal is considered to be natural. NATURAL animals will not engage creatures tagged with {{token|AT_PEACE_WITH_WILDLIFE|c}} in combat unless they are members of a hostile entity and vice-versa.

|-
| {{text anchor|NATURAL_ANIMAL}}
| Caste
|
| Alias of {{token|NATURAL|c}}.

|-
| {{text anchor|NATURAL_SKILL}}
| Caste
|
*[[Skill_token|Skill token]]
*value
| The creature possesses the specified [[skill]] at this level inherently - that is, it begins with the skill at this level, and the skill may never rust below that. A value of 15 is legendary.

|-
| {{text anchor|NIGHT_CREATURE}}
| Caste
|
| Creatures with this token can appear as [[experiment|experiments]]. Causes the creature to count as {{token|NOT_LIVING|c}}. Killing a creature featuring this token provides one point of "hero" reputation. Adds the creature's description as part of the initial summary of their historical figure in legends mode. People will react to creatures with this token as a night creature (natch). In adventure mode, ambushes involving these units will say "Night creature!" instead of "Ambush!"

Prevents creature behavior enabled by {{token|LARGE_PREDATOR|c}}

Prevents the AI from using ANIMATE interactions, unless the newly-animated{{token|OPPOSED_TO_LIFE|c}}undead will not attack them. The check for this is specifically whether the unit is:
*a ghost
*an animated unit
*a unit with the {{token|NO_AGING|c}} token added via {{token|CE_ADD_TAG|c}}. (This allows for the default exclusion of elves and goblins, unless raised as intelligent undead.)

''This token should not be confused with other NIGHT_CREATURE_X tokens.''
''This token is not well understood at the present time.''

|-
| {{text anchor|NIGHT_CREATURE_BOGEYMAN}}
| Caste
|
| Creatures with this token can appear in [[bogeyman|bogeyman ambushes]] in [[adventure mode]], where they adopt classical bogeyman traits such as stalking the adventurer and vaporising when dawn breaks. Such traits do not manifest if the creature is encountered outside of a bogeyman ambush (for instance, as a megabeast or a civilised being). In addition, their corpses and severed body parts turn into [[smoke]] after a short while. Note that setting the "Number of Bogeyman Types" in [[advanced world generation]] to 0 will only remove randomly-generated bogeymen.

|-
| {{text anchor|NIGHT_CREATURE_EXPERIMENTER}}
| Caste
|
| Found on some [[necromancer]]s. Creatures with this tag may periodically "perform horrible experiments" offscreen, during which they can use creature-targeting interactions with an <code>[[Interaction_token#I_SOURCE|[I_SOURCE:EXPERIMENT]]]</code> tag on living creatures in their area. Worlds are generated with a list of procedurally-generated experiments, allowing necromancers to turn living people and animals into [[Infected_ghoul|ghouls]] and [[Experiment|other experimental creatures]], and these will automatically be available to all experimenters; it does not appear possible to prevent this. You can mod in your own custom experiment interactions, but these are used very infrequently due to the large number of generated experiments.

|-
| {{text anchor|NIGHT_CREATURE_HUNTER}}
| Caste
|
| Found on [[night troll]]s and [[werebeast]]s. Implies that the creature is a [[night creature]], and shows its description in [[legends mode]] entry. The creature is always hostile and will start [[no quarter]] combat with any nearby creatures, except for members of its own race. Note that this tag does not override the creature's normal behavior in [[fortress mode]] except for the aforementioned aggression, and doesn't prevent the creature from fleeing the battles it started. It also removes the creature's materials from stockpile settings list, making them be stored there regardless of settings.

Does stack with {{token|LARGE_ROAMING|c}} and if both are used the creature will spawn as both historical hunters and as wild animals; this requires specifying a {{token|BIOME|c}} in which the creature will live, and subterranean biomes are allowed.

This tag causes the usual behaviour of werebeasts in worldgen, that is, fleeing towns upon being cursed and conducting raids from a lair. If this tag is absent from a deity curse, the accursed will simply be driven out of towns in a similar manner to [[vampire]]s. When paired with SPOUSE_CONVERTER, a very small population of the creature will be created during worldgen (sometimes only a single individual will be created), and their histories will be tracked (that is, they will not spawn spontaneously later, they must either have children or convert other creatures to increase their numbers). The creature will settle in a lair and go on rampages during worldgen. It will actively attempt to seek out potential conversion targets to abduct, convert, and have children with (if possible).

|-
| {{text anchor|NIGHT_CREATURE_NIGHTMARE}}
| Caste
|
| Found on [[nightmare]]s. Corpses and severed body parts derived from creatures with this token turn into [[smoke]] after a short while.

|-
| {{text anchor|NO_AUTUMN}}
| Caste
|
| The creature caste does not appear in [[Calendar|autumn]].

|-
| {{text anchor|NO_CONNECTIONS_FOR_MOVEMENT}}
| Caste
|
| Creature doesn't require connected body parts to move{{verify}}; generally used on undead creatures with connections that have rotted away.

|-
| {{text anchor|NO_DIZZINESS}}
| Caste
|
| Creature cannot become [[Symptom#Dizziness|dizzy]].

|-
| {{text anchor|NO_DRINK}}
| Caste
|
| Creature does not need to drink.

|-
| {{text anchor|NO_EAT}}
| Caste
|
| Creature does not need to [[food|eat]].

|-
| {{text anchor|NO_FEVERS}}
| Caste
|
| Creature cannot suffer [[Symptom#Fever|fevers]].

|-
| {{text anchor|NO_GENDER}}
| Caste
|
| The creature is biologically sexless, making it unable to [[breeding|breed]].

|-
| {{text anchor|NO_PHYS_ATT_GAIN}}
| Caste
|
| The creature cannot raise any [[Attribute#Body_attributes|physical attributes]].

|-
| {{text anchor|NO_PHYS_ATT_RUST}}
| Caste
|
| The creature cannot lose any [[Attribute#Body_attributes|physical attributes]].

|-
| {{text anchor|NO_SLEEP}}
| Caste
|
| Creature does not need to sleep, but can still be rendered unconscious by other means.

|-
| {{text anchor|NO_SPRING}}
| Caste
|
| The creature caste does not appear in [[Calendar|spring]].

|-
| {{text anchor|NO_SUMMER}}
| Caste
|
| The creature caste does not appear in [[Calendar|summer]].

|-
| {{text anchor|NO_THOUGHT_CENTER_FOR_MOVEMENT}}
| Caste
|
| The bodyparts of this creature don't need to be connected to an organ with the {{token|THOUGHT|body}} tag in order to have motor function. Generally used on creatures that don't have brains. If a creature doesn't have a thought part and doesn't have this token, it will be unable to grasp or stand. Nautilus men experience this issue in vanilla.

|-
| {{text anchor|NO_UNIT_TYPE_COLOR}}
| Caste
|
| Prevents creature from selecting its color based on its profession (e.g. Miner, Hunter, Wrestler).

|-
| {{text anchor|NO_VEGETATION_PERTURB}}
| Caste{{Verify}}
|
| Likely prevents the creature from leaving broken vegetation tracks.{{Verify}}

|-
| {{text anchor|NO_WINTER}}
| Caste
|
| The creature caste does not appear in [[Calendar|winter]].

|-
| {{text anchor|NOBONES}}
| Caste
|
| Creature has no bones.

|-
| {{text anchor|NOBREATHE}}
| Caste
|
| Creature doesn't need to breathe or have {{token|BREATHE|body}}parts in its body, nor can it drown or be strangled. Creatures living in magma must have this tag, otherwise they will drown.

|-
| {{text anchor|NOCTURNAL}}
| Caste
|
| When set, the creature will only appear at night (after 10:05 PM and before 4:30 AM) in [[Adventurer mode]].

|-
| {{text anchor|NOEMOTION}}
| Caste
|
| Creature has no emotions, thus; it is immune to the effects of [[stress]] and unable to rage, and its [[need]]s cannot be fulfilled in any way. Used on [[undead]] in the vanilla game.

|-
| {{text anchor|NOEXERT}}
| Caste
|
| Creature can't become tired or over-exerted from taking too many combat actions, or moving at full speed for extended periods of time.

|-
| {{text anchor|NOFEAR}}
| Caste
|
| Creature doesn't feel fear and will never flee from battle, and will be immune to [[ghost]]s' attempts to 'scare it to death'. Additionally, it causes [[bogeyman|bogeymen]] and [[nightmare]]s to become friendly towards the creature.

|-
| {{text anchor|NOMEAT}}
| Caste
|
| Creature will not be hunted or fed to wild beasts.

|-
| {{text anchor|NONAUSEA}}
| Caste
|
| Creature isn't nauseated by gut hits and cannot vomit.

|-
| {{text anchor|NOPAIN}}
| Caste
|
| Creature doesn't feel pain.

|-
| {{text anchor|NOSKIN}}
| Caste
|
| Creature will not drop a hide when [[butcher|butchered]].

|-
| {{text anchor|NOSKULL}}
| Caste
|
| Creature will not drop a skull on butchering, rot, or decay of severed head.

|-
| {{text anchor|NOSMELLYROT}}
| Caste
|
| Does not produce [[miasma]] when rotting.

|-
| {{text anchor|NOSTUCKINS}}
| Caste
|
| Weapons can't get stuck in the creature.

|-
| {{text anchor|NOSTUN}}
| Caste
|
| Creature can't be stunned and knocked unconscious by pain or head injuries. Creatures with this tag never wake up from sleep in Fortress Mode. If this creature needs to sleep while playing, it will die.

|-
| {{text anchor|NOT_BUTCHERABLE}}
| Caste
|
| Corpses from this creature cannot be [[butcher|butchered]]. Does not prevent the creature from being slaughtered while alive, however.

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

|-
| {{text anchor|NOTHOUGHT}}
| Caste
|
| Creature doesn't require a {{token|THOUGHT|body}} body part to survive. Has the added effect of preventing speech, though directly controlling creatures that would otherwise be capable of speaking allows them to engage in conversation.
|}

{{alphabetical TOC|style=margin: 1em auto;}}

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

|-
| {{text anchor|ODOR_LEVEL}}
| Caste
|
*number
| How easy the creature is to [[smell]]. The higher the number, the easier the creature is to sniff out. Defaults to 50. Vanilla creatures have values from 0 (undetectable) to 90 (noticeable by humans and dwarves).

|-
| {{text anchor|ODOR_STRING}}
| Caste
|
*string
| What the creature [[smell]]s like. If no odor string is defined, the creature name (not the caste name) is used.

|-
| {{text anchor|OPPOSED_TO_LIFE}}
| Caste
|
| Is hostile to all creatures except undead and other non-living ones and will show {{DFtext|Opposed to life|0:1}} in the [[unit list]]. Used by [[undead]] in the vanilla game. Functions without the {{token|NOT_LIVING|c}} token, and seems to imply said token as well. Undead will not be hostile to otherwise-living creatures given this token. Living creatures given this token will attack living creatures that lack it, while ignoring other living creatures that also have this token.

|-
| {{text anchor|ORIENTATION}}
| Caste
|
*MALE/FEMALE
*disinterested chance
*casual chance
*strong chance
| Determines caste's likelihood of having sexual attraction to certain sexes. Values default to 75:20:5 for the same sex and 5:20:75 for the opposite sex. The first value indicates how likely to be entirely uninterested in the sex, the second decides if the creature will be able to become lovers with that sex, the third decides whether they will be able to marry in worldgen and post-worldgen world activities (which implies being able to become lovers). Marriage seems to be able to happen in fort mode play regardless, as long as they are lovers first.

|-
| {{text anchor|OUTSIDER_CONTROLLABLE}}
| Caste
|
| Lets you play as an [[Adventurer_mode_character_creation#Outsider|outsider]] of this species in adventure mode.

|}

{{alphabetical TOC|style=margin: 1em auto;}}

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

|-
| {{text anchor|PACK_ANIMAL}}
| Caste
|
| Allows the creature to be used as a pack animal. Used by [[trading|merchants]] without wagons and adventurers. Also prevents creature from dropping hauled items on its own -- do ''not'' use for player-controllable creatures! May lead to the creature being domesticated during worldgen, even if it doesn't have {{token|COMMON_DOMESTIC|c}}.

Creatures with this tag but without {{token|BENIGN|c}}, and/or with {{token|LARGE_PREDATOR|c}} leads to hauled items being dropped.

|-
| {{text anchor|PARALYZEIMMUNE}}
| Caste
|
| The creature is immune to all [[Syndrome#CE_PARALYSIS|paralyzing]] special attacks.

|-
| {{text anchor|PATTERNFLIER}}
| Caste
|
| Used to control the bat riders with paralyze-dart blowguns that flew through the 2D chasm. Doesn't do anything now.

|-
| {{text anchor|PCG_LAYERING}}
| Creature
|
*[[Procedural graphics layer|Layering type]]
| Adds a layer to the current {{token|PROCEDURAL_CREATURE_GRAPHICS|c}} definition.

|-
| {{text anchor|PEARL}}
| Caste
|
| Does nothing.

|-
| {{text anchor|PENETRATEPOWER}}
| Caste
|
*value
| Controls the ability of [[vermin]] to find a way into containers when they are eating food from your stockpiles.

Objects made of most materials (e.g. metal) roll a number from 0-100, and if the resulting number is greater than the penetrate power, their contents escape for the time being. Objects made of [[wood]], [[leather]], [[amber]], or [[coral]] roll 0-95, and items made of [[cloth]] roll 0-90.

|-
| {{text anchor|PERSONALITY}}
| Caste
|
*ATTRIBUTE
*lowest
*median
*highest
| Determines the range and chance of personality facets. Standard is 0:50:100. See [[personality facet]] for more info.

|-
| {{text anchor|PET}}
| Caste
|
| Allows the creature to be [[Animal_trainer|tamed]] in Fortress mode. Prerequisite for all other working animal roles. Civilizations that encounter it in worldgen will tame and domesticate it for their own use. Adding this to civilization members will classify them as pets instead of citizens, with all the [[Fun|problems]] that entails. However, you can solve these problems using the popular plugin [https://dffd.bay12games.com/file.php?id=13095| Dwarf Therapist], which is completely unaffected by the tag.

|-
| {{text anchor|PET_EXOTIC}}
| Caste
|
| Allows the creature to be [[Animal_trainer|tamed]] in Fortress mode. Prequisite for all other working animal roles. Civilizations cannot domesticate it in worldgen, with certain exceptions. More difficult to tame?{{verify}} Adding this to civilization members will classify them as pets instead of citizens, with all the [[Fun|problems]] that entails. ([[Gremlin|Example]]).

|-
| {{text anchor|PETVALUE}}
| Caste
|
*value
| How valuable a tamed animal is. Actual cost in points in the embarking screen is 1+(PETVALUE/2) for an untrained animal, 1+PETVALUE for a war/hunting one.

|-
| {{text anchor|PETVALUE_DIVISOR}}
| Caste
|
*value
| Divides the creature's {{token|PETVALUE|c}} by the specified number. Used by [[honey bee]]s to prevent a single hive from being worth a fortune.

|-
| {{text anchor|PHYS_ATT_CAP_PERC}}
| Caste
|
*[[Attribute|ATTRIBUTE]] Token
*Cap %
|Default is 200. This means you can increase your attribute to 200% of its starting value (or the average value + your starting value if that is higher).

|-
| {{text anchor|PHYS_ATT_RANGE}}
| Caste
|
*[[Attribute|ATTRIBUTE]]
*lowest
*lower
*low
*median
*high
*higher
*highest
| Sets up a [[Attribute#Body_attributes|physical attribute]]'s range of values (0-5000). All physical attribute ranges default to 200:700:900:1000:1100:1300:2000.

|-
| {{text anchor|PHYS_ATT_RATES}}
| Caste
|
*[[Attribute|ATTRIBUTE]] Token
*cost to improve
*unused counter rate
*rust counter rate
*demotion counter rate
| [[Attribute#Body_attributes|Physical attribute]] gain/decay rates. Lower numbers in the last three slots make decay occur faster. Defaults for STRENGTH, AGILITY, TOUGHNESS, and ENDURANCE are 500:3:4:3, while RECUPERATION and DISEASE_RESISTANCE default to 500:NONE:NONE:NONE.

|-
| {{text anchor|PLUS_BP_GROUP}}
| Caste
|
*BY_TYPE, BY_CATEGORY, or BY_TOKEN
*body type, category, or token
| Adds a body part group to selected body part group. Presumably used immediately after {{token|SET_BP_GROUP|c}}.

|-
| {{text anchor|PLUS_MATERIAL}}
| Creature
|
*material
| Adds a material to selected materials. Used immediately after {{token|SELECT_MATERIAL|c}}.

|-
| {{text anchor|POP_RATIO}}
| Caste
|
*number (max 100000)
| Weighted population of caste; Lower is rarer. Not to be confused with {{token|FREQUENCY|c}}. A weight of 0 will{{version|51.06 experimental}} prevent a caste from spawning naturally. Regardless of pop ratio, [[Position token|Position]]s that only allow a certain caste can force it to spawn.

|-
| {{text anchor|POPULATION_NUMBER}}
| Creature
|
*min
*max
| The minimum/maximum numbers of how many of these creatures are present in each world map tile of the appropriate region. Defaults to 1:1 if not specified.

|-
| {{text anchor|POWER}}
| Caste
|
| Allows the being to represent itself as a deity, allowing it to become the leader of a civilized group. Not used by any creatures in the vanilla game. Requires {{token|CAN_SPEAK|c}} to actually do anything more than settle at a location (e.g. write books, lead armies, profane temples). Doesn't appear to do anything for creatures that are already civilized. Once the creature ascends to a position of leadership, it will proceed to act as a standard ruler for their entity and fulfill the same functions (hold tournaments, tame creatures, etc.).

|-
| {{text anchor|PREFSTRING}}
| Creature
|
*string
| Sets what other creatures [[Preferences|prefer]] about this creature. "Urist likes dwarves for their beards." Multiple entries will be chosen from at random. Creatures lacking a PREFSTRING token will never appear under another's preferences.

|-
| {{text anchor|PROCEDURAL_CREATURE_GRAPHICS}}
| Creature
|
* [[Graphics_token#Basic_creature_sprite_types|Sprite type]] or Caste then sprite type
| Makes the creature have procedural graphics built for it, like forgotten beasts/demons/titans/experiments. Must be associated with PCG_LAYERING tokens.

|-
| {{text anchor|PROFESSION_NAME}}
| Creature
|
*[[Unit type token]] (Profession)
*singular
*plural
| The generic name for members of this profession, at the creature level. In order to give members of specific castes different names for professions, use {{token|CASTE_PROFESSION_NAME|c}} instead.

|-
| {{text anchor|PRONE_TO_RAGE}}
| Caste
|
*Chance
| Creature has a percentage chance to flip out at visible non-friendly creatures. Enraged creatures attack anything regardless of timidity and get a strength bonus to their hits. This is what makes [[badger]]s so hardcore.

|-
| {{text anchor|PUS}}
| Caste
|
* <[[material token]]>
* <[[Material_definition_token#Material_States|material state]]>
| The creature has pus. Specifies the stuff secreted by [[Health_care#Infection|infected wounds]].
|}

{{alphabetical TOC|style=margin: 1em auto;}}

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

|-
| {{text anchor|RELSIZE}}
| Caste
|
*BY_CATEGORY, BY_TYPE, BY_TOKEN
*body category, type, or token
*Relsize
| Specifies a new relative size for a part than what is stated in the body plan. For example, dwarves have larger livers.

|-
| {{text anchor|REMAINS}}
| Caste
|
*singular
*plural
| What the creature's [[remains]] are called.

|-
| {{text anchor|REMAINS_COLOR}}
| Caste
|
| What color the creature's [[remains]] are.

|-
| {{text anchor|REMAINS_ON_VERMIN_BITE_DEATH}}
| Caste
|
| Goes with {{token|VERMIN_BITE|c}} and {{token|DIE_WHEN_VERMIN_BITE|c}}, the vermin creature will leave remains on death when biting. Leaving this tag out will cause the creature to disappear entirely after it bites.

|-
| {{text anchor|REMAINS_UNDETERMINED}}
| Caste
|
| Nothing.

|-
| {{text anchor|REMOVE_MATERIAL}}
| Creature
|
*material token
| Removes a material from the creature.

|-
| {{text anchor|REMOVE_TISSUE}}
| Creature
|
*tissue token
| Removes a tissue from the creature.

|-
| {{text anchor|RETRACT_INTO_BP}}
| Caste
|
*BY_TYPE, BY_CATEGORY or BY_TOKEN
*body type, [[Body_token#CATEGORY|category]], or [[Body_token#BP|token]]
*Second person ("You") retract verb text
*Third person ("The giant snail") retract verb text
*Second person cancel retract text
*Third person cancel retract text
| The creature will retract into the specified body part(s) when threatened. It will be unable to move or attack, but enemies will only be able to attack the specified body part(s). When one of the specified body part is severed off, the creature automatically unretracts and cannot retract anymore. More than one body part can be selected by using BY_TYPE or BY_CATEGORY.

Second-person descriptions are used for adventurer mode natural ability. "<pro_pos>" can be used in the descriptions, being replaced with the proper pronoun (or lack thereof) in-game.

Undead curled up creatures are buggy, specifically those that retract into their upper bodies: [[echidna]]s, [[hedgehog]]s and [[pangolin]]s.{{bug|11463}}{{bug|10519}} The upper body is prevented from collapsing by a separate body part (the middle spine), which cannot be attacked when the creature is retracted. See {{token|PREVENTS_PARENT_COLLAPSE|bo}}. Living creatures eventually succumb to blood loss, but undead creatures do not. Giant creatures also take a very long time to bleed out.
|-
| {{text anchor|RETURNS_VERMIN_KILLS_TO_OWNER}}
| Creature
|
| Cat behavior. If it kills a vermin creature and has an owner, it carries the remains in its mouth and drops them at their feet. Requires {{token|HUNTS_VERMIN|c}}.

|-
| {{text anchor|ROOT_AROUND}}
| Caste
|
*BY_TYPE, BY_CATEGORY or BY_TOKEN
*body type, [[Body_token#CATEGORY|category]], or [[Body_token#BP|token]]
*Second person ("You") verb text
*Third person ("The hen") verb text
| Creature will occasionally root around in the grass, looking for insects. Used for flavor in Adventurer Mode, spawns vermin edible for this creature in Fortress Mode. Creatures missing the specified body part will be unable to perform this action. The action produces a message (visible in adventure mode) in the form:

[creature] [verb text] the [description of creature's location]

In adventure mode, the "rooting around" ability will be included in the "natural abilities" menu, represented by its second person verb text.

|}

{{alphabetical TOC|style=margin: 1em auto;}}

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

|-
| {{text anchor|SAVAGE}}
| Creature
|
| The creature will only show up in "savage" biomes. Has no effect on cavern creatures. Cannot be combined with {{token|GOOD|c}} or {{token|EVIL|c}}.

|-
| {{text anchor|SECRETION}}
| Caste
|
*<[[material token]]>
*<[[Material_definition_token#Material_States|material state]]>
*BY_TOKEN / BY_CATEGORY / BY_TYPE
*<[[Body_token#BP|body part ID]]> / <[[Body_token#CATEGORY|category]]> or ALL / <type (e.g. [[Body_token#GRASP|GRASP]])>
*<[[Body_detail_plan_token#BP_LAYERS|tissue layer]]> or ALL
*<trigger>
| Causes the specified tissue layer(s) of the indicated body part(s) to secrete the designated material. A size 100 ('covering') [[contaminant]] is created over the affected body part(s) in its specified material state (and at the temperature appropriate to this state) when the trigger condition is met, as long as one of the secretory tissue layers is still intact. Valid triggers are:
*'''CONTINUOUS'''
Secretion occurs once every 40 [[time|ticks]] in [[fortress mode]], and every tick in [[adventurer mode]].
*'''EXERTION'''
Secretion occurs continuously (at the rate described above) whilst the creature is at minimum {{Tile|Tired|6:1}} following physical exertion. Note that this cannot occur if the creature has {{token|NOEXERT|c}}.
*'''EXTREME_EMOTION'''
Secretion occurs continuously (as above) whilst the creature is distressed. Cannot occur in creatures with {{token|NOEMOTION|c}}.

|-
| {{text anchor|SELECT_ADDITIONAL_CASTE}}
| Creature
|
*<caste>
| Adds an additional previously defined caste to the selection. Used after {{token|SELECT_CASTE|c}}.

|-
| {{text anchor|SELECT_CASTE}}
| Creature
|
*<caste> or ALL
| Selects a previously defined caste

|-
| {{text anchor|SELECT_MATERIAL}}
| Creature
|
*<[[material token]]>
| Selects a locally defined material. Can be ALL.

|-
| {{text anchor|SELECT_TISSUE}}
| Creature
|
*tissue token
| Selects a tissue for editing.

|-
| {{text anchor|SEMIMEGABEAST}}
| Caste
|
| Essentially the same as {{token|MEGABEAST|c}}, but more of them are created during worldgen. See the [[semi-megabeast]] page for details.

|-
| {{text anchor|SENSE_CREATURE_CLASS}}
| Caste
|
* <[[Creature_token#CREATURE_CLASS|creature class]]>
* [[Tilesets|<tile value or character>]]
* [[Color#Color_values|<foreground color>:<background color>:<foreground brightness>]]
| Gives the creature the ability to sense creatures belonging to the specified [[Creature_token#CREATURE_CLASS|creature class]] even when they lie far beyond line of sight, including through walls and floors. It also appears to reduce or negate the combat penalty of [[Wound#Blindness|blind]] units when fighting creatures they can sense. In [[adventure mode]], the specified tile will be used to represent sensed creatures when they cannot be seen directly.

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

|-
| {{text anchor|SKILL_LEARN_RATE}}
| Caste
|
*<[[skill_token]]>
*<percentage>
| The rate at which this creature learns this skill. Requires {{token|CAN_LEARN|c}} or {{token|INTELLIGENT|c}} to function.

|-
| {{text anchor|SKILL_LEARN_RATES}}
| Caste
|
*<percentage>
| The rate at which this creature learns all skills. Requires {{token|CAN_LEARN|c}} or {{token|INTELLIGENT|c}} to function.

|-
| {{text anchor|SKILL_RATE}}
| Caste
|
*[[skill_token]]
*<% of improvement points gained>
*<unused counter rate>
*<rust counter rate>
*<demotion counter rate>
| Like {{token|SKILL_RATES|c}}, but applies to individual skills instead. Requires {{token|CAN_LEARN|c}} or {{token|INTELLIGENT|c}} to function.

|-
| {{text anchor|SKILL_RATES}}
| Caste
|
*<% of improvement points gained>
*<unused counter rate>
*<rust counter rate>
*<demotion counter rate>
| Affects skill gain and decay. Lower numbers in the last three slots make decay occur faster ([SKILL_RATES:100:1:1:1] would cause rapid decay). The counter rates may also be replaced with NONE.
Default is [SKILL_RATES:100:8:16:16]. Requires {{token|CAN_LEARN|c}} or {{token|INTELLIGENT|c}} to function.

|-
| {{text anchor|SKILL_RUST_RATE}}
| Caste
|
*[[skill_token]]
*value
*value
*value
| The rate at which this skill decays. Lower values cause the skill to decay faster. Requires {{token|CAN_LEARN|c}} or {{token|INTELLIGENT|c}} to function.

|-
| {{text anchor|SKILL_RUST_RATES}}
| Caste
|
*value
*value
*value
| The rate at which all skills decay. Lower values cause the skills to decay faster. Requires {{token|CAN_LEARN|c}} or {{token|INTELLIGENT|c}} to function.

|-
| {{text anchor|SLAIN_CASTE_SPEECH}}
| Caste
|
*[[Speech file|text set]]
| Caste-specific {{token|SLAIN_SPEECH|c}}.

|-
| {{text anchor|SLAIN_SPEECH}}
| Creature
|
*[[Speech file|text set]]
| Boasting speeches relating to killing this creature. Examples include [[text_dwarf.txt/raw|text_dwarf.txt]] (<code>[SLAIN_SPEECH:SLAIN_DWARF]</code>) and text_elf.txt (<code>[SLAIN_SPEECH:SLAIN_ELF]</code>) in data\vanilla\vanilla_creatures\objects.

|-
| {{text anchor|SLOW_LEARNER}}
| Caste
|
| Shorthand for {{token|CAN_LEARN|c}} + <code>[[Creature_token#SKILL_LEARN_RATES|[SKILL_LEARN_RATES:50]]]</code>.{{verify}} Used by a number of 'primitive' creatures (like [[ogre]]s, [[giant]]s and [[troglodyte]]s) in the vanilla game. Applicable to player races. Prevents a player from recruiting nobility, even basic ones. Subterranean creatures with this token combined with {{token|EVIL|c}} will become servants of goblins in their civilizations, in the style of [[troll]]s.

|-
| {{text anchor|SMALL_REMAINS}}
| Caste
|
| Creature leaves "[[item token#REMAINS|remains]]" instead of a corpse. Used by [[vermin]].

|-
| {{text anchor|SMELL_TRIGGER}}
| Caste
|
*value
| Determines how keen a creature's sense of smell is - lower is better. At 10000, a creature cannot smell at all.

|-
| {{text anchor|SOLDIER_ALTTILE}}
| Creature
|
*'character' or tile number
| If this creature is active in its civilization's military, it will blink between its default tile and this one.

|-
| {{text anchor|SOUND}}
| Caste
|
* Sound application (currently accepts ALERT or PEACEFUL_INTERMITTENT)
* Sound range (in tiles)
* Sound delay (lower values = sound is produced more often)
* VOCALIZATION or NONE (determines whether the sound requires breathing or not)
* First-person description
* Third-person description
* Description when out of sight
| Creature makes sounds periodically, which can be heard in Adventure mode.
* First-person reads "You '''bark'''"
* Third-person reads "The [[capybara]] '''barks'''"
* Out of sight reads "You hear '''a loud bark'''"
with the text in bold being the description arguments of the token.

|-
| {{text anchor|SOURCE_HFID}}
| Creature
|
*Integer
| Found on generated [[angel]]s. This is the historical figure ID of the deity with which the angel is associated. Since HFIDs are not predictable before worldgen, this isn't terribly usable in mods.

|-
| {{text anchor|SPECIFIC_FOOD}}
| Caste
|
* PLANT or CREATURE
* Plant/creature ID
| Creature will only appear in biomes with this plant or creature available. Grazers given a specific type of grass (such as [[panda]]s and [[bamboo]]) will only eat that grass and nothing else, risking starvation if there's none available.

|-
| {{text anchor|SPHERE}}
| Creature
|
* [[Sphere#Available_spheres|sphere]]
| Sets what religious spheres the creature is aligned to, for purposes of being worshipped via the {{token|POWER|c}} token. Also affects the creature's name.

|-
| {{text anchor|SPOUSE_CONVERSION_TARGET}}
| Caste
|
| This creature can be converted by a night creature with {{token|SPOUSE_CONVERTER|c}}.

|-
| {{text anchor|SPOUSE_CONVERTER}}
| Caste
|
| If the creature has the {{token|NIGHT_CREATURE_HUNTER|c}} tag, it will kidnap {{token|SPOUSE_CONVERSION_TARGET|c}}s and transform them into the caste of its species with the {{token|CONVERTED_SPOUSE|c}} tag during worldgen. It may also start families this way.

|-
| {{text anchor|SPREAD_EVIL_SPHERES_IF_RULER}}
| Caste
|
| If the creature rules over a [[site]], it will cause the local landscape to be corrupted into [[Surroundings#Evil|evil surroundings]] associated with the creature's [[Creature_token#SPHERE|sphere]]s. The creature must have at least one of the following [[sphere]]s for this to take effect: BLIGHT, DEATH, DISEASE, DEFORMITY, NIGHTMARES. The first three kill vegetation, while the others sometimes do. The last two get [[Plant_token#EVIL|evil plants]] and [[Creature_token#EVIL|evil animals]] sometimes. NIGHTMARES gets [[bogeyman|bogeymen]]. [http://www.bay12forums.com/smf/index.php?topic=169696.msg8162224#msg8162224] Used by [[demon]]s in the vanilla game.

|-
| {{text anchor|STANCE_CLIMBER}}
| Caste
|
| Caste does not require <code>[[Body_token#GRASP|[GRASP]]]</code> body parts to climb -- it can climb with <code>[[Body_token#STANCE|[STANCE]]]</code> parts instead.

|-
| {{text anchor|STANDARD_GRAZER}}
| Caste
|
| Acts as {{token|GRAZER|c}} but set to 20000*G*(max size)^(-3/4), where G defaults to 100 but can be set in d_init, and the whole thing is trapped between 150 and 3 million. Used for all grazers in the default creature raws.

|-
| {{text anchor|STRANGE_MOODS}}
| Caste
|
| The creature will get [[strange mood]]s in fortress mode and can produce artifacts.

|-
| {{text anchor|SUPERNATURAL}}
| Caste
|
| Gives the creature knowledge of any secrets with <code>[[Interaction_token#IS_SECRET|[SUPERNATURAL_LEARNING_POSSIBLE]]]</code> that match its [[Creature_token#SPHERE|spheres]] and also prevents it from becoming a [[vampire]] or [[werebeast]]. Other effects are unknown.

|-
| {{text anchor|SWIMS_INNATE}}
| Caste
|
| The creature naturally knows how to swim perfectly and does not use the [[swimmer]] skill, as opposed to {{token|SWIMS_LEARNED|c}} below. However, Fortress mode AI never paths into water anyway, so it's less useful there.

|-
| {{text anchor|SWIMS_LEARNED}}
| Caste
|
| The creature swims only as well as their present [[Swimmer|swimming skill]] allows them to.

|-
| {{text anchor|SYNDROME_DILUTION_FACTOR}}
| Caste
| <[[Syndrome#SYN_IDENTIFIER|syndrome identifier]]>:<percentage>
| Dilutes the effects of syndromes which have the specified identifier. A percentage of 100 is equal to the regular syndrome effect severity, higher percentages reduce severity.
|}

{{alphabetical TOC|style=margin: 1em auto;}}

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

|-
| {{text anchor|TENDONS}}
| Caste
|
* [[material token]]
*healing rate
| The creature has tendons in its {{token|CONNECTIVE_TISSUE_ANCHOR|td}} tissues (bone or chitin by default). Cutting the bone/chitin tissue severs the tendons, disabling motor function if the target is a limb.

|-
| {{text anchor|THICKWEB}}
| Caste
|
| The creature's [[web]]s can catch larger creatures.

|-
| {{text anchor|TISSUE}}
| Creature
|
*name
| Begins defining a tissue in the creature file. Follow this with standard tissue definition tokens to define the tissue properties.

|-
| {{text anchor|TISSUE_LAYER}}
| Caste
|
*BY_TYPE, BY_CATEGORY, BY_TOKEN
*TYPE,CATEGORY, or TOKEN
*TISSUE
*LOCATION
| Adds the tissue layer to wherever it is required.
Non-argument Locations can be FRONT, RIGHT, LEFT, TOP, BOTTOM. Argument locations are AROUND and CLEANS, requiring a further body part and a % of coverage/cleansing

|-
| {{text anchor|TISSUE_LAYER_OVER}}
| Caste
|
*BY_TYPE, BY_CATEGORY, BY_TOKEN
*TYPE,CATEGORY, or TOKEN
*TISSUE
*LOCATION
| Alias for TISSUE_LAYER

|-
| {{text anchor|TISSUE_LAYER_UNDER}}
| Caste
|
*BY_TYPE, BY_CATEGORY, BY_TOKEN
*TYPE,CATEGORY, or TOKEN
*TISSUE
| Adds the tissue layer under a given part.
For example, an [[iron man]] has a gaseous poison within, and this tissue (GAS is its name) has the token [TISSUE_LEAKS] and its state is GAS, so when you puncture the iron outside and damage this tissue it leaks gas (can have a syndrome by using a previous one in the creature sample.) [TISSUE_LAYER_UNDER:BY_CATEGORY:ALL:{tissue}] {tissue} is what will be under the TISSUE_LAYER; here is an example Tissue from the 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]

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

|-
| {{text anchor|TRADE_CAPACITY}}
| Caste
|
*number
| How much the creature can carry when used by merchants. 1000 by default. Completely ignored if the animal does not also have PACK_ANIMAL or WAGON, instead using BODY_SIZE^(2/3)/20, even if they're a pack animal due to ANIMAL_ALWAYS_PACK_ANIMAL.

|-
| {{text anchor|TRAINABLE}}
| Caste
|
| Shortcut for {{token|TRAINABLE_HUNTING|c}} + {{token|TRAINABLE_WAR|c}}.

|-
| {{text anchor|TRAINABLE_HUNTING}}
| Caste
|
| Can be [[Animal trainer|trained]] as a hunting beast, increasing speed.

|-
| {{text anchor|TRAINABLE_WAR}}
| Caste
|
| Can be [[Animal trainer|trained]] as a war beast, increasing strength and endurance.

|-
| {{text anchor|TRANCES}}
| Caste
|
| Allows the creature to go into [[martial trance]]s. Used by dwarves in the vanilla game.

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

|-
| {{text anchor|TRIGGERABLE_GROUP}}
| Creature
|
*min
*max
| A large swarm of vermin can be disturbed, usually in adventurer mode.

|-
| {{text anchor|TSU_NOUN}}
| Caste
|
*noun
*SINGULAR or PLURAL
| Noun for the {{token|TISSUE_STYLE_UNIT|c}}, used in the description of the tissue layer's style.
|}

{{alphabetical TOC|style=margin: 1em auto;}}

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

|-
| {{text anchor|UBIQUITOUS}}
| Creature
|
| Creature will occur in every region with the correct biome. Does not apply to {{token|EVIL|c}}/{{token|GOOD|c}} tags. Supersedes {{token|FREQUENCY|c}} for the purposes of distributing populations through the map, they are present in every part of the valid biome. Respects {{token|FREQUENCY|c}} for the frequency of unit [[Creature token#CLUSTER_NUMBER|cluster]] spawns being of this species.

|-
| {{text anchor|UNDERGROUND_DEPTH}}
| Creature
|
*mindepth
*maxdepth
| Depth that the creature appears underground. Numbers can be from 0 to 5. 0 is actually 'above ground' and can be used if the creature is to appear both above and below ground. Values from 1-3 are the respective [[cavern]] levels, 4 is the [[magma sea]] and 5 is the [[HFS]]. A single argument may be used instead of min and max. [[Demon]]s use only 5:5; user-defined creatures with both this depth and {{token|FLIER}} will take part in the initial wave from the HFS alongside generated demons, but without {{token|FLIER}} they will only spawn from the map edges. Civilizations that can use underground plants or animals will only export (via the embark screen or caravans) things that are available at depth 1.

|-
| {{text anchor|UNDERSWIM}}
| Caste
|
| The creature is displayed as blue when in [[Water#Depth|7/7 water]]. Used on fish and amphibious creatures which swim under the water.

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

|-
| {{text anchor|USE_CASTE}}
| Creature
|
*new caste token
*old caste token
| Defines a new caste derived directly from a previous caste. The new caste inherits all properties of the old one. The effect of this tag is automatic if one has not yet defined any castes: "Any caste-level tag that occurs before castes are explicitly declared is saved up and placed on any caste that is declared later, unless the caste is explicitly derived from another caste."
Roostre: "When DF detects duplicate tokens in the raws of the same object, a failsafe seems to kick in; it takes the bottom-most of the duplicates, and disregards the others. In the case of tokens added by a mod, it prioritizes the duplicate in the mod." This means that if a tag is defined in the base-caste and redefined in the derived caste, the derived tag overwrites the base tag.

|-
| {{text anchor|USE_MATERIAL}}
| Creature
|
*new material ID
*old material ID
| Defines a new local creature material and populates it with all properties defined in the specified local creature material.

|-
| {{text anchor|USE_MATERIAL_TEMPLATE}}
| Creature
|
*new material token
*material template
| Defines a new local creature material and populates it with all properties defined in the specified template. [http://www.bay12forums.com/smf/index.php?topic=175437.msg8441368#msg8441368 There seems to be a limit of 200 materials per creature].

|-
| {{text anchor|USE_TISSUE}}
| Creature
|
*new tissue token
*old tissue id
| Defines a new local creature tissue and populates it with all properties defined in the local tissue specified in the second argument.

|-
| {{text anchor|USE_TISSUE_TEMPLATE}}
| Creature
|
*new tissue token
*tissue template
| Loads a tissue template listed in OBJECT:TISSUE_TEMPLATE files, such as tissue_template_default.txt.

|-
| {{text anchor|UTTERANCES}}
| Creature
|
| Changes the language of the creature into unintelligible 'kobold-speak', which creatures of other species will be unable to understand. If a civilized creature has this and is not part of a {{token|SKULKING|e}} civ, it will tend to start wars with all nearby civilizations and will be unable to make peace treaties due to 'inability to communicate'.
|}

{{alphabetical TOC|style=margin: 1em auto;}}

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

|-
| {{text anchor|VEGETATION}}
| Caste
|
| Like {{token|AT_PEACE_WITH_WILDLIFE}}, but also makes the creature more valued in artwork by civilisations with the PLANT [[sphere]]. [http://www.bay12forums.com/smf/index.php?topic=169696.msg8316954#msg8316954] Used by [[grimeling]]s in the vanilla game.

|-
| {{text anchor|VERMIN_BITE}}
| Caste
|
*chance of occurrence{{verify}}
*verb (bitten, stung, etc.)
* [[material token]]
* [[Material_definition_token#Material_States|material state]]
| Enables vermin to bite other creatures, injecting the specified material. See {{token|SPECIALATTACK_INJECT_EXTRACT|c}} for details about injection - this token presumably works in a similar manner.{{verify}}

|-
| {{text anchor|VERMIN_EATER}}
| Creature
|
| The vermin creature will attempt to eat exposed food. See {{token|PENETRATEPOWER|c}}. Distinct from {{token|VERMIN_ROTTER|c}}.

|-
| {{text anchor|VERMIN_FISH}}
| Creature
|
| The vermin appears in [[water]] and will attempt to swim around.

|-
| {{text anchor|VERMIN_GROUNDER}}
| Creature
|
| The creature appears in "general" surface ground locations. Note that this doesn't stop the creature from flying if it can (most vermin birds have this tag).

|-
| {{text anchor|VERMIN_HATEABLE}}
| Caste
|
| Some dwarves will [[Preferences|hate]] the creature and get unhappy thoughts when around it. See the [[Hateable|list of hateable vermin]] for details.

|-
| {{text anchor|VERMIN_MICRO}}
| Caste
|
| This makes the creature move in a swarm of creatures of the same race as it (e.g. swarm of flies, swarm of ants).

|-
| {{text anchor|VERMIN_NOFISH}}
| Caste
|
| The creature cannot be caught by [[fishing]].

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

|-
| {{text anchor|VERMIN_NOTRAP}}
| Caste
|
| The creature cannot be caught in baited [[animal trap]]s; however, a "[[Trapper|catch live land animal]]" task may still be able to capture one if a dwarf finds one roaming around.

|-
| {{text anchor|VERMIN_ROTTER}}
| Creature
|
| The vermin are attracted to rotting stuff and loose food left in the open and cause unhappy thoughts to dwarves who encounter them. Present on flies, knuckle worms, acorn flies, and blood gnats.

|-
| {{text anchor|VERMIN_SOIL}}
| Creature
|
| The creature randomly appears near dirt or mud, and may be uncovered by creatures that have the {{token|ROOT_AROUND|c}} interaction such as [[goose|geese]] and [[chicken]]s. Dwarves will ignore the creature when given the "Capture live land animal" task.

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

|-
| {{text anchor|VERMINHUNTER}}
| Caste
|
| Old shorthand for "does cat stuff". Contains {{token|AT_PEACE_WITH_WILDLIFE|c}} + {{token|RETURNS_VERMIN_KILLS_TO_OWNER|c}} + {{token|HUNTS_VERMIN|c}} + {{token|ADOPTS_OWNER|c}}.

|-
| {{text anchor|VESPERTINE}}
| Caste
|
| When set, the creature will only appear in the evening (between 8:00 PM and 10:05 PM) in [[Adventurer mode]].

|-
| {{text anchor|VIEWRANGE}}
| Caste
|
*value
| Value should determine how close you have to get to a critter before it attacks (or prevents adv mode travel etc.) Default is 20.

|-
| {{text anchor|VISION_ARC}}
| Caste
|
*binocular vision arc
*non-binocular vision arc
| The width of the creature's vision arcs, in degrees (i.e. 0 to 360). The first number is binocular vision, the second is non-binocular vision. Binocular vision has a minimum of about 10 degrees, monocular, a maximum of about 350 degrees. Values past these limits will be accepted, but will default to ~10 degrees and ~350 degrees respectively. Defaults are 60:120.
|}

{{alphabetical TOC|style=margin: 1em auto;}}

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

|-
| {{text anchor|WAGON_PULLER}}
| Caste
|
| Allows the creature to pull caravan wagons. If a civilization doesn't have access to any, it is restricted to trading with pack animals.

|-
| {{text anchor|WEBBER}}
| Caste
|
* [[material token]]
| Allows the creature to create [[web]]s, and defines what the webs are made of.

|-
| {{text anchor|WEBIMMUNE}}
| Caste
|
| The creature will not get caught in thick [[web]]s. Used by creatures who can shoot thick webs (such as [[giant cave spider]]s) in order to make them immune to their own attacks.
|}

==Attack Tokens==

Attacks can use four different part selection criteria. Except for TISSUE_LAYER, the base game makes use of all of these in its attacks.

{| {{prettytable}}
|- bgcolor="#ddd"
! width="20%" | Part type token
! width="30%" | Arguments
! width="60%" | Description

|-
| {{text anchor|BODYPART}}
|
* BY_TYPE/BY_TOKEN/BY_CATEGORY
* type/token/category
| This attack uses a particular body part; for example, ATTACK:PUNCH:BODYPART:BY_TYPE:GRASP will make it use any part that can hold onto an object.

|-
| {{text anchor|TISSUE_LAYER}}
|
* BY_TYPE/BY_TOKEN/BY_CATEGORY
* type/token/category
* tissue layer
| This attack uses a specific tissue layer on a specific body part; ATTACK:SCRATCH:TISSUE_LAYER:BY_TYPE:GRASP:BONE will make it use the bone of the hands.

|-
| {{text anchor|CHILD_BODYPART_GROUP}}
|
* BY_TYPE/BY_TOKEN/BY_CATEGORY
* type/token/category
* BY_TYPE/BY_TOKEN/BY_CATEGORY
* type/token/category
| Uses a body part that is subordinate to another; ATTACK:SLAP:CHILD_BODYPART_GROUP:BY_CATEGORY:ARM_LOWER:BY_TYPE:GRASP will make it use every hand attached to each lower arm (so it will generate one attack per lower arm, each of which will use every hand on that arm, assuming there are multiple hands per arm).

|-
| {{text anchor|CHILD_TISSUE_LAYER_GROUP}}
|
* BY_TYPE/BY_TOKEN/BY_CATEGORY
* type/token/category
* BY_TYPE/BY_TOKEN/BY_CATEGORY
* type/token/category
* tissue layer
| As CHILD_BODYPART_GROUP, but specifying a tissue, too; ATTACK:BITE:CHILD_BODYPART_GROUP:BY_CATEGORY:HEAD:BY_CATEGORY:TOOTH

|}

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

|-
| {{text anchor|ATTACK_SKILL}}
| Caste
|
*[[Skill token]]
| Defines the skill used by the attack.

|-
| {{text anchor|ATTACK_VERB}}
| Caste
|
*2nd person
*3rd person
| Descriptive text for the attack.

|-
| {{text anchor|ATTACK_CONTACT_PERC}}
| Caste
|
*% value
| The contact area of the attack, measured in % of the body part's volume. Note that all attack percentages can be more than 100%.

|-
| {{text anchor|ATTACK_PENETRATION_PERC}}
| Caste
|
*% value
| The penetration value of the attack, measured in % of the body part's volume. Requires ATTACK_FLAG_EDGE. Maximum value: 15000.

|-
| {{text anchor|ATTACK_PRIORITY}}
| Caste
|
*MAIN or SECOND
| Usage frequency. MAIN attacks are 100 times more frequently chosen than SECOND. Opportunity attacks ignore this preference.

|-
| {{text anchor|ATTACK_VELOCITY_MODIFIER}}
| Caste
|
*number
| The velocity multiplier of the attack, multiplied by 1000.

|-
| {{text anchor|ATTACK_FLAG_CANLATCH}}
| Caste
|
| Attacks that damage tissue have the chance to latch on in a wrestling hold. The grabbing bodypart can then use the "shake around" wrestling move, causing severe, armor-bypassing tensile damage according to the attacker's body volume.

|-
| {{text anchor|ATTACK_FLAG_WITH}}
| Caste
|
| Displays the name of the body part used to perform an attack while announcing it, e.g. "The weaver punches the bugbat with his right hand".

|-
| {{text anchor|ATTACK_FLAG_EDGE}}
| Caste
|
| The attack is edged, with all the effects on physical resistance and contact area that it entails.

|-
| {{text anchor|ATTACK_PREPARE_AND_RECOVER}}
| Caste
|
* Preparation time
* Recovery time
| Determines the length of time to prepare this attack and until one can perform this attack again. Values appear to be calculated in adventure mode ticks.

|-
| {{text anchor|ATTACK_FLAG_BAD_MULTIATTACK}}
| Caste
|
| Multiple strikes with this attack cannot be performed effectively.

|-
| {{text anchor|ATTACK_FLAG_INDEPENDENT_MULTIATTACK}}
| Caste
|
| Multiple strikes with this attack can be performed with no penalty. The creature will use all attacks with this token at once.

|-
| {{text anchor|SPECIALATTACK_INJECT_EXTRACT}}
| Caste
|
*<[[material token]]>
*<[[Material_definition_token#Material_States|material state]]>
*<min quantity>
*<max quantity>
| When added to an attack, causes the attack to inject the specified material into the victim's bloodstream. Once injected, the material will participate in [[temperature|thermal]] exchange within the creature - injecting something like molten [[iron]] (INORGANIC:IRON:LIQUID) would cause most unmodded creatures to melt (note that some of the injected material also [[contaminant|splatters]] over the bodypart used to carry out the attack, so it should be protected appropriately). If the injected material has an associated [[syndrome]] with the [[Syndrome#SYN_INJECTED|[SYN_INJECTED]]] token, it will be transmitted to the victim. If the attack is blunt, the injected material lacks the [[Material definition token#ENTERS_BLOOD|[ENTERS_BLOOD]]] token, the attacked bodypart has no [[Tissue_definition_token#VASCULAR|[VASCULAR]]] tissues, or the victim is bloodless, the material will splatter over the attacked body part instead.

|-
| {{text anchor|SPECIALATTACK_INTERACTION}}
| Caste
|
*interaction
| When this attack lands successfully, a specified interaction will take effect on the target creature. The attack must break the target creature's skin in order to work. This will take effect in worldgen as well. If the attack would break skin, the interaction will occur '''before the attack actually lands'''.

|-
| {{text anchor|SPECIALATTACK_SUCK_BLOOD}}
| Caste
|
*min
*max
| Successful attack draws out an amount of blood randomized between the min and max value. Beware that this '''will''' trigger any ingestion syndromes attached to the target creature's blood - for example, using this attack on a vampire will turn you into one too.
|}

==Tissue Layer Tokens==
Tissue layers are added to a creature's body parts by the creature tokens [[#TISSUE_LAYER|TISSUE_LAYER]], [[#TISSUE_LAYER_OVER|TISSUE_LAYER_OVER]], [[#TISSUE_LAYER_UNDER|TISSUE_LAYER_UNDER]], and the body detail plan token [[#TL_LAYERS|TL_LAYERS]].

These tissue layers are not the same thing as tissues, which are defined at creature level, but rather applications of the tissues. If the SKIN tissue of a creature is the more general and abstract notion of what skin is for that creature, then a tissue layer may be the "actual" skin on the creature's nose, head, or second toe. As most creatures have more than one body part, tissue layers are normally selected en masse.

Some tissue layer tokens are analogous to tissue definition tokens, e.g. [[#TL_CONNECTS|TL_CONNECTS]] to [[tissue_definition_token#CONNECTS|CONNECTS]].

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

|-
| {{text anchor|SELECT_TISSUE_LAYER}}
| Caste
|
*TISSUE
*BY_CATEGORY, BY_TYPE, BY_TOKEN
*Location - category, type, or token | Selects a tissue at a location
* (optional) FRONT, BACK, LEFT, RIGHT, TOP, BOTTOM, AROUND.
| Begins a selection of tissue layers.
[SELECT_TISSUE_LAYER:HEART:BY_TYPE:HEART]

|-
| {{text anchor|PLUS_TISSUE_LAYER}}
| Caste
|
*TISSUE
*BY_CATEGORY, BY_TYPE, BY_TOKEN
*Location - category, type, or token
| Adds tissue layers to those selected.

|-
| {{text anchor|SET_TL_GROUP}}
| Caste
|
*TISSUE
*BY_CATEGORY, BY_TYPE, BY_TOKEN
*Location - category, type, or token
*tissue
| Begins a selection of tissue layers. Only usable for descriptor and cosmetic purposes.

Research has implied it may be redundant with SELECT_TISSUE_LAYER, as the latter allows for cosmetics as well as "functional" tokens such as TL_MAJOR_ARTERIES. Vanilla raws still use SET_TL_GROUP though, for all cosmetic purposes. More research is needed on this subject.

|-
| {{text anchor|PLUS_TL_GROUP}}
| Caste
|
*BY_CATEGORY, BY_TYPE, BY_TOKEN
*Location - category, type, or token
*tissue
| Adds tissue layers to those selected. Like SET_TL_GROUP, it may be redundant even if used in the vanilla raws.

|-
| {{text anchor|SET_LAYER_TISSUE}}
| Caste
|
*TISSUE
| Sets a selected tissue layer to be made of a different tissue.

|-
| {{text anchor|SHEARABLE_TISSUE_LAYER}}
| Caste
|
* tissue modifier
* required value
| Tissue layer can be sheared for its component material. The specified modifier must be at least of the desired value for shearing to be possible (for example, a [[llama]]'s wool must have a LENGTH of 300 before it is shearable).

|-
| {{text anchor|TISSUE_LAYER_APPEARANCE_MODIFIER}}
| Caste
|
*QUALITY
*lowest
*lower
*low
*median
*high
*higher
*highest
| Sets the range of qualities, including LENGTH, DENSE, HIGH_POSITION, CURLY, GREASY, WRINKLY

|-
| {{text anchor|TISSUE_STYLE_UNIT}}
| Caste
|
*tissue style unit ID
*shaping
| Sets tissue layer to be the target of TISSUE_STYLE token specified for an entity, works only on entity members. Mostly used with tissues HAIR, BEARD, MOUSTACHE, SIDEBURNS.

|-
| {{text anchor|TL_COLOR_MODIFIER}}
| Caste
|
*COLOR
*freq
*COLOR
*freq etc.
| Creates a list of colors/color patterns, giving each a relative frequency. If the given color or pattern does not exist, the tissue is described as being "transparent".

|-
| {{text anchor|TLCM_GENETIC_MODEL}}
| Caste
|
| The way the color modifier is passed on to offspring. May or may not work right now.{{verify}}

|-
| {{text anchor|TLCM_IMPORTANCE}}
| Caste
|
*number
| Presumably modifies the importance of the tissue layer color modifier, for description purposes.
HOWEVER using this appears to remove all mention of colour from creature descriptions. It does not appear in any default creatures.

|-
| {{text anchor|TLCM_NOUN}}
| Caste
|
*name
*SINGULAR or PLURAL
| Names the tissue layer color modifier, and determines the noun. Also used by [[Utility:Stonesense|Stonesense]] for colouring body parts.

|-
| {{text anchor|TLCM_TIMING}}
| Caste
|
*ROOT
*start change window years
*days
*end change window years
*days
| Determines the point in the creature's life when the color change begins and ends.

|-
| {{text anchor|TL_CONNECTS}}
| Caste
|
| Gives the CONNECTS attribute to selected layers.

|-
| {{text anchor|TL_HEALING_RATE}}
| Caste
|
*value
| Changes the HEALING_RATE of the selected tissue layers.

|-
| {{text anchor|TL_MAJOR_ARTERIES}}
| Caste
|
| Gives the "major arteries" attribute to selected layers. Used to add massive bleeding properties to the throat, made from skin.

|-
| {{text anchor|TL_PAIN_RECEPTORS}}
| Caste
|
*value
| Changes the number of pain receptors for selected tissue layers.

|-
| {{text anchor|TL_RELATIVE_THICKNESS}}
| Caste
|
*value
| Changes the relative thickness for selected tissue layers.

|-
| {{text anchor|TL_VASCULAR}}
| Caste
|
*value
| Sets a new VASCULAR value (which modulates bleeding) for selected tissue layers.

|}

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

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

Syndrome

2025-06-21T19:38:05Z

DikbutDaGrate: Updating a sentence

{{Quality|Masterwork}}
{{av}}
[[File:syndrome_statuses_anim.gif|right]]In ''Dwarf Fortress'', a '''syndrome''' can be thought of as a condition which applies a collection of [[Syndrome#Creature Effect Tokens|effects]] to [[creature]]s who contract it. Syndromes give rise to several of the game's [[fun|more interesting]] [[Health care|medical]] [[Status_icon|predicaments]], such as [[alcohol]] inebriation, venomous snake bites, and the brain-rotting secretions of certain [[Forgotten beast|uninvited guests]]. That said, the syndrome system isn't functionally restricted to the simulation of disease - many of the game's supernatural features, such as [[werewolf|werewolves]], [[vampire]]s, [[necromancer]]s, [[mummy|mummy curses]] and the [[undead]], are in fact produced by applying various [[Syndrome#Special_Effects|special effects]] to creatures via syndromes.

Graphically, [[Dwarf|dwarves]], [[human]]s, [[elf|elves]], [[goblin]]s and [[kobold]]s with supernatural syndromes will have a different skin color, as seen in the image to the right. Other creatures will appear exactly as they are with no alterations, unless they're undead, in which they will appear with an indigo/blue tint, black eyes and white pupils, as every creature will have a unique undead sprite (including that of children and babies for some creatures).

''"Yeah, I know this. I was looking for [[Syndrome examples|modded examples]]..."''
[[File:skin_color_preview.png|thumb|right|What different undead/immortal creatures' skin colors mean, which are also syndromes.]]
==List of syndromes==
In unmodded games, syndromes are generally named after the animal, substance or effect that delivers them. They can cause unpleasant and sometimes fatal [[symptom]]s over a short to long duration, 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 those that can be helped by treatment. Note that in a world with [[dragon]]s and [[giant elephant]]s, dwarves (and elves and humans) fall into the "small creatures" category for purposes of this discussion.
{| {{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 Blisters Nausea
| None
|-
| 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 Drowsiness Strong pain Fever Unconsciousness Complete paralysis1
| None
| None
|-
| Blob blisters
| cave blob fluid (contact or ingested)
| Touching a [[cave blob]]
| Mild pain 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 Fever Pain 
| Severe localized necrosis
| None
|-
| Bumblebee sting
| bumblebee venom (injected)
| Being stung by a [[bumblebee]] worker
| Pain Strong swelling
| None
| None
|-
| Bushmaster bite
| bushmaster venom (injected)
| Being bitten by a [[bushmaster]], [[giant bushmaster]] or [[bushmaster man]]
| Strong pain Mild bleeding Dizziness Nausea Unconsciousness Complete paralysis1
| None
| None
|-
| Cave floater sickness
| cave floater gas (inhaled or ingested)
| Expelled from [[cave floater]]
| Mild nausea
| Fever Strong drowsiness (delayed) Strong dizziness (delayed)
| None
|-
| Cave spider bite
| cave spider venom (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 Swelling Nausea
| None
| None
|-
| Giant cave spider bite
| giant cave spider venom (injected)
| Being bitten by a [[giant cave spider]]
| Size-dependant paralysis.
| Death by asphyxiation, in small targets. Large targets are generally unhindered...unless you count the high probability of being eaten by the giant cave spider as a hindrance.
| None, not that it really matters.
|-
| Gila monster bite
| gila monster venom (injected)
| Being bitten by a [[gila monster]], [[giant gila monster]] or [[gila monster man]]
| Pain Mild swelling
| None
| None
|-
| Gnomeblight
| [[gnomeblight]] (contact, inhaled, injected, or ingested)
| Purposely exposing oneself to the extract. Only affects [[mountain gnome]]s and [[dark gnome]]s.
| None
| Severe systemic necrosis2
| None
|-
| Giant desert scorpion sting
| giant desert scorpion venom (injected)
| Being stung by a [[giant desert scorpion]]
| Necrosis of the brain and nervous system
| '''Certain death'''
| None, not that it really matters.
|-
| Helmet snake bite
| helmet snake venom (injected)
| Being bitten by a [[helmet snake]]
| Minor bleeding
| Fever Nausea Dizziness Localized swelling Localized oozing Localized bruising Strong pain Intense localized necrosis Possible loss of limb
| None
|-
| Honey bee sting
| honey bee venom (injected)
| Being stung by a [[honey bee]] worker
| Pain Strong swelling
| None
| None
|-
| Inebriation
| [[Alcohol]] (consumed/injected)
| Consuming alcoholic drinks
| Nausea Dizziness Unconsciousness Personality changes Euphoria Erratic behavior Trouble breathing
| None
| None
|-
| Iron man cough
| iron man gas (inhaled)
| Expelled by [[iron man]]
| Coughing blood
| None
| None
|-
| King cobra bite
| king cobra venom (injected)
| Being bitten by a [[king cobra]]
| Complete paralysis1 Pain, dizziness, drowsiness
| None
| None
|-
| Phantom spider bite
| phantom spider venom (injected)
| Being bitten by a [[phantom spider]]
| None
| Numbness and mild dizziness
| None
|-
| Platypus sting
| platypus venom (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 (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 (injected)
| Being bitten by a [[serpent man]]
| Complete paralysis1
| None
| None
|-
| Mummy's curse
| [[Mummy|Disturbance interaction]].
| Being cursed by a [[mummy]], when caught raiding their tombs
| None
| None
| 20% chance of any skill roll failing, regardless of skill.
|-
| Vampirism
| [[Deity|Divine]] curse
| Drinking the blood of a [[vampire]]. Toppling statues in shrines and temples (random chance), rolling divination dice too frequently.
| None
| None
| Victim becomes a [[vampire]].
|-
| Werebeast curse
| [[Deity|Divine]] curse
| Being bitten by a [[werebeast]], toppling statues in shrines and temples (random chance), rolling divination dice too frequently.
| None
| None
| Victim becomes a [[werebeast]].
|-
| Necromancy
| Secret
| Reading a book/slab that contains the secrets of life and death.
| None
| None
| Reader becomes a [[necromancer]].
|-
| evil rain sickness3
|rowspan=7| Random
| Being caught outside in [[Weather#Evil weather|freakish weather]] in an evil [[biome]]
|rowspan=7| Random
|rowspan=7| Random
|rowspan=7| Random
|-
| evil cloud sickness4
| Being caught in a [[Weather#Evil weather|creeping cloud]] in an evil [[biome]]
|-
| beast sickness5
| Encounters with [[forgotten beast]]s
|-
| titan sickness5
| Encounters with [[titan]]s
|-
| night sickness5
| Encounters with [[nightmare]]s or [[experiment]]s
|-
| demon sickness5
| Encounters with [[demon]]s
|-
| divine sickness5
| Encounters with [[angel]]s
|}
: 1. For small creatures such as humans and dwarves, paralysis tends to result in suffocation.
: 2. Necrosis of the brain will eventually result in death once the brain rots away completely.
: 3. Evil rain typically only causes minor symptoms such as blisters, bruising, coughing blood, dizziness, fever, nausea, oozing, and pain.
: 4. Evil clouds either cause major symptoms (as with beast/titan/demon sicknesses) or permanently transform creatures into [[Undead|zombie-like]] forms.
: 5. [[Titan]]s, [[forgotten beast]]s, [[nightmare]]s, [[experiment]]s, [[demon]]s and [[angel]]s have a chance to have a randomized syndrome. These range from mildly hazardous (mild [[Symptom#Blisters|blisters]] from inhaling boiling blood) to instantly fatal (severe necrosis from a contact poison attached to a breath weapon/creature made of blood).

==The anatomy of a syndrome==
To recap, syndromes are "diseases" which inflict effects upon creatures who acquire them. Mechanically, they're composed of a bunch of different syndrome tokens which detail [[Syndrome#Basic syndrome tokens|how it works]] and [[Syndrome#Creature effect tokens|what it does]]. Syndrome acquisition can be boiled down into two main routes: (1) via materials and (2) via interactions. Unlike most objects in the game, syndromes aren't defined in their own raw file; they're instead built up within the raw definition of the material or interaction effect to which they are tied, as described below.
{{Modding}}
'''1) Transmission via Materials'''
Any material (be it [[Material_token#INORGANIC|inorganic]], [[Material_token#CREATURE_MAT|creature-derived]], or [[Material_token#PLANT_MAT|plant-derived]]) can have one or more syndromes added to it, simply by defining the syndrome within the material's own raw definition. The addition of certain tokens (detailed [[Syndrome#SYN_CONTACT|below]]) to the syndrome will determine what must be done to the material so as to transmit the syndrome to a creature; the current modes of transmission are as follows: [[Syndrome#SYN_CONTACT|bodily contact]] with the material, [[Syndrome#SYN_INGESTED|ingestion]] or [[Syndrome#SYN_INHALED|inhalation]] of the material, or [[Syndrome#SYN_INJECTED|injection]] of the material into the bloodstream. Any combination of transmission modes can be specified per syndrome.

Here's the material definition of [[giant cave spider]] venom with its associated syndrome as an example:

''(See [[Giant cave spider/raw|here]] for the complete creature raw.)''
[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_GIANT:ALL]'''
'''[SYN_INJECTED]'''
'''[CE_PARALYSIS:SEV:100:PROB:100:RESISTABLE:SIZE_DILUTES:START:5:PEAK:10:END:20]'''

In the above, the non-bolded section consists of various [[material definition token]]s used to define and customise the venom material. (USE_MATERIAL_TEMPLATE defines a material called 'POISON', and creates it using the template 'CREATURE_EXTRACT_TEMPLATE' as a basis, which is then altered by the other tokens placed below it. See [[Material_definition_token#STATE_NAME|STATE_NAME]], [[Material_definition_token#STATE_ADJ|STATE_ADJ]], and [[Material_definition_token#PREFIX|PREFIX]] for more information about these tokens). The relevance of [[Material_definition_token#ENTERS_BLOOD|ENTERS_BLOOD]] in this context is explained below.

The bolded section consists of the syndrome definition, which is initiated using the [[Syndrome#SYNDROME|[SYNDROME]]] token. The tokens placed after this (which are described in further detail [[Syndrome#Basic syndrome tokens|below]]) flesh out the syndrome - in this case they name it "giant cave spider bite", make it work only against creatures belonging to the 'GENERAL_POISON' [[Creature token#CREATURE_CLASS|creature class]], render giant cave spiders immune to it, and cause creatures to contract it if the venom is injected into them. The creature effect at the very bottom makes the syndrome inflict progressive complete paralysis upon the victim after a short delay, for what would be a relatively short-lived period were it not for the fact that most small creatures tend to suffocate before the effect wears off (that, or they get eaten by the giant cave spider that caused it).

Great, so how do we get this lethal venom into a creature's bloodstream to transmit the syndrome? Giant cave spiders are able to do this via the [[Creature token#SPECIALATTACK_INJECT_EXTRACT|SPECIALATTACK_INJECT_EXTRACT]] token appended to their bite attack as such:
[SPECIALATTACK_INJECT_EXTRACT:LOCAL_CREATURE_MAT:POISON:LIQUID:100:100]
This makes their bites inject 100 units of the 'POISON' material in its liquid [[Material_definition_token#Material_States|state]]. Note that '[[Material_token#LOCAL_CREATURE_MAT|LOCAL_CREATURE_MAT]]:POISON' indicates that the 'POISON' material is defined amidst the same creature raws where the attack was detailed i.e. within the SPIDER_CAVE_GIANT creature definition; we could have written '[[Material_token#CREATURE_MAT|CREATURE_MAT]]:SPIDER_CAVE_GIANT:POISON' instead for the same result. Also note that we can make the attack inject any material we want it to, not just creature-associated materials. (Want your spider to inject molten [[gold]] into its victims to melt them from the inside out instead of bothering with syndromes? Simply replace 'LOCAL_CREATURE_MAT:POISON:LIQUID' with '[[Material_token#INORGANIC|INORGANIC]]:GOLD:LIQUID' and you're good to go).

Note that [ENTERS_BLOOD] must be added to the material definition for injection attacks making use of this material to function properly. Without this token, the material would simply [[contaminant|splatter]] over the attacked bodypart instead of entering the bloodstream, so the above syndrome, which relies solely on the [[Syndrome#SYN_INJECTED|injectable]] transmission route, wouldn't be contracted. [ENTERS_BLOOD] can of course be left out intentionally, if the aim is to cover creatures with a material that transmits syndromes [[Syndrome#SYN_CONTACT|on contact]]. Keep in mind that splattering in lieu of injection also occurs with blunt attacks, on attacked body parts devoid of [[Tissue_definition_token#VASCULAR|VASCULAR]] tissue, and on [[Creature token#BLOOD|bloodless]] victims (including creatures who've had their blood removed via [[Syndrome#CE_REMOVE_TAG|CE_REMOVE_TAG:HAS_BLOOD]]).

A fun variation on typical creature venoms is to add a [[Syndrome#SYN_CONTACT|contact-transmissible]] syndrome to the creature's [[Creature token#BLOOD|blood]] material - this tends to end poorly for any predator that chooses to attack them.

'''2) Transmission via Interactions'''

The [[Interaction token|interaction]] system can be used to add syndromes to creatures directly via certain interaction effects, most notably [[Interaction token#I_EFFECT|I_EFFECT:ADD_SYNDROME]]. After placing this I_EFFECT in an interaction definition, the syndrome to be added is defined beneath it in exactly the same manner as that used for the material-bound syndromes described above. (Note that any [[Interaction_token#IE_TARGET|IE_ tokens]] used with this I_EFFECT can be placed before or after the syndrome definition; the order doesn’t really matter). The [[Interaction token#I_EFFECT| ANIMATE]] and [[Interaction token#I_EFFECT| RESURRECT]] interaction effects also allow syndromes to be tied to them in the same manner; in this case the syndrome is applied to the target creature after it is animated or resurrected respectively.

See [[Syndrome#Spreading_diseases|below]] for an example of a syndrome-transmitting interaction.

==Basic syndrome tokens==

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

|-
| {{text anchor|SYNDROME}}
|
| Used to begin defining a new syndrome.

|-
| {{text anchor|SYN_NAME}}
| <your text>
| Used to specify the name of the syndrome as it appears in-game. Names don't have to be unique; it's perfectly acceptable to have multiple syndromes with identical names.

For example, this name is displayed when <nowiki>[</nowiki>[[Syndrome#CE_FEEL_EMOTION|CE_FEEL_EMOTION:<...>]]] causes an emotional reaction {{dftext|Urist is |0:1}}{{dftext|<emotion>|6:0}}{{dftext| due to <your_syn_name>.|0:1}}

|-
| {{text anchor|SYN_CLASS}}
| <your text>
| Can be included to create a syndrome class and assign the syndrome to it, for use with the [[Interaction token#IT_CANNOT_HAVE_SYNDROME_CLASS|IT_CANNOT_HAVE_SYNDROME_CLASS]] interaction token. Can be specified more than once to assign the syndrome to multiple classes. Other syndromes can also be assigned to the same class.

|-
| {{text anchor|SYN_CONTACT}}
|
| If the syndrome is tied to a material, creatures who come into contact with this material will contract the syndrome if this token is included in the syndrome definition. Contact transmission occurs when a creature's body becomes [[contaminant|contaminated]] with the material (visible as [material name] 'smear', 'dusting' or 'covering' over body parts when viewing the creature's inventory). Note that contact with [[item]]s made of a syndrome-inducing material currently doesn't result in transmission.

Methods of getting a material contaminant onto a creature's body include:
* [[Creature token#SECRETION|secretions]]
* [[Interaction_token#LIQUID_GLOB|liquid projectiles]] (contaminate struck body parts if exposed)
* [[Interaction_token#TRAILING_VAPOR_FLOW|vapor]] and [[Interaction_token#TRAILING_DUST_FLOW|dust clouds]] (contaminate all external body parts, even if covered)
* [[Interaction_token#SPATTER_LIQUID|puddles]] and [[Interaction_token#SPATTER_POWDER|dust piles]] ([[Body_token#STANCE|STANCE]] body parts become contaminated if the creature walks into them [[clothing|barefoot]], and all uncovered external body parts are contaminated if the creature is [[Status icon#Non-flashing|prone]])
* [[Interaction_token#WEATHER_FALLING_MATERIAL|freakish rain]] (contaminates all external body parts, even if covered, if the creature is outside)
* unprotected bodily contact with a contaminated creature (including performing or receiving body part attacks such as punches and [[wrestling]] moves, creature collisions, as well as [[Interaction_token#I_EFFECT|CONTACT]] interaction effects, if the involved body parts are exposed)
* items [[Material_definition_token#MELTING_POINT|melting]] whilst equipped or hauled (this contaminates the body part that was holding them if exposed)
* striking the creature's body with a contaminated item (see below)

It is possible to use this token for syndromes intended to be applied via envenomed weapons (but also check out [[Syndrome#SYN_INJECTED|SYN_INJECTED]]). When a creature's body is struck with an item which is contaminated with a contact syndrome-inducing material, the syndrome will be transmitted to the struck creature, even if the attack doesn't pierce the flesh. Syndrome transmission in this context often occurs in the absence of a visible contaminant on the body.

Contact transmission only appears to occur at the moment of contamination (which is to say, when a new bodily spatter is created). If the syndrome ends (once all its [[Syndrome#Creature_effect_tokens|creature effects]] reach their END point, at which point it will be removed from the creature), it will NOT be reapplied by the original syndrome-inducing contaminant (assuming it hasn't been cleaned off yet); the creature will need to be recontaminated with the causative material for this to occur. (Note that in the case of [[Creature token#SECRETION|secretions]], the secreted contaminants are continuously reapplied to the secretory body parts, so any associated short-lasting contact syndromes allowed to target the secreting creature can potentially be reapplied at the rate of secretion; this may work differently in [[adventurer mode]]).

|-
| {{text anchor|SYN_INGESTED}}
|
| If the syndrome is tied to a material, creatures who [[food|eat]] or drink substances comprising, containing or [[contaminant|contaminated]] with this material will contract the syndrome if this token is included. This includes [[kitchen|prepared meals]] when any of the constituent ingredients contains the material in question.

This also applies to [[creature token#GRAZER|grazing]] creatures which happen to munch on a [[plant token#GRASS|grass]] that has an ingestion-triggered syndrome tied to any of its constituent materials.

|-
| {{text anchor|SYN_INHALED}}
|
| If the syndrome is tied to a material, creatures who inhale the material will contract the syndrome if this token is included. Materials can only be inhaled in their [[Material_definition_token#BOILING_POINT|gaseous]] state, which is attainable by [[temperature|boiling]], or in the form of a [[Interaction_token#TRAILING_GAS_FLOW|TRAILING_GAS_FLOW]], [[Interaction_token#UNDIRECTED_GAS|UNDIRECTED_GAS]] or [[Interaction_token#WEATHER_CREEPING_GAS|WEATHER_CREEPING_GAS]]. Creatures can also be made to [[Tissue_definition_token#TISSUE_LEAKS|leak]] [[Tissue_definition_token#TISSUE_MAT_STATE|gaseous tissue]] when damaged.

Note that {{token|AQUATIC|c}} creatures never inhale gaseous materials, and creatures which do breathe air aren't guaranteed to inhale gases when exposed to them for a short time. Contrary to what one might expect, creatures with {{token|NOBREATHE|c}} are in fact capable of contracting inhalation syndromes; this is presumably a bug.

|-
| {{text anchor|SYN_INJECTED}}
|
| If the syndrome is tied to a material, the injection of this material into a creature's bloodstream will cause it to contract the syndrome if this token is included. Injection can be carried out as part of a creature attack via [[Creature_token#SPECIALATTACK_INJECT_EXTRACT|SPECIALATTACK_INJECT_EXTRACT]], or by piercing the flesh of a creature with an [[item]] that has been [[contaminant|contaminated]] with the material. Thus, this token can be used as a more specific alternative to [[Syndrome#SYN_CONTACT|SYN_CONTACT]] for syndromes intended to be administered by envenomed weapons.

For injection to work, the material definition must include [[Material_definition_token#ENTERS_BLOOD|ENTERS_BLOOD]], the attacked body part needs to have [[Tissue_definition_token#VASCULAR|VASCULAR]] tissue, and the intended victim must have [[Creature token#BLOOD|BLOOD]] (so it won't work on creatures with the [[Syndrome#CE_REMOVE_TAG|CE_REMOVE_TAG:HAS_BLOOD]] syndrome effect). Getting the weapon "lodged into the wound" isn't a requirement.

|-
| {{text anchor|SYN_AFFECTED_CLASS}}
| <[[Creature token#CREATURE_CLASS|creature class]]>
| If this is included, only creatures which belong to the specified [[Creature token#CREATURE_CLASS|creature class]] (as well as creatures which pass the [[Syndrome#SYN_AFFECTED_CREATURE|SYN_AFFECTED_CREATURE]] check if this is included) will be able to contract the syndrome. This token can be specified multiple times per syndrome, in which case creatures which have at least one matching class will be considered susceptible. If [[Syndrome#SYN_IMMUNE_CLASS|SYN_IMMUNE_CLASS]] and/or [[Syndrome#SYN_IMMUNE_CREATURE|SYN_IMMUNE_CREATURE]] are included, creatures which fail these checks will be unable to contract the syndrome even if they pass this class check.

|-
| {{text anchor|SYN_IMMUNE_CLASS}}
| <[[Creature token#CREATURE_CLASS|creature class]]>
| If this is included, creatures which belong to the specified [[Creature token#CREATURE_CLASS|creature class]] will be unable to contract the syndrome. This token can be specified multiple times per syndrome, in which case creatures with at least one matching class will be considered immune (unless overridden by [[Syndrome#SYN_AFFECTED_CREATURE|SYN_AFFECTED_CREATURE]]).

|-
| {{text anchor|SYN_AFFECTED_CREATURE}}
| <creature>:<[[Creature_token#CASTE|caste]]>
| If this is included, only the specified creature (and, if [[Syndrome#SYN_AFFECTED_CLASS|SYN_AFFECTED_CLASS]] is included, also creatures which pass this check as explained above) will be able to contract the syndrome. This token can be used multiple times per syndrome. If used alongside [[Syndrome#SYN_IMMUNE_CLASS|SYN_IMMUNE_CLASS]], the specified creature will be able to contract the syndrome regardless of this class check.

DWARF:FEMALE is an example of a valid <creature>:<caste> combination; "ALL" can be used in place of a specific caste so as to indicate that this applies to all castes of the specified creature.

|-
| {{text anchor|SYN_IMMUNE_CREATURE}}
| <creature>:<[[Creature_token#CASTE|caste]]>
| If this is included, the specified creature will be unable to contract the syndrome (even if it matches [[Syndrome#SYN_AFFECTED_CLASS|SYN_AFFECTED_CLASS]]). It can be specified multiple times per syndrome. As above, "ALL" can be used in place of a specific caste.

|-
| {{text anchor|SYN_NO_HOSPITAL}}
|
| Prevents creatures from being admitted to [[health care|hospital]] for problems arising directly as a result of the syndrome's effects, no matter how bad they get.

|-
| {{text anchor|SYN_IDENTIFIER}}
| <your text>
| This token can be included to give a syndrome an identifier which can be shared between multiple syndromes. Only one identifier may be specified per syndrome.

Syndrome identifiers can be used in conjunction with the [[Creature token#SYNDROME_DILUTION_FACTOR|SYNDROME_DILUTION_FACTOR]] creature token to alter a creature’s innate resistance to the relevant [[Syndrome#Symptomatic effects|effects]] of any syndromes that possess the specified identifier. For example, every [[alcohol|alcoholic beverage]] in unmodded games comes with its own copy of an intoxicating syndrome, each of which has a <code>[SYN_IDENTIFIER:INEBRIATION]</code> token. All [[dwarf|dwarves]] have <code>[SYNDROME_DILUTION_FACTOR:INEBRIATION:150]</code>, which decreases the severity of any effects derived from a syndrome with the INEBRIATION identifier, thus enabling them to better handle all forms of alcohol.

When a creature gets a new syndrome with the same SYN_IDENTIFIER, it merges the effects of the new syndrome into the old one, resetting any overlapping syndrome effects to their PEAK time. If the new one comes with a [[Syndrome#SYN_CONCENTRATION_ADDED|SYN_CONCENTRATION_ADDED]] token, it will additionally adjust the first syndrome's concentration on any overlapping syndrome effects as described below. Taking the above example once again, a sober dwarf drinking their first alcoholic beverage would be exposed to an INEBRIATION syndrome, contracting it and having its effects manifest normally. If the dwarf were to have another drink before the effects of this first syndrome have all worn off (by reaching their [[Syndrome#Creature effect tokens|END]] point), then exposure to the second INEBRIATION syndrome would increase the severity of the original syndrome's effects, making the dwarf progressively more intoxicated, and reset the timer on inebriation to its PEAK.

|-
| {{text anchor|SYN_CONCENTRATION_ADDED}}
| <amount>:<max>
| Syndrome concentration is essentially a quantity which impacts the severity of the syndrome's relevant [[Syndrome#Symptomatic effects|effects]]. The higher the syndrome's concentration, the greater its severity. When a syndrome is contracted, the value specified in <amount> is its initial concentration level.

As described above, if a creature is exposed to a syndrome with a particular [[Syndrome#SYN_IDENTIFIER|SYN_IDENTIFIER]] when already possessing an active syndrome with the same identifier, then this later syndrome isn't contracted, instead contributing to the original syndrome's concentration as indicated by its SYN_CONCENTRATION_ADDED token, if present. The syndrome in question will increase the original syndrome's concentration by <amount> whenever the creature is exposed to it, until its specified <max> concentration is reached by the original syndrome, causing subsequent exposure to this particular syndrome to do nothing (that is, until the original syndrome ends, at which point a new one may be contracted normally). Should the creature be exposed to a different syndrome with the same identifier and a higher <max> value, the concentration will of course increase further.

For example, all forms of [[alcohol]] in the vanilla game have a syndrome with <code>[SYN_IDENTIFIER:INEBRIATION]</code> and <code>[SYN_CONCENTRATION_ADDED:100:1000]</code>. When alcohol is first drunk, the creature contracts the relevant inebriating syndrome at a concentration level of 100. Every subsequent drink will increase the concentration of this first syndrome by a further 100, intensifying its effects, until it plateaus at concentration level 1000. Once all the effects of the original syndrome have ended, the cycle can be started anew (assuming the drinker hasn't died of [[Alcohol#Alcohol_poisoning|alcohol poisoning]] yet). As described by Toady, "Each 100 of <amount> will contribute SEV in general to each effect (before [[Creature token#SYNDROME_DILUTION_FACTOR|dilution]]), <max> goes up to 1000. The concentration does not decrease, but will stay at the maximum attained until the syndrome wears off."

Some of the generated interaction-derived syndromes come with <code>[SYN_CONCENTRATION_ADDED:1000:0]</code>. According to Toady, this "was a precaution after I had one bug with effects not fully manifesting due to low levels. It may not be necessary, but I decided to give everybody a full dose of the juice until I could get a closer look at it." [http://www.bay12forums.com/smf/index.php?topic=169696.msg8083872#msg8083872]
|}

==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) ends it, the order of the intervening tokens isn't important.

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

|-
| {{text anchor|CE_X}}
|
| The effect type. This can be a number of different tokens, as detailed in the tables that follow this one.

|-
| {{text anchor|SEV}}
| <amount>
| The severity of the effect. Higher values appear to be worse, with SEV:1000 CE_NECROSIS causing a part to near-instantly become rotten. Can go as high as 2147483647, and can be negative.

|-
| {{text anchor|PROB}}
| <amount>
| The probability of the effect actually manifesting in the victim, as a percentage. 100 means always, 1 means a 1 in 100 chance.

|-
| {{text anchor|BP}}
| <body part>:<tissue>
| (Optional; overridden by [[Syndrome#LOCALIZED|LOCALIZED]]) Specifies which body parts and tissues the effect is to be applied to. Not every effect requires a target!

<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 by the [BP] token of the body plan definition. For example, if you wanted to target the lungs of a creature, you would use BP:BY_CATEGORY:LUNG:ALL. The effect would act on all body parts 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 body parts. Multiple targets can be given in one effect 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 body parts relevant to the contagion, like lungs for coal dust inhalation, or the eyes for exposure to an acid gas.

|-
| {{text anchor|LOCALIZED}}
|
| (Optional; overrides [[Syndrome#BP|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 - i.e. 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 (such as IMPAIR_FUNCTION on a non-organ) then this token makes the effect do nothing. This token also makes inhaled syndromes have no effect.

|-
| {{text anchor|VASCULAR_ONLY}}
|
| (Optional) This effect only affects tissue layers with the VASCULAR token.

|-
| {{text anchor|MUSCULAR_ONLY}}
|
| (Optional) This effect only affects tissue layers with the MUSCULAR token.

|-
| {{text anchor|SIZE_DILUTES}}
|
| (Optional) This token presumably causes the severity of the effect 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.

|-
| {{text anchor|SIZE_DELAYS}}
|
| (Optional) As above, this token has yet to be tested but presumably delays the onset of an effect according to the size of the victim.

|-
| {{text anchor|CAN_BE_HIDDEN}}
|
| (Optional) Can be hidden by a unit assuming a secret identity, such as a [[vampire]]. {{verify}}

|-
| {{text anchor|RESISTABLE}} (sic)
|
| (Optional) Whether a syndrome can build tolerance by exposure. If this token is present, each application of the syndrome will cause future applications to be weaker. This seems to be a permanent effect that does not fall off over time. (yes, it's spelled incorrectly)

|-
| {{text anchor|DWF_STRETCH}}
| <amount>
| (Optional) Multiplies the duration values of the effect by the specified amount in Fortress mode.

|-
| {{text anchor|ABRUPT_START}}
|
| (Optional) Makes the effect begin immediately rather than ramping up.

|-
| {{text anchor|ABRUPT_END}}
|
| (Optional) Makes the effect end immediately rather than ramping down.

|-
| {{text anchor|ABRUPT}}
|
| (Optional) Combination of ABRUPT_START and ABRUPT_END.

|-
| {{text anchor|START}}
| <time>
| Determines the time after exposure, in ticks, when the effect starts. Required for all effects.

|-
| {{text anchor|PEAK}}
| <time>
| (Optional) Determines the time after exposure, in ticks, when the effect reaches its peak intensity.

|-
| {{text anchor|END}}
| <time>
| (Optional) Determines the time after exposure, in ticks, when the effect ends.
|}

A key point that needs to be understood with regards to damaging syndrome effects such as [[Syndrome#CE_BRUISING|bruising]] is that they deal a quantity of damage (based on the effect's SEV and other modifiers) '''every [[time|tick]]''', and this damage accumulates over time. Thus, even a bruising effect at the lowest possible severity value '''will''' eventually lead to destruction of the affected body part(s) if the effect has a long enough duration. Similarly, [[Syndrome#Healing_Effects|healing effects]] undo a specific amount of damage every tick whilst the effect lasts.

===Symptomatic Effects===

The following table contains [[Syndrome#Creature effect tokens|creature effect tokens]] which cause purely medical [[symptom]]s.

Non-targeted effects will ignore any BP tokens and LOCALIZED tokens.

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!

{| {{prettytable}}
|- bgcolor="Bisque"
! Token
! Accepts Target
! Description
|-
| {{text anchor|CE_BRUISING}}
| Yes
| Causes the targeted body part to undergo bruising.
|-
| {{text anchor|CE_BLISTERS}}
| Yes
| Covers the targeted body part with blisters.
|-
| {{text anchor|CE_OOZING}}
| Yes
| Causes pus to ooze from the afflicted body part.
|-
| {{text anchor|CE_BLEEDING}}
| Yes
| Causes the targeted body part 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.
|-
| {{text anchor|CE_SWELLING}}
| Yes
| Causes the targeted body part to swell up. Extreme swelling may lead to necrosis.
|-
| {{text anchor|CE_NECROSIS}}
| Yes
| Causes the targeted body part to rot, with associated tissue damage, miasma emission and bleeding. The victim slowly bleeds to death if the wound is not treated. Badly necrotic limbs will require amputation.
|-
| {{text anchor|CE_NUMBNESS}}
| Optional
| Causes numbness in the affected body part, blocking pain. Extreme numbness may lead to sensory nerve damage. If no target is specified this applies to all body parts.
|-
| {{text anchor|CE_PAIN}}
| Optional
| Afflicts the targeted body part with intense pain. If no target is specified this applies to all body parts.
|-
| {{text anchor|CE_PARALYSIS}}
| Optional
| Causes complete paralysis of the affected body part. Paralysis on a limb may lead to motor nerve damage. If no target is specified this causes total paralysis, which can lead to suffocation of smaller creatures.
|-
| {{text anchor|CE_IMPAIR_FUNCTION}}
| Yes
| An organ afflicted with this effect 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. Note that this effect is currently bugged, and will not "turn off" until the creature receives a wound to cause its body parts to update.
|-
| {{text anchor|CE_DIZZINESS}}
| No
| Inflicts the Dizziness condition, occasional fainting and a general slowdown in movement and work speed.
|-
| {{text anchor|CE_DROWSINESS}}
| No
| Causes the Drowsiness condition.
|-
| {{text anchor|CE_UNCONSCIOUSNESS}}
| No
| Renders the creature unconscious.
|-
| {{text anchor|CE_FEVER}}
| No
| Causes the Fever condition.
|-
| {{text anchor|CE_NAUSEA}}
| No
| Causes the Nausea condition, and heavy vomiting. Can eventually lead to dehydration and death.
|-
| {{text anchor|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.
|-
| {{text anchor|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.
|}

===Healing Effects===
Most of the [[Syndrome#Symptomatic_Effects|above]] effects have counterparts to alleviate [[symptom]]s and heal physical damage:
{| {{prettytable}}
|- bgcolor="Bisque"
! Token
! Accepts Target
! Description
|-
| {{text anchor|CE_REDUCE_PAIN}}
| Yes
| Decreases the severity of pain produced by wounds or syndrome effects on the targeted body part. The SEV value probably controls by how much the pain is decreased.
|-
| {{text anchor|CE_REDUCE_SWELLING}}
| Yes
| Decreases the severity of swelling on the targeted body part.
|-
| {{text anchor|CE_REDUCE_PARALYSIS}}
| Yes
| Decreases the severity of any paralysis effects on the targeted body part.
|-
| {{text anchor|CE_REDUCE_DIZZINESS}}
| No
| Decreases the severity of any dizziness the creature has.
|-
| {{text anchor|CE_REDUCE_NAUSEA}}
| No
| Decreases the severity of any nausea the creature has.
|-
| {{text anchor|CE_REDUCE_FEVER}}
| No
| Decreases the severity of any fever the creature has.
|-
| {{text anchor|CE_STOP_BLEEDING}}
| Yes
| Decreases the severity of the bleeding of any wounds or syndrome effects on the targeted body part. The SEV value probably controls by how much the bleeding is decreased.
|-
| {{text anchor|CE_CLOSE_OPEN_WOUNDS}}
| Yes
| Closes any wounds on the targeted body part with speed depending on the SEV value.
|-
| {{text anchor|CE_CURE_INFECTION}}
| Yes?
| Probably decreases the severity of the infection from infected wounds over time.
|-
| {{text anchor|CE_HEAL_TISSUES}}
| Yes
| Heals the tissues of the targeted body part with speed depending on the SEV value.
|-
| {{text anchor|CE_HEAL_NERVES}}
| Yes
| Heals the nerves of the targeted body part with speed depending on the SEV value.
|-
| {{text anchor|CE_REGROW_PARTS}}
| Yes
| Causes missing body parts to regrow. SEV controls how quickly body parts are regrown. In adventure, parts may be lost again once you travel or wait/sleep {{bug|0011396}}.
|}

===Special Effects===
Several special syndrome effects take different arguments than the above. These are used for generated interactions in unmodded games, but may be used as well for any custom substance or interaction. CE_FEEL_EMOTION is the only one of these that takes SEV.

{| {{prettytable}}
|- bgcolor="Bisque"
! Token
! Accepts Target
! Arguments
! Description
|-
| {{text anchor|CE_ADD_TAG}}
| No
| <tag 1>:<tag 2>:etc
| Adds the specified tag(s) to the affected creature. Multiple tags can be specified sequentially within a single effect token. Valid tags:

'''Special tags:'''

*NO_AGING
Halts the creature's aging process and prevents [[Creature token#MAXAGE|death by old age]].

*STERILE
Makes the creature unable to produce [[children|offspring]].

*HAS_BLOOD
*MORTAL
*FIT_FOR_ANIMATION
*FIT_FOR_RESURRECTION
Adding these tags to a creature doesn't appear to do anything.

'''Creature tokens:'''

*[[Creature_token#BLOODSUCKER|BLOODSUCKER]]
*[[Creature_token#CAN_LEARN|CAN_LEARN]]
*[[Creature_token#CAN_SPEAK|CAN_SPEAK]]
*[[Creature_token#CRAZED|CRAZED]]
*[[Creature_token#EXTRAVISION|EXTRAVISION]]
*[[Creature_token#MISCHIEVOUS|MISCHIEVOUS]] (or [[Creature_token#MISCHIEVIOUS|MISCHIEVIOUS]])
*[[Creature_token#NO_CONNECTIONS_FOR_MOVEMENT|NO_CONNECTIONS_FOR_MOVEMENT]]
*[[Creature_token#NO_DIZZINESS|NO_DIZZINESS]]
*[[Creature_token#NO_DRINK|NO_DRINK]]
*[[Creature_token#NO_EAT|NO_EAT]]
*[[Creature_token#NO_FEVERS|NO_FEVERS]]
*[[Creature_token#NO_PHYS_ATT_GAIN|NO_PHYS_ATT_GAIN]]
*[[Creature_token#NO_PHYS_ATT_RUST|NO_PHYS_ATT_RUST]]
*[[Creature_token#NO_SLEEP|NO_SLEEP]]
*[[Creature_token#NO_THOUGHT_CENTER_FOR_MOVEMENT|NO_THOUGHT_CENTER_FOR_MOVEMENT]]
*[[Creature_token#NOBREATHE|NOBREATHE]]
*[[Creature_token#NOEMOTION|NOEMOTION]]
*[[Creature_token#NOEXERT|NOEXERT]]
*[[Creature_token#NOFEAR|NOFEAR]]
*[[Creature_token#NONAUSEA|NONAUSEA]]
*[[Creature_token#NOPAIN|NOPAIN]]
*[[Creature_token#NOSTUN|NOSTUN]]
*[[Creature_token#NOT_LIVING|NOT_LIVING]]
*[[Creature_token#NOTHOUGHT|NOTHOUGHT]]
*[[Creature_token#OPPOSED_TO_LIFE|OPPOSED_TO_LIFE]]
*[[Creature_token#PARALYZEIMMUNE|PARALYZEIMMUNE]]
*[[Creature_token#SUPERNATURAL|SUPERNATURAL]]
*[[Creature_token#TRANCES|TRANCES]]
*[[Creature_token#UTTERANCES|UTTERANCES]]
*[[Creature_token#NIGHT_CREATURE_EXPERIMENTER|NIGHT_CREATURE_EXPERIMENTER]]

Adding tags will cause the creature to pass/fail any relevant <code>[[Interaction token#IT_REQUIRES|IT_REQUIRES]]</code>/<code>[[Interaction_token#IT_FORBIDDEN|IT_FORBIDDEN]]</code> checks (with the apparent exceptions of FIT_FOR_ANIMATION and FIT_FOR_RESURRECTION). Note that [[Syndrome#CE_REMOVE_TAG|CE_REMOVE_TAG]] overrides this effect.

|-
| {{text anchor|CE_REMOVE_TAG}}
| No
| <tag 1>:<tag 2>:etc
| Removes the specified tag(s) from the affected creature. Multiple tags can be specified sequentially within a single effect token. The tags listed [[Syndrome#CE_ADD_TAG|above]] can all be removed via this effect.

If a particular tag is targeted by both CE_REMOVE_TAG and [[Syndrome#CE_ADD_TAG|CE_ADD_TAG]], and both effects are active simultaneously, CE_REMOVE_TAG takes precedence (i.e. the overall effect is that of tag removal for as long as CE_REMOVE_TAG remains active). The order in which the effects activate doesn't affect this, not even if CE_ADD_TAG is added later/earlier via a different syndrome.

Removing tags will cause the creature to fail/pass any relevant <code>[[Interaction token#IT_REQUIRES|IT_REQUIRES]]</code>/<code>[[Interaction_token#IT_FORBIDDEN|IT_FORBIDDEN]]</code> checks (with the apparent exceptions of FIT_FOR_ANIMATION and FIT_FOR_RESURRECTION).

'''Special tags:'''

* HAS_BLOOD
If this tag is removed, the creature behaves as though it has no [[Creature token#BLOOD|blood]]; it doesn't bleed when [[Tissue definition token#VASCULAR|VASCULAR]] tissues are damaged (and thus cannot die of blood loss), and substances cannot be [[Syndrome#SYN_INJECTED|injected]] into it.

* NO_AGING
* STERILE
Removing these tags doesn't appear to do anything unless they've been added to a creature via [[Syndrome#CE_ADD_TAG|CE_ADD_TAG]], in which case their effects will be negated as described above.

* MORTAL
* FIT_FOR_ANIMATION
* FIT_FOR_RESURRECTION
Removing these tags doesn't appear to do anything.

|- a
| {{text anchor|CE_DISPLAY_NAME}}
| No
| NAME:singular:plural:adjective
| Attaches the specified name to the creature's normal name.

|-
| {{text anchor|CE_DISPLAY_TILE}}
| No
| TILE:[[Tilesets|<tile value or character>]]:[[Color#Color_values|<foreground color>:<background color>:<foreground brightness>]]
| Causes the creature to display the specified tile instead of its normal one.

|-
| {{text anchor|CE_FLASH_TILE}}
| No
| TILE:[[Tilesets|<tile value or character>]]:[[Color#Color_values|<foreground color>:<background color>:<foreground brightness>]]:FREQUENCY:<frames default tile>:<frames syndrome tile>
| Causes the creature to flash between its normal tile and the one specified here.

|-
| {{text anchor|CE_PHYS_ATT_CHANGE}}
| No
| [[Attribute]]:percentage:fixed boost(?)
| Alters the creature's specified [[Attribute#Body_attributes|physical attribute]].

|-
| {{text anchor|CE_MENT_ATT_CHANGE}}
| No
| [[Attribute]]:percentage:fixed boost(?)
| Alters the creature's specified [[Attribute#Soul_attributes|mental attribute]].

|-
| {{text anchor|CE_SPEED_CHANGE}}
| No
| speed modifier:number
| Changes the creature's speed.
Speed modifier contains one or both of:
* SPEED_PERC:percentage (this modifies a creature's in-game speed, so higher numbers are faster)
* SPEED_ADD:number (this modifies a creature's [SPEED:XX] token, so higher numbers are slower. Negative numbers are accepted though will only reduce a creature's speed to zero)
The minimum and maximum speeds able to be created by CE_SPEED_CHANGE are 99 and 10,000 respectively.

|-
| {{text anchor|CE_SKILL_ROLL_ADJUST}}
| No
| PERC:percentage:PERC_ON:percentage
| Alters the results of all [[Skill#Skills in use|skill rolls]] the creature makes, multiplying them by ``PERC / 100``. The ``PERC_ON`` value specifies the probability of the effect being applied on a particular roll.
e.g. This causes a 20% chance of any skill roll being 0 (multiplies the current skill level by 0/100) instead of the normal result
[CE_SKILL_ROLL_ADJUST:PROB:100:PERC:0:PERC_ON:20:START:0]

|-
| {{text anchor|CE_BODY_APPEARANCE_MODIFIER}}
| No
| APPEARANCE_MODIFIER:HEIGHT/LENGTH/BROADNESS:percentage(?)
| Alters the size of the creature.

|-
| {{text anchor|CE_BP_APPEARANCE_MODIFIER}}
| Yes
| body part:APPEARANCE_MODIFIER:attribute:number
| Alters the characteristics (height, width etc.) of a body part. "body part" here can either be BP, followed by the usual BY_CATEGORY etc., or TL, followed by the usual selection for SELECT_TISSUE_LAYER.

|-
| {{text anchor|CE_BODY_TRANSFORMATION}}
| No
|
| Makes the affected unit transform into a different creature. The target creature may either be specified directly by following this with a CE:CREATURE token, or else set to be randomly selected as indicated by the additional tokens listed below (of which multiple may be specified).

Note that transformation into or out of the target form causes the creature to drop all items in its inventory and instantly heals all of its wounds. If an [[undead]] limb happens to be transformed, its entire body will regenerate upon transforming back.

Transformation will also re-roll a creature's age to somewhere within the new form's adult age range. This prevents a 70 year old dwarf from dying the moment it turns into a bat ([[Creature token#MAXAGE|max age]] of 3). If it remains stuck as a bat for (at most) three consecutive years it will die of old age as a bat before the syndrome is able to wear off.

A transformed creature generally retains its previous group and civilization membership (unless it becomes [[Creature token#OPPOSED_TO_LIFE|OPPOSED_TO_LIFE]] for example). A transformed dwarf will remain a member of your fortress (and may still hold or gain [[Noble|positions]]), a transformed trader will hang out at the trade depot and eventually leave along with its fellow traders, and a transformed goblin will continue sieging your fortress with its fellow siege members.

A transformed diplomat (like a trade liaison or expedition leader) will still be able to conduct diplomatic meetings even if they no longer [[Creature token#CAN_SPEAK|CAN_SPEAK]].

Transformed creatures can be trained and adopted following the usual rules. However note that if a transformed creature is a member of your fortress then [[Animal Training|animal trainers]] will not attempt to train it.

A transformed creature can produce offspring with creatures of the species it has transformed into and will follow that creature's normal rules for reproduction.

[[Butcher#Butchering|Butchering]] a transformed creature may produce an odd mix of products. For example, if Urist the dwarf is transformed into a [[Cow|bull]] and then is led to the butcher's block for slaughter the resulting products will contain some bull creature parts like "Urist's horn", "Urist's hoof", and "Urist's skin" (which becomes "cow leather" when [[Tanner|tanned]]) but will also contain some dwarf creature parts like "dwarf meat", "dwarf eye", and "dwarf brain".

'''Specific transformation:'''

* '''CE:CREATURE:'''<creature>:<caste> 
This can be used to specify a target creature to transform into ([CE:CREATURE:DWARF:FEMALE], for example). '''ALL''' or '''ANY''' can be used in place of a specific caste to randomise this for every transformation.
Do note that using '''ALL''' or '''ANY''' for transformation castes will make the creature transform over and over again with the interval depending on the '''START''' token. This can lead to an unending transformation loop. [[Syndrome#looping_problem|However, there is a way to get around this.]]

'''Random transformation:'''

* '''CE:CREATURE_FLAG:'''<[[Interaction_token#Creature_and_Caste_Flags|creature flag]]> 
Narrows down the selection to creatures which have the specified [[Interaction_token#Creature_and_Caste_Flags|creature flag]]. May be used multiple times per transformation effect; creatures which lack any of the indicated flags will never be transformed into.

* '''CE:FORBIDDEN_CREATURE_FLAG:'''<[[Interaction_token#Creature_and_Caste_Flags|creature flag]]> 
Excludes creatures with the specified [[Interaction_token#Creature_and_Caste_Flags|creature flag]] from the random selection pool. May be used multiple times per transformation effect; creatures which possess any of the indicated flags will never be transformed into.

* '''CE:CREATURE_CASTE_FLAG:'''<[[Interaction_token#Creature_and_Caste_Flags|caste flag]]> 
Narrows down the selection to creatures which have the specified [[Interaction_token#Creature_and_Caste_Flags|caste flag]]. May be used multiple times per transformation effect; creatures which lack any of the indicated flags will never be transformed into.

* '''CE:FORBIDDEN_CREATURE_CASTE_FLAG:'''<[[Interaction_token#Creature_and_Caste_Flags|caste flag]]> 
Excludes any creature with the specified [[Interaction_token#Creature_and_Caste_Flags|caste flag]] from the random selection pool. May be used multiple times per transformation effect; creatures which possess any of the indicated flags will never be transformed into.

*'''CE:HAVE_FAST_EFFORTLESS_GAIT_SPEED:'''<minimum [[Gait#Speed|gait speed]]> 
Narrows down the selection to creatures which have at least one [[gait]] with an [[Creature_token#GAIT|<energy expenditure>]] of 0 and a [[Creature_token#GAIT|<max speed>]] less than or equal to the specified <minimum gait speed> ("less than" because lower is faster in the scale used for [[Gait#Speed|gait speed]]). This is used in generated [[Die#Adventurer_Mode|divination curses]] to prevent the player from being transformed into a creature that is frustratingly slow to play as. [http://www.bay12forums.com/smf/index.php?topic=169696.msg8243222#msg8243222]

*'''CE:ALL_SLOW_EFFORTLESS_GAIT_SPEED:'''<maximum [[Gait#Speed|gait speed]]> 
Excludes any creatures which have at least one [[gait]] with an [[Creature_token#GAIT|<energy expenditure>]] of 0 and a [[Creature_token#GAIT|<max speed>]] value less than or equal to the specified <maximum gait speed> (note that larger values are slower in the scale used for [[Gait#Speed|gait speed]]). [http://www.bay12forums.com/smf/index.php?topic=169696.msg8243222#msg8243222]

|-
| {{text anchor|CE_MATERIAL_FORCE_MULTIPLIER}}
| No
| MAT_MULT:[[material token|<material token>]]:<value A>:<value B>
| When the affected creature is struck with a weapon made of the specified material, the force exerted will be multiplied by A/B, thus making the creature more or less susceptible to this material. For example, if A is 2 and B is 1, the force exerted by the defined material will be doubled. If A is 1 and B is 2, it will be halved instead. '''NONE:NONE''' can be used in place of a specific material token so as to make the effect applicable to all materials. Note that this syndrome effect is equivalent to the [[Creature_token#MATERIAL_FORCE_MULTIPLIER|MATERIAL_FORCE_MULTIPLIER]] creature token.

|-
| {{text anchor|CE_CAN_DO_INTERACTION}}
| No
|
| Makes the creature able to perform an [[Interaction_token|interaction]]. Follow this effect token with [[Interaction_token#INTERACTION|[CDI:INTERACTION:<interaction name>]]] to specify the desired interaction, and add other [[Interaction_token#Usage|CDI tokens]] as required.
|-
| {{text anchor|CE_SPECIAL_ATTACK_INTERACTION}}
| Yes
| INTERACTION:<interaction name>:BP:<selection criteria>:<name of category,type, or token of designated part/parts>
| Makes the creature able to perform an interaction when using an attack with a designated body part/parts. See [[#In 0.47.01|below]] for an example

|-
| {{text anchor|CE_BODY_MAT_INTERACTION}}
| No
| MAT_TOKEN:<body material token>
| This is used to tie an [[Interaction_token|interaction]] to one of the creature’s body materials. Generated [[vampire]] syndromes use this effect to make vampire blood pass on the vampirism curse when consumed.

The target body material is specified by inserting its ID as defined in the creature raws. For example, when a syndrome with “CE_BODY_MAT_INTERACTION:MAT_TOKEN:SWEAT” is gained by a unit, the effect will apply to any material defined as “SWEAT” in the creature raws of that unit, if such a material is present.
'''RESERVED_BLOOD''' is a special body material token which can be used to specify the [[Creature_token#BLOOD|[BLOOD]]] material of any creature, regardless of the material's actual ID.

The following tokens should be placed after this effect:
* '''CE:SYNDROME_TAG:'''<transmission method> is used to specify what must be done with the body material to trigger the interaction. Replace "<transmission method>" with any of '''[[Syndrome#SYN_INGESTED|SYN_INGESTED]], [[Syndrome#SYN_INJECTED|SYN_INJECTED]], [[Syndrome#SYN_CONTACT|SYN_CONTACT]], [[Syndrome#SYN_INHALED|SYN_INHALED]]'''. Multiple instances of this tag may be used to specify different valid transmission routes. ''However, SYN_INGESTED appears to be the only one that works at present.''
* '''CE:INTERACTION:'''<[[Interaction_token#INTERACTION|interaction ID]]> is used to specify which interaction is to be run (replace "<interaction ID>" with the name of the desired interaction). Appropriate interaction effects with a creature target (such as [[Interaction_token#I_EFFECT|ADD_SYNDROME]]) will be inflicted upon the unit who interacts with the body material as specified above. Note that the linked interaction must have an [[Interaction_token#I_SOURCE|[I_SOURCE:INGESTION]]] token for this to work.

This currently only works on materials obtained from historical figures. That is to say, the material must bear the source unit's name, such as "Urist McVampire's dwarf blood" as opposed to mere "dwarf blood".

|-
| {{text anchor|CE_SENSE_CREATURE_CLASS}}
| No
| CLASS:<[[Creature_token#CREATURE_CLASS|creature class]]>:
[[Tilesets|<tile value or character>]]:
[[Color#Color_values|<foreground color>:<background color>:<foreground brightness>]]
| Provides the ability to sense creatures belonging to the specified [[Creature_token#CREATURE_CLASS|creature class]] even when such creatures lie far beyond line of sight, including through walls and floors. It also appears to reduce or negate the combat penalty of [[Wound#Blindness|blind]] units when fighting creatures they can sense. In [[adventure mode]], the specified tile will be used to represent sensed creatures when they cannot be seen directly.

|-
| {{text anchor|CE_FEEL_EMOTION}}
| No
| EMOTION:<[[emotion]]>
| Makes the creature feel a specific [[emotion]]. The effect's SEV value determines how intense the emotion is. The creature also receives a [[thought]] in the following format: "[creature] feels [emotion] due to [[Syndrome#SYN_NAME|[syndrome name]]]". See [[Emotion]] for the list of valid emotions.

|-
| {{text anchor|CE_CHANGE_PERSONALITY}}
| No
| FACET:<[[Personality facet|personality facet]]>:<amount>
| Changes a [[personality facet]] by the given amount. Multiple FACET:<facet>:<amount> sets may be used, and <amount> can be negative. For example, generated [[necromancer]] syndromes come with the following effect: 
<code>[CE_CHANGE_PERSONALITY:FACET:ANXIETY_PROPENSITY:50:FACET:TRUST:-50:START:0:ABRUPT]</code>

According to Toady, CE_CHANGE_PERSONALITY effects can cause creatures to re-evaluate their [[Personality goal|goals]] in worldgen; the boost to anxiety and distrust given to necromancers makes it more likely for them to develop the goal of [[Personality goal#RULE_THE_WORLD|ruling the world]]. [http://www.bay12forums.com/smf/index.php?topic=169696.msg8275328#msg8275328]

|-
| {{text anchor|CE_ERRATIC_BEHAVIOR}}
| No
|
| Causes erratic behavior, meaning "People that [[Personality facet#VIOLENT|like to brawl]] have a chance of starting a brawl-level fight with any nearby adult." [http://www.bay12forums.com/smf//index.php?topic=159164.msg7632503#msg7632503 -Toady]
|}

'''All''' creature effect tokens take START, END and PROB numbers, and can be followed by [CE:PERIODIC] and/or [CE:COUNTER_TRIGGER] to restrict when they actually take effect.

===Periodic Triggers===

'''[CE:{{text anchor|PERIODIC}}:<period_type>:<min_value>:<max_value>]'''

When this token is placed after a syndrome effect, it will prevent that effect from working unless within the specified period range.

For example, generated [[werebeast]] syndromes have a [[Syndrome#CE_BODY_TRANSFORMATION|body transformation effect]] with <code>[CE:PERIODIC:[[Syndrome#MOON_PHASE|MOON_PHASE]]:27:0]</code>, which makes the transformation active only throughout moon phases 27 to 0 (the full moon period). Once the moon phase changes from 0 to 1, the transformation will end and remain inactive until phase 27 is reached again (unless of course the effect has an END time which is reached before this happens. On that note, keep in mind that the START time of the effect needs to have been reached for activation to have become possible).

Only one periodic trigger may currently be specified per effect. [[Syndrome#Counter_Triggers|Counter triggers]] can also be specified for the same effect, in which case both the periodic trigger and at least one counter trigger will need to have its conditions met for the effect to be allowed to work.

MOON_PHASE is currently the only valid period type:

{| {{prettytable}}
|- bgcolor="Bisque"
! Period
! Description
|-
| {{text anchor|MOON_PHASE}}
| The lunar cycle in ''Dwarf Fortress'' is composed of 28 segments (each slightly shorter than a [[time|day]] in duration), with each segment represented by a value ranging from 0 to 27. These correspond to moon phases as follows:
* '''0''' = full moon
* '''1-4''' = waning gibbous
* '''5-8''' = waning half
* '''9-12''' = waning crescent
* '''13-14''' = new moon
* '''15-18''' = waxing crescent
* '''19-22''' = waxing half
* '''23-26''' = waxing gibbous
* '''27''' = full moon
|}

===Counter Triggers===

'''[CE:{{text anchor|COUNTER_TRIGGER}}:<counter_name>:<min_value>:<max_value>:REQUIRED]'''

Creatures in ''Dwarf Fortress'' possess internal counters which keep track of their various activities and statuses. When this token is placed after a syndrome effect, it will prevent the effect from working unless the affected creature has the indicated counter, and its value lies within the specified range.

For example, generated [[vampire]] syndromes use <code>[CE:COUNTER_TRIGGER:[[Syndrome#DRINKING_BLOOD|DRINKING_BLOOD]]:1:NONE:REQUIRED]</code> with an [[Syndrome#CE_BP_APPEARANCE_MODIFIER|appearance modifier]] to make the vampire's teeth temporarily lengthen whilst leeching blood.

Note that <code>NONE</code> can be used in place of <max_value> to indicate that any value above <min_value> is valid. <code>NONE</code> can also be used in place of <min_value>, which is equivalent to the lowest value attainable by a counter.

<code>REQUIRED</code> implies that the effect won't proceed if the counter exists but doesn't lie within the range provided. However, it's actually redunant as COUNTER_TRIGGER always checks for both of these conditions [http://www.bay12forums.com/smf/index.php?topic=169696.msg8173424#msg8173424]; replacing it with <code>NONE</code> doesn't alter the way the trigger functions, though it ''will'' fail to work if this slot is left empty instead.

As detailed below, most counters only exist temporarily, so their use as triggers is somewhat more restricted than intuition suggests. For example, specifying <code>0</code> or <code>NONE</code> as the <min_value> for a [[Syndrome#CAVE_ADAPT|CAVE_ADAPT]] trigger wouldn't permit the effect to work when the affected creature is outside, since this counter is removed from the unit as soon as its value decreases past 1. Similarly, [[Syndrome#MILK_COUNTER|MILK_COUNTER]] is only present for some time ''after'' a creature is milked.

Multiple counter triggers can be specified per effect, in which case the effect will be permitted to work if at least one of the trigger conditions is met. A [[Syndrome#Periodic_Triggers|periodic trigger]] can also be specified for the same effect, in which case both the periodic trigger and at least one counter trigger will need to have their conditions met for the effect to work.

The following is a list of valid counter types including a couple of notable values:

{| {{prettytable}}
|- bgcolor="Bisque"
! Counter
! Description

|-
| {{text anchor|ALCOHOLIC}}
| For {{token|ALCOHOL_DEPENDENT|c}} creatures, this counter increases by 1 each [[time|tick]], and is reset to 0 when the creature drinks [[alcohol]]. The following messages are added after "needs alcohol to get through the working day" in the creature's description when the counter reaches the specified values:
* 100800 (3 months) = and is starting to work slowly due to its scarcity
* 201600 (6 months) = and really wants a drink
* 302400 (9 months) = and has gone without a drink for far, far too long
* 403200 (1 year) = and can't even remember the last time (s)he had some

|-
| {{text anchor|CAVE_ADAPT}}
| For creatures with the {{token|CAVE_ADAPT|c}} token, this counter is created and increases by 1 each [[time|tick]] when the creature is in the {{DFtext|Dark|0:1}}, and is deleted once the dwarf steps outside and [[vomit]]s. See [[cave adaptation]] for more information.
* 403200 (1 year) = going outside causes irritation
* 604800 (1.5 years) = going outside causes nausea

|-
| {{text anchor|MILK_COUNTER}}
| When a creature is milked, this counter is created and set to the frequency value specified in the creature's {{token|MILKABLE|c}} token, and subsequently decreases by 1 each [[time|tick]] until it reaches 0, at which point it is immediately removed, making the creature available for milking again.

|-
| {{text anchor|EGG_SPENT}}
| This counter is created and set to 100800 (3 months' worth of [[time|tick]]s in fortress mode) when a creature [[Creature_token#LAYS_EGGS|lays eggs]], and thereafter decreases by 1 each tick until it reaches 0, at which point it is removed and the creature regains the ability to lay eggs.

|-
| {{text anchor|GROUNDED_ANIMAL_ANGER}}
| This counter is added and increases by 200 whenever a unit is lying on the ground and does not have [CAN_LEARN]. It subsequently decreases by 1 each [[time|tick]], with a 1% chance to increase by 200. The counter is removed if it decreases to 0. If the counter is greater than 45000 the unit will lash out at a random nearby unit and the counter will be reset to 40000. This is the counter's only effect.

|-
| {{text anchor|TIME_SINCE_SUCKED_BLOOD}}
| This counter rises by 1 every [[time|tick]] for creatures with the {{token|BLOODSUCKER|c}} token. When it rises high enough (generally around 100800; 3 months in fortress mode time), the creature will seek an [[sleep|unconscious]] victim to leech off of. Blood-sucking causes the counter to decrease, and will continue until either the victim is dead or the counter reaches 0. Note that this counter isn't removed when 0 is reached.

When playing as a bloodsucker in [[adventure mode]], the following bloodthirst indicators are displayed when this counter reaches the specified values:
* 172800 (1 day in adventure mode time) = {{DFtext|Thirsty|4:0}}
* 1209600 (1 week) = {{DFtext|Thirsty!|4:1}}
* 2419200 (2 weeks) = {{DFtext|Thirsty!|5:1}}
Various penalties are applied as bloodthirst increases; see the [[vampire]] article for more information.

|-
| {{text anchor|DRINKING_BLOOD}}
| This appears to be created and set to a fixed value of 20 whilst the creature is sucking blood, and begins to decrease by 1 each [[time|tick]] once blood-sucking ceases (as described [[Syndrome#TIME_SINCE_SUCKED_BLOOD|above]]) until it reaches 0, at which point the counter is removed.

|}

{{mod}}

==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.
[MELTING_POINT:NONE]
[BOILING_POINT:10000]
[MAT_FIXED_TEMP:10001]
[SPEC_HEAT:1]
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#SYN_INHALED|SYN_INHALED]] syndrome you thoughtfully attached to the material definition earlier! Note that creatures do not need to inhale every tick, so there is a chance that the gas will dissipate before it can infect any particular creature.

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 definition token]]s.

==Spreading diseases==
It's fully possible to make a nasty disease capable of spreading itself from an infected dwarf to others, though it requires some skill in modding [[interaction token|interactions]] as well. Here is an example of a plague-inflicting interaction:

[INTERACTION:PLAGUE]
[I_TARGET:A:CREATURE]
[IT_LOCATION:CONTEXT_CREATURE]
[IT_FORBIDDEN:NOT_LIVING]
[IT_AFFECTED_CLASS:GENERAL_POISON]
[IT_MANUAL_INPUT:creatures]
[I_EFFECT:ADD_SYNDROME]
[IE_TARGET:A]
[IE_IMMEDIATE]
[SYNDROME]
[SYN_NAME:the plague]
[SYN_AFFECTED_CLASS:GENERAL_POISON]
[CE_FEVER:SEV:250:PROB:100:START:250:PEAK:1500:END:25000]
[CE_BLISTERS:SEV:325:PROB:100:BP:BY_CATEGORY:ALL:SKIN:START:250:PEAK:1500:END:25000]
[CE_NECROSIS:SEV:300:PROB:100:BP:BY_CATEGORY:ALL:ALL:VASCULAR_ONLY:START:22500:PEAK:23750:END:25000]
[CE_CAN_DO_INTERACTION:START:1500:END:25000]
[CDI:ADV_NAME:Spread the plague]
[CDI:INTERACTION:PLAGUE]
[CDI:TARGET:A:LINE_OF_SIGHT]
[CDI:TARGET_RANGE:A:10]
[CDI:WAIT_PERIOD:30]

As you can see, the syndrome here inflicts blisters, fever and, after roughly a month, necrosis of the whole body - that's when the infected creatures will start dying out. But before that happens, CE_CAN_DO_INTERACTION makes them capable of spreading the plague further.

You also need a disease vector that will bring the plague straight to your fort. (hint: use [[large rat|various]] [[rat man|species]] [[giant rat|of rats]] - they're perfect for that). The following code, added to a creature's raws, ensures the creature will infect anybody it encounters:

[CAN_DO_INTERACTION:PLAGUE]
[CDI:ADV_NAME:Spread the plague]
[CDI:TARGET:A:LINE_OF_SIGHT]
[CDI:TARGET_RANGE:A:10]
[CDI:WAIT_PERIOD:30]

As soon as the said creature is startled by your dwarves, the [[fun]] will begin.

It is also possible to use a creature's established methods of attack for use in disease-spreading.

Let's use the borrowed example of the plague above. This time, the plague will spread through biting, using the following syndrome code:

[INTERACTION:PLAGUE]
[I_TARGET:A:CREATURE]
[IT_LOCATION:CONTEXT_CREATURE]
[IT_FORBIDDEN:NOT_LIVING]
[IT_AFFECTED_CLASS:GENERAL_POISON]
[IT_MANUAL_INPUT:creatures]
[I_EFFECT:ADD_SYNDROME]
[IE_TARGET:A]
[IE_IMMEDIATE]
[SYNDROME]
[SYN_NAME:the plague]
[SYN_AFFECTED_CLASS:GENERAL_POISON]
[CE_FEVER:SEV:250:PROB:100:START:250:PEAK:1500:END:25000]
[CE_BLISTERS:SEV:325:PROB:100:BP:BY_CATEGORY:ALL:SKIN:START:250:PEAK:1500:END:25000]
[CE_NECROSIS:SEV:300:PROB:100:BP:BY_CATEGORY:ALL:ALL:VASCULAR_ONLY:START:22500:PEAK:23750:END:25000]
[CE_SPECIAL_ATTACK_INTERACTION:INTERACTION:PLAGUE:BP:BY_CATEGORY:TOOTH:START:0:ABRUPT]

The line [CE_SPECIAL_ATTACK_INTERACTION:INTERACTION:BITE_PLAGUE:BP:BY_CATEGORY:MOUTH:BP:BY_CATEGORY:TOOTH:START:0:ABRUPT] allows any infected creature with an attack using mouth or tooth category body parts to immediately spread the disease using said attack. The victim of the attack may then spread the disease if they are able to attack with the needed body part/parts.

==Multi-caste/multi-creature body transformations==
This is a way to get around the {{text anchor|looping problem}} when using ANY or ALL castes for [[Syndrome#CE_BODY_TRANSFORMATION|CE_BODY_TRANSFORMATION]] and not being limited to a single creature for transformations. It's an incredibly simple solution as you can see in this example code:
{{code|code=
[SYNDROME]
[SYN_NAME:draconic curse]
[SYN_CLASS:DRACONIC_CURSE]
[CE_BODY_TRANSFORMATION:PROB:25:START:0]
[CE:CREATURE:HYDRA:MALE]
[CE_BODY_TRANSFORMATION:PROB:33:START:0]
[CE:CREATURE:DRAGON:MALE]
[CE_BODY_TRANSFORMATION:PROB:50:START:0]
[CE:CREATURE:HYDRA:FEMALE]
[CE_BODY_TRANSFORMATION:PROB:100:START:0]
[CE:CREATURE:DRAGON:FEMALE]
}}
This code will transform a creature into either a female/male [[hydra]] or a female/male [[dragon]].

For every caste/creature you want a ''victim'' to transform into, you add a [CE_BODY_TRANSFORMATION] token with a [PROB] token attached to it. For each of the transformations, the PROB is set to ``100 / number_of_remaining_transformations`` (or different numbers if you want uneven odds), with the final transformation having a PROB of 100 to ensure there is always at least one transformation chosen. A creature can only have one active transformation at a time, so if any of the lower PROB transformations occurs then the PROB 100 transformation can not happen.

If you instead want a ''sequence'' of transformations to take place then you need make sure that one transformation ends on the same tick that the next one begins:
{{code|code=
[SYNDROME]
[SYN_NAME:draconic sequence curse]
[SYN_CLASS:DRACONIC_SEQUENCE_CURSE]
[CE_BODY_TRANSFORMATION:PROB:100:START:0:END:10]
[CE:CREATURE:HYDRA:MALE]
[CE_BODY_TRANSFORMATION:PROB:100:START:10:END:20]
[CE:CREATURE:DRAGON:MALE]
[CE_BODY_TRANSFORMATION:PROB:100:START:20:END:30]
[CE:CREATURE:HYDRA:FEMALE]
[CE_BODY_TRANSFORMATION:PROB:100:START:30:END:40]
[CE:CREATURE:DRAGON:FEMALE]
}}

==See also==

* [[Syndrome examples]]
* [[Interaction token]]
* [[Modding]]

{{Category|Modding}}
{{Category|Creature attributes}}
{{Category|Tokens}}
[[ru:DF2012:Syndrome]]

Syndrome

2025-06-21T19:36:34Z

DikbutDaGrate: Detailed clarification on the mechanics of the grounded animal anger counter token.

{{Quality|Masterwork}}
{{av}}
[[File:syndrome_statuses_anim.gif|right]]In ''Dwarf Fortress'', a '''syndrome''' can be thought of as a condition which applies a collection of [[Syndrome#Creature Effect Tokens|effects]] to [[creature]]s who contract it. Syndromes give rise to several of the game's [[fun|more interesting]] [[Health care|medical]] [[Status_icon|predicaments]], such as [[alcohol]] inebriation, venomous snake bites, and the brain-rotting secretions of certain [[Forgotten beast|uninvited guests]]. That said, the syndrome system isn't functionally restricted to the simulation of disease - many of the game's supernatural features, such as [[werewolf|werewolves]], [[vampire]]s, [[necromancer]]s, [[mummy|mummy curses]] and the [[undead]], are in fact produced by applying various [[Syndrome#Special_Effects|special effects]] to creatures via syndromes.

Graphically, [[Dwarf|dwarves]], [[human]]s, [[elf|elves]], [[goblin]]s and [[kobold]]s with supernatural syndromes will have a different skin color, as seen in the image to the right. Other creatures will appear exactly as they are with no alterations, unless they're undead, in which they will appear with an indigo/blue tint, black eyes and white pupils, as every creature will have a unique undead sprite (including that of children and babies for some creatures).

''"Yeah, I know this. I was looking for [[Syndrome examples|modded examples]]..."''
[[File:skin_color_preview.png|thumb|right|What different undead/immortal creatures' skin colors mean, which are also syndromes.]]
==List of syndromes==
In unmodded games, syndromes are generally named after the animal, substance or effect that delivers them. They can cause unpleasant and sometimes fatal [[symptom]]s over a short to long duration, 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 those that can be helped by treatment. Note that in a world with [[dragon]]s and [[giant elephant]]s, dwarves (and elves and humans) fall into the "small creatures" category for purposes of this discussion.
{| {{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 Blisters Nausea
| None
|-
| 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 Drowsiness Strong pain Fever Unconsciousness Complete paralysis1
| None
| None
|-
| Blob blisters
| cave blob fluid (contact or ingested)
| Touching a [[cave blob]]
| Mild pain 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 Fever Pain 
| Severe localized necrosis
| None
|-
| Bumblebee sting
| bumblebee venom (injected)
| Being stung by a [[bumblebee]] worker
| Pain Strong swelling
| None
| None
|-
| Bushmaster bite
| bushmaster venom (injected)
| Being bitten by a [[bushmaster]], [[giant bushmaster]] or [[bushmaster man]]
| Strong pain Mild bleeding Dizziness Nausea Unconsciousness Complete paralysis1
| None
| None
|-
| Cave floater sickness
| cave floater gas (inhaled or ingested)
| Expelled from [[cave floater]]
| Mild nausea
| Fever Strong drowsiness (delayed) Strong dizziness (delayed)
| None
|-
| Cave spider bite
| cave spider venom (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 Swelling Nausea
| None
| None
|-
| Giant cave spider bite
| giant cave spider venom (injected)
| Being bitten by a [[giant cave spider]]
| Size-dependant paralysis.
| Death by asphyxiation, in small targets. Large targets are generally unhindered...unless you count the high probability of being eaten by the giant cave spider as a hindrance.
| None, not that it really matters.
|-
| Gila monster bite
| gila monster venom (injected)
| Being bitten by a [[gila monster]], [[giant gila monster]] or [[gila monster man]]
| Pain Mild swelling
| None
| None
|-
| Gnomeblight
| [[gnomeblight]] (contact, inhaled, injected, or ingested)
| Purposely exposing oneself to the extract. Only affects [[mountain gnome]]s and [[dark gnome]]s.
| None
| Severe systemic necrosis2
| None
|-
| Giant desert scorpion sting
| giant desert scorpion venom (injected)
| Being stung by a [[giant desert scorpion]]
| Necrosis of the brain and nervous system
| '''Certain death'''
| None, not that it really matters.
|-
| Helmet snake bite
| helmet snake venom (injected)
| Being bitten by a [[helmet snake]]
| Minor bleeding
| Fever Nausea Dizziness Localized swelling Localized oozing Localized bruising Strong pain Intense localized necrosis Possible loss of limb
| None
|-
| Honey bee sting
| honey bee venom (injected)
| Being stung by a [[honey bee]] worker
| Pain Strong swelling
| None
| None
|-
| Inebriation
| [[Alcohol]] (consumed/injected)
| Consuming alcoholic drinks
| Nausea Dizziness Unconsciousness Personality changes Euphoria Erratic behavior Trouble breathing
| None
| None
|-
| Iron man cough
| iron man gas (inhaled)
| Expelled by [[iron man]]
| Coughing blood
| None
| None
|-
| King cobra bite
| king cobra venom (injected)
| Being bitten by a [[king cobra]]
| Complete paralysis1 Pain, dizziness, drowsiness
| None
| None
|-
| Phantom spider bite
| phantom spider venom (injected)
| Being bitten by a [[phantom spider]]
| None
| Numbness and mild dizziness
| None
|-
| Platypus sting
| platypus venom (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 (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 (injected)
| Being bitten by a [[serpent man]]
| Complete paralysis1
| None
| None
|-
| Mummy's curse
| [[Mummy|Disturbance interaction]].
| Being cursed by a [[mummy]], when caught raiding their tombs
| None
| None
| 20% chance of any skill roll failing, regardless of skill.
|-
| Vampirism
| [[Deity|Divine]] curse
| Drinking the blood of a [[vampire]]. Toppling statues in shrines and temples (random chance), rolling divination dice too frequently.
| None
| None
| Victim becomes a [[vampire]].
|-
| Werebeast curse
| [[Deity|Divine]] curse
| Being bitten by a [[werebeast]], toppling statues in shrines and temples (random chance), rolling divination dice too frequently.
| None
| None
| Victim becomes a [[werebeast]].
|-
| Necromancy
| Secret
| Reading a book/slab that contains the secrets of life and death.
| None
| None
| Reader becomes a [[necromancer]].
|-
| evil rain sickness3
|rowspan=7| Random
| Being caught outside in [[Weather#Evil weather|freakish weather]] in an evil [[biome]]
|rowspan=7| Random
|rowspan=7| Random
|rowspan=7| Random
|-
| evil cloud sickness4
| Being caught in a [[Weather#Evil weather|creeping cloud]] in an evil [[biome]]
|-
| beast sickness5
| Encounters with [[forgotten beast]]s
|-
| titan sickness5
| Encounters with [[titan]]s
|-
| night sickness5
| Encounters with [[nightmare]]s or [[experiment]]s
|-
| demon sickness5
| Encounters with [[demon]]s
|-
| divine sickness5
| Encounters with [[angel]]s
|}
: 1. For small creatures such as humans and dwarves, paralysis tends to result in suffocation.
: 2. Necrosis of the brain will eventually result in death once the brain rots away completely.
: 3. Evil rain typically only causes minor symptoms such as blisters, bruising, coughing blood, dizziness, fever, nausea, oozing, and pain.
: 4. Evil clouds either cause major symptoms (as with beast/titan/demon sicknesses) or permanently transform creatures into [[Undead|zombie-like]] forms.
: 5. [[Titan]]s, [[forgotten beast]]s, [[nightmare]]s, [[experiment]]s, [[demon]]s and [[angel]]s have a chance to have a randomized syndrome. These range from mildly hazardous (mild [[Symptom#Blisters|blisters]] from inhaling boiling blood) to instantly fatal (severe necrosis from a contact poison attached to a breath weapon/creature made of blood).

==The anatomy of a syndrome==
To recap, syndromes are "diseases" which inflict effects upon creatures who acquire them. Mechanically, they're composed of a bunch of different syndrome tokens which detail [[Syndrome#Basic syndrome tokens|how it works]] and [[Syndrome#Creature effect tokens|what it does]]. Syndrome acquisition can be boiled down into two main routes: (1) via materials and (2) via interactions. Unlike most objects in the game, syndromes aren't defined in their own raw file; they're instead built up within the raw definition of the material or interaction effect to which they are tied, as described below.
{{Modding}}
'''1) Transmission via Materials'''
Any material (be it [[Material_token#INORGANIC|inorganic]], [[Material_token#CREATURE_MAT|creature-derived]], or [[Material_token#PLANT_MAT|plant-derived]]) can have one or more syndromes added to it, simply by defining the syndrome within the material's own raw definition. The addition of certain tokens (detailed [[Syndrome#SYN_CONTACT|below]]) to the syndrome will determine what must be done to the material so as to transmit the syndrome to a creature; the current modes of transmission are as follows: [[Syndrome#SYN_CONTACT|bodily contact]] with the material, [[Syndrome#SYN_INGESTED|ingestion]] or [[Syndrome#SYN_INHALED|inhalation]] of the material, or [[Syndrome#SYN_INJECTED|injection]] of the material into the bloodstream. Any combination of transmission modes can be specified per syndrome.

Here's the material definition of [[giant cave spider]] venom with its associated syndrome as an example:

''(See [[Giant cave spider/raw|here]] for the complete creature raw.)''
[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_GIANT:ALL]'''
'''[SYN_INJECTED]'''
'''[CE_PARALYSIS:SEV:100:PROB:100:RESISTABLE:SIZE_DILUTES:START:5:PEAK:10:END:20]'''

In the above, the non-bolded section consists of various [[material definition token]]s used to define and customise the venom material. (USE_MATERIAL_TEMPLATE defines a material called 'POISON', and creates it using the template 'CREATURE_EXTRACT_TEMPLATE' as a basis, which is then altered by the other tokens placed below it. See [[Material_definition_token#STATE_NAME|STATE_NAME]], [[Material_definition_token#STATE_ADJ|STATE_ADJ]], and [[Material_definition_token#PREFIX|PREFIX]] for more information about these tokens). The relevance of [[Material_definition_token#ENTERS_BLOOD|ENTERS_BLOOD]] in this context is explained below.

The bolded section consists of the syndrome definition, which is initiated using the [[Syndrome#SYNDROME|[SYNDROME]]] token. The tokens placed after this (which are described in further detail [[Syndrome#Basic syndrome tokens|below]]) flesh out the syndrome - in this case they name it "giant cave spider bite", make it work only against creatures belonging to the 'GENERAL_POISON' [[Creature token#CREATURE_CLASS|creature class]], render giant cave spiders immune to it, and cause creatures to contract it if the venom is injected into them. The creature effect at the very bottom makes the syndrome inflict progressive complete paralysis upon the victim after a short delay, for what would be a relatively short-lived period were it not for the fact that most small creatures tend to suffocate before the effect wears off (that, or they get eaten by the giant cave spider that caused it).

Great, so how do we get this lethal venom into a creature's bloodstream to transmit the syndrome? Giant cave spiders are able to do this via the [[Creature token#SPECIALATTACK_INJECT_EXTRACT|SPECIALATTACK_INJECT_EXTRACT]] token appended to their bite attack as such:
[SPECIALATTACK_INJECT_EXTRACT:LOCAL_CREATURE_MAT:POISON:LIQUID:100:100]
This makes their bites inject 100 units of the 'POISON' material in its liquid [[Material_definition_token#Material_States|state]]. Note that '[[Material_token#LOCAL_CREATURE_MAT|LOCAL_CREATURE_MAT]]:POISON' indicates that the 'POISON' material is defined amidst the same creature raws where the attack was detailed i.e. within the SPIDER_CAVE_GIANT creature definition; we could have written '[[Material_token#CREATURE_MAT|CREATURE_MAT]]:SPIDER_CAVE_GIANT:POISON' instead for the same result. Also note that we can make the attack inject any material we want it to, not just creature-associated materials. (Want your spider to inject molten [[gold]] into its victims to melt them from the inside out instead of bothering with syndromes? Simply replace 'LOCAL_CREATURE_MAT:POISON:LIQUID' with '[[Material_token#INORGANIC|INORGANIC]]:GOLD:LIQUID' and you're good to go).

Note that [ENTERS_BLOOD] must be added to the material definition for injection attacks making use of this material to function properly. Without this token, the material would simply [[contaminant|splatter]] over the attacked bodypart instead of entering the bloodstream, so the above syndrome, which relies solely on the [[Syndrome#SYN_INJECTED|injectable]] transmission route, wouldn't be contracted. [ENTERS_BLOOD] can of course be left out intentionally, if the aim is to cover creatures with a material that transmits syndromes [[Syndrome#SYN_CONTACT|on contact]]. Keep in mind that splattering in lieu of injection also occurs with blunt attacks, on attacked body parts devoid of [[Tissue_definition_token#VASCULAR|VASCULAR]] tissue, and on [[Creature token#BLOOD|bloodless]] victims (including creatures who've had their blood removed via [[Syndrome#CE_REMOVE_TAG|CE_REMOVE_TAG:HAS_BLOOD]]).

A fun variation on typical creature venoms is to add a [[Syndrome#SYN_CONTACT|contact-transmissible]] syndrome to the creature's [[Creature token#BLOOD|blood]] material - this tends to end poorly for any predator that chooses to attack them.

'''2) Transmission via Interactions'''

The [[Interaction token|interaction]] system can be used to add syndromes to creatures directly via certain interaction effects, most notably [[Interaction token#I_EFFECT|I_EFFECT:ADD_SYNDROME]]. After placing this I_EFFECT in an interaction definition, the syndrome to be added is defined beneath it in exactly the same manner as that used for the material-bound syndromes described above. (Note that any [[Interaction_token#IE_TARGET|IE_ tokens]] used with this I_EFFECT can be placed before or after the syndrome definition; the order doesn’t really matter). The [[Interaction token#I_EFFECT| ANIMATE]] and [[Interaction token#I_EFFECT| RESURRECT]] interaction effects also allow syndromes to be tied to them in the same manner; in this case the syndrome is applied to the target creature after it is animated or resurrected respectively.

See [[Syndrome#Spreading_diseases|below]] for an example of a syndrome-transmitting interaction.

==Basic syndrome tokens==

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

|-
| {{text anchor|SYNDROME}}
|
| Used to begin defining a new syndrome.

|-
| {{text anchor|SYN_NAME}}
| <your text>
| Used to specify the name of the syndrome as it appears in-game. Names don't have to be unique; it's perfectly acceptable to have multiple syndromes with identical names.

For example, this name is displayed when <nowiki>[</nowiki>[[Syndrome#CE_FEEL_EMOTION|CE_FEEL_EMOTION:<...>]]] causes an emotional reaction {{dftext|Urist is |0:1}}{{dftext|<emotion>|6:0}}{{dftext| due to <your_syn_name>.|0:1}}

|-
| {{text anchor|SYN_CLASS}}
| <your text>
| Can be included to create a syndrome class and assign the syndrome to it, for use with the [[Interaction token#IT_CANNOT_HAVE_SYNDROME_CLASS|IT_CANNOT_HAVE_SYNDROME_CLASS]] interaction token. Can be specified more than once to assign the syndrome to multiple classes. Other syndromes can also be assigned to the same class.

|-
| {{text anchor|SYN_CONTACT}}
|
| If the syndrome is tied to a material, creatures who come into contact with this material will contract the syndrome if this token is included in the syndrome definition. Contact transmission occurs when a creature's body becomes [[contaminant|contaminated]] with the material (visible as [material name] 'smear', 'dusting' or 'covering' over body parts when viewing the creature's inventory). Note that contact with [[item]]s made of a syndrome-inducing material currently doesn't result in transmission.

Methods of getting a material contaminant onto a creature's body include:
* [[Creature token#SECRETION|secretions]]
* [[Interaction_token#LIQUID_GLOB|liquid projectiles]] (contaminate struck body parts if exposed)
* [[Interaction_token#TRAILING_VAPOR_FLOW|vapor]] and [[Interaction_token#TRAILING_DUST_FLOW|dust clouds]] (contaminate all external body parts, even if covered)
* [[Interaction_token#SPATTER_LIQUID|puddles]] and [[Interaction_token#SPATTER_POWDER|dust piles]] ([[Body_token#STANCE|STANCE]] body parts become contaminated if the creature walks into them [[clothing|barefoot]], and all uncovered external body parts are contaminated if the creature is [[Status icon#Non-flashing|prone]])
* [[Interaction_token#WEATHER_FALLING_MATERIAL|freakish rain]] (contaminates all external body parts, even if covered, if the creature is outside)
* unprotected bodily contact with a contaminated creature (including performing or receiving body part attacks such as punches and [[wrestling]] moves, creature collisions, as well as [[Interaction_token#I_EFFECT|CONTACT]] interaction effects, if the involved body parts are exposed)
* items [[Material_definition_token#MELTING_POINT|melting]] whilst equipped or hauled (this contaminates the body part that was holding them if exposed)
* striking the creature's body with a contaminated item (see below)

It is possible to use this token for syndromes intended to be applied via envenomed weapons (but also check out [[Syndrome#SYN_INJECTED|SYN_INJECTED]]). When a creature's body is struck with an item which is contaminated with a contact syndrome-inducing material, the syndrome will be transmitted to the struck creature, even if the attack doesn't pierce the flesh. Syndrome transmission in this context often occurs in the absence of a visible contaminant on the body.

Contact transmission only appears to occur at the moment of contamination (which is to say, when a new bodily spatter is created). If the syndrome ends (once all its [[Syndrome#Creature_effect_tokens|creature effects]] reach their END point, at which point it will be removed from the creature), it will NOT be reapplied by the original syndrome-inducing contaminant (assuming it hasn't been cleaned off yet); the creature will need to be recontaminated with the causative material for this to occur. (Note that in the case of [[Creature token#SECRETION|secretions]], the secreted contaminants are continuously reapplied to the secretory body parts, so any associated short-lasting contact syndromes allowed to target the secreting creature can potentially be reapplied at the rate of secretion; this may work differently in [[adventurer mode]]).

|-
| {{text anchor|SYN_INGESTED}}
|
| If the syndrome is tied to a material, creatures who [[food|eat]] or drink substances comprising, containing or [[contaminant|contaminated]] with this material will contract the syndrome if this token is included. This includes [[kitchen|prepared meals]] when any of the constituent ingredients contains the material in question.

This also applies to [[creature token#GRAZER|grazing]] creatures which happen to munch on a [[plant token#GRASS|grass]] that has an ingestion-triggered syndrome tied to any of its constituent materials.

|-
| {{text anchor|SYN_INHALED}}
|
| If the syndrome is tied to a material, creatures who inhale the material will contract the syndrome if this token is included. Materials can only be inhaled in their [[Material_definition_token#BOILING_POINT|gaseous]] state, which is attainable by [[temperature|boiling]], or in the form of a [[Interaction_token#TRAILING_GAS_FLOW|TRAILING_GAS_FLOW]], [[Interaction_token#UNDIRECTED_GAS|UNDIRECTED_GAS]] or [[Interaction_token#WEATHER_CREEPING_GAS|WEATHER_CREEPING_GAS]]. Creatures can also be made to [[Tissue_definition_token#TISSUE_LEAKS|leak]] [[Tissue_definition_token#TISSUE_MAT_STATE|gaseous tissue]] when damaged.

Note that {{token|AQUATIC|c}} creatures never inhale gaseous materials, and creatures which do breathe air aren't guaranteed to inhale gases when exposed to them for a short time. Contrary to what one might expect, creatures with {{token|NOBREATHE|c}} are in fact capable of contracting inhalation syndromes; this is presumably a bug.

|-
| {{text anchor|SYN_INJECTED}}
|
| If the syndrome is tied to a material, the injection of this material into a creature's bloodstream will cause it to contract the syndrome if this token is included. Injection can be carried out as part of a creature attack via [[Creature_token#SPECIALATTACK_INJECT_EXTRACT|SPECIALATTACK_INJECT_EXTRACT]], or by piercing the flesh of a creature with an [[item]] that has been [[contaminant|contaminated]] with the material. Thus, this token can be used as a more specific alternative to [[Syndrome#SYN_CONTACT|SYN_CONTACT]] for syndromes intended to be administered by envenomed weapons.

For injection to work, the material definition must include [[Material_definition_token#ENTERS_BLOOD|ENTERS_BLOOD]], the attacked body part needs to have [[Tissue_definition_token#VASCULAR|VASCULAR]] tissue, and the intended victim must have [[Creature token#BLOOD|BLOOD]] (so it won't work on creatures with the [[Syndrome#CE_REMOVE_TAG|CE_REMOVE_TAG:HAS_BLOOD]] syndrome effect). Getting the weapon "lodged into the wound" isn't a requirement.

|-
| {{text anchor|SYN_AFFECTED_CLASS}}
| <[[Creature token#CREATURE_CLASS|creature class]]>
| If this is included, only creatures which belong to the specified [[Creature token#CREATURE_CLASS|creature class]] (as well as creatures which pass the [[Syndrome#SYN_AFFECTED_CREATURE|SYN_AFFECTED_CREATURE]] check if this is included) will be able to contract the syndrome. This token can be specified multiple times per syndrome, in which case creatures which have at least one matching class will be considered susceptible. If [[Syndrome#SYN_IMMUNE_CLASS|SYN_IMMUNE_CLASS]] and/or [[Syndrome#SYN_IMMUNE_CREATURE|SYN_IMMUNE_CREATURE]] are included, creatures which fail these checks will be unable to contract the syndrome even if they pass this class check.

|-
| {{text anchor|SYN_IMMUNE_CLASS}}
| <[[Creature token#CREATURE_CLASS|creature class]]>
| If this is included, creatures which belong to the specified [[Creature token#CREATURE_CLASS|creature class]] will be unable to contract the syndrome. This token can be specified multiple times per syndrome, in which case creatures with at least one matching class will be considered immune (unless overridden by [[Syndrome#SYN_AFFECTED_CREATURE|SYN_AFFECTED_CREATURE]]).

|-
| {{text anchor|SYN_AFFECTED_CREATURE}}
| <creature>:<[[Creature_token#CASTE|caste]]>
| If this is included, only the specified creature (and, if [[Syndrome#SYN_AFFECTED_CLASS|SYN_AFFECTED_CLASS]] is included, also creatures which pass this check as explained above) will be able to contract the syndrome. This token can be used multiple times per syndrome. If used alongside [[Syndrome#SYN_IMMUNE_CLASS|SYN_IMMUNE_CLASS]], the specified creature will be able to contract the syndrome regardless of this class check.

DWARF:FEMALE is an example of a valid <creature>:<caste> combination; "ALL" can be used in place of a specific caste so as to indicate that this applies to all castes of the specified creature.

|-
| {{text anchor|SYN_IMMUNE_CREATURE}}
| <creature>:<[[Creature_token#CASTE|caste]]>
| If this is included, the specified creature will be unable to contract the syndrome (even if it matches [[Syndrome#SYN_AFFECTED_CLASS|SYN_AFFECTED_CLASS]]). It can be specified multiple times per syndrome. As above, "ALL" can be used in place of a specific caste.

|-
| {{text anchor|SYN_NO_HOSPITAL}}
|
| Prevents creatures from being admitted to [[health care|hospital]] for problems arising directly as a result of the syndrome's effects, no matter how bad they get.

|-
| {{text anchor|SYN_IDENTIFIER}}
| <your text>
| This token can be included to give a syndrome an identifier which can be shared between multiple syndromes. Only one identifier may be specified per syndrome.

Syndrome identifiers can be used in conjunction with the [[Creature token#SYNDROME_DILUTION_FACTOR|SYNDROME_DILUTION_FACTOR]] creature token to alter a creature’s innate resistance to the relevant [[Syndrome#Symptomatic effects|effects]] of any syndromes that possess the specified identifier. For example, every [[alcohol|alcoholic beverage]] in unmodded games comes with its own copy of an intoxicating syndrome, each of which has a <code>[SYN_IDENTIFIER:INEBRIATION]</code> token. All [[dwarf|dwarves]] have <code>[SYNDROME_DILUTION_FACTOR:INEBRIATION:150]</code>, which decreases the severity of any effects derived from a syndrome with the INEBRIATION identifier, thus enabling them to better handle all forms of alcohol.

When a creature gets a new syndrome with the same SYN_IDENTIFIER, it merges the effects of the new syndrome into the old one, resetting any overlapping syndrome effects to their PEAK time. If the new one comes with a [[Syndrome#SYN_CONCENTRATION_ADDED|SYN_CONCENTRATION_ADDED]] token, it will additionally adjust the first syndrome's concentration on any overlapping syndrome effects as described below. Taking the above example once again, a sober dwarf drinking their first alcoholic beverage would be exposed to an INEBRIATION syndrome, contracting it and having its effects manifest normally. If the dwarf were to have another drink before the effects of this first syndrome have all worn off (by reaching their [[Syndrome#Creature effect tokens|END]] point), then exposure to the second INEBRIATION syndrome would increase the severity of the original syndrome's effects, making the dwarf progressively more intoxicated, and reset the timer on inebriation to its PEAK.

|-
| {{text anchor|SYN_CONCENTRATION_ADDED}}
| <amount>:<max>
| Syndrome concentration is essentially a quantity which impacts the severity of the syndrome's relevant [[Syndrome#Symptomatic effects|effects]]. The higher the syndrome's concentration, the greater its severity. When a syndrome is contracted, the value specified in <amount> is its initial concentration level.

As described above, if a creature is exposed to a syndrome with a particular [[Syndrome#SYN_IDENTIFIER|SYN_IDENTIFIER]] when already possessing an active syndrome with the same identifier, then this later syndrome isn't contracted, instead contributing to the original syndrome's concentration as indicated by its SYN_CONCENTRATION_ADDED token, if present. The syndrome in question will increase the original syndrome's concentration by <amount> whenever the creature is exposed to it, until its specified <max> concentration is reached by the original syndrome, causing subsequent exposure to this particular syndrome to do nothing (that is, until the original syndrome ends, at which point a new one may be contracted normally). Should the creature be exposed to a different syndrome with the same identifier and a higher <max> value, the concentration will of course increase further.

For example, all forms of [[alcohol]] in the vanilla game have a syndrome with <code>[SYN_IDENTIFIER:INEBRIATION]</code> and <code>[SYN_CONCENTRATION_ADDED:100:1000]</code>. When alcohol is first drunk, the creature contracts the relevant inebriating syndrome at a concentration level of 100. Every subsequent drink will increase the concentration of this first syndrome by a further 100, intensifying its effects, until it plateaus at concentration level 1000. Once all the effects of the original syndrome have ended, the cycle can be started anew (assuming the drinker hasn't died of [[Alcohol#Alcohol_poisoning|alcohol poisoning]] yet). As described by Toady, "Each 100 of <amount> will contribute SEV in general to each effect (before [[Creature token#SYNDROME_DILUTION_FACTOR|dilution]]), <max> goes up to 1000. The concentration does not decrease, but will stay at the maximum attained until the syndrome wears off."

Some of the generated interaction-derived syndromes come with <code>[SYN_CONCENTRATION_ADDED:1000:0]</code>. According to Toady, this "was a precaution after I had one bug with effects not fully manifesting due to low levels. It may not be necessary, but I decided to give everybody a full dose of the juice until I could get a closer look at it." [http://www.bay12forums.com/smf/index.php?topic=169696.msg8083872#msg8083872]
|}

==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) ends it, the order of the intervening tokens isn't important.

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

|-
| {{text anchor|CE_X}}
|
| The effect type. This can be a number of different tokens, as detailed in the tables that follow this one.

|-
| {{text anchor|SEV}}
| <amount>
| The severity of the effect. Higher values appear to be worse, with SEV:1000 CE_NECROSIS causing a part to near-instantly become rotten. Can go as high as 2147483647, and can be negative.

|-
| {{text anchor|PROB}}
| <amount>
| The probability of the effect actually manifesting in the victim, as a percentage. 100 means always, 1 means a 1 in 100 chance.

|-
| {{text anchor|BP}}
| <body part>:<tissue>
| (Optional; overridden by [[Syndrome#LOCALIZED|LOCALIZED]]) Specifies which body parts and tissues the effect is to be applied to. Not every effect requires a target!

<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 by the [BP] token of the body plan definition. For example, if you wanted to target the lungs of a creature, you would use BP:BY_CATEGORY:LUNG:ALL. The effect would act on all body parts 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 body parts. Multiple targets can be given in one effect 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 body parts relevant to the contagion, like lungs for coal dust inhalation, or the eyes for exposure to an acid gas.

|-
| {{text anchor|LOCALIZED}}
|
| (Optional; overrides [[Syndrome#BP|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 - i.e. 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 (such as IMPAIR_FUNCTION on a non-organ) then this token makes the effect do nothing. This token also makes inhaled syndromes have no effect.

|-
| {{text anchor|VASCULAR_ONLY}}
|
| (Optional) This effect only affects tissue layers with the VASCULAR token.

|-
| {{text anchor|MUSCULAR_ONLY}}
|
| (Optional) This effect only affects tissue layers with the MUSCULAR token.

|-
| {{text anchor|SIZE_DILUTES}}
|
| (Optional) This token presumably causes the severity of the effect 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.

|-
| {{text anchor|SIZE_DELAYS}}
|
| (Optional) As above, this token has yet to be tested but presumably delays the onset of an effect according to the size of the victim.

|-
| {{text anchor|CAN_BE_HIDDEN}}
|
| (Optional) Can be hidden by a unit assuming a secret identity, such as a [[vampire]]. {{verify}}

|-
| {{text anchor|RESISTABLE}} (sic)
|
| (Optional) Whether a syndrome can build tolerance by exposure. If this token is present, each application of the syndrome will cause future applications to be weaker. This seems to be a permanent effect that does not fall off over time. (yes, it's spelled incorrectly)

|-
| {{text anchor|DWF_STRETCH}}
| <amount>
| (Optional) Multiplies the duration values of the effect by the specified amount in Fortress mode.

|-
| {{text anchor|ABRUPT_START}}
|
| (Optional) Makes the effect begin immediately rather than ramping up.

|-
| {{text anchor|ABRUPT_END}}
|
| (Optional) Makes the effect end immediately rather than ramping down.

|-
| {{text anchor|ABRUPT}}
|
| (Optional) Combination of ABRUPT_START and ABRUPT_END.

|-
| {{text anchor|START}}
| <time>
| Determines the time after exposure, in ticks, when the effect starts. Required for all effects.

|-
| {{text anchor|PEAK}}
| <time>
| (Optional) Determines the time after exposure, in ticks, when the effect reaches its peak intensity.

|-
| {{text anchor|END}}
| <time>
| (Optional) Determines the time after exposure, in ticks, when the effect ends.
|}

A key point that needs to be understood with regards to damaging syndrome effects such as [[Syndrome#CE_BRUISING|bruising]] is that they deal a quantity of damage (based on the effect's SEV and other modifiers) '''every [[time|tick]]''', and this damage accumulates over time. Thus, even a bruising effect at the lowest possible severity value '''will''' eventually lead to destruction of the affected body part(s) if the effect has a long enough duration. Similarly, [[Syndrome#Healing_Effects|healing effects]] undo a specific amount of damage every tick whilst the effect lasts.

===Symptomatic Effects===

The following table contains [[Syndrome#Creature effect tokens|creature effect tokens]] which cause purely medical [[symptom]]s.

Non-targeted effects will ignore any BP tokens and LOCALIZED tokens.

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!

{| {{prettytable}}
|- bgcolor="Bisque"
! Token
! Accepts Target
! Description
|-
| {{text anchor|CE_BRUISING}}
| Yes
| Causes the targeted body part to undergo bruising.
|-
| {{text anchor|CE_BLISTERS}}
| Yes
| Covers the targeted body part with blisters.
|-
| {{text anchor|CE_OOZING}}
| Yes
| Causes pus to ooze from the afflicted body part.
|-
| {{text anchor|CE_BLEEDING}}
| Yes
| Causes the targeted body part 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.
|-
| {{text anchor|CE_SWELLING}}
| Yes
| Causes the targeted body part to swell up. Extreme swelling may lead to necrosis.
|-
| {{text anchor|CE_NECROSIS}}
| Yes
| Causes the targeted body part to rot, with associated tissue damage, miasma emission and bleeding. The victim slowly bleeds to death if the wound is not treated. Badly necrotic limbs will require amputation.
|-
| {{text anchor|CE_NUMBNESS}}
| Optional
| Causes numbness in the affected body part, blocking pain. Extreme numbness may lead to sensory nerve damage. If no target is specified this applies to all body parts.
|-
| {{text anchor|CE_PAIN}}
| Optional
| Afflicts the targeted body part with intense pain. If no target is specified this applies to all body parts.
|-
| {{text anchor|CE_PARALYSIS}}
| Optional
| Causes complete paralysis of the affected body part. Paralysis on a limb may lead to motor nerve damage. If no target is specified this causes total paralysis, which can lead to suffocation of smaller creatures.
|-
| {{text anchor|CE_IMPAIR_FUNCTION}}
| Yes
| An organ afflicted with this effect 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. Note that this effect is currently bugged, and will not "turn off" until the creature receives a wound to cause its body parts to update.
|-
| {{text anchor|CE_DIZZINESS}}
| No
| Inflicts the Dizziness condition, occasional fainting and a general slowdown in movement and work speed.
|-
| {{text anchor|CE_DROWSINESS}}
| No
| Causes the Drowsiness condition.
|-
| {{text anchor|CE_UNCONSCIOUSNESS}}
| No
| Renders the creature unconscious.
|-
| {{text anchor|CE_FEVER}}
| No
| Causes the Fever condition.
|-
| {{text anchor|CE_NAUSEA}}
| No
| Causes the Nausea condition, and heavy vomiting. Can eventually lead to dehydration and death.
|-
| {{text anchor|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.
|-
| {{text anchor|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.
|}

===Healing Effects===
Most of the [[Syndrome#Symptomatic_Effects|above]] effects have counterparts to alleviate [[symptom]]s and heal physical damage:
{| {{prettytable}}
|- bgcolor="Bisque"
! Token
! Accepts Target
! Description
|-
| {{text anchor|CE_REDUCE_PAIN}}
| Yes
| Decreases the severity of pain produced by wounds or syndrome effects on the targeted body part. The SEV value probably controls by how much the pain is decreased.
|-
| {{text anchor|CE_REDUCE_SWELLING}}
| Yes
| Decreases the severity of swelling on the targeted body part.
|-
| {{text anchor|CE_REDUCE_PARALYSIS}}
| Yes
| Decreases the severity of any paralysis effects on the targeted body part.
|-
| {{text anchor|CE_REDUCE_DIZZINESS}}
| No
| Decreases the severity of any dizziness the creature has.
|-
| {{text anchor|CE_REDUCE_NAUSEA}}
| No
| Decreases the severity of any nausea the creature has.
|-
| {{text anchor|CE_REDUCE_FEVER}}
| No
| Decreases the severity of any fever the creature has.
|-
| {{text anchor|CE_STOP_BLEEDING}}
| Yes
| Decreases the severity of the bleeding of any wounds or syndrome effects on the targeted body part. The SEV value probably controls by how much the bleeding is decreased.
|-
| {{text anchor|CE_CLOSE_OPEN_WOUNDS}}
| Yes
| Closes any wounds on the targeted body part with speed depending on the SEV value.
|-
| {{text anchor|CE_CURE_INFECTION}}
| Yes?
| Probably decreases the severity of the infection from infected wounds over time.
|-
| {{text anchor|CE_HEAL_TISSUES}}
| Yes
| Heals the tissues of the targeted body part with speed depending on the SEV value.
|-
| {{text anchor|CE_HEAL_NERVES}}
| Yes
| Heals the nerves of the targeted body part with speed depending on the SEV value.
|-
| {{text anchor|CE_REGROW_PARTS}}
| Yes
| Causes missing body parts to regrow. SEV controls how quickly body parts are regrown. In adventure, parts may be lost again once you travel or wait/sleep {{bug|0011396}}.
|}

===Special Effects===
Several special syndrome effects take different arguments than the above. These are used for generated interactions in unmodded games, but may be used as well for any custom substance or interaction. CE_FEEL_EMOTION is the only one of these that takes SEV.

{| {{prettytable}}
|- bgcolor="Bisque"
! Token
! Accepts Target
! Arguments
! Description
|-
| {{text anchor|CE_ADD_TAG}}
| No
| <tag 1>:<tag 2>:etc
| Adds the specified tag(s) to the affected creature. Multiple tags can be specified sequentially within a single effect token. Valid tags:

'''Special tags:'''

*NO_AGING
Halts the creature's aging process and prevents [[Creature token#MAXAGE|death by old age]].

*STERILE
Makes the creature unable to produce [[children|offspring]].

*HAS_BLOOD
*MORTAL
*FIT_FOR_ANIMATION
*FIT_FOR_RESURRECTION
Adding these tags to a creature doesn't appear to do anything.

'''Creature tokens:'''

*[[Creature_token#BLOODSUCKER|BLOODSUCKER]]
*[[Creature_token#CAN_LEARN|CAN_LEARN]]
*[[Creature_token#CAN_SPEAK|CAN_SPEAK]]
*[[Creature_token#CRAZED|CRAZED]]
*[[Creature_token#EXTRAVISION|EXTRAVISION]]
*[[Creature_token#MISCHIEVOUS|MISCHIEVOUS]] (or [[Creature_token#MISCHIEVIOUS|MISCHIEVIOUS]])
*[[Creature_token#NO_CONNECTIONS_FOR_MOVEMENT|NO_CONNECTIONS_FOR_MOVEMENT]]
*[[Creature_token#NO_DIZZINESS|NO_DIZZINESS]]
*[[Creature_token#NO_DRINK|NO_DRINK]]
*[[Creature_token#NO_EAT|NO_EAT]]
*[[Creature_token#NO_FEVERS|NO_FEVERS]]
*[[Creature_token#NO_PHYS_ATT_GAIN|NO_PHYS_ATT_GAIN]]
*[[Creature_token#NO_PHYS_ATT_RUST|NO_PHYS_ATT_RUST]]
*[[Creature_token#NO_SLEEP|NO_SLEEP]]
*[[Creature_token#NO_THOUGHT_CENTER_FOR_MOVEMENT|NO_THOUGHT_CENTER_FOR_MOVEMENT]]
*[[Creature_token#NOBREATHE|NOBREATHE]]
*[[Creature_token#NOEMOTION|NOEMOTION]]
*[[Creature_token#NOEXERT|NOEXERT]]
*[[Creature_token#NOFEAR|NOFEAR]]
*[[Creature_token#NONAUSEA|NONAUSEA]]
*[[Creature_token#NOPAIN|NOPAIN]]
*[[Creature_token#NOSTUN|NOSTUN]]
*[[Creature_token#NOT_LIVING|NOT_LIVING]]
*[[Creature_token#NOTHOUGHT|NOTHOUGHT]]
*[[Creature_token#OPPOSED_TO_LIFE|OPPOSED_TO_LIFE]]
*[[Creature_token#PARALYZEIMMUNE|PARALYZEIMMUNE]]
*[[Creature_token#SUPERNATURAL|SUPERNATURAL]]
*[[Creature_token#TRANCES|TRANCES]]
*[[Creature_token#UTTERANCES|UTTERANCES]]
*[[Creature_token#NIGHT_CREATURE_EXPERIMENTER|NIGHT_CREATURE_EXPERIMENTER]]

Adding tags will cause the creature to pass/fail any relevant <code>[[Interaction token#IT_REQUIRES|IT_REQUIRES]]</code>/<code>[[Interaction_token#IT_FORBIDDEN|IT_FORBIDDEN]]</code> checks (with the apparent exceptions of FIT_FOR_ANIMATION and FIT_FOR_RESURRECTION). Note that [[Syndrome#CE_REMOVE_TAG|CE_REMOVE_TAG]] overrides this effect.

|-
| {{text anchor|CE_REMOVE_TAG}}
| No
| <tag 1>:<tag 2>:etc
| Removes the specified tag(s) from the affected creature. Multiple tags can be specified sequentially within a single effect token. The tags listed [[Syndrome#CE_ADD_TAG|above]] can all be removed via this effect.

If a particular tag is targeted by both CE_REMOVE_TAG and [[Syndrome#CE_ADD_TAG|CE_ADD_TAG]], and both effects are active simultaneously, CE_REMOVE_TAG takes precedence (i.e. the overall effect is that of tag removal for as long as CE_REMOVE_TAG remains active). The order in which the effects activate doesn't affect this, not even if CE_ADD_TAG is added later/earlier via a different syndrome.

Removing tags will cause the creature to fail/pass any relevant <code>[[Interaction token#IT_REQUIRES|IT_REQUIRES]]</code>/<code>[[Interaction_token#IT_FORBIDDEN|IT_FORBIDDEN]]</code> checks (with the apparent exceptions of FIT_FOR_ANIMATION and FIT_FOR_RESURRECTION).

'''Special tags:'''

* HAS_BLOOD
If this tag is removed, the creature behaves as though it has no [[Creature token#BLOOD|blood]]; it doesn't bleed when [[Tissue definition token#VASCULAR|VASCULAR]] tissues are damaged (and thus cannot die of blood loss), and substances cannot be [[Syndrome#SYN_INJECTED|injected]] into it.

* NO_AGING
* STERILE
Removing these tags doesn't appear to do anything unless they've been added to a creature via [[Syndrome#CE_ADD_TAG|CE_ADD_TAG]], in which case their effects will be negated as described above.

* MORTAL
* FIT_FOR_ANIMATION
* FIT_FOR_RESURRECTION
Removing these tags doesn't appear to do anything.

|- a
| {{text anchor|CE_DISPLAY_NAME}}
| No
| NAME:singular:plural:adjective
| Attaches the specified name to the creature's normal name.

|-
| {{text anchor|CE_DISPLAY_TILE}}
| No
| TILE:[[Tilesets|<tile value or character>]]:[[Color#Color_values|<foreground color>:<background color>:<foreground brightness>]]
| Causes the creature to display the specified tile instead of its normal one.

|-
| {{text anchor|CE_FLASH_TILE}}
| No
| TILE:[[Tilesets|<tile value or character>]]:[[Color#Color_values|<foreground color>:<background color>:<foreground brightness>]]:FREQUENCY:<frames default tile>:<frames syndrome tile>
| Causes the creature to flash between its normal tile and the one specified here.

|-
| {{text anchor|CE_PHYS_ATT_CHANGE}}
| No
| [[Attribute]]:percentage:fixed boost(?)
| Alters the creature's specified [[Attribute#Body_attributes|physical attribute]].

|-
| {{text anchor|CE_MENT_ATT_CHANGE}}
| No
| [[Attribute]]:percentage:fixed boost(?)
| Alters the creature's specified [[Attribute#Soul_attributes|mental attribute]].

|-
| {{text anchor|CE_SPEED_CHANGE}}
| No
| speed modifier:number
| Changes the creature's speed.
Speed modifier contains one or both of:
* SPEED_PERC:percentage (this modifies a creature's in-game speed, so higher numbers are faster)
* SPEED_ADD:number (this modifies a creature's [SPEED:XX] token, so higher numbers are slower. Negative numbers are accepted though will only reduce a creature's speed to zero)
The minimum and maximum speeds able to be created by CE_SPEED_CHANGE are 99 and 10,000 respectively.

|-
| {{text anchor|CE_SKILL_ROLL_ADJUST}}
| No
| PERC:percentage:PERC_ON:percentage
| Alters the results of all [[Skill#Skills in use|skill rolls]] the creature makes, multiplying them by ``PERC / 100``. The ``PERC_ON`` value specifies the probability of the effect being applied on a particular roll.
e.g. This causes a 20% chance of any skill roll being 0 (multiplies the current skill level by 0/100) instead of the normal result
[CE_SKILL_ROLL_ADJUST:PROB:100:PERC:0:PERC_ON:20:START:0]

|-
| {{text anchor|CE_BODY_APPEARANCE_MODIFIER}}
| No
| APPEARANCE_MODIFIER:HEIGHT/LENGTH/BROADNESS:percentage(?)
| Alters the size of the creature.

|-
| {{text anchor|CE_BP_APPEARANCE_MODIFIER}}
| Yes
| body part:APPEARANCE_MODIFIER:attribute:number
| Alters the characteristics (height, width etc.) of a body part. "body part" here can either be BP, followed by the usual BY_CATEGORY etc., or TL, followed by the usual selection for SELECT_TISSUE_LAYER.

|-
| {{text anchor|CE_BODY_TRANSFORMATION}}
| No
|
| Makes the affected unit transform into a different creature. The target creature may either be specified directly by following this with a CE:CREATURE token, or else set to be randomly selected as indicated by the additional tokens listed below (of which multiple may be specified).

Note that transformation into or out of the target form causes the creature to drop all items in its inventory and instantly heals all of its wounds. If an [[undead]] limb happens to be transformed, its entire body will regenerate upon transforming back.

Transformation will also re-roll a creature's age to somewhere within the new form's adult age range. This prevents a 70 year old dwarf from dying the moment it turns into a bat ([[Creature token#MAXAGE|max age]] of 3). If it remains stuck as a bat for (at most) three consecutive years it will die of old age as a bat before the syndrome is able to wear off.

A transformed creature generally retains its previous group and civilization membership (unless it becomes [[Creature token#OPPOSED_TO_LIFE|OPPOSED_TO_LIFE]] for example). A transformed dwarf will remain a member of your fortress (and may still hold or gain [[Noble|positions]]), a transformed trader will hang out at the trade depot and eventually leave along with its fellow traders, and a transformed goblin will continue sieging your fortress with its fellow siege members.

A transformed diplomat (like a trade liaison or expedition leader) will still be able to conduct diplomatic meetings even if they no longer [[Creature token#CAN_SPEAK|CAN_SPEAK]].

Transformed creatures can be trained and adopted following the usual rules. However note that if a transformed creature is a member of your fortress then [[Animal Training|animal trainers]] will not attempt to train it.

A transformed creature can produce offspring with creatures of the species it has transformed into and will follow that creature's normal rules for reproduction.

[[Butcher#Butchering|Butchering]] a transformed creature may produce an odd mix of products. For example, if Urist the dwarf is transformed into a [[Cow|bull]] and then is led to the butcher's block for slaughter the resulting products will contain some bull creature parts like "Urist's horn", "Urist's hoof", and "Urist's skin" (which becomes "cow leather" when [[Tanner|tanned]]) but will also contain some dwarf creature parts like "dwarf meat", "dwarf eye", and "dwarf brain".

'''Specific transformation:'''

* '''CE:CREATURE:'''<creature>:<caste> 
This can be used to specify a target creature to transform into ([CE:CREATURE:DWARF:FEMALE], for example). '''ALL''' or '''ANY''' can be used in place of a specific caste to randomise this for every transformation.
Do note that using '''ALL''' or '''ANY''' for transformation castes will make the creature transform over and over again with the interval depending on the '''START''' token. This can lead to an unending transformation loop. [[Syndrome#looping_problem|However, there is a way to get around this.]]

'''Random transformation:'''

* '''CE:CREATURE_FLAG:'''<[[Interaction_token#Creature_and_Caste_Flags|creature flag]]> 
Narrows down the selection to creatures which have the specified [[Interaction_token#Creature_and_Caste_Flags|creature flag]]. May be used multiple times per transformation effect; creatures which lack any of the indicated flags will never be transformed into.

* '''CE:FORBIDDEN_CREATURE_FLAG:'''<[[Interaction_token#Creature_and_Caste_Flags|creature flag]]> 
Excludes creatures with the specified [[Interaction_token#Creature_and_Caste_Flags|creature flag]] from the random selection pool. May be used multiple times per transformation effect; creatures which possess any of the indicated flags will never be transformed into.

* '''CE:CREATURE_CASTE_FLAG:'''<[[Interaction_token#Creature_and_Caste_Flags|caste flag]]> 
Narrows down the selection to creatures which have the specified [[Interaction_token#Creature_and_Caste_Flags|caste flag]]. May be used multiple times per transformation effect; creatures which lack any of the indicated flags will never be transformed into.

* '''CE:FORBIDDEN_CREATURE_CASTE_FLAG:'''<[[Interaction_token#Creature_and_Caste_Flags|caste flag]]> 
Excludes any creature with the specified [[Interaction_token#Creature_and_Caste_Flags|caste flag]] from the random selection pool. May be used multiple times per transformation effect; creatures which possess any of the indicated flags will never be transformed into.

*'''CE:HAVE_FAST_EFFORTLESS_GAIT_SPEED:'''<minimum [[Gait#Speed|gait speed]]> 
Narrows down the selection to creatures which have at least one [[gait]] with an [[Creature_token#GAIT|<energy expenditure>]] of 0 and a [[Creature_token#GAIT|<max speed>]] less than or equal to the specified <minimum gait speed> ("less than" because lower is faster in the scale used for [[Gait#Speed|gait speed]]). This is used in generated [[Die#Adventurer_Mode|divination curses]] to prevent the player from being transformed into a creature that is frustratingly slow to play as. [http://www.bay12forums.com/smf/index.php?topic=169696.msg8243222#msg8243222]

*'''CE:ALL_SLOW_EFFORTLESS_GAIT_SPEED:'''<maximum [[Gait#Speed|gait speed]]> 
Excludes any creatures which have at least one [[gait]] with an [[Creature_token#GAIT|<energy expenditure>]] of 0 and a [[Creature_token#GAIT|<max speed>]] value less than or equal to the specified <maximum gait speed> (note that larger values are slower in the scale used for [[Gait#Speed|gait speed]]). [http://www.bay12forums.com/smf/index.php?topic=169696.msg8243222#msg8243222]

|-
| {{text anchor|CE_MATERIAL_FORCE_MULTIPLIER}}
| No
| MAT_MULT:[[material token|<material token>]]:<value A>:<value B>
| When the affected creature is struck with a weapon made of the specified material, the force exerted will be multiplied by A/B, thus making the creature more or less susceptible to this material. For example, if A is 2 and B is 1, the force exerted by the defined material will be doubled. If A is 1 and B is 2, it will be halved instead. '''NONE:NONE''' can be used in place of a specific material token so as to make the effect applicable to all materials. Note that this syndrome effect is equivalent to the [[Creature_token#MATERIAL_FORCE_MULTIPLIER|MATERIAL_FORCE_MULTIPLIER]] creature token.

|-
| {{text anchor|CE_CAN_DO_INTERACTION}}
| No
|
| Makes the creature able to perform an [[Interaction_token|interaction]]. Follow this effect token with [[Interaction_token#INTERACTION|[CDI:INTERACTION:<interaction name>]]] to specify the desired interaction, and add other [[Interaction_token#Usage|CDI tokens]] as required.
|-
| {{text anchor|CE_SPECIAL_ATTACK_INTERACTION}}
| Yes
| INTERACTION:<interaction name>:BP:<selection criteria>:<name of category,type, or token of designated part/parts>
| Makes the creature able to perform an interaction when using an attack with a designated body part/parts. See [[#In 0.47.01|below]] for an example

|-
| {{text anchor|CE_BODY_MAT_INTERACTION}}
| No
| MAT_TOKEN:<body material token>
| This is used to tie an [[Interaction_token|interaction]] to one of the creature’s body materials. Generated [[vampire]] syndromes use this effect to make vampire blood pass on the vampirism curse when consumed.

The target body material is specified by inserting its ID as defined in the creature raws. For example, when a syndrome with “CE_BODY_MAT_INTERACTION:MAT_TOKEN:SWEAT” is gained by a unit, the effect will apply to any material defined as “SWEAT” in the creature raws of that unit, if such a material is present.
'''RESERVED_BLOOD''' is a special body material token which can be used to specify the [[Creature_token#BLOOD|[BLOOD]]] material of any creature, regardless of the material's actual ID.

The following tokens should be placed after this effect:
* '''CE:SYNDROME_TAG:'''<transmission method> is used to specify what must be done with the body material to trigger the interaction. Replace "<transmission method>" with any of '''[[Syndrome#SYN_INGESTED|SYN_INGESTED]], [[Syndrome#SYN_INJECTED|SYN_INJECTED]], [[Syndrome#SYN_CONTACT|SYN_CONTACT]], [[Syndrome#SYN_INHALED|SYN_INHALED]]'''. Multiple instances of this tag may be used to specify different valid transmission routes. ''However, SYN_INGESTED appears to be the only one that works at present.''
* '''CE:INTERACTION:'''<[[Interaction_token#INTERACTION|interaction ID]]> is used to specify which interaction is to be run (replace "<interaction ID>" with the name of the desired interaction). Appropriate interaction effects with a creature target (such as [[Interaction_token#I_EFFECT|ADD_SYNDROME]]) will be inflicted upon the unit who interacts with the body material as specified above. Note that the linked interaction must have an [[Interaction_token#I_SOURCE|[I_SOURCE:INGESTION]]] token for this to work.

This currently only works on materials obtained from historical figures. That is to say, the material must bear the source unit's name, such as "Urist McVampire's dwarf blood" as opposed to mere "dwarf blood".

|-
| {{text anchor|CE_SENSE_CREATURE_CLASS}}
| No
| CLASS:<[[Creature_token#CREATURE_CLASS|creature class]]>:
[[Tilesets|<tile value or character>]]:
[[Color#Color_values|<foreground color>:<background color>:<foreground brightness>]]
| Provides the ability to sense creatures belonging to the specified [[Creature_token#CREATURE_CLASS|creature class]] even when such creatures lie far beyond line of sight, including through walls and floors. It also appears to reduce or negate the combat penalty of [[Wound#Blindness|blind]] units when fighting creatures they can sense. In [[adventure mode]], the specified tile will be used to represent sensed creatures when they cannot be seen directly.

|-
| {{text anchor|CE_FEEL_EMOTION}}
| No
| EMOTION:<[[emotion]]>
| Makes the creature feel a specific [[emotion]]. The effect's SEV value determines how intense the emotion is. The creature also receives a [[thought]] in the following format: "[creature] feels [emotion] due to [[Syndrome#SYN_NAME|[syndrome name]]]". See [[Emotion]] for the list of valid emotions.

|-
| {{text anchor|CE_CHANGE_PERSONALITY}}
| No
| FACET:<[[Personality facet|personality facet]]>:<amount>
| Changes a [[personality facet]] by the given amount. Multiple FACET:<facet>:<amount> sets may be used, and <amount> can be negative. For example, generated [[necromancer]] syndromes come with the following effect: 
<code>[CE_CHANGE_PERSONALITY:FACET:ANXIETY_PROPENSITY:50:FACET:TRUST:-50:START:0:ABRUPT]</code>

According to Toady, CE_CHANGE_PERSONALITY effects can cause creatures to re-evaluate their [[Personality goal|goals]] in worldgen; the boost to anxiety and distrust given to necromancers makes it more likely for them to develop the goal of [[Personality goal#RULE_THE_WORLD|ruling the world]]. [http://www.bay12forums.com/smf/index.php?topic=169696.msg8275328#msg8275328]

|-
| {{text anchor|CE_ERRATIC_BEHAVIOR}}
| No
|
| Causes erratic behavior, meaning "People that [[Personality facet#VIOLENT|like to brawl]] have a chance of starting a brawl-level fight with any nearby adult." [http://www.bay12forums.com/smf//index.php?topic=159164.msg7632503#msg7632503 -Toady]
|}

'''All''' creature effect tokens take START, END and PROB numbers, and can be followed by [CE:PERIODIC] and/or [CE:COUNTER_TRIGGER] to restrict when they actually take effect.

===Periodic Triggers===

'''[CE:{{text anchor|PERIODIC}}:<period_type>:<min_value>:<max_value>]'''

When this token is placed after a syndrome effect, it will prevent that effect from working unless within the specified period range.

For example, generated [[werebeast]] syndromes have a [[Syndrome#CE_BODY_TRANSFORMATION|body transformation effect]] with <code>[CE:PERIODIC:[[Syndrome#MOON_PHASE|MOON_PHASE]]:27:0]</code>, which makes the transformation active only throughout moon phases 27 to 0 (the full moon period). Once the moon phase changes from 0 to 1, the transformation will end and remain inactive until phase 27 is reached again (unless of course the effect has an END time which is reached before this happens. On that note, keep in mind that the START time of the effect needs to have been reached for activation to have become possible).

Only one periodic trigger may currently be specified per effect. [[Syndrome#Counter_Triggers|Counter triggers]] can also be specified for the same effect, in which case both the periodic trigger and at least one counter trigger will need to have its conditions met for the effect to be allowed to work.

MOON_PHASE is currently the only valid period type:

{| {{prettytable}}
|- bgcolor="Bisque"
! Period
! Description
|-
| {{text anchor|MOON_PHASE}}
| The lunar cycle in ''Dwarf Fortress'' is composed of 28 segments (each slightly shorter than a [[time|day]] in duration), with each segment represented by a value ranging from 0 to 27. These correspond to moon phases as follows:
* '''0''' = full moon
* '''1-4''' = waning gibbous
* '''5-8''' = waning half
* '''9-12''' = waning crescent
* '''13-14''' = new moon
* '''15-18''' = waxing crescent
* '''19-22''' = waxing half
* '''23-26''' = waxing gibbous
* '''27''' = full moon
|}

===Counter Triggers===

'''[CE:{{text anchor|COUNTER_TRIGGER}}:<counter_name>:<min_value>:<max_value>:REQUIRED]'''

Creatures in ''Dwarf Fortress'' possess internal counters which keep track of their various activities and statuses. When this token is placed after a syndrome effect, it will prevent the effect from working unless the affected creature has the indicated counter, and its value lies within the specified range.

For example, generated [[vampire]] syndromes use <code>[CE:COUNTER_TRIGGER:[[Syndrome#DRINKING_BLOOD|DRINKING_BLOOD]]:1:NONE:REQUIRED]</code> with an [[Syndrome#CE_BP_APPEARANCE_MODIFIER|appearance modifier]] to make the vampire's teeth temporarily lengthen whilst leeching blood.

Note that <code>NONE</code> can be used in place of <max_value> to indicate that any value above <min_value> is valid. <code>NONE</code> can also be used in place of <min_value>, which is equivalent to the lowest value attainable by a counter.

<code>REQUIRED</code> implies that the effect won't proceed if the counter exists but doesn't lie within the range provided. However, it's actually redunant as COUNTER_TRIGGER always checks for both of these conditions [http://www.bay12forums.com/smf/index.php?topic=169696.msg8173424#msg8173424]; replacing it with <code>NONE</code> doesn't alter the way the trigger functions, though it ''will'' fail to work if this slot is left empty instead.

As detailed below, most counters only exist temporarily, so their use as triggers is somewhat more restricted than intuition suggests. For example, specifying <code>0</code> or <code>NONE</code> as the <min_value> for a [[Syndrome#CAVE_ADAPT|CAVE_ADAPT]] trigger wouldn't permit the effect to work when the affected creature is outside, since this counter is removed from the unit as soon as its value decreases past 1. Similarly, [[Syndrome#MILK_COUNTER|MILK_COUNTER]] is only present for some time ''after'' a creature is milked.

Multiple counter triggers can be specified per effect, in which case the effect will be permitted to work if at least one of the trigger conditions is met. A [[Syndrome#Periodic_Triggers|periodic trigger]] can also be specified for the same effect, in which case both the periodic trigger and at least one counter trigger will need to have their conditions met for the effect to work.

The following is a list of valid counter types including a couple of notable values:

{| {{prettytable}}
|- bgcolor="Bisque"
! Counter
! Description

|-
| {{text anchor|ALCOHOLIC}}
| For {{token|ALCOHOL_DEPENDENT|c}} creatures, this counter increases by 1 each [[time|tick]], and is reset to 0 when the creature drinks [[alcohol]]. The following messages are added after "needs alcohol to get through the working day" in the creature's description when the counter reaches the specified values:
* 100800 (3 months) = and is starting to work slowly due to its scarcity
* 201600 (6 months) = and really wants a drink
* 302400 (9 months) = and has gone without a drink for far, far too long
* 403200 (1 year) = and can't even remember the last time (s)he had some

|-
| {{text anchor|CAVE_ADAPT}}
| For creatures with the {{token|CAVE_ADAPT|c}} token, this counter is created and increases by 1 each [[time|tick]] when the creature is in the {{DFtext|Dark|0:1}}, and is deleted once the dwarf steps outside and [[vomit]]s. See [[cave adaptation]] for more information.
* 403200 (1 year) = going outside causes irritation
* 604800 (1.5 years) = going outside causes nausea

|-
| {{text anchor|MILK_COUNTER}}
| When a creature is milked, this counter is created and set to the frequency value specified in the creature's {{token|MILKABLE|c}} token, and subsequently decreases by 1 each [[time|tick]] until it reaches 0, at which point it is immediately removed, making the creature available for milking again.

|-
| {{text anchor|EGG_SPENT}}
| This counter is created and set to 100800 (3 months' worth of [[time|tick]]s in fortress mode) when a creature [[Creature_token#LAYS_EGGS|lays eggs]], and thereafter decreases by 1 each tick until it reaches 0, at which point it is removed and the creature regains the ability to lay eggs.

|-
| {{text anchor|GROUNDED_ANIMAL_ANGER}}
| How angry (and likely to attack) an animal without is from being in an overcrowded location. The counter is added and increases by 200 whenever a unit is lying on the ground and does not have [CAN_LEARN]. It subsequently decreases by 1 each [[time|tick]], with a 1% chance to increase by 200. The counter is removed if it decreases to 0. If the counter is greater than 45000 the unit will lash out at a random nearby unit and the counter will be reset to 40000. This is the counter's only effect.

|-
| {{text anchor|TIME_SINCE_SUCKED_BLOOD}}
| This counter rises by 1 every [[time|tick]] for creatures with the {{token|BLOODSUCKER|c}} token. When it rises high enough (generally around 100800; 3 months in fortress mode time), the creature will seek an [[sleep|unconscious]] victim to leech off of. Blood-sucking causes the counter to decrease, and will continue until either the victim is dead or the counter reaches 0. Note that this counter isn't removed when 0 is reached.

When playing as a bloodsucker in [[adventure mode]], the following bloodthirst indicators are displayed when this counter reaches the specified values:
* 172800 (1 day in adventure mode time) = {{DFtext|Thirsty|4:0}}
* 1209600 (1 week) = {{DFtext|Thirsty!|4:1}}
* 2419200 (2 weeks) = {{DFtext|Thirsty!|5:1}}
Various penalties are applied as bloodthirst increases; see the [[vampire]] article for more information.

|-
| {{text anchor|DRINKING_BLOOD}}
| This appears to be created and set to a fixed value of 20 whilst the creature is sucking blood, and begins to decrease by 1 each [[time|tick]] once blood-sucking ceases (as described [[Syndrome#TIME_SINCE_SUCKED_BLOOD|above]]) until it reaches 0, at which point the counter is removed.

|}

{{mod}}

==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.
[MELTING_POINT:NONE]
[BOILING_POINT:10000]
[MAT_FIXED_TEMP:10001]
[SPEC_HEAT:1]
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#SYN_INHALED|SYN_INHALED]] syndrome you thoughtfully attached to the material definition earlier! Note that creatures do not need to inhale every tick, so there is a chance that the gas will dissipate before it can infect any particular creature.

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 definition token]]s.

==Spreading diseases==
It's fully possible to make a nasty disease capable of spreading itself from an infected dwarf to others, though it requires some skill in modding [[interaction token|interactions]] as well. Here is an example of a plague-inflicting interaction:

[INTERACTION:PLAGUE]
[I_TARGET:A:CREATURE]
[IT_LOCATION:CONTEXT_CREATURE]
[IT_FORBIDDEN:NOT_LIVING]
[IT_AFFECTED_CLASS:GENERAL_POISON]
[IT_MANUAL_INPUT:creatures]
[I_EFFECT:ADD_SYNDROME]
[IE_TARGET:A]
[IE_IMMEDIATE]
[SYNDROME]
[SYN_NAME:the plague]
[SYN_AFFECTED_CLASS:GENERAL_POISON]
[CE_FEVER:SEV:250:PROB:100:START:250:PEAK:1500:END:25000]
[CE_BLISTERS:SEV:325:PROB:100:BP:BY_CATEGORY:ALL:SKIN:START:250:PEAK:1500:END:25000]
[CE_NECROSIS:SEV:300:PROB:100:BP:BY_CATEGORY:ALL:ALL:VASCULAR_ONLY:START:22500:PEAK:23750:END:25000]
[CE_CAN_DO_INTERACTION:START:1500:END:25000]
[CDI:ADV_NAME:Spread the plague]
[CDI:INTERACTION:PLAGUE]
[CDI:TARGET:A:LINE_OF_SIGHT]
[CDI:TARGET_RANGE:A:10]
[CDI:WAIT_PERIOD:30]

As you can see, the syndrome here inflicts blisters, fever and, after roughly a month, necrosis of the whole body - that's when the infected creatures will start dying out. But before that happens, CE_CAN_DO_INTERACTION makes them capable of spreading the plague further.

You also need a disease vector that will bring the plague straight to your fort. (hint: use [[large rat|various]] [[rat man|species]] [[giant rat|of rats]] - they're perfect for that). The following code, added to a creature's raws, ensures the creature will infect anybody it encounters:

[CAN_DO_INTERACTION:PLAGUE]
[CDI:ADV_NAME:Spread the plague]
[CDI:TARGET:A:LINE_OF_SIGHT]
[CDI:TARGET_RANGE:A:10]
[CDI:WAIT_PERIOD:30]

As soon as the said creature is startled by your dwarves, the [[fun]] will begin.

It is also possible to use a creature's established methods of attack for use in disease-spreading.

Let's use the borrowed example of the plague above. This time, the plague will spread through biting, using the following syndrome code:

[INTERACTION:PLAGUE]
[I_TARGET:A:CREATURE]
[IT_LOCATION:CONTEXT_CREATURE]
[IT_FORBIDDEN:NOT_LIVING]
[IT_AFFECTED_CLASS:GENERAL_POISON]
[IT_MANUAL_INPUT:creatures]
[I_EFFECT:ADD_SYNDROME]
[IE_TARGET:A]
[IE_IMMEDIATE]
[SYNDROME]
[SYN_NAME:the plague]
[SYN_AFFECTED_CLASS:GENERAL_POISON]
[CE_FEVER:SEV:250:PROB:100:START:250:PEAK:1500:END:25000]
[CE_BLISTERS:SEV:325:PROB:100:BP:BY_CATEGORY:ALL:SKIN:START:250:PEAK:1500:END:25000]
[CE_NECROSIS:SEV:300:PROB:100:BP:BY_CATEGORY:ALL:ALL:VASCULAR_ONLY:START:22500:PEAK:23750:END:25000]
[CE_SPECIAL_ATTACK_INTERACTION:INTERACTION:PLAGUE:BP:BY_CATEGORY:TOOTH:START:0:ABRUPT]

The line [CE_SPECIAL_ATTACK_INTERACTION:INTERACTION:BITE_PLAGUE:BP:BY_CATEGORY:MOUTH:BP:BY_CATEGORY:TOOTH:START:0:ABRUPT] allows any infected creature with an attack using mouth or tooth category body parts to immediately spread the disease using said attack. The victim of the attack may then spread the disease if they are able to attack with the needed body part/parts.

==Multi-caste/multi-creature body transformations==
This is a way to get around the {{text anchor|looping problem}} when using ANY or ALL castes for [[Syndrome#CE_BODY_TRANSFORMATION|CE_BODY_TRANSFORMATION]] and not being limited to a single creature for transformations. It's an incredibly simple solution as you can see in this example code:
{{code|code=
[SYNDROME]
[SYN_NAME:draconic curse]
[SYN_CLASS:DRACONIC_CURSE]
[CE_BODY_TRANSFORMATION:PROB:25:START:0]
[CE:CREATURE:HYDRA:MALE]
[CE_BODY_TRANSFORMATION:PROB:33:START:0]
[CE:CREATURE:DRAGON:MALE]
[CE_BODY_TRANSFORMATION:PROB:50:START:0]
[CE:CREATURE:HYDRA:FEMALE]
[CE_BODY_TRANSFORMATION:PROB:100:START:0]
[CE:CREATURE:DRAGON:FEMALE]
}}
This code will transform a creature into either a female/male [[hydra]] or a female/male [[dragon]].

For every caste/creature you want a ''victim'' to transform into, you add a [CE_BODY_TRANSFORMATION] token with a [PROB] token attached to it. For each of the transformations, the PROB is set to ``100 / number_of_remaining_transformations`` (or different numbers if you want uneven odds), with the final transformation having a PROB of 100 to ensure there is always at least one transformation chosen. A creature can only have one active transformation at a time, so if any of the lower PROB transformations occurs then the PROB 100 transformation can not happen.

If you instead want a ''sequence'' of transformations to take place then you need make sure that one transformation ends on the same tick that the next one begins:
{{code|code=
[SYNDROME]
[SYN_NAME:draconic sequence curse]
[SYN_CLASS:DRACONIC_SEQUENCE_CURSE]
[CE_BODY_TRANSFORMATION:PROB:100:START:0:END:10]
[CE:CREATURE:HYDRA:MALE]
[CE_BODY_TRANSFORMATION:PROB:100:START:10:END:20]
[CE:CREATURE:DRAGON:MALE]
[CE_BODY_TRANSFORMATION:PROB:100:START:20:END:30]
[CE:CREATURE:HYDRA:FEMALE]
[CE_BODY_TRANSFORMATION:PROB:100:START:30:END:40]
[CE:CREATURE:DRAGON:FEMALE]
}}

==See also==

* [[Syndrome examples]]
* [[Interaction token]]
* [[Modding]]

{{Category|Modding}}
{{Category|Creature attributes}}
{{Category|Tokens}}
[[ru:DF2012:Syndrome]]

Creature token

2025-04-13T22:04:27Z

DikbutDaGrate: Tested, and it doesn't. However, items stored in a refuse stockpile will speed up decay. The presence of rotter vermin at these locations is simply due to rotter vermin spawning mechanics.

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

The <code>[OBJECT:CREATURE]</code> [[token]] begins the definition of a ''Dwarf Fortress'' [[creature]] [[raw file]]. Each creature definition that follows begins with the {{token|creature|c|creature ID}} token, and the creature's exact properties and behavior are then specified by the use of further creature tokens. All known creature tokens are listed below.

Vanilla creature definitions can be found in <code>[[Game folder|<Dwarf Fortress>]]\data\vanilla\vanilla_creatures\</code>.
Creature ID is also used with [[graphics token]]s to make customizable [[graphics set]]s.

The [[caste]] tokens allow defining sub-species within the broader creature definition, including true biological castes and lesser variations, such as sexes. Creature tokens can either be 'Creature' or 'CASTE-only' type which can only be applied to creature or caste respectively, or 'CASTE' which can be applied to both. In the table bellow, creature type distinguishes tokens that can be applied to creature only, caste only, and both ('creature', 'CASTE-only', and 'CASTE' respectively)

__NOTOC__
{{clear}}
{{alphabetical TOC|style=margin: 1em auto;}}

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

|-
| {{text anchor|ADOPTS_OWNER}}
| Caste
|
| Prevents the tamed creature from being made available for adoption, instead allowing it to automatically adopt whoever it wants. The basic requirements for adoption are intact, and the creature will only adopt individuals who have a [[preference]] for their species. Used by [[cat]]s in the vanilla game. When {{k|v}}iewing a tame creature with this token, the message "This animal isn't interested in your wishes" will appear instead of "This [adorable] animal can't work" or "This animal is waiting to be trained".

|-
| {{text anchor|ALCOHOL_DEPENDENT}}
| Caste
|
| Makes the creature need [[alcohol]] to get through the working day; it will choose to drink booze instead of [[water]] if possible. Going sober for too long reduces speed.

|-
| {{text anchor|ALL_ACTIVE}}
| Caste
|
| When set, the creature will appear at any time of day. Overrides {{token|DIURNAL|c}}, {{token|NOCTURNAL|c}}, {{token|CREPUSCULAR|c}}, {{token|MATUTINAL|c}}, and {{token|VESPERTINE|c}}.

|-
| {{text anchor|ALTTILE}}
| Creature
|
*'character' or tile number
| If set, the creature will blink between its {{token|TILE|c}} and its ALTTILE.

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

|-
| {{text anchor|AMPHIBIOUS}}
| Caste
|
| Allows a creature to breathe both in and out of [[water]] (unlike {{token|AQUATIC|c}}) - does not prevent drowning in [[magma]].

|-
| {{text anchor|APP_MOD_DESC_RANGE}}
| Appearance Modifier
|
*Range (6 values, low to high)
| Based on info from [http://www.bay12forums.com/smf/index.php?topic=113762.msg3473069#msg3473069 Wannabehero on the forums]: When used with an appearance modifier token (BP_APPEARANCE_MODIFIER or BODY_APPEARANCE_MODIFIER), tells the game what numeric ranges to map to which descriptors.

The game uses 7 descriptor levels for each modifier, with the center one generally being to omit the thing from the creature description entirely. The six values in APP_MOD_DESC_RANGE define the boundaries between each described range. If this is not specified it uses the numbers 10:50:95:105:150:190.

|-
| {{text anchor|APP_MOD_GENETIC_MODEL}}
| Appearance Modifier
|
*Model (Accepts DOMINANT_MORE, DOMINANT_LESS, and MIX)
| Defines a genetic model for the relevant appearance modifier(s). May or may not do anything significant at present.

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

|-
| {{text anchor|APP_MOD_NOUN}}
| Appearance Modifier
|
*noun
*SINGULAR or PLURAL
| Creates a noun for the appearance, and whether it is singular or plural.

|-
| {{text anchor|APP_MOD_RATE}}
| Appearance Modifier
|
*Rate (integer)
*Scale (DAILY, YEARLY)
*min (growth)
*max (growth)
*start year
*start day
*end year
*end day
| Setting the growth rate of the modifier. The last two tokens can be replaced by NO_END to have growth continue indefinitely.

|-
| {{text anchor|APPLY_CREATURE_VARIATION}}
| Caste
|
*creature variation ID
*(optional) any amount of arbitrary arguments
| Applies the specified [[creature variation token|creature variation]]. See [[Creature_variation_token#Arguments_and_conditional_tokens]] for how the subsequent arguments may be used.

|-
| {{text anchor|APPLY_CURRENT_CREATURE_VARIATION}}
| Special
|
| Applies the effects of all pending {{token|CV_ADD_TAG|c}} and {{token|CV_REMOVE_TAG|c}} tokens that have been defined in the current creature.

|-
| {{text anchor|AQUATIC}}
| Caste
|
| Enables the creature to breathe in water, but causes it to air-drown on dry land.

|-
| {{text anchor|ARENA_RESTRICTED}}
| Caste
|
| Causes the creature to be excluded from the [[object testing arena]]'s creature spawning list. Typically applied to spoileriffic creatures.

|-
| {{text anchor|ARTIFICIAL_HIVEABLE}}
| Creature
|
| Enables the creature to be kept in artificial [[hive]]s by [[beekeeper]]s.

|-
| {{text anchor|AT_PEACE_WITH_WILDLIFE}}
| Caste
|
| Prevents the creature from attacking or frightening creatures with the {{Token|NATURAL|c}} tag.

|-
| {{text anchor|ATTACK}}
| Caste
|
*token
*selection criteria (it's complicated)
| Defines the attack name, and the body part used. See [[#Attack Tokens|below]] for valid subtokens
'''Example:''' 
<code>[ATTACK:GORE:BODYPART:BY_CATEGORY:HORN]</code> 
''GORE'' = name of the attack 
''BODYPART:BY_CATEGORY:HORN'' = the horn is used to attack (presuming the creature has one)

|-
| {{text anchor|ATTACK_TRIGGER}}
| Caste
|
*population
*exported wealth
*created wealth
| Specifies when a [[megabeast]] or [[semi-megabeast]] will attack the fortress. The attacks will start occurring when all of the requirements are met. Setting a value to 0 disables the trigger.

|}

{{alphabetical TOC|style=margin: 1em auto;}}

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

|-
| {{text anchor|BABY}}
| Caste
|
*integer
| Age at which creature is considered a child, the default is zero. One can think of this as the duration of the baby stage.

|-
| {{text anchor|BABYNAME}}
| Caste
|
*singular
*plural
| Defines a new name for a creature in baby state at the caste level. For non-caste-specific baby names, see {{token|GENERAL_BABY_NAME|c}}.

|-
| {{text anchor|BEACH_FREQUENCY}}
| Caste
|
*integer
| Creature may be subject to [[beaching]], becoming stranded on [[Beach|shores]], where they will eventually air-drown. The number indicates the frequency of the occurrence. Presumably requires the creature to be {{token|AQUATIC|c}}. Used by [[orca]]s, [[sperm whale]]s and [[sea nettle jellyfish]] in the vanilla game.

|-
| {{text anchor|BENIGN}}
| Caste
|
| The creature is non-aggressive by default, and will never automatically be engaged by companions or soldiers, running away from any creatures that are not friendly to it, and will only defend itself if it becomes enraged. Can be thought of as the counterpoint of the {{token|LARGE_PREDATOR|c}} tag. When tamed, animals with this tag will be useless for fortress defense.

This and {{token|TRADE_CAPACITY|c}} are required for {{token|PACK_ANIMAL|c}} to function properly, if an animal contains the aforementioned requirements without this tag: items loaded by the merchants will be dropped upon departure.

|-
| {{text anchor|BIOME}}
| Creature
|
* [[biome token]]
| Select a [[biome]] the creature may appear in.

|-
| {{text anchor|BLOOD}}
| Caste
|
* <[[material token]]>
* <[[Material_definition_token#Material_States|material state]]>
| Specifies what the creature's blood is made of.

|-
| {{text anchor|BLOODSUCKER}}
| Caste
|
| Causes [[vampire]]-like behaviour; the creature will suck the [[Creature_token#BLOOD|blood]] of unconscious victims when its [[Syndrome#TIME_SINCE_SUCKED_BLOOD|thirst for blood]] grows sufficiently large. When controlling the creature in adventure mode, this can be done at will. Seems to be required to make the creature denouncable (in-world) as a creature of the night.

|-
| {{text anchor|BODY}}
| Caste
|
*body parts
| Draws body parts from OBJECT:BODY files (such as body_default.txt)
'''Example:''' 
[BODY:BODY_WITH_HEAD_FLAG:HEART:GUTS:BRAIN:MOUTH] 
This is the body from a [[purring maggot]]. It creates a body with head, a heart, some guts, a brain, and a mouth. That's all a maggot needs.

The body parts need to be listed in an order such that any parent part appears before its connected children. For example [BODY:HEART:BODY_WITH_HEAD_FLAG] produces a "Body Token Recognized But Could Not Connect: HEART" error because HEART can't find any UPPERBODY(s) to connect to. Switching the order to [BODY:BODY_WITH_HEAD_FLAG:HEART] fixes the problem because now the UPPERBODY is created before the HEART tries to connect to it.

'''If the body is left undefined, the creature (or caste) will be tagged as [DOES_NOT_EXIST].''' {{verify}}

|-
| {{text anchor|BODY_APPEARANCE_MODIFIER}}
| Caste
|
*ATTRIBUTE
*lowest
*lower
*low
*median
*high
*higher
*highest
| These body modifiers give individual creatures different characteristics. In the case of HEIGHT, BROADNESS and LENGTH, the modifier is also a percentage change to the BODY_SIZE of the individual creature. The seven numbers afterward give a distribution of ranges. Each interval has an equal chance of occurring.
'''Example:''' 
[BODY_APPEARANCE_MODIFIER:HEIGHT:90:95:98:100:102:105:110] 
''HEIGHT'' : marks the height to be changed 
''90:95:98:100:102:105:110'' : sets the range from the shortest (90% of the average height) to the tallest (110% of the average height) creature variation.

|-
| {{text anchor|BODY_DETAIL_PLAN}}
| Caste
|
*PlanName
*Arguments
| Loads a plan from 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:''' 
[BODY_DETAIL_PLAN:VERTEBRATE_TISSUE_LAYERS:SKIN:FAT:MUSCLE:BONE:CARTILAGE] 
This creates the detailed body of a [[fox]], the skin, fat, muscle, bones and cartilage out of the vertebrate tissues. 
A [[Purring maggot|maggot]] would only need: 
''[BODY_DETAIL_PLAN:EXOSKELETON_TISSUE_LAYERS:SKIN:FAT:MUSCLE]''

|-
| {{text anchor|BODY_SIZE}}
| Caste
|
*years
*days
*size
| Sets size at a given age. Size is in cubic centimeters, and for normal body materials, is roughly equal to the creature's average weight in grams.
'''Example:''' 
[BODY_SIZE:0:0:10000] 
[BODY_SIZE:1:168:50000] 
[BODY_SIZE:12:0:220000] 
This describes the size of a [[minotaur]]. Its birth size would be 10,000 cm3 (~10 kg). At 1 year and 168 days old it would be 50,000 cm3 (~50 kg). And as an adult (at 12 years old) it would be 220,000 cm3 and weigh roughly 220 kg.

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

|-
| {{text anchor|BONECARN}}
| Caste
|
| Creature eats bones. Implies {{token|CARNIVORE|c}}. [[Adventurer mode|Adventurers]] with this token are currently unable to eat bones.{{Bug|11069}}

|-
| {{text anchor|BP_ADD_TYPE}}
| Caste
|
| Adds a type to a body part - used with {{token|SET_BP_GROUP|c}}. In vanilla DF, this is used for adding the type '[[Body token#GELDABLE|GELDABLE]]' to the lower body of certain [[cat|creatures]].

|-
| {{text anchor|BP_APPEARANCE_MODIFIER}}
| Caste
|
*QUALITY
*lowest
*lower
*low
*median
*high
*higher
*highest
| Sets up the breadth of possibilities for appearance qualities for a selected BP group. EG. Eyes (CLOSE_SET, DEEP_SET, ROUND_VS_NARROW, LARGE_IRIS),Lips (THICKNESS), Nose (BROADNESS, LENGTH, UPTURNED, CONVEX), Ear (SPLAYED_OUT, HANGING_LOBES, BROADNESS, HEIGHT), Tooth (GAPS), Skull (HIGH_CHEEKBONES, BROAD_CHIN, JUTTING CHIN, SQUARE_CHIN), Neck (DEEP_VOICE, RASPY_VOICE), Head (BROADNESS, HEIGHT)

|-
| {{text anchor|BP_REMOVE_TYPE}}
| Caste
|
| Removes a type from a body part. Used with {{token|SET_BP_GROUP|c}}.

|-
| {{text anchor|BUILDINGDESTROYER}}
| Caste
|
*1 or 2
| Allows a creature to destroy furniture and buildings. Value [1] targets mostly doors, hatches, furniture and the like. Value [2] targets anything not made with the {{k|b}} + {{k|C}} commands.
|}

{{alphabetical TOC|style=margin: 1em auto;}}

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

|-
| {{text anchor|CAN_DO_INTERACTION}}
| Caste
|
*interaction token
| The creature can perform an interaction. See [[interaction token]].

|-
| {{text anchor|CAN_LEARN}}
| Caste
|
| The creature gains [[skill]]s and can have [[labor|professions]]. If a member of a civilization (even a pet) has this token, it'll need to eat, drink and sleep. Note that this token makes the creature unable to be eaten 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. A creature with at least this token or the {{token|CAN_SPEAK|c}} token will be able to have [[Personality value|values]] and [[Personality goal|goals]].

|-
| {{text anchor|CAN_SPEAK}}
| Caste
|
| Can [[talking|talk]]. Note that this is not necessary for a creature to gain social skills but to make friends in fortress mode. A creature with at least this token or the {{token|CAN_LEARN|c}} token will be able to have [[Personality value|values]] and [[Personality goal|goals]].

|-
| {{text anchor|CANNOT_CLIMB}}
| Caste
|
| Creature cannot [[climber|climb]], even if it has free grasp parts.

|-
| {{text anchor|CANNOT_JUMP}}
| Caste
|
| Creature cannot [[jump]].

|-
| {{text anchor|CANNOT_UNDEAD}}
| Caste
|
| Acts like {{token|NOT_LIVING|c}}, except that {{token|OPPOSED_TO_LIFE|c}} creatures will attack them.

|-
| {{text anchor|CANOPENDOORS}}
| Caste
|
| Defunct, as doors cannot be set as tightly closed anymore.

|-
| {{text anchor|CARNIVORE}}
| Caste
|
| Creature ''only'' eats [[meat]]. If the creature goes on rampages in worldgen, it will often devour the people/animals it kills.

|-
| {{text anchor|CASTE}}
| Creature
|
*name
| Defines a [[caste]].

|-
| {{text anchor|CASTE_ALTTILE}}
| Caste
|
*tile number or "letter"
| Caste-specific {{token|ALTTILE|c}}. Requires {{token|CASTE_TILE|c}}.

|-
| {{text anchor|CASTE_COLOR}}
| Caste
|
*fg
*bg
*brightness
| Caste-specific {{token|COLOR|c}}.

|-
| {{text anchor|CASTE_GLOWCOLOR}}
| Caste
|
*fg
*bg
*brightness
| Caste-specific {{token|GLOWCOLOR|c}}.

|-
| {{text anchor|CASTE_GLOWTILE}}
| Caste
|
*tile value or "letter"
| Caste-specific {{token|GLOWTILE|c}}.

|-
| {{text anchor|CASTE_NAME}}
| Caste
|
*singular
*plural
*adjective
| While {{token|NAME|c}} describes the name of the species, {{token|CASTE_NAME|c}} names individuals of the species. Unlike other caste-specific descriptions, this token is required, even for creatures without separate castes. If left undefined, the creature will not show up in the [[arena]] and members of the species will be labeled as "nothing".

|-
| {{text anchor|CASTE_PROFESSION_NAME}}
| Caste
|
*[[Unit type token]] (Profession)
*singular
*plural
| Caste-specific {{token|PROFESSION_NAME|c}}.

|-
| {{text anchor|CASTE_SOLDIER_ALTTILE}}
| Caste
|
*'character' or tile number
| Caste-specific {{token|SOLDIER_ALTTILE|c}}. Requires {{token|CASTE_SOLDIER_TILE|c}}.

|-
| {{text anchor|CASTE_SOLDIER_TILE}}
| Caste
|
*'character' or tile number
| Caste-specific {{token|CREATURE_SOLDIER_TILE|c}}.

|-
| {{text anchor|CASTE_TILE}}
| Caste
|
* tile number or "letter"
| Caste-specific {{token|CREATURE_TILE|c}}.

|-
| {{text anchor|CAVE_ADAPT}}
| Caste
|
| Causes [[cave adaptation]].
Allows for creature's race to be involved in jokes that end in "And the [race] saw the sun and vomited on the spot!"

|-
| {{text anchor|CDI}}
| Caste
|
*Varies
| Specifies interaction details following a {{token|CAN_DO_INTERACTION|c}} token. See [[interaction token]].

|-
| {{text anchor|CHANGE_BODY_SIZE_PERC}}
| Caste
|
*integer
| Multiplies body size by a factor of (integer)%. 50 halves size, 200 doubles.

|-
| {{text anchor|CHANGE_FREQUENCY_PERC}}
| Creature
|
*integer
| Multiplies frequency by a factor of (integer)%.

|-
| {{text anchor|CHILD}}
| Caste
|
*integer
| Age at which creature is considered an adult - one can think of this as the duration of the [[children|child]] stage. Allows the creature's offspring to be rendered fully tame if [[animal trainer|trained]] during their childhood.

|-
| {{text anchor|CHILDNAME}}
| Caste
|
*singular
*plural
| Defines a new name for a creature in the child state at the caste level. For non-caste-specific child names, see {{token|GENERAL_CHILD_NAME|c}}.

|-
| {{text anchor|CLUSTER_NUMBER}}
| Creature
|
*min
*max
| The minimum/maximum numbers of how many creatures per spawned cluster. Vermin fish with this token in combination with temperate ocean and river biome tokens [http://www.bay12forums.com/smf/index.php?topic=51864.msg1122319#msg1122319 will perform seasonal migrations]. Defaults to 1:1 if not specified.

|-
| {{text anchor|CLUTCH_SIZE}}
| Caste
|
*min
*max
|Number of [[egg]]s laid in one sitting.

|-
| {{text anchor|COLONY_EXTERNAL}}
| Caste
|
| Caste hovers around colony.

|-
| {{text anchor|COLOR}}
| Creature
|
*foreground
*background
*brightness
| Color of the creature's tile. (See [[Color]] for usage.)

|-
| {{text anchor|COMMON_DOMESTIC}}
| Caste
|
| When combined with any of {{token|PET|c}}, {{token|PACK_ANIMAL|c}}, {{token|WAGON_PULLER|c}} and/or {{token|MOUNT|c}}, the creature is guaranteed to be domesticated by any [[civilization]] with {{token|COMMON_DOMESTIC_PET|e}}, {{token|COMMON_DOMESTIC_PACK|e}}, {{token|COMMON_DOMESTIC_PULL|e}} and/or {{token|COMMON_DOMESTIC_MOUNT|e}} respectively. Such civilizations will always have access to the creature, even in the absence of wild populations. This token is invalid on {{token|FANCIFUL|c}} creatures.

|-
| {{text anchor|CONVERTED_SPOUSE}}
| Caste
|
| Creatures of this caste's species with the {{token|SPOUSE_CONVERTER|c}} and {{token|NIGHT_CREATURE_HUNTER|c}} tokens will kidnap {{token|SPOUSE_CONVERSION_TARGET|c}}s of an appropriate sex and convert them into castes with CONVERTED_SPOUSE.

|-
| {{text anchor|COOKABLE_LIVE}}
| Caste
|
| Set this to allow the creature to be cooked in meals without first being butchered/cleaned. Used by some water-dwelling vermin such as [[mussel]]s, [[nautilus]]es and [[oyster]]s.

|-
| {{text anchor|CRAZED}}
| Caste
|
| Creature is '[[insanity|berserk]]' and will attack all other creatures, except members of its own species that '''also''' have the CRAZED tag. It will show {{DFtext|Berserk|4:1}} in the [[unit list]]. Berserk creatures go on rampages during [[world generation|worldgen]] much more frequently than non-berserk ones.

|-
| {{text anchor|COPY_TAGS_FROM}}
| Special
|
*creature ID
| Copies another specified creature. This will override any definitions made before it; essentially, it makes this creature identical to the other one, which can then be modified. Often used in combination with {{token|APPLY_CREATURE_VARIATION|c}} to import standard variations from a file. The vanilla [[giant animal]]s and [[animal person|animal people]]s are examples of this token combination.

|-
| {{text anchor|CREATURE}}
| Creature
|
*creature ID
| A unique, arbitrary identifier that begins the definition of each new creature, and is used to reference the creature in other tokens and raws.

|-
| {{text anchor|CREATURE_CLASS}}
| Caste
|
*classname
| An arbitrary creature classification. Can be set to anything, but the only vanilla uses are GENERAL_POISON (used in syndromes), EDIBLE_GROUND_BUG (used as targets for {{token|GOBBLE_VERMIN_CLASS|c}}), MAMMAL, and POISONOUS (both used for kobold pet eligibility). A single creature can have multiple classes.

The full list of tokens that use creature classes is:

* Creature tokens: {{token|GOBBLE_VERMIN_CLASS|c}}, {{token|GOBBLE_VERMIN_CLASS|c}}
* Interaction tokens: {{token|IT_AFFECTED_CLASS|in}}, {{token|IT_IMMUNE_CLASS|in}}
* Animal definition (Entity) tokens: {{token|ANIMAL_CLASS|e}}, {{token|ANIMAL_FORBIDDEN_CLASS|e}}
* Position (Entity) token: {{token|ALLOWED_CLASS|po}}
* Syndrome tokens: {{token|SYN_AFFECTED_CLASS|sy}}, {{token|SYN_IMMUNE_CLASS|sy}}, {{token|CE_SENSE_CREATURE_CLASS|sy}}
|-
| {{text anchor|CREATURE_SOLDIER_TILE}}
| Creature
|
*'character' or tile number
| Creatures active in their civilization's [[military]] will use this tile instead.

|-
| {{text anchor|CREATURE_TILE}}
| Creature
|
*'character' or tile number
| The symbol of the creature in ASCII mode.

|-
| {{text anchor|CREPUSCULAR}}
| Caste
|
| When set, the creature will appear at dawn (between 4:30 AM and 6:00 AM) and in the evening (between 8:00 PM and 10:05 PM) in [[Adventurer mode]].

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

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

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

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

|-
| {{text anchor|CV_REMOVE_TAG}}
| Special
|
*TAG NAME
| Removes a tag. Used in conjunction with creature variation templates.
|}

{{alphabetical TOC|style=margin: 1em auto;}}

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

|-
| {{text anchor|DEMON}}
| Caste
|
| Found on generated [[demon]]s. Marks the caste to be used in the initial wave after breaking into the [[underworld]], and by the demon civilizations created during world-gen breachings{{verify}}.

|-
| {{text anchor|DESCRIPTION}}
| Caste
|
*text
| A brief description of the creature type, as displayed when viewing the creature's description/[[Thoughts and preferences|thoughts & preferences]] screen.

|-
| {{text anchor|DIE_WHEN_VERMIN_BITE}}
| Caste
|
| Causes the creature to die upon attacking. Used by [[honey bee]]s to simulate them dying after using their stingers.

|-
| {{text anchor|DIFFICULTY}}
| Caste
|
*integer
| Increases experience gain during adventure mode. Creatures with a difficulty of 11 or higher are not assigned for quests in adventure mode.

|-
| {{text anchor|DIURNAL}}
| Caste
|
| When set, the creature will only appear during the day (between 6:00 AM and 8:00 PM) in [[Adventurer mode]].

|-
| {{text anchor|DIVE_HUNTS_VERMIN}}
| Caste
|
| The creature hunts vermin by diving from the air. On tame creatures, it has the same effect as {{token|HUNTS_VERMIN|c}}. Found on [[peregrine falcon]]s.

|-
| {{text anchor|DOES_NOT_EXIST}}
| Creature
|
| Adding this token to a creature prevents it from appearing in generated worlds (unless it's marked as [[Entity_token#ANIMAL_ALWAYS_PRESENT|always present]] for a particular civilisation). For example, adding it to [[dog]]s will lead to worlds being generated without dogs in them. Also removes the creature from the [[object testing arena]]'s spawn list. If combined with {{token|FANCIFUL|c}}, artistic depictions of the creature will occur regardless. Used by [[centaur]]s, [[chimera]]s and [[griffon]]s in the vanilla game.

Note: a creature tagged as DOES_NOT_EXIST can still be [[Interaction_token#I_EFFECT|summoned]] successfully, as long as it has a body defined in its raws [http://www.bay12forums.com/smf/index.php?topic=165213.msg8086938#msg8086938], or, another creature can[[Syndrome#CE_BODY_TRANSFORMATION|transform]] into it.
|}

{{alphabetical TOC|style=margin: 1em auto;}}

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

|-
| {{text anchor|EBO_ITEM}}
| Caste
|
*[[item token]]
*[[material token]] (ANY_HARD_STONE can be used for the material)
| Defines the item that the creature drops upon being [[butcher|butchered]]. Used with {{token|EXTRA_BUTCHER_OBJECT|c}}.

|-
| {{text anchor|EBO_SHAPE}}
| Caste
|
*gem shape
| The shape of the creature's extra [[butcher|butchering]] drop. Used with {{token|EXTRA_BUTCHER_OBJECT|c}}.

|-
| {{text anchor|EGG_MATERIAL}}
| Caste
|
* <[[material token]]>
* <[[Material_definition_token#Material_States|material state]]>
| Defines the material composition of [[egg]]s laid by the creature. [[creature_token#LAYS_EGGS|Egg-laying]] creatures in the default game define this 3 times, using LOCAL_CREATURE_MAT:EGGSHELL, LOCAL_CREATURE_MAT:EGG_WHITE, and then LOCAL_CREATURE_MAT:EGG_YOLK. Eggs will be made out of eggshell. Edibility is determined by tags on whites or yolk, but they otherwise do not exist.

|-
| {{text anchor|EGG_SIZE}}
| Caste
|
*size
| Determines the size of laid [[egg]]s. Doesn't affect hatching or cooking, but bigger eggs will be heavier, and may take longer to be hauled depending on the hauler's strength.

|-
| {{text anchor|EQUIPMENT_WAGON}}
| Creature
|
| Makes the creature appear as a large 3×3 [[wagon]] responsible for carrying trade goods, pulled by two {{token|WAGON_PULLER|c}} creatures and driven by a merchant.

|-
| {{text anchor|EQUIPS}}
| Caste
|
| Allows the creature to wear or wield items.

|-
| {{text anchor|EVIL}}
| Creature
|
| The creature is considered evil and will only show up in evil biomes. Civilizations with {{token|USE_EVIL_ANIMALS|e}} can domesticate them regardless of exotic status. Has no effect on cavern creatures except to restrict taming. A civilization with evil creatures can colonise evil areas.

|-
| {{text anchor|EXTRA_BUTCHER_OBJECT}}
| Caste
|
* [[Body token#CATEGORY|BY_CATEGORY]] or [[Body token#CONTYPE|BY_TYPE]] or [[Body token#BP|BY_TOKEN]]
* TYPE, CATEGORY, or TOKEN
| The creature drops an additional object when [[butcher|butchered]], as defined by {{token|EBO_ITEM|c}} and {{token|EBO_SHAPE|c}}. Used for [[gizzard stone]]s in default creatures. For some materials, needs to be defined after caste definitions with SELECT_CASTE:ALL{{Bug|6355}}

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

|-
| {{text anchor|EXTRAVISION}}
| Caste
|
| The creature can see regardless of whether it has working eyes and has full 360 degree vision, making it impossible to strike the creature from a blind spot in combat. Invisible creatures will also be seen, namely [[intelligent undead]] using a "vanish" power.
|}

{{alphabetical TOC|style=margin: 1em auto;}}

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

|-
| {{text anchor|FANCIFUL}}
| Creature
|
| The creature is a thing of legend and known to all civilizations. Its materials cannot be requested or preferred. The tag also adds some art value modifiers. Used by a [[Fanciful|number of creatures]]. Conflicts with {{token|COMMON_DOMESTIC|c}}.

|-
| {{text anchor|FEATURE_ATTACK_GROUP}}
| Caste
|
| Found on [[Animal people#Subterranean animal people|subterranean animal-man]] tribals. Currently defunct. In previous versions{{verify}}, it caused these creatures to crawl out of chasms and underground rivers.

|-
| {{text anchor|FEATURE_BEAST}}
| Caste
|
| Found on [[forgotten beast]]s. Presumably makes it act as such, initiating underground attacks on fortresses, or leads to the pop-up message upon encountering one{{verify}}. Hides the creature from displaying in a world_sites_and_pops file. Does not create historical figures like generated forgotten beasts do.

Requires specifying a {{token|BIOME|c}} in which the creature will live, and both surface and subterranean biomes are allowed. Does not stack with {{token|LARGE_ROAMING|c}} and if both are used the creature will not spawn. Appears to be incompatible with {{token|DEMON|c}} even if used in separate castes.

|-
| {{text anchor|FEMALE}}
| Caste
|
| Makes the creature biologically female, enabling her to [[Breeding|bear young]]. Usually specified inside a caste.

|-
| {{text anchor|FIREIMMUNE}}
| Caste
|
| Makes the creature immune to [[Interaction_token#FIREBALL|FIREBALL]] and [[Interaction_token#FIREJET|FIREJET]] attacks, and allows it to path through high temperature zones, like lava or fires. Does not, by itself, make the creature immune to the damaging effects of burning in [[fire]], and does not prevent general heat damage or melting on its own (this would require adjustments to be made to the creature's body [[Material_definition_token|materials]] - see the [[Dragon/raw|dragon raws]] for an example).

|-
| {{text anchor|FIREIMMUNE_SUPER}}
| Caste
|
| Like {{token|FIREIMMUNE|c}}, but also renders the creature immune to [[Interaction_token#DRAGONFIRE|DRAGONFIRE]] attacks.

|-
| {{text anchor|FISHITEM}}
| Caste
|
| The creature's corpse is a single [[Item_token#FISH_RAW|FISH_RAW]] food item that needs to be cleaned (into a [[Item_token#FISH|FISH]] item) at a [[fishery]] to become edible. Before being cleaned the item is referred to as "raw". The food item is categorized under "fish" on the food and stocks screens, and when uncleaned it is sorted under "raw fish" in the stocks (but does not show up on the food screen).
Without this or {{token|COOKABLE_LIVE|c}}, [[fishing|fished]] vermin will turn into food the same way as non-vermin creatures, resulting in multiple units of food (meat, brain, lungs, eyes, spleen etc.) from a single fished vermin. These units of food are categorized as meat by the game.

|-
| {{text anchor|FIXED_TEMP}}
| Caste
|
*temperature
| The creature's body is constantly at this temperature, heating up or cooling the surrounding area. Alters the temperature of the creature's inventory and all adjacent tiles, [[Temperature|with all the effects that this implies]] - may trigger wildfires at high enough values. Also makes the creature immune to extreme heat or cold, as long as the temperature set is not harmful to the materials that the creature is made from. Corpses and body parts of creatures with a fixed temperature maintain their temperature even after death.

Note that temperatures of 12000 and higher may cause [[path|pathfinding]] issues in fortress mode.

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

|-
| {{text anchor|FLIER}}
| Caste
|
| Allows a creature to fly, independent of it having wings or not. Fortress Mode pathfinding only partially incorporates flying - flying creatures need a land path to exist between them and an area in order to access it, but as long as one such path exists, they do not need to use it, instead being able to fly over intervening obstacles. Winged creatures with this token can lose their ability to fly if their wings are crippled or severed. Winged creatures without this token will be unable to fly. (A 'wing' in this context refers to any body part with its own [[Body_token#FLIER|FLIER]] token).

|-
| {{text anchor|FREQUENCY}}
| Creature
|
*number, max 100
| Determines the chances of a creature appearing within its environment, with higher values resulting in more frequent appearance. Also affects the chance of a creature being brought in a caravan for trading.
This value is used multiply to determine the rarity of animal populations. A creature with [FREQUENCY:50] will appear in 50% of valid biomes, and be present in 50% of the area within those biomes.
When a [[Creature token#CLUSTER_NUMBER|cluster]] spawns, the game effectively considers all creatures that can possibly appear and uses the FREQUENCY value as a ''weight'' - for example, if there are three creatures with frequencies 10/25/50, the creature with [FREQUENCY:50] will appear approximately 58.8% of the time. Defaults to 50 if not specified. Not to be confused with {{token|POP_RATIO|c}}.
|}

{{alphabetical TOC|style=margin: 1em auto;}}

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

|-
| {{text anchor|GAIT}}
| Caste
|
* <gait type>
* <gait name>
* <max [[Gait#Speed|speed]]>
* <build up time>
* <max turning [[Gait#Speed|speed]]>
* <start [[Gait#Speed|speed]]>
* <energy expenditure>
* <gait flag(s)>
| Defines a gait by which the creature can move. See [[Gait]] for more information. Specifically, you likely want to use one of the existing STANDARD_X_GAITS creature variations, as described in [[Gait#Gaits_and_Modding|this subsection]].

* <max speed> indicates the maximum [[Gait#Speed|speed]] achievable by a creature using this gait
* <start speed> indicates the creature's speed when it starts moving using this gait
* <build up time> indicates how long it will take for a creature using this gait to go from <start speed> to <max speed>. For example, a value of 10 means that it should be able to reach the maximum speed by moving 10 [[tile]]s in a straight line over even terrain.
* <max turning speed> indicates the maximum speed permissible when the creature suddenly changes its direction of motion. The creature's speed will be reduced to <max turning speed> if travelling at a higher speed than this before turning.
* <energy expenditure> indicates how energy-consuming the gait is. Higher values cause the creature to tire out faster. Persistent usage of a high-intensity gait will eventually lead to exhaustion and [[Status_icon#Non-flashing|collapse]].

'''NO_BUILD_UP''' can be specified instead of a <start speed> value to make the <max speed> instantly achievable upon initiating movement (this is equivalent to a <build up time> of 0). Note that <build up time> and <max turning speed> are both ignored if specified alongside this (as NO_BUILD_UP trumps <build up time> and preserves <max speed> whilst turning, and <max turning speed> cannot exceed <max speed>) so it is permissible to omit them so long as they are '''both''' omitted together.

It's possible to specify a <start speed> greater than the <max speed>; the moving creature will decelerate towards its <max speed> in this case.

'''valid gait types:'''
*'''WALK''' 
Used for moving normally over ground tiles.

*'''CRAWL''' 
Used for moving over ground tiles whilst [[Status_icon#Non-flashing|prone]].

*'''SWIM''' 
Used for moving through tiles containing [[water]] or [[magma]] at a [[Water#Depth|depth]] of at least 4/7.

*'''FLY''' 
Used for moving through [[open space]].

*'''CLIMB''' 
Used for moving whilst [[Climber|climbing]].

'''valid gait flags:'''
* '''AGILITY''' 
Speeds/slows movement depending on the creature's [[Attribute#Agility|Agility]] stat.

* '''STRENGTH''' 
Speeds/slows movement depending on the creature's [[Attribute#Strength|Strength]] stat.

* '''LAYERS_SLOW''' 
Makes [[Tissue_definition_token#THICKENS_ON_ENERGY_STORAGE|THICKENS_ON_ENERGY_STORAGE]] and [[Tissue_definition_token#THICKENS_ON_STRENGTH|THICKENS_ON_STRENGTH]] tissue layers slow movement depending on how thick they are. Adding the STRENGTH gait flag counteracts the impact of the latter layer.

* '''STEALTH_SLOWS:'''<percentage> 
Slows movement by the specified percentage when the creature is [[Ambusher|sneaking]].

|-
| {{text anchor|GENERAL_BABY_NAME}}
| Creature
|
*singular
*plural
| Like {{token|BABYNAME|c}}, but applied regardless of caste.

|-
| {{text anchor|GENERAL_CHILD_NAME}}
| Creature
|
*singular
*plural
| Like {{token|CHILDNAME|c}}, but applied regardless of caste.

|-
| {{text anchor|GENERAL_MATERIAL_FORCE_MULTIPLIER}}
| Caste
|
*value A
*value B
| Has the same function as {{token|MATERIAL_FORCE_MULTIPLIER|c}}, but applies to all attacks instead of just those involving a specific material. Appears to be overridden by MATERIAL_FORCE_MULTIPLIER ([[werebeast]]s, for example, use both tokens to provide resistance to all materials, with one exception to which they are especially vulnerable).

|-
| {{text anchor|GENERATED}}
| Creature
|
| Found on procedurally generated creatures like [[forgotten beast]]s, [[titan]]s, [[demon]]s, [[angel]]s, and [[night creature]]s. Cannot be specified in user-defined raws.

|-
| {{text anchor|GETS_INFECTIONS_FROM_ROT}}
| Caste
|
| Makes the creature get [[Health_care#Infection|infections]] from necrotic tissue.

|-
| {{text anchor|GETS_WOUND_INFECTIONS}}
| Caste
|
| Makes the creature's wounds become [[Health_care#Infection|infected]] if left untreated for too long.

|-
| {{text anchor|GLOWCOLOR}}
| Creature
|
*foreground
*background
*brightness
| The colour of the creature's {{token|GLOWTILE|c}}.

|-
| {{text anchor|GLOWTILE}}
| Creature
|
*ascii character
| If present, the being glows in the dark (generally used for Adventurer 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 {{token|CASTE_GLOWTILE|c}} instead.

|-
| {{text anchor|GNAWER}}
| Caste
|
*verb
| The creature can and will gnaw its way out of [[animal trap]]s and [[cage]]s using the specified verb, depending on the material from which it is made (normally wood).

|-
| {{text anchor|GOBBLE_VERMIN_CLASS}}
| Caste
|
*class
| The creature eats vermin of the specified class.

|-
| {{text anchor|GOBBLE_VERMIN_CREATURE}}
| Caste
|
*creature
*caste
| The creature eats a specified [[vermin]].

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

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

|-
| {{text anchor|GO_TO_TAG}}
| Special
|
| When using tags from an existing creature, inserts new tags ''before'' the specified tag.

|-
| {{text anchor|GOOD}}
| Creature
|
| Creature is considered good and will only show up in good biomes - [[unicorn]]s, for example. Civilizations with {{token|USE_GOOD_ANIMALS|e}} can domesticate them regardless of exotic status. Has no effect on cavern creatures except to restrict taming. A civilization that has good creatures can colonise good areas in world-gen.

|-
| {{text anchor|GRASSTRAMPLE}}
| Caste
|
*value
| The value determines how rapidly [[grass]] is trampled when a creature steps on it - a value of 0 causes the creature to never damage grass, while a value of 100 causes grass to be trampled as rapidly as possible. Defaults to 5.

|-
| {{text anchor|GRAVITATE_BODY_SIZE}}
| Caste
|
*target value
| Used in Creature Variants. This token changes the adult body size to the average of the old adult body size and the target value and scales all intermediate growth stages by the same factor.

|-
| {{text anchor|GRAZER}}
| Caste
|
*number
| The creature is a grazer - if tamed in fortress mode, it needs a pasture to survive. The higher the number, the less frequently it needs to eat in order to live. Not used since 0.40.12, replaced by {{token|STANDARD_GRAZER|c}} to fix {{bugl|4113}}.
|}

{{alphabetical TOC|style=margin: 1em auto;}}

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

|-
| {{text anchor|HABIT}}
| Caste
|
*type
*probability
| Defines certain behaviors for the creature. The habit types are:
*COLLECT_TROPHIES
*COOK_PEOPLE
*COOK_VERMIN
*GRIND_VERMIN
*COOK_BLOOD
*GRIND_BONE_MEAL
*EAT_BONE_PORRIDGE
*USE_ANY_MELEE_WEAPON
*GIANT_NEST
*COLLECT_WEALTH.
These require the creature to have a {{token|LAIR|c}} to work properly, and also don't seem to work on creatures who are not a {{token|SEMIMEGABEAST|c}}, {{token|MEGABEAST|c}}, or{{token|NIGHT_CREATURE_HUNTER|c}}.

|-
| {{text anchor|HABIT_NUM}}
| Caste
|
*number or TEST_ALL
| "If you set HABIT_NUM to a number, it should give you that exact number of habits according to the weights.".{{cite forum|60554/1719248}} All lists of HABITs are preceded by [HABIT_NUM:TEST_ALL]

|-
| {{text anchor|HAS_NERVES}}
| Caste
|
| The creature has nerves in its muscles. Cutting the muscle tissue can sever motor and sensory nerves.

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

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

|-
| {{text anchor|HOMEOTHERM}}
| Caste
|
*number or NONE
| Default 'NONE'. The creature's normal body [[temperature]]. Creature ceases maintaining temperature on death unlike fixed material temperatures. Provides minor protection from environmental temperature to the creature.

|-
| {{text anchor|HUNTS_VERMIN}}
| Caste
|
| Creature hunts and kills nearby [[vermin]], randomly walking between places with food laying on the ground or in stockpiles, to check for possible [VERMIN_EATER] vermin, but they'll kill any other vermin too. Do not include this creature token on an intelligent entity that you intend to play as in fortress mode because it will prevent them from feeding themselves.

|}

{{alphabetical TOC|style=margin: 1em auto;}}

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

|-
| {{text anchor|IMMOBILE}}
| Caste
|
| The creature cannot move. Found on [[sponge]]s. Will also stop a creature from breeding in fortress mode (MALE and FEMALE are affected, if one is IMMOBILE; no breeding will happen).

|-
| {{text anchor|IMMOBILE_LAND}}
| Caste
|
| The creature is immobile while on land. Only works on {{token|AQUATIC|c}} creatures which can't breathe on land.

|-
| {{text anchor|IMMOLATE}}
| Caste
|
| The creature radiates [[fire]]. It will ignite, and potentially completely destroy, items the creature is standing on. Also gives the vermin a high chance of escaping from [[animal trap]]s and [[cage]]s made of any flammable materials (specifically ones that could be ignited by magma).

|-
| {{text anchor|INTELLIGENT}}
| Caste
|
| Alias for {{token|CAN_SPEAK|c}} + {{token|CAN_LEARN|c}}.

|-
| {{text anchor|ITEMCORPSE}}
| Caste
|
* [[item token]]
* [[material token]]
| Determines if the creature leaves behind a non-standard corpse (i.e. wood, statue, bars, stone, pool of liquid, etc.). [[Ethics]] may prevent actually using the item in jobs or reactions.

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

{{alphabetical TOC|style=margin: 1em auto;}}

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

|-
| {{text anchor|LAIR}}
| Caste
|
*type
*probability
| Found on megabeasts, semimegabeasts, and night creatures. The creature will seek out sites of this type and take them as lairs. The lair types are:
*SIMPLE_BURROW
*SIMPLE_MOUND
*WILDERNESS_LOCATION
*SHRINE
*LABYRINTH

|-
| {{text anchor|LAIR_CHARACTERISTIC}}
| Caste
|
*characteristic
*probability
| Defines certain features of the creature's lair. The only valid characteristic is HAS_DOORS.

|-
| {{text anchor|LAIR_HUNTER}}
| Caste
|
| This creature will actively hunt adventurers in its lair.

|-
| {{text anchor|LAIR_HUNTER_SPEECH}}
| Caste
|
*speech file
| What this creature says while hunting adventurers in its lair.

|-
| {{text anchor|LARGE_PREDATOR}}
| Caste
|
| Will attack other creatures that are smaller than it. Tamed large predators will still attack wildlife. In [[fortress mode]], only one group of "large predators" (possibly two groups on "savage" maps) will appear on any given map. In [[adventurer mode]], large predators will try to ambush and attack you (and your party will attack them back). When tamed, large predators tend to be much more aggressive to enemies than non-large predators, making them a good choice for an animal army. They may go on rampages in worldgen, and adventurers may receive quests to kill them. Also, they can be mentioned in the intro paragraph when starting a fortress e.g. "ere the wolves get hungry."
A single biome supports 7 large predator species, picking randomly and rolling a d100 under its {{token|FREQUENCY|c}} to add it until all 7 slots are filled.

Incompatible with {{token|PACK_ANIMAL|c}} on a technicality, if included: hauled items are likely to be dropped upon entering the map (even if {{token|TRADE_CAPACITY|c}} is present) in contrast to when the merchants depart.

|-
| {{text anchor|LARGE_ROAMING}}
| Creature
|
| This is the core requisite tag allowing the creature to spawn as a wild animal in the appropriate biomes. Requires specifying a {{token|BIOME|c}} in which the creature will spawn. Does not require specifying a frequency, population number, or cluster number.

This tag stacks with {{token|MEGABEAST|c}}, {{token|SEMIMEGABEAST|c}}, or {{token|NIGHT_CREATURE_HUNTER|c}}; if used with one of these tags, the creature will spawn as both a boss and as a wild animal. This tag does not stack with {{token|FEATURE_BEAST|c}} and if both are used the creature will not spawn. This tag is unaffected by {{token|DEMON|c}}.

|-
| {{text anchor|LAYS_EGGS}}
| Caste
|
| Creature lays [[egg]]s instead of giving birth to live young.

|-
| {{text anchor|LAYS_UNUSUAL_EGGS}}
| Caste
|
* [[item token]]
* [[material token]]
| Creature lays the specified item instead of regular eggs.

|-
| {{text anchor|LIGAMENTS}}
| Caste
|
* [[material token]]
*healing rate
| The creature has ligaments in its {{token|CONNECTIVE_TISSUE_ANCHOR|td}} tissues (bone or chitin by default). Cutting the bone/chitin tissue severs the ligaments, disabling motor function if the target is a limb.

|-
| {{text anchor|LIGHT_GEN}}
| Caste
|
| A vermin featuring this tag will remain visible to an adventurer even at night.

Subterranean vermin which feature this token will flicker in unexposed and unrevealed cavern layers while playing in Fortress Mode.

|-
| {{text anchor|LIKES_FIGHTING}}
| Caste
|
| The creature will attack enemies rather than flee from them. This tag has the same effect on player-controlled creatures - including modded dwarves. Retired as of v0.40.14 in favor of {{token|LARGE_PREDATOR|c}}.

|-
| {{text anchor|LISP}}
| Caste
|
| Creature uses "sssssnake talk" (multiplies 'S' when talking - "My name isss Recisssiz."). Used by [[Serpent man|serpent men]] and [[Reptile man|reptile men]] in the vanilla game. C's with the same pronunciation (depending on the word) are not affected by this token.

|-
| {{text anchor|LITTERSIZE}}
| Caste
|
* minimum
* maximum
| Determines the number of offspring per one birth; default 1-3, not used in vanilla raws. See also {{token|MULTIPLE_LITTER_RARE|c}}.

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

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

|-
| {{text anchor|LOCKPICKER}}
| Caste
|
| Lets a creature open [[door]]s that are set to forbidden in fortress mode.

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

|-
| {{text anchor|LOW_LIGHT_VISION}}
| Caste
|
*number
| Determines how well a creature can see in the dark - higher is better. Dwarves have 10000, which amounts to perfect nightvision.
|}

{{alphabetical TOC|style=margin: 1em auto;}}

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

|-
| {{text anchor|MAGICAL}}
| Caste
|
| According to Toady One, this is completely interchangeable with {{token|AT_PEACE_WITH_WILDLIFE|c}} and might have been used in very early versions of the game by wandering wizards or the ent-type tree creatures that used to be animated by elves. [http://www.bay12forums.com/smf/index.php?topic=169696.msg8316954#msg8316954]

|-
| {{text anchor|MAGMA_VISION}}
| Caste
|
| The creature is able to see while submerged in [[magma]].

|-
| {{text anchor|MALE}}
| Caste
|
| Makes the creature biologically male. Usually declared inside a caste.

|-
| {{text anchor|MANNERISM|MANNERISM_*}}
| Caste
|
*occasionally body part
| Adds a possible mannerism to the creature's profile. See [[creature mannerism token]] for further info.

|-
| {{text anchor|MATERIAL}}
| Creature
|
*material id
| Begins defining a new local material. Follow this with standard material definition tokens to define the material.

|-
| {{text anchor|MATERIAL_FORCE_MULTIPLIER}}
| Caste
|
*[[Material token]]
*value A
*value B
| When struck with a weapon made of the specified material, the force exerted will be multiplied by A/B, thus making the creature more or less susceptible to this material. For example, if A is 2 and B is 1, the force exerted by the defined material will be doubled. If A is 1 and B is 2, it will be halved instead. See also {{token|GENERAL_MATERIAL_FORCE_MULTIPLIER|c}}, which can be used to make this sort of effect applicable to all materials.

|-
| {{text anchor|MATUTINAL}}
| Caste
|
| When set, the creature will only appear at dawn (between 4:30 AM and 6:00 AM) in [[Adventurer mode]].

|-
| {{text anchor|MAXAGE}}
| Caste
|
*min
*max
| Determines the creature's natural lifespan, using the specified minimum and maximum age values (in years). Each individual creature with this token is generated with a predetermined date (calculated down to the exact [[time|tick]]!) between these values, at which it is destined to die of old age, should it live long enough. Note that the probability of death at any given age does not increase as the creature gets older [http://i.imgur.com/A1A4aA9.png].
Creatures which lack this token are naturally immortal. The [[Syndrome#CE_ADD_TAG|NO_AGING]] syndrome tag will prevent death by old age from occurring. Also note that, among civilized creatures, castes which lack this token will refuse to marry others with it, and vice versa.

|-
| {{text anchor|MEANDERER}}
| Caste
|
| Makes the creature slowly stroll around, unless it's in combat or performing a job. If combined with {{token|CAN_LEARN|c}}, will severely impact their [[pathfinding]] and lead the creature to move extremely slowly when not performing any task. Problematically applies to animal people based on the animal and war trained animals{{bug|9588}}.

|-
| {{text anchor|MEGABEAST}}
| Caste
|
| A 'boss' creature. A small number of the creatures are created during worldgen, their histories and descendants (if any) will be tracked in worldgen (as opposed to simply 'spawning'), and they will occasionally go on rampages, potentially leading to worship if they attack the same place multiple times. Their presence and number will also influence age names. When appearing in fortress mode, they will have a pop-up message announcing their arrival. They will remain hostile to military even after being tamed.{{bug|10731}} See [[megabeast]] page for more details.

Requires specifying a {{token|BIOME|c}} in which the creature will live. Subterranean biomes appear to not be allowed. Does stack with {{token|LARGE_ROAMING|c}} and if both are used the creature will spawn as both historical bosses and as wild animals.

|-
| {{text anchor|MENT_ATT_CAP_PERC}}
| Caste
|
*[[Attribute|ATTRIBUTE]] Token
*Cap %
|Default is 200. This means you can increase your attribute to 200% of its starting value (or the average value + your starting value if that is higher).

|-
| {{text anchor|MENT_ATT_RANGE}}
| Caste
|
*[[Attribute|ATTRIBUTE]]
*lowest
*lower
*low
*median
*high
*higher
*highest
| Sets up a [[Attribute#Soul_attributes|mental attribute]]'s range of values (0-5000). All mental attribute ranges default to 200:800:900:1000:1100:1300:2000.

|-
| {{text anchor|MENT_ATT_RATES}}
| Caste
|
*[[Attribute|ATTRIBUTE]] Token
*cost to improve
*unused counter rate
*rust counter rate
*demotion counter rate
| [[Attribute#Soul_attributes|Mental attribute]] gain/decay rates. Lower numbers in the last three slots make decay occur faster. Defaults are 500:4:5:4.

|-
| {{text anchor|MILKABLE}}
| Caste
|
* [[material token]]
* frequency
| Allows the creature to be [[milk]]ed in the [[farmer's workshop]]. The frequency is the amount of [[time|ticks]] the creature needs to "recharge" (i.e. how much time needs to pass before it can be milked again). Does not work on [[#CAN_LEARN|sentient]] creatures, regardless of [[ethics]].

|-
| {{text anchor|MISCHIEVIOUS}}
| Caste
|
| Alias for {{token|MISCHIEVOUS|c}}.

|-
| {{text anchor|MISCHIEVOUS}}
| Caste
|
| The creature spawns [[stealth]]ed and will attempt to path into the fortress, pulling any [[lever]]s it comes across. It will be invisible on the map and [[unit list]] until spotted by a citizen, at which point the game will pause and recenter on the creature. Used by [[gremlin]]s in the vanilla game. "They go on little missions to mess with various fortress buildings, not just levers."

|-
| {{text anchor|MODVALUE}}
| Caste
|
| Seemingly no longer used.

|-
| {{text anchor|MOUNT}}
| Caste
|
| Creature may be used as a [[mount]]. No use for the player in fortress mode, but enemy sieging forces may arrive with cavalry. Mounts are usable in adventure mode.

|-
| {{text anchor|MOUNT_EXOTIC}}
| Caste
|
| Creature may be used as a [[mount]], but civilizations cannot domesticate it in worldgen without certain exceptions.

|-
| {{text anchor|MULTIPART_FULL_VISION}}
| Caste
|
| Allows the creature to have all-around vision, as long as it has multiple heads that can see.

|-
| {{text anchor|MULTIPLE_LITTER_RARE}}
| Caste
|
| Makes the species usually produce a single offspring per birth, with a 1/500 chance of using the {{token|LITTERSIZE|c}} as usual. Requires {{token|FEMALE|c}}.

|-
| {{text anchor|MUNDANE}}
| Creature
|
| Marks if the creature is an actual real-life creature. Only used for age-names at present.
|}

{{alphabetical TOC|style=margin: 1em auto;}}

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

|-
| {{text anchor|NAME}}
| Creature
|
*singular
*plural
*adjective
| The generic name for any creature of this type - will be used for referring to the species in the abstract, such as the default material prefix. For labeling individual creatures, {{token|CASTE_NAME|c}} is necessary. If left undefined, the creature will be labeled as "nothing" by the game.

Some examples of adjective use:
* "super''dwarven'' strength"
* "the ''dwarven'' hillocks of X"
* Deity species as in "''feline'' deity"
* Megabeast attacks in worldgen. One with multiple dragons being a "''draconic'' rampage"

|-
| {{text anchor|NATURAL}}
| Caste
|
| Animal is considered to be natural. NATURAL animals will not engage creatures tagged with {{token|AT_PEACE_WITH_WILDLIFE|c}} in combat unless they are members of a hostile entity and vice-versa.

|-
| {{text anchor|NATURAL_ANIMAL}}
| Caste
|
| Alias of {{token|NATURAL|c}}.

|-
| {{text anchor|NATURAL_SKILL}}
| Caste
|
*[[Skill_token|Skill token]]
*value
| The creature possesses the specified [[skill]] at this level inherently - that is, it begins with the skill at this level, and the skill may never rust below that. A value of 15 is legendary.

|-
| {{text anchor|NIGHT_CREATURE}}
| Caste
|
| Creatures with this token can appear as [[experiment|experiments]]. Causes the creature to count as {{token|NOT_LIVING|c}}. Killing a creature featuring this token provides one point of "hero" reputation. Adds the creature's description as part of the initial summary of their historical figure in legends mode. People will react to creatures with this token as a night creature (natch). In adventure mode, ambushes involving these units will say "Night creature!" instead of "Ambush!"

Prevents creature behavior enabled by {{token|LARGE_PREDATOR|c}}

Prevents the AI from using ANIMATE interactions, unless the newly-animated{{token|OPPOSED_TO_LIFE|c}}undead will not attack them. The check for this is specifically whether the unit is:
*a ghost
*an animated unit
*a unit with the {{token|NO_AGING|c}} token added via {{token|CE_ADD_TAG|c}}. (This allows for the default exclusion of elves and goblins, unless raised as intelligent undead.)

''This token should not be confused with other NIGHT_CREATURE_X tokens.''
''This token is not well understood at the present time.''

|-
| {{text anchor|NIGHT_CREATURE_BOGEYMAN}}
| Caste
|
| Creatures with this token can appear in [[bogeyman|bogeyman ambushes]] in [[adventure mode]], where they adopt classical bogeyman traits such as stalking the adventurer and vaporising when dawn breaks. Such traits do not manifest if the creature is encountered outside of a bogeyman ambush (for instance, as a megabeast or a civilised being). In addition, their corpses and severed body parts turn into [[smoke]] after a short while. Note that setting the "Number of Bogeyman Types" in [[advanced world generation]] to 0 will only remove randomly-generated bogeymen.

|-
| {{text anchor|NIGHT_CREATURE_EXPERIMENTER}}
| Caste
|
| Found on some [[necromancer]]s. Creatures with this tag may periodically "perform horrible experiments" offscreen, during which they can use creature-targeting interactions with an <code>[[Interaction_token#I_SOURCE|[I_SOURCE:EXPERIMENT]]]</code> tag on living creatures in their area. Worlds are generated with a list of procedurally-generated experiments, allowing necromancers to turn living people and animals into [[Infected_ghoul|ghouls]] and [[Experiment|other experimental creatures]], and these will automatically be available to all experimenters; it does not appear possible to prevent this. You can mod in your own custom experiment interactions, but these are used very infrequently due to the large number of generated experiments.

|-
| {{text anchor|NIGHT_CREATURE_HUNTER}}
| Caste
|
| Found on [[night troll]]s and [[werebeast]]s. Implies that the creature is a [[night creature]], and shows its description in [[legends mode]] entry. The creature is always hostile and will start [[no quarter]] combat with any nearby creatures, except for members of its own race. Note that this tag does not override the creature's normal behavior in [[fortress mode]] except for the aforementioned aggression, and doesn't prevent the creature from fleeing the battles it started. It also removes the creature's materials from stockpile settings list, making them be stored there regardless of settings.

Does stack with {{token|LARGE_ROAMING|c}} and if both are used the creature will spawn as both historical hunters and as wild animals; this requires specifying a {{token|BIOME|c}} in which the creature will live, and subterranean biomes are allowed.

This tag causes the usual behaviour of werebeasts in worldgen, that is, fleeing towns upon being cursed and conducting raids from a lair. If this tag is absent from a deity curse, the accursed will simply be driven out of towns in a similar manner to [[vampire]]s. When paired with SPOUSE_CONVERTER, a very small population of the creature will be created during worldgen (sometimes only a single individual will be created), and their histories will be tracked (that is, they will not spawn spontaneously later, they must either have children or convert other creatures to increase their numbers). The creature will settle in a lair and go on rampages during worldgen. It will actively attempt to seek out potential conversion targets to abduct, convert, and have children with (if possible).

|-
| {{text anchor|NIGHT_CREATURE_NIGHTMARE}}
| Caste
|
| Found on [[nightmare]]s. Corpses and severed body parts derived from creatures with this token turn into [[smoke]] after a short while.

|-
| {{text anchor|NO_AUTUMN}}
| Caste
|
| The creature caste does not appear in [[Calendar|autumn]].

|-
| {{text anchor|NO_CONNECTIONS_FOR_MOVEMENT}}
| Caste
|
| Creature doesn't require connected body parts to move{{verify}}; generally used on undead creatures with connections that have rotted away.

|-
| {{text anchor|NO_DIZZINESS}}
| Caste
|
| Creature cannot become [[Symptom#Dizziness|dizzy]].

|-
| {{text anchor|NO_DRINK}}
| Caste
|
| Creature does not need to drink.

|-
| {{text anchor|NO_EAT}}
| Caste
|
| Creature does not need to [[food|eat]].

|-
| {{text anchor|NO_FEVERS}}
| Caste
|
| Creature cannot suffer [[Symptom#Fever|fevers]].

|-
| {{text anchor|NO_GENDER}}
| Caste
|
| The creature is biologically sexless, making it unable to [[breeding|breed]].

|-
| {{text anchor|NO_PHYS_ATT_GAIN}}
| Caste
|
| The creature cannot raise any [[Attribute#Body_attributes|physical attributes]].

|-
| {{text anchor|NO_PHYS_ATT_RUST}}
| Caste
|
| The creature cannot lose any [[Attribute#Body_attributes|physical attributes]].

|-
| {{text anchor|NO_SLEEP}}
| Caste
|
| Creature does not need to sleep, but can still be rendered unconscious by other means.

|-
| {{text anchor|NO_SPRING}}
| Caste
|
| The creature caste does not appear in [[Calendar|spring]].

|-
| {{text anchor|NO_SUMMER}}
| Caste
|
| The creature caste does not appear in [[Calendar|summer]].

|-
| {{text anchor|NO_THOUGHT_CENTER_FOR_MOVEMENT}}
| Caste
|
| The bodyparts of this creature don't need to be connected to an organ with the {{token|THOUGHT|body}} tag in order to have motor function. Generally used on creatures that don't have brains. If a creature doesn't have a thought part and doesn't have this token, it will be unable to grasp or stand. Nautilus men experience this issue in vanilla.

|-
| {{text anchor|NO_UNIT_TYPE_COLOR}}
| Caste
|
| Prevents creature from selecting its color based on its profession (e.g. Miner, Hunter, Wrestler).

|-
| {{text anchor|NO_VEGETATION_PERTURB}}
| Caste{{Verify}}
|
| Likely prevents the creature from leaving broken vegetation tracks.{{Verify}}

|-
| {{text anchor|NO_WINTER}}
| Caste
|
| The creature caste does not appear in [[Calendar|winter]].

|-
| {{text anchor|NOBONES}}
| Caste
|
| Creature has no bones.

|-
| {{text anchor|NOBREATHE}}
| Caste
|
| Creature doesn't need to breathe or have {{token|BREATHE|body}}parts in its body, nor can it drown or be strangled. Creatures living in magma must have this tag, otherwise they will drown.

|-
| {{text anchor|NOCTURNAL}}
| Caste
|
| When set, the creature will only appear at night (after 10:05 PM and before 4:30 AM) in [[Adventurer mode]].

|-
| {{text anchor|NOEMOTION}}
| Caste
|
| Creature has no emotions, thus; it is immune to the effects of [[stress]] and unable to rage, and its [[need]]s cannot be fulfilled in any way. Used on [[undead]] in the vanilla game.

|-
| {{text anchor|NOEXERT}}
| Caste
|
| Creature can't become tired or over-exerted from taking too many combat actions, or moving at full speed for extended periods of time.

|-
| {{text anchor|NOFEAR}}
| Caste
|
| Creature doesn't feel fear and will never flee from battle, and will be immune to [[ghost]]s' attempts to 'scare it to death'. Additionally, it causes [[bogeyman|bogeymen]] and [[nightmare]]s to become friendly towards the creature.

|-
| {{text anchor|NOMEAT}}
| Caste
|
| Creature will not be hunted or fed to wild beasts.

|-
| {{text anchor|NONAUSEA}}
| Caste
|
| Creature isn't nauseated by gut hits and cannot vomit.

|-
| {{text anchor|NOPAIN}}
| Caste
|
| Creature doesn't feel pain.

|-
| {{text anchor|NOSKIN}}
| Caste
|
| Creature will not drop a hide when [[butcher|butchered]].

|-
| {{text anchor|NOSKULL}}
| Caste
|
| Creature will not drop a skull on butchering, rot, or decay of severed head.

|-
| {{text anchor|NOSMELLYROT}}
| Caste
|
| Does not produce [[miasma]] when rotting.

|-
| {{text anchor|NOSTUCKINS}}
| Caste
|
| Weapons can't get stuck in the creature.

|-
| {{text anchor|NOSTUN}}
| Caste
|
| Creature can't be stunned and knocked unconscious by pain or head injuries. Creatures with this tag never wake up from sleep in Fortress Mode. If this creature needs to sleep while playing, it will die.

|-
| {{text anchor|NOT_BUTCHERABLE}}
| Caste
|
| Corpses from this creature cannot be [[butcher|butchered]]. Does not prevent the creature from being slaughtered while alive, however.

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

|-
| {{text anchor|NOTHOUGHT}}
| Caste
|
| Creature doesn't require a {{token|THOUGHT|body}} body part to survive. Has the added effect of preventing speech, though directly controlling creatures that would otherwise be capable of speaking allows them to engage in conversation.
|}

{{alphabetical TOC|style=margin: 1em auto;}}

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

|-
| {{text anchor|ODOR_LEVEL}}
| Caste
|
*number
| How easy the creature is to [[smell]]. The higher the number, the easier the creature is to sniff out. Defaults to 50. Vanilla creatures have values from 0 (undetectable) to 90 (noticeable by humans and dwarves).

|-
| {{text anchor|ODOR_STRING}}
| Caste
|
*string
| What the creature [[smell]]s like. If no odor string is defined, the creature name (not the caste name) is used.

|-
| {{text anchor|OPPOSED_TO_LIFE}}
| Caste
|
| Is hostile to all creatures except undead and other non-living ones and will show {{DFtext|Opposed to life|0:1}} in the [[unit list]]. Used by [[undead]] in the vanilla game. Functions without the {{token|NOT_LIVING|c}} token, and seems to imply said token as well. Undead will not be hostile to otherwise-living creatures given this token. Living creatures given this token will attack living creatures that lack it, while ignoring other living creatures that also have this token.

|-
| {{text anchor|ORIENTATION}}
| Caste
|
*MALE/FEMALE
*disinterested chance
*casual chance
*strong chance
| Determines caste's likelihood of having sexual attraction to certain sexes. Values default to 75:20:5 for the same sex and 5:20:75 for the opposite sex. The first value indicates how likely to be entirely uninterested in the sex, the second decides if the creature will be able to become lovers with that sex, the third decides whether they will be able to marry in worldgen and post-worldgen world activities (which implies being able to become lovers). Marriage seems to be able to happen in fort mode play regardless, as long as they are lovers first.

|-
| {{text anchor|OUTSIDER_CONTROLLABLE}}
| Caste
|
| Lets you play as an [[Adventurer_mode_character_creation#Outsider|outsider]] of this species in adventure mode.

|}

{{alphabetical TOC|style=margin: 1em auto;}}

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

|-
| {{text anchor|PACK_ANIMAL}}
| Caste
|
| Allows the creature to be used as a pack animal. Used by [[trading|merchants]] without wagons and adventurers. Also prevents creature from dropping hauled items on its own -- do ''not'' use for player-controllable creatures! May lead to the creature being domesticated during worldgen, even if it doesn't have {{token|COMMON_DOMESTIC|c}}.

Creatures with this tag but without {{token|BENIGN|c}}, and/or with {{token|LARGE_PREDATOR|c}} leads to hauled items being dropped.

|-
| {{text anchor|PARALYZEIMMUNE}}
| Caste
|
| The creature is immune to all [[Syndrome#CE_PARALYSIS|paralyzing]] special attacks.

|-
| {{text anchor|PATTERNFLIER}}
| Caste
|
| Used to control the bat riders with paralyze-dart blowguns that flew through the 2D chasm. Doesn't do anything now.

|-
| {{text anchor|PCG_LAYERING}}
| Creature
|
*[[Procedural graphics layer|Layering type]]
| Adds a layer to the current {{token|PROCEDURAL_CREATURE_GRAPHICS|c}} definition.

|-
| {{text anchor|PEARL}}
| Caste
|
| Does nothing.

|-
| {{text anchor|PENETRATEPOWER}}
| Caste
|
*value
| Controls the ability of [[vermin]] to find a way into containers when they are eating food from your stockpiles.

Objects made of most materials (e.g. metal) roll a number from 0-100, and if the resulting number is greater than the penetrate power, their contents escape for the time being. Objects made of [[wood]], [[leather]], [[amber]], or [[coral]] roll 0-95, and items made of [[cloth]] roll 0-90.

|-
| {{text anchor|PERSONALITY}}
| Caste
|
*ATTRIBUTE
*lowest
*median
*highest
| Determines the range and chance of personality facets. Standard is 0:50:100. See [[personality facet]] for more info.

|-
| {{text anchor|PET}}
| Caste
|
| Allows the creature to be [[Animal_trainer|tamed]] in Fortress mode. Prerequisite for all other working animal roles. Civilizations that encounter it in worldgen will tame and domesticate it for their own use. Adding this to civilization members will classify them as pets instead of citizens, with all the [[Fun|problems]] that entails. However, you can solve these problems using the popular plugin [https://dffd.bay12games.com/file.php?id=13095| Dwarf Therapist], which is completely unaffected by the tag.

|-
| {{text anchor|PET_EXOTIC}}
| Caste
|
| Allows the creature to be [[Animal_trainer|tamed]] in Fortress mode. Prequisite for all other working animal roles. Civilizations cannot domesticate it in worldgen, with certain exceptions. More difficult to tame?{{verify}} Adding this to civilization members will classify them as pets instead of citizens, with all the [[Fun|problems]] that entails. ([[Gremlin|Example]]).

|-
| {{text anchor|PETVALUE}}
| Caste
|
*value
| How valuable a tamed animal is. Actual cost in points in the embarking screen is 1+(PETVALUE/2) for an untrained animal, 1+PETVALUE for a war/hunting one.

|-
| {{text anchor|PETVALUE_DIVISOR}}
| Caste
|
*value
| Divides the creature's {{token|PETVALUE|c}} by the specified number. Used by [[honey bee]]s to prevent a single hive from being worth a fortune.

|-
| {{text anchor|PHYS_ATT_CAP_PERC}}
| Caste
|
*[[Attribute|ATTRIBUTE]] Token
*Cap %
|Default is 200. This means you can increase your attribute to 200% of its starting value (or the average value + your starting value if that is higher).

|-
| {{text anchor|PHYS_ATT_RANGE}}
| Caste
|
*[[Attribute|ATTRIBUTE]]
*lowest
*lower
*low
*median
*high
*higher
*highest
| Sets up a [[Attribute#Body_attributes|physical attribute]]'s range of values (0-5000). All physical attribute ranges default to 200:700:900:1000:1100:1300:2000.

|-
| {{text anchor|PHYS_ATT_RATES}}
| Caste
|
*[[Attribute|ATTRIBUTE]] Token
*cost to improve
*unused counter rate
*rust counter rate
*demotion counter rate
| [[Attribute#Body_attributes|Physical attribute]] gain/decay rates. Lower numbers in the last three slots make decay occur faster. Defaults for STRENGTH, AGILITY, TOUGHNESS, and ENDURANCE are 500:3:4:3, while RECUPERATION and DISEASE_RESISTANCE default to 500:NONE:NONE:NONE.

|-
| {{text anchor|PLUS_BP_GROUP}}
| Caste
|
*BY_TYPE, BY_CATEGORY, or BY_TOKEN
*body type, category, or token
| Adds a body part group to selected body part group. Presumably used immediately after {{token|SET_BP_GROUP|c}}.

|-
| {{text anchor|PLUS_MATERIAL}}
| Creature
|
*material
| Adds a material to selected materials. Used immediately after {{token|SELECT_MATERIAL|c}}.

|-
| {{text anchor|POP_RATIO}}
| Caste
|
*number (max 100000)
| Weighted population of caste; Lower is rarer. Not to be confused with {{token|FREQUENCY|c}}. A weight of 0 will{{version|51.06 experimental}} prevent a caste from spawning naturally. Regardless of pop ratio, [[Position token|Position]]s that only allow a certain caste can force it to spawn.

|-
| {{text anchor|POPULATION_NUMBER}}
| Creature
|
*min
*max
| The minimum/maximum numbers of how many of these creatures are present in each world map tile of the appropriate region. Defaults to 1:1 if not specified.

|-
| {{text anchor|POWER}}
| Caste
|
| Allows the being to represent itself as a deity, allowing it to become the leader of a civilized group. Not used by any creatures in the vanilla game. Requires {{token|CAN_SPEAK|c}} to actually do anything more than settle at a location (e.g. write books, lead armies, profane temples). Doesn't appear to do anything for creatures that are already civilized. Once the creature ascends to a position of leadership, it will proceed to act as a standard ruler for their entity and fulfill the same functions (hold tournaments, tame creatures, etc.).

|-
| {{text anchor|PREFSTRING}}
| Creature
|
*string
| Sets what other creatures [[Preferences|prefer]] about this creature. "Urist likes dwarves for their beards." Multiple entries will be chosen from at random. Creatures lacking a PREFSTRING token will never appear under another's preferences.

|-
| {{text anchor|PROCEDURAL_CREATURE_GRAPHICS}}
| Creature
|
* [[Graphics_token#Basic_creature_sprite_types|Sprite type]] or Caste then sprite type
| Makes the creature have procedural graphics built for it, like forgotten beasts/demons/titans/experiments. Must be associated with PCG_LAYERING tokens.

|-
| {{text anchor|PROFESSION_NAME}}
| Creature
|
*[[Unit type token]] (Profession)
*singular
*plural
| The generic name for members of this profession, at the creature level. In order to give members of specific castes different names for professions, use {{token|CASTE_PROFESSION_NAME|c}} instead.

|-
| {{text anchor|PRONE_TO_RAGE}}
| Caste
|
*Chance
| Creature has a percentage chance to flip out at visible non-friendly creatures. Enraged creatures attack anything regardless of timidity and get a strength bonus to their hits. This is what makes [[badger]]s so hardcore.

|-
| {{text anchor|PUS}}
| Caste
|
* <[[material token]]>
* <[[Material_definition_token#Material_States|material state]]>
| The creature has pus. Specifies the stuff secreted by [[Health_care#Infection|infected wounds]].
|}

{{alphabetical TOC|style=margin: 1em auto;}}

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

|-
| {{text anchor|RELSIZE}}
| Caste
|
*BY_CATEGORY, BY_TYPE, BY_TOKEN
*body category, type, or token
*Relsize
| Specifies a new relative size for a part than what is stated in the body plan. For example, dwarves have larger livers.

|-
| {{text anchor|REMAINS}}
| Caste
|
*singular
*plural
| What the creature's [[remains]] are called.

|-
| {{text anchor|REMAINS_COLOR}}
| Caste
|
| What color the creature's [[remains]] are.

|-
| {{text anchor|REMAINS_ON_VERMIN_BITE_DEATH}}
| Caste
|
| Goes with {{token|VERMIN_BITE|c}} and {{token|DIE_WHEN_VERMIN_BITE|c}}, the vermin creature will leave remains on death when biting. Leaving this tag out will cause the creature to disappear entirely after it bites.

|-
| {{text anchor|REMAINS_UNDETERMINED}}
| Caste
|
| Nothing.

|-
| {{text anchor|REMOVE_MATERIAL}}
| Creature
|
*material token
| Removes a material from the creature.

|-
| {{text anchor|REMOVE_TISSUE}}
| Creature
|
*tissue token
| Removes a tissue from the creature.

|-
| {{text anchor|RETRACT_INTO_BP}}
| Caste
|
*BY_TYPE, BY_CATEGORY or BY_TOKEN
*body type, [[Body_token#CATEGORY|category]], or [[Body_token#BP|token]]
*Second person ("You") retract verb text
*Third person ("The giant snail") retract verb text
*Second person cancel retract text
*Third person cancel retract text
| The creature will retract into the specified body part(s) when threatened. It will be unable to move or attack, but enemies will only be able to attack the specified body part(s). When one of the specified body part is severed off, the creature automatically unretracts and cannot retract anymore. More than one body part can be selected by using BY_TYPE or BY_CATEGORY.

Second-person descriptions are used for adventurer mode natural ability. "<pro_pos>" can be used in the descriptions, being replaced with the proper pronoun (or lack thereof) in-game.

Undead curled up creatures are buggy, specifically those that retract into their upper bodies: [[echidna]]s, [[hedgehog]]s and [[pangolin]]s.{{bug|11463}}{{bug|10519}} The upper body is prevented from collapsing by a separate body part (the middle spine), which cannot be attacked when the creature is retracted. See {{token|PREVENTS_PARENT_COLLAPSE|bo}}. Living creatures eventually succumb to blood loss, but undead creatures do not. Giant creatures also take a very long time to bleed out.
|-
| {{text anchor|RETURNS_VERMIN_KILLS_TO_OWNER}}
| Creature
|
| Cat behavior. If it kills a vermin creature and has an owner, it carries the remains in its mouth and drops them at their feet. Requires {{token|HUNTS_VERMIN|c}}.

|-
| {{text anchor|ROOT_AROUND}}
| Caste
|
*BY_TYPE, BY_CATEGORY or BY_TOKEN
*body type, [[Body_token#CATEGORY|category]], or [[Body_token#BP|token]]
*Second person ("You") verb text
*Third person ("The hen") verb text
| Creature will occasionally root around in the grass, looking for insects. Used for flavor in Adventurer Mode, spawns vermin edible for this creature in Fortress Mode. Creatures missing the specified body part will be unable to perform this action. The action produces a message (visible in adventure mode) in the form:

[creature] [verb text] the [description of creature's location]

In adventure mode, the "rooting around" ability will be included in the "natural abilities" menu, represented by its second person verb text.

|}

{{alphabetical TOC|style=margin: 1em auto;}}

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

|-
| {{text anchor|SAVAGE}}
| Creature
|
| The creature will only show up in "savage" biomes. Has no effect on cavern creatures. Cannot be combined with {{token|GOOD|c}} or {{token|EVIL|c}}.

|-
| {{text anchor|SECRETION}}
| Caste
|
*<[[material token]]>
*<[[Material_definition_token#Material_States|material state]]>
*BY_TOKEN / BY_CATEGORY / BY_TYPE
*<[[Body_token#BP|body part ID]]> / <[[Body_token#CATEGORY|category]]> or ALL / <type (e.g. [[Body_token#GRASP|GRASP]])>
*<[[Body_detail_plan_token#BP_LAYERS|tissue layer]]> or ALL
*<trigger>
| Causes the specified tissue layer(s) of the indicated body part(s) to secrete the designated material. A size 100 ('covering') [[contaminant]] is created over the affected body part(s) in its specified material state (and at the temperature appropriate to this state) when the trigger condition is met, as long as one of the secretory tissue layers is still intact. Valid triggers are:
*'''CONTINUOUS'''
Secretion occurs once every 40 [[time|ticks]] in [[fortress mode]], and every tick in [[adventurer mode]].
*'''EXERTION'''
Secretion occurs continuously (at the rate described above) whilst the creature is at minimum {{Tile|Tired|6:1}} following physical exertion. Note that this cannot occur if the creature has {{token|NOEXERT|c}}.
*'''EXTREME_EMOTION'''
Secretion occurs continuously (as above) whilst the creature is distressed. Cannot occur in creatures with {{token|NOEMOTION|c}}.

|-
| {{text anchor|SELECT_ADDITIONAL_CASTE}}
| Creature
|
*<caste>
| Adds an additional previously defined caste to the selection. Used after {{token|SELECT_CASTE|c}}.

|-
| {{text anchor|SELECT_CASTE}}
| Creature
|
*<caste> or ALL
| Selects a previously defined caste

|-
| {{text anchor|SELECT_MATERIAL}}
| Creature
|
*<[[material token]]>
| Selects a locally defined material. Can be ALL.

|-
| {{text anchor|SELECT_TISSUE}}
| Creature
|
*tissue token
| Selects a tissue for editing.

|-
| {{text anchor|SEMIMEGABEAST}}
| Caste
|
| Essentially the same as {{token|MEGABEAST|c}}, but more of them are created during worldgen. See the [[semi-megabeast]] page for details.

|-
| {{text anchor|SENSE_CREATURE_CLASS}}
| Caste
|
* <[[Creature_token#CREATURE_CLASS|creature class]]>
* [[Tilesets|<tile value or character>]]
* [[Color#Color_values|<foreground color>:<background color>:<foreground brightness>]]
| Gives the creature the ability to sense creatures belonging to the specified [[Creature_token#CREATURE_CLASS|creature class]] even when they lie far beyond line of sight, including through walls and floors. It also appears to reduce or negate the combat penalty of [[Wound#Blindness|blind]] units when fighting creatures they can sense. In [[adventure mode]], the specified tile will be used to represent sensed creatures when they cannot be seen directly.

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

|-
| {{text anchor|SKILL_LEARN_RATE}}
| Caste
|
*<[[skill_token]]>
*<percentage>
| The rate at which this creature learns this skill. Requires {{token|CAN_LEARN|c}} or {{token|INTELLIGENT|c}} to function.

|-
| {{text anchor|SKILL_LEARN_RATES}}
| Caste
|
*<percentage>
| The rate at which this creature learns all skills. Requires {{token|CAN_LEARN|c}} or {{token|INTELLIGENT|c}} to function.

|-
| {{text anchor|SKILL_RATE}}
| Caste
|
*[[skill_token]]
*<% of improvement points gained>
*<unused counter rate>
*<rust counter rate>
*<demotion counter rate>
| Like {{token|SKILL_RATES|c}}, but applies to individual skills instead. Requires {{token|CAN_LEARN|c}} or {{token|INTELLIGENT|c}} to function.

|-
| {{text anchor|SKILL_RATES}}
| Caste
|
*<% of improvement points gained>
*<unused counter rate>
*<rust counter rate>
*<demotion counter rate>
| Affects skill gain and decay. Lower numbers in the last three slots make decay occur faster ([SKILL_RATES:100:1:1:1] would cause rapid decay). The counter rates may also be replaced with NONE.
Default is [SKILL_RATES:100:8:16:16]. Requires {{token|CAN_LEARN|c}} or {{token|INTELLIGENT|c}} to function.

|-
| {{text anchor|SKILL_RUST_RATE}}
| Caste
|
*[[skill_token]]
*value
*value
*value
| The rate at which this skill decays. Lower values cause the skill to decay faster. Requires {{token|CAN_LEARN|c}} or {{token|INTELLIGENT|c}} to function.

|-
| {{text anchor|SKILL_RUST_RATES}}
| Caste
|
*value
*value
*value
| The rate at which all skills decay. Lower values cause the skills to decay faster. Requires {{token|CAN_LEARN|c}} or {{token|INTELLIGENT|c}} to function.

|-
| {{text anchor|SLAIN_CASTE_SPEECH}}
| Caste
|
*[[Speech file|text set]]
| Caste-specific {{token|SLAIN_SPEECH|c}}.

|-
| {{text anchor|SLAIN_SPEECH}}
| Creature
|
*[[Speech file|text set]]
| Boasting speeches relating to killing this creature. Examples include [[text_dwarf.txt/raw|text_dwarf.txt]] (<code>[SLAIN_SPEECH:SLAIN_DWARF]</code>) and text_elf.txt (<code>[SLAIN_SPEECH:SLAIN_ELF]</code>) in data\vanilla\vanilla_creatures\objects.

|-
| {{text anchor|SLOW_LEARNER}}
| Caste
|
| Shorthand for {{token|CAN_LEARN|c}} + <code>[[Creature_token#SKILL_LEARN_RATES|[SKILL_LEARN_RATES:50]]]</code>.{{verify}} Used by a number of 'primitive' creatures (like [[ogre]]s, [[giant]]s and [[troglodyte]]s) in the vanilla game. Applicable to player races. Prevents a player from recruiting nobility, even basic ones. Subterranean creatures with this token combined with {{token|EVIL|c}} will become servants of goblins in their civilizations, in the style of [[troll]]s.

|-
| {{text anchor|SMALL_REMAINS}}
| Caste
|
| Creature leaves "[[item token#REMAINS|remains]]" instead of a corpse. Used by [[vermin]].

|-
| {{text anchor|SMELL_TRIGGER}}
| Caste
|
*value
| Determines how keen a creature's sense of smell is - lower is better. At 10000, a creature cannot smell at all.

|-
| {{text anchor|SOLDIER_ALTTILE}}
| Creature
|
*'character' or tile number
| If this creature is active in its civilization's military, it will blink between its default tile and this one.

|-
| {{text anchor|SOUND}}
| Caste
|
* Sound application (currently accepts ALERT or PEACEFUL_INTERMITTENT)
* Sound range (in tiles)
* Sound delay (lower values = sound is produced more often)
* VOCALIZATION or NONE (determines whether the sound requires breathing or not)
* First-person description
* Third-person description
* Description when out of sight
| Creature makes sounds periodically, which can be heard in Adventure mode.
* First-person reads "You '''bark'''"
* Third-person reads "The [[capybara]] '''barks'''"
* Out of sight reads "You hear '''a loud bark'''"
with the text in bold being the description arguments of the token.

|-
| {{text anchor|SOURCE_HFID}}
| Creature
|
*Integer
| Found on generated [[angel]]s. This is the historical figure ID of the deity with which the angel is associated. Since HFIDs are not predictable before worldgen, this isn't terribly usable in mods.

|-
| {{text anchor|SPECIFIC_FOOD}}
| Caste
|
* PLANT or CREATURE
* Plant/creature ID
| Creature will only appear in biomes with this plant or creature available. Grazers given a specific type of grass (such as [[panda]]s and [[bamboo]]) will only eat that grass and nothing else, risking starvation if there's none available.

|-
| {{text anchor|SPHERE}}
| Creature
|
* [[Sphere#Available_spheres|sphere]]
| Sets what religious spheres the creature is aligned to, for purposes of being worshipped via the {{token|POWER|c}} token. Also affects the creature's name.

|-
| {{text anchor|SPOUSE_CONVERSION_TARGET}}
| Caste
|
| This creature can be converted by a night creature with {{token|SPOUSE_CONVERTER|c}}.

|-
| {{text anchor|SPOUSE_CONVERTER}}
| Caste
|
| If the creature has the {{token|NIGHT_CREATURE_HUNTER|c}} tag, it will kidnap {{token|SPOUSE_CONVERSION_TARGET|c}}s and transform them into the caste of its species with the {{token|CONVERTED_SPOUSE|c}} tag during worldgen. It may also start families this way.

|-
| {{text anchor|SPREAD_EVIL_SPHERES_IF_RULER}}
| Caste
|
| If the creature rules over a [[site]], it will cause the local landscape to be corrupted into [[Surroundings#Evil|evil surroundings]] associated with the creature's [[Creature_token#SPHERE|sphere]]s. The creature must have at least one of the following [[sphere]]s for this to take effect: BLIGHT, DEATH, DISEASE, DEFORMITY, NIGHTMARES. The first three kill vegetation, while the others sometimes do. The last two get [[Plant_token#EVIL|evil plants]] and [[Creature_token#EVIL|evil animals]] sometimes. NIGHTMARES gets [[bogeyman|bogeymen]]. [http://www.bay12forums.com/smf/index.php?topic=169696.msg8162224#msg8162224] Used by [[demon]]s in the vanilla game.

|-
| {{text anchor|STANCE_CLIMBER}}
| Caste
|
| Caste does not require <code>[[Body_token#GRASP|[GRASP]]]</code> body parts to climb -- it can climb with <code>[[Body_token#STANCE|[STANCE]]]</code> parts instead.

|-
| {{text anchor|STANDARD_GRAZER}}
| Caste
|
| Acts as {{token|GRAZER|c}} but set to 20000*G*(max size)^(-3/4), where G defaults to 100 but can be set in d_init, and the whole thing is trapped between 150 and 3 million. Used for all grazers in the default creature raws.

|-
| {{text anchor|STRANGE_MOODS}}
| Caste
|
| The creature will get [[strange mood]]s in fortress mode and can produce artifacts.

|-
| {{text anchor|SUPERNATURAL}}
| Caste
|
| Gives the creature knowledge of any secrets with <code>[[Interaction_token#IS_SECRET|[SUPERNATURAL_LEARNING_POSSIBLE]]]</code> that match its [[Creature_token#SPHERE|spheres]] and also prevents it from becoming a [[vampire]] or [[werebeast]]. Other effects are unknown.

|-
| {{text anchor|SWIMS_INNATE}}
| Caste
|
| The creature naturally knows how to swim perfectly and does not use the [[swimmer]] skill, as opposed to {{token|SWIMS_LEARNED|c}} below. However, Fortress mode AI never paths into water anyway, so it's less useful there.

|-
| {{text anchor|SWIMS_LEARNED}}
| Caste
|
| The creature swims only as well as their present [[Swimmer|swimming skill]] allows them to.

|-
| {{text anchor|SYNDROME_DILUTION_FACTOR}}
| Caste
| <[[Syndrome#SYN_IDENTIFIER|syndrome identifier]]>:<percentage>
| Dilutes the effects of syndromes which have the specified identifier. A percentage of 100 is equal to the regular syndrome effect severity, higher percentages reduce severity.
|}

{{alphabetical TOC|style=margin: 1em auto;}}

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

|-
| {{text anchor|TENDONS}}
| Caste
|
* [[material token]]
*healing rate
| The creature has tendons in its {{token|CONNECTIVE_TISSUE_ANCHOR|td}} tissues (bone or chitin by default). Cutting the bone/chitin tissue severs the tendons, disabling motor function if the target is a limb.

|-
| {{text anchor|THICKWEB}}
| Caste
|
| The creature's [[web]]s can catch larger creatures.

|-
| {{text anchor|TISSUE}}
| Creature
|
*name
| Begins defining a tissue in the creature file. Follow this with standard tissue definition tokens to define the tissue properties.

|-
| {{text anchor|TISSUE_LAYER}}
| Caste
|
*BY_TYPE, BY_CATEGORY, BY_TOKEN
*TYPE,CATEGORY, or TOKEN
*TISSUE
*LOCATION
| Adds the tissue layer to wherever it is required.
Non-argument Locations can be FRONT, RIGHT, LEFT, TOP, BOTTOM. Argument locations are AROUND and CLEANS, requiring a further body part and a % of coverage/cleansing

|-
| {{text anchor|TISSUE_LAYER_OVER}}
| Caste
|
*BY_TYPE, BY_CATEGORY, BY_TOKEN
*TYPE,CATEGORY, or TOKEN
*TISSUE
*LOCATION
| Alias for TISSUE_LAYER

|-
| {{text anchor|TISSUE_LAYER_UNDER}}
| Caste
|
*BY_TYPE, BY_CATEGORY, BY_TOKEN
*TYPE,CATEGORY, or TOKEN
*TISSUE
| Adds the tissue layer under a given part.
For example, an [[iron man]] has a gaseous poison within, and this tissue (GAS is its name) has the token [TISSUE_LEAKS] and its state is GAS, so when you puncture the iron outside and damage this tissue it leaks gas (can have a syndrome by using a previous one in the creature sample.) [TISSUE_LAYER_UNDER:BY_CATEGORY:ALL:{tissue}] {tissue} is what will be under the TISSUE_LAYER; here is an example Tissue from the 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]

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

|-
| {{text anchor|TRADE_CAPACITY}}
| Caste
|
*number
| How much the creature can carry when used by merchants. 1000 by default. Completely ignored if the animal does not also have PACK_ANIMAL or WAGON, instead using BODY_SIZE^(2/3)/20, even if they're a pack animal due to ANIMAL_ALWAYS_PACK_ANIMAL.

|-
| {{text anchor|TRAINABLE}}
| Caste
|
| Shortcut for {{token|TRAINABLE_HUNTING|c}} + {{token|TRAINABLE_WAR|c}}.

|-
| {{text anchor|TRAINABLE_HUNTING}}
| Caste
|
| Can be [[Animal trainer|trained]] as a hunting beast, increasing speed.

|-
| {{text anchor|TRAINABLE_WAR}}
| Caste
|
| Can be [[Animal trainer|trained]] as a war beast, increasing strength and endurance.

|-
| {{text anchor|TRANCES}}
| Caste
|
| Allows the creature to go into [[martial trance]]s. Used by dwarves in the vanilla game.

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

|-
| {{text anchor|TRIGGERABLE_GROUP}}
| Creature
|
*min
*max
| A large swarm of vermin can be disturbed, usually in adventurer mode.

|-
| {{text anchor|TSU_NOUN}}
| Caste
|
*noun
*SINGULAR or PLURAL
| Noun for the {{token|TISSUE_STYLE_UNIT|c}}, used in the description of the tissue layer's style.
|}

{{alphabetical TOC|style=margin: 1em auto;}}

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

|-
| {{text anchor|UBIQUITOUS}}
| Creature
|
| Creature will occur in every region with the correct biome. Does not apply to {{token|EVIL|c}}/{{token|GOOD|c}} tags. Supersedes {{token|FREQUENCY|c}} for the purposes of distributing populations through the map, they are present in every part of the valid biome. Respects {{token|FREQUENCY|c}} for the frequency of unit [[Creature token#CLUSTER_NUMBER|cluster]] spawns being of this species.

|-
| {{text anchor|UNDERGROUND_DEPTH}}
| Creature
|
*mindepth
*maxdepth
| Depth that the creature appears underground. Numbers can be from 0 to 5. 0 is actually 'above ground' and can be used if the creature is to appear both above and below ground. Values from 1-3 are the respective [[cavern]] levels, 4 is the [[magma sea]] and 5 is the [[HFS]]. A single argument may be used instead of min and max. [[Demon]]s use only 5:5; user-defined creatures with both this depth and {{token|FLIER}} will take part in the initial wave from the HFS alongside generated demons, but without {{token|FLIER}} they will only spawn from the map edges. Civilizations that can use underground plants or animals will only export (via the embark screen or caravans) things that are available at depth 1.

|-
| {{text anchor|UNDERSWIM}}
| Caste
|
| The creature is displayed as blue when in [[Water#Depth|7/7 water]]. Used on fish and amphibious creatures which swim under the water.

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

|-
| {{text anchor|USE_CASTE}}
| Creature
|
*new caste token
*old caste token
| Defines a new caste derived directly from a previous caste. The new caste inherits all properties of the old one. The effect of this tag is automatic if one has not yet defined any castes: "Any caste-level tag that occurs before castes are explicitly declared is saved up and placed on any caste that is declared later, unless the caste is explicitly derived from another caste."
Roostre: "When DF detects duplicate tokens in the raws of the same object, a failsafe seems to kick in; it takes the bottom-most of the duplicates, and disregards the others. In the case of tokens added by a mod, it prioritizes the duplicate in the mod." This means that if a tag is defined in the base-caste and redefined in the derived caste, the derived tag overwrites the base tag.

|-
| {{text anchor|USE_MATERIAL}}
| Creature
|
*new material ID
*old material ID
| Defines a new local creature material and populates it with all properties defined in the specified local creature material.

|-
| {{text anchor|USE_MATERIAL_TEMPLATE}}
| Creature
|
*new material token
*material template
| Defines a new local creature material and populates it with all properties defined in the specified template. [http://www.bay12forums.com/smf/index.php?topic=175437.msg8441368#msg8441368 There seems to be a limit of 200 materials per creature].

|-
| {{text anchor|USE_TISSUE}}
| Creature
|
*new tissue token
*old tissue id
| Defines a new local creature tissue and populates it with all properties defined in the local tissue specified in the second argument.

|-
| {{text anchor|USE_TISSUE_TEMPLATE}}
| Creature
|
*new tissue token
*tissue template
| Loads a tissue template listed in OBJECT:TISSUE_TEMPLATE files, such as tissue_template_default.txt.

|-
| {{text anchor|UTTERANCES}}
| Creature
|
| Changes the language of the creature into unintelligible 'kobold-speak', which creatures of other species will be unable to understand. If a civilized creature has this and is not part of a {{token|SKULKING|e}} civ, it will tend to start wars with all nearby civilizations and will be unable to make peace treaties due to 'inability to communicate'.
|}

{{alphabetical TOC|style=margin: 1em auto;}}

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

|-
| {{text anchor|VEGETATION}}
| Caste
|
| Like {{token|AT_PEACE_WITH_WILDLIFE}}, but also makes the creature more valued in artwork by civilisations with the PLANT [[sphere]]. [http://www.bay12forums.com/smf/index.php?topic=169696.msg8316954#msg8316954] Used by [[grimeling]]s in the vanilla game.

|-
| {{text anchor|VERMIN_BITE}}
| Caste
|
*chance of occurrence{{verify}}
*verb (bitten, stung, etc.)
* [[material token]]
* [[Material_definition_token#Material_States|material state]]
| Enables vermin to bite other creatures, injecting the specified material. See {{token|SPECIALATTACK_INJECT_EXTRACT|c}} for details about injection - this token presumably works in a similar manner.{{verify}}

|-
| {{text anchor|VERMIN_EATER}}
| Creature
|
| The vermin creature will attempt to eat exposed food. See {{token|PENETRATEPOWER|c}}. Distinct from {{token|VERMIN_ROTTER|c}}.

|-
| {{text anchor|VERMIN_FISH}}
| Creature
|
| The vermin appears in [[water]] and will attempt to swim around.

|-
| {{text anchor|VERMIN_GROUNDER}}
| Creature
|
| The creature appears in "general" surface ground locations. Note that this doesn't stop the creature from flying if it can (most vermin birds have this tag).

|-
| {{text anchor|VERMIN_HATEABLE}}
| Caste
|
| Some dwarves will [[Preferences|hate]] the creature and get unhappy thoughts when around it. See the [[Hateable|list of hateable vermin]] for details.

|-
| {{text anchor|VERMIN_MICRO}}
| Caste
|
| This makes the creature move in a swarm of creatures of the same race as it (e.g. swarm of flies, swarm of ants).

|-
| {{text anchor|VERMIN_NOFISH}}
| Caste
|
| The creature cannot be caught by [[fishing]].

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

|-
| {{text anchor|VERMIN_NOTRAP}}
| Caste
|
| The creature cannot be caught in baited [[animal trap]]s; however, a "[[Trapper|catch live land animal]]" task may still be able to capture one if a dwarf finds one roaming around.

|-
| {{text anchor|VERMIN_ROTTER}}
| Creature
|
| The vermin are attracted to rotting stuff and loose food left in the open and cause unhappy thoughts to dwarves who encounter them. Present on flies, knuckle worms, acorn flies, and blood gnats.

|-
| {{text anchor|VERMIN_SOIL}}
| Creature
|
| The creature randomly appears near dirt or mud, and may be uncovered by creatures that have the {{token|ROOT_AROUND|c}} interaction such as [[goose|geese]] and [[chicken]]s. Dwarves will ignore the creature when given the "Capture live land animal" task.

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

|-
| {{text anchor|VERMINHUNTER}}
| Caste
|
| Old shorthand for "does cat stuff". Contains {{token|AT_PEACE_WITH_WILDLIFE|c}} + {{token|RETURNS_VERMIN_KILLS_TO_OWNER|c}} + {{token|HUNTS_VERMIN|c}} + {{token|ADOPTS_OWNER|c}}.

|-
| {{text anchor|VESPERTINE}}
| Caste
|
| When set, the creature will only appear in the evening (between 8:00 PM and 10:05 PM) in Adventurer mode.

|-
| {{text anchor|VIEWRANGE}}
| Caste
|
*value
| Value should determine how close you have to get to a critter before it attacks (or prevents adv mode travel etc.) Default is 20.

|-
| {{text anchor|VISION_ARC}}
| Caste
|
*binocular vision arc
*non-binocular vision arc
| The width of the creature's vision arcs, in degrees (i.e. 0 to 360). The first number is binocular vision, the second is non-binocular vision. Binocular vision has a minimum of about 10 degrees, monocular, a maximum of about 350 degrees. Values past these limits will be accepted, but will default to ~10 degrees and ~350 degrees respectively. Defaults are 60:120.
|}

{{alphabetical TOC|style=margin: 1em auto;}}

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

|-
| {{text anchor|WAGON_PULLER}}
| Caste
|
| Allows the creature to pull caravan wagons. If a civilization doesn't have access to any, it is restricted to trading with pack animals.

|-
| {{text anchor|WEBBER}}
| Caste
|
* [[material token]]
| Allows the creature to create [[web]]s, and defines what the webs are made of.

|-
| {{text anchor|WEBIMMUNE}}
| Caste
|
| The creature will not get caught in thick [[web]]s. Used by creatures who can shoot thick webs (such as [[giant cave spider]]s) in order to make them immune to their own attacks.
|}

==Attack Tokens==

Attacks can use four different part selection criteria. Except for TISSUE_LAYER, the base game makes use of all of these in its attacks.

{| {{prettytable}}
|- bgcolor="#ddd"
! width="20%" | Part type token
! width="30%" | Arguments
! width="60%" | Description

|-
| {{text anchor|BODYPART}}
|
* BY_TYPE/BY_TOKEN/BY_CATEGORY
* type/token/category
| This attack uses a particular body part; for example, ATTACK:PUNCH:BODYPART:BY_TYPE:GRASP will make it use any part that can hold onto an object.

|-
| {{text anchor|TISSUE_LAYER}}
|
* BY_TYPE/BY_TOKEN/BY_CATEGORY
* type/token/category
* tissue layer
| This attack uses a specific tissue layer on a specific body part; ATTACK:SCRATCH:TISSUE_LAYER:BY_TYPE:GRASP:BONE will make it use the bone of the hands.

|-
| {{text anchor|CHILD_BODYPART_GROUP}}
|
* BY_TYPE/BY_TOKEN/BY_CATEGORY
* type/token/category
* BY_TYPE/BY_TOKEN/BY_CATEGORY
* type/token/category
| Uses a body part that is subordinate to another; ATTACK:SLAP:CHILD_BODYPART_GROUP:BY_CATEGORY:ARM_LOWER:BY_TYPE:GRASP will make it use every hand attached to each lower arm (so it will generate one attack per lower arm, each of which will use every hand on that arm, assuming there are multiple hands per arm).

|-
| {{text anchor|CHILD_TISSUE_LAYER_GROUP}}
|
* BY_TYPE/BY_TOKEN/BY_CATEGORY
* type/token/category
* BY_TYPE/BY_TOKEN/BY_CATEGORY
* type/token/category
* tissue layer
| As CHILD_BODYPART_GROUP, but specifying a tissue, too; ATTACK:BITE:CHILD_BODYPART_GROUP:BY_CATEGORY:HEAD:BY_CATEGORY:TOOTH

|}

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

|-
| {{text anchor|ATTACK_SKILL}}
| Caste
|
*[[Skill token]]
| Defines the skill used by the attack.

|-
| {{text anchor|ATTACK_VERB}}
| Caste
|
*2nd person
*3rd person
| Descriptive text for the attack.

|-
| {{text anchor|ATTACK_CONTACT_PERC}}
| Caste
|
*% value
| The contact area of the attack, measured in % of the body part's volume. Note that all attack percentages can be more than 100%.

|-
| {{text anchor|ATTACK_PENETRATION_PERC}}
| Caste
|
*% value
| The penetration value of the attack, measured in % of the body part's volume. Requires ATTACK_FLAG_EDGE. Maximum value: 15000.

|-
| {{text anchor|ATTACK_PRIORITY}}
| Caste
|
*MAIN or SECOND
| Usage frequency. MAIN attacks are 100 times more frequently chosen than SECOND. Opportunity attacks ignore this preference.

|-
| {{text anchor|ATTACK_VELOCITY_MODIFIER}}
| Caste
|
*number
| The velocity multiplier of the attack, multiplied by 1000.

|-
| {{text anchor|ATTACK_FLAG_CANLATCH}}
| Caste
|
| Attacks that damage tissue have the chance to latch on in a wrestling hold. The grabbing bodypart can then use the "shake around" wrestling move, causing severe, armor-bypassing tensile damage according to the attacker's body volume.

|-
| {{text anchor|ATTACK_FLAG_WITH}}
| Caste
|
| Displays the name of the body part used to perform an attack while announcing it, e.g. "The weaver punches the bugbat with his right hand".

|-
| {{text anchor|ATTACK_FLAG_EDGE}}
| Caste
|
| The attack is edged, with all the effects on physical resistance and contact area that it entails.

|-
| {{text anchor|ATTACK_PREPARE_AND_RECOVER}}
| Caste
|
* Preparation time
* Recovery time
| Determines the length of time to prepare this attack and until one can perform this attack again. Values appear to be calculated in adventure mode ticks.

|-
| {{text anchor|ATTACK_FLAG_BAD_MULTIATTACK}}
| Caste
|
| Multiple strikes with this attack cannot be performed effectively.

|-
| {{text anchor|ATTACK_FLAG_INDEPENDENT_MULTIATTACK}}
| Caste
|
| Multiple strikes with this attack can be performed with no penalty. The creature will use all attacks with this token at once.

|-
| {{text anchor|SPECIALATTACK_INJECT_EXTRACT}}
| Caste
|
*<[[material token]]>
*<[[Material_definition_token#Material_States|material state]]>
*<min quantity>
*<max quantity>
| When added to an attack, causes the attack to inject the specified material into the victim's bloodstream. Once injected, the material will participate in [[temperature|thermal]] exchange within the creature - injecting something like molten [[iron]] (INORGANIC:IRON:LIQUID) would cause most unmodded creatures to melt (note that some of the injected material also [[contaminant|splatters]] over the bodypart used to carry out the attack, so it should be protected appropriately). If the injected material has an associated [[syndrome]] with the [[Syndrome#SYN_INJECTED|[SYN_INJECTED]]] token, it will be transmitted to the victim. If the attack is blunt, the injected material lacks the [[Material definition token#ENTERS_BLOOD|[ENTERS_BLOOD]]] token, the attacked bodypart has no [[Tissue_definition_token#VASCULAR|[VASCULAR]]] tissues, or the victim is bloodless, the material will splatter over the attacked body part instead.

|-
| {{text anchor|SPECIALATTACK_INTERACTION}}
| Caste
|
*interaction
| When this attack lands successfully, a specified interaction will take effect on the target creature. The attack must break the target creature's skin in order to work. This will take effect in worldgen as well. If the attack would break skin, the interaction will occur '''before the attack actually lands'''.

|-
| {{text anchor|SPECIALATTACK_SUCK_BLOOD}}
| Caste
|
*min
*max
| Successful attack draws out an amount of blood randomized between the min and max value. Beware that this '''will''' trigger any ingestion syndromes attached to the target creature's blood - for example, using this attack on a vampire will turn you into one too.
|}

==Tissue Layer Tokens==
Tissue layers are added to a creature's body parts by the creature tokens [[#TISSUE_LAYER|TISSUE_LAYER]], [[#TISSUE_LAYER_OVER|TISSUE_LAYER_OVER]], [[#TISSUE_LAYER_UNDER|TISSUE_LAYER_UNDER]], and the body detail plan token [[#TL_LAYERS|TL_LAYERS]].

These tissue layers are not the same thing as tissues, which are defined at creature level, but rather applications of the tissues. If the SKIN tissue of a creature is the more general and abstract notion of what skin is for that creature, then a tissue layer may be the "actual" skin on the creature's nose, head, or second toe. As most creatures have more than one body part, tissue layers are normally selected en masse.

Some tissue layer tokens are analogous to tissue definition tokens, e.g. [[#TL_CONNECTS|TL_CONNECTS]] to [[tissue_definition_token#CONNECTS|CONNECTS]].

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

|-
| {{text anchor|SELECT_TISSUE_LAYER}}
| Caste
|
*TISSUE
*BY_CATEGORY, BY_TYPE, BY_TOKEN
*Location - category, type, or token | Selects a tissue at a location
* (optional) FRONT, BACK, LEFT, RIGHT, TOP, BOTTOM, AROUND.
| Begins a selection of tissue layers.
[SELECT_TISSUE_LAYER:HEART:BY_TYPE:HEART]

|-
| {{text anchor|PLUS_TISSUE_LAYER}}
| Caste
|
*TISSUE
*BY_CATEGORY, BY_TYPE, BY_TOKEN
*Location - category, type, or token
| Adds tissue layers to those selected.

|-
| {{text anchor|SET_TL_GROUP}}
| Caste
|
*TISSUE
*BY_CATEGORY, BY_TYPE, BY_TOKEN
*Location - category, type, or token
*tissue
| Begins a selection of tissue layers. Only usable for descriptor and cosmetic purposes.

Research has implied it may be redundant with SELECT_TISSUE_LAYER, as the latter allows for cosmetics as well as "functional" tokens such as TL_MAJOR_ARTERIES. Vanilla raws still use SET_TL_GROUP though, for all cosmetic purposes. More research is needed on this subject.

|-
| {{text anchor|PLUS_TL_GROUP}}
| Caste
|
*BY_CATEGORY, BY_TYPE, BY_TOKEN
*Location - category, type, or token
*tissue
| Adds tissue layers to those selected. Like SET_TL_GROUP, it may be redundant even if used in the vanilla raws.

|-
| {{text anchor|SET_LAYER_TISSUE}}
| Caste
|
*TISSUE
| Sets a selected tissue layer to be made of a different tissue.

|-
| {{text anchor|SHEARABLE_TISSUE_LAYER}}
| Caste
|
* tissue modifier
* required value
| Tissue layer can be sheared for its component material. The specified modifier must be at least of the desired value for shearing to be possible (for example, a [[llama]]'s wool must have a LENGTH of 300 before it is shearable).

|-
| {{text anchor|TISSUE_LAYER_APPEARANCE_MODIFIER}}
| Caste
|
*QUALITY
*lowest
*lower
*low
*median
*high
*higher
*highest
| Sets the range of qualities, including LENGTH, DENSE, HIGH_POSITION, CURLY, GREASY, WRINKLY

|-
| {{text anchor|TISSUE_STYLE_UNIT}}
| Caste
|
*tissue style unit ID
*shaping
| Sets tissue layer to be the target of TISSUE_STYLE token specified for an entity, works only on entity members. Mostly used with tissues HAIR, BEARD, MOUSTACHE, SIDEBURNS.

|-
| {{text anchor|TL_COLOR_MODIFIER}}
| Caste
|
*COLOR
*freq
*COLOR
*freq etc.
| Creates a list of colors/color patterns, giving each a relative frequency. If the given color or pattern does not exist, the tissue is described as being "transparent".

|-
| {{text anchor|TLCM_GENETIC_MODEL}}
| Caste
|
| The way the color modifier is passed on to offspring. May or may not work right now.{{verify}}

|-
| {{text anchor|TLCM_IMPORTANCE}}
| Caste
|
*number
| Presumably modifies the importance of the tissue layer color modifier, for description purposes.
HOWEVER using this appears to remove all mention of colour from creature descriptions. It does not appear in any default creatures.

|-
| {{text anchor|TLCM_NOUN}}
| Caste
|
*name
*SINGULAR or PLURAL
| Names the tissue layer color modifier, and determines the noun. Also used by [[Utility:Stonesense|Stonesense]] for colouring body parts.

|-
| {{text anchor|TLCM_TIMING}}
| Caste
|
*ROOT
*start change window years
*days
*end change window years
*days
| Determines the point in the creature's life when the color change begins and ends.

|-
| {{text anchor|TL_CONNECTS}}
| Caste
|
| Gives the CONNECTS attribute to selected layers.

|-
| {{text anchor|TL_HEALING_RATE}}
| Caste
|
*value
| Changes the HEALING_RATE of the selected tissue layers.

|-
| {{text anchor|TL_MAJOR_ARTERIES}}
| Caste
|
| Gives the "major arteries" attribute to selected layers. Used to add massive bleeding properties to the throat, made from skin.

|-
| {{text anchor|TL_PAIN_RECEPTORS}}
| Caste
|
*value
| Changes the number of pain receptors for selected tissue layers.

|-
| {{text anchor|TL_RELATIVE_THICKNESS}}
| Caste
|
*value
| Changes the relative thickness for selected tissue layers.

|-
| {{text anchor|TL_VASCULAR}}
| Caste
|
*value
| Sets a new VASCULAR value (which modulates bleeding) for selected tissue layers.

|}

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

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

Creature token

2025-04-08T23:05:27Z

DikbutDaGrate: Minor formatting edit

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

The <code>[OBJECT:CREATURE]</code> [[token]] begins the definition of a ''Dwarf Fortress'' [[creature]] [[raw file]]. Each creature definition that follows begins with the {{token|creature|c|creature ID}} token, and the creature's exact properties and behavior are then specified by the use of further creature tokens. All known creature tokens are listed below.

Vanilla creature definitions can be found in <code>[[Game folder|<Dwarf Fortress>]]\data\vanilla\vanilla_creatures\</code>.
Creature ID is also used with [[graphics token]]s to make customizable [[graphics set]]s.

The [[caste]] tokens allow defining sub-species within the broader creature definition, including true biological castes and lesser variations, such as sexes. Creature tokens can either be 'Creature' or 'CASTE-only' type which can only be applied to creature or caste respectively, or 'CASTE' which can be applied to both. In the table bellow, creature type distinguishes tokens that can be applied to creature only, caste only, and both ('creature', 'CASTE-only', and 'CASTE' respectively)

__NOTOC__
{{clear}}
{{alphabetical TOC|style=margin: 1em auto;}}

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

|-
| {{text anchor|ADOPTS_OWNER}}
| Caste
|
| Prevents the tamed creature from being made available for adoption, instead allowing it to automatically adopt whoever it wants. The basic requirements for adoption are intact, and the creature will only adopt individuals who have a [[preference]] for their species. Used by [[cat]]s in the vanilla game. When {{k|v}}iewing a tame creature with this token, the message "This animal isn't interested in your wishes" will appear instead of "This [adorable] animal can't work" or "This animal is waiting to be trained".

|-
| {{text anchor|ALCOHOL_DEPENDENT}}
| Caste
|
| Makes the creature need [[alcohol]] to get through the working day; it will choose to drink booze instead of [[water]] if possible. Going sober for too long reduces speed.

|-
| {{text anchor|ALL_ACTIVE}}
| Caste
|
| When set, the creature will appear at any time of day. Overrides {{token|DIURNAL|c}}, {{token|NOCTURNAL|c}}, {{token|CREPUSCULAR|c}}, {{token|MATUTINAL|c}}, and {{token|VESPERTINE|c}}.

|-
| {{text anchor|ALTTILE}}
| Creature
|
*'character' or tile number
| If set, the creature will blink between its {{token|TILE|c}} and its ALTTILE.

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

|-
| {{text anchor|AMPHIBIOUS}}
| Caste
|
| Allows a creature to breathe both in and out of [[water]] (unlike {{token|AQUATIC|c}}) - does not prevent drowning in [[magma]].

|-
| {{text anchor|APP_MOD_DESC_RANGE}}
| Appearance Modifier
|
*Range (6 values, low to high)
| Based on info from [http://www.bay12forums.com/smf/index.php?topic=113762.msg3473069#msg3473069 Wannabehero on the forums]: When used with an appearance modifier token (BP_APPEARANCE_MODIFIER or BODY_APPEARANCE_MODIFIER), tells the game what numeric ranges to map to which descriptors.

The game uses 7 descriptor levels for each modifier, with the center one generally being to omit the thing from the creature description entirely. The six values in APP_MOD_DESC_RANGE define the boundaries between each described range. If this is not specified it uses the numbers 10:50:95:105:150:190.

|-
| {{text anchor|APP_MOD_GENETIC_MODEL}}
| Appearance Modifier
|
*Model (Accepts DOMINANT_MORE, DOMINANT_LESS, and MIX)
| Defines a genetic model for the relevant appearance modifier(s). May or may not do anything significant at present.

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

|-
| {{text anchor|APP_MOD_NOUN}}
| Appearance Modifier
|
*noun
*SINGULAR or PLURAL
| Creates a noun for the appearance, and whether it is singular or plural.

|-
| {{text anchor|APP_MOD_RATE}}
| Appearance Modifier
|
*Rate (integer)
*Scale (DAILY, YEARLY)
*min (growth)
*max (growth)
*start year
*start day
*end year
*end day
| Setting the growth rate of the modifier. The last two tokens can be replaced by NO_END to have growth continue indefinitely.

|-
| {{text anchor|APPLY_CREATURE_VARIATION}}
| Caste
|
*creature variation ID
*(optional) any amount of arbitrary arguments
| Applies the specified [[creature variation token|creature variation]]. See [[Creature_variation_token#Arguments_and_conditional_tokens]] for how the subsequent arguments may be used.

|-
| {{text anchor|APPLY_CURRENT_CREATURE_VARIATION}}
| Special
|
| Applies the effects of all pending {{token|CV_ADD_TAG|c}} and {{token|CV_REMOVE_TAG|c}} tokens that have been defined in the current creature.

|-
| {{text anchor|AQUATIC}}
| Caste
|
| Enables the creature to breathe in water, but causes it to air-drown on dry land.

|-
| {{text anchor|ARENA_RESTRICTED}}
| Caste
|
| Causes the creature to be excluded from the [[object testing arena]]'s creature spawning list. Typically applied to spoileriffic creatures.

|-
| {{text anchor|ARTIFICIAL_HIVEABLE}}
| Creature
|
| Enables the creature to be kept in artificial [[hive]]s by [[beekeeper]]s.

|-
| {{text anchor|AT_PEACE_WITH_WILDLIFE}}
| Caste
|
| Prevents the creature from attacking or frightening creatures with the {{Token|NATURAL|c}} tag.

|-
| {{text anchor|ATTACK}}
| Caste
|
*token
*selection criteria (it's complicated)
| Defines the attack name, and the body part used. See [[#Attack Tokens|below]] for valid subtokens
'''Example:''' 
<code>[ATTACK:GORE:BODYPART:BY_CATEGORY:HORN]</code> 
''GORE'' = name of the attack 
''BODYPART:BY_CATEGORY:HORN'' = the horn is used to attack (presuming the creature has one)

|-
| {{text anchor|ATTACK_TRIGGER}}
| Caste
|
*population
*exported wealth
*created wealth
| Specifies when a [[megabeast]] or [[semi-megabeast]] will attack the fortress. The attacks will start occurring when all of the requirements are met. Setting a value to 0 disables the trigger.

|}

{{alphabetical TOC|style=margin: 1em auto;}}

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

|-
| {{text anchor|BABY}}
| Caste
|
*integer
| Age at which creature is considered a child, the default is zero. One can think of this as the duration of the baby stage.

|-
| {{text anchor|BABYNAME}}
| Caste
|
*singular
*plural
| Defines a new name for a creature in baby state at the caste level. For non-caste-specific baby names, see {{token|GENERAL_BABY_NAME|c}}.

|-
| {{text anchor|BEACH_FREQUENCY}}
| Caste
|
*integer
| Creature may be subject to [[beaching]], becoming stranded on [[Beach|shores]], where they will eventually air-drown. The number indicates the frequency of the occurrence. Presumably requires the creature to be {{token|AQUATIC|c}}. Used by [[orca]]s, [[sperm whale]]s and [[sea nettle jellyfish]] in the vanilla game.

|-
| {{text anchor|BENIGN}}
| Caste
|
| The creature is non-aggressive by default, and will never automatically be engaged by companions or soldiers, running away from any creatures that are not friendly to it, and will only defend itself if it becomes enraged. Can be thought of as the counterpoint of the {{token|LARGE_PREDATOR|c}} tag. When tamed, animals with this tag will be useless for fortress defense.

This and {{token|TRADE_CAPACITY|c}} are required for {{token|PACK_ANIMAL|c}} to function properly, if an animal contains the aforementioned requirements without this tag: items loaded by the merchants will be dropped upon departure.

|-
| {{text anchor|BIOME}}
| Creature
|
* [[biome token]]
| Select a [[biome]] the creature may appear in.

|-
| {{text anchor|BLOOD}}
| Caste
|
* <[[material token]]>
* <[[Material_definition_token#Material_States|material state]]>
| Specifies what the creature's blood is made of.

|-
| {{text anchor|BLOODSUCKER}}
| Caste
|
| Causes [[vampire]]-like behaviour; the creature will suck the [[Creature_token#BLOOD|blood]] of unconscious victims when its [[Syndrome#TIME_SINCE_SUCKED_BLOOD|thirst for blood]] grows sufficiently large. When controlling the creature in adventure mode, this can be done at will. Seems to be required to make the creature denouncable (in-world) as a creature of the night.

|-
| {{text anchor|BODY}}
| Caste
|
*body parts
| Draws body parts from OBJECT:BODY files (such as body_default.txt)
'''Example:''' 
[BODY:BODY_WITH_HEAD_FLAG:HEART:GUTS:BRAIN:MOUTH] 
This is the body from a [[purring maggot]]. It creates a body with head, a heart, some guts, a brain, and a mouth. That's all a maggot needs.

The body parts need to be listed in an order such that any parent part appears before its connected children. For example [BODY:HEART:BODY_WITH_HEAD_FLAG] produces a "Body Token Recognized But Could Not Connect: HEART" error because HEART can't find any UPPERBODY(s) to connect to. Switching the order to [BODY:BODY_WITH_HEAD_FLAG:HEART] fixes the problem because now the UPPERBODY is created before the HEART tries to connect to it.

'''If the body is left undefined, the creature (or caste) will be tagged as [DOES_NOT_EXIST].''' {{verify}}

|-
| {{text anchor|BODY_APPEARANCE_MODIFIER}}
| Caste
|
*ATTRIBUTE
*lowest
*lower
*low
*median
*high
*higher
*highest
| These body modifiers give individual creatures different characteristics. In the case of HEIGHT, BROADNESS and LENGTH, the modifier is also a percentage change to the BODY_SIZE of the individual creature. The seven numbers afterward give a distribution of ranges. Each interval has an equal chance of occurring.
'''Example:''' 
[BODY_APPEARANCE_MODIFIER:HEIGHT:90:95:98:100:102:105:110] 
''HEIGHT'' : marks the height to be changed 
''90:95:98:100:102:105:110'' : sets the range from the shortest (90% of the average height) to the tallest (110% of the average height) creature variation.

|-
| {{text anchor|BODY_DETAIL_PLAN}}
| Caste
|
*PlanName
*Arguments
| Loads a plan from 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:''' 
[BODY_DETAIL_PLAN:VERTEBRATE_TISSUE_LAYERS:SKIN:FAT:MUSCLE:BONE:CARTILAGE] 
This creates the detailed body of a [[fox]], the skin, fat, muscle, bones and cartilage out of the vertebrate tissues. 
A [[Purring maggot|maggot]] would only need: 
''[BODY_DETAIL_PLAN:EXOSKELETON_TISSUE_LAYERS:SKIN:FAT:MUSCLE]''

|-
| {{text anchor|BODY_SIZE}}
| Caste
|
*years
*days
*size
| Sets size at a given age. Size is in cubic centimeters, and for normal body materials, is roughly equal to the creature's average weight in grams.
'''Example:''' 
[BODY_SIZE:0:0:10000] 
[BODY_SIZE:1:168:50000] 
[BODY_SIZE:12:0:220000] 
This describes the size of a [[minotaur]]. Its birth size would be 10,000 cm3 (~10 kg). At 1 year and 168 days old it would be 50,000 cm3 (~50 kg). And as an adult (at 12 years old) it would be 220,000 cm3 and weigh roughly 220 kg.

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

|-
| {{text anchor|BONECARN}}
| Caste
|
| Creature eats bones. Implies {{token|CARNIVORE|c}}. [[Adventurer mode|Adventurers]] with this token are currently unable to eat bones.{{Bug|11069}}

|-
| {{text anchor|BP_ADD_TYPE}}
| Caste
|
| Adds a type to a body part - used with {{token|SET_BP_GROUP|c}}. In vanilla DF, this is used for adding the type '[[Body token#GELDABLE|GELDABLE]]' to the lower body of certain [[cat|creatures]].

|-
| {{text anchor|BP_APPEARANCE_MODIFIER}}
| Caste
|
*QUALITY
*lowest
*lower
*low
*median
*high
*higher
*highest
| Sets up the breadth of possibilities for appearance qualities for a selected BP group. EG. Eyes (CLOSE_SET, DEEP_SET, ROUND_VS_NARROW, LARGE_IRIS),Lips (THICKNESS), Nose (BROADNESS, LENGTH, UPTURNED, CONVEX), Ear (SPLAYED_OUT, HANGING_LOBES, BROADNESS, HEIGHT), Tooth (GAPS), Skull (HIGH_CHEEKBONES, BROAD_CHIN, JUTTING CHIN, SQUARE_CHIN), Neck (DEEP_VOICE, RASPY_VOICE), Head (BROADNESS, HEIGHT)

|-
| {{text anchor|BP_REMOVE_TYPE}}
| Caste
|
| Removes a type from a body part. Used with {{token|SET_BP_GROUP|c}}.

|-
| {{text anchor|BUILDINGDESTROYER}}
| Caste
|
*1 or 2
| Allows a creature to destroy furniture and buildings. Value [1] targets mostly doors, hatches, furniture and the like. Value [2] targets anything not made with the {{k|b}} + {{k|C}} commands.
|}

{{alphabetical TOC|style=margin: 1em auto;}}

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

|-
| {{text anchor|CAN_DO_INTERACTION}}
| Caste
|
*interaction token
| The creature can perform an interaction. See [[interaction token]].

|-
| {{text anchor|CAN_LEARN}}
| Caste
|
| The creature gains [[skill]]s and can have [[labor|professions]]. If a member of a civilization (even a pet) has this token, it'll need to eat, drink and sleep. Note that this token makes the creature unable to be eaten 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. A creature with at least this token or the {{token|CAN_SPEAK|c}} token will be able to have [[Personality value|values]] and [[Personality goal|goals]].

|-
| {{text anchor|CAN_SPEAK}}
| Caste
|
| Can [[talking|talk]]. Note that this is not necessary for a creature to gain social skills but to make friends in fortress mode. A creature with at least this token or the {{token|CAN_LEARN|c}} token will be able to have [[Personality value|values]] and [[Personality goal|goals]].

|-
| {{text anchor|CANNOT_CLIMB}}
| Caste
|
| Creature cannot [[climber|climb]], even if it has free grasp parts.

|-
| {{text anchor|CANNOT_JUMP}}
| Caste
|
| Creature cannot [[jump]].

|-
| {{text anchor|CANNOT_UNDEAD}}
| Caste
|
| Acts like {{token|NOT_LIVING|c}}, except that {{token|OPPOSED_TO_LIFE|c}} creatures will attack them.

|-
| {{text anchor|CANOPENDOORS}}
| Caste
|
| Defunct, as doors cannot be set as tightly closed anymore.

|-
| {{text anchor|CARNIVORE}}
| Caste
|
| Creature ''only'' eats [[meat]]. If the creature goes on rampages in worldgen, it will often devour the people/animals it kills.

|-
| {{text anchor|CASTE}}
| Creature
|
*name
| Defines a [[caste]].

|-
| {{text anchor|CASTE_ALTTILE}}
| Caste
|
*tile number or "letter"
| Caste-specific {{token|ALTTILE|c}}. Requires {{token|CASTE_TILE|c}}.

|-
| {{text anchor|CASTE_COLOR}}
| Caste
|
*fg
*bg
*brightness
| Caste-specific {{token|COLOR|c}}.

|-
| {{text anchor|CASTE_GLOWCOLOR}}
| Caste
|
*fg
*bg
*brightness
| Caste-specific {{token|GLOWCOLOR|c}}.

|-
| {{text anchor|CASTE_GLOWTILE}}
| Caste
|
*tile value or "letter"
| Caste-specific {{token|GLOWTILE|c}}.

|-
| {{text anchor|CASTE_NAME}}
| Caste
|
*singular
*plural
*adjective
| While {{token|NAME|c}} describes the name of the species, {{token|CASTE_NAME|c}} names individuals of the species. Unlike other caste-specific descriptions, this token is required, even for creatures without separate castes. If left undefined, the creature will not show up in the [[arena]] and members of the species will be labeled as "nothing".

|-
| {{text anchor|CASTE_PROFESSION_NAME}}
| Caste
|
*[[Unit type token]] (Profession)
*singular
*plural
| Caste-specific {{token|PROFESSION_NAME|c}}.

|-
| {{text anchor|CASTE_SOLDIER_ALTTILE}}
| Caste
|
*'character' or tile number
| Caste-specific {{token|SOLDIER_ALTTILE|c}}. Requires {{token|CASTE_SOLDIER_TILE|c}}.

|-
| {{text anchor|CASTE_SOLDIER_TILE}}
| Caste
|
*'character' or tile number
| Caste-specific {{token|CREATURE_SOLDIER_TILE|c}}.

|-
| {{text anchor|CASTE_TILE}}
| Caste
|
* tile number or "letter"
| Caste-specific {{token|CREATURE_TILE|c}}.

|-
| {{text anchor|CAVE_ADAPT}}
| Caste
|
| Causes [[cave adaptation]].
Allows for creature's race to be involved in jokes that end in "And the [race] saw the sun and vomited on the spot!"

|-
| {{text anchor|CDI}}
| Caste
|
*Varies
| Specifies interaction details following a {{token|CAN_DO_INTERACTION|c}} token. See [[interaction token]].

|-
| {{text anchor|CHANGE_BODY_SIZE_PERC}}
| Caste
|
*integer
| Multiplies body size by a factor of (integer)%. 50 halves size, 200 doubles.

|-
| {{text anchor|CHANGE_FREQUENCY_PERC}}
| Creature
|
*integer
| Multiplies frequency by a factor of (integer)%.

|-
| {{text anchor|CHILD}}
| Caste
|
*integer
| Age at which creature is considered an adult - one can think of this as the duration of the [[children|child]] stage. Allows the creature's offspring to be rendered fully tame if [[animal trainer|trained]] during their childhood.

|-
| {{text anchor|CHILDNAME}}
| Caste
|
*singular
*plural
| Defines a new name for a creature in the child state at the caste level. For non-caste-specific child names, see {{token|GENERAL_CHILD_NAME|c}}.

|-
| {{text anchor|CLUSTER_NUMBER}}
| Creature
|
*min
*max
| The minimum/maximum numbers of how many creatures per spawned cluster. Vermin fish with this token in combination with temperate ocean and river biome tokens [http://www.bay12forums.com/smf/index.php?topic=51864.msg1122319#msg1122319 will perform seasonal migrations]. Defaults to 1:1 if not specified.

|-
| {{text anchor|CLUTCH_SIZE}}
| Caste
|
*min
*max
|Number of [[egg]]s laid in one sitting.

|-
| {{text anchor|COLONY_EXTERNAL}}
| Caste
|
| Caste hovers around colony.

|-
| {{text anchor|COLOR}}
| Creature
|
*foreground
*background
*brightness
| Color of the creature's tile. (See [[Color]] for usage.)

|-
| {{text anchor|COMMON_DOMESTIC}}
| Caste
|
| When combined with any of {{token|PET|c}}, {{token|PACK_ANIMAL|c}}, {{token|WAGON_PULLER|c}} and/or {{token|MOUNT|c}}, the creature is guaranteed to be domesticated by any [[civilization]] with {{token|COMMON_DOMESTIC_PET|e}}, {{token|COMMON_DOMESTIC_PACK|e}}, {{token|COMMON_DOMESTIC_PULL|e}} and/or {{token|COMMON_DOMESTIC_MOUNT|e}} respectively. Such civilizations will always have access to the creature, even in the absence of wild populations. This token is invalid on {{token|FANCIFUL|c}} creatures.

|-
| {{text anchor|CONVERTED_SPOUSE}}
| Caste
|
| Creatures of this caste's species with the {{token|SPOUSE_CONVERTER|c}} and {{token|NIGHT_CREATURE_HUNTER|c}} tokens will kidnap {{token|SPOUSE_CONVERSION_TARGET|c}}s of an appropriate sex and convert them into castes with CONVERTED_SPOUSE.

|-
| {{text anchor|COOKABLE_LIVE}}
| Caste
|
| Set this to allow the creature to be cooked in meals without first being butchered/cleaned. Used by some water-dwelling vermin such as [[mussel]]s, [[nautilus]]es and [[oyster]]s.

|-
| {{text anchor|CRAZED}}
| Caste
|
| Creature is '[[insanity|berserk]]' and will attack all other creatures, except members of its own species that '''also''' have the CRAZED tag. It will show {{DFtext|Berserk|4:1}} in the [[unit list]]. Berserk creatures go on rampages during [[world generation|worldgen]] much more frequently than non-berserk ones.

|-
| {{text anchor|COPY_TAGS_FROM}}
| Special
|
*creature ID
| Copies another specified creature. This will override any definitions made before it; essentially, it makes this creature identical to the other one, which can then be modified. Often used in combination with {{token|APPLY_CREATURE_VARIATION|c}} to import standard variations from a file. The vanilla [[giant animal]]s and [[animal person|animal people]]s are examples of this token combination.

|-
| {{text anchor|CREATURE}}
| Creature
|
*creature ID
| A unique, arbitrary identifier that begins the definition of each new creature, and is used to reference the creature in other tokens and raws.

|-
| {{text anchor|CREATURE_CLASS}}
| Caste
|
*classname
| An arbitrary creature classification. Can be set to anything, but the only vanilla uses are GENERAL_POISON (used in syndromes), EDIBLE_GROUND_BUG (used as targets for {{token|GOBBLE_VERMIN_CLASS|c}}), MAMMAL, and POISONOUS (both used for kobold pet eligibility). A single creature can have multiple classes.

The full list of tokens that use creature classes is:

* Creature tokens: {{token|GOBBLE_VERMIN_CLASS|c}}, {{token|GOBBLE_VERMIN_CLASS|c}}
* Interaction tokens: {{token|IT_AFFECTED_CLASS|in}}, {{token|IT_IMMUNE_CLASS|in}}
* Animal definition (Entity) tokens: {{token|ANIMAL_CLASS|e}}, {{token|ANIMAL_FORBIDDEN_CLASS|e}}
* Position (Entity) token: {{token|ALLOWED_CLASS|po}}
* Syndrome tokens: {{token|SYN_AFFECTED_CLASS|sy}}, {{token|SYN_IMMUNE_CLASS|sy}}, {{token|CE_SENSE_CREATURE_CLASS|sy}}
|-
| {{text anchor|CREATURE_SOLDIER_TILE}}
| Creature
|
*'character' or tile number
| Creatures active in their civilization's [[military]] will use this tile instead.

|-
| {{text anchor|CREATURE_TILE}}
| Creature
|
*'character' or tile number
| The symbol of the creature in ASCII mode.

|-
| {{text anchor|CREPUSCULAR}}
| Caste
|
| When set, the creature will appear at dawn (between 4:30 AM and 6:00 AM) and in the evening (between 8:00 PM and 10:05 PM) in [[Adventurer mode]].

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

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

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

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

|-
| {{text anchor|CV_REMOVE_TAG}}
| Special
|
*TAG NAME
| Removes a tag. Used in conjunction with creature variation templates.
|}

{{alphabetical TOC|style=margin: 1em auto;}}

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

|-
| {{text anchor|DEMON}}
| Caste
|
| Found on generated [[demon]]s. Marks the caste to be used in the initial wave after breaking into the [[underworld]], and by the demon civilizations created during world-gen breachings{{verify}}.

|-
| {{text anchor|DESCRIPTION}}
| Caste
|
*text
| A brief description of the creature type, as displayed when viewing the creature's description/[[Thoughts and preferences|thoughts & preferences]] screen.

|-
| {{text anchor|DIE_WHEN_VERMIN_BITE}}
| Caste
|
| Causes the creature to die upon attacking. Used by [[honey bee]]s to simulate them dying after using their stingers.

|-
| {{text anchor|DIFFICULTY}}
| Caste
|
*integer
| Increases experience gain during adventure mode. Creatures with a difficulty of 11 or higher are not assigned for quests in adventure mode.

|-
| {{text anchor|DIURNAL}}
| Caste
|
| When set, the creature will only appear during the day (between 6:00 AM and 8:00 PM) in [[Adventurer mode]].

|-
| {{text anchor|DIVE_HUNTS_VERMIN}}
| Caste
|
| The creature hunts vermin by diving from the air. On tame creatures, it has the same effect as {{token|HUNTS_VERMIN|c}}. Found on [[peregrine falcon]]s.

|-
| {{text anchor|DOES_NOT_EXIST}}
| Creature
|
| Adding this token to a creature prevents it from appearing in generated worlds (unless it's marked as [[Entity_token#ANIMAL_ALWAYS_PRESENT|always present]] for a particular civilisation). For example, adding it to [[dog]]s will lead to worlds being generated without dogs in them. Also removes the creature from the [[object testing arena]]'s spawn list. If combined with {{token|FANCIFUL|c}}, artistic depictions of the creature will occur regardless. Used by [[centaur]]s, [[chimera]]s and [[griffon]]s in the vanilla game.

Note: a creature tagged as DOES_NOT_EXIST can still be [[Interaction_token#I_EFFECT|summoned]] successfully, as long as it has a body defined in its raws [http://www.bay12forums.com/smf/index.php?topic=165213.msg8086938#msg8086938], or, another creature can[[Syndrome#CE_BODY_TRANSFORMATION|transform]] into it.
|}

{{alphabetical TOC|style=margin: 1em auto;}}

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

|-
| {{text anchor|EBO_ITEM}}
| Caste
|
*[[item token]]
*[[material token]] (ANY_HARD_STONE can be used for the material)
| Defines the item that the creature drops upon being [[butcher|butchered]]. Used with {{token|EXTRA_BUTCHER_OBJECT|c}}.

|-
| {{text anchor|EBO_SHAPE}}
| Caste
|
*gem shape
| The shape of the creature's extra [[butcher|butchering]] drop. Used with {{token|EXTRA_BUTCHER_OBJECT|c}}.

|-
| {{text anchor|EGG_MATERIAL}}
| Caste
|
* <[[material token]]>
* <[[Material_definition_token#Material_States|material state]]>
| Defines the material composition of [[egg]]s laid by the creature. [[creature_token#LAYS_EGGS|Egg-laying]] creatures in the default game define this 3 times, using LOCAL_CREATURE_MAT:EGGSHELL, LOCAL_CREATURE_MAT:EGG_WHITE, and then LOCAL_CREATURE_MAT:EGG_YOLK. Eggs will be made out of eggshell. Edibility is determined by tags on whites or yolk, but they otherwise do not exist.

|-
| {{text anchor|EGG_SIZE}}
| Caste
|
*size
| Determines the size of laid [[egg]]s. Doesn't affect hatching or cooking, but bigger eggs will be heavier, and may take longer to be hauled depending on the hauler's strength.

|-
| {{text anchor|EQUIPMENT_WAGON}}
| Creature
|
| Makes the creature appear as a large 3×3 [[wagon]] responsible for carrying trade goods, pulled by two {{token|WAGON_PULLER|c}} creatures and driven by a merchant.

|-
| {{text anchor|EQUIPS}}
| Caste
|
| Allows the creature to wear or wield items.

|-
| {{text anchor|EVIL}}
| Creature
|
| The creature is considered evil and will only show up in evil biomes. Civilizations with {{token|USE_EVIL_ANIMALS|e}} can domesticate them regardless of exotic status. Has no effect on cavern creatures except to restrict taming. A civilization with evil creatures can colonise evil areas.

|-
| {{text anchor|EXTRA_BUTCHER_OBJECT}}
| Caste
|
* [[Body token#CATEGORY|BY_CATEGORY]] or [[Body token#CONTYPE|BY_TYPE]] or [[Body token#BP|BY_TOKEN]]
* TYPE, CATEGORY, or TOKEN
| The creature drops an additional object when [[butcher|butchered]], as defined by {{token|EBO_ITEM|c}} and {{token|EBO_SHAPE|c}}. Used for [[gizzard stone]]s in default creatures. For some materials, needs to be defined after caste definitions with SELECT_CASTE:ALL{{Bug|6355}}

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

|-
| {{text anchor|EXTRAVISION}}
| Caste
|
| The creature can see regardless of whether it has working eyes and has full 360 degree vision, making it impossible to strike the creature from a blind spot in combat. Invisible creatures will also be seen, namely [[intelligent undead]] using a "vanish" power.
|}

{{alphabetical TOC|style=margin: 1em auto;}}

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

|-
| {{text anchor|FANCIFUL}}
| Creature
|
| The creature is a thing of legend and known to all civilizations. Its materials cannot be requested or preferred. The tag also adds some art value modifiers. Used by a [[Fanciful|number of creatures]]. Conflicts with {{token|COMMON_DOMESTIC|c}}.

|-
| {{text anchor|FEATURE_ATTACK_GROUP}}
| Caste
|
| Found on [[Animal people#Subterranean animal people|subterranean animal-man]] tribals. Currently defunct. In previous versions{{verify}}, it caused these creatures to crawl out of chasms and underground rivers.

|-
| {{text anchor|FEATURE_BEAST}}
| Caste
|
| Found on [[forgotten beast]]s. Presumably makes it act as such, initiating underground attacks on fortresses, or leads to the pop-up message upon encountering one{{verify}}. Hides the creature from displaying in a world_sites_and_pops file. Does not create historical figures like generated forgotten beasts do.

Requires specifying a {{token|BIOME|c}} in which the creature will live, and both surface and subterranean biomes are allowed. Does not stack with {{token|LARGE_ROAMING|c}} and if both are used the creature will not spawn. Appears to be incompatible with {{token|DEMON|c}} even if used in separate castes.

|-
| {{text anchor|FEMALE}}
| Caste
|
| Makes the creature biologically female, enabling her to [[Breeding|bear young]]. Usually specified inside a caste.

|-
| {{text anchor|FIREIMMUNE}}
| Caste
|
| Makes the creature immune to [[Interaction_token#FIREBALL|FIREBALL]] and [[Interaction_token#FIREJET|FIREJET]] attacks, and allows it to path through high temperature zones, like lava or fires. Does not, by itself, make the creature immune to the damaging effects of burning in [[fire]], and does not prevent general heat damage or melting on its own (this would require adjustments to be made to the creature's body [[Material_definition_token|materials]] - see the [[Dragon/raw|dragon raws]] for an example).

|-
| {{text anchor|FIREIMMUNE_SUPER}}
| Caste
|
| Like {{token|FIREIMMUNE|c}}, but also renders the creature immune to [[Interaction_token#DRAGONFIRE|DRAGONFIRE]] attacks.

|-
| {{text anchor|FISHITEM}}
| Caste
|
| The creature's corpse is a single [[Item_token#FISH_RAW|FISH_RAW]] food item that needs to be cleaned (into a [[Item_token#FISH|FISH]] item) at a [[fishery]] to become edible. Before being cleaned the item is referred to as "raw". The food item is categorized under "fish" on the food and stocks screens, and when uncleaned it is sorted under "raw fish" in the stocks (but does not show up on the food screen).
Without this or {{token|COOKABLE_LIVE|c}}, [[fishing|fished]] vermin will turn into food the same way as non-vermin creatures, resulting in multiple units of food (meat, brain, lungs, eyes, spleen etc.) from a single fished vermin. These units of food are categorized as meat by the game.

|-
| {{text anchor|FIXED_TEMP}}
| Caste
|
*temperature
| The creature's body is constantly at this temperature, heating up or cooling the surrounding area. Alters the temperature of the creature's inventory and all adjacent tiles, [[Temperature|with all the effects that this implies]] - may trigger wildfires at high enough values. Also makes the creature immune to extreme heat or cold, as long as the temperature set is not harmful to the materials that the creature is made from. Corpses and body parts of creatures with a fixed temperature maintain their temperature even after death.

Note that temperatures of 12000 and higher may cause [[path|pathfinding]] issues in fortress mode.

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

|-
| {{text anchor|FLIER}}
| Caste
|
| Allows a creature to fly, independent of it having wings or not. Fortress Mode pathfinding only partially incorporates flying - flying creatures need a land path to exist between them and an area in order to access it, but as long as one such path exists, they do not need to use it, instead being able to fly over intervening obstacles. Winged creatures with this token can lose their ability to fly if their wings are crippled or severed. Winged creatures without this token will be unable to fly. (A 'wing' in this context refers to any body part with its own [[Body_token#FLIER|FLIER]] token).

|-
| {{text anchor|FREQUENCY}}
| Creature
|
*number, max 100
| Determines the chances of a creature appearing within its environment, with higher values resulting in more frequent appearance. Also affects the chance of a creature being brought in a caravan for trading.
This value is used multiply to determine the rarity of animal populations. A creature with [FREQUENCY:50] will appear in 50% of valid biomes, and be present in 50% of the area within those biomes.
When a [[Creature token#CLUSTER_NUMBER|cluster]] spawns, the game effectively considers all creatures that can possibly appear and uses the FREQUENCY value as a ''weight'' - for example, if there are three creatures with frequencies 10/25/50, the creature with [FREQUENCY:50] will appear approximately 58.8% of the time. Defaults to 50 if not specified. Not to be confused with {{token|POP_RATIO|c}}.
|}

{{alphabetical TOC|style=margin: 1em auto;}}

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

|-
| {{text anchor|GAIT}}
| Caste
|
* <gait type>
* <gait name>
* <max [[Gait#Speed|speed]]>
* <build up time>
* <max turning [[Gait#Speed|speed]]>
* <start [[Gait#Speed|speed]]>
* <energy expenditure>
* <gait flag(s)>
| Defines a gait by which the creature can move. See [[Gait]] for more information. Specifically, you likely want to use one of the existing STANDARD_X_GAITS creature variations, as described in [[Gait#Gaits_and_Modding|this subsection]].

* <max speed> indicates the maximum [[Gait#Speed|speed]] achievable by a creature using this gait
* <start speed> indicates the creature's speed when it starts moving using this gait
* <build up time> indicates how long it will take for a creature using this gait to go from <start speed> to <max speed>. For example, a value of 10 means that it should be able to reach the maximum speed by moving 10 [[tile]]s in a straight line over even terrain.
* <max turning speed> indicates the maximum speed permissible when the creature suddenly changes its direction of motion. The creature's speed will be reduced to <max turning speed> if travelling at a higher speed than this before turning.
* <energy expenditure> indicates how energy-consuming the gait is. Higher values cause the creature to tire out faster. Persistent usage of a high-intensity gait will eventually lead to exhaustion and [[Status_icon#Non-flashing|collapse]].

'''NO_BUILD_UP''' can be specified instead of a <start speed> value to make the <max speed> instantly achievable upon initiating movement (this is equivalent to a <build up time> of 0). Note that <build up time> and <max turning speed> are both ignored if specified alongside this (as NO_BUILD_UP trumps <build up time> and preserves <max speed> whilst turning, and <max turning speed> cannot exceed <max speed>) so it is permissible to omit them so long as they are '''both''' omitted together.

It's possible to specify a <start speed> greater than the <max speed>; the moving creature will decelerate towards its <max speed> in this case.

'''valid gait types:'''
*'''WALK''' 
Used for moving normally over ground tiles.

*'''CRAWL''' 
Used for moving over ground tiles whilst [[Status_icon#Non-flashing|prone]].

*'''SWIM''' 
Used for moving through tiles containing [[water]] or [[magma]] at a [[Water#Depth|depth]] of at least 4/7.

*'''FLY''' 
Used for moving through [[open space]].

*'''CLIMB''' 
Used for moving whilst [[Climber|climbing]].

'''valid gait flags:'''
* '''AGILITY''' 
Speeds/slows movement depending on the creature's [[Attribute#Agility|Agility]] stat.

* '''STRENGTH''' 
Speeds/slows movement depending on the creature's [[Attribute#Strength|Strength]] stat.

* '''LAYERS_SLOW''' 
Makes [[Tissue_definition_token#THICKENS_ON_ENERGY_STORAGE|THICKENS_ON_ENERGY_STORAGE]] and [[Tissue_definition_token#THICKENS_ON_STRENGTH|THICKENS_ON_STRENGTH]] tissue layers slow movement depending on how thick they are. Adding the STRENGTH gait flag counteracts the impact of the latter layer.

* '''STEALTH_SLOWS:'''<percentage> 
Slows movement by the specified percentage when the creature is [[Ambusher|sneaking]].

|-
| {{text anchor|GENERAL_BABY_NAME}}
| Creature
|
*singular
*plural
| Like {{token|BABYNAME|c}}, but applied regardless of caste.

|-
| {{text anchor|GENERAL_CHILD_NAME}}
| Creature
|
*singular
*plural
| Like {{token|CHILDNAME|c}}, but applied regardless of caste.

|-
| {{text anchor|GENERAL_MATERIAL_FORCE_MULTIPLIER}}
| Caste
|
*value A
*value B
| Has the same function as {{token|MATERIAL_FORCE_MULTIPLIER|c}}, but applies to all attacks instead of just those involving a specific material. Appears to be overridden by MATERIAL_FORCE_MULTIPLIER ([[werebeast]]s, for example, use both tokens to provide resistance to all materials, with one exception to which they are especially vulnerable).

|-
| {{text anchor|GENERATED}}
| Creature
|
| Found on procedurally generated creatures like [[forgotten beast]]s, [[titan]]s, [[demon]]s, [[angel]]s, and [[night creature]]s. Cannot be specified in user-defined raws.

|-
| {{text anchor|GETS_INFECTIONS_FROM_ROT}}
| Caste
|
| Makes the creature get [[Health_care#Infection|infections]] from necrotic tissue.

|-
| {{text anchor|GETS_WOUND_INFECTIONS}}
| Caste
|
| Makes the creature's wounds become [[Health_care#Infection|infected]] if left untreated for too long.

|-
| {{text anchor|GLOWCOLOR}}
| Creature
|
*foreground
*background
*brightness
| The colour of the creature's {{token|GLOWTILE|c}}.

|-
| {{text anchor|GLOWTILE}}
| Creature
|
*ascii character
| If present, the being glows in the dark (generally used for Adventurer 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 {{token|CASTE_GLOWTILE|c}} instead.

|-
| {{text anchor|GNAWER}}
| Caste
|
*verb
| The creature can and will gnaw its way out of [[animal trap]]s and [[cage]]s using the specified verb, depending on the material from which it is made (normally wood).

|-
| {{text anchor|GOBBLE_VERMIN_CLASS}}
| Caste
|
*class
| The creature eats vermin of the specified class.

|-
| {{text anchor|GOBBLE_VERMIN_CREATURE}}
| Caste
|
*creature
*caste
| The creature eats a specified [[vermin]].

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

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

|-
| {{text anchor|GO_TO_TAG}}
| Special
|
| When using tags from an existing creature, inserts new tags ''before'' the specified tag.

|-
| {{text anchor|GOOD}}
| Creature
|
| Creature is considered good and will only show up in good biomes - [[unicorn]]s, for example. Civilizations with {{token|USE_GOOD_ANIMALS|e}} can domesticate them regardless of exotic status. Has no effect on cavern creatures except to restrict taming. A civilization that has good creatures can colonise good areas in world-gen.

|-
| {{text anchor|GRASSTRAMPLE}}
| Caste
|
*value
| The value determines how rapidly [[grass]] is trampled when a creature steps on it - a value of 0 causes the creature to never damage grass, while a value of 100 causes grass to be trampled as rapidly as possible. Defaults to 5.

|-
| {{text anchor|GRAVITATE_BODY_SIZE}}
| Caste
|
*target value
| Used in Creature Variants. This token changes the adult body size to the average of the old adult body size and the target value and scales all intermediate growth stages by the same factor.

|-
| {{text anchor|GRAZER}}
| Caste
|
*number
| The creature is a grazer - if tamed in fortress mode, it needs a pasture to survive. The higher the number, the less frequently it needs to eat in order to live. Not used since 0.40.12, replaced by {{token|STANDARD_GRAZER|c}} to fix {{bugl|4113}}.
|}

{{alphabetical TOC|style=margin: 1em auto;}}

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

|-
| {{text anchor|HABIT}}
| Caste
|
*type
*probability
| Defines certain behaviors for the creature. The habit types are:
*COLLECT_TROPHIES
*COOK_PEOPLE
*COOK_VERMIN
*GRIND_VERMIN
*COOK_BLOOD
*GRIND_BONE_MEAL
*EAT_BONE_PORRIDGE
*USE_ANY_MELEE_WEAPON
*GIANT_NEST
*COLLECT_WEALTH.
These require the creature to have a {{token|LAIR|c}} to work properly, and also don't seem to work on creatures who are not a {{token|SEMIMEGABEAST|c}}, {{token|MEGABEAST|c}}, or{{token|NIGHT_CREATURE_HUNTER|c}}.

|-
| {{text anchor|HABIT_NUM}}
| Caste
|
*number or TEST_ALL
| "If you set HABIT_NUM to a number, it should give you that exact number of habits according to the weights.".{{cite forum|60554/1719248}} All lists of HABITs are preceded by [HABIT_NUM:TEST_ALL]

|-
| {{text anchor|HAS_NERVES}}
| Caste
|
| The creature has nerves in its muscles. Cutting the muscle tissue can sever motor and sensory nerves.

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

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

|-
| {{text anchor|HOMEOTHERM}}
| Caste
|
*number or NONE
| Default 'NONE'. The creature's normal body [[temperature]]. Creature ceases maintaining temperature on death unlike fixed material temperatures. Provides minor protection from environmental temperature to the creature.

|-
| {{text anchor|HUNTS_VERMIN}}
| Caste
|
| Creature hunts and kills nearby [[vermin]], randomly walking between places with food laying on the ground or in stockpiles, to check for possible [VERMIN_EATER] vermin, but they'll kill any other vermin too. Do not include this creature token on an intelligent entity that you intend to play as in fortress mode because it will prevent them from feeding themselves.

|}

{{alphabetical TOC|style=margin: 1em auto;}}

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

|-
| {{text anchor|IMMOBILE}}
| Caste
|
| The creature cannot move. Found on [[sponge]]s. Will also stop a creature from breeding in fortress mode (MALE and FEMALE are affected, if one is IMMOBILE; no breeding will happen).

|-
| {{text anchor|IMMOBILE_LAND}}
| Caste
|
| The creature is immobile while on land. Only works on {{token|AQUATIC|c}} creatures which can't breathe on land.

|-
| {{text anchor|IMMOLATE}}
| Caste
|
| The creature radiates [[fire]]. It will ignite, and potentially completely destroy, items the creature is standing on. Also gives the vermin a high chance of escaping from [[animal trap]]s and [[cage]]s made of any flammable materials (specifically ones that could be ignited by magma).

|-
| {{text anchor|INTELLIGENT}}
| Caste
|
| Alias for {{token|CAN_SPEAK|c}} + {{token|CAN_LEARN|c}}.

|-
| {{text anchor|ITEMCORPSE}}
| Caste
|
* [[item token]]
* [[material token]]
| Determines if the creature leaves behind a non-standard corpse (i.e. wood, statue, bars, stone, pool of liquid, etc.). [[Ethics]] may prevent actually using the item in jobs or reactions.

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

{{alphabetical TOC|style=margin: 1em auto;}}

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

|-
| {{text anchor|LAIR}}
| Caste
|
*type
*probability
| Found on megabeasts, semimegabeasts, and night creatures. The creature will seek out sites of this type and take them as lairs. The lair types are:
*SIMPLE_BURROW
*SIMPLE_MOUND
*WILDERNESS_LOCATION
*SHRINE
*LABYRINTH

|-
| {{text anchor|LAIR_CHARACTERISTIC}}
| Caste
|
*characteristic
*probability
| Defines certain features of the creature's lair. The only valid characteristic is HAS_DOORS.

|-
| {{text anchor|LAIR_HUNTER}}
| Caste
|
| This creature will actively hunt adventurers in its lair.

|-
| {{text anchor|LAIR_HUNTER_SPEECH}}
| Caste
|
*speech file
| What this creature says while hunting adventurers in its lair.

|-
| {{text anchor|LARGE_PREDATOR}}
| Caste
|
| Will attack other creatures that are smaller than it. Tamed large predators will still attack wildlife. In [[fortress mode]], only one group of "large predators" (possibly two groups on "savage" maps) will appear on any given map. In [[adventurer mode]], large predators will try to ambush and attack you (and your party will attack them back). When tamed, large predators tend to be much more aggressive to enemies than non-large predators, making them a good choice for an animal army. They may go on rampages in worldgen, and adventurers may receive quests to kill them. Also, they can be mentioned in the intro paragraph when starting a fortress e.g. "ere the wolves get hungry."
A single biome supports 7 large predator species, picking randomly and rolling a d100 under its {{token|FREQUENCY|c}} to add it until all 7 slots are filled.

Incompatible with {{token|PACK_ANIMAL|c}} on a technicality, if included: hauled items are likely to be dropped upon entering the map (even if {{token|TRADE_CAPACITY|c}} is present) in contrast to when the merchants depart.

|-
| {{text anchor|LARGE_ROAMING}}
| Creature
|
| This is the core requisite tag allowing the creature to spawn as a wild animal in the appropriate biomes. Requires specifying a {{token|BIOME|c}} in which the creature will spawn. Does not require specifying a frequency, population number, or cluster number.

This tag stacks with {{token|MEGABEAST|c}}, {{token|SEMIMEGABEAST|c}}, or {{token|NIGHT_CREATURE_HUNTER|c}}; if used with one of these tags, the creature will spawn as both a boss and as a wild animal. This tag does not stack with {{token|FEATURE_BEAST|c}} and if both are used the creature will not spawn. This tag is unaffected by {{token|DEMON|c}}.

|-
| {{text anchor|LAYS_EGGS}}
| Caste
|
| Creature lays [[egg]]s instead of giving birth to live young.

|-
| {{text anchor|LAYS_UNUSUAL_EGGS}}
| Caste
|
* [[item token]]
* [[material token]]
| Creature lays the specified item instead of regular eggs.

|-
| {{text anchor|LIGAMENTS}}
| Caste
|
* [[material token]]
*healing rate
| The creature has ligaments in its {{token|CONNECTIVE_TISSUE_ANCHOR|td}} tissues (bone or chitin by default). Cutting the bone/chitin tissue severs the ligaments, disabling motor function if the target is a limb.

|-
| {{text anchor|LIGHT_GEN}}
| Caste
|
| A vermin featuring this tag will remain visible to an adventurer even at night.

Subterranean vermin which feature this token will flicker in unexposed and unrevealed cavern layers while playing in Fortress Mode.

|-
| {{text anchor|LIKES_FIGHTING}}
| Caste
|
| The creature will attack enemies rather than flee from them. This tag has the same effect on player-controlled creatures - including modded dwarves. Retired as of v0.40.14 in favor of {{token|LARGE_PREDATOR|c}}.

|-
| {{text anchor|LISP}}
| Caste
|
| Creature uses "sssssnake talk" (multiplies 'S' when talking - "My name isss Recisssiz."). Used by [[Serpent man|serpent men]] and [[Reptile man|reptile men]] in the vanilla game. C's with the same pronunciation (depending on the word) are not affected by this token.

|-
| {{text anchor|LITTERSIZE}}
| Caste
|
* minimum
* maximum
| Determines the number of offspring per one birth; default 1-3, not used in vanilla raws. See also {{token|MULTIPLE_LITTER_RARE|c}}.

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

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

|-
| {{text anchor|LOCKPICKER}}
| Caste
|
| Lets a creature open [[door]]s that are set to forbidden in fortress mode.

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

|-
| {{text anchor|LOW_LIGHT_VISION}}
| Caste
|
*number
| Determines how well a creature can see in the dark - higher is better. Dwarves have 10000, which amounts to perfect nightvision.
|}

{{alphabetical TOC|style=margin: 1em auto;}}

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

|-
| {{text anchor|MAGICAL}}
| Caste
|
| According to Toady One, this is completely interchangeable with {{token|AT_PEACE_WITH_WILDLIFE|c}} and might have been used in very early versions of the game by wandering wizards or the ent-type tree creatures that used to be animated by elves. [http://www.bay12forums.com/smf/index.php?topic=169696.msg8316954#msg8316954]

|-
| {{text anchor|MAGMA_VISION}}
| Caste
|
| The creature is able to see while submerged in [[magma]].

|-
| {{text anchor|MALE}}
| Caste
|
| Makes the creature biologically male. Usually declared inside a caste.

|-
| {{text anchor|MANNERISM|MANNERISM_*}}
| Caste
|
*occasionally body part
| Adds a possible mannerism to the creature's profile. See [[creature mannerism token]] for further info.

|-
| {{text anchor|MATERIAL}}
| Creature
|
*material id
| Begins defining a new local material. Follow this with standard material definition tokens to define the material.

|-
| {{text anchor|MATERIAL_FORCE_MULTIPLIER}}
| Caste
|
*[[Material token]]
*value A
*value B
| When struck with a weapon made of the specified material, the force exerted will be multiplied by A/B, thus making the creature more or less susceptible to this material. For example, if A is 2 and B is 1, the force exerted by the defined material will be doubled. If A is 1 and B is 2, it will be halved instead. See also {{token|GENERAL_MATERIAL_FORCE_MULTIPLIER|c}}, which can be used to make this sort of effect applicable to all materials.

|-
| {{text anchor|MATUTINAL}}
| Caste
|
| When set, the creature will only appear at dawn (between 4:30 AM and 6:00 AM) in [[Adventurer mode]].

|-
| {{text anchor|MAXAGE}}
| Caste
|
*min
*max
| Determines the creature's natural lifespan, using the specified minimum and maximum age values (in years). Each individual creature with this token is generated with a predetermined date (calculated down to the exact [[time|tick]]!) between these values, at which it is destined to die of old age, should it live long enough. Note that the probability of death at any given age does not increase as the creature gets older [http://i.imgur.com/A1A4aA9.png].
Creatures which lack this token are naturally immortal. The [[Syndrome#CE_ADD_TAG|NO_AGING]] syndrome tag will prevent death by old age from occurring. Also note that, among civilized creatures, castes which lack this token will refuse to marry others with it, and vice versa.

|-
| {{text anchor|MEANDERER}}
| Caste
|
| Makes the creature slowly stroll around, unless it's in combat or performing a job. If combined with {{token|CAN_LEARN|c}}, will severely impact their [[pathfinding]] and lead the creature to move extremely slowly when not performing any task. Problematically applies to animal people based on the animal and war trained animals{{bug|9588}}.

|-
| {{text anchor|MEGABEAST}}
| Caste
|
| A 'boss' creature. A small number of the creatures are created during worldgen, their histories and descendants (if any) will be tracked in worldgen (as opposed to simply 'spawning'), and they will occasionally go on rampages, potentially leading to worship if they attack the same place multiple times. Their presence and number will also influence age names. When appearing in fortress mode, they will have a pop-up message announcing their arrival. They will remain hostile to military even after being tamed.{{bug|10731}} See [[megabeast]] page for more details.

Requires specifying a {{token|BIOME|c}} in which the creature will live. Subterranean biomes appear to not be allowed. Does stack with {{token|LARGE_ROAMING|c}} and if both are used the creature will spawn as both historical bosses and as wild animals.

|-
| {{text anchor|MENT_ATT_CAP_PERC}}
| Caste
|
*[[Attribute|ATTRIBUTE]] Token
*Cap %
|Default is 200. This means you can increase your attribute to 200% of its starting value (or the average value + your starting value if that is higher).

|-
| {{text anchor|MENT_ATT_RANGE}}
| Caste
|
*[[Attribute|ATTRIBUTE]]
*lowest
*lower
*low
*median
*high
*higher
*highest
| Sets up a [[Attribute#Soul_attributes|mental attribute]]'s range of values (0-5000). All mental attribute ranges default to 200:800:900:1000:1100:1300:2000.

|-
| {{text anchor|MENT_ATT_RATES}}
| Caste
|
*[[Attribute|ATTRIBUTE]] Token
*cost to improve
*unused counter rate
*rust counter rate
*demotion counter rate
| [[Attribute#Soul_attributes|Mental attribute]] gain/decay rates. Lower numbers in the last three slots make decay occur faster. Defaults are 500:4:5:4.

|-
| {{text anchor|MILKABLE}}
| Caste
|
* [[material token]]
* frequency
| Allows the creature to be [[milk]]ed in the [[farmer's workshop]]. The frequency is the amount of [[time|ticks]] the creature needs to "recharge" (i.e. how much time needs to pass before it can be milked again). Does not work on [[#CAN_LEARN|sentient]] creatures, regardless of [[ethics]].

|-
| {{text anchor|MISCHIEVIOUS}}
| Caste
|
| Alias for {{token|MISCHIEVOUS|c}}.

|-
| {{text anchor|MISCHIEVOUS}}
| Caste
|
| The creature spawns [[stealth]]ed and will attempt to path into the fortress, pulling any [[lever]]s it comes across. It will be invisible on the map and [[unit list]] until spotted by a citizen, at which point the game will pause and recenter on the creature. Used by [[gremlin]]s in the vanilla game. "They go on little missions to mess with various fortress buildings, not just levers."

|-
| {{text anchor|MODVALUE}}
| Caste
|
| Seemingly no longer used.

|-
| {{text anchor|MOUNT}}
| Caste
|
| Creature may be used as a [[mount]]. No use for the player in fortress mode, but enemy sieging forces may arrive with cavalry. Mounts are usable in adventure mode.

|-
| {{text anchor|MOUNT_EXOTIC}}
| Caste
|
| Creature may be used as a [[mount]], but civilizations cannot domesticate it in worldgen without certain exceptions.

|-
| {{text anchor|MULTIPART_FULL_VISION}}
| Caste
|
| Allows the creature to have all-around vision, as long as it has multiple heads that can see.

|-
| {{text anchor|MULTIPLE_LITTER_RARE}}
| Caste
|
| Makes the species usually produce a single offspring per birth, with a 1/500 chance of using the {{token|LITTERSIZE|c}} as usual. Requires {{token|FEMALE|c}}.

|-
| {{text anchor|MUNDANE}}
| Creature
|
| Marks if the creature is an actual real-life creature. Only used for age-names at present.
|}

{{alphabetical TOC|style=margin: 1em auto;}}

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

|-
| {{text anchor|NAME}}
| Creature
|
*singular
*plural
*adjective
| The generic name for any creature of this type - will be used for referring to the species in the abstract, such as the default material prefix. For labeling individual creatures, {{token|CASTE_NAME|c}} is necessary. If left undefined, the creature will be labeled as "nothing" by the game.

Some examples of adjective use:
* "super''dwarven'' strength"
* "the ''dwarven'' hillocks of X"
* Deity species as in "''feline'' deity"
* Megabeast attacks in worldgen. One with multiple dragons being a "''draconic'' rampage"

|-
| {{text anchor|NATURAL}}
| Caste
|
| Animal is considered to be natural. NATURAL animals will not engage creatures tagged with {{token|AT_PEACE_WITH_WILDLIFE|c}} in combat unless they are members of a hostile entity and vice-versa.

|-
| {{text anchor|NATURAL_ANIMAL}}
| Caste
|
| Alias of {{token|NATURAL|c}}.

|-
| {{text anchor|NATURAL_SKILL}}
| Caste
|
*[[Skill_token|Skill token]]
*value
| The creature possesses the specified [[skill]] at this level inherently - that is, it begins with the skill at this level, and the skill may never rust below that. A value of 15 is legendary.

|-
| {{text anchor|NIGHT_CREATURE}}
| Caste
|
| Creatures with this token can appear as [[experiment|experiments]]. Causes the creature to count as {{token|NOT_LIVING|c}}. Killing a creature featuring this token provides one point of "hero" reputation. Adds the creature's description as part of the initial summary of their historical figure in legends mode. People will react to creatures with this token as a night creature (natch). In adventure mode, ambushes involving these units will say "Night creature!" instead of "Ambush!"

Prevents creature behavior enabled by {{token|LARGE_PREDATOR|c}}

Prevents the AI from using ANIMATE interactions, unless the newly-animated{{token|OPPOSED_TO_LIFE|c}}undead will not attack them. The check for this is specifically whether the unit is:
*a ghost
*an animated unit
*a unit with the {{token|NO_AGING|c}} token added via {{token|CE_ADD_TAG|c}}. (This allows for the default exclusion of elves and goblins, unless raised as intelligent undead.)

''This token should not be confused with other NIGHT_CREATURE_X tokens.''
''This token is not well understood at the present time.''

|-
| {{text anchor|NIGHT_CREATURE_BOGEYMAN}}
| Caste
|
| Creatures with this token can appear in [[bogeyman|bogeyman ambushes]] in [[adventure mode]], where they adopt classical bogeyman traits such as stalking the adventurer and vaporising when dawn breaks. Such traits do not manifest if the creature is encountered outside of a bogeyman ambush (for instance, as a megabeast or a civilised being). In addition, their corpses and severed body parts turn into [[smoke]] after a short while. Note that setting the "Number of Bogeyman Types" in [[advanced world generation]] to 0 will only remove randomly-generated bogeymen.

|-
| {{text anchor|NIGHT_CREATURE_EXPERIMENTER}}
| Caste
|
| Found on some [[necromancer]]s. Creatures with this tag may periodically "perform horrible experiments" offscreen, during which they can use creature-targeting interactions with an <code>[[Interaction_token#I_SOURCE|[I_SOURCE:EXPERIMENT]]]</code> tag on living creatures in their area. Worlds are generated with a list of procedurally-generated experiments, allowing necromancers to turn living people and animals into [[Infected_ghoul|ghouls]] and [[Experiment|other experimental creatures]], and these will automatically be available to all experimenters; it does not appear possible to prevent this. You can mod in your own custom experiment interactions, but these are used very infrequently due to the large number of generated experiments.

|-
| {{text anchor|NIGHT_CREATURE_HUNTER}}
| Caste
|
| Found on [[night troll]]s and [[werebeast]]s. Implies that the creature is a [[night creature]], and shows its description in [[legends mode]] entry. The creature is always hostile and will start [[no quarter]] combat with any nearby creatures, except for members of its own race. Note that this tag does not override the creature's normal behavior in [[fortress mode]] except for the aforementioned aggression, and doesn't prevent the creature from fleeing the battles it started. It also removes the creature's materials from stockpile settings list, making them be stored there regardless of settings.

Does stack with {{token|LARGE_ROAMING|c}} and if both are used the creature will spawn as both historical hunters and as wild animals; this requires specifying a {{token|BIOME|c}} in which the creature will live, and subterranean biomes are allowed.

This tag causes the usual behaviour of werebeasts in worldgen, that is, fleeing towns upon being cursed and conducting raids from a lair. If this tag is absent from a deity curse, the accursed will simply be driven out of towns in a similar manner to [[vampire]]s. When paired with SPOUSE_CONVERTER, a very small population of the creature will be created during worldgen (sometimes only a single individual will be created), and their histories will be tracked (that is, they will not spawn spontaneously later, they must either have children or convert other creatures to increase their numbers). The creature will settle in a lair and go on rampages during worldgen. It will actively attempt to seek out potential conversion targets to abduct, convert, and have children with (if possible).

|-
| {{text anchor|NIGHT_CREATURE_NIGHTMARE}}
| Caste
|
| Found on [[nightmare]]s. Corpses and severed body parts derived from creatures with this token turn into [[smoke]] after a short while.

|-
| {{text anchor|NO_AUTUMN}}
| Caste
|
| The creature caste does not appear in [[Calendar|autumn]].

|-
| {{text anchor|NO_CONNECTIONS_FOR_MOVEMENT}}
| Caste
|
| Creature doesn't require connected body parts to move{{verify}}; generally used on undead creatures with connections that have rotted away.

|-
| {{text anchor|NO_DIZZINESS}}
| Caste
|
| Creature cannot become [[Symptom#Dizziness|dizzy]].

|-
| {{text anchor|NO_DRINK}}
| Caste
|
| Creature does not need to drink.

|-
| {{text anchor|NO_EAT}}
| Caste
|
| Creature does not need to [[food|eat]].

|-
| {{text anchor|NO_FEVERS}}
| Caste
|
| Creature cannot suffer [[Symptom#Fever|fevers]].

|-
| {{text anchor|NO_GENDER}}
| Caste
|
| The creature is biologically sexless, making it unable to [[breeding|breed]].

|-
| {{text anchor|NO_PHYS_ATT_GAIN}}
| Caste
|
| The creature cannot raise any [[Attribute#Body_attributes|physical attributes]].

|-
| {{text anchor|NO_PHYS_ATT_RUST}}
| Caste
|
| The creature cannot lose any [[Attribute#Body_attributes|physical attributes]].

|-
| {{text anchor|NO_SLEEP}}
| Caste
|
| Creature does not need to sleep, but can still be rendered unconscious by other means.

|-
| {{text anchor|NO_SPRING}}
| Caste
|
| The creature caste does not appear in [[Calendar|spring]].

|-
| {{text anchor|NO_SUMMER}}
| Caste
|
| The creature caste does not appear in [[Calendar|summer]].

|-
| {{text anchor|NO_THOUGHT_CENTER_FOR_MOVEMENT}}
| Caste
|
| The bodyparts of this creature don't need to be connected to an organ with the {{token|THOUGHT|body}} tag in order to have motor function. Generally used on creatures that don't have brains. If a creature doesn't have a thought part and doesn't have this token, it will be unable to grasp or stand. Nautilus men experience this issue in vanilla.

|-
| {{text anchor|NO_UNIT_TYPE_COLOR}}
| Caste
|
| Prevents creature from selecting its color based on its profession (e.g. Miner, Hunter, Wrestler).

|-
| {{text anchor|NO_VEGETATION_PERTURB}}
| Caste{{Verify}}
|
| Likely prevents the creature from leaving broken vegetation tracks.{{Verify}}

|-
| {{text anchor|NO_WINTER}}
| Caste
|
| The creature caste does not appear in [[Calendar|winter]].

|-
| {{text anchor|NOBONES}}
| Caste
|
| Creature has no bones.

|-
| {{text anchor|NOBREATHE}}
| Caste
|
| Creature doesn't need to breathe or have {{token|BREATHE|body}}parts in its body, nor can it drown or be strangled. Creatures living in magma must have this tag, otherwise they will drown.

|-
| {{text anchor|NOCTURNAL}}
| Caste
|
| When set, the creature will only appear at night (after 10:05 PM and before 4:30 AM) in [[Adventurer mode]].

|-
| {{text anchor|NOEMOTION}}
| Caste
|
| Creature has no emotions, thus; it is immune to the effects of [[stress]] and unable to rage, and its [[need]]s cannot be fulfilled in any way. Used on [[undead]] in the vanilla game.

|-
| {{text anchor|NOEXERT}}
| Caste
|
| Creature can't become tired or over-exerted from taking too many combat actions, or moving at full speed for extended periods of time.

|-
| {{text anchor|NOFEAR}}
| Caste
|
| Creature doesn't feel fear and will never flee from battle, and will be immune to [[ghost]]s' attempts to 'scare it to death'. Additionally, it causes [[bogeyman|bogeymen]] and [[nightmare]]s to become friendly towards the creature.

|-
| {{text anchor|NOMEAT}}
| Caste
|
| Creature will not be hunted or fed to wild beasts.

|-
| {{text anchor|NONAUSEA}}
| Caste
|
| Creature isn't nauseated by gut hits and cannot vomit.

|-
| {{text anchor|NOPAIN}}
| Caste
|
| Creature doesn't feel pain.

|-
| {{text anchor|NOSKIN}}
| Caste
|
| Creature will not drop a hide when [[butcher|butchered]].

|-
| {{text anchor|NOSKULL}}
| Caste
|
| Creature will not drop a skull on butchering, rot, or decay of severed head.

|-
| {{text anchor|NOSMELLYROT}}
| Caste
|
| Does not produce [[miasma]] when rotting.

|-
| {{text anchor|NOSTUCKINS}}
| Caste
|
| Weapons can't get stuck in the creature.

|-
| {{text anchor|NOSTUN}}
| Caste
|
| Creature can't be stunned and knocked unconscious by pain or head injuries. Creatures with this tag never wake up from sleep in Fortress Mode. If this creature needs to sleep while playing, it will die.

|-
| {{text anchor|NOT_BUTCHERABLE}}
| Caste
|
| Corpses from this creature cannot be [[butcher|butchered]]. Does not prevent the creature from being slaughtered while alive, however.

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

|-
| {{text anchor|NOTHOUGHT}}
| Caste
|
| Creature doesn't require a {{token|THOUGHT|body}} body part to survive. Has the added effect of preventing speech, though directly controlling creatures that would otherwise be capable of speaking allows them to engage in conversation.
|}

{{alphabetical TOC|style=margin: 1em auto;}}

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

|-
| {{text anchor|ODOR_LEVEL}}
| Caste
|
*number
| How easy the creature is to [[smell]]. The higher the number, the easier the creature is to sniff out. Defaults to 50. Vanilla creatures have values from 0 (undetectable) to 90 (noticeable by humans and dwarves).

|-
| {{text anchor|ODOR_STRING}}
| Caste
|
*string
| What the creature [[smell]]s like. If no odor string is defined, the creature name (not the caste name) is used.

|-
| {{text anchor|OPPOSED_TO_LIFE}}
| Caste
|
| Is hostile to all creatures except undead and other non-living ones and will show {{DFtext|Opposed to life|0:1}} in the [[unit list]]. Used by [[undead]] in the vanilla game. Functions without the {{token|NOT_LIVING|c}} token, and seems to imply said token as well. Undead will not be hostile to otherwise-living creatures given this token. Living creatures given this token will attack living creatures that lack it, while ignoring other living creatures that also have this token.

|-
| {{text anchor|ORIENTATION}}
| Caste
|
*MALE/FEMALE
*disinterested chance
*casual chance
*strong chance
| Determines caste's likelihood of having sexual attraction to certain sexes. Values default to 75:20:5 for the same sex and 5:20:75 for the opposite sex. The first value indicates how likely to be entirely uninterested in the sex, the second decides if the creature will be able to become lovers with that sex, the third decides whether they will be able to marry in worldgen and post-worldgen world activities (which implies being able to become lovers). Marriage seems to be able to happen in fort mode play regardless, as long as they are lovers first.

|-
| {{text anchor|OUTSIDER_CONTROLLABLE}}
| Caste
|
| Lets you play as an [[Adventurer_mode_character_creation#Outsider|outsider]] of this species in adventure mode.

|}

{{alphabetical TOC|style=margin: 1em auto;}}

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

|-
| {{text anchor|PACK_ANIMAL}}
| Caste
|
| Allows the creature to be used as a pack animal. Used by [[trading|merchants]] without wagons and adventurers. Also prevents creature from dropping hauled items on its own -- do ''not'' use for player-controllable creatures! May lead to the creature being domesticated during worldgen, even if it doesn't have {{token|COMMON_DOMESTIC|c}}.

Creatures with this tag but without {{token|BENIGN|c}}, and/or with {{token|LARGE_PREDATOR|c}} leads to hauled items being dropped.

|-
| {{text anchor|PARALYZEIMMUNE}}
| Caste
|
| The creature is immune to all [[Syndrome#CE_PARALYSIS|paralyzing]] special attacks.

|-
| {{text anchor|PATTERNFLIER}}
| Caste
|
| Used to control the bat riders with paralyze-dart blowguns that flew through the 2D chasm. Doesn't do anything now.

|-
| {{text anchor|PCG_LAYERING}}
| Creature
|
*[[Procedural graphics layer|Layering type]]
| Adds a layer to the current {{token|PROCEDURAL_CREATURE_GRAPHICS|c}} definition.

|-
| {{text anchor|PEARL}}
| Caste
|
| Does nothing.

|-
| {{text anchor|PENETRATEPOWER}}
| Caste
|
*value
| Controls the ability of [[vermin]] to find a way into containers when they are eating food from your stockpiles.

Objects made of most materials (e.g. metal) roll a number from 0-100, and if the resulting number is greater than the penetrate power, their contents escape for the time being. Objects made of [[wood]], [[leather]], [[amber]], or [[coral]] roll 0-95, and items made of [[cloth]] roll 0-90.

|-
| {{text anchor|PERSONALITY}}
| Caste
|
*ATTRIBUTE
*lowest
*median
*highest
| Determines the range and chance of personality facets. Standard is 0:50:100. See [[personality facet]] for more info.

|-
| {{text anchor|PET}}
| Caste
|
| Allows the creature to be [[Animal_trainer|tamed]] in Fortress mode. Prerequisite for all other working animal roles. Civilizations that encounter it in worldgen will tame and domesticate it for their own use. Adding this to civilization members will classify them as pets instead of citizens, with all the [[Fun|problems]] that entails. However, you can solve these problems using the popular plugin [https://dffd.bay12games.com/file.php?id=13095| Dwarf Therapist], which is completely unaffected by the tag.

|-
| {{text anchor|PET_EXOTIC}}
| Caste
|
| Allows the creature to be [[Animal_trainer|tamed]] in Fortress mode. Prequisite for all other working animal roles. Civilizations cannot domesticate it in worldgen, with certain exceptions. More difficult to tame?{{verify}} Adding this to civilization members will classify them as pets instead of citizens, with all the [[Fun|problems]] that entails. ([[Gremlin|Example]]).

|-
| {{text anchor|PETVALUE}}
| Caste
|
*value
| How valuable a tamed animal is. Actual cost in points in the embarking screen is 1+(PETVALUE/2) for an untrained animal, 1+PETVALUE for a war/hunting one.

|-
| {{text anchor|PETVALUE_DIVISOR}}
| Caste
|
*value
| Divides the creature's {{token|PETVALUE|c}} by the specified number. Used by [[honey bee]]s to prevent a single hive from being worth a fortune.

|-
| {{text anchor|PHYS_ATT_CAP_PERC}}
| Caste
|
*[[Attribute|ATTRIBUTE]] Token
*Cap %
|Default is 200. This means you can increase your attribute to 200% of its starting value (or the average value + your starting value if that is higher).

|-
| {{text anchor|PHYS_ATT_RANGE}}
| Caste
|
*[[Attribute|ATTRIBUTE]]
*lowest
*lower
*low
*median
*high
*higher
*highest
| Sets up a [[Attribute#Body_attributes|physical attribute]]'s range of values (0-5000). All physical attribute ranges default to 200:700:900:1000:1100:1300:2000.

|-
| {{text anchor|PHYS_ATT_RATES}}
| Caste
|
*[[Attribute|ATTRIBUTE]] Token
*cost to improve
*unused counter rate
*rust counter rate
*demotion counter rate
| [[Attribute#Body_attributes|Physical attribute]] gain/decay rates. Lower numbers in the last three slots make decay occur faster. Defaults for STRENGTH, AGILITY, TOUGHNESS, and ENDURANCE are 500:3:4:3, while RECUPERATION and DISEASE_RESISTANCE default to 500:NONE:NONE:NONE.

|-
| {{text anchor|PLUS_BP_GROUP}}
| Caste
|
*BY_TYPE, BY_CATEGORY, or BY_TOKEN
*body type, category, or token
| Adds a body part group to selected body part group. Presumably used immediately after {{token|SET_BP_GROUP|c}}.

|-
| {{text anchor|PLUS_MATERIAL}}
| Creature
|
*material
| Adds a material to selected materials. Used immediately after {{token|SELECT_MATERIAL|c}}.

|-
| {{text anchor|POP_RATIO}}
| Caste
|
*number (max 100000)
| Weighted population of caste; Lower is rarer. Not to be confused with {{token|FREQUENCY|c}}. A weight of 0 will{{version|51.06 experimental}} prevent a caste from spawning naturally. Regardless of pop ratio, [[Position token|Position]]s that only allow a certain caste can force it to spawn.

|-
| {{text anchor|POPULATION_NUMBER}}
| Creature
|
*min
*max
| The minimum/maximum numbers of how many of these creatures are present in each world map tile of the appropriate region. Defaults to 1:1 if not specified.

|-
| {{text anchor|POWER}}
| Caste
|
| Allows the being to represent itself as a deity, allowing it to become the leader of a civilized group. Not used by any creatures in the vanilla game. Requires {{token|CAN_SPEAK|c}} to actually do anything more than settle at a location (e.g. write books, lead armies, profane temples). Doesn't appear to do anything for creatures that are already civilized. Once the creature ascends to a position of leadership, it will proceed to act as a standard ruler for their entity and fulfill the same functions (hold tournaments, tame creatures, etc.).

|-
| {{text anchor|PREFSTRING}}
| Creature
|
*string
| Sets what other creatures [[Preferences|prefer]] about this creature. "Urist likes dwarves for their beards." Multiple entries will be chosen from at random. Creatures lacking a PREFSTRING token will never appear under another's preferences.

|-
| {{text anchor|PROCEDURAL_CREATURE_GRAPHICS}}
| Creature
|
* [[Graphics_token#Basic_creature_sprite_types|Sprite type]] or Caste then sprite type
| Makes the creature have procedural graphics built for it, like forgotten beasts/demons/titans/experiments. Must be associated with PCG_LAYERING tokens.

|-
| {{text anchor|PROFESSION_NAME}}
| Creature
|
*[[Unit type token]] (Profession)
*singular
*plural
| The generic name for members of this profession, at the creature level. In order to give members of specific castes different names for professions, use {{token|CASTE_PROFESSION_NAME|c}} instead.

|-
| {{text anchor|PRONE_TO_RAGE}}
| Caste
|
*Chance
| Creature has a percentage chance to flip out at visible non-friendly creatures. Enraged creatures attack anything regardless of timidity and get a strength bonus to their hits. This is what makes [[badger]]s so hardcore.

|-
| {{text anchor|PUS}}
| Caste
|
* <[[material token]]>
* <[[Material_definition_token#Material_States|material state]]>
| The creature has pus. Specifies the stuff secreted by [[Health_care#Infection|infected wounds]].
|}

{{alphabetical TOC|style=margin: 1em auto;}}

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

|-
| {{text anchor|RELSIZE}}
| Caste
|
*BY_CATEGORY, BY_TYPE, BY_TOKEN
*body category, type, or token
*Relsize
| Specifies a new relative size for a part than what is stated in the body plan. For example, dwarves have larger livers.

|-
| {{text anchor|REMAINS}}
| Caste
|
*singular
*plural
| What the creature's [[remains]] are called.

|-
| {{text anchor|REMAINS_COLOR}}
| Caste
|
| What color the creature's [[remains]] are.

|-
| {{text anchor|REMAINS_ON_VERMIN_BITE_DEATH}}
| Caste
|
| Goes with {{token|VERMIN_BITE|c}} and {{token|DIE_WHEN_VERMIN_BITE|c}}, the vermin creature will leave remains on death when biting. Leaving this tag out will cause the creature to disappear entirely after it bites.

|-
| {{text anchor|REMAINS_UNDETERMINED}}
| Caste
|
| Nothing.

|-
| {{text anchor|REMOVE_MATERIAL}}
| Creature
|
*material token
| Removes a material from the creature.

|-
| {{text anchor|REMOVE_TISSUE}}
| Creature
|
*tissue token
| Removes a tissue from the creature.

|-
| {{text anchor|RETRACT_INTO_BP}}
| Caste
|
*BY_TYPE, BY_CATEGORY or BY_TOKEN
*body type, [[Body_token#CATEGORY|category]], or [[Body_token#BP|token]]
*Second person ("You") retract verb text
*Third person ("The giant snail") retract verb text
*Second person cancel retract text
*Third person cancel retract text
| The creature will retract into the specified body part(s) when threatened. It will be unable to move or attack, but enemies will only be able to attack the specified body part(s). When one of the specified body part is severed off, the creature automatically unretracts and cannot retract anymore. More than one body part can be selected by using BY_TYPE or BY_CATEGORY.

Second-person descriptions are used for adventurer mode natural ability. "<pro_pos>" can be used in the descriptions, being replaced with the proper pronoun (or lack thereof) in-game.

Undead curled up creatures are buggy, specifically those that retract into their upper bodies: [[echidna]]s, [[hedgehog]]s and [[pangolin]]s.{{bug|11463}}{{bug|10519}} The upper body is prevented from collapsing by a separate body part (the middle spine), which cannot be attacked when the creature is retracted. See {{token|PREVENTS_PARENT_COLLAPSE|bo}}. Living creatures eventually succumb to blood loss, but undead creatures do not. Giant creatures also take a very long time to bleed out.
|-
| {{text anchor|RETURNS_VERMIN_KILLS_TO_OWNER}}
| Creature
|
| Cat behavior. If it kills a vermin creature and has an owner, it carries the remains in its mouth and drops them at their feet. Requires {{token|HUNTS_VERMIN|c}}.

|-
| {{text anchor|ROOT_AROUND}}
| Caste
|
*BY_TYPE, BY_CATEGORY or BY_TOKEN
*body type, [[Body_token#CATEGORY|category]], or [[Body_token#BP|token]]
*Second person ("You") verb text
*Third person ("The hen") verb text
| Creature will occasionally root around in the grass, looking for insects. Used for flavor in Adventurer Mode, spawns vermin edible for this creature in Fortress Mode. Creatures missing the specified body part will be unable to perform this action. The action produces a message (visible in adventure mode) in the form:

[creature] [verb text] the [description of creature's location]

In adventure mode, the "rooting around" ability will be included in the "natural abilities" menu, represented by its second person verb text.

|}

{{alphabetical TOC|style=margin: 1em auto;}}

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

|-
| {{text anchor|SAVAGE}}
| Creature
|
| The creature will only show up in "savage" biomes. Has no effect on cavern creatures. Cannot be combined with {{token|GOOD|c}} or {{token|EVIL|c}}.

|-
| {{text anchor|SECRETION}}
| Caste
|
*<[[material token]]>
*<[[Material_definition_token#Material_States|material state]]>
*BY_TOKEN / BY_CATEGORY / BY_TYPE
*<[[Body_token#BP|body part ID]]> / <[[Body_token#CATEGORY|category]]> or ALL / <type (e.g. [[Body_token#GRASP|GRASP]])>
*<[[Body_detail_plan_token#BP_LAYERS|tissue layer]]> or ALL
*<trigger>
| Causes the specified tissue layer(s) of the indicated body part(s) to secrete the designated material. A size 100 ('covering') [[contaminant]] is created over the affected body part(s) in its specified material state (and at the temperature appropriate to this state) when the trigger condition is met, as long as one of the secretory tissue layers is still intact. Valid triggers are:
*'''CONTINUOUS'''
Secretion occurs once every 40 [[time|ticks]] in [[fortress mode]], and every tick in [[adventurer mode]].
*'''EXERTION'''
Secretion occurs continuously (at the rate described above) whilst the creature is at minimum {{Tile|Tired|6:1}} following physical exertion. Note that this cannot occur if the creature has {{token|NOEXERT|c}}.
*'''EXTREME_EMOTION'''
Secretion occurs continuously (as above) whilst the creature is distressed. Cannot occur in creatures with {{token|NOEMOTION|c}}.

|-
| {{text anchor|SELECT_ADDITIONAL_CASTE}}
| Creature
|
*<caste>
| Adds an additional previously defined caste to the selection. Used after {{token|SELECT_CASTE|c}}.

|-
| {{text anchor|SELECT_CASTE}}
| Creature
|
*<caste> or ALL
| Selects a previously defined caste

|-
| {{text anchor|SELECT_MATERIAL}}
| Creature
|
*<[[material token]]>
| Selects a locally defined material. Can be ALL.

|-
| {{text anchor|SELECT_TISSUE}}
| Creature
|
*tissue token
| Selects a tissue for editing.

|-
| {{text anchor|SEMIMEGABEAST}}
| Caste
|
| Essentially the same as {{token|MEGABEAST|c}}, but more of them are created during worldgen. See the [[semi-megabeast]] page for details.

|-
| {{text anchor|SENSE_CREATURE_CLASS}}
| Caste
|
* <[[Creature_token#CREATURE_CLASS|creature class]]>
* [[Tilesets|<tile value or character>]]
* [[Color#Color_values|<foreground color>:<background color>:<foreground brightness>]]
| Gives the creature the ability to sense creatures belonging to the specified [[Creature_token#CREATURE_CLASS|creature class]] even when they lie far beyond line of sight, including through walls and floors. It also appears to reduce or negate the combat penalty of [[Wound#Blindness|blind]] units when fighting creatures they can sense. In [[adventure mode]], the specified tile will be used to represent sensed creatures when they cannot be seen directly.

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

|-
| {{text anchor|SKILL_LEARN_RATE}}
| Caste
|
*<[[skill_token]]>
*<percentage>
| The rate at which this creature learns this skill. Requires {{token|CAN_LEARN|c}} or {{token|INTELLIGENT|c}} to function.

|-
| {{text anchor|SKILL_LEARN_RATES}}
| Caste
|
*<percentage>
| The rate at which this creature learns all skills. Requires {{token|CAN_LEARN|c}} or {{token|INTELLIGENT|c}} to function.

|-
| {{text anchor|SKILL_RATE}}
| Caste
|
*[[skill_token]]
*<% of improvement points gained>
*<unused counter rate>
*<rust counter rate>
*<demotion counter rate>
| Like {{token|SKILL_RATES|c}}, but applies to individual skills instead. Requires {{token|CAN_LEARN|c}} or {{token|INTELLIGENT|c}} to function.

|-
| {{text anchor|SKILL_RATES}}
| Caste
|
*<% of improvement points gained>
*<unused counter rate>
*<rust counter rate>
*<demotion counter rate>
| Affects skill gain and decay. Lower numbers in the last three slots make decay occur faster ([SKILL_RATES:100:1:1:1] would cause rapid decay). The counter rates may also be replaced with NONE.
Default is [SKILL_RATES:100:8:16:16]. Requires {{token|CAN_LEARN|c}} or {{token|INTELLIGENT|c}} to function.

|-
| {{text anchor|SKILL_RUST_RATE}}
| Caste
|
*[[skill_token]]
*value
*value
*value
| The rate at which this skill decays. Lower values cause the skill to decay faster. Requires {{token|CAN_LEARN|c}} or {{token|INTELLIGENT|c}} to function.

|-
| {{text anchor|SKILL_RUST_RATES}}
| Caste
|
*value
*value
*value
| The rate at which all skills decay. Lower values cause the skills to decay faster. Requires {{token|CAN_LEARN|c}} or {{token|INTELLIGENT|c}} to function.

|-
| {{text anchor|SLAIN_CASTE_SPEECH}}
| Caste
|
*[[Speech file|text set]]
| Caste-specific {{token|SLAIN_SPEECH|c}}.

|-
| {{text anchor|SLAIN_SPEECH}}
| Creature
|
*[[Speech file|text set]]
| Boasting speeches relating to killing this creature. Examples include [[text_dwarf.txt/raw|text_dwarf.txt]] (<code>[SLAIN_SPEECH:SLAIN_DWARF]</code>) and text_elf.txt (<code>[SLAIN_SPEECH:SLAIN_ELF]</code>) in data\vanilla\vanilla_creatures\objects.

|-
| {{text anchor|SLOW_LEARNER}}
| Caste
|
| Shorthand for {{token|CAN_LEARN|c}} + <code>[[Creature_token#SKILL_LEARN_RATES|[SKILL_LEARN_RATES:50]]]</code>.{{verify}} Used by a number of 'primitive' creatures (like [[ogre]]s, [[giant]]s and [[troglodyte]]s) in the vanilla game. Applicable to player races. Prevents a player from recruiting nobility, even basic ones. Subterranean creatures with this token combined with {{token|EVIL|c}} will become servants of goblins in their civilizations, in the style of [[troll]]s.

|-
| {{text anchor|SMALL_REMAINS}}
| Caste
|
| Creature leaves "[[item token#REMAINS|remains]]" instead of a corpse. Used by [[vermin]].

|-
| {{text anchor|SMELL_TRIGGER}}
| Caste
|
*value
| Determines how keen a creature's sense of smell is - lower is better. At 10000, a creature cannot smell at all.

|-
| {{text anchor|SOLDIER_ALTTILE}}
| Creature
|
*'character' or tile number
| If this creature is active in its civilization's military, it will blink between its default tile and this one.

|-
| {{text anchor|SOUND}}
| Caste
|
* Sound application (currently accepts ALERT or PEACEFUL_INTERMITTENT)
* Sound range (in tiles)
* Sound delay (lower values = sound is produced more often)
* VOCALIZATION or NONE (determines whether the sound requires breathing or not)
* First-person description
* Third-person description
* Description when out of sight
| Creature makes sounds periodically, which can be heard in Adventure mode.
* First-person reads "You '''bark'''"
* Third-person reads "The [[capybara]] '''barks'''"
* Out of sight reads "You hear '''a loud bark'''"
with the text in bold being the description arguments of the token.

|-
| {{text anchor|SOURCE_HFID}}
| Creature
|
*Integer
| Found on generated [[angel]]s. This is the historical figure ID of the deity with which the angel is associated. Since HFIDs are not predictable before worldgen, this isn't terribly usable in mods.

|-
| {{text anchor|SPECIFIC_FOOD}}
| Caste
|
* PLANT or CREATURE
* Plant/creature ID
| Creature will only appear in biomes with this plant or creature available. Grazers given a specific type of grass (such as [[panda]]s and [[bamboo]]) will only eat that grass and nothing else, risking starvation if there's none available.

|-
| {{text anchor|SPHERE}}
| Creature
|
* [[Sphere#Available_spheres|sphere]]
| Sets what religious spheres the creature is aligned to, for purposes of being worshipped via the {{token|POWER|c}} token. Also affects the creature's name.

|-
| {{text anchor|SPOUSE_CONVERSION_TARGET}}
| Caste
|
| This creature can be converted by a night creature with {{token|SPOUSE_CONVERTER|c}}.

|-
| {{text anchor|SPOUSE_CONVERTER}}
| Caste
|
| If the creature has the {{token|NIGHT_CREATURE_HUNTER|c}} tag, it will kidnap {{token|SPOUSE_CONVERSION_TARGET|c}}s and transform them into the caste of its species with the {{token|CONVERTED_SPOUSE|c}} tag during worldgen. It may also start families this way.

|-
| {{text anchor|SPREAD_EVIL_SPHERES_IF_RULER}}
| Caste
|
| If the creature rules over a [[site]], it will cause the local landscape to be corrupted into [[Surroundings#Evil|evil surroundings]] associated with the creature's [[Creature_token#SPHERE|sphere]]s. The creature must have at least one of the following [[sphere]]s for this to take effect: BLIGHT, DEATH, DISEASE, DEFORMITY, NIGHTMARES. The first three kill vegetation, while the others sometimes do. The last two get [[Plant_token#EVIL|evil plants]] and [[Creature_token#EVIL|evil animals]] sometimes. NIGHTMARES gets [[bogeyman|bogeymen]]. [http://www.bay12forums.com/smf/index.php?topic=169696.msg8162224#msg8162224] Used by [[demon]]s in the vanilla game.

|-
| {{text anchor|STANCE_CLIMBER}}
| Caste
|
| Caste does not require <code>[[Body_token#GRASP|[GRASP]]]</code> body parts to climb -- it can climb with <code>[[Body_token#STANCE|[STANCE]]]</code> parts instead.

|-
| {{text anchor|STANDARD_GRAZER}}
| Caste
|
| Acts as {{token|GRAZER|c}} but set to 20000*G*(max size)^(-3/4), where G defaults to 100 but can be set in d_init, and the whole thing is trapped between 150 and 3 million. Used for all grazers in the default creature raws.

|-
| {{text anchor|STRANGE_MOODS}}
| Caste
|
| The creature will get [[strange mood]]s in fortress mode and can produce artifacts.

|-
| {{text anchor|SUPERNATURAL}}
| Caste
|
| Gives the creature knowledge of any secrets with <code>[[Interaction_token#IS_SECRET|[SUPERNATURAL_LEARNING_POSSIBLE]]]</code> that match its [[Creature_token#SPHERE|spheres]] and also prevents it from becoming a [[vampire]] or [[werebeast]]. Other effects are unknown.

|-
| {{text anchor|SWIMS_INNATE}}
| Caste
|
| The creature naturally knows how to swim perfectly and does not use the [[swimmer]] skill, as opposed to {{token|SWIMS_LEARNED|c}} below. However, Fortress mode AI never paths into water anyway, so it's less useful there.

|-
| {{text anchor|SWIMS_LEARNED}}
| Caste
|
| The creature swims only as well as their present [[Swimmer|swimming skill]] allows them to.

|-
| {{text anchor|SYNDROME_DILUTION_FACTOR}}
| Caste
| <[[Syndrome#SYN_IDENTIFIER|syndrome identifier]]>:<percentage>
| Dilutes the effects of syndromes which have the specified identifier. A percentage of 100 is equal to the regular syndrome effect severity, higher percentages reduce severity.
|}

{{alphabetical TOC|style=margin: 1em auto;}}

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

|-
| {{text anchor|TENDONS}}
| Caste
|
* [[material token]]
*healing rate
| The creature has tendons in its {{token|CONNECTIVE_TISSUE_ANCHOR|td}} tissues (bone or chitin by default). Cutting the bone/chitin tissue severs the tendons, disabling motor function if the target is a limb.

|-
| {{text anchor|THICKWEB}}
| Caste
|
| The creature's [[web]]s can catch larger creatures.

|-
| {{text anchor|TISSUE}}
| Creature
|
*name
| Begins defining a tissue in the creature file. Follow this with standard tissue definition tokens to define the tissue properties.

|-
| {{text anchor|TISSUE_LAYER}}
| Caste
|
*BY_TYPE, BY_CATEGORY, BY_TOKEN
*TYPE,CATEGORY, or TOKEN
*TISSUE
*LOCATION
| Adds the tissue layer to wherever it is required.
Non-argument Locations can be FRONT, RIGHT, LEFT, TOP, BOTTOM. Argument locations are AROUND and CLEANS, requiring a further body part and a % of coverage/cleansing

|-
| {{text anchor|TISSUE_LAYER_OVER}}
| Caste
|
*BY_TYPE, BY_CATEGORY, BY_TOKEN
*TYPE,CATEGORY, or TOKEN
*TISSUE
*LOCATION
| Alias for TISSUE_LAYER

|-
| {{text anchor|TISSUE_LAYER_UNDER}}
| Caste
|
*BY_TYPE, BY_CATEGORY, BY_TOKEN
*TYPE,CATEGORY, or TOKEN
*TISSUE
| Adds the tissue layer under a given part.
For example, an [[iron man]] has a gaseous poison within, and this tissue (GAS is its name) has the token [TISSUE_LEAKS] and its state is GAS, so when you puncture the iron outside and damage this tissue it leaks gas (can have a syndrome by using a previous one in the creature sample.) [TISSUE_LAYER_UNDER:BY_CATEGORY:ALL:{tissue}] {tissue} is what will be under the TISSUE_LAYER; here is an example Tissue from the 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]

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

|-
| {{text anchor|TRADE_CAPACITY}}
| Caste
|
*number
| How much the creature can carry when used by merchants. 1000 by default. Completely ignored if the animal does not also have PACK_ANIMAL or WAGON, instead using BODY_SIZE^(2/3)/20, even if they're a pack animal due to ANIMAL_ALWAYS_PACK_ANIMAL.

|-
| {{text anchor|TRAINABLE}}
| Caste
|
| Shortcut for {{token|TRAINABLE_HUNTING|c}} + {{token|TRAINABLE_WAR|c}}.

|-
| {{text anchor|TRAINABLE_HUNTING}}
| Caste
|
| Can be [[Animal trainer|trained]] as a hunting beast, increasing speed.

|-
| {{text anchor|TRAINABLE_WAR}}
| Caste
|
| Can be [[Animal trainer|trained]] as a war beast, increasing strength and endurance.

|-
| {{text anchor|TRANCES}}
| Caste
|
| Allows the creature to go into [[martial trance]]s. Used by dwarves in the vanilla game.

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

|-
| {{text anchor|TRIGGERABLE_GROUP}}
| Creature
|
*min
*max
| A large swarm of vermin can be disturbed, usually in adventurer mode.

|-
| {{text anchor|TSU_NOUN}}
| Caste
|
*noun
*SINGULAR or PLURAL
| Noun for the {{token|TISSUE_STYLE_UNIT|c}}, used in the description of the tissue layer's style.
|}

{{alphabetical TOC|style=margin: 1em auto;}}

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

|-
| {{text anchor|UBIQUITOUS}}
| Creature
|
| Creature will occur in every region with the correct biome. Does not apply to {{token|EVIL|c}}/{{token|GOOD|c}} tags. Supersedes {{token|FREQUENCY|c}} for the purposes of distributing populations through the map, they are present in every part of the valid biome. Respects {{token|FREQUENCY|c}} for the frequency of unit [[Creature token#CLUSTER_NUMBER|cluster]] spawns being of this species.

|-
| {{text anchor|UNDERGROUND_DEPTH}}
| Creature
|
*mindepth
*maxdepth
| Depth that the creature appears underground. Numbers can be from 0 to 5. 0 is actually 'above ground' and can be used if the creature is to appear both above and below ground. Values from 1-3 are the respective [[cavern]] levels, 4 is the [[magma sea]] and 5 is the [[HFS]]. A single argument may be used instead of min and max. [[Demon]]s use only 5:5; user-defined creatures with both this depth and {{token|FLIER}} will take part in the initial wave from the HFS alongside generated demons, but without {{token|FLIER}} they will only spawn from the map edges. Civilizations that can use underground plants or animals will only export (via the embark screen or caravans) things that are available at depth 1.

|-
| {{text anchor|UNDERSWIM}}
| Caste
|
| The creature is displayed as blue when in [[Water#Depth|7/7 water]]. Used on fish and amphibious creatures which swim under the water.

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

|-
| {{text anchor|USE_CASTE}}
| Creature
|
*new caste token
*old caste token
| Defines a new caste derived directly from a previous caste. The new caste inherits all properties of the old one. The effect of this tag is automatic if one has not yet defined any castes: "Any caste-level tag that occurs before castes are explicitly declared is saved up and placed on any caste that is declared later, unless the caste is explicitly derived from another caste."
Roostre: "When DF detects duplicate tokens in the raws of the same object, a failsafe seems to kick in; it takes the bottom-most of the duplicates, and disregards the others. In the case of tokens added by a mod, it prioritizes the duplicate in the mod." This means that if a tag is defined in the base-caste and redefined in the derived caste, the derived tag overwrites the base tag.

|-
| {{text anchor|USE_MATERIAL}}
| Creature
|
*new material ID
*old material ID
| Defines a new local creature material and populates it with all properties defined in the specified local creature material.

|-
| {{text anchor|USE_MATERIAL_TEMPLATE}}
| Creature
|
*new material token
*material template
| Defines a new local creature material and populates it with all properties defined in the specified template. [http://www.bay12forums.com/smf/index.php?topic=175437.msg8441368#msg8441368 There seems to be a limit of 200 materials per creature].

|-
| {{text anchor|USE_TISSUE}}
| Creature
|
*new tissue token
*old tissue id
| Defines a new local creature tissue and populates it with all properties defined in the local tissue specified in the second argument.

|-
| {{text anchor|USE_TISSUE_TEMPLATE}}
| Creature
|
*new tissue token
*tissue template
| Loads a tissue template listed in OBJECT:TISSUE_TEMPLATE files, such as tissue_template_default.txt.

|-
| {{text anchor|UTTERANCES}}
| Creature
|
| Changes the language of the creature into unintelligible 'kobold-speak', which creatures of other species will be unable to understand. If a civilized creature has this and is not part of a {{token|SKULKING|e}} civ, it will tend to start wars with all nearby civilizations and will be unable to make peace treaties due to 'inability to communicate'.
|}

{{alphabetical TOC|style=margin: 1em auto;}}

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

|-
| {{text anchor|VEGETATION}}
| Caste
|
| Like {{token|AT_PEACE_WITH_WILDLIFE}}, but also makes the creature more valued in artwork by civilisations with the PLANT [[sphere]]. [http://www.bay12forums.com/smf/index.php?topic=169696.msg8316954#msg8316954] Used by [[grimeling]]s in the vanilla game.

|-
| {{text anchor|VERMIN_BITE}}
| Caste
|
*chance of occurrence{{verify}}
*verb (bitten, stung, etc.)
* [[material token]]
* [[Material_definition_token#Material_States|material state]]
| Enables vermin to bite other creatures, injecting the specified material. See {{token|SPECIALATTACK_INJECT_EXTRACT|c}} for details about injection - this token presumably works in a similar manner.{{verify}}

|-
| {{text anchor|VERMIN_EATER}}
| Creature
|
| The vermin creature will attempt to eat exposed food. See {{token|PENETRATEPOWER|c}}. Distinct from {{token|VERMIN_ROTTER|c}}.

|-
| {{text anchor|VERMIN_FISH}}
| Creature
|
| The vermin appears in [[water]] and will attempt to swim around.

|-
| {{text anchor|VERMIN_GROUNDER}}
| Creature
|
| The creature appears in "general" surface ground locations. Note that this doesn't stop the creature from flying if it can (most vermin birds have this tag).

|-
| {{text anchor|VERMIN_HATEABLE}}
| Caste
|
| Some dwarves will [[Preferences|hate]] the creature and get unhappy thoughts when around it. See the [[Hateable|list of hateable vermin]] for details.

|-
| {{text anchor|VERMIN_MICRO}}
| Caste
|
| This makes the creature move in a swarm of creatures of the same race as it (e.g. swarm of flies, swarm of ants).

|-
| {{text anchor|VERMIN_NOFISH}}
| Caste
|
| The creature cannot be caught by [[fishing]].

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

|-
| {{text anchor|VERMIN_NOTRAP}}
| Caste
|
| The creature cannot be caught in baited [[animal trap]]s; however, a "[[Trapper|catch live land animal]]" task may still be able to capture one if a dwarf finds one roaming around.

|-
| {{text anchor|VERMIN_ROTTER}}
| Creature
|
| The vermin are attracted to rotting stuff and loose food left in the open and cause unhappy thoughts to dwarves who encounter them. Present on flies, knuckle worms, acorn flies, and blood gnats. Speeds up decay?{{verify}}

|-
| {{text anchor|VERMIN_SOIL}}
| Creature
|
| The creature randomly appears near dirt or mud, and may be uncovered by creatures that have the {{token|ROOT_AROUND|c}} interaction such as [[goose|geese]] and [[chicken]]s. Dwarves will ignore the creature when given the "Capture live land animal" task.

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

|-
| {{text anchor|VERMINHUNTER}}
| Caste
|
| Old shorthand for "does cat stuff". Contains {{token|AT_PEACE_WITH_WILDLIFE|c}} + {{token|RETURNS_VERMIN_KILLS_TO_OWNER|c}} + {{token|HUNTS_VERMIN|c}} + {{token|ADOPTS_OWNER|c}}.

|-
| {{text anchor|VESPERTINE}}
| Caste
|
| When set, the creature will only appear in the evening (between 8:00 PM and 10:05 PM) in Adventurer mode.

|-
| {{text anchor|VIEWRANGE}}
| Caste
|
*value
| Value should determine how close you have to get to a critter before it attacks (or prevents adv mode travel etc.) Default is 20.

|-
| {{text anchor|VISION_ARC}}
| Caste
|
*binocular vision arc
*non-binocular vision arc
| The width of the creature's vision arcs, in degrees (i.e. 0 to 360). The first number is binocular vision, the second is non-binocular vision. Binocular vision has a minimum of about 10 degrees, monocular, a maximum of about 350 degrees. Values past these limits will be accepted, but will default to ~10 degrees and ~350 degrees respectively. Defaults are 60:120.
|}

{{alphabetical TOC|style=margin: 1em auto;}}

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

|-
| {{text anchor|WAGON_PULLER}}
| Caste
|
| Allows the creature to pull caravan wagons. If a civilization doesn't have access to any, it is restricted to trading with pack animals.

|-
| {{text anchor|WEBBER}}
| Caste
|
* [[material token]]
| Allows the creature to create [[web]]s, and defines what the webs are made of.

|-
| {{text anchor|WEBIMMUNE}}
| Caste
|
| The creature will not get caught in thick [[web]]s. Used by creatures who can shoot thick webs (such as [[giant cave spider]]s) in order to make them immune to their own attacks.
|}

==Attack Tokens==

Attacks can use four different part selection criteria. Except for TISSUE_LAYER, the base game makes use of all of these in its attacks.

{| {{prettytable}}
|- bgcolor="#ddd"
! width="20%" | Part type token
! width="30%" | Arguments
! width="60%" | Description

|-
| {{text anchor|BODYPART}}
|
* BY_TYPE/BY_TOKEN/BY_CATEGORY
* type/token/category
| This attack uses a particular body part; for example, ATTACK:PUNCH:BODYPART:BY_TYPE:GRASP will make it use any part that can hold onto an object.

|-
| {{text anchor|TISSUE_LAYER}}
|
* BY_TYPE/BY_TOKEN/BY_CATEGORY
* type/token/category
* tissue layer
| This attack uses a specific tissue layer on a specific body part; ATTACK:SCRATCH:TISSUE_LAYER:BY_TYPE:GRASP:BONE will make it use the bone of the hands.

|-
| {{text anchor|CHILD_BODYPART_GROUP}}
|
* BY_TYPE/BY_TOKEN/BY_CATEGORY
* type/token/category
* BY_TYPE/BY_TOKEN/BY_CATEGORY
* type/token/category
| Uses a body part that is subordinate to another; ATTACK:SLAP:CHILD_BODYPART_GROUP:BY_CATEGORY:ARM_LOWER:BY_TYPE:GRASP will make it use every hand attached to each lower arm (so it will generate one attack per lower arm, each of which will use every hand on that arm, assuming there are multiple hands per arm).

|-
| {{text anchor|CHILD_TISSUE_LAYER_GROUP}}
|
* BY_TYPE/BY_TOKEN/BY_CATEGORY
* type/token/category
* BY_TYPE/BY_TOKEN/BY_CATEGORY
* type/token/category
* tissue layer
| As CHILD_BODYPART_GROUP, but specifying a tissue, too; ATTACK:BITE:CHILD_BODYPART_GROUP:BY_CATEGORY:HEAD:BY_CATEGORY:TOOTH

|}

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

|-
| {{text anchor|ATTACK_SKILL}}
| Caste
|
*[[Skill token]]
| Defines the skill used by the attack.

|-
| {{text anchor|ATTACK_VERB}}
| Caste
|
*2nd person
*3rd person
| Descriptive text for the attack.

|-
| {{text anchor|ATTACK_CONTACT_PERC}}
| Caste
|
*% value
| The contact area of the attack, measured in % of the body part's volume. Note that all attack percentages can be more than 100%.

|-
| {{text anchor|ATTACK_PENETRATION_PERC}}
| Caste
|
*% value
| The penetration value of the attack, measured in % of the body part's volume. Requires ATTACK_FLAG_EDGE. Maximum value: 15000.

|-
| {{text anchor|ATTACK_PRIORITY}}
| Caste
|
*MAIN or SECOND
| Usage frequency. MAIN attacks are 100 times more frequently chosen than SECOND. Opportunity attacks ignore this preference.

|-
| {{text anchor|ATTACK_VELOCITY_MODIFIER}}
| Caste
|
*number
| The velocity multiplier of the attack, multiplied by 1000.

|-
| {{text anchor|ATTACK_FLAG_CANLATCH}}
| Caste
|
| Attacks that damage tissue have the chance to latch on in a wrestling hold. The grabbing bodypart can then use the "shake around" wrestling move, causing severe, armor-bypassing tensile damage according to the attacker's body volume.

|-
| {{text anchor|ATTACK_FLAG_WITH}}
| Caste
|
| Displays the name of the body part used to perform an attack while announcing it, e.g. "The weaver punches the bugbat with his right hand".

|-
| {{text anchor|ATTACK_FLAG_EDGE}}
| Caste
|
| The attack is edged, with all the effects on physical resistance and contact area that it entails.

|-
| {{text anchor|ATTACK_PREPARE_AND_RECOVER}}
| Caste
|
* Preparation time
* Recovery time
| Determines the length of time to prepare this attack and until one can perform this attack again. Values appear to be calculated in adventure mode ticks.

|-
| {{text anchor|ATTACK_FLAG_BAD_MULTIATTACK}}
| Caste
|
| Multiple strikes with this attack cannot be performed effectively.

|-
| {{text anchor|ATTACK_FLAG_INDEPENDENT_MULTIATTACK}}
| Caste
|
| Multiple strikes with this attack can be performed with no penalty. The creature will use all attacks with this token at once.

|-
| {{text anchor|SPECIALATTACK_INJECT_EXTRACT}}
| Caste
|
*<[[material token]]>
*<[[Material_definition_token#Material_States|material state]]>
*<min quantity>
*<max quantity>
| When added to an attack, causes the attack to inject the specified material into the victim's bloodstream. Once injected, the material will participate in [[temperature|thermal]] exchange within the creature - injecting something like molten [[iron]] (INORGANIC:IRON:LIQUID) would cause most unmodded creatures to melt (note that some of the injected material also [[contaminant|splatters]] over the bodypart used to carry out the attack, so it should be protected appropriately). If the injected material has an associated [[syndrome]] with the [[Syndrome#SYN_INJECTED|[SYN_INJECTED]]] token, it will be transmitted to the victim. If the attack is blunt, the injected material lacks the [[Material definition token#ENTERS_BLOOD|[ENTERS_BLOOD]]] token, the attacked bodypart has no [[Tissue_definition_token#VASCULAR|[VASCULAR]]] tissues, or the victim is bloodless, the material will splatter over the attacked body part instead.

|-
| {{text anchor|SPECIALATTACK_INTERACTION}}
| Caste
|
*interaction
| When this attack lands successfully, a specified interaction will take effect on the target creature. The attack must break the target creature's skin in order to work. This will take effect in worldgen as well. If the attack would break skin, the interaction will occur '''before the attack actually lands'''.

|-
| {{text anchor|SPECIALATTACK_SUCK_BLOOD}}
| Caste
|
*min
*max
| Successful attack draws out an amount of blood randomized between the min and max value. Beware that this '''will''' trigger any ingestion syndromes attached to the target creature's blood - for example, using this attack on a vampire will turn you into one too.
|}

==Tissue Layer Tokens==
Tissue layers are added to a creature's body parts by the creature tokens [[#TISSUE_LAYER|TISSUE_LAYER]], [[#TISSUE_LAYER_OVER|TISSUE_LAYER_OVER]], [[#TISSUE_LAYER_UNDER|TISSUE_LAYER_UNDER]], and the body detail plan token [[#TL_LAYERS|TL_LAYERS]].

These tissue layers are not the same thing as tissues, which are defined at creature level, but rather applications of the tissues. If the SKIN tissue of a creature is the more general and abstract notion of what skin is for that creature, then a tissue layer may be the "actual" skin on the creature's nose, head, or second toe. As most creatures have more than one body part, tissue layers are normally selected en masse.

Some tissue layer tokens are analogous to tissue definition tokens, e.g. [[#TL_CONNECTS|TL_CONNECTS]] to [[tissue_definition_token#CONNECTS|CONNECTS]].

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

|-
| {{text anchor|SELECT_TISSUE_LAYER}}
| Caste
|
*TISSUE
*BY_CATEGORY, BY_TYPE, BY_TOKEN
*Location - category, type, or token | Selects a tissue at a location
* (optional) FRONT, BACK, LEFT, RIGHT, TOP, BOTTOM, AROUND.
| Begins a selection of tissue layers.
[SELECT_TISSUE_LAYER:HEART:BY_TYPE:HEART]

|-
| {{text anchor|PLUS_TISSUE_LAYER}}
| Caste
|
*TISSUE
*BY_CATEGORY, BY_TYPE, BY_TOKEN
*Location - category, type, or token
| Adds tissue layers to those selected.

|-
| {{text anchor|SET_TL_GROUP}}
| Caste
|
*TISSUE
*BY_CATEGORY, BY_TYPE, BY_TOKEN
*Location - category, type, or token
*tissue
| Begins a selection of tissue layers. Only usable for descriptor and cosmetic purposes.

Research has implied it may be redundant with SELECT_TISSUE_LAYER, as the latter allows for cosmetics as well as "functional" tokens such as TL_MAJOR_ARTERIES. Vanilla raws still use SET_TL_GROUP though, for all cosmetic purposes. More research is needed on this subject.

|-
| {{text anchor|PLUS_TL_GROUP}}
| Caste
|
*BY_CATEGORY, BY_TYPE, BY_TOKEN
*Location - category, type, or token
*tissue
| Adds tissue layers to those selected. Like SET_TL_GROUP, it may be redundant even if used in the vanilla raws.

|-
| {{text anchor|SET_LAYER_TISSUE}}
| Caste
|
*TISSUE
| Sets a selected tissue layer to be made of a different tissue.

|-
| {{text anchor|SHEARABLE_TISSUE_LAYER}}
| Caste
|
* tissue modifier
* required value
| Tissue layer can be sheared for its component material. The specified modifier must be at least of the desired value for shearing to be possible (for example, a [[llama]]'s wool must have a LENGTH of 300 before it is shearable).

|-
| {{text anchor|TISSUE_LAYER_APPEARANCE_MODIFIER}}
| Caste
|
*QUALITY
*lowest
*lower
*low
*median
*high
*higher
*highest
| Sets the range of qualities, including LENGTH, DENSE, HIGH_POSITION, CURLY, GREASY, WRINKLY

|-
| {{text anchor|TISSUE_STYLE_UNIT}}
| Caste
|
*tissue style unit ID
*shaping
| Sets tissue layer to be the target of TISSUE_STYLE token specified for an entity, works only on entity members. Mostly used with tissues HAIR, BEARD, MOUSTACHE, SIDEBURNS.

|-
| {{text anchor|TL_COLOR_MODIFIER}}
| Caste
|
*COLOR
*freq
*COLOR
*freq etc.
| Creates a list of colors/color patterns, giving each a relative frequency. If the given color or pattern does not exist, the tissue is described as being "transparent".

|-
| {{text anchor|TLCM_GENETIC_MODEL}}
| Caste
|
| The way the color modifier is passed on to offspring. May or may not work right now.{{verify}}

|-
| {{text anchor|TLCM_IMPORTANCE}}
| Caste
|
*number
| Presumably modifies the importance of the tissue layer color modifier, for description purposes.
HOWEVER using this appears to remove all mention of colour from creature descriptions. It does not appear in any default creatures.

|-
| {{text anchor|TLCM_NOUN}}
| Caste
|
*name
*SINGULAR or PLURAL
| Names the tissue layer color modifier, and determines the noun. Also used by [[Utility:Stonesense|Stonesense]] for colouring body parts.

|-
| {{text anchor|TLCM_TIMING}}
| Caste
|
*ROOT
*start change window years
*days
*end change window years
*days
| Determines the point in the creature's life when the color change begins and ends.

|-
| {{text anchor|TL_CONNECTS}}
| Caste
|
| Gives the CONNECTS attribute to selected layers.

|-
| {{text anchor|TL_HEALING_RATE}}
| Caste
|
*value
| Changes the HEALING_RATE of the selected tissue layers.

|-
| {{text anchor|TL_MAJOR_ARTERIES}}
| Caste
|
| Gives the "major arteries" attribute to selected layers. Used to add massive bleeding properties to the throat, made from skin.

|-
| {{text anchor|TL_PAIN_RECEPTORS}}
| Caste
|
*value
| Changes the number of pain receptors for selected tissue layers.

|-
| {{text anchor|TL_RELATIVE_THICKNESS}}
| Caste
|
*value
| Changes the relative thickness for selected tissue layers.

|-
| {{text anchor|TL_VASCULAR}}
| Caste
|
*value
| Sets a new VASCULAR value (which modulates bleeding) for selected tissue layers.

|}

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

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

Creature token

2025-04-08T23:00:49Z

DikbutDaGrate: [NIGHT_CREATURE] may actually cause [LOCAL_POPS_PRODUCE _HEROES] to work better, somehow. Full verdict on what its doing is pending.

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

The <code>[OBJECT:CREATURE]</code> [[token]] begins the definition of a ''Dwarf Fortress'' [[creature]] [[raw file]]. Each creature definition that follows begins with the {{token|creature|c|creature ID}} token, and the creature's exact properties and behavior are then specified by the use of further creature tokens. All known creature tokens are listed below.

Vanilla creature definitions can be found in <code>[[Game folder|<Dwarf Fortress>]]\data\vanilla\vanilla_creatures\</code>.
Creature ID is also used with [[graphics token]]s to make customizable [[graphics set]]s.

The [[caste]] tokens allow defining sub-species within the broader creature definition, including true biological castes and lesser variations, such as sexes. Creature tokens can either be 'Creature' or 'CASTE-only' type which can only be applied to creature or caste respectively, or 'CASTE' which can be applied to both. In the table bellow, creature type distinguishes tokens that can be applied to creature only, caste only, and both ('creature', 'CASTE-only', and 'CASTE' respectively)

__NOTOC__
{{clear}}
{{alphabetical TOC|style=margin: 1em auto;}}

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

|-
| {{text anchor|ADOPTS_OWNER}}
| Caste
|
| Prevents the tamed creature from being made available for adoption, instead allowing it to automatically adopt whoever it wants. The basic requirements for adoption are intact, and the creature will only adopt individuals who have a [[preference]] for their species. Used by [[cat]]s in the vanilla game. When {{k|v}}iewing a tame creature with this token, the message "This animal isn't interested in your wishes" will appear instead of "This [adorable] animal can't work" or "This animal is waiting to be trained".

|-
| {{text anchor|ALCOHOL_DEPENDENT}}
| Caste
|
| Makes the creature need [[alcohol]] to get through the working day; it will choose to drink booze instead of [[water]] if possible. Going sober for too long reduces speed.

|-
| {{text anchor|ALL_ACTIVE}}
| Caste
|
| When set, the creature will appear at any time of day. Overrides {{token|DIURNAL|c}}, {{token|NOCTURNAL|c}}, {{token|CREPUSCULAR|c}}, {{token|MATUTINAL|c}}, and {{token|VESPERTINE|c}}.

|-
| {{text anchor|ALTTILE}}
| Creature
|
*'character' or tile number
| If set, the creature will blink between its {{token|TILE|c}} and its ALTTILE.

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

|-
| {{text anchor|AMPHIBIOUS}}
| Caste
|
| Allows a creature to breathe both in and out of [[water]] (unlike {{token|AQUATIC|c}}) - does not prevent drowning in [[magma]].

|-
| {{text anchor|APP_MOD_DESC_RANGE}}
| Appearance Modifier
|
*Range (6 values, low to high)
| Based on info from [http://www.bay12forums.com/smf/index.php?topic=113762.msg3473069#msg3473069 Wannabehero on the forums]: When used with an appearance modifier token (BP_APPEARANCE_MODIFIER or BODY_APPEARANCE_MODIFIER), tells the game what numeric ranges to map to which descriptors.

The game uses 7 descriptor levels for each modifier, with the center one generally being to omit the thing from the creature description entirely. The six values in APP_MOD_DESC_RANGE define the boundaries between each described range. If this is not specified it uses the numbers 10:50:95:105:150:190.

|-
| {{text anchor|APP_MOD_GENETIC_MODEL}}
| Appearance Modifier
|
*Model (Accepts DOMINANT_MORE, DOMINANT_LESS, and MIX)
| Defines a genetic model for the relevant appearance modifier(s). May or may not do anything significant at present.

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

|-
| {{text anchor|APP_MOD_NOUN}}
| Appearance Modifier
|
*noun
*SINGULAR or PLURAL
| Creates a noun for the appearance, and whether it is singular or plural.

|-
| {{text anchor|APP_MOD_RATE}}
| Appearance Modifier
|
*Rate (integer)
*Scale (DAILY, YEARLY)
*min (growth)
*max (growth)
*start year
*start day
*end year
*end day
| Setting the growth rate of the modifier. The last two tokens can be replaced by NO_END to have growth continue indefinitely.

|-
| {{text anchor|APPLY_CREATURE_VARIATION}}
| Caste
|
*creature variation ID
*(optional) any amount of arbitrary arguments
| Applies the specified [[creature variation token|creature variation]]. See [[Creature_variation_token#Arguments_and_conditional_tokens]] for how the subsequent arguments may be used.

|-
| {{text anchor|APPLY_CURRENT_CREATURE_VARIATION}}
| Special
|
| Applies the effects of all pending {{token|CV_ADD_TAG|c}} and {{token|CV_REMOVE_TAG|c}} tokens that have been defined in the current creature.

|-
| {{text anchor|AQUATIC}}
| Caste
|
| Enables the creature to breathe in water, but causes it to air-drown on dry land.

|-
| {{text anchor|ARENA_RESTRICTED}}
| Caste
|
| Causes the creature to be excluded from the [[object testing arena]]'s creature spawning list. Typically applied to spoileriffic creatures.

|-
| {{text anchor|ARTIFICIAL_HIVEABLE}}
| Creature
|
| Enables the creature to be kept in artificial [[hive]]s by [[beekeeper]]s.

|-
| {{text anchor|AT_PEACE_WITH_WILDLIFE}}
| Caste
|
| Prevents the creature from attacking or frightening creatures with the {{Token|NATURAL|c}} tag.

|-
| {{text anchor|ATTACK}}
| Caste
|
*token
*selection criteria (it's complicated)
| Defines the attack name, and the body part used. See [[#Attack Tokens|below]] for valid subtokens
'''Example:''' 
<code>[ATTACK:GORE:BODYPART:BY_CATEGORY:HORN]</code> 
''GORE'' = name of the attack 
''BODYPART:BY_CATEGORY:HORN'' = the horn is used to attack (presuming the creature has one)

|-
| {{text anchor|ATTACK_TRIGGER}}
| Caste
|
*population
*exported wealth
*created wealth
| Specifies when a [[megabeast]] or [[semi-megabeast]] will attack the fortress. The attacks will start occurring when all of the requirements are met. Setting a value to 0 disables the trigger.

|}

{{alphabetical TOC|style=margin: 1em auto;}}

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

|-
| {{text anchor|BABY}}
| Caste
|
*integer
| Age at which creature is considered a child, the default is zero. One can think of this as the duration of the baby stage.

|-
| {{text anchor|BABYNAME}}
| Caste
|
*singular
*plural
| Defines a new name for a creature in baby state at the caste level. For non-caste-specific baby names, see {{token|GENERAL_BABY_NAME|c}}.

|-
| {{text anchor|BEACH_FREQUENCY}}
| Caste
|
*integer
| Creature may be subject to [[beaching]], becoming stranded on [[Beach|shores]], where they will eventually air-drown. The number indicates the frequency of the occurrence. Presumably requires the creature to be {{token|AQUATIC|c}}. Used by [[orca]]s, [[sperm whale]]s and [[sea nettle jellyfish]] in the vanilla game.

|-
| {{text anchor|BENIGN}}
| Caste
|
| The creature is non-aggressive by default, and will never automatically be engaged by companions or soldiers, running away from any creatures that are not friendly to it, and will only defend itself if it becomes enraged. Can be thought of as the counterpoint of the {{token|LARGE_PREDATOR|c}} tag. When tamed, animals with this tag will be useless for fortress defense.

This and {{token|TRADE_CAPACITY|c}} are required for {{token|PACK_ANIMAL|c}} to function properly, if an animal contains the aforementioned requirements without this tag: items loaded by the merchants will be dropped upon departure.

|-
| {{text anchor|BIOME}}
| Creature
|
* [[biome token]]
| Select a [[biome]] the creature may appear in.

|-
| {{text anchor|BLOOD}}
| Caste
|
* <[[material token]]>
* <[[Material_definition_token#Material_States|material state]]>
| Specifies what the creature's blood is made of.

|-
| {{text anchor|BLOODSUCKER}}
| Caste
|
| Causes [[vampire]]-like behaviour; the creature will suck the [[Creature_token#BLOOD|blood]] of unconscious victims when its [[Syndrome#TIME_SINCE_SUCKED_BLOOD|thirst for blood]] grows sufficiently large. When controlling the creature in adventure mode, this can be done at will. Seems to be required to make the creature denouncable (in-world) as a creature of the night.

|-
| {{text anchor|BODY}}
| Caste
|
*body parts
| Draws body parts from OBJECT:BODY files (such as body_default.txt)
'''Example:''' 
[BODY:BODY_WITH_HEAD_FLAG:HEART:GUTS:BRAIN:MOUTH] 
This is the body from a [[purring maggot]]. It creates a body with head, a heart, some guts, a brain, and a mouth. That's all a maggot needs.

The body parts need to be listed in an order such that any parent part appears before its connected children. For example [BODY:HEART:BODY_WITH_HEAD_FLAG] produces a "Body Token Recognized But Could Not Connect: HEART" error because HEART can't find any UPPERBODY(s) to connect to. Switching the order to [BODY:BODY_WITH_HEAD_FLAG:HEART] fixes the problem because now the UPPERBODY is created before the HEART tries to connect to it.

'''If the body is left undefined, the creature (or caste) will be tagged as [DOES_NOT_EXIST].''' {{verify}}

|-
| {{text anchor|BODY_APPEARANCE_MODIFIER}}
| Caste
|
*ATTRIBUTE
*lowest
*lower
*low
*median
*high
*higher
*highest
| These body modifiers give individual creatures different characteristics. In the case of HEIGHT, BROADNESS and LENGTH, the modifier is also a percentage change to the BODY_SIZE of the individual creature. The seven numbers afterward give a distribution of ranges. Each interval has an equal chance of occurring.
'''Example:''' 
[BODY_APPEARANCE_MODIFIER:HEIGHT:90:95:98:100:102:105:110] 
''HEIGHT'' : marks the height to be changed 
''90:95:98:100:102:105:110'' : sets the range from the shortest (90% of the average height) to the tallest (110% of the average height) creature variation.

|-
| {{text anchor|BODY_DETAIL_PLAN}}
| Caste
|
*PlanName
*Arguments
| Loads a plan from 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:''' 
[BODY_DETAIL_PLAN:VERTEBRATE_TISSUE_LAYERS:SKIN:FAT:MUSCLE:BONE:CARTILAGE] 
This creates the detailed body of a [[fox]], the skin, fat, muscle, bones and cartilage out of the vertebrate tissues. 
A [[Purring maggot|maggot]] would only need: 
''[BODY_DETAIL_PLAN:EXOSKELETON_TISSUE_LAYERS:SKIN:FAT:MUSCLE]''

|-
| {{text anchor|BODY_SIZE}}
| Caste
|
*years
*days
*size
| Sets size at a given age. Size is in cubic centimeters, and for normal body materials, is roughly equal to the creature's average weight in grams.
'''Example:''' 
[BODY_SIZE:0:0:10000] 
[BODY_SIZE:1:168:50000] 
[BODY_SIZE:12:0:220000] 
This describes the size of a [[minotaur]]. Its birth size would be 10,000 cm3 (~10 kg). At 1 year and 168 days old it would be 50,000 cm3 (~50 kg). And as an adult (at 12 years old) it would be 220,000 cm3 and weigh roughly 220 kg.

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

|-
| {{text anchor|BONECARN}}
| Caste
|
| Creature eats bones. Implies {{token|CARNIVORE|c}}. [[Adventurer mode|Adventurers]] with this token are currently unable to eat bones.{{Bug|11069}}

|-
| {{text anchor|BP_ADD_TYPE}}
| Caste
|
| Adds a type to a body part - used with {{token|SET_BP_GROUP|c}}. In vanilla DF, this is used for adding the type '[[Body token#GELDABLE|GELDABLE]]' to the lower body of certain [[cat|creatures]].

|-
| {{text anchor|BP_APPEARANCE_MODIFIER}}
| Caste
|
*QUALITY
*lowest
*lower
*low
*median
*high
*higher
*highest
| Sets up the breadth of possibilities for appearance qualities for a selected BP group. EG. Eyes (CLOSE_SET, DEEP_SET, ROUND_VS_NARROW, LARGE_IRIS),Lips (THICKNESS), Nose (BROADNESS, LENGTH, UPTURNED, CONVEX), Ear (SPLAYED_OUT, HANGING_LOBES, BROADNESS, HEIGHT), Tooth (GAPS), Skull (HIGH_CHEEKBONES, BROAD_CHIN, JUTTING CHIN, SQUARE_CHIN), Neck (DEEP_VOICE, RASPY_VOICE), Head (BROADNESS, HEIGHT)

|-
| {{text anchor|BP_REMOVE_TYPE}}
| Caste
|
| Removes a type from a body part. Used with {{token|SET_BP_GROUP|c}}.

|-
| {{text anchor|BUILDINGDESTROYER}}
| Caste
|
*1 or 2
| Allows a creature to destroy furniture and buildings. Value [1] targets mostly doors, hatches, furniture and the like. Value [2] targets anything not made with the {{k|b}} + {{k|C}} commands.
|}

{{alphabetical TOC|style=margin: 1em auto;}}

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

|-
| {{text anchor|CAN_DO_INTERACTION}}
| Caste
|
*interaction token
| The creature can perform an interaction. See [[interaction token]].

|-
| {{text anchor|CAN_LEARN}}
| Caste
|
| The creature gains [[skill]]s and can have [[labor|professions]]. If a member of a civilization (even a pet) has this token, it'll need to eat, drink and sleep. Note that this token makes the creature unable to be eaten 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. A creature with at least this token or the {{token|CAN_SPEAK|c}} token will be able to have [[Personality value|values]] and [[Personality goal|goals]].

|-
| {{text anchor|CAN_SPEAK}}
| Caste
|
| Can [[talking|talk]]. Note that this is not necessary for a creature to gain social skills but to make friends in fortress mode. A creature with at least this token or the {{token|CAN_LEARN|c}} token will be able to have [[Personality value|values]] and [[Personality goal|goals]].

|-
| {{text anchor|CANNOT_CLIMB}}
| Caste
|
| Creature cannot [[climber|climb]], even if it has free grasp parts.

|-
| {{text anchor|CANNOT_JUMP}}
| Caste
|
| Creature cannot [[jump]].

|-
| {{text anchor|CANNOT_UNDEAD}}
| Caste
|
| Acts like {{token|NOT_LIVING|c}}, except that {{token|OPPOSED_TO_LIFE|c}} creatures will attack them.

|-
| {{text anchor|CANOPENDOORS}}
| Caste
|
| Defunct, as doors cannot be set as tightly closed anymore.

|-
| {{text anchor|CARNIVORE}}
| Caste
|
| Creature ''only'' eats [[meat]]. If the creature goes on rampages in worldgen, it will often devour the people/animals it kills.

|-
| {{text anchor|CASTE}}
| Creature
|
*name
| Defines a [[caste]].

|-
| {{text anchor|CASTE_ALTTILE}}
| Caste
|
*tile number or "letter"
| Caste-specific {{token|ALTTILE|c}}. Requires {{token|CASTE_TILE|c}}.

|-
| {{text anchor|CASTE_COLOR}}
| Caste
|
*fg
*bg
*brightness
| Caste-specific {{token|COLOR|c}}.

|-
| {{text anchor|CASTE_GLOWCOLOR}}
| Caste
|
*fg
*bg
*brightness
| Caste-specific {{token|GLOWCOLOR|c}}.

|-
| {{text anchor|CASTE_GLOWTILE}}
| Caste
|
*tile value or "letter"
| Caste-specific {{token|GLOWTILE|c}}.

|-
| {{text anchor|CASTE_NAME}}
| Caste
|
*singular
*plural
*adjective
| While {{token|NAME|c}} describes the name of the species, {{token|CASTE_NAME|c}} names individuals of the species. Unlike other caste-specific descriptions, this token is required, even for creatures without separate castes. If left undefined, the creature will not show up in the [[arena]] and members of the species will be labeled as "nothing".

|-
| {{text anchor|CASTE_PROFESSION_NAME}}
| Caste
|
*[[Unit type token]] (Profession)
*singular
*plural
| Caste-specific {{token|PROFESSION_NAME|c}}.

|-
| {{text anchor|CASTE_SOLDIER_ALTTILE}}
| Caste
|
*'character' or tile number
| Caste-specific {{token|SOLDIER_ALTTILE|c}}. Requires {{token|CASTE_SOLDIER_TILE|c}}.

|-
| {{text anchor|CASTE_SOLDIER_TILE}}
| Caste
|
*'character' or tile number
| Caste-specific {{token|CREATURE_SOLDIER_TILE|c}}.

|-
| {{text anchor|CASTE_TILE}}
| Caste
|
* tile number or "letter"
| Caste-specific {{token|CREATURE_TILE|c}}.

|-
| {{text anchor|CAVE_ADAPT}}
| Caste
|
| Causes [[cave adaptation]].
Allows for creature's race to be involved in jokes that end in "And the [race] saw the sun and vomited on the spot!"

|-
| {{text anchor|CDI}}
| Caste
|
*Varies
| Specifies interaction details following a {{token|CAN_DO_INTERACTION|c}} token. See [[interaction token]].

|-
| {{text anchor|CHANGE_BODY_SIZE_PERC}}
| Caste
|
*integer
| Multiplies body size by a factor of (integer)%. 50 halves size, 200 doubles.

|-
| {{text anchor|CHANGE_FREQUENCY_PERC}}
| Creature
|
*integer
| Multiplies frequency by a factor of (integer)%.

|-
| {{text anchor|CHILD}}
| Caste
|
*integer
| Age at which creature is considered an adult - one can think of this as the duration of the [[children|child]] stage. Allows the creature's offspring to be rendered fully tame if [[animal trainer|trained]] during their childhood.

|-
| {{text anchor|CHILDNAME}}
| Caste
|
*singular
*plural
| Defines a new name for a creature in the child state at the caste level. For non-caste-specific child names, see {{token|GENERAL_CHILD_NAME|c}}.

|-
| {{text anchor|CLUSTER_NUMBER}}
| Creature
|
*min
*max
| The minimum/maximum numbers of how many creatures per spawned cluster. Vermin fish with this token in combination with temperate ocean and river biome tokens [http://www.bay12forums.com/smf/index.php?topic=51864.msg1122319#msg1122319 will perform seasonal migrations]. Defaults to 1:1 if not specified.

|-
| {{text anchor|CLUTCH_SIZE}}
| Caste
|
*min
*max
|Number of [[egg]]s laid in one sitting.

|-
| {{text anchor|COLONY_EXTERNAL}}
| Caste
|
| Caste hovers around colony.

|-
| {{text anchor|COLOR}}
| Creature
|
*foreground
*background
*brightness
| Color of the creature's tile. (See [[Color]] for usage.)

|-
| {{text anchor|COMMON_DOMESTIC}}
| Caste
|
| When combined with any of {{token|PET|c}}, {{token|PACK_ANIMAL|c}}, {{token|WAGON_PULLER|c}} and/or {{token|MOUNT|c}}, the creature is guaranteed to be domesticated by any [[civilization]] with {{token|COMMON_DOMESTIC_PET|e}}, {{token|COMMON_DOMESTIC_PACK|e}}, {{token|COMMON_DOMESTIC_PULL|e}} and/or {{token|COMMON_DOMESTIC_MOUNT|e}} respectively. Such civilizations will always have access to the creature, even in the absence of wild populations. This token is invalid on {{token|FANCIFUL|c}} creatures.

|-
| {{text anchor|CONVERTED_SPOUSE}}
| Caste
|
| Creatures of this caste's species with the {{token|SPOUSE_CONVERTER|c}} and {{token|NIGHT_CREATURE_HUNTER|c}} tokens will kidnap {{token|SPOUSE_CONVERSION_TARGET|c}}s of an appropriate sex and convert them into castes with CONVERTED_SPOUSE.

|-
| {{text anchor|COOKABLE_LIVE}}
| Caste
|
| Set this to allow the creature to be cooked in meals without first being butchered/cleaned. Used by some water-dwelling vermin such as [[mussel]]s, [[nautilus]]es and [[oyster]]s.

|-
| {{text anchor|CRAZED}}
| Caste
|
| Creature is '[[insanity|berserk]]' and will attack all other creatures, except members of its own species that '''also''' have the CRAZED tag. It will show {{DFtext|Berserk|4:1}} in the [[unit list]]. Berserk creatures go on rampages during [[world generation|worldgen]] much more frequently than non-berserk ones.

|-
| {{text anchor|COPY_TAGS_FROM}}
| Special
|
*creature ID
| Copies another specified creature. This will override any definitions made before it; essentially, it makes this creature identical to the other one, which can then be modified. Often used in combination with {{token|APPLY_CREATURE_VARIATION|c}} to import standard variations from a file. The vanilla [[giant animal]]s and [[animal person|animal people]]s are examples of this token combination.

|-
| {{text anchor|CREATURE}}
| Creature
|
*creature ID
| A unique, arbitrary identifier that begins the definition of each new creature, and is used to reference the creature in other tokens and raws.

|-
| {{text anchor|CREATURE_CLASS}}
| Caste
|
*classname
| An arbitrary creature classification. Can be set to anything, but the only vanilla uses are GENERAL_POISON (used in syndromes), EDIBLE_GROUND_BUG (used as targets for {{token|GOBBLE_VERMIN_CLASS|c}}), MAMMAL, and POISONOUS (both used for kobold pet eligibility). A single creature can have multiple classes.

The full list of tokens that use creature classes is:

* Creature tokens: {{token|GOBBLE_VERMIN_CLASS|c}}, {{token|GOBBLE_VERMIN_CLASS|c}}
* Interaction tokens: {{token|IT_AFFECTED_CLASS|in}}, {{token|IT_IMMUNE_CLASS|in}}
* Animal definition (Entity) tokens: {{token|ANIMAL_CLASS|e}}, {{token|ANIMAL_FORBIDDEN_CLASS|e}}
* Position (Entity) token: {{token|ALLOWED_CLASS|po}}
* Syndrome tokens: {{token|SYN_AFFECTED_CLASS|sy}}, {{token|SYN_IMMUNE_CLASS|sy}}, {{token|CE_SENSE_CREATURE_CLASS|sy}}
|-
| {{text anchor|CREATURE_SOLDIER_TILE}}
| Creature
|
*'character' or tile number
| Creatures active in their civilization's [[military]] will use this tile instead.

|-
| {{text anchor|CREATURE_TILE}}
| Creature
|
*'character' or tile number
| The symbol of the creature in ASCII mode.

|-
| {{text anchor|CREPUSCULAR}}
| Caste
|
| When set, the creature will appear at dawn (between 4:30 AM and 6:00 AM) and in the evening (between 8:00 PM and 10:05 PM) in [[Adventurer mode]].

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

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

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

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

|-
| {{text anchor|CV_REMOVE_TAG}}
| Special
|
*TAG NAME
| Removes a tag. Used in conjunction with creature variation templates.
|}

{{alphabetical TOC|style=margin: 1em auto;}}

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

|-
| {{text anchor|DEMON}}
| Caste
|
| Found on generated [[demon]]s. Marks the caste to be used in the initial wave after breaking into the [[underworld]], and by the demon civilizations created during world-gen breachings{{verify}}.

|-
| {{text anchor|DESCRIPTION}}
| Caste
|
*text
| A brief description of the creature type, as displayed when viewing the creature's description/[[Thoughts and preferences|thoughts & preferences]] screen.

|-
| {{text anchor|DIE_WHEN_VERMIN_BITE}}
| Caste
|
| Causes the creature to die upon attacking. Used by [[honey bee]]s to simulate them dying after using their stingers.

|-
| {{text anchor|DIFFICULTY}}
| Caste
|
*integer
| Increases experience gain during adventure mode. Creatures with a difficulty of 11 or higher are not assigned for quests in adventure mode.

|-
| {{text anchor|DIURNAL}}
| Caste
|
| When set, the creature will only appear during the day (between 6:00 AM and 8:00 PM) in [[Adventurer mode]].

|-
| {{text anchor|DIVE_HUNTS_VERMIN}}
| Caste
|
| The creature hunts vermin by diving from the air. On tame creatures, it has the same effect as {{token|HUNTS_VERMIN|c}}. Found on [[peregrine falcon]]s.

|-
| {{text anchor|DOES_NOT_EXIST}}
| Creature
|
| Adding this token to a creature prevents it from appearing in generated worlds (unless it's marked as [[Entity_token#ANIMAL_ALWAYS_PRESENT|always present]] for a particular civilisation). For example, adding it to [[dog]]s will lead to worlds being generated without dogs in them. Also removes the creature from the [[object testing arena]]'s spawn list. If combined with {{token|FANCIFUL|c}}, artistic depictions of the creature will occur regardless. Used by [[centaur]]s, [[chimera]]s and [[griffon]]s in the vanilla game.

Note: a creature tagged as DOES_NOT_EXIST can still be [[Interaction_token#I_EFFECT|summoned]] successfully, as long as it has a body defined in its raws [http://www.bay12forums.com/smf/index.php?topic=165213.msg8086938#msg8086938], or, another creature can[[Syndrome#CE_BODY_TRANSFORMATION|transform]] into it.
|}

{{alphabetical TOC|style=margin: 1em auto;}}

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

|-
| {{text anchor|EBO_ITEM}}
| Caste
|
*[[item token]]
*[[material token]] (ANY_HARD_STONE can be used for the material)
| Defines the item that the creature drops upon being [[butcher|butchered]]. Used with {{token|EXTRA_BUTCHER_OBJECT|c}}.

|-
| {{text anchor|EBO_SHAPE}}
| Caste
|
*gem shape
| The shape of the creature's extra [[butcher|butchering]] drop. Used with {{token|EXTRA_BUTCHER_OBJECT|c}}.

|-
| {{text anchor|EGG_MATERIAL}}
| Caste
|
* <[[material token]]>
* <[[Material_definition_token#Material_States|material state]]>
| Defines the material composition of [[egg]]s laid by the creature. [[creature_token#LAYS_EGGS|Egg-laying]] creatures in the default game define this 3 times, using LOCAL_CREATURE_MAT:EGGSHELL, LOCAL_CREATURE_MAT:EGG_WHITE, and then LOCAL_CREATURE_MAT:EGG_YOLK. Eggs will be made out of eggshell. Edibility is determined by tags on whites or yolk, but they otherwise do not exist.

|-
| {{text anchor|EGG_SIZE}}
| Caste
|
*size
| Determines the size of laid [[egg]]s. Doesn't affect hatching or cooking, but bigger eggs will be heavier, and may take longer to be hauled depending on the hauler's strength.

|-
| {{text anchor|EQUIPMENT_WAGON}}
| Creature
|
| Makes the creature appear as a large 3×3 [[wagon]] responsible for carrying trade goods, pulled by two {{token|WAGON_PULLER|c}} creatures and driven by a merchant.

|-
| {{text anchor|EQUIPS}}
| Caste
|
| Allows the creature to wear or wield items.

|-
| {{text anchor|EVIL}}
| Creature
|
| The creature is considered evil and will only show up in evil biomes. Civilizations with {{token|USE_EVIL_ANIMALS|e}} can domesticate them regardless of exotic status. Has no effect on cavern creatures except to restrict taming. A civilization with evil creatures can colonise evil areas.

|-
| {{text anchor|EXTRA_BUTCHER_OBJECT}}
| Caste
|
* [[Body token#CATEGORY|BY_CATEGORY]] or [[Body token#CONTYPE|BY_TYPE]] or [[Body token#BP|BY_TOKEN]]
* TYPE, CATEGORY, or TOKEN
| The creature drops an additional object when [[butcher|butchered]], as defined by {{token|EBO_ITEM|c}} and {{token|EBO_SHAPE|c}}. Used for [[gizzard stone]]s in default creatures. For some materials, needs to be defined after caste definitions with SELECT_CASTE:ALL{{Bug|6355}}

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

|-
| {{text anchor|EXTRAVISION}}
| Caste
|
| The creature can see regardless of whether it has working eyes and has full 360 degree vision, making it impossible to strike the creature from a blind spot in combat. Invisible creatures will also be seen, namely [[intelligent undead]] using a "vanish" power.
|}

{{alphabetical TOC|style=margin: 1em auto;}}

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

|-
| {{text anchor|FANCIFUL}}
| Creature
|
| The creature is a thing of legend and known to all civilizations. Its materials cannot be requested or preferred. The tag also adds some art value modifiers. Used by a [[Fanciful|number of creatures]]. Conflicts with {{token|COMMON_DOMESTIC|c}}.

|-
| {{text anchor|FEATURE_ATTACK_GROUP}}
| Caste
|
| Found on [[Animal people#Subterranean animal people|subterranean animal-man]] tribals. Currently defunct. In previous versions{{verify}}, it caused these creatures to crawl out of chasms and underground rivers.

|-
| {{text anchor|FEATURE_BEAST}}
| Caste
|
| Found on [[forgotten beast]]s. Presumably makes it act as such, initiating underground attacks on fortresses, or leads to the pop-up message upon encountering one{{verify}}. Hides the creature from displaying in a world_sites_and_pops file. Does not create historical figures like generated forgotten beasts do.

Requires specifying a {{token|BIOME|c}} in which the creature will live, and both surface and subterranean biomes are allowed. Does not stack with {{token|LARGE_ROAMING|c}} and if both are used the creature will not spawn. Appears to be incompatible with {{token|DEMON|c}} even if used in separate castes.

|-
| {{text anchor|FEMALE}}
| Caste
|
| Makes the creature biologically female, enabling her to [[Breeding|bear young]]. Usually specified inside a caste.

|-
| {{text anchor|FIREIMMUNE}}
| Caste
|
| Makes the creature immune to [[Interaction_token#FIREBALL|FIREBALL]] and [[Interaction_token#FIREJET|FIREJET]] attacks, and allows it to path through high temperature zones, like lava or fires. Does not, by itself, make the creature immune to the damaging effects of burning in [[fire]], and does not prevent general heat damage or melting on its own (this would require adjustments to be made to the creature's body [[Material_definition_token|materials]] - see the [[Dragon/raw|dragon raws]] for an example).

|-
| {{text anchor|FIREIMMUNE_SUPER}}
| Caste
|
| Like {{token|FIREIMMUNE|c}}, but also renders the creature immune to [[Interaction_token#DRAGONFIRE|DRAGONFIRE]] attacks.

|-
| {{text anchor|FISHITEM}}
| Caste
|
| The creature's corpse is a single [[Item_token#FISH_RAW|FISH_RAW]] food item that needs to be cleaned (into a [[Item_token#FISH|FISH]] item) at a [[fishery]] to become edible. Before being cleaned the item is referred to as "raw". The food item is categorized under "fish" on the food and stocks screens, and when uncleaned it is sorted under "raw fish" in the stocks (but does not show up on the food screen).
Without this or {{token|COOKABLE_LIVE|c}}, [[fishing|fished]] vermin will turn into food the same way as non-vermin creatures, resulting in multiple units of food (meat, brain, lungs, eyes, spleen etc.) from a single fished vermin. These units of food are categorized as meat by the game.

|-
| {{text anchor|FIXED_TEMP}}
| Caste
|
*temperature
| The creature's body is constantly at this temperature, heating up or cooling the surrounding area. Alters the temperature of the creature's inventory and all adjacent tiles, [[Temperature|with all the effects that this implies]] - may trigger wildfires at high enough values. Also makes the creature immune to extreme heat or cold, as long as the temperature set is not harmful to the materials that the creature is made from. Corpses and body parts of creatures with a fixed temperature maintain their temperature even after death.

Note that temperatures of 12000 and higher may cause [[path|pathfinding]] issues in fortress mode.

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

|-
| {{text anchor|FLIER}}
| Caste
|
| Allows a creature to fly, independent of it having wings or not. Fortress Mode pathfinding only partially incorporates flying - flying creatures need a land path to exist between them and an area in order to access it, but as long as one such path exists, they do not need to use it, instead being able to fly over intervening obstacles. Winged creatures with this token can lose their ability to fly if their wings are crippled or severed. Winged creatures without this token will be unable to fly. (A 'wing' in this context refers to any body part with its own [[Body_token#FLIER|FLIER]] token).

|-
| {{text anchor|FREQUENCY}}
| Creature
|
*number, max 100
| Determines the chances of a creature appearing within its environment, with higher values resulting in more frequent appearance. Also affects the chance of a creature being brought in a caravan for trading.
This value is used multiply to determine the rarity of animal populations. A creature with [FREQUENCY:50] will appear in 50% of valid biomes, and be present in 50% of the area within those biomes.
When a [[Creature token#CLUSTER_NUMBER|cluster]] spawns, the game effectively considers all creatures that can possibly appear and uses the FREQUENCY value as a ''weight'' - for example, if there are three creatures with frequencies 10/25/50, the creature with [FREQUENCY:50] will appear approximately 58.8% of the time. Defaults to 50 if not specified. Not to be confused with {{token|POP_RATIO|c}}.
|}

{{alphabetical TOC|style=margin: 1em auto;}}

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

|-
| {{text anchor|GAIT}}
| Caste
|
* <gait type>
* <gait name>
* <max [[Gait#Speed|speed]]>
* <build up time>
* <max turning [[Gait#Speed|speed]]>
* <start [[Gait#Speed|speed]]>
* <energy expenditure>
* <gait flag(s)>
| Defines a gait by which the creature can move. See [[Gait]] for more information. Specifically, you likely want to use one of the existing STANDARD_X_GAITS creature variations, as described in [[Gait#Gaits_and_Modding|this subsection]].

* <max speed> indicates the maximum [[Gait#Speed|speed]] achievable by a creature using this gait
* <start speed> indicates the creature's speed when it starts moving using this gait
* <build up time> indicates how long it will take for a creature using this gait to go from <start speed> to <max speed>. For example, a value of 10 means that it should be able to reach the maximum speed by moving 10 [[tile]]s in a straight line over even terrain.
* <max turning speed> indicates the maximum speed permissible when the creature suddenly changes its direction of motion. The creature's speed will be reduced to <max turning speed> if travelling at a higher speed than this before turning.
* <energy expenditure> indicates how energy-consuming the gait is. Higher values cause the creature to tire out faster. Persistent usage of a high-intensity gait will eventually lead to exhaustion and [[Status_icon#Non-flashing|collapse]].

'''NO_BUILD_UP''' can be specified instead of a <start speed> value to make the <max speed> instantly achievable upon initiating movement (this is equivalent to a <build up time> of 0). Note that <build up time> and <max turning speed> are both ignored if specified alongside this (as NO_BUILD_UP trumps <build up time> and preserves <max speed> whilst turning, and <max turning speed> cannot exceed <max speed>) so it is permissible to omit them so long as they are '''both''' omitted together.

It's possible to specify a <start speed> greater than the <max speed>; the moving creature will decelerate towards its <max speed> in this case.

'''valid gait types:'''
*'''WALK''' 
Used for moving normally over ground tiles.

*'''CRAWL''' 
Used for moving over ground tiles whilst [[Status_icon#Non-flashing|prone]].

*'''SWIM''' 
Used for moving through tiles containing [[water]] or [[magma]] at a [[Water#Depth|depth]] of at least 4/7.

*'''FLY''' 
Used for moving through [[open space]].

*'''CLIMB''' 
Used for moving whilst [[Climber|climbing]].

'''valid gait flags:'''
* '''AGILITY''' 
Speeds/slows movement depending on the creature's [[Attribute#Agility|Agility]] stat.

* '''STRENGTH''' 
Speeds/slows movement depending on the creature's [[Attribute#Strength|Strength]] stat.

* '''LAYERS_SLOW''' 
Makes [[Tissue_definition_token#THICKENS_ON_ENERGY_STORAGE|THICKENS_ON_ENERGY_STORAGE]] and [[Tissue_definition_token#THICKENS_ON_STRENGTH|THICKENS_ON_STRENGTH]] tissue layers slow movement depending on how thick they are. Adding the STRENGTH gait flag counteracts the impact of the latter layer.

* '''STEALTH_SLOWS:'''<percentage> 
Slows movement by the specified percentage when the creature is [[Ambusher|sneaking]].

|-
| {{text anchor|GENERAL_BABY_NAME}}
| Creature
|
*singular
*plural
| Like {{token|BABYNAME|c}}, but applied regardless of caste.

|-
| {{text anchor|GENERAL_CHILD_NAME}}
| Creature
|
*singular
*plural
| Like {{token|CHILDNAME|c}}, but applied regardless of caste.

|-
| {{text anchor|GENERAL_MATERIAL_FORCE_MULTIPLIER}}
| Caste
|
*value A
*value B
| Has the same function as {{token|MATERIAL_FORCE_MULTIPLIER|c}}, but applies to all attacks instead of just those involving a specific material. Appears to be overridden by MATERIAL_FORCE_MULTIPLIER ([[werebeast]]s, for example, use both tokens to provide resistance to all materials, with one exception to which they are especially vulnerable).

|-
| {{text anchor|GENERATED}}
| Creature
|
| Found on procedurally generated creatures like [[forgotten beast]]s, [[titan]]s, [[demon]]s, [[angel]]s, and [[night creature]]s. Cannot be specified in user-defined raws.

|-
| {{text anchor|GETS_INFECTIONS_FROM_ROT}}
| Caste
|
| Makes the creature get [[Health_care#Infection|infections]] from necrotic tissue.

|-
| {{text anchor|GETS_WOUND_INFECTIONS}}
| Caste
|
| Makes the creature's wounds become [[Health_care#Infection|infected]] if left untreated for too long.

|-
| {{text anchor|GLOWCOLOR}}
| Creature
|
*foreground
*background
*brightness
| The colour of the creature's {{token|GLOWTILE|c}}.

|-
| {{text anchor|GLOWTILE}}
| Creature
|
*ascii character
| If present, the being glows in the dark (generally used for Adventurer 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 {{token|CASTE_GLOWTILE|c}} instead.

|-
| {{text anchor|GNAWER}}
| Caste
|
*verb
| The creature can and will gnaw its way out of [[animal trap]]s and [[cage]]s using the specified verb, depending on the material from which it is made (normally wood).

|-
| {{text anchor|GOBBLE_VERMIN_CLASS}}
| Caste
|
*class
| The creature eats vermin of the specified class.

|-
| {{text anchor|GOBBLE_VERMIN_CREATURE}}
| Caste
|
*creature
*caste
| The creature eats a specified [[vermin]].

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

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

|-
| {{text anchor|GO_TO_TAG}}
| Special
|
| When using tags from an existing creature, inserts new tags ''before'' the specified tag.

|-
| {{text anchor|GOOD}}
| Creature
|
| Creature is considered good and will only show up in good biomes - [[unicorn]]s, for example. Civilizations with {{token|USE_GOOD_ANIMALS|e}} can domesticate them regardless of exotic status. Has no effect on cavern creatures except to restrict taming. A civilization that has good creatures can colonise good areas in world-gen.

|-
| {{text anchor|GRASSTRAMPLE}}
| Caste
|
*value
| The value determines how rapidly [[grass]] is trampled when a creature steps on it - a value of 0 causes the creature to never damage grass, while a value of 100 causes grass to be trampled as rapidly as possible. Defaults to 5.

|-
| {{text anchor|GRAVITATE_BODY_SIZE}}
| Caste
|
*target value
| Used in Creature Variants. This token changes the adult body size to the average of the old adult body size and the target value and scales all intermediate growth stages by the same factor.

|-
| {{text anchor|GRAZER}}
| Caste
|
*number
| The creature is a grazer - if tamed in fortress mode, it needs a pasture to survive. The higher the number, the less frequently it needs to eat in order to live. Not used since 0.40.12, replaced by {{token|STANDARD_GRAZER|c}} to fix {{bugl|4113}}.
|}

{{alphabetical TOC|style=margin: 1em auto;}}

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

|-
| {{text anchor|HABIT}}
| Caste
|
*type
*probability
| Defines certain behaviors for the creature. The habit types are:
*COLLECT_TROPHIES
*COOK_PEOPLE
*COOK_VERMIN
*GRIND_VERMIN
*COOK_BLOOD
*GRIND_BONE_MEAL
*EAT_BONE_PORRIDGE
*USE_ANY_MELEE_WEAPON
*GIANT_NEST
*COLLECT_WEALTH.
These require the creature to have a {{token|LAIR|c}} to work properly, and also don't seem to work on creatures who are not a {{token|SEMIMEGABEAST|c}}, {{token|MEGABEAST|c}}, or{{token|NIGHT_CREATURE_HUNTER|c}}.

|-
| {{text anchor|HABIT_NUM}}
| Caste
|
*number or TEST_ALL
| "If you set HABIT_NUM to a number, it should give you that exact number of habits according to the weights.".{{cite forum|60554/1719248}} All lists of HABITs are preceded by [HABIT_NUM:TEST_ALL]

|-
| {{text anchor|HAS_NERVES}}
| Caste
|
| The creature has nerves in its muscles. Cutting the muscle tissue can sever motor and sensory nerves.

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

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

|-
| {{text anchor|HOMEOTHERM}}
| Caste
|
*number or NONE
| Default 'NONE'. The creature's normal body [[temperature]]. Creature ceases maintaining temperature on death unlike fixed material temperatures. Provides minor protection from environmental temperature to the creature.

|-
| {{text anchor|HUNTS_VERMIN}}
| Caste
|
| Creature hunts and kills nearby [[vermin]], randomly walking between places with food laying on the ground or in stockpiles, to check for possible [VERMIN_EATER] vermin, but they'll kill any other vermin too. Do not include this creature token on an intelligent entity that you intend to play as in fortress mode because it will prevent them from feeding themselves.

|}

{{alphabetical TOC|style=margin: 1em auto;}}

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

|-
| {{text anchor|IMMOBILE}}
| Caste
|
| The creature cannot move. Found on [[sponge]]s. Will also stop a creature from breeding in fortress mode (MALE and FEMALE are affected, if one is IMMOBILE; no breeding will happen).

|-
| {{text anchor|IMMOBILE_LAND}}
| Caste
|
| The creature is immobile while on land. Only works on {{token|AQUATIC|c}} creatures which can't breathe on land.

|-
| {{text anchor|IMMOLATE}}
| Caste
|
| The creature radiates [[fire]]. It will ignite, and potentially completely destroy, items the creature is standing on. Also gives the vermin a high chance of escaping from [[animal trap]]s and [[cage]]s made of any flammable materials (specifically ones that could be ignited by magma).

|-
| {{text anchor|INTELLIGENT}}
| Caste
|
| Alias for {{token|CAN_SPEAK|c}} + {{token|CAN_LEARN|c}}.

|-
| {{text anchor|ITEMCORPSE}}
| Caste
|
* [[item token]]
* [[material token]]
| Determines if the creature leaves behind a non-standard corpse (i.e. wood, statue, bars, stone, pool of liquid, etc.). [[Ethics]] may prevent actually using the item in jobs or reactions.

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

{{alphabetical TOC|style=margin: 1em auto;}}

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

|-
| {{text anchor|LAIR}}
| Caste
|
*type
*probability
| Found on megabeasts, semimegabeasts, and night creatures. The creature will seek out sites of this type and take them as lairs. The lair types are:
*SIMPLE_BURROW
*SIMPLE_MOUND
*WILDERNESS_LOCATION
*SHRINE
*LABYRINTH

|-
| {{text anchor|LAIR_CHARACTERISTIC}}
| Caste
|
*characteristic
*probability
| Defines certain features of the creature's lair. The only valid characteristic is HAS_DOORS.

|-
| {{text anchor|LAIR_HUNTER}}
| Caste
|
| This creature will actively hunt adventurers in its lair.

|-
| {{text anchor|LAIR_HUNTER_SPEECH}}
| Caste
|
*speech file
| What this creature says while hunting adventurers in its lair.

|-
| {{text anchor|LARGE_PREDATOR}}
| Caste
|
| Will attack other creatures that are smaller than it. Tamed large predators will still attack wildlife. In [[fortress mode]], only one group of "large predators" (possibly two groups on "savage" maps) will appear on any given map. In [[adventurer mode]], large predators will try to ambush and attack you (and your party will attack them back). When tamed, large predators tend to be much more aggressive to enemies than non-large predators, making them a good choice for an animal army. They may go on rampages in worldgen, and adventurers may receive quests to kill them. Also, they can be mentioned in the intro paragraph when starting a fortress e.g. "ere the wolves get hungry."
A single biome supports 7 large predator species, picking randomly and rolling a d100 under its {{token|FREQUENCY|c}} to add it until all 7 slots are filled.

Incompatible with {{token|PACK_ANIMAL|c}} on a technicality, if included: hauled items are likely to be dropped upon entering the map (even if {{token|TRADE_CAPACITY|c}} is present) in contrast to when the merchants depart.

|-
| {{text anchor|LARGE_ROAMING}}
| Creature
|
| This is the core requisite tag allowing the creature to spawn as a wild animal in the appropriate biomes. Requires specifying a {{token|BIOME|c}} in which the creature will spawn. Does not require specifying a frequency, population number, or cluster number.

This tag stacks with {{token|MEGABEAST|c}}, {{token|SEMIMEGABEAST|c}}, or {{token|NIGHT_CREATURE_HUNTER|c}}; if used with one of these tags, the creature will spawn as both a boss and as a wild animal. This tag does not stack with {{token|FEATURE_BEAST|c}} and if both are used the creature will not spawn. This tag is unaffected by {{token|DEMON|c}}.

|-
| {{text anchor|LAYS_EGGS}}
| Caste
|
| Creature lays [[egg]]s instead of giving birth to live young.

|-
| {{text anchor|LAYS_UNUSUAL_EGGS}}
| Caste
|
* [[item token]]
* [[material token]]
| Creature lays the specified item instead of regular eggs.

|-
| {{text anchor|LIGAMENTS}}
| Caste
|
* [[material token]]
*healing rate
| The creature has ligaments in its {{token|CONNECTIVE_TISSUE_ANCHOR|td}} tissues (bone or chitin by default). Cutting the bone/chitin tissue severs the ligaments, disabling motor function if the target is a limb.

|-
| {{text anchor|LIGHT_GEN}}
| Caste
|
| A vermin featuring this tag will remain visible to an adventurer even at night.

Subterranean vermin which feature this token will flicker in unexposed and unrevealed cavern layers while playing in Fortress Mode.

|-
| {{text anchor|LIKES_FIGHTING}}
| Caste
|
| The creature will attack enemies rather than flee from them. This tag has the same effect on player-controlled creatures - including modded dwarves. Retired as of v0.40.14 in favor of {{token|LARGE_PREDATOR|c}}.

|-
| {{text anchor|LISP}}
| Caste
|
| Creature uses "sssssnake talk" (multiplies 'S' when talking - "My name isss Recisssiz."). Used by [[Serpent man|serpent men]] and [[Reptile man|reptile men]] in the vanilla game. C's with the same pronunciation (depending on the word) are not affected by this token.

|-
| {{text anchor|LITTERSIZE}}
| Caste
|
* minimum
* maximum
| Determines the number of offspring per one birth; default 1-3, not used in vanilla raws. See also {{token|MULTIPLE_LITTER_RARE|c}}.

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

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

|-
| {{text anchor|LOCKPICKER}}
| Caste
|
| Lets a creature open [[door]]s that are set to forbidden in fortress mode.

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

|-
| {{text anchor|LOW_LIGHT_VISION}}
| Caste
|
*number
| Determines how well a creature can see in the dark - higher is better. Dwarves have 10000, which amounts to perfect nightvision.
|}

{{alphabetical TOC|style=margin: 1em auto;}}

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

|-
| {{text anchor|MAGICAL}}
| Caste
|
| According to Toady One, this is completely interchangeable with {{token|AT_PEACE_WITH_WILDLIFE|c}} and might have been used in very early versions of the game by wandering wizards or the ent-type tree creatures that used to be animated by elves. [http://www.bay12forums.com/smf/index.php?topic=169696.msg8316954#msg8316954]

|-
| {{text anchor|MAGMA_VISION}}
| Caste
|
| The creature is able to see while submerged in [[magma]].

|-
| {{text anchor|MALE}}
| Caste
|
| Makes the creature biologically male. Usually declared inside a caste.

|-
| {{text anchor|MANNERISM|MANNERISM_*}}
| Caste
|
*occasionally body part
| Adds a possible mannerism to the creature's profile. See [[creature mannerism token]] for further info.

|-
| {{text anchor|MATERIAL}}
| Creature
|
*material id
| Begins defining a new local material. Follow this with standard material definition tokens to define the material.

|-
| {{text anchor|MATERIAL_FORCE_MULTIPLIER}}
| Caste
|
*[[Material token]]
*value A
*value B
| When struck with a weapon made of the specified material, the force exerted will be multiplied by A/B, thus making the creature more or less susceptible to this material. For example, if A is 2 and B is 1, the force exerted by the defined material will be doubled. If A is 1 and B is 2, it will be halved instead. See also {{token|GENERAL_MATERIAL_FORCE_MULTIPLIER|c}}, which can be used to make this sort of effect applicable to all materials.

|-
| {{text anchor|MATUTINAL}}
| Caste
|
| When set, the creature will only appear at dawn (between 4:30 AM and 6:00 AM) in [[Adventurer mode]].

|-
| {{text anchor|MAXAGE}}
| Caste
|
*min
*max
| Determines the creature's natural lifespan, using the specified minimum and maximum age values (in years). Each individual creature with this token is generated with a predetermined date (calculated down to the exact [[time|tick]]!) between these values, at which it is destined to die of old age, should it live long enough. Note that the probability of death at any given age does not increase as the creature gets older [http://i.imgur.com/A1A4aA9.png].
Creatures which lack this token are naturally immortal. The [[Syndrome#CE_ADD_TAG|NO_AGING]] syndrome tag will prevent death by old age from occurring. Also note that, among civilized creatures, castes which lack this token will refuse to marry others with it, and vice versa.

|-
| {{text anchor|MEANDERER}}
| Caste
|
| Makes the creature slowly stroll around, unless it's in combat or performing a job. If combined with {{token|CAN_LEARN|c}}, will severely impact their [[pathfinding]] and lead the creature to move extremely slowly when not performing any task. Problematically applies to animal people based on the animal and war trained animals{{bug|9588}}.

|-
| {{text anchor|MEGABEAST}}
| Caste
|
| A 'boss' creature. A small number of the creatures are created during worldgen, their histories and descendants (if any) will be tracked in worldgen (as opposed to simply 'spawning'), and they will occasionally go on rampages, potentially leading to worship if they attack the same place multiple times. Their presence and number will also influence age names. When appearing in fortress mode, they will have a pop-up message announcing their arrival. They will remain hostile to military even after being tamed.{{bug|10731}} See [[megabeast]] page for more details.

Requires specifying a {{token|BIOME|c}} in which the creature will live. Subterranean biomes appear to not be allowed. Does stack with {{token|LARGE_ROAMING|c}} and if both are used the creature will spawn as both historical bosses and as wild animals.

|-
| {{text anchor|MENT_ATT_CAP_PERC}}
| Caste
|
*[[Attribute|ATTRIBUTE]] Token
*Cap %
|Default is 200. This means you can increase your attribute to 200% of its starting value (or the average value + your starting value if that is higher).

|-
| {{text anchor|MENT_ATT_RANGE}}
| Caste
|
*[[Attribute|ATTRIBUTE]]
*lowest
*lower
*low
*median
*high
*higher
*highest
| Sets up a [[Attribute#Soul_attributes|mental attribute]]'s range of values (0-5000). All mental attribute ranges default to 200:800:900:1000:1100:1300:2000.

|-
| {{text anchor|MENT_ATT_RATES}}
| Caste
|
*[[Attribute|ATTRIBUTE]] Token
*cost to improve
*unused counter rate
*rust counter rate
*demotion counter rate
| [[Attribute#Soul_attributes|Mental attribute]] gain/decay rates. Lower numbers in the last three slots make decay occur faster. Defaults are 500:4:5:4.

|-
| {{text anchor|MILKABLE}}
| Caste
|
* [[material token]]
* frequency
| Allows the creature to be [[milk]]ed in the [[farmer's workshop]]. The frequency is the amount of [[time|ticks]] the creature needs to "recharge" (i.e. how much time needs to pass before it can be milked again). Does not work on [[#CAN_LEARN|sentient]] creatures, regardless of [[ethics]].

|-
| {{text anchor|MISCHIEVIOUS}}
| Caste
|
| Alias for {{token|MISCHIEVOUS|c}}.

|-
| {{text anchor|MISCHIEVOUS}}
| Caste
|
| The creature spawns [[stealth]]ed and will attempt to path into the fortress, pulling any [[lever]]s it comes across. It will be invisible on the map and [[unit list]] until spotted by a citizen, at which point the game will pause and recenter on the creature. Used by [[gremlin]]s in the vanilla game. "They go on little missions to mess with various fortress buildings, not just levers."

|-
| {{text anchor|MODVALUE}}
| Caste
|
| Seemingly no longer used.

|-
| {{text anchor|MOUNT}}
| Caste
|
| Creature may be used as a [[mount]]. No use for the player in fortress mode, but enemy sieging forces may arrive with cavalry. Mounts are usable in adventure mode.

|-
| {{text anchor|MOUNT_EXOTIC}}
| Caste
|
| Creature may be used as a [[mount]], but civilizations cannot domesticate it in worldgen without certain exceptions.

|-
| {{text anchor|MULTIPART_FULL_VISION}}
| Caste
|
| Allows the creature to have all-around vision, as long as it has multiple heads that can see.

|-
| {{text anchor|MULTIPLE_LITTER_RARE}}
| Caste
|
| Makes the species usually produce a single offspring per birth, with a 1/500 chance of using the {{token|LITTERSIZE|c}} as usual. Requires {{token|FEMALE|c}}.

|-
| {{text anchor|MUNDANE}}
| Creature
|
| Marks if the creature is an actual real-life creature. Only used for age-names at present.
|}

{{alphabetical TOC|style=margin: 1em auto;}}

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

|-
| {{text anchor|NAME}}
| Creature
|
*singular
*plural
*adjective
| The generic name for any creature of this type - will be used for referring to the species in the abstract, such as the default material prefix. For labeling individual creatures, {{token|CASTE_NAME|c}} is necessary. If left undefined, the creature will be labeled as "nothing" by the game.

Some examples of adjective use:
* "super''dwarven'' strength"
* "the ''dwarven'' hillocks of X"
* Deity species as in "''feline'' deity"
* Megabeast attacks in worldgen. One with multiple dragons being a "''draconic'' rampage"

|-
| {{text anchor|NATURAL}}
| Caste
|
| Animal is considered to be natural. NATURAL animals will not engage creatures tagged with {{token|AT_PEACE_WITH_WILDLIFE|c}} in combat unless they are members of a hostile entity and vice-versa.

|-
| {{text anchor|NATURAL_ANIMAL}}
| Caste
|
| Alias of {{token|NATURAL|c}}.

|-
| {{text anchor|NATURAL_SKILL}}
| Caste
|
*[[Skill_token|Skill token]]
*value
| The creature possesses the specified [[skill]] at this level inherently - that is, it begins with the skill at this level, and the skill may never rust below that. A value of 15 is legendary.

|-
| {{text anchor|NIGHT_CREATURE}}
| Caste
|
| Creatures with this token can appear as [[experiment|experiments]].
Causes the creature to count as {{token|NOT_LIVING|c}}. Killing a creature featuring this token provides one point of "hero" reputation. Adds the creature's description as part of the initial summary of their historical figure in legends mode. Prevents creature behavior enabled by {{token|LARGE_PREDATOR|c}}. People will react to creatures with this token as a night creature (natch). In adventure mode, ambushes involving these units will say "Night creature!" instead of "Ambush!"

Prevents the AI from using ANIMATE interactions, unless the newly-animated{{token|OPPOSED_TO_LIFE|c}}undead will not attack them. The check for this is specifically whether the unit is:
*a ghost
*an animated unit
*a unit with the {{token|NO_AGING|c}} token added via {{token|CE_ADD_TAG|c}}. (This allows for the default exclusion of elves and goblins, unless raised as intelligent undead.)

''This token should not be confused with other NIGHT_CREATURE_X tokens.''
''This token is not well understood at the present time.''

|-
| {{text anchor|NIGHT_CREATURE_BOGEYMAN}}
| Caste
|
| Creatures with this token can appear in [[bogeyman|bogeyman ambushes]] in [[adventure mode]], where they adopt classical bogeyman traits such as stalking the adventurer and vaporising when dawn breaks. Such traits do not manifest if the creature is encountered outside of a bogeyman ambush (for instance, as a megabeast or a civilised being). In addition, their corpses and severed body parts turn into [[smoke]] after a short while. Note that setting the "Number of Bogeyman Types" in [[advanced world generation]] to 0 will only remove randomly-generated bogeymen.

|-
| {{text anchor|NIGHT_CREATURE_EXPERIMENTER}}
| Caste
|
| Found on some [[necromancer]]s. Creatures with this tag may periodically "perform horrible experiments" offscreen, during which they can use creature-targeting interactions with an <code>[[Interaction_token#I_SOURCE|[I_SOURCE:EXPERIMENT]]]</code> tag on living creatures in their area. Worlds are generated with a list of procedurally-generated experiments, allowing necromancers to turn living people and animals into [[Infected_ghoul|ghouls]] and [[Experiment|other experimental creatures]], and these will automatically be available to all experimenters; it does not appear possible to prevent this. You can mod in your own custom experiment interactions, but these are used very infrequently due to the large number of generated experiments.

|-
| {{text anchor|NIGHT_CREATURE_HUNTER}}
| Caste
|
| Found on [[night troll]]s and [[werebeast]]s. Implies that the creature is a [[night creature]], and shows its description in [[legends mode]] entry. The creature is always hostile and will start [[no quarter]] combat with any nearby creatures, except for members of its own race. Note that this tag does not override the creature's normal behavior in [[fortress mode]] except for the aforementioned aggression, and doesn't prevent the creature from fleeing the battles it started. It also removes the creature's materials from stockpile settings list, making them be stored there regardless of settings.

Does stack with {{token|LARGE_ROAMING|c}} and if both are used the creature will spawn as both historical hunters and as wild animals; this requires specifying a {{token|BIOME|c}} in which the creature will live, and subterranean biomes are allowed.

This tag causes the usual behaviour of werebeasts in worldgen, that is, fleeing towns upon being cursed and conducting raids from a lair. If this tag is absent from a deity curse, the accursed will simply be driven out of towns in a similar manner to [[vampire]]s. When paired with SPOUSE_CONVERTER, a very small population of the creature will be created during worldgen (sometimes only a single individual will be created), and their histories will be tracked (that is, they will not spawn spontaneously later, they must either have children or convert other creatures to increase their numbers). The creature will settle in a lair and go on rampages during worldgen. It will actively attempt to seek out potential conversion targets to abduct, convert, and have children with (if possible).

|-
| {{text anchor|NIGHT_CREATURE_NIGHTMARE}}
| Caste
|
| Found on [[nightmare]]s. Corpses and severed body parts derived from creatures with this token turn into [[smoke]] after a short while.

|-
| {{text anchor|NO_AUTUMN}}
| Caste
|
| The creature caste does not appear in [[Calendar|autumn]].

|-
| {{text anchor|NO_CONNECTIONS_FOR_MOVEMENT}}
| Caste
|
| Creature doesn't require connected body parts to move{{verify}}; generally used on undead creatures with connections that have rotted away.

|-
| {{text anchor|NO_DIZZINESS}}
| Caste
|
| Creature cannot become [[Symptom#Dizziness|dizzy]].

|-
| {{text anchor|NO_DRINK}}
| Caste
|
| Creature does not need to drink.

|-
| {{text anchor|NO_EAT}}
| Caste
|
| Creature does not need to [[food|eat]].

|-
| {{text anchor|NO_FEVERS}}
| Caste
|
| Creature cannot suffer [[Symptom#Fever|fevers]].

|-
| {{text anchor|NO_GENDER}}
| Caste
|
| The creature is biologically sexless, making it unable to [[breeding|breed]].

|-
| {{text anchor|NO_PHYS_ATT_GAIN}}
| Caste
|
| The creature cannot raise any [[Attribute#Body_attributes|physical attributes]].

|-
| {{text anchor|NO_PHYS_ATT_RUST}}
| Caste
|
| The creature cannot lose any [[Attribute#Body_attributes|physical attributes]].

|-
| {{text anchor|NO_SLEEP}}
| Caste
|
| Creature does not need to sleep, but can still be rendered unconscious by other means.

|-
| {{text anchor|NO_SPRING}}
| Caste
|
| The creature caste does not appear in [[Calendar|spring]].

|-
| {{text anchor|NO_SUMMER}}
| Caste
|
| The creature caste does not appear in [[Calendar|summer]].

|-
| {{text anchor|NO_THOUGHT_CENTER_FOR_MOVEMENT}}
| Caste
|
| The bodyparts of this creature don't need to be connected to an organ with the {{token|THOUGHT|body}} tag in order to have motor function. Generally used on creatures that don't have brains. If a creature doesn't have a thought part and doesn't have this token, it will be unable to grasp or stand. Nautilus men experience this issue in vanilla.

|-
| {{text anchor|NO_UNIT_TYPE_COLOR}}
| Caste
|
| Prevents creature from selecting its color based on its profession (e.g. Miner, Hunter, Wrestler).

|-
| {{text anchor|NO_VEGETATION_PERTURB}}
| Caste{{Verify}}
|
| Likely prevents the creature from leaving broken vegetation tracks.{{Verify}}

|-
| {{text anchor|NO_WINTER}}
| Caste
|
| The creature caste does not appear in [[Calendar|winter]].

|-
| {{text anchor|NOBONES}}
| Caste
|
| Creature has no bones.

|-
| {{text anchor|NOBREATHE}}
| Caste
|
| Creature doesn't need to breathe or have {{token|BREATHE|body}}parts in its body, nor can it drown or be strangled. Creatures living in magma must have this tag, otherwise they will drown.

|-
| {{text anchor|NOCTURNAL}}
| Caste
|
| When set, the creature will only appear at night (after 10:05 PM and before 4:30 AM) in [[Adventurer mode]].

|-
| {{text anchor|NOEMOTION}}
| Caste
|
| Creature has no emotions, thus; it is immune to the effects of [[stress]] and unable to rage, and its [[need]]s cannot be fulfilled in any way. Used on [[undead]] in the vanilla game.

|-
| {{text anchor|NOEXERT}}
| Caste
|
| Creature can't become tired or over-exerted from taking too many combat actions, or moving at full speed for extended periods of time.

|-
| {{text anchor|NOFEAR}}
| Caste
|
| Creature doesn't feel fear and will never flee from battle, and will be immune to [[ghost]]s' attempts to 'scare it to death'. Additionally, it causes [[bogeyman|bogeymen]] and [[nightmare]]s to become friendly towards the creature.

|-
| {{text anchor|NOMEAT}}
| Caste
|
| Creature will not be hunted or fed to wild beasts.

|-
| {{text anchor|NONAUSEA}}
| Caste
|
| Creature isn't nauseated by gut hits and cannot vomit.

|-
| {{text anchor|NOPAIN}}
| Caste
|
| Creature doesn't feel pain.

|-
| {{text anchor|NOSKIN}}
| Caste
|
| Creature will not drop a hide when [[butcher|butchered]].

|-
| {{text anchor|NOSKULL}}
| Caste
|
| Creature will not drop a skull on butchering, rot, or decay of severed head.

|-
| {{text anchor|NOSMELLYROT}}
| Caste
|
| Does not produce [[miasma]] when rotting.

|-
| {{text anchor|NOSTUCKINS}}
| Caste
|
| Weapons can't get stuck in the creature.

|-
| {{text anchor|NOSTUN}}
| Caste
|
| Creature can't be stunned and knocked unconscious by pain or head injuries. Creatures with this tag never wake up from sleep in Fortress Mode. If this creature needs to sleep while playing, it will die.

|-
| {{text anchor|NOT_BUTCHERABLE}}
| Caste
|
| Corpses from this creature cannot be [[butcher|butchered]]. Does not prevent the creature from being slaughtered while alive, however.

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

|-
| {{text anchor|NOTHOUGHT}}
| Caste
|
| Creature doesn't require a {{token|THOUGHT|body}} body part to survive. Has the added effect of preventing speech, though directly controlling creatures that would otherwise be capable of speaking allows them to engage in conversation.
|}

{{alphabetical TOC|style=margin: 1em auto;}}

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

|-
| {{text anchor|ODOR_LEVEL}}
| Caste
|
*number
| How easy the creature is to [[smell]]. The higher the number, the easier the creature is to sniff out. Defaults to 50. Vanilla creatures have values from 0 (undetectable) to 90 (noticeable by humans and dwarves).

|-
| {{text anchor|ODOR_STRING}}
| Caste
|
*string
| What the creature [[smell]]s like. If no odor string is defined, the creature name (not the caste name) is used.

|-
| {{text anchor|OPPOSED_TO_LIFE}}
| Caste
|
| Is hostile to all creatures except undead and other non-living ones and will show {{DFtext|Opposed to life|0:1}} in the [[unit list]]. Used by [[undead]] in the vanilla game. Functions without the {{token|NOT_LIVING|c}} token, and seems to imply said token as well. Undead will not be hostile to otherwise-living creatures given this token. Living creatures given this token will attack living creatures that lack it, while ignoring other living creatures that also have this token.

|-
| {{text anchor|ORIENTATION}}
| Caste
|
*MALE/FEMALE
*disinterested chance
*casual chance
*strong chance
| Determines caste's likelihood of having sexual attraction to certain sexes. Values default to 75:20:5 for the same sex and 5:20:75 for the opposite sex. The first value indicates how likely to be entirely uninterested in the sex, the second decides if the creature will be able to become lovers with that sex, the third decides whether they will be able to marry in worldgen and post-worldgen world activities (which implies being able to become lovers). Marriage seems to be able to happen in fort mode play regardless, as long as they are lovers first.

|-
| {{text anchor|OUTSIDER_CONTROLLABLE}}
| Caste
|
| Lets you play as an [[Adventurer_mode_character_creation#Outsider|outsider]] of this species in adventure mode.

|}

{{alphabetical TOC|style=margin: 1em auto;}}

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

|-
| {{text anchor|PACK_ANIMAL}}
| Caste
|
| Allows the creature to be used as a pack animal. Used by [[trading|merchants]] without wagons and adventurers. Also prevents creature from dropping hauled items on its own -- do ''not'' use for player-controllable creatures! May lead to the creature being domesticated during worldgen, even if it doesn't have {{token|COMMON_DOMESTIC|c}}.

Creatures with this tag but without {{token|BENIGN|c}}, and/or with {{token|LARGE_PREDATOR|c}} leads to hauled items being dropped.

|-
| {{text anchor|PARALYZEIMMUNE}}
| Caste
|
| The creature is immune to all [[Syndrome#CE_PARALYSIS|paralyzing]] special attacks.

|-
| {{text anchor|PATTERNFLIER}}
| Caste
|
| Used to control the bat riders with paralyze-dart blowguns that flew through the 2D chasm. Doesn't do anything now.

|-
| {{text anchor|PCG_LAYERING}}
| Creature
|
*[[Procedural graphics layer|Layering type]]
| Adds a layer to the current {{token|PROCEDURAL_CREATURE_GRAPHICS|c}} definition.

|-
| {{text anchor|PEARL}}
| Caste
|
| Does nothing.

|-
| {{text anchor|PENETRATEPOWER}}
| Caste
|
*value
| Controls the ability of [[vermin]] to find a way into containers when they are eating food from your stockpiles.

Objects made of most materials (e.g. metal) roll a number from 0-100, and if the resulting number is greater than the penetrate power, their contents escape for the time being. Objects made of [[wood]], [[leather]], [[amber]], or [[coral]] roll 0-95, and items made of [[cloth]] roll 0-90.

|-
| {{text anchor|PERSONALITY}}
| Caste
|
*ATTRIBUTE
*lowest
*median
*highest
| Determines the range and chance of personality facets. Standard is 0:50:100. See [[personality facet]] for more info.

|-
| {{text anchor|PET}}
| Caste
|
| Allows the creature to be [[Animal_trainer|tamed]] in Fortress mode. Prerequisite for all other working animal roles. Civilizations that encounter it in worldgen will tame and domesticate it for their own use. Adding this to civilization members will classify them as pets instead of citizens, with all the [[Fun|problems]] that entails. However, you can solve these problems using the popular plugin [https://dffd.bay12games.com/file.php?id=13095| Dwarf Therapist], which is completely unaffected by the tag.

|-
| {{text anchor|PET_EXOTIC}}
| Caste
|
| Allows the creature to be [[Animal_trainer|tamed]] in Fortress mode. Prequisite for all other working animal roles. Civilizations cannot domesticate it in worldgen, with certain exceptions. More difficult to tame?{{verify}} Adding this to civilization members will classify them as pets instead of citizens, with all the [[Fun|problems]] that entails. ([[Gremlin|Example]]).

|-
| {{text anchor|PETVALUE}}
| Caste
|
*value
| How valuable a tamed animal is. Actual cost in points in the embarking screen is 1+(PETVALUE/2) for an untrained animal, 1+PETVALUE for a war/hunting one.

|-
| {{text anchor|PETVALUE_DIVISOR}}
| Caste
|
*value
| Divides the creature's {{token|PETVALUE|c}} by the specified number. Used by [[honey bee]]s to prevent a single hive from being worth a fortune.

|-
| {{text anchor|PHYS_ATT_CAP_PERC}}
| Caste
|
*[[Attribute|ATTRIBUTE]] Token
*Cap %
|Default is 200. This means you can increase your attribute to 200% of its starting value (or the average value + your starting value if that is higher).

|-
| {{text anchor|PHYS_ATT_RANGE}}
| Caste
|
*[[Attribute|ATTRIBUTE]]
*lowest
*lower
*low
*median
*high
*higher
*highest
| Sets up a [[Attribute#Body_attributes|physical attribute]]'s range of values (0-5000). All physical attribute ranges default to 200:700:900:1000:1100:1300:2000.

|-
| {{text anchor|PHYS_ATT_RATES}}
| Caste
|
*[[Attribute|ATTRIBUTE]] Token
*cost to improve
*unused counter rate
*rust counter rate
*demotion counter rate
| [[Attribute#Body_attributes|Physical attribute]] gain/decay rates. Lower numbers in the last three slots make decay occur faster. Defaults for STRENGTH, AGILITY, TOUGHNESS, and ENDURANCE are 500:3:4:3, while RECUPERATION and DISEASE_RESISTANCE default to 500:NONE:NONE:NONE.

|-
| {{text anchor|PLUS_BP_GROUP}}
| Caste
|
*BY_TYPE, BY_CATEGORY, or BY_TOKEN
*body type, category, or token
| Adds a body part group to selected body part group. Presumably used immediately after {{token|SET_BP_GROUP|c}}.

|-
| {{text anchor|PLUS_MATERIAL}}
| Creature
|
*material
| Adds a material to selected materials. Used immediately after {{token|SELECT_MATERIAL|c}}.

|-
| {{text anchor|POP_RATIO}}
| Caste
|
*number (max 100000)
| Weighted population of caste; Lower is rarer. Not to be confused with {{token|FREQUENCY|c}}. A weight of 0 will{{version|51.06 experimental}} prevent a caste from spawning naturally. Regardless of pop ratio, [[Position token|Position]]s that only allow a certain caste can force it to spawn.

|-
| {{text anchor|POPULATION_NUMBER}}
| Creature
|
*min
*max
| The minimum/maximum numbers of how many of these creatures are present in each world map tile of the appropriate region. Defaults to 1:1 if not specified.

|-
| {{text anchor|POWER}}
| Caste
|
| Allows the being to represent itself as a deity, allowing it to become the leader of a civilized group. Not used by any creatures in the vanilla game. Requires {{token|CAN_SPEAK|c}} to actually do anything more than settle at a location (e.g. write books, lead armies, profane temples). Doesn't appear to do anything for creatures that are already civilized. Once the creature ascends to a position of leadership, it will proceed to act as a standard ruler for their entity and fulfill the same functions (hold tournaments, tame creatures, etc.).

|-
| {{text anchor|PREFSTRING}}
| Creature
|
*string
| Sets what other creatures [[Preferences|prefer]] about this creature. "Urist likes dwarves for their beards." Multiple entries will be chosen from at random. Creatures lacking a PREFSTRING token will never appear under another's preferences.

|-
| {{text anchor|PROCEDURAL_CREATURE_GRAPHICS}}
| Creature
|
* [[Graphics_token#Basic_creature_sprite_types|Sprite type]] or Caste then sprite type
| Makes the creature have procedural graphics built for it, like forgotten beasts/demons/titans/experiments. Must be associated with PCG_LAYERING tokens.

|-
| {{text anchor|PROFESSION_NAME}}
| Creature
|
*[[Unit type token]] (Profession)
*singular
*plural
| The generic name for members of this profession, at the creature level. In order to give members of specific castes different names for professions, use {{token|CASTE_PROFESSION_NAME|c}} instead.

|-
| {{text anchor|PRONE_TO_RAGE}}
| Caste
|
*Chance
| Creature has a percentage chance to flip out at visible non-friendly creatures. Enraged creatures attack anything regardless of timidity and get a strength bonus to their hits. This is what makes [[badger]]s so hardcore.

|-
| {{text anchor|PUS}}
| Caste
|
* <[[material token]]>
* <[[Material_definition_token#Material_States|material state]]>
| The creature has pus. Specifies the stuff secreted by [[Health_care#Infection|infected wounds]].
|}

{{alphabetical TOC|style=margin: 1em auto;}}

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

|-
| {{text anchor|RELSIZE}}
| Caste
|
*BY_CATEGORY, BY_TYPE, BY_TOKEN
*body category, type, or token
*Relsize
| Specifies a new relative size for a part than what is stated in the body plan. For example, dwarves have larger livers.

|-
| {{text anchor|REMAINS}}
| Caste
|
*singular
*plural
| What the creature's [[remains]] are called.

|-
| {{text anchor|REMAINS_COLOR}}
| Caste
|
| What color the creature's [[remains]] are.

|-
| {{text anchor|REMAINS_ON_VERMIN_BITE_DEATH}}
| Caste
|
| Goes with {{token|VERMIN_BITE|c}} and {{token|DIE_WHEN_VERMIN_BITE|c}}, the vermin creature will leave remains on death when biting. Leaving this tag out will cause the creature to disappear entirely after it bites.

|-
| {{text anchor|REMAINS_UNDETERMINED}}
| Caste
|
| Nothing.

|-
| {{text anchor|REMOVE_MATERIAL}}
| Creature
|
*material token
| Removes a material from the creature.

|-
| {{text anchor|REMOVE_TISSUE}}
| Creature
|
*tissue token
| Removes a tissue from the creature.

|-
| {{text anchor|RETRACT_INTO_BP}}
| Caste
|
*BY_TYPE, BY_CATEGORY or BY_TOKEN
*body type, [[Body_token#CATEGORY|category]], or [[Body_token#BP|token]]
*Second person ("You") retract verb text
*Third person ("The giant snail") retract verb text
*Second person cancel retract text
*Third person cancel retract text
| The creature will retract into the specified body part(s) when threatened. It will be unable to move or attack, but enemies will only be able to attack the specified body part(s). When one of the specified body part is severed off, the creature automatically unretracts and cannot retract anymore. More than one body part can be selected by using BY_TYPE or BY_CATEGORY.

Second-person descriptions are used for adventurer mode natural ability. "<pro_pos>" can be used in the descriptions, being replaced with the proper pronoun (or lack thereof) in-game.

Undead curled up creatures are buggy, specifically those that retract into their upper bodies: [[echidna]]s, [[hedgehog]]s and [[pangolin]]s.{{bug|11463}}{{bug|10519}} The upper body is prevented from collapsing by a separate body part (the middle spine), which cannot be attacked when the creature is retracted. See {{token|PREVENTS_PARENT_COLLAPSE|bo}}. Living creatures eventually succumb to blood loss, but undead creatures do not. Giant creatures also take a very long time to bleed out.
|-
| {{text anchor|RETURNS_VERMIN_KILLS_TO_OWNER}}
| Creature
|
| Cat behavior. If it kills a vermin creature and has an owner, it carries the remains in its mouth and drops them at their feet. Requires {{token|HUNTS_VERMIN|c}}.

|-
| {{text anchor|ROOT_AROUND}}
| Caste
|
*BY_TYPE, BY_CATEGORY or BY_TOKEN
*body type, [[Body_token#CATEGORY|category]], or [[Body_token#BP|token]]
*Second person ("You") verb text
*Third person ("The hen") verb text
| Creature will occasionally root around in the grass, looking for insects. Used for flavor in Adventurer Mode, spawns vermin edible for this creature in Fortress Mode. Creatures missing the specified body part will be unable to perform this action. The action produces a message (visible in adventure mode) in the form:

[creature] [verb text] the [description of creature's location]

In adventure mode, the "rooting around" ability will be included in the "natural abilities" menu, represented by its second person verb text.

|}

{{alphabetical TOC|style=margin: 1em auto;}}

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

|-
| {{text anchor|SAVAGE}}
| Creature
|
| The creature will only show up in "savage" biomes. Has no effect on cavern creatures. Cannot be combined with {{token|GOOD|c}} or {{token|EVIL|c}}.

|-
| {{text anchor|SECRETION}}
| Caste
|
*<[[material token]]>
*<[[Material_definition_token#Material_States|material state]]>
*BY_TOKEN / BY_CATEGORY / BY_TYPE
*<[[Body_token#BP|body part ID]]> / <[[Body_token#CATEGORY|category]]> or ALL / <type (e.g. [[Body_token#GRASP|GRASP]])>
*<[[Body_detail_plan_token#BP_LAYERS|tissue layer]]> or ALL
*<trigger>
| Causes the specified tissue layer(s) of the indicated body part(s) to secrete the designated material. A size 100 ('covering') [[contaminant]] is created over the affected body part(s) in its specified material state (and at the temperature appropriate to this state) when the trigger condition is met, as long as one of the secretory tissue layers is still intact. Valid triggers are:
*'''CONTINUOUS'''
Secretion occurs once every 40 [[time|ticks]] in [[fortress mode]], and every tick in [[adventurer mode]].
*'''EXERTION'''
Secretion occurs continuously (at the rate described above) whilst the creature is at minimum {{Tile|Tired|6:1}} following physical exertion. Note that this cannot occur if the creature has {{token|NOEXERT|c}}.
*'''EXTREME_EMOTION'''
Secretion occurs continuously (as above) whilst the creature is distressed. Cannot occur in creatures with {{token|NOEMOTION|c}}.

|-
| {{text anchor|SELECT_ADDITIONAL_CASTE}}
| Creature
|
*<caste>
| Adds an additional previously defined caste to the selection. Used after {{token|SELECT_CASTE|c}}.

|-
| {{text anchor|SELECT_CASTE}}
| Creature
|
*<caste> or ALL
| Selects a previously defined caste

|-
| {{text anchor|SELECT_MATERIAL}}
| Creature
|
*<[[material token]]>
| Selects a locally defined material. Can be ALL.

|-
| {{text anchor|SELECT_TISSUE}}
| Creature
|
*tissue token
| Selects a tissue for editing.

|-
| {{text anchor|SEMIMEGABEAST}}
| Caste
|
| Essentially the same as {{token|MEGABEAST|c}}, but more of them are created during worldgen. See the [[semi-megabeast]] page for details.

|-
| {{text anchor|SENSE_CREATURE_CLASS}}
| Caste
|
* <[[Creature_token#CREATURE_CLASS|creature class]]>
* [[Tilesets|<tile value or character>]]
* [[Color#Color_values|<foreground color>:<background color>:<foreground brightness>]]
| Gives the creature the ability to sense creatures belonging to the specified [[Creature_token#CREATURE_CLASS|creature class]] even when they lie far beyond line of sight, including through walls and floors. It also appears to reduce or negate the combat penalty of [[Wound#Blindness|blind]] units when fighting creatures they can sense. In [[adventure mode]], the specified tile will be used to represent sensed creatures when they cannot be seen directly.

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

|-
| {{text anchor|SKILL_LEARN_RATE}}
| Caste
|
*<[[skill_token]]>
*<percentage>
| The rate at which this creature learns this skill. Requires {{token|CAN_LEARN|c}} or {{token|INTELLIGENT|c}} to function.

|-
| {{text anchor|SKILL_LEARN_RATES}}
| Caste
|
*<percentage>
| The rate at which this creature learns all skills. Requires {{token|CAN_LEARN|c}} or {{token|INTELLIGENT|c}} to function.

|-
| {{text anchor|SKILL_RATE}}
| Caste
|
*[[skill_token]]
*<% of improvement points gained>
*<unused counter rate>
*<rust counter rate>
*<demotion counter rate>
| Like {{token|SKILL_RATES|c}}, but applies to individual skills instead. Requires {{token|CAN_LEARN|c}} or {{token|INTELLIGENT|c}} to function.

|-
| {{text anchor|SKILL_RATES}}
| Caste
|
*<% of improvement points gained>
*<unused counter rate>
*<rust counter rate>
*<demotion counter rate>
| Affects skill gain and decay. Lower numbers in the last three slots make decay occur faster ([SKILL_RATES:100:1:1:1] would cause rapid decay). The counter rates may also be replaced with NONE.
Default is [SKILL_RATES:100:8:16:16]. Requires {{token|CAN_LEARN|c}} or {{token|INTELLIGENT|c}} to function.

|-
| {{text anchor|SKILL_RUST_RATE}}
| Caste
|
*[[skill_token]]
*value
*value
*value
| The rate at which this skill decays. Lower values cause the skill to decay faster. Requires {{token|CAN_LEARN|c}} or {{token|INTELLIGENT|c}} to function.

|-
| {{text anchor|SKILL_RUST_RATES}}
| Caste
|
*value
*value
*value
| The rate at which all skills decay. Lower values cause the skills to decay faster. Requires {{token|CAN_LEARN|c}} or {{token|INTELLIGENT|c}} to function.

|-
| {{text anchor|SLAIN_CASTE_SPEECH}}
| Caste
|
*[[Speech file|text set]]
| Caste-specific {{token|SLAIN_SPEECH|c}}.

|-
| {{text anchor|SLAIN_SPEECH}}
| Creature
|
*[[Speech file|text set]]
| Boasting speeches relating to killing this creature. Examples include [[text_dwarf.txt/raw|text_dwarf.txt]] (<code>[SLAIN_SPEECH:SLAIN_DWARF]</code>) and text_elf.txt (<code>[SLAIN_SPEECH:SLAIN_ELF]</code>) in data\vanilla\vanilla_creatures\objects.

|-
| {{text anchor|SLOW_LEARNER}}
| Caste
|
| Shorthand for {{token|CAN_LEARN|c}} + <code>[[Creature_token#SKILL_LEARN_RATES|[SKILL_LEARN_RATES:50]]]</code>.{{verify}} Used by a number of 'primitive' creatures (like [[ogre]]s, [[giant]]s and [[troglodyte]]s) in the vanilla game. Applicable to player races. Prevents a player from recruiting nobility, even basic ones. Subterranean creatures with this token combined with {{token|EVIL|c}} will become servants of goblins in their civilizations, in the style of [[troll]]s.

|-
| {{text anchor|SMALL_REMAINS}}
| Caste
|
| Creature leaves "[[item token#REMAINS|remains]]" instead of a corpse. Used by [[vermin]].

|-
| {{text anchor|SMELL_TRIGGER}}
| Caste
|
*value
| Determines how keen a creature's sense of smell is - lower is better. At 10000, a creature cannot smell at all.

|-
| {{text anchor|SOLDIER_ALTTILE}}
| Creature
|
*'character' or tile number
| If this creature is active in its civilization's military, it will blink between its default tile and this one.

|-
| {{text anchor|SOUND}}
| Caste
|
* Sound application (currently accepts ALERT or PEACEFUL_INTERMITTENT)
* Sound range (in tiles)
* Sound delay (lower values = sound is produced more often)
* VOCALIZATION or NONE (determines whether the sound requires breathing or not)
* First-person description
* Third-person description
* Description when out of sight
| Creature makes sounds periodically, which can be heard in Adventure mode.
* First-person reads "You '''bark'''"
* Third-person reads "The [[capybara]] '''barks'''"
* Out of sight reads "You hear '''a loud bark'''"
with the text in bold being the description arguments of the token.

|-
| {{text anchor|SOURCE_HFID}}
| Creature
|
*Integer
| Found on generated [[angel]]s. This is the historical figure ID of the deity with which the angel is associated. Since HFIDs are not predictable before worldgen, this isn't terribly usable in mods.

|-
| {{text anchor|SPECIFIC_FOOD}}
| Caste
|
* PLANT or CREATURE
* Plant/creature ID
| Creature will only appear in biomes with this plant or creature available. Grazers given a specific type of grass (such as [[panda]]s and [[bamboo]]) will only eat that grass and nothing else, risking starvation if there's none available.

|-
| {{text anchor|SPHERE}}
| Creature
|
* [[Sphere#Available_spheres|sphere]]
| Sets what religious spheres the creature is aligned to, for purposes of being worshipped via the {{token|POWER|c}} token. Also affects the creature's name.

|-
| {{text anchor|SPOUSE_CONVERSION_TARGET}}
| Caste
|
| This creature can be converted by a night creature with {{token|SPOUSE_CONVERTER|c}}.

|-
| {{text anchor|SPOUSE_CONVERTER}}
| Caste
|
| If the creature has the {{token|NIGHT_CREATURE_HUNTER|c}} tag, it will kidnap {{token|SPOUSE_CONVERSION_TARGET|c}}s and transform them into the caste of its species with the {{token|CONVERTED_SPOUSE|c}} tag during worldgen. It may also start families this way.

|-
| {{text anchor|SPREAD_EVIL_SPHERES_IF_RULER}}
| Caste
|
| If the creature rules over a [[site]], it will cause the local landscape to be corrupted into [[Surroundings#Evil|evil surroundings]] associated with the creature's [[Creature_token#SPHERE|sphere]]s. The creature must have at least one of the following [[sphere]]s for this to take effect: BLIGHT, DEATH, DISEASE, DEFORMITY, NIGHTMARES. The first three kill vegetation, while the others sometimes do. The last two get [[Plant_token#EVIL|evil plants]] and [[Creature_token#EVIL|evil animals]] sometimes. NIGHTMARES gets [[bogeyman|bogeymen]]. [http://www.bay12forums.com/smf/index.php?topic=169696.msg8162224#msg8162224] Used by [[demon]]s in the vanilla game.

|-
| {{text anchor|STANCE_CLIMBER}}
| Caste
|
| Caste does not require <code>[[Body_token#GRASP|[GRASP]]]</code> body parts to climb -- it can climb with <code>[[Body_token#STANCE|[STANCE]]]</code> parts instead.

|-
| {{text anchor|STANDARD_GRAZER}}
| Caste
|
| Acts as {{token|GRAZER|c}} but set to 20000*G*(max size)^(-3/4), where G defaults to 100 but can be set in d_init, and the whole thing is trapped between 150 and 3 million. Used for all grazers in the default creature raws.

|-
| {{text anchor|STRANGE_MOODS}}
| Caste
|
| The creature will get [[strange mood]]s in fortress mode and can produce artifacts.

|-
| {{text anchor|SUPERNATURAL}}
| Caste
|
| Gives the creature knowledge of any secrets with <code>[[Interaction_token#IS_SECRET|[SUPERNATURAL_LEARNING_POSSIBLE]]]</code> that match its [[Creature_token#SPHERE|spheres]] and also prevents it from becoming a [[vampire]] or [[werebeast]]. Other effects are unknown.

|-
| {{text anchor|SWIMS_INNATE}}
| Caste
|
| The creature naturally knows how to swim perfectly and does not use the [[swimmer]] skill, as opposed to {{token|SWIMS_LEARNED|c}} below. However, Fortress mode AI never paths into water anyway, so it's less useful there.

|-
| {{text anchor|SWIMS_LEARNED}}
| Caste
|
| The creature swims only as well as their present [[Swimmer|swimming skill]] allows them to.

|-
| {{text anchor|SYNDROME_DILUTION_FACTOR}}
| Caste
| <[[Syndrome#SYN_IDENTIFIER|syndrome identifier]]>:<percentage>
| Dilutes the effects of syndromes which have the specified identifier. A percentage of 100 is equal to the regular syndrome effect severity, higher percentages reduce severity.
|}

{{alphabetical TOC|style=margin: 1em auto;}}

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

|-
| {{text anchor|TENDONS}}
| Caste
|
* [[material token]]
*healing rate
| The creature has tendons in its {{token|CONNECTIVE_TISSUE_ANCHOR|td}} tissues (bone or chitin by default). Cutting the bone/chitin tissue severs the tendons, disabling motor function if the target is a limb.

|-
| {{text anchor|THICKWEB}}
| Caste
|
| The creature's [[web]]s can catch larger creatures.

|-
| {{text anchor|TISSUE}}
| Creature
|
*name
| Begins defining a tissue in the creature file. Follow this with standard tissue definition tokens to define the tissue properties.

|-
| {{text anchor|TISSUE_LAYER}}
| Caste
|
*BY_TYPE, BY_CATEGORY, BY_TOKEN
*TYPE,CATEGORY, or TOKEN
*TISSUE
*LOCATION
| Adds the tissue layer to wherever it is required.
Non-argument Locations can be FRONT, RIGHT, LEFT, TOP, BOTTOM. Argument locations are AROUND and CLEANS, requiring a further body part and a % of coverage/cleansing

|-
| {{text anchor|TISSUE_LAYER_OVER}}
| Caste
|
*BY_TYPE, BY_CATEGORY, BY_TOKEN
*TYPE,CATEGORY, or TOKEN
*TISSUE
*LOCATION
| Alias for TISSUE_LAYER

|-
| {{text anchor|TISSUE_LAYER_UNDER}}
| Caste
|
*BY_TYPE, BY_CATEGORY, BY_TOKEN
*TYPE,CATEGORY, or TOKEN
*TISSUE
| Adds the tissue layer under a given part.
For example, an [[iron man]] has a gaseous poison within, and this tissue (GAS is its name) has the token [TISSUE_LEAKS] and its state is GAS, so when you puncture the iron outside and damage this tissue it leaks gas (can have a syndrome by using a previous one in the creature sample.) [TISSUE_LAYER_UNDER:BY_CATEGORY:ALL:{tissue}] {tissue} is what will be under the TISSUE_LAYER; here is an example Tissue from the 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]

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

|-
| {{text anchor|TRADE_CAPACITY}}
| Caste
|
*number
| How much the creature can carry when used by merchants. 1000 by default. Completely ignored if the animal does not also have PACK_ANIMAL or WAGON, instead using BODY_SIZE^(2/3)/20, even if they're a pack animal due to ANIMAL_ALWAYS_PACK_ANIMAL.

|-
| {{text anchor|TRAINABLE}}
| Caste
|
| Shortcut for {{token|TRAINABLE_HUNTING|c}} + {{token|TRAINABLE_WAR|c}}.

|-
| {{text anchor|TRAINABLE_HUNTING}}
| Caste
|
| Can be [[Animal trainer|trained]] as a hunting beast, increasing speed.

|-
| {{text anchor|TRAINABLE_WAR}}
| Caste
|
| Can be [[Animal trainer|trained]] as a war beast, increasing strength and endurance.

|-
| {{text anchor|TRANCES}}
| Caste
|
| Allows the creature to go into [[martial trance]]s. Used by dwarves in the vanilla game.

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

|-
| {{text anchor|TRIGGERABLE_GROUP}}
| Creature
|
*min
*max
| A large swarm of vermin can be disturbed, usually in adventurer mode.

|-
| {{text anchor|TSU_NOUN}}
| Caste
|
*noun
*SINGULAR or PLURAL
| Noun for the {{token|TISSUE_STYLE_UNIT|c}}, used in the description of the tissue layer's style.
|}

{{alphabetical TOC|style=margin: 1em auto;}}

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

|-
| {{text anchor|UBIQUITOUS}}
| Creature
|
| Creature will occur in every region with the correct biome. Does not apply to {{token|EVIL|c}}/{{token|GOOD|c}} tags. Supersedes {{token|FREQUENCY|c}} for the purposes of distributing populations through the map, they are present in every part of the valid biome. Respects {{token|FREQUENCY|c}} for the frequency of unit [[Creature token#CLUSTER_NUMBER|cluster]] spawns being of this species.

|-
| {{text anchor|UNDERGROUND_DEPTH}}
| Creature
|
*mindepth
*maxdepth
| Depth that the creature appears underground. Numbers can be from 0 to 5. 0 is actually 'above ground' and can be used if the creature is to appear both above and below ground. Values from 1-3 are the respective [[cavern]] levels, 4 is the [[magma sea]] and 5 is the [[HFS]]. A single argument may be used instead of min and max. [[Demon]]s use only 5:5; user-defined creatures with both this depth and {{token|FLIER}} will take part in the initial wave from the HFS alongside generated demons, but without {{token|FLIER}} they will only spawn from the map edges. Civilizations that can use underground plants or animals will only export (via the embark screen or caravans) things that are available at depth 1.

|-
| {{text anchor|UNDERSWIM}}
| Caste
|
| The creature is displayed as blue when in [[Water#Depth|7/7 water]]. Used on fish and amphibious creatures which swim under the water.

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

|-
| {{text anchor|USE_CASTE}}
| Creature
|
*new caste token
*old caste token
| Defines a new caste derived directly from a previous caste. The new caste inherits all properties of the old one. The effect of this tag is automatic if one has not yet defined any castes: "Any caste-level tag that occurs before castes are explicitly declared is saved up and placed on any caste that is declared later, unless the caste is explicitly derived from another caste."
Roostre: "When DF detects duplicate tokens in the raws of the same object, a failsafe seems to kick in; it takes the bottom-most of the duplicates, and disregards the others. In the case of tokens added by a mod, it prioritizes the duplicate in the mod." This means that if a tag is defined in the base-caste and redefined in the derived caste, the derived tag overwrites the base tag.

|-
| {{text anchor|USE_MATERIAL}}
| Creature
|
*new material ID
*old material ID
| Defines a new local creature material and populates it with all properties defined in the specified local creature material.

|-
| {{text anchor|USE_MATERIAL_TEMPLATE}}
| Creature
|
*new material token
*material template
| Defines a new local creature material and populates it with all properties defined in the specified template. [http://www.bay12forums.com/smf/index.php?topic=175437.msg8441368#msg8441368 There seems to be a limit of 200 materials per creature].

|-
| {{text anchor|USE_TISSUE}}
| Creature
|
*new tissue token
*old tissue id
| Defines a new local creature tissue and populates it with all properties defined in the local tissue specified in the second argument.

|-
| {{text anchor|USE_TISSUE_TEMPLATE}}
| Creature
|
*new tissue token
*tissue template
| Loads a tissue template listed in OBJECT:TISSUE_TEMPLATE files, such as tissue_template_default.txt.

|-
| {{text anchor|UTTERANCES}}
| Creature
|
| Changes the language of the creature into unintelligible 'kobold-speak', which creatures of other species will be unable to understand. If a civilized creature has this and is not part of a {{token|SKULKING|e}} civ, it will tend to start wars with all nearby civilizations and will be unable to make peace treaties due to 'inability to communicate'.
|}

{{alphabetical TOC|style=margin: 1em auto;}}

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

|-
| {{text anchor|VEGETATION}}
| Caste
|
| Like {{token|AT_PEACE_WITH_WILDLIFE}}, but also makes the creature more valued in artwork by civilisations with the PLANT [[sphere]]. [http://www.bay12forums.com/smf/index.php?topic=169696.msg8316954#msg8316954] Used by [[grimeling]]s in the vanilla game.

|-
| {{text anchor|VERMIN_BITE}}
| Caste
|
*chance of occurrence{{verify}}
*verb (bitten, stung, etc.)
* [[material token]]
* [[Material_definition_token#Material_States|material state]]
| Enables vermin to bite other creatures, injecting the specified material. See {{token|SPECIALATTACK_INJECT_EXTRACT|c}} for details about injection - this token presumably works in a similar manner.{{verify}}

|-
| {{text anchor|VERMIN_EATER}}
| Creature
|
| The vermin creature will attempt to eat exposed food. See {{token|PENETRATEPOWER|c}}. Distinct from {{token|VERMIN_ROTTER|c}}.

|-
| {{text anchor|VERMIN_FISH}}
| Creature
|
| The vermin appears in [[water]] and will attempt to swim around.

|-
| {{text anchor|VERMIN_GROUNDER}}
| Creature
|
| The creature appears in "general" surface ground locations. Note that this doesn't stop the creature from flying if it can (most vermin birds have this tag).

|-
| {{text anchor|VERMIN_HATEABLE}}
| Caste
|
| Some dwarves will [[Preferences|hate]] the creature and get unhappy thoughts when around it. See the [[Hateable|list of hateable vermin]] for details.

|-
| {{text anchor|VERMIN_MICRO}}
| Caste
|
| This makes the creature move in a swarm of creatures of the same race as it (e.g. swarm of flies, swarm of ants).

|-
| {{text anchor|VERMIN_NOFISH}}
| Caste
|
| The creature cannot be caught by [[fishing]].

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

|-
| {{text anchor|VERMIN_NOTRAP}}
| Caste
|
| The creature cannot be caught in baited [[animal trap]]s; however, a "[[Trapper|catch live land animal]]" task may still be able to capture one if a dwarf finds one roaming around.

|-
| {{text anchor|VERMIN_ROTTER}}
| Creature
|
| The vermin are attracted to rotting stuff and loose food left in the open and cause unhappy thoughts to dwarves who encounter them. Present on flies, knuckle worms, acorn flies, and blood gnats. Speeds up decay?{{verify}}

|-
| {{text anchor|VERMIN_SOIL}}
| Creature
|
| The creature randomly appears near dirt or mud, and may be uncovered by creatures that have the {{token|ROOT_AROUND|c}} interaction such as [[goose|geese]] and [[chicken]]s. Dwarves will ignore the creature when given the "Capture live land animal" task.

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

|-
| {{text anchor|VERMINHUNTER}}
| Caste
|
| Old shorthand for "does cat stuff". Contains {{token|AT_PEACE_WITH_WILDLIFE|c}} + {{token|RETURNS_VERMIN_KILLS_TO_OWNER|c}} + {{token|HUNTS_VERMIN|c}} + {{token|ADOPTS_OWNER|c}}.

|-
| {{text anchor|VESPERTINE}}
| Caste
|
| When set, the creature will only appear in the evening (between 8:00 PM and 10:05 PM) in Adventurer mode.

|-
| {{text anchor|VIEWRANGE}}
| Caste
|
*value
| Value should determine how close you have to get to a critter before it attacks (or prevents adv mode travel etc.) Default is 20.

|-
| {{text anchor|VISION_ARC}}
| Caste
|
*binocular vision arc
*non-binocular vision arc
| The width of the creature's vision arcs, in degrees (i.e. 0 to 360). The first number is binocular vision, the second is non-binocular vision. Binocular vision has a minimum of about 10 degrees, monocular, a maximum of about 350 degrees. Values past these limits will be accepted, but will default to ~10 degrees and ~350 degrees respectively. Defaults are 60:120.
|}

{{alphabetical TOC|style=margin: 1em auto;}}

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

|-
| {{text anchor|WAGON_PULLER}}
| Caste
|
| Allows the creature to pull caravan wagons. If a civilization doesn't have access to any, it is restricted to trading with pack animals.

|-
| {{text anchor|WEBBER}}
| Caste
|
* [[material token]]
| Allows the creature to create [[web]]s, and defines what the webs are made of.

|-
| {{text anchor|WEBIMMUNE}}
| Caste
|
| The creature will not get caught in thick [[web]]s. Used by creatures who can shoot thick webs (such as [[giant cave spider]]s) in order to make them immune to their own attacks.
|}

==Attack Tokens==

Attacks can use four different part selection criteria. Except for TISSUE_LAYER, the base game makes use of all of these in its attacks.

{| {{prettytable}}
|- bgcolor="#ddd"
! width="20%" | Part type token
! width="30%" | Arguments
! width="60%" | Description

|-
| {{text anchor|BODYPART}}
|
* BY_TYPE/BY_TOKEN/BY_CATEGORY
* type/token/category
| This attack uses a particular body part; for example, ATTACK:PUNCH:BODYPART:BY_TYPE:GRASP will make it use any part that can hold onto an object.

|-
| {{text anchor|TISSUE_LAYER}}
|
* BY_TYPE/BY_TOKEN/BY_CATEGORY
* type/token/category
* tissue layer
| This attack uses a specific tissue layer on a specific body part; ATTACK:SCRATCH:TISSUE_LAYER:BY_TYPE:GRASP:BONE will make it use the bone of the hands.

|-
| {{text anchor|CHILD_BODYPART_GROUP}}
|
* BY_TYPE/BY_TOKEN/BY_CATEGORY
* type/token/category
* BY_TYPE/BY_TOKEN/BY_CATEGORY
* type/token/category
| Uses a body part that is subordinate to another; ATTACK:SLAP:CHILD_BODYPART_GROUP:BY_CATEGORY:ARM_LOWER:BY_TYPE:GRASP will make it use every hand attached to each lower arm (so it will generate one attack per lower arm, each of which will use every hand on that arm, assuming there are multiple hands per arm).

|-
| {{text anchor|CHILD_TISSUE_LAYER_GROUP}}
|
* BY_TYPE/BY_TOKEN/BY_CATEGORY
* type/token/category
* BY_TYPE/BY_TOKEN/BY_CATEGORY
* type/token/category
* tissue layer
| As CHILD_BODYPART_GROUP, but specifying a tissue, too; ATTACK:BITE:CHILD_BODYPART_GROUP:BY_CATEGORY:HEAD:BY_CATEGORY:TOOTH

|}

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

|-
| {{text anchor|ATTACK_SKILL}}
| Caste
|
*[[Skill token]]
| Defines the skill used by the attack.

|-
| {{text anchor|ATTACK_VERB}}
| Caste
|
*2nd person
*3rd person
| Descriptive text for the attack.

|-
| {{text anchor|ATTACK_CONTACT_PERC}}
| Caste
|
*% value
| The contact area of the attack, measured in % of the body part's volume. Note that all attack percentages can be more than 100%.

|-
| {{text anchor|ATTACK_PENETRATION_PERC}}
| Caste
|
*% value
| The penetration value of the attack, measured in % of the body part's volume. Requires ATTACK_FLAG_EDGE. Maximum value: 15000.

|-
| {{text anchor|ATTACK_PRIORITY}}
| Caste
|
*MAIN or SECOND
| Usage frequency. MAIN attacks are 100 times more frequently chosen than SECOND. Opportunity attacks ignore this preference.

|-
| {{text anchor|ATTACK_VELOCITY_MODIFIER}}
| Caste
|
*number
| The velocity multiplier of the attack, multiplied by 1000.

|-
| {{text anchor|ATTACK_FLAG_CANLATCH}}
| Caste
|
| Attacks that damage tissue have the chance to latch on in a wrestling hold. The grabbing bodypart can then use the "shake around" wrestling move, causing severe, armor-bypassing tensile damage according to the attacker's body volume.

|-
| {{text anchor|ATTACK_FLAG_WITH}}
| Caste
|
| Displays the name of the body part used to perform an attack while announcing it, e.g. "The weaver punches the bugbat with his right hand".

|-
| {{text anchor|ATTACK_FLAG_EDGE}}
| Caste
|
| The attack is edged, with all the effects on physical resistance and contact area that it entails.

|-
| {{text anchor|ATTACK_PREPARE_AND_RECOVER}}
| Caste
|
* Preparation time
* Recovery time
| Determines the length of time to prepare this attack and until one can perform this attack again. Values appear to be calculated in adventure mode ticks.

|-
| {{text anchor|ATTACK_FLAG_BAD_MULTIATTACK}}
| Caste
|
| Multiple strikes with this attack cannot be performed effectively.

|-
| {{text anchor|ATTACK_FLAG_INDEPENDENT_MULTIATTACK}}
| Caste
|
| Multiple strikes with this attack can be performed with no penalty. The creature will use all attacks with this token at once.

|-
| {{text anchor|SPECIALATTACK_INJECT_EXTRACT}}
| Caste
|
*<[[material token]]>
*<[[Material_definition_token#Material_States|material state]]>
*<min quantity>
*<max quantity>
| When added to an attack, causes the attack to inject the specified material into the victim's bloodstream. Once injected, the material will participate in [[temperature|thermal]] exchange within the creature - injecting something like molten [[iron]] (INORGANIC:IRON:LIQUID) would cause most unmodded creatures to melt (note that some of the injected material also [[contaminant|splatters]] over the bodypart used to carry out the attack, so it should be protected appropriately). If the injected material has an associated [[syndrome]] with the [[Syndrome#SYN_INJECTED|[SYN_INJECTED]]] token, it will be transmitted to the victim. If the attack is blunt, the injected material lacks the [[Material definition token#ENTERS_BLOOD|[ENTERS_BLOOD]]] token, the attacked bodypart has no [[Tissue_definition_token#VASCULAR|[VASCULAR]]] tissues, or the victim is bloodless, the material will splatter over the attacked body part instead.

|-
| {{text anchor|SPECIALATTACK_INTERACTION}}
| Caste
|
*interaction
| When this attack lands successfully, a specified interaction will take effect on the target creature. The attack must break the target creature's skin in order to work. This will take effect in worldgen as well. If the attack would break skin, the interaction will occur '''before the attack actually lands'''.

|-
| {{text anchor|SPECIALATTACK_SUCK_BLOOD}}
| Caste
|
*min
*max
| Successful attack draws out an amount of blood randomized between the min and max value. Beware that this '''will''' trigger any ingestion syndromes attached to the target creature's blood - for example, using this attack on a vampire will turn you into one too.
|}

==Tissue Layer Tokens==
Tissue layers are added to a creature's body parts by the creature tokens [[#TISSUE_LAYER|TISSUE_LAYER]], [[#TISSUE_LAYER_OVER|TISSUE_LAYER_OVER]], [[#TISSUE_LAYER_UNDER|TISSUE_LAYER_UNDER]], and the body detail plan token [[#TL_LAYERS|TL_LAYERS]].

These tissue layers are not the same thing as tissues, which are defined at creature level, but rather applications of the tissues. If the SKIN tissue of a creature is the more general and abstract notion of what skin is for that creature, then a tissue layer may be the "actual" skin on the creature's nose, head, or second toe. As most creatures have more than one body part, tissue layers are normally selected en masse.

Some tissue layer tokens are analogous to tissue definition tokens, e.g. [[#TL_CONNECTS|TL_CONNECTS]] to [[tissue_definition_token#CONNECTS|CONNECTS]].

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

|-
| {{text anchor|SELECT_TISSUE_LAYER}}
| Caste
|
*TISSUE
*BY_CATEGORY, BY_TYPE, BY_TOKEN
*Location - category, type, or token | Selects a tissue at a location
* (optional) FRONT, BACK, LEFT, RIGHT, TOP, BOTTOM, AROUND.
| Begins a selection of tissue layers.
[SELECT_TISSUE_LAYER:HEART:BY_TYPE:HEART]

|-
| {{text anchor|PLUS_TISSUE_LAYER}}
| Caste
|
*TISSUE
*BY_CATEGORY, BY_TYPE, BY_TOKEN
*Location - category, type, or token
| Adds tissue layers to those selected.

|-
| {{text anchor|SET_TL_GROUP}}
| Caste
|
*TISSUE
*BY_CATEGORY, BY_TYPE, BY_TOKEN
*Location - category, type, or token
*tissue
| Begins a selection of tissue layers. Only usable for descriptor and cosmetic purposes.

Research has implied it may be redundant with SELECT_TISSUE_LAYER, as the latter allows for cosmetics as well as "functional" tokens such as TL_MAJOR_ARTERIES. Vanilla raws still use SET_TL_GROUP though, for all cosmetic purposes. More research is needed on this subject.

|-
| {{text anchor|PLUS_TL_GROUP}}
| Caste
|
*BY_CATEGORY, BY_TYPE, BY_TOKEN
*Location - category, type, or token
*tissue
| Adds tissue layers to those selected. Like SET_TL_GROUP, it may be redundant even if used in the vanilla raws.

|-
| {{text anchor|SET_LAYER_TISSUE}}
| Caste
|
*TISSUE
| Sets a selected tissue layer to be made of a different tissue.

|-
| {{text anchor|SHEARABLE_TISSUE_LAYER}}
| Caste
|
* tissue modifier
* required value
| Tissue layer can be sheared for its component material. The specified modifier must be at least of the desired value for shearing to be possible (for example, a [[llama]]'s wool must have a LENGTH of 300 before it is shearable).

|-
| {{text anchor|TISSUE_LAYER_APPEARANCE_MODIFIER}}
| Caste
|
*QUALITY
*lowest
*lower
*low
*median
*high
*higher
*highest
| Sets the range of qualities, including LENGTH, DENSE, HIGH_POSITION, CURLY, GREASY, WRINKLY

|-
| {{text anchor|TISSUE_STYLE_UNIT}}
| Caste
|
*tissue style unit ID
*shaping
| Sets tissue layer to be the target of TISSUE_STYLE token specified for an entity, works only on entity members. Mostly used with tissues HAIR, BEARD, MOUSTACHE, SIDEBURNS.

|-
| {{text anchor|TL_COLOR_MODIFIER}}
| Caste
|
*COLOR
*freq
*COLOR
*freq etc.
| Creates a list of colors/color patterns, giving each a relative frequency. If the given color or pattern does not exist, the tissue is described as being "transparent".

|-
| {{text anchor|TLCM_GENETIC_MODEL}}
| Caste
|
| The way the color modifier is passed on to offspring. May or may not work right now.{{verify}}

|-
| {{text anchor|TLCM_IMPORTANCE}}
| Caste
|
*number
| Presumably modifies the importance of the tissue layer color modifier, for description purposes.
HOWEVER using this appears to remove all mention of colour from creature descriptions. It does not appear in any default creatures.

|-
| {{text anchor|TLCM_NOUN}}
| Caste
|
*name
*SINGULAR or PLURAL
| Names the tissue layer color modifier, and determines the noun. Also used by [[Utility:Stonesense|Stonesense]] for colouring body parts.

|-
| {{text anchor|TLCM_TIMING}}
| Caste
|
*ROOT
*start change window years
*days
*end change window years
*days
| Determines the point in the creature's life when the color change begins and ends.

|-
| {{text anchor|TL_CONNECTS}}
| Caste
|
| Gives the CONNECTS attribute to selected layers.

|-
| {{text anchor|TL_HEALING_RATE}}
| Caste
|
*value
| Changes the HEALING_RATE of the selected tissue layers.

|-
| {{text anchor|TL_MAJOR_ARTERIES}}
| Caste
|
| Gives the "major arteries" attribute to selected layers. Used to add massive bleeding properties to the throat, made from skin.

|-
| {{text anchor|TL_PAIN_RECEPTORS}}
| Caste
|
*value
| Changes the number of pain receptors for selected tissue layers.

|-
| {{text anchor|TL_RELATIVE_THICKNESS}}
| Caste
|
*value
| Changes the relative thickness for selected tissue layers.

|-
| {{text anchor|TL_VASCULAR}}
| Caste
|
*value
| Sets a new VASCULAR value (which modulates bleeding) for selected tissue layers.

|}

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

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

Combat

2025-02-09T15:39:48Z

DikbutDaGrate: This is several kinds of wrong. Needs more revision.

{{Quality|Masterwork}}
{{av}}
: ''This page ''will'' cover the mechanics of combat - as they're all figured out. For now, you may want to refer to [[Combat skill]]s, [[Armor]] and/or [[Weapon]]s) for specific information on those aspects. The effects of many [[material]] properties on combat are somewhat understood (see the [[Material science]] page).''
: ''For a "How to", [[Military]] is the main article, (or see [[Attack]] for the quick "right now!" version.''

[[File:combat_preview_anim.gif|thumb|290px|right|Animation of an armored [[dwarf]] and an armored [[human]] in a fight to the death.]]'''Combat''' in ''Dwarf Fortress'' is unlike that in most strategy and role-playing games. Rather than having hit points, units have a collection of body parts, such as limbs, head(s) and a torso. These have sub-parts: limbs have skin, fat, muscle, tendons, bones, nerves and arteries; heads have brains, eyes, noses, mouths, teeth and tongues; and torsos have internal organs. [[Wound|Damage]] to these parts and sub-parts causes various negative effects, such as fainting, vomiting, loss of mobility due to bone fractures or nerve damage, and eventually leading to death from organ failure or blood loss. The combat system tries to present a fairly realistic depiction of combat, with several important consequences.

Although [[creature]]s and players may direct and focus their attacks, combat is random in nature. A glancing blow can get lucky and damage a vital organ, or open an artery to cause massive blood loss. Weapons cause damage specific to their class, be they [[Battle axe|axes]] or [[Short sword|swords]] or [[backpack]]s. You will often see creatures attacked with impaling weapons such as [[spear]]s or [[crossbow]] bolts die of asphyxiation when their lungs are pierced, while slashing weapons are more likely to open an artery or lop off a limb, and blunt weapons will cause fractures. Some weapons may become stuck in the enemy: if the weapon wielder can maintain control, they can continue to do damage and immobilize the enemy, but if the enemy gains control of the stuck weapon, the weapon's wielder will be disarmed.

{{Translation
| dwarven = zoluth
| elvish = moÿira
| goblin = nur
| human = thec}}Reading the combat [[Reports|{{k|r}}eports]] will give you a gruesome blow-by-blow of the fighting, telling you exactly what each strike did. It is important to note that, while most natural creatures have the same sorts of vulnerabilities due to their similar collections of body parts, procedurally-generated creatures such as [[bogeymen]], [[forgotten beast]]s and [[titan]]s may lack these vulnerabilities entirely. Killing a shambling pile of refuse may prove to be a very, very long process due to the fact that it has no vital parts, and metallic creatures may prove to be nearly invulnerable. When all else fails, a [[cave-in]] or [[obsidian]] casting means certain death for anything caught in it.

As in real life, combat in ''Dwarf Fortress'' is chaotic, deadly, and gruesome. Numbers seem to matter, as defending against multiple opponents can be difficult, even for a decent fighter. Your warriors will not suffer loss of generic 'hit points', and cannot simply rest to regain them. Injuries must be dealt with in an appropriate fashion for healing to occur: broken bones must be set, wounds must be cleaned and stitched up, and for some things such as concussions, you can only wait and hope the victim eventually regains consciousness.

In [[fortress mode]], combat is handled passively, with gameplay constantly moving, and only pausing in certain circumstances (such as the arrival of a [[megabeast]] or [[siege]]). In [[adventure mode]], combat is handled in a slower and more diligent manner, given the frame-by-frame manner of the gamemode, allowing the player to manage their actions more carefully. Combat is also represented in a more graphical way in the latter gamemode, such as slashes and sparks appearing across the screen when a creature attacks another. The player, their companions and any nearby creatures will cause a small combat log to appear in the upper center of the screen when attacking in adventure mode.

==General observations==
[[File:advmode_combat_anim.gif|thumb|178px|right|An intelligent undead human fighting a goblin in adventure mode.]]
* Blunt weapons use contact area, IMPACT_YIELD, IMPACT_FRACTURE and weapon mass to scale damage. As such, metal effective for blunt weapons are [[Adamantine]] 🡆 [[Copper]] 🡆 [[Iron]] 🡆 [[Bronze]] 🡆 [[Steel]] 🡆 [[Silver]], from lowest to highest. It should be noted that steel is just about as effective as silver due to the impact values, as well as iron and copper. Higher contact area has higher potential damage but has a harder time getting through armor.
* Edge weapons use SHEAR_YIELD and SHEAR_FRACTURE for material strength. As such, metal effectiveness for edged weapons are [[Silver]] 🡆 [[Copper]] 🡆 [[Bronze]] 🡆 [[Iron]] 🡆 [[Steel]] 🡆 [[Adamantine]], from lowest to highest.
* Edge weapons use contact area and penetration size to determine pressure. Lower contact area results in better ability to pierce armor, higher contact area increases the amount of tissue affected by an attack. Swords provide both, with slashing and stabbing; spears provide only low contact area, and axes only provide high.

===AI Behaviour===
On seeing an enemy, military dwarves will rush towards their targets if they're able to path towards them. When at least one opponent is engaging a player-controlled character in adventure mode or the [[object testing arena]]. Colored dots will appear to reduce confusion, and will indicate where the player is, where attacking allies are and where enemies are, including what type of fighting said enemies are doing:
* [[File:indicator_you.png]] - '''You:''' The character currently controlled by the player.
* [[File:indicator_ally.png]] - '''Ally:''' The character is an ally and/or companion during a fight.
* [[File:indicator_brawl.png]] - '''Brawl:''' The character is brawling: punches, kicks, scratches and some wrestling moves, but no weapons.
* [[File:indicator_nonlethal.png]] - '''Non-lethal:''' Somewhat similar to brawling, but with more types of wrestling moves. Although there is no lethal intent, a combatant may still receive mortal wounds.
* [[File:indicator_lethal.png]] - '''Lethal:''' The character intends to fight to the death, but someone surrendering may also end the fight.

====Weapon attacks====
During most fights, attacks are targeted at a specific body part with a specific weapon, based on a few factors.

In adventurer mode, during a fight, each turn generates an ease and squareness for each part of the target, based on relative positioning and current actions. If an auto-attack is made, the AI will take into account:
*A combination of the ease and squareness of the attack.
*Weapons at its disposal, including both held and natural weapons
*Body parts, such as the head, although this seems to be considered a low priority

The AI can also perform wrestling, including the use of locks, choke-holds, and even forcefully removing equipment, although wrestling attacks are usually uncommon when a weapon is equipped.

If the target is unconscious or immobilized, such as becoming exhausted or caught in webs, all strikes against that target will become perfectly accurate and perfectly squared, and the AI will always prioritize removing the helmet, then striking the head.

Note that the AI does not seem to account for a body part's injuries - an already-disarmed hand or unusable leg can still be targeted, despite the presence of functional parts.

*Example: A goblin might suffer fatal upper spine injury from a blunt attack, rendering everything below their head useless - however, the dwarves will fail to recognise this and can continue to attack their body. This can result in dwarves becoming tired needlessly, increasing their own chances of death, especially in sieges.

The AI also sometimes forgets to retrieve their weapon after it becomes lodged in a target's wound. While they can still block attacks with their weapon, they will stop using it to make an attack, unless they receive intervention, such as another dwarf killing their target, or a tackle displacing them. This means even legendary weapon users can suddenly become useless mid-battle, and dispatching a small number of dwarves can be prone to reliability issues, especially if their weapon type becomes lodged often.

==General terms==
:'''Stress''' - Pressure = Force per area = F/A
:'''Strain''' - Deformation of a solid due to stress = Stress/Elastic Modulus

:'''Yield Strength''' is the amount of stress required to permanently deform (bend) a material (plastic deformation)
:'''Fracture Strength''' is the amount of stress required to permanently break (rupture) a material
:'''Strain at yield''' is the amount of deformation (bending) that occurs at the yield point
:Implications to ''Dwarf Fortress'' Combat

==Armor properties==
*Material Properties
:* Blunt Protection
::*'''Impact yield'''
::*'''Impact fracture'''
::*'''Impact strain at yield'''

:* Edge Protection
::*'''Shear yield'''
::*'''Shear fracture'''
::*'''Shear strain at yield'''

*Item Properties
:*'''Armor Level''': Layer number in which armor is worn. Lower numbers will be equipped first, and later numbers equipped if space is available.
:*'''Coverage'': Some armor covers more of the body than others.

==Weapon properties==
*Material Properties
:*Common
::*'''Contact Area''': Determines the surface area hit by the weapon. Likely in mm2.
::*'''Velocity Multiplier''': Effectively increases the velocity of the weapon swing.

:*Blunt Weapons
::*Blunt weapons are all about weapon mass, contact area, and velocity. Apply a large force to a small area for bone crushing goodness.
::*'''Mass''' is likely material '''Density''' times weapon '''Size'''
::*'''Momentum''' is '''Mass''' times '''Velocity'''
::*'''Velocity''' is based on the '''Mass''' of the weapon, the '''Strength''' of the wielder, and the '''Velocity Multiplier''' of the weapon
::*Any impact must have a conservation of momentum, and thusly, impart the weapon's momentum to the target
::*'''Stress''' is the '''Force''' of the strike divided by the '''Contact Area'''
:::*Material '''Impact Yield''' determines the '''Stress''' required to dent the armor (likely not used)

:*Edged Weapons
::*Edged weapons rely on a combination of size, mass, contact area, penetration depth, and velocity

==Attack speed==
Attack speed is defined in the raws using the ATTACK_PREPARE_AND_RECOVER token. ATTACK_PREPARE_AND_RECOVER:3:3 means "3 ticks to prepare, 3 ticks to recover"; this is the usual, for most attacks. Some attacks, such as kicks, are slower, and some, such as many night creature attacks, are faster. These can also be affected by modifiers (see below).

==Other combat factors==
* Both adventurer mode and fortress mode keeps track of which way a creature is facing, based on its last actions. Attacks from behind will have increased accuracy, especially if the target hasn't spotted the attacker yet.
* Movement speed plays an important role in melee combat, as it determines both dodging efficiency and opponent's accuracy. Creatures that are either prone or naturally slow (such as [[giant snail]]s) will have a hard time dodging attacks, so breaking one of the opponent's legs is worth the effort.
* Creature size, especially relative to other combatants, has a considerable effect on combat. In addition to individual strength stats, larger targets hit with greater force, though whether this is absolute or relative to the target's size is uncertain. Charging and wrestling also favor the larger combatant.
* As of update 0.43.04 shakes and strong attacks will translate to other bodyparts. For example, if you hit an enemy in the head with a blunt weapon, the force from that attack may also hurt the neck of the enemy. Even if the attack is blocked by armor, the force of the blow can still damage other bodyparts.
* Attacks can have modifiers that affect their speed and properties: heavy attacks increase the prepare and recover time, but have a higher velocity; precise attacks nearly double the prepare time, but have much higher accuracy; quick attacks reduce prepare and recover to about 2/3, but have lower velocity; wild attacks are slightly faster in preparation and have higher velocity, but lower accuracy and take significantly longer to recover.
* Only wild attacks are usable by berserk creatures.

==Arena test results==
* See [[Material]]

==Adventurer mode==

{| class="wikitable" style="border:1px solid #ccc;"
|-
| {{k|8}} {{k|2}} {{k|4}} {{k|6}} {{k|7}} {{k|9}} {{k|1}} {{k|3}}/ {{k|↑}} {{k|↓}} {{k|←}} {{k|→}}
| Attack adjacent hostile creature
|-
|
|-
| {{k|5}}
| Attack hostile creature on same tile
|-
| {{Adv menu icon|A}}
| Attack an adjacent creature
|-
| {{Adv menu icon|W}}
| Wrestle an adjacent creature
|-
| {{Adv menu icon|f}}
| Fire a projectile
|-
| {{k|t}}
| Throw an item
|-
| {{Adv menu icon|X}}
| Use ability or power
|-
| {{Adv menu icon|j}}
| Jump
|-
| {{Adv menu icon|C}}
| Open combat preferences interface
|}

[[Combat]] is the fine art of using physical force to cause injury and death, and it is particularly fun in ''Dwarf Fortress''.

See [[Adventurer mode gameplay#Party members]] for information on switching characters and using tactical mode.

=== Defense ===

Defense is very important in ''Dwarf Fortress''. Lucky attacks can kill instantly, and the only way to heal is to pass time (which can be done with fast travel, sleeping, or actual waiting) and some damage cannot be healed. The main methods of defense are armor, dodging, shields, and parrying attacks.

Defense can happen either automatically, or manually using the {{Adv menu icon|A}} attack menu. Manual defense is more likely to succeed, but prevents you from attacking (except for multi-attacks, but defense is tricky with those). The relative skill levels of attacker and target also affect the chances of success - a master swordsman is more likely to hit a novice dodger than a master dodger, for example. Also, see the [[Combat#Combat_preferences|Combat preferences]] section below for information on how those can affect defense.

[[Armor]] has a chance to automatically deflect an attack that targets a body part covered by it. So, getting as much [[Armor#Coverage|coverage]] as possible is important, as is having more [[Armor#Layers|layers]] of protection. The [[armor user]] skill is also very important as otherwise worn armor will greatly slow the wearer down.

Each attack on you has a chance of being dodged automatically depending on your [[dodger]] skill level. You can also dodge manually in the {{Adv menu icon|A}} aim attack menu by selecting any creature and choosing dodge. You then pick a direction, and your character will move one tile in that direction, possibly avoiding any number of attacks. Tiles that have a creature standing in them or some other blocking object cannot be dodged into. It is not clear whether choosing a specific creature increases the chance to dodge their attack or if choosing any creature will result in the same chance to dodge all attacks.

Each held shield has a chance to block most attacks, including breath attacks, and each held weapon has a chance to parry other weapon attacks, including projectile attacks (very rarely). Blocking and parrying can also be attempted manually in the {{Adv menu icon|A}} aim attack menu. There you can see adjacent creatures and any attacks they are attempting. This may include how soon the attack will happen depending on [[observer]] skill level. You can then pick a creature and choose to attempt to parry or block their attack. If several attacks are incoming, you can either manually defend against the soonest attack hoping for time to defend against the others or against the most dangerous hoping the other attacks are defended automatically.

The defensive options in the {{Adv menu icon|A}} aim attack menu do not have fixed keys because their position can change if one or more is impossible. You can't block without a shield, parry without a free weapon, or dodge while in a wrestling hold.

Offense can also sometimes be used defensively. Using {{Adv menu icon|W}} [[wrestling]] grabs, incoming attacks can be [[Wrestling#Interrupting|interrupted]] and opponents [[Wrestling#Disarming|disarmed]].

Note that you can dodge even if you are not being attacked. Also, despite being in an attack menu the defensive options will not escalate the conflict level. So, you can dodge away from a friendly creature without it counting as an attack.

=== Weapons ===

[[Weapon]]s are divided into specific [[Combat_skill#Weapon_skills|weapon skill]]s. Also, any item held in a grasp (usually a hand) can be used as a weapon and will use the [[Miscellaneous object user]] skill. This includes shields. Mining [[pick]]s are an exception in that they use the [[Miner]] skill.

Weapons can become stuck in wounds after an attack - this will make the weapon unavailable for aimed attacks. There are multiple ways to free them. The most reliable is by {{Adv menu icon|I}} interacting with the weapon in inventory, choosing the weapon, and choosing the {{DFtext|Gain possession}} option. Other ways include; doing a non-aimed attack can free up a stuck weapon (but if you're holding multiple weapons this isn't certain to work); moving from your current tile (exposing your back or flank to the enemy is not recommended); moving the enemy from their ''own'' tile by wrestling throw or charging attack; or jumping into the enemy.

Most creatures have body parts that can be used as weapons; hands, nails, feet, and mouths are common. These allow the creature to punch, scratch, kick, and bite, which use the Striker, Kicker, and Biter [[combat skill]]s. Creatures with other body parts may have an added attack with those; horns or tusks add gore attacks, for example. Creatures may also have attacks as natural abilities or acquired powers which can be used with {{Adv menu icon|X}}. [[Spit]] is a common ability, but is not very effective.

The entire body can also be used as a weapon by {{Adv menu icon|j}} jumping into or through the tile a creature is in. Usually they will dodge, but that might be useful around dangerous terrain. If it does hit, they may be sent flying depending on your relative masses. This can be useful for crowd control or knocking enemies into pits. Having your weapon stuck in them seems to increase the chance of hitting them.

=== Melee attacks ===

Hostile creatures can be attacked using a non-aimed attack by simply moving towards your enemy using the movement keys. A hostile creature in the same tile as you can be attacked with {{k|5}}. The specific type of attack can be influenced by the [[Combat#Combat_preferences|combat preferences]] and may be influenced by the character's skill level for each type of attack.{{verify}}

Any visible creature can be attacked by standing next to it and pressing {{Adv menu icon|A}} or {{Adv menu icon|W}}. Attacking some creatures will require a confirmation, given using {{k|alt}}+{{k|y}}. This can be because they're friendly (which includes wild animals for elves), unconscious, or have yielded. This menu also has [[Combat#Wrestling|wrestling]] and [[Combat#Defense|defensive]] options.

The first option {{k|a}} is to make an '''aimed attack'''. You first select the body part that you want to attack, then the type of attack. There are several options below the attack type menu. '''Quick attacks''' are faster than regular attacks but weaker. '''Heavy attacks''' are slower but hit harder. '''Wild attacks''' are faster and hit harder but are inaccurate. '''Precise attacks''' are very slow but are much more likely to hit. '''Multi-attacks''' allow you to attack several times in a row, at a great cost to the effectiveness of any one of the chosen attacks.

Some options may be marked with a {{DFtext|!|3:1}}, this indicates an attack of opportunity which has a greatly increased chance of effectiveness, but only applies to a specific attack type. Selecting a body part with one of these will then show which type of attack it is. A {{DFtext|↑|3:1}} or {{DFtext|↓|3:1}} indicates that there is a {{DFtext|!|3:1}} on another page. The keys to change the page are shown above the list, {{k|/}} and {{k|*}} by default. Even if one of these doesn't target an important body part or uses a weaker attack, if successful they can cause significant pain which may give you an advantage.

Some options may also be marked with one of {{DFtext|+|2:0}}, {{DFtext|+|2:1}}, {{DFtext|-|4:0}}, or {{DFtext|-|4:1}}, these indicate normal attacks that are better ({{DFtext|+|2:0}}{{DFtext|+|2:1}}) or worse ({{DFtext|-|4:0}}{{DFtext|-|4:1}}) than average.

Look at the difficulty rating for various possible attacks. Impossible attacks will be nearly impossible to land and Easier attacks will be very easy to land. The difficulty rating for an attack does not change depending on your weapon skill. Based on player experiences, a Grand Master weapon user can almost always land a "Tricky" strike, while a Novice generally cannot. Attacks on various locations will also have limits on how "squarely" they can land (due to being out of reach, for example). Square and very square attacks will deal more damage.{{Verify}} Attacks which "can't land squarely" are generally still effective.

When your target is unconscious all attacks will be {{DFtext|Simple strike, direct hit}}.

Attacks aimed at an unarmored head are the most effective; a single attack to the cranium with a weapon will usually put an end to the fight. Aimed attacks are especially useful for dismembering opponents. Opponents who are missing a foot will fall over, thereby greatly lowering their speed, and giving you an immediate edge in the fight. Cutting off both hands is also highly recommended for obvious reasons. After all, a field full of armless, one-legged enemies can be a big experience booster for your character and your companions. Damage to the lower body can cause nausea on most mundane creatures which is a major debuff for them. (They can also rarely [[Gelder|geld]] male creatures, but that has no other combat effect.)

Aimed attacks are also especially helpful when fighting giant beasts. Some enemies like giant desert scorpions have lots of redundant body parts, and random attacks waste valuable time on low priority areas while the scorpion is busy injecting venom into the whole party. Lastly, aimed attacks allow you to grab trophies that are not available via butchering. For example, a minotaur's horns can be cut off during a fight, but since it's a humanoid, most adventurers will refuse to butcher its corpse after the fight. However, in DF2014, all butcherable corpses are able to be butchered, as long as the corpse isn't too mangled.

=== Ranged attacks ===

To attack with a ranged weapon press the {{Adv menu icon|f}} key with a ranged weapon (bow, crossbow, etc.) equipped on one hand and select the square where you want to attack. Note that you need to have some sort of ammo, corresponding to the type of ranged weapon you are using (for example, bows use arrows, crossbows use bolts). Otherwise, a message stating "You have nothing left to fire." is displayed in brown. Similarly use the {{k|t}} key to throw any random object in the same manner. Random objects appear to make a random attack if they happen to have more than one possible type.{{Verify}} For example, if you throw a sword it may hit with a blunt impact, a stabbing impact, or a slicing impact. Throwing crossbow bolts with sufficient throwing skill and strength seems to have an effect similar to firing them, although less powerful. On the plus side, you will never lose ammo if you throw it.

It is not possible to aim for specific body parts with ranged or thrown attacks.

{{k|t}}hrowing is generally a good skill to have for any adventurer, as it allows you to slow down fleeing foes, both on the ground and in the air without the need of equipping a (cross)bow. Just like {{k|l}}ooking, you can use throwing to view and hit enemies multiple Z levels away from you. If you're lucky, you can simply land a hit that causes the flying enemy to give in to pain, and then let gravity do the rest of the work. Even if the fall doesn't kill them, they will most likely be stunned long enough for you to run up and slaughter them.

=== Wrestling ===

:''Main article: [[Wrestling]]''

'''[[Wrestling]]''' (grappling) can be performed by selecting an enemy via {{Adv menu icon|W}} to wrestle. You can wrestle any enemy. Wrestling works somewhat like a targeted attack: Once you grab a creature by some body part, you may be able to make another wrestling attempt that will allow you to perform a throw or takedown. For a detailed list of moves, such as takedowns, throws, choke holds, etc., see [[Wrestling]].

=== Wounds ===

If you get wounded during combat, you can try to yield or flee - or both - before you get more wounded.

To yield, press {{Adv menu icon|y}}. This will be less effective if you continue to hold a weapon, so drop any with {{Adv menu icon|d}}. Putting them away with {{Adv menu icon|q}} or {{Adv menu icon|p}} may also work. You can also ask them to cease hostilities with {{Adv menu icon|k}}. However, depending on the hostility level of the conflict and possibly the personality of your enemy, they may continue to attack you.

If you choose to flee, you can increase your movement speed with {{Adv menu icon|m}}. Be aware that movement speed while stunned, nauseous or winded is reduced, and might leave you open to fatal blows. If you are next to a creature, manually dodging using the {{Adv menu icon|A}} attack menu may be faster than using the movement keys and will likely avoid more attacks.

Your wounds will heal over time, so just fast travel or sleep in a safe place. Some wounds may never heal, however, leaving you permanently crippled. Obtaining a crutch may help with this. Or, if you are not already a vampire, you can get bitten by a werebeast during full moon, which will heal all injuries once per month. Rolling [[die|divination dice]] can also result in a transformation or direct healing, though such magical healing seems to also have limits.

If you have some bolts or arrows stuck in your body, they can be removed by using the complex {{Adv menu icon|I}} interaction menu. Select the stuck bolt or arrow from the list and then pull it out with {{k|a}}. You'll probably start bleeding after you pull it out, but the bleeding is rarely anything to worry about.

=== Combat preferences ===

At any time during gameplay (except in fast travel mode), you can press {{Adv menu icon|C}} to open the Combat Preferences menu. There are three different preferences you can set: Attack, Dodge and Charge Defense. These have a few different sub-preferences each:

*'''{{k|a}}ttack'''
**'''According to Opponent''' - The default setting. When set to this, charging happens more or less frequently, depending on the difference in size between you and the opponent. Bigger opponents get charged less, smaller more often. Can be very risky, since a random charge against a huge opponent is likely to get you knocked down and stunned. In the same vein, charging when close to obstacles or other environmental hazards is very dangerous, potentially fatal, if the enemy dodges you.
**'''Strike''' - This setting ensures that you never charge an opponent, but rather just swing your weapon at them. This carries less risk than the above, but you're never going to knock anyone down without hitting their legs or spine. Very preferable against large opponents.
**'''Charge''' - When set to this, you ALWAYS charge. When faced with numerous small enemies (Bogeymen in particular), this can be extremely useful, but remember to switch back when facing something bigger. Charging a large dragon is almost a certain death sentence.
**'''Close Combat''' - With this setting, all your auto-attacks are grapples. Generally not very useful, since the random nature of it tends to prevent you from actually doing any damage with it, but if you continually auto-attack a harmless creature with it, your wrestling-skill will be legendary in no time.

*'''{{k|d}}odge'''
**'''Move Around''' - This means you can jump away from attacks, physically moving in a random direction. While this lets you dodge attacks more often, it can also result in you jumping into a wall or lake. If you're fighting in really tight spaces, or areas with large pits, you might want to switch to the other option.
**'''Stand Ground''' - As can be expected, you stand your ground. No jumping around, which is useful in the above situation, but risky in the open. If you have room for jumping around, go with Move Around, but otherwise this could be a good idea.

*'''{{k|c}}harge Defense'''
**'''According to Opponent''' - Again, the default setting. You're more likely to stand still against small enemies charging, but will probably prefer moving away from larger ones. Somewhat risky, in that even a somewhat small enemy can stun you by charging.
**'''Dodge Away''' - With this, you'll dodge away from charging enemies, if you can. It's not a sure bet, but it's very much worth it against enemies who like to charge. This is probably the most preferable mode, since you're not losing a whole lot by dodging a small foe charging, but dodging an angry night beast can save you from a world of pain.
**'''Stand Ground''' - If you're certain of your physical superiority to the opponent, you can safely choose this. Standing your ground like a real man/woman might feel hardcore, but getting knocked down in a fight can be extremely dangerous. It probably has some use against bogeymen, though, since they're quite small. If you really are much bigger than the enemy, you'll end up knocking THEM down. Most of the time though, charges heavily favor the attacker, so dodging away is probably preferable.

Using the Combat Preferences properly can actually save your hide, so they're worth fiddling with. Just don't forget that you've fiddled with them, since a misplaced charge or dodge could end up killing ''you''.

===Iconography===
====Natural attacks====
These are attacks that do not need the use of weapons, but instead utilize the body parts of the attacker to harm, manipulate or hold onto the body parts of an enemy.

{| class="wikitable" style="width:660px;"
! Icon
! Attack
! Description
|-
| [[File:adv_icon_wrestle.png]]
| '''Wrestle'''
| A set of attacks based on wrestling moves, naturally using one's limbs to attack.
|-
| [[File:adv_icon_grab.png]]
| '''Grab'''
| Takes hold of an enemy's body part.
|-
| [[File:adv_icon_joint_lock.png]]
| '''Joint Lock'''
| Push or pull an enemy's joint to its maximum degree of motion, putting the combatant in pain and further preventing movement.
|-
| [[File:adv_icon_choke.png]]
| '''Choke'''
| Grabs the enemy with a choke hold, suffocating them if they need to breathe.
|-
| [[File:adv_icon_takedown.png]]
| '''Takedown'''
| Throws the enemy down, likely knocking them off their feet.
|-
| [[File:adv_icon_throw.png]]
| '''Wrestle'''
| Send the enemy airborne.
|-
| [[File:adv_icon_pinch1.png]]
| '''Pinch'''
| The user pinches an enemy's body part with their digits, fingers or pincers.
|-
| [[File:adv_icon_pinch2.png]]
| '''Gouge'''
| Tears or claws into an enemy body part that has been grappled.
|-
| [[File:adv_icon_break.png]]
| '''Break'''
| Forcefully break an enemy bone, rendering the body part useless.
|-
| [[File:adv_icon_release.png]]
| '''Loosen'''
| Loosen or release the grip of a hold on an enemy.
|-
| [[File:adv_icon_strangle.png]]
| '''Strangle'''
| Grab and shake the throat of the enemy, suffocating them if they need to breathe.
|-
| [[File:adv_icon_latch.png]]
| '''Latch'''
| Sharply bite into the victim, holding them in place.
|}

====Weapon/Item attack types====
These attacks utilize the weapons the user is holding, or whatever items are in their inventory.

{| class="wikitable" style="width:660px;"
! Icon
! Attack
! Description
|-
| [[File:adv_attack_quick.png]]
| '''Quick'''
| A weaker attack that is quick and easy to recover from.
|-
| [[File:adv_attack_heavy.png]]
| '''Heavy'''
| A strong attack that is slower and harder to recover from.
|-
| [[File:adv_attack_wild.png]]
| '''Wild'''
| A fast attack, but is very inaccurate and hard to maintain the balance of.
|-
| [[File:adv_attack_precise.png]]
| '''Precise'''
| A very slow, but very accurate attack.
|-
| [[File:adv_attack_charge.png]]
| '''Charge'''
| Charges into the enemy, possibly making an enemy stumble off balance or knock them down.
|-
| [[File:adv_attack_multi.png]]
| '''Multi-attack'''
| A sequence of attacks customizable by the player, when finished, they will all be executed one after the other.
|}

====Weapon/Item utilization====
These attack choices determine how the weapon or item will be used.

{| class="wikitable" style="width:660px;"
! Icon
! Attack
! Description
|-
| [[File:adv_attack_stab.png]]
| '''Stab'''
| Strike the enemy by directly thrusting a sword's point.
|-
| [[File:adv_attack_slash.png]]
| '''Slash'''
| Strike the enemy by swinging the edge of a sword at the enemy.
|-
| [[File:adv_attack_slap.png]]
| '''Slap'''
| Hits the enemy with the flat side of a weapon.
|-
| [[File:adv_attack_hack.png]]
| '''Hack'''
| Strike the enemy by swinging an axe or axe-like weapon into the enemy.
|-
| [[File:adv_attack_bash.png]]
| '''Charge'''
| Strike the enemy with a blunt weapon.
|-
| [[File:adv_attack_lash.png]]
| '''Lash'''
| Attack an enemy by lashing a whip.
|-
| [[File:adv_attack_pommel.png]]
| '''Pommel'''
| Bash an enemy with the handle of a weapon.
|-
| [[File:adv_attack_punch.png]]
| '''Punch'''
| Swing a punch toward the enemy.
|-
| [[File:adv_attack_kick.png]]
| '''Kick'''
| Kick the enemy.
|-
| [[File:adv_attack_bite.png]]
| '''Bite'''
| Simply bite the enemy. A [[vampire]] can draw blood from a victim this way, or a [[werebeast]] can also transfer its curse with a bite that breaks the skin. Very effective if the attacker's bite is venomous.
|-
| [[File:adv_attack_sting.png]]
| '''Sting'''
| Attack the enemy with a stinger, if the attacking creature naturally has a stringer. Very effective if the attacker's sting is venomous.
|-
| [[File:adv_attack_pincer.png]]
| '''Pincer'''
| Attack the enemy with a pincer, if the attacking creature naturally has a pincer.
|-
| [[File:adv_attack_other.png]]
| '''Push'''
| Shoves the enemy away.
|}

{{Category|Game mechanics}}
[[ru:Combat]]

Fairy

2025-01-25T23:37:36Z

DikbutDaGrate: Undo revision 304103 by Jecowa (talk)

{{Quality|Fine}}
{{verminlookup/0
|image=fairy_sprite.png}}
{{av}}
{{creaturedesc}}

'''Fairies''' are a type of [[fanciful]] above-ground [[vermin]] that live in [[good]] areas. They, alongside [[pixie]]s, are the only intelligent vermin in the game, though they can't be interacted with on the basis of being vermin. When encountered in [[adventure mode]], they will glow in the dark (''or should; see below''). They possess a [[pet]] value of 10. As they possess the VERMIN_NOTRAP token, they cannot be captured by placing [[animal trap]]s, but they can still be trapped using the ''catch live land animal'' task.

Despite their description, they do not actually have wings at all, let alone lacy ones (though they can still fly, even without them). A comment in their raws implies [[Main:Toady One|Toady]] plans to eventually give them lacy wings.

While a token in their creature raws should enable them to generate light, they cannot, as they lack the necessary graphical tokens and sprite creature graphics to do so.

Some [[dwarves]] [[Preferences|like]] fairies for their ''lacy wings'' and their ''babylike giggles''.

[[File:fairy_preview.jpg|thumb|269px|center|Note: Wings may not function in-game.]]

{{gamedata}}
{{vermin}}

Moon snail

2025-01-25T23:30:26Z

DikbutDaGrate: Clarification on the acquisition of moon snails

{{Quality|Fine}}
{{verminlookup/0
|image=moon_snail_sprite.png}}
{{av}}
{{creaturedesc}}

'''Moon snails''' are a species of [[hateable]] [[vermin]] found inhabiting [[temperate]] [[ocean]]s. They will cause unhappy [[thought]]s in [[Dwarf|dwarves]] who absolutely detest them should they encounter one. They possess a [[pet]] value of 10, and can not be caught in built animal traps, but can be caught with a "Capture a Live Land Animal" job, despite being aquatic. Beaches are ideal locations for catching moon snails.

Some dwarves [[Preferences|like]] moon snails for their ''predatory nature'' and their ''striking coloration''.

{{Translation| dwarven = ïlon nasod | elvish = anaye limi | goblin = zusla snuslû | human = oku copgur}}
[[File:Moon Snail.jpg|thumb|400px|center|Admired for its ''predatory nature''.]]

{{gamedata}}
{{vermin}}

Creature token

2024-11-11T21:23:28Z

DikbutDaGrate: Removed spam and false information.

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

The <code>[OBJECT:CREATURE]</code> [[token]] begins the definition of a ''Dwarf Fortress'' [[creature]] [[raw file]]. Each creature definition that follows begins with the {{token|creature|c|creature ID}} token, and the creature's exact properties and behavior are then specified by the use of further creature tokens. All known creature tokens are listed below.

Vanilla creature definitions can be found in <code>[[Game folder|<Dwarf Fortress>]]\data\vanilla\vanilla_creatures\</code>.
Creature ID is also used with [[graphics token]]s to make customizable [[graphics set]]s.

The [[caste]] tokens allow defining sub-species within the broader creature definition, including true biological castes and lesser variations, such as sexes. Creature tokens can either be 'Creature' or 'CASTE-only' type which can only be applied to creature or cast respectively, or 'CASTE' which can be applied to both. In the table bellow, creature type distinguish tokens that can be applied to creature only, cast only and both ('creature', 'CASTE-only', and 'CASTE' respectively)

__NOTOC__
{{clear}}
{{alphabetical TOC|style=margin: 1em auto;}}

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

|-
| {{text anchor|ADOPTS_OWNER}}
| Caste
|
| Prevents tamed creature from being made available for adoption, instead allowing it to automatically adopt whoever it wants. The basic requirements for adoption are intact, and the creature will only adopt individuals who have a [[preference]] for their species. Used by [[cat]]s in the vanilla game. When {{k|v}}iewing a tame creature with this token, the message "This animal isn't interested in your wishes" will appear instead of "This [adorable] animal can't work" or "This animal is waiting to be trained".

|-
| {{text anchor|ALCOHOL_DEPENDENT}}
| Caste
|
| Makes the creature need [[alcohol]] to get through the working day; it will choose to drink booze instead of [[water]] if possible. Going sober for too long reduces speed.

|-
| {{text anchor|ALL_ACTIVE}}
| Caste
|
| When set, the creature will appear at any time of day. Overrides {{token|DIURNAL|c}}, {{token|NOCTURNAL|c}}, {{token|CREPUSCULAR|c}}, {{token|MATUTINAL|c}}, and {{token|VESPERTINE|c}}.

|-
| {{text anchor|ALTTILE}}
| Creature
|
*'character' or tile number
| If set, the creature will blink between its {{token|TILE|c}} and its ALTTILE.

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

|-
| {{text anchor|AMPHIBIOUS}}
| Caste
|
| Allows a creature to breathe both in and out of [[water]] (unlike {{token|AQUATIC|c}}) - does not prevent drowning in [[magma]].

|-
| {{text anchor|APP_MOD_DESC_RANGE}}
| Appearance Modifier
|
*Range (6 values, low to high)
| Based on info from [http://www.bay12forums.com/smf/index.php?topic=113762.msg3473069#msg3473069 Wannabehero on the forums]: When used with an appearance modifier token (BP_APPEARANCE_MODIFIER or BODY_APPEARANCE_MODIFIER), tells the game what numeric ranges to map to which descriptors.

The game uses 7 descriptor levels for each modifier, with the center one generally being to omit the thing from the creature description entirely. The six values in APP_MOD_DESC_RANGE define the boundaries between each described range. If this is not specified it uses the numbers 10:50:95:105:150:190.

|-
| {{text anchor|APP_MOD_GENETIC_MODEL}}
| Appearance Modifier
|
*Model (Accepts DOMINANT_MORE, DOMINANT_LESS, and MIX)
| Defines a genetic model for the relevant appearance modifier(s). May or may not do anything significant at present.

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

|-
| {{text anchor|APP_MOD_NOUN}}
| Appearance Modifier
|
*noun
*SINGULAR or PLURAL
| Creates a noun for the appearance, and whether it is singular or plural.

|-
| {{text anchor|APP_MOD_RATE}}
| Appearance Modifier
|
*Rate (integer)
*Scale (DAILY, YEARLY)
*min (growth)
*max (growth)
*start year
*start day
*end year
*end day
| Setting the growth rate of the modifier. The last two tokens can be replaced by NO_END to have growth continue indefinitely.

|-
| {{text anchor|APPLY_CREATURE_VARIATION}}
| Caste
|
*creature variation ID
*(optional) any amount of arbitrary arguments
| Applies the specified [[creature variation token|creature variation]]. See [[Creature_variation_token#Arguments_and_conditional_tokens]] for how the subsequent arguments may be used.

|-
| {{text anchor|APPLY_CURRENT_CREATURE_VARIATION}}
| Special
|
| Applies the effects of all pending {{token|CV_ADD_TAG|c}} and {{token|CV_REMOVE_TAG|c}} tokens that have been defined in the current creature.

|-
| {{text anchor|AQUATIC}}
| Caste
|
| Enables the creature to breathe in water, but causes it to air-drown on dry land.

|-
| {{text anchor|ARENA_RESTRICTED}}
| Caste
|
| Causes the creature to be excluded from the [[object testing arena]]'s creature spawning list. Typically applied to spoileriffic creatures.

|-
| {{text anchor|ARTIFICIAL_HIVEABLE}}
| Creature
|
| Enables the creature to be kept in artificial [[hive]]s by [[beekeeper]]s.

|-
| {{text anchor|AT_PEACE_WITH_WILDLIFE}}
| Caste
|
| Prevents the creature from attacking or frightening creatures with the {{Token|NATURAL|c}} tag.

|-
| {{text anchor|ATTACK}}
| Caste
|
*token
*selection criteria (it's complicated)
| Defines the attack name, and the body part used. See [[#Attack Tokens|below]] for valid subtokens
'''Example:''' 
<code>[ATTACK:GORE:BODYPART:BY_CATEGORY:HORN]</code> 
''GORE'' = name of the attack 
''BODYPART:BY_CATEGORY:HORN'' = the horn is used to attack (presuming the creature has one)

|-
| {{text anchor|ATTACK_TRIGGER}}
| Caste
|
*population
*exported wealth
*created wealth
| Specifies when a [[megabeast]] or [[semi-megabeast]] will attack the fortress. The attacks will start occurring when all of the requirements are met. Setting a value to 0 disables the trigger.

|}

{{alphabetical TOC|style=margin: 1em auto;}}

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

|-
| {{text anchor|BABY}}
| Caste
|
*integer
| Age at which creature is considered a child, the default is zero. One can think of this as the duration of the baby stage.

|-
| {{text anchor|BABYNAME}}
| Caste
|
*singular
*plural
| Defines a new name for a creature in baby state at the caste level. For non-caste-specific baby names, see {{token|GENERAL_BABY_NAME|c}}.

|-
| {{text anchor|BEACH_FREQUENCY}}
| Caste
|
*integer
| Creature may be subject to [[beaching]], becoming stranded on [[Beach|shores]], where they will eventually air-drown. The number indicates the frequency of the occurrence. Presumably requires the creature to be {{token|AQUATIC|c}}. Used by [[orca]]s, [[sperm whale]]s and [[sea nettle jellyfish]] in the vanilla game.

|-
| {{text anchor|BENIGN}}
| Caste
|
| The creature is non-aggressive by default, and will never automatically be engaged by companions or soldiers, running away from any creatures that are not friendly to it, and will only defend itself if it becomes enraged. Can be thought of as the counterpoint of the {{token|LARGE_PREDATOR|c}} tag. When tamed, animals with this tag will be useless for fortress defense.

This and {{token|TRADE_CAPACITY|c}} are required for {{token|PACK_ANIMAL|c}} to function properly, if an animal contains the aforementioned requirements without this tag: items loaded by the merchants will be dropped upon departure.

|-
| {{text anchor|BIOME}}
| Creature
|
* [[biome token]]
| Select a [[biome]] the creature may appear in.

|-
| {{text anchor|BLOOD}}
| Caste
|
* <[[material token]]>
* <[[Material_definition_token#Material_States|material state]]>
| Specifies what the creature's blood is made of.

|-
| {{text anchor|BLOODSUCKER}}
| Caste
|
| Causes [[vampire]]-like behaviour; the creature will suck the [[Creature_token#BLOOD|blood]] of unconscious victims when its [[Syndrome#TIME_SINCE_SUCKED_BLOOD|thirst for blood]] grows sufficiently large. When controlling the creature in adventure mode, this can be done at will. Seems to be required to make the creature denouncable (in-world) as a creature of the night.

|-
| {{text anchor|BODY}}
| Caste
|
*body parts
| Draws body parts from OBJECT:BODY files (such as body_default.txt)
'''Example:''' 
[BODY:BODY_WITH_HEAD_FLAG:HEART:GUTS:BRAIN:MOUTH] 
This is the body from a [[purring maggot]]. It creates a body with head, a heart, some guts, a brain, and a mouth. That's all a maggot needs.

The body parts need to be listed in an order such that any parent part appears before its connected children. For example [BODY:HEART:BODY_WITH_HEAD_FLAG] produces a "Body Token Recognized But Could Not Connect: HEART" error because HEART can't find any UPPERBODY(s) to connect to. Switching the order to [BODY:BODY_WITH_HEAD_FLAG:HEART] fixes the problem because now the UPPERBODY is created before the HEART tries to connect to it.

'''If the body is left undefined, the creature (or caste) will be tagged as [DOES_NOT_EXIST].''' {{verify}}

|-
| {{text anchor|BODY_APPEARANCE_MODIFIER}}
| Caste
|
*ATTRIBUTE
*lowest
*lower
*low
*median
*high
*higher
*highest
| These body modifiers give individual creatures different characteristics. In the case of HEIGHT, BROADNESS and LENGTH, the modifier is also a percentage change to the BODY_SIZE of the individual creature. The seven numbers afterward give a distribution of ranges. Each interval has an equal chance of occurring.
'''Example:''' 
[BODY_APPEARANCE_MODIFIER:HEIGHT:90:95:98:100:102:105:110] 
''HEIGHT'' : marks the height to be changed 
''90:95:98:100:102:105:110'' : sets the range from the shortest (90% of the average height) to the tallest (110% of the average height) creature variation.

|-
| {{text anchor|BODY_DETAIL_PLAN}}
| Caste
|
*PlanName
*Arguments
| Loads a plan from 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:''' 
[BODY_DETAIL_PLAN:VERTEBRATE_TISSUE_LAYERS:SKIN:FAT:MUSCLE:BONE:CARTILAGE] 
This creates the detailed body of a [[fox]], the skin, fat, muscle, bones and cartilage out of the vertebrate tissues. 
A [[Purring maggot|maggot]] would only need: 
''[BODY_DETAIL_PLAN:EXOSKELETON_TISSUE_LAYERS:SKIN:FAT:MUSCLE]''

|-
| {{text anchor|BODY_SIZE}}
| Caste
|
*years
*days
*size
| Sets size at a given age. Size is in cubic centimeters, and for normal body materials, is roughly equal to the creature's average weight in grams.
'''Example:''' 
[BODY_SIZE:0:0:10000] 
[BODY_SIZE:1:168:50000] 
[BODY_SIZE:12:0:220000] 
This describes the size of a [[minotaur]]. Its birth size would be 10,000 cm3 (~10 kg). At 1 year and 168 days old it would be 50,000 cm3 (~50 kg). And as an adult (at 12 years old) it would be 220,000 cm3 and weigh roughly 220 kg.

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

|-
| {{text anchor|BONECARN}}
| Caste
|
| Creature eats bones. Implies {{token|CARNIVORE|c}}. [[Adventurer mode|Adventurers]] with this token are currently unable to eat bones.{{Bug|11069}}

|-
| {{text anchor|BP_ADD_TYPE}}
| Caste
|
| Adds a type to a body part - used with {{token|SET_BP_GROUP|c}}. In vanilla DF, this is used for adding the type '[[Body token#GELDABLE|GELDABLE]]' to the lower body of certain [[cat|creatures]].

|-
| {{text anchor|BP_APPEARANCE_MODIFIER}}
| Caste
|
*QUALITY
*lowest
*lower
*low
*median
*high
*higher
*highest
| Sets up the breadth of possibilities for appearance qualities for a selected BP group. EG. Eyes (CLOSE_SET, DEEP_SET, ROUND_VS_NARROW, LARGE_IRIS),Lips (THICKNESS), Nose (BROADNESS, LENGTH, UPTURNED, CONVEX), Ear (SPLAYED_OUT, HANGING_LOBES, BROADNESS, HEIGHT), Tooth (GAPS), Skull (HIGH_CHEEKBONES, BROAD_CHIN, JUTTING CHIN, SQUARE_CHIN), Neck (DEEP_VOICE, RASPY_VOICE), Head (BROADNESS, HEIGHT)

|-
| {{text anchor|BP_REMOVE_TYPE}}
| Caste
|
| Removes a type from a body part. Used with {{token|SET_BP_GROUP|c}}.

|-
| {{text anchor|BUILDINGDESTROYER}}
| Caste
|
*1 or 2
| Allows a creature to destroy furniture and buildings. Value [1] targets mostly doors, hatches, furniture and the like. Value [2] targets anything not made with the {{k|b}} + {{k|C}} commands.
|}

{{alphabetical TOC|style=margin: 1em auto;}}

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

|-
| {{text anchor|CAN_DO_INTERACTION}}
| Caste
|
*interaction token
| The creature can perform an interaction. See [[interaction token]].

|-
| {{text anchor|CAN_LEARN}}
| Caste
|
| The creature gains [[skill]]s and can have [[labor|professions]]. If a member of a civilization (even a pet) has this token, it'll need to eat, drink and sleep. Note that this token makes the creature unable to be eaten 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. A creature with at least this token or the {{token|CAN_SPEAK|c}} token will be able to have [[Personality traits, values, and dreams#Values|values]] and [[Personality traits, values, and dreams#Dreams|dreams]].

|-
| {{text anchor|CAN_SPEAK}}
| Caste
|
| Can [[talking|talk]]. Note that this is not necessary for a creature to gain social skills but to make friends in fortress mode. A creature with at least this token or the {{token|CAN_LEARN|c}} token will be able to have [[Personality traits, values, and dreams#Values|values]] and [[Personality traits, values, and dreams#Dreams|dreams]].

|-
| {{text anchor|CANNOT_CLIMB}}
| Caste
|
| Creature cannot [[climber|climb]], even if it has free grasp parts.

|-
| {{text anchor|CANNOT_JUMP}}
| Caste
|
| Creature cannot [[jump]].

|-
| {{text anchor|CANNOT_UNDEAD}}
| Caste
|
| Acts like {{token|NOT_LIVING|c}}, except that {{token|OPPOSED_TO_LIFE|c}} creatures will attack them.

|-
| {{text anchor|CANOPENDOORS}}
| Caste
|
| Allows the creature to open [[door]]s that are set to be unpassable for pets. In adventure mode, creatures lacking this token will be unable to pass through door tiles except whilst these are occupied by other creatures. Not currently useful in Fortress mode as doors can no longer be set unpassable for pets.{{version|50.03}}

|-
| {{text anchor|CARNIVORE}}
| Caste
|
| Creature ''only'' eats [[meat]]. If the creature goes on rampages in worldgen, it will often devour the people/animals it kills. Does not seem to affect the diet of the adventurer in adventure mode.

|-
| {{text anchor|CASTE}}
| Creature
|
*name
| Defines a [[caste]].

|-
| {{text anchor|CASTE_ALTTILE}}
| Caste
|
*tile number or "letter"
| Caste-specific {{token|ALTTILE|c}}. Requires {{token|CASTE_TILE|c}}.

|-
| {{text anchor|CASTE_COLOR}}
| Caste
|
*fg
*bg
*brightness
| Caste-specific {{token|COLOR|c}}.

|-
| {{text anchor|CASTE_GLOWCOLOR}}
| Caste
|
*fg
*bg
*brightness
| Caste-specific {{token|GLOWCOLOR|c}}.

|-
| {{text anchor|CASTE_GLOWTILE}}
| Caste
|
*tile value or "letter"
| Caste-specific {{token|GLOWTILE|c}}.

|-
| {{text anchor|CASTE_NAME}}
| Caste
|
*singular
*plural
*adjective
| While {{token|NAME|c}} describes the name of the species, {{token|CASTE_NAME|c}} names individuals of the species. Unlike other caste-specific descriptions, this token is required, even for creatures without separate castes. If left undefined, the creature will not show up in the [[arena]] and members of the species will be labeled as "nothing".

|-
| {{text anchor|CASTE_PROFESSION_NAME}}
| Caste
|
*[[Unit type token]] (Profession)
*singular
*plural
| Caste-specific {{token|PROFESSION_NAME|c}}.

|-
| {{text anchor|CASTE_SOLDIER_ALTTILE}}
| Caste
|
*'character' or tile number
| Caste-specific {{token|SOLDIER_ALTTILE|c}}. Requires {{token|CASTE_SOLDIER_TILE|c}}.

|-
| {{text anchor|CASTE_SOLDIER_TILE}}
| Caste
|
*'character' or tile number
| Caste-specific {{token|CREATURE_SOLDIER_TILE|c}}.

|-
| {{text anchor|CASTE_TILE}}
| Caste
|
* tile number or "letter"
| Caste-specific {{token|CREATURE_TILE|c}}.

|-
| {{text anchor|CAVE_ADAPT}}
| Caste
|
| Causes [[cave adaptation]].
Allows for creature's race to be involved in jokes that end in "And the [race] saw the sun and vomited on the spot!"

|-
| {{text anchor|CDI}}
| Caste
|
*Varies
| Specifies interaction details following a {{token|CAN_DO_INTERACTION|c}} token. See [[interaction token]].

|-
| {{text anchor|CHANGE_BODY_SIZE_PERC}}
| Caste
|
*integer
| Multiplies body size by a factor of (integer)%. 50 halves size, 200 doubles.

|-
| {{text anchor|CHANGE_FREQUENCY_PERC}}
| Creature
|
*integer
| Multiplies frequency by a factor of (integer)%.

|-
| {{text anchor|CHILD}}
| Caste
|
*integer
| Age at which creature is considered an adult - one can think of this as the duration of the [[children|child]] stage. Allows the creature's offspring to be rendered fully tame if [[animal trainer|trained]] during their childhood.

|-
| {{text anchor|CHILDNAME}}
| Caste
|
*singular
*plural
| Defines a new name for a creature in the child state at the caste level. For non-caste-specific child names, see {{token|GENERAL_CHILD_NAME|c}}.

|-
| {{text anchor|CLUSTER_NUMBER}}
| Creature
|
*min
*max
| The minimum/maximum numbers of how many creatures per spawned cluster. Vermin fish with this token in combination with temperate ocean and river biome tokens [http://www.bay12forums.com/smf/index.php?topic=51864.msg1122319#msg1122319 will perform seasonal migrations]. Defaults to 1:1 if not specified.

|-
| {{text anchor|CLUTCH_SIZE}}
| Caste
|
*min
*max
|Number of [[egg]]s laid in one sitting.

|-
| {{text anchor|COLONY_EXTERNAL}}
| Caste
|
| Caste hovers around colony.

|-
| {{text anchor|COLOR}}
| Creature
|
*foreground
*background
*brightness
| Color of the creature's tile. See [[Color]] for usage.

|-
| {{text anchor|COMMON_DOMESTIC}}
| Caste
|
| When combined with any of {{token|PET|c}}, {{token|PACK_ANIMAL|c}}, {{token|WAGON_PULLER|c}} and/or {{token|MOUNT|c}}, the creature is guaranteed to be domesticated by any [[civilization]] with {{token|COMMON_DOMESTIC_PET|e}}, {{token|COMMON_DOMESTIC_PACK|e}}, {{token|COMMON_DOMESTIC_PULL|e}} and/or {{token|COMMON_DOMESTIC_MOUNT|e}} respectively. Such civilizations will always have access to the creature, even in the absence of wild populations. This token is invalid on {{token|FANCIFUL|c}} creatures.

|-
| {{text anchor|CONVERTED_SPOUSE}}
| Caste
|
| Creatures of this caste's species with the {{token|SPOUSE_CONVERTER|c}} and {{token|NIGHT_CREATURE_HUNTER|c}} tokens will kidnap {{token|SPOUSE_CONVERSION_TARGET|c}}s of an appropriate sex and convert them into castes with CONVERTED_SPOUSE.

|-
| {{text anchor|COOKABLE_LIVE}}
| Caste
|
| Set this to allow the creature to be cooked in meals without first being butchered/cleaned. Used by some water-dwelling vermin such as [[mussel]]s, [[nautilus]]es and [[oyster]]s.

|-
| {{text anchor|CRAZED}}
| Caste
|
| Creature is '[[insanity|berserk]]' and will attack all other creatures, except members of its own species that '''also''' have the CRAZED tag. It will show {{DFtext|Berserk|4:1}} in the [[unit list]]. Berserk creatures go on rampages during [[world generation|worldgen]] much more frequently than non-berserk ones.

|-
| {{text anchor|COPY_TAGS_FROM}}
| Special
|
*creature ID
| Copies another specified creature. This will override any definitions made before it; essentially, it makes this creature identical to the other one, which can then be modified. Often used in combination with {{token|APPLY_CREATURE_VARIATION|c}} to import standard variations from a file. The vanilla [[giant animal]]s and [[animal person|animal people]]s are examples of this token combination.

|-
| {{text anchor|CREATURE}}
| Creature
|
*creature ID
| A unique, arbitrary identifier that begins the definition of each new creature, and is used to reference the creature in other tokens and raws.

|-
| {{text anchor|CREATURE_CLASS}}
| Caste
|
*classname
| An arbitrary creature classification. Can be set to anything, but the only vanilla uses are GENERAL_POISON (used in syndromes), EDIBLE_GROUND_BUG (used as targets for {{token|GOBBLE_VERMIN_CLASS|c}}), MAMMAL, and POISONOUS (both used for kobold pet eligibility). A single creature can have multiple classes.

The full list of tokens that use creature classes is:

* Creature tokens: {{token|GOBBLE_VERMIN_CLASS|c}}, {{token|GOBBLE_VERMIN_CLASS|c}}
* Interaction tokens: {{token|IT_AFFECTED_CLASS|in}}, {{token|IT_IMMUNE_CLASS|in}}
* Animal definition (Entity) tokens: {{token|ANIMAL_CLASS|e}}, {{token|ANIMAL_FORBIDDEN_CLASS|e}}
* Position (Entity) token: {{token|ALLOWED_CLASS|po}}
* Syndrome tokens: {{token|SYN_AFFECTED_CLASS|sy}}, {{token|SYN_IMMUNE_CLASS|sy}}, {{token|CE_SENSE_CREATURE_CLASS|sy}}
|-
| {{text anchor|CREATURE_SOLDIER_TILE}}
| Creature
|
*'character' or tile number
| Creatures active in their civilization's [[military]] will use this tile instead.

|-
| {{text anchor|CREATURE_TILE}}
| Creature
|
*'character' or tile number
| The symbol of the creature in ASCII mode.

|-
| {{text anchor|CREPUSCULAR}}
| Caste
|
| When set, the creature will appear at dawn (between 4:30 AM and 6:00 AM) and in the evening (between 8:00 PM and 10:05 PM) in Adventurer mode.

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

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

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

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

|-
| {{text anchor|CV_REMOVE_TAG}}
| Special
|
*TAG NAME
| Removes a tag. Used in conjunction with creature variation templates.
|}

{{alphabetical TOC|style=margin: 1em auto;}}

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

|-
| {{text anchor|DEMON}}
| Caste
|
| Found on generated [[demon]]s. Marks the caste to be used in the initial wave after breaking into the [[underworld]], and by the demon civilizations created during world-gen breachings{{verify}}.

|-
| {{text anchor|DESCRIPTION}}
| Caste
|
*text
| A brief description of the creature type, as displayed when viewing the creature's description/[[Thoughts and preferences|thoughts & preferences]] screen.

|-
| {{text anchor|DIE_WHEN_VERMIN_BITE}}
| Caste
|
| Causes the creature to die upon attacking. Used by [[honey bee]]s to simulate them dying after using their stingers.

|-
| {{text anchor|DIFFICULTY}}
| Caste
|
*integer
| Increases experience gain during adventure mode. Creatures with a difficulty of 11 or higher are not assigned for quests in adventure mode.

|-
| {{text anchor|DIURNAL}}
| Caste
|
| When set, the creature will only appear during the day (between 6:00 AM and 8:00 PM) in Adventurer mode.

|-
| {{text anchor|DIVE_HUNTS_VERMIN}}
| Caste
|
| The creature hunts vermin by diving from the air. On tame creatures, it has the same effect as {{token|HUNTS_VERMIN|c}}. Found on [[peregrine falcon]]s.

|-
| {{text anchor|DOES_NOT_EXIST}}
| Creature
|
| Adding this token to a creature prevents it from appearing in generated worlds (unless it's marked as [[Entity_token#ANIMAL_ALWAYS_PRESENT|always present]] for a particular civilisation). For example, adding it to [[dog]]s will lead to worlds being generated without dogs in them. Also removes the creature from the [[object testing arena]]'s spawn list. If combined with {{token|FANCIFUL|c}}, artistic depictions of the creature will occur regardless. Used by [[centaur]]s, [[chimera]]s and [[griffon]]s in the vanilla game.

Note: a creature tagged as DOES_NOT_EXIST can still be [[Interaction_token#I_EFFECT|summoned]] successfully, as long as it has a body defined in its raws. [http://www.bay12forums.com/smf/index.php?topic=165213.msg8086938#msg8086938]. It's also possible for another creature to [[Syndrome#CE_BODY_TRANSFORMATION|transform]] into it.
|}

{{alphabetical TOC|style=margin: 1em auto;}}

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

|-
| {{text anchor|EBO_ITEM}}
| Caste
|
*[[item token]]
*[[material token]] (ANY_HARD_STONE can be used for the material)
| Defines the item that the creature drops upon being [[butcher|butchered]]. Used with {{token|EXTRA_BUTCHER_OBJECT|c}}.

|-
| {{text anchor|EBO_SHAPE}}
| Caste
|
*gem shape
| The shape of the creature's extra [[butcher|butchering]] drop. Used with {{token|EXTRA_BUTCHER_OBJECT|c}}.

|-
| {{text anchor|EGG_MATERIAL}}
| Caste
|
* <[[material token]]>
* <[[Material_definition_token#Material_States|material state]]>
| Defines the material composition of [[egg]]s laid by the creature. [[creature_token#LAYS_EGGS|Egg-laying]] creatures in the default game define this 3 times, using LOCAL_CREATURE_MAT:EGGSHELL, LOCAL_CREATURE_MAT:EGG_WHITE, and then LOCAL_CREATURE_MAT:EGG_YOLK. Eggs will be made out of eggshell. Edibility is determined by tags on whites or yolk, but they otherwise do not exist.

|-
| {{text anchor|EGG_SIZE}}
| Caste
|
*size
| Determines the size of laid [[egg]]s. Doesn't affect hatching or cooking, but bigger eggs will be heavier, and may take longer to be hauled depending on the hauler's strength.

|-
| {{text anchor|EQUIPMENT_WAGON}}
| Creature
|
| Makes the creature appear as a large 3×3 [[wagon]] responsible for carrying trade goods, pulled by two {{token|WAGON_PULLER|c}} creatures and driven by a merchant.

|-
| {{text anchor|EQUIPS}}
| Caste
|
| Allows the creature to wear or wield items.

|-
| {{text anchor|EVIL}}
| Creature
|
| The creature is considered evil and will only show up in evil biomes. Civilizations with {{token|USE_EVIL_ANIMALS|e}} can domesticate them regardless of exotic status. Has no effect on cavern creatures except to restrict taming. A civilization with evil creatures can colonise evil areas.

|-
| {{text anchor|EXTRA_BUTCHER_OBJECT}}
| Caste
|
* BY_CATEGORY, BY_TYPE, BY_TOKEN
* TYPE, CATEGORY, or TOKEN
| The creature drops an additional object when [[butcher|butchered]], as defined by {{token|EBO_ITEM|c}} and {{token|EBO_SHAPE|c}}. Used for [[gizzard stone]]s in default creatures. For some materials, needs to be defined after caste definitions with SELECT_CASTE:ALL{{Bug|6355}}

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

|-
| {{text anchor|EXTRAVISION}}
| Caste
|
| The creature can see regardless of whether it has working eyes and has full 360 degree vision, making it impossible to strike the creature from a blind spot in combat. Invisible creatures will also be seen, namely [[intelligent undead]] using a "vanish" power.
|}

{{alphabetical TOC|style=margin: 1em auto;}}

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

|-
| {{text anchor|FANCIFUL}}
| Creature
|
| The creature is a thing of legend and known to all civilizations. Its materials cannot be requested or preferred. The tag also adds some art value modifiers. Used by a [[Fanciful|number of creatures]]. Conflicts with {{token|COMMON_DOMESTIC|c}}.

|-
| {{text anchor|FEATURE_ATTACK_GROUP}}
| Caste
|
| Found on [[Animal people#Subterranean animal people|subterranean animal-man]] tribals. Currently defunct. In previous versions{{verify}}, it caused these creatures to crawl out of chasms and underground rivers.

|-
| {{text anchor|FEATURE_BEAST}}
| Caste
|
| Found on [[forgotten beast]]s. Presumably makes it act as such, initiating underground attacks on fortresses, or leads to the pop-up message upon encountering one{{verify}}. Hides the creature from displaying in a world_sites_and_pops file. Does not create historical figures like generated forgotten beasts do.

Requires specifying a {{token|BIOME|c}} in which the creature will live, and both surface and subterranean biomes are allowed. Does not stack with {{token|LARGE_ROAMING|c}} and if both are used the creature will not spawn. Appears to be incompatible with {{token|DEMON|c}} even if used in separate castes.

|-
| {{text anchor|FEMALE}}
| Caste
|
| Makes the creature biologically female, enabling her to [[Breeding|bear young]]. Usually specified inside a caste.

|-
| {{text anchor|FIREIMMUNE}}
| Caste
|
| Makes the creature immune to [[Interaction_token#FIREBALL|FIREBALL]] and [[Interaction_token#FIREJET|FIREJET]] attacks, and allows it to path through high temperature zones, like lava or fires. Does not, by itself, make the creature immune to the damaging effects of burning in [[fire]], and does not prevent general heat damage or melting on its own (this would require adjustments to be made to the creature's body [[Material_definition_token|materials]] - see the [[Dragon/raw|dragon raws]] for an example).

|-
| {{text anchor|FIREIMMUNE_SUPER}}
| Caste
|
| Like {{token|FIREIMMUNE|c}}, but also renders the creature immune to [[Interaction_token#DRAGONFIRE|DRAGONFIRE]] attacks.

|-
| {{text anchor|FISHITEM}}
| Caste
|
| The creature's corpse is a single [[Item_token#FISH_RAW|FISH_RAW]] food item that needs to be cleaned (into a [[Item_token#FISH|FISH]] item) at a [[fishery]] to become edible. Before being cleaned the item is referred to as "raw". The food item is categorized under "fish" on the food and stocks screens, and when uncleaned it is sorted under "raw fish" in the stocks (but does not show up on the food screen).
Without this or {{token|COOKABLE_LIVE|c}}, [[fishing|fished]] vermin will turn into food the same way as non-vermin creatures, resulting in multiple units of food (meat, brain, lungs, eyes, spleen etc.) from a single fished vermin. These units of food are categorized as meat by the game.

|-
| {{text anchor|FIXED_TEMP}}
| Caste
|
*temperature
| The creature's body is constantly at this temperature, heating up or cooling the surrounding area. Alters the temperature of the creature's inventory and all adjacent tiles, [[Temperature|with all the effects that this implies]] - may trigger wildfires at high enough values. Also makes the creature immune to extreme heat or cold, as long as the temperature set is not harmful to the materials that the creature is made from. Corpses and body parts of creatures with a fixed temperature maintain their temperature even after death.

Note that temperatures of 12000 and higher may cause [[path|pathfinding]] issues in fortress mode.

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

|-
| {{text anchor|FLIER}}
| Caste
|
| Allows a creature to fly, independent of it having wings or not. Fortress Mode pathfinding only partially incorporates flying - flying creatures need a land path to exist between them and an area in order to access it, but as long as one such path exists, they do not need to use it, instead being able to fly over intervening obstacles. Winged creatures with this token can lose their ability to fly if their wings are crippled or severed. Winged creatures without this token will be unable to fly. (A 'wing' in this context refers to any body part with its own [[Body_token#FLIER|FLIER]] token).

|-
| {{text anchor|FREQUENCY}}
| Creature
|
*number, max 100
| Determines the chances of a creature appearing within its environment, with higher values resulting in more frequent appearance. Also affects the chance of a creature being brought in a caravan for trading.
This value is used multiply to determine the rarity of animal populations. A creature with [FREQUENCY:50] will appear in 50% of valid biomes, and be present in 50% of the area within those biomes.
When a [[Creature token#CLUSTER_NUMBER|cluster]] spawns, the game effectively considers all creatures that can possibly appear and uses the FREQUENCY value as a ''weight'' - for example, if there are three creatures with frequencies 10/25/50, the creature with [FREQUENCY:50] will appear approximately 58.8% of the time. Defaults to 50 if not specified. Not to be confused with {{token|POP_RATIO|c}}.
|}

{{alphabetical TOC|style=margin: 1em auto;}}

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

|-
| {{text anchor|GAIT}}
| Caste
|
* <gait type>
* <gait name>
* <max [[Gait#Speed|speed]]>
* <build up time>
* <max turning [[Gait#Speed|speed]]>
* <start [[Gait#Speed|speed]]>
* <energy expenditure>
* <gait flag(s)>
| Defines a gait by which the creature can move. See [[Gait]] for more information. Specifically, you likely want to use one of the existing STANDARD_X_GAITS creature variations, as described in [[Gait#Gaits_and_Modding|this subsection]].

* <max speed> indicates the maximum [[Gait#Speed|speed]] achievable by a creature using this gait
* <start speed> indicates the creature's speed when it starts moving using this gait
* <build up time> indicates how long it will take for a creature using this gait to go from <start speed> to <max speed>. For example, a value of 10 means that it should be able to reach the maximum speed by moving 10 [[tile]]s in a straight line over even terrain.
* <max turning speed> indicates the maximum speed permissible when the creature suddenly changes its direction of motion. The creature's speed will be reduced to <max turning speed> if travelling at a higher speed than this before turning.
* <energy expenditure> indicates how energy-consuming the gait is. Higher values cause the creature to tire out faster. Persistent usage of a high-intensity gait will eventually lead to exhaustion and [[Status_icon#Non-flashing|collapse]].

'''NO_BUILD_UP''' can be specified instead of a <start speed> value to make the <max speed> instantly achievable upon initiating movement (this is equivalent to a <build up time> of 0). Note that <build up time> and <max turning speed> are both ignored if specified alongside this (as NO_BUILD_UP trumps <build up time> and preserves <max speed> whilst turning, and <max turning speed> cannot exceed <max speed>) so it is permissible to omit them so long as they are '''both''' omitted together.

It's possible to specify a <start speed> greater than the <max speed>; the moving creature will decelerate towards its <max speed> in this case.

'''valid gait types:'''
*'''WALK''' 
Used for moving normally over ground tiles.

*'''CRAWL''' 
Used for moving over ground tiles whilst [[Status_icon#Non-flashing|prone]].

*'''SWIM''' 
Used for moving through tiles containing [[water]] or [[magma]] at a [[Water#Depth|depth]] of at least 4/7.

*'''FLY''' 
Used for moving through [[open space]].

*'''CLIMB''' 
Used for moving whilst [[Climber|climbing]].

'''valid gait flags:'''
* '''AGILITY''' 
Speeds/slows movement depending on the creature's [[Attribute#Agility|Agility]] stat.

* '''STRENGTH''' 
Speeds/slows movement depending on the creature's [[Attribute#Strength|Strength]] stat.

* '''LAYERS_SLOW''' 
Makes [[Tissue_definition_token#THICKENS_ON_ENERGY_STORAGE|THICKENS_ON_ENERGY_STORAGE]] and [[Tissue_definition_token#THICKENS_ON_STRENGTH|THICKENS_ON_STRENGTH]] tissue layers slow movement depending on how thick they are. Adding the STRENGTH gait flag counteracts the impact of the latter layer.

* '''STEALTH_SLOWS:'''<percentage> 
Slows movement by the specified percentage when the creature is [[Ambusher|sneaking]].

|-
| {{text anchor|GENERAL_BABY_NAME}}
| Creature
|
*singular
*plural
| Like {{token|BABYNAME|c}}, but applied regardless of caste.

|-
| {{text anchor|GENERAL_CHILD_NAME}}
| Creature
|
*singular
*plural
| Like {{token|CHILDNAME|c}}, but applied regardless of caste.

|-
| {{text anchor|GENERAL_MATERIAL_FORCE_MULTIPLIER}}
| Caste
|
*value A
*value B
| Has the same function as {{token|MATERIAL_FORCE_MULTIPLIER|c}}, but applies to all attacks instead of just those involving a specific material. Appears to be overridden by MATERIAL_FORCE_MULTIPLIER ([[werebeast]]s, for example, use both tokens to provide resistance to all materials, with one exception to which they are especially vulnerable).

|-
| {{text anchor|GENERATED}}
| Creature
|
| Found on procedurally generated creatures like [[forgotten beast]]s, [[titan]]s, [[demon]]s, [[angel]]s, and [[night creature]]s. Cannot be specified in user-defined raws.

|-
| {{text anchor|GETS_INFECTIONS_FROM_ROT}}
| Caste
|
| Makes the creature get [[Health_care#Infection|infections]] from necrotic tissue.

|-
| {{text anchor|GETS_WOUND_INFECTIONS}}
| Caste
|
| Makes the creature's wounds become [[Health_care#Infection|infected]] if left untreated for too long.

|-
| {{text anchor|GLOWCOLOR}}
| Creature
|
*foreground
*background
*brightness
| The colour of the creature's {{token|GLOWTILE|c}}.

|-
| {{text anchor|GLOWTILE}}
| Creature
|
*ascii character
| If present, the being glows in the dark (generally used for Adventurer 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 {{token|CASTE_GLOWTILE|c}} instead.

|-
| {{text anchor|GNAWER}}
| Caste
|
*verb
| The creature can and will gnaw its way out of [[animal trap]]s and [[cage]]s using the specified verb, depending on the material from which it is made (normally wood).

|-
| {{text anchor|GOBBLE_VERMIN_CLASS}}
| Caste
|
*class
| The creature eats vermin of the specified class.

|-
| {{text anchor|GOBBLE_VERMIN_CREATURE}}
| Caste
|
*creature
*caste
| The creature eats a specified [[vermin]].

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

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

|-
| {{text anchor|GO_TO_TAG}}
| Special
|
| When using tags from an existing creature, inserts new tags ''before'' the specified tag.

|-
| {{text anchor|GOOD}}
| Creature
|
| Creature is considered good and will only show up in good biomes - [[unicorn]]s, for example. Civilizations with {{token|USE_GOOD_ANIMALS|e}} can domesticate them regardless of exotic status. Has no effect on cavern creatures except to restrict taming. A civilization that has good creatures can colonise good areas in world-gen.

|-
| {{text anchor|GRASSTRAMPLE}}
| Caste
|
*value
| The value determines how rapidly [[grass]] is trampled when a creature steps on it - a value of 0 causes the creature to never damage grass, while a value of 100 causes grass to be trampled as rapidly as possible. Defaults to 5.

|-
| {{text anchor|GRAVITATE_BODY_SIZE}}
| Caste
|
*target value
| Used in Creature Variants. This token changes the adult body size to the average of the old adult body size and the target value and scales all intermediate growth stages by the same factor.

|-
| {{text anchor|GRAZER}}
| Caste
|
*number
| The creature is a grazer - if tamed in fortress mode, it needs a pasture to survive. The higher the number, the less frequently it needs to eat in order to live. Not used since 0.40.12, replaced by {{token|STANDARD_GRAZER|c}} to fix {{bugl|4113}}.
|}

{{alphabetical TOC|style=margin: 1em auto;}}

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

|-
| {{text anchor|HABIT}}
| Caste
|
*type
*probability
| Defines certain behaviors for the creature. The habit types are:
*COLLECT_TROPHIES
*COOK_PEOPLE
*COOK_VERMIN
*GRIND_VERMIN
*COOK_BLOOD
*GRIND_BONE_MEAL
*EAT_BONE_PORRIDGE
*USE_ANY_MELEE_WEAPON
*GIANT_NEST
*COLLECT_WEALTH.
These require the creature to have a {{token|LAIR|c}} to work properly, and also don't seem to work on creatures who are not a {{token|SEMIMEGABEAST|c}}, {{token|MEGABEAST|c}}, or{{token|NIGHT_CREATURE_HUNTER|c}}.

|-
| {{text anchor|HABIT_NUM}}
| Caste
|
*number or TEST_ALL
| "If you set HABIT_NUM to a number, it should give you that exact number of habits according to the weights.".{{cite forum|60554/1719248}} All lists of HABITs are preceded by [HABIT_NUM:TEST_ALL]

|-
| {{text anchor|HAS_NERVES}}
| Caste
|
| The creature has nerves in its muscles. Cutting the muscle tissue can sever motor and sensory nerves.

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

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

|-
| {{text anchor|HOMEOTHERM}}
| Caste
|
*number or NONE
| Default 'NONE'. The creature's normal body [[temperature]]. Creature ceases maintaining temperature on death unlike fixed material temperatures. Provides minor protection from environmental temperature to the creature.

|-
| {{text anchor|HUNTS_VERMIN}}
| Caste
|
| Creature hunts and kills nearby [[vermin]], randomly walking between places with food laying on the ground or in stockpiles, to check for possible [VERMIN_EATER] vermin, but they'll kill any other vermin too. Do not include this creature token on an intelligent entity that you intend to play as in fortress mode because it will prevent them from feeding themselves.

|}

{{alphabetical TOC|style=margin: 1em auto;}}

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

|-
| {{text anchor|IMMOBILE}}
| Caste
|
| The creature cannot move. Found on [[sponge]]s. Will also stop a creature from breeding in fortress mode (MALE and FEMALE are affected, if one is IMMOBILE; no breeding will happen).

|-
| {{text anchor|IMMOBILE_LAND}}
| Caste
|
| The creature is immobile while on land. Only works on {{token|AQUATIC|c}} creatures which can't breathe on land.

|-
| {{text anchor|IMMOLATE}}
| Caste
|
| The creature radiates [[fire]]. It will ignite, and potentially completely destroy, items the creature is standing on. Also gives the vermin a high chance of escaping from [[animal trap]]s and [[cage]]s made of any flammable materials (specifically ones that could be ignited by magma).

|-
| {{text anchor|INTELLIGENT}}
| Caste
|
| Alias for {{token|CAN_SPEAK|c}} + {{token|CAN_LEARN|c}}.

|-
| {{text anchor|ITEMCORPSE}}
| Caste
|
* [[item token]]
* [[material token]]
| Determines if the creature leaves behind a non-standard corpse (i.e. wood, statue, bars, stone, pool of liquid, etc.). [[Ethics]] may prevent actually using the item in jobs or reactions.

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

{{alphabetical TOC|style=margin: 1em auto;}}

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

|-
| {{text anchor|LAIR}}
| Caste
|
*type
*probability
| Found on megabeasts, semimegabeasts, and night creatures. The creature will seek out sites of this type and take them as lairs. The lair types are:
*SIMPLE_BURROW
*SIMPLE_MOUND
*WILDERNESS_LOCATION
*SHRINE
*LABYRINTH

|-
| {{text anchor|LAIR_CHARACTERISTIC}}
| Caste
|
*characteristic
*probability
| Defines certain features of the creature's lair. The only valid characteristic is HAS_DOORS.

|-
| {{text anchor|LAIR_HUNTER}}
| Caste
|
| This creature will actively hunt adventurers in its lair.

|-
| {{text anchor|LAIR_HUNTER_SPEECH}}
| Caste
|
*speech file
| What this creature says while hunting adventurers in its lair.

|-
| {{text anchor|LARGE_PREDATOR}}
| Caste
|
| Will attack other creatures that are smaller than it. In [[fortress mode]], only one group of "large predators" (possibly two groups on "savage" maps) will appear on any given map. In [[adventurer mode]], large predators will try to ambush and attack you (and your party will attack them back). When tamed, large predators tend to be much more aggressive to enemies than non-large predators, making them a good choice for an animal army. They may go on rampages in worldgen, and adventurers may receive quests to kill them. Also, they can be mentioned in the intro paragraph when starting a fortress e.g. "ere the wolves get hungry."
A single biome supports 7 large predator species, picking randomly and rolling a d100 under its {{token|FREQUENCY|c}} to add it until all 7 slots are filled.

Incompatible with {{token|PACK_ANIMAL|c}} on a technicality, if included: hauled items are likely to be dropped upon entering the map (even if {{token|TRADE_CAPACITY|c}} is present) in contrast to when the merchants depart.

|-
| {{text anchor|LARGE_ROAMING}}
| Creature
|
| This is the core requisite tag allowing the creature to spawn as a wild animal in the appropriate biomes. Requires specifying a {{token|BIOME|c}} in which the creature will spawn. Does not require specifying a frequency, population number, or cluster number.

This tag stacks with {{token|MEGABEAST|c}}, {{token|SEMIMEGABEAST|c}}, or {{token|NIGHT_CREATURE_HUNTER|c}}; if used with one of these tags, the creature will spawn as both a boss and as a wild animal. This tag does not stack with {{token|FEATURE_BEAST|c}} and if both are used the creature will not spawn. This tag is unaffected by {{token|DEMON|c}}.

|-
| {{text anchor|LAYS_EGGS}}
| Caste
|
| Creature lays [[egg]]s instead of giving birth to live young.

|-
| {{text anchor|LAYS_UNUSUAL_EGGS}}
| Caste
|
* [[item token]]
* [[material token]]
| Creature lays the specified item instead of regular eggs.

|-
| {{text anchor|LIGAMENTS}}
| Caste
|
* [[material token]]
*healing rate
| The creature has ligaments in its {{token|CONNECTIVE_TISSUE_ANCHOR|td}} tissues (bone or chitin by default). Cutting the bone/chitin tissue severs the ligaments, disabling motor function if the target is a limb.

|-
| {{text anchor|LIGHT_GEN}}
| Caste
|
| A vermin featuring this tag will remain visible to an adventurer even at night.

Subterranean vermin which feature this token will flicker in unexposed and unrevealed cavern layers while playing in Fortress Mode.

|-
| {{text anchor|LIKES_FIGHTING}}
| Caste
|
| The creature will attack enemies rather than flee from them. This tag has the same effect on player-controlled creatures - including modded dwarves. Retired as of v0.40.14 in favor of {{token|LARGE_PREDATOR|c}}.

|-
| {{text anchor|LISP}}
| Caste
|
| Creature uses "sssssnake talk" (multiplies 'S' when talking - "My name isss Recisssiz."). Used by [[Serpent man|serpent men]] and [[Reptile man|reptile men]] in the vanilla game. C's with the same pronunciation (depending on the word) are not affected by this token.

|-
| {{text anchor|LITTERSIZE}}
| Caste
|
* minimum
* maximum
| Determines the number of offspring per one birth; default 1-3, not used in vanilla raws. See also {{token|MULTIPLE_LITTER_RARE|c}}.

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

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

|-
| {{text anchor|LOCKPICKER}}
| Caste
|
| Lets a creature open [[door]]s that are set to forbidden in fortress mode.

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

|-
| {{text anchor|LOW_LIGHT_VISION}}
| Caste
|
*number
| Determines how well a creature can see in the dark - higher is better. Dwarves have 10000, which amounts to perfect nightvision.
|}

{{alphabetical TOC|style=margin: 1em auto;}}

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

|-
| {{text anchor|MAGICAL}}
| Caste
|
| According to Toady One, this is completely interchangeable with {{token|AT_PEACE_WITH_WILDLIFE|c}} and might have been used in very early versions of the game by wandering wizards or the ent-type tree creatures that used to be animated by elves. [http://www.bay12forums.com/smf/index.php?topic=169696.msg8316954#msg8316954]

|-
| {{text anchor|MAGMA_VISION}}
| Caste
|
| The creature is able to see while submerged in [[magma]].

|-
| {{text anchor|MALE}}
| Caste
|
| Makes the creature biologically male. Usually declared inside a caste.

|-
| {{text anchor|MANNERISM|MANNERISM_*}}
| Caste
|
*occasionally body part
| Adds a possible mannerism to the creature's profile. See [[creature mannerism token]] for further info.

|-
| {{text anchor|MATERIAL}}
| Creature
|
*material id
| Begins defining a new local material. Follow this with standard material definition tokens to define the material.

|-
| {{text anchor|MATERIAL_FORCE_MULTIPLIER}}
| Caste
|
*[[Material token]]
*value A
*value B
| When struck with a weapon made of the specified material, the force exerted will be multiplied by A/B, thus making the creature more or less susceptible to this material. For example, if A is 2 and B is 1, the force exerted by the defined material will be doubled. If A is 1 and B is 2, it will be halved instead. See also {{token|GENERAL_MATERIAL_FORCE_MULTIPLIER|c}}, which can be used to make this sort of effect applicable to all materials.

|-
| {{text anchor|MATUTINAL}}
| Caste
|
| When set, the creature will only appear at dawn (between 4:30 AM and 6:00 AM) in Adventurer mode.

|-
| {{text anchor|MAXAGE}}
| Caste
|
*min
*max
| Determines the creature's natural lifespan, using the specified minimum and maximum age values (in years). Each individual creature with this token is generated with a predetermined date (calculated down to the exact [[time|tick]]!) between these values, at which it is destined to die of old age, should it live long enough. Note that the probability of death at any given age does not increase as the creature gets older [http://i.imgur.com/A1A4aA9.png].
Creatures which lack this token are naturally immortal. The [[Syndrome#CE_ADD_TAG|NO_AGING]] syndrome tag will prevent death by old age from occurring. Also note that, among civilized creatures, castes which lack this token will refuse to marry others with it, and vice versa.

|-
| {{text anchor|MEANDERER}}
| Caste
|
| Makes the creature slowly stroll around, unless it's in combat or performing a job. If combined with {{token|CAN_LEARN|c}}, will severely impact their [[pathfinding]] and lead the creature to move extremely slowly when not performing any task. Problematically applies to animal people based on the animal and war trained animals{{bug|9588}}.

|-
| {{text anchor|MEGABEAST}}
| Caste
|
| A 'boss' creature. A small number of the creatures are created during worldgen, their histories and descendants (if any) will be tracked in worldgen (as opposed to simply 'spawning'), and they will occasionally go on rampages, potentially leading to worship if they attack the same place multiple times. Their presence and number will also influence age names. When appearing in fortress mode, they will have a pop-up message announcing their arrival. They will remain hostile to military even after being tamed.{{bug|10731}} See [[megabeast]] page for more details.

Requires specifying a {{token|BIOME|c}} in which the creature will live. Subterranean biomes appear to not be allowed. Does stack with {{token|LARGE_ROAMING|c}} and if both are used the creature will spawn as both historical bosses and as wild animals.

|-
| {{text anchor|MENT_ATT_CAP_PERC}}
| Caste
|
*[[Attribute|ATTRIBUTE]] Token
*Cap %
|Default is 200. This means you can increase your attribute to 200% of its starting value (or the average value + your starting value if that is higher).

|-
| {{text anchor|MENT_ATT_RANGE}}
| Caste
|
*[[Attribute|ATTRIBUTE]]
*lowest
*lower
*low
*median
*high
*higher
*highest
| Sets up a [[Attribute#Soul_attributes|mental attribute]]'s range of values (0-5000). All mental attribute ranges default to 200:800:900:1000:1100:1300:2000.

|-
| {{text anchor|MENT_ATT_RATES}}
| Caste
|
*[[Attribute|ATTRIBUTE]] Token
*cost to improve
*unused counter rate
*rust counter rate
*demotion counter rate
| [[Attribute#Soul_attributes|Mental attribute]] gain/decay rates. Lower numbers in the last three slots make decay occur faster. Defaults are 500:4:5:4.

|-
| {{text anchor|MILKABLE}}
| Caste
|
* [[material token]]
* frequency
| Allows the creature to be [[milk]]ed in the [[farmer's workshop]]. The frequency is the amount of [[time|ticks]] the creature needs to "recharge" (i.e. how much time needs to pass before it can be milked again). Does not work on [[#CAN_LEARN|sentient]] creatures, regardless of [[ethics]].

|-
| {{text anchor|MISCHIEVIOUS}}
| Caste
|
| Alias for {{token|MISCHIEVOUS|c}}.

|-
| {{text anchor|MISCHIEVOUS}}
| Caste
|
| The creature spawns [[stealth]]ed and will attempt to path into the fortress, pulling any [[lever]]s it comes across. It will be invisible on the map and [[unit list]] until spotted by a citizen, at which point the game will pause and recenter on the creature. Used by [[gremlin]]s in the vanilla game. "They go on little missions to mess with various fortress buildings, not just levers."

|-
| {{text anchor|MODVALUE}}
| Caste
|
| Seemingly no longer used.

|-
| {{text anchor|MOUNT}}
| Caste
|
| Creature may be used as a [[mount]]. No use for the player in fortress mode, but enemy sieging forces may arrive with cavalry. Mounts are usable in adventure mode.

|-
| {{text anchor|MOUNT_EXOTIC}}
| Caste
|
| Creature may be used as a [[mount]], but civilizations cannot domesticate it in worldgen without certain exceptions.

|-
| {{text anchor|MULTIPART_FULL_VISION}}
| Caste
|
| Allows the creature to have all-around vision, as long as it has multiple heads that can see.

|-
| {{text anchor|MULTIPLE_LITTER_RARE}}
| Caste
|
| Makes the species usually produce a single offspring per birth, with a 1/500 chance of using the {{token|LITTERSIZE|c}} as usual. Requires {{token|FEMALE|c}}.

|-
| {{text anchor|MUNDANE}}
| Creature
|
| Marks if the creature is an actual real-life creature. Only used for age-names at present.
|}

{{alphabetical TOC|style=margin: 1em auto;}}

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

|-
| {{text anchor|NAME}}
| Creature
|
*singular
*plural
*adjective
| The generic name for any creature of this type - will be used for referring to the species in the abstract, such as the default material prefix. For labeling individual creatures, {{token|CASTE_NAME|c}} is necessary. If left undefined, the creature will be labeled as "nothing" by the game.

Some examples of adjective use:
* "super''dwarven'' strength"
* "the ''dwarven'' hillocks of X"
* Deity species as in "''feline'' deity"
* Megabeast attacks in worldgen. One with multiple dragons being a "''draconic'' rampage"

|-
| {{text anchor|NATURAL}}
| Caste
|
| Animal is considered to be natural. NATURAL animals will not engage creatures tagged with {{token|AT_PEACE_WITH_WILDLIFE|c}} in combat unless they are members of a hostile entity and vice-versa.

|-
| {{text anchor|NATURAL_ANIMAL}}
| Caste
|
| Alias of {{token|NATURAL|c}}.

|-
| {{text anchor|NATURAL_SKILL}}
| Caste
|
*[[Skill_token|Skill token]]
*value
| The creature possesses the specified [[skill]] at this level inherently - that is, it begins with the skill at this level, and the skill may never rust below that. A value of 15 is legendary.

|-
| {{text anchor|NIGHT_CREATURE}}
| Caste
|
| Creatures with this token can appear as [[experiment|experiments]].
Prevents {{token|LOCAL_POPS_PRODUCE_HEROES|c}} from functioning. Causes the creature to count as {{token|NOT_LIVING|c}}. Killing a creature featuring this token provides one point of "hero" reputation. Adds the creature's description as part of the initial summary of their historical figure in legends mode. Prevents creature behavior enabled by {{token|LARGE_PREDATOR|c}}. People will react to creatures with this token as a night creature (natch). In adventure mode, ambushes involving these units will say "Night creature!" instead of "Ambush!"

Prevents the AI from using ANIMATE interactions, unless the newly-animated{{token|OPPOSED_TO_LIFE|c}}undead will not attack them. The check for this is specifically whether the unit is:
*a ghost
*an animated unit
*a unit with the {{token|NO_AGING|c}} token added via {{token|CE_ADD_TAG|c}}. (This allows for the default exclusion of elves and goblins, unless raised as intelligent undead.)

''This token should not be confused with other NIGHT_CREATURE_X tokens.''
''This token is not well understood at the present time.''

|-
| {{text anchor|NIGHT_CREATURE_BOGEYMAN}}
| Caste
|
| Creatures with this token can appear in [[bogeyman|bogeyman ambushes]] in [[adventure mode]], where they adopt classical bogeyman traits such as stalking the adventurer and vaporising when dawn breaks. Such traits do not manifest if the creature is encountered outside of a bogeyman ambush (for instance, as a megabeast or a civilised being). In addition, their corpses and severed body parts turn into [[smoke]] after a short while. Note that setting the "Number of Bogeyman Types" in [[advanced world generation]] to 0 will only remove randomly-generated bogeymen.

|-
| {{text anchor|NIGHT_CREATURE_EXPERIMENTER}}
| Caste
|
| Found on some [[necromancer]]s. Creatures with this tag may periodically "perform horrible experiments" offscreen, during which they can use creature-targeting interactions with an <code>[[Interaction_token#I_SOURCE|[I_SOURCE:EXPERIMENT]]]</code> tag on living creatures in their area. Worlds are generated with a list of procedurally-generated experiments, allowing necromancers to turn living people and animals into [[Infected_ghoul|ghouls]] and [[Experiment|other experimental creatures]], and these will automatically be available to all experimenters; it does not appear possible to prevent this. You can mod in your own custom experiment interactions, but these are used very infrequently due to the large number of generated experiments.

|-
| {{text anchor|NIGHT_CREATURE_HUNTER}}
| Caste
|
| Found on [[night troll]]s and [[werebeast]]s. Implies that the creature is a [[night creature]], and shows its description in [[legends mode]] entry. The creature is always hostile and will start [[no quarter]] combat with any nearby creatures, except for members of its own race. Note that this tag does not override the creature's normal behavior in [[fortress mode]] except for the aforementioned aggression, and doesn't prevent the creature from fleeing the battles it started. It also removes the creature's materials from stockpile settings list, making them be stored there regardless of settings.

Does stack with {{token|LARGE_ROAMING|c}} and if both are used the creature will spawn as both historical hunters and as wild animals; this requires specifying a {{token|BIOME|c}} in which the creature will live, and subterranean biomes are allowed.

This tag causes the usual behaviour of werebeasts in worldgen, that is, fleeing towns upon being cursed and conducting raids from a lair. If this tag is absent from a deity curse, the accursed will simply be driven out of towns in a similar manner to [[vampire]]s. When paired with SPOUSE_CONVERTER, a very small population of the creature will be created during worldgen (sometimes only a single individual will be created), and their histories will be tracked (that is, they will not spawn spontaneously later, they must either have children or convert other creatures to increase their numbers). The creature will settle in a lair and go on rampages during worldgen. It will actively attempt to seek out potential conversion targets to abduct, convert, and have children with (if possible).

|-
| {{text anchor|NIGHT_CREATURE_NIGHTMARE}}
| Caste
|
| Found on [[nightmare]]s. Corpses and severed body parts derived from creatures with this token turn into [[smoke]] after a short while.

|-
| {{text anchor|NO_AUTUMN}}
| Caste
|
| The creature caste does not appear in [[Calendar|autumn]].

|-
| {{text anchor|NO_CONNECTIONS_FOR_MOVEMENT}}
| Caste
|
| Creature doesn't require connected body parts to move{{verify}}; generally used on undead creatures with connections that have rotted away.

|-
| {{text anchor|NO_DIZZINESS}}
| Caste
|
| Creature cannot become [[Symptom#Dizziness|dizzy]].

|-
| {{text anchor|NO_DRINK}}
| Caste
|
| Creature does not need to drink.

|-
| {{text anchor|NO_EAT}}
| Caste
|
| Creature does not need to [[food|eat]].

|-
| {{text anchor|NO_FEVERS}}
| Caste
|
| Creature cannot suffer [[Symptom#Fever|fevers]].

|-
| {{text anchor|NO_GENDER}}
| Caste
|
| The creature is biologically sexless, making it unable to [[breeding|breed]].

|-
| {{text anchor|NO_PHYS_ATT_GAIN}}
| Caste
|
| The creature cannot raise any [[Attribute#Body_attributes|physical attributes]].

|-
| {{text anchor|NO_PHYS_ATT_RUST}}
| Caste
|
| The creature cannot lose any [[Attribute#Body_attributes|physical attributes]].

|-
| {{text anchor|NO_SLEEP}}
| Caste
|
| Creature does not need to sleep, but can still be rendered unconscious by other means.

|-
| {{text anchor|NO_SPRING}}
| Caste
|
| The creature caste does not appear in [[Calendar|spring]].

|-
| {{text anchor|NO_SUMMER}}
| Caste
|
| The creature caste does not appear in [[Calendar|summer]].

|-
| {{text anchor|NO_THOUGHT_CENTER_FOR_MOVEMENT}}
| Caste
|
| Creature doesn't require an organ with the {{token|THOUGHT|body}} tag to survive or attack; generally used on creatures that don't have brains.

|-
| {{text anchor|NO_UNIT_TYPE_COLOR}}
| Caste
|
| Prevents creature from selecting its color based on its profession (e.g. Miner, Hunter, Wrestler).

|-
| {{text anchor|NO_VEGETATION_PERTURB}}
| Caste{{Verify}}
|
| Likely prevents the creature from leaving broken vegetation tracks.{{Verify}}

|-
| {{text anchor|NO_WINTER}}
| Caste
|
| The creature caste does not appear in [[Calendar|winter]].

|-
| {{text anchor|NOBONES}}
| Caste
|
| Creature has no bones.

|-
| {{text anchor|NOBREATHE}}
| Caste
|
| Creature doesn't need to breathe or have {{token|BREATHE|body}} parts in body, nor can it drown or be strangled. Creatures living in magma must have this tag, otherwise they will drown.

|-
| {{text anchor|NOCTURNAL}}
| Caste
|
| When set, the creature will only appear at night (after 10:05 PM and before 4:30 AM) in Adventurer mode.

|-
| {{text anchor|NOEMOTION}}
| Caste
|
| Creature has no emotions. It is immune to the effects of [[stress]] and unable to rage, and its [[need]]s cannot be fulfilled in any way. Used on [[undead]] in the vanilla game.

|-
| {{text anchor|NOEXERT}}
| Caste
|
| Creature can't become tired or over-exerted from taking too many combat actions, or moving at full speed for extended periods of time.

|-
| {{text anchor|NOFEAR}}
| Caste
|
| Creature doesn't feel fear and will never flee from battle, and will be immune to [[ghost]]s' attempts to 'scare it to death'. Additionally, it causes [[bogeyman|bogeymen]] and [[nightmare]]s to become friendly towards the creature.

|-
| {{text anchor|NOMEAT}}
| Caste
|
| Creature will not be hunted or fed to wild beasts.

|-
| {{text anchor|NONAUSEA}}
| Caste
|
| Creature isn't nauseated by gut hits and cannot vomit.

|-
| {{text anchor|NOPAIN}}
| Caste
|
| Creature doesn't feel pain.

|-
| {{text anchor|NOSKIN}}
| Caste
|
| Creature will not drop a hide when [[butcher|butchered]].

|-
| {{text anchor|NOSKULL}}
| Caste
|
| Creature will not drop a skull on butchering, rot, or decay of severed head.

|-
| {{text anchor|NOSMELLYROT}}
| Caste
|
| Does not produce [[miasma]] when rotting.

|-
| {{text anchor|NOSTUCKINS}}
| Caste
|
| Weapons can't get stuck in the creature.

|-
| {{text anchor|NOSTUN}}
| Caste
|
| Creature can't be stunned and knocked unconscious by pain or head injuries. Creatures with this tag never wake up from sleep in Fortress Mode. If this creature needs to sleep while playing, it will die.

|-
| {{text anchor|NOT_BUTCHERABLE}}
| Caste
|
| Corpses from this creature cannot be [[butcher|butchered]]. Does not prevent the creature from being slaughtered while alive, however.

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

|-
| {{text anchor|NOTHOUGHT}}
| Caste
|
| Creature doesn't require a {{token|THOUGHT|body}} body part to survive. Has the added effect of preventing speech, though directly controlling creatures that would otherwise be capable of speaking allows them to engage in conversation.
|}

{{alphabetical TOC|style=margin: 1em auto;}}

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

|-
| {{text anchor|ODOR_LEVEL}}
| Caste
|
*number
| How easy the creature is to [[smell]]. The higher the number, the easier the creature is to sniff out. Defaults to 50. Vanilla creatures have values from 0 (undetectable) to 90 (noticeable by humans and dwarves).

|-
| {{text anchor|ODOR_STRING}}
| Caste
|
*string
| What the creature [[smell]]s like. If no odor string is defined, the creature name (not the caste name) is used.

|-
| {{text anchor|OPPOSED_TO_LIFE}}
| Caste
|
| Is hostile to all creatures except undead and other non-living ones and will show {{DFtext|Opposed to life|0:1}} in the [[unit list]]. Used by [[undead]] in the vanilla game. Functions without the {{token|NOT_LIVING|c}} token, and seems to imply said token as well. Undead will not be hostile to otherwise-living creatures given this token. Living creatures given this token will attack living creatures that lack it, while ignoring other living creatures that also have this token.

|-
| {{text anchor|ORIENTATION}}
| Caste
|
*MALE/FEMALE
*disinterested chance
*casual chance
*strong chance
| Determines caste's likelihood of having sexual attraction to certain sexes. Values default to 75:20:5 for the same sex and 5:20:75 for the opposite sex. The first value indicates how likely to be entirely uninterested in the sex, the second decides if the creature will be able to become lovers with that sex, the third decides whether they will be able to marry in worldgen and post-worldgen world activities (which implies being able to become lovers). Marriage seems to be able to happen in fort mode play regardless, as long as they are lovers first.

|-
| {{text anchor|OUTSIDER_CONTROLLABLE}}
| Caste
|
| Lets you play as an [[Adventurer_mode_character_creation#Outsider|outsider]] of this species in adventure mode.

|}

{{alphabetical TOC|style=margin: 1em auto;}}

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

|-
| {{text anchor|PACK_ANIMAL}}
| Caste
|
| Allows the creature to be used as a pack animal. Used by [[trading|merchants]] without wagons and adventurers. Also prevents creature from dropping hauled items on its own -- do ''not'' use for player-controllable creatures! May lead to the creature being domesticated during worldgen, even if it doesn't have {{token|COMMON_DOMESTIC|c}}.

Creatures with this tag but without {{token|BENIGN|c}}, and/or with {{token|LARGE_PREDATOR|c}} leads to hauled items being dropped.

|-
| {{text anchor|PARALYZEIMMUNE}}
| Caste
|
| The creature is immune to all [[Syndrome#CE_PARALYSIS|paralyzing]] special attacks.

|-
| {{text anchor|PATTERNFLIER}}
| Caste
|
| Used to control the bat riders with paralyze-dart blowguns that flew through the 2D chasm. Doesn't do anything now.

|-
| {{text anchor|PCG_LAYERING}}
| Creature
|
*[[Procedural graphics layer|Layering type]]
| Adds a layer to the current {{token|PROCEDURAL_CREATURE_GRAPHICS|c}} definition.

|-
| {{text anchor|PEARL}}
| Caste
|
| In earlier versions, creature would generate [[pearl]]s. Does nothing in the current version.{{verify}}

|-
| {{text anchor|PENETRATEPOWER}}
| Caste
|
*value
| Controls the ability of [[vermin]] to find a way into containers when they are eating food from your stockpiles.

Objects made of most materials (e.g. metal) roll a number from 0-100, and if the resulting number is greater than the penetrate power, their contents escape for the time being. Objects made of [[wood]], [[leather]], [[amber]], or [[coral]] roll 0-95, and items made of [[cloth]] roll 0-90.

|-
| {{text anchor|PERSONALITY}}
| Caste
|
*ATTRIBUTE
*lowest
*median
*highest
| Determines the range and chance of personality traits. Standard is 0:50:100. See [[Personality traits, values, and dreams#Traits|personality traits]] for more info.

|-
| {{text anchor|PET}}
| Caste
|
| Allows the creature to be [[Animal_trainer|tamed]] in Fortress mode. Prerequisite for all other working animal roles. Civilizations that encounter it in worldgen will tame and domesticate it for their own use. Adding this to civilization members will classify them as pets instead of citizens, with all the [[Fun|problems]] that entails. However, you can solve these problems using the popular plugin [https://dffd.bay12games.com/file.php?id=13095| Dwarf Therapist], which is completely unaffected by the tag.

|-
| {{text anchor|PET_EXOTIC}}
| Caste
|
| Allows the creature to be [[Animal_trainer|tamed]] in Fortress mode. Prequisite for all other working animal roles. Civilizations cannot domesticate it in worldgen, with certain exceptions. More difficult to tame?{{verify}} Adding this to civilization members will classify them as pets instead of citizens, with all the [[Fun|problems]] that entails. ([[Gremlin|Example]]).

|-
| {{text anchor|PETVALUE}}
| Caste
|
*value
| How valuable a tamed animal is. Actual cost in points in the embarking screen is 1+(PETVALUE/2) for an untrained animal, 1+PETVALUE for a war/hunting one.

|-
| {{text anchor|PETVALUE_DIVISOR}}
| Caste
|
*value
| Divides the creature's {{token|PETVALUE|c}} by the specified number. Used by [[honey bee]]s to prevent a single hive from being worth a fortune.

|-
| {{text anchor|PHYS_ATT_CAP_PERC}}
| Caste
|
*[[Attribute|ATTRIBUTE]] Token
*Cap %
|Default is 200. This means you can increase your attribute to 200% of its starting value (or the average value + your starting value if that is higher).

|-
| {{text anchor|PHYS_ATT_RANGE}}
| Caste
|
*[[Attribute|ATTRIBUTE]]
*lowest
*lower
*low
*median
*high
*higher
*highest
| Sets up a [[Attribute#Body_attributes|physical attribute]]'s range of values (0-5000). All physical attribute ranges default to 200:700:900:1000:1100:1300:2000.

|-
| {{text anchor|PHYS_ATT_RATES}}
| Caste
|
*[[Attribute|ATTRIBUTE]] Token
*cost to improve
*unused counter rate
*rust counter rate
*demotion counter rate
| [[Attribute#Body_attributes|Physical attribute]] gain/decay rates. Lower numbers in the last three slots make decay occur faster. Defaults for STRENGTH, AGILITY, TOUGHNESS, and ENDURANCE are 500:3:4:3, while RECUPERATION and DISEASE_RESISTANCE default to 500:NONE:NONE:NONE.

|-
| {{text anchor|PLUS_BP_GROUP}}
| Caste
|
*BY_TYPE, BY_CATEGORY, or BY_TOKEN
*body type, category, or token
| Adds a body part group to selected body part group. Presumably used immediately after {{token|SET_BP_GROUP|c}}.

|-
| {{text anchor|PLUS_MATERIAL}}
| Creature
|
*material
| Adds a material to selected materials. Used immediately after {{token|SELECT_MATERIAL|c}}.

|-
| {{text anchor|POP_RATIO}}
| Caste
|
*number (max 100000)
| Weighted population of caste; Lower is rarer. Not to be confused with {{token|FREQUENCY|c}}. A weight of 0 will not prevent a caste from spawning.

|-
| {{text anchor|POPULATION_NUMBER}}
| Creature
|
*min
*max
| The minimum/maximum numbers of how many of these creatures are present in each world map tile of the appropriate region. Defaults to 1:1 if not specified.

|-
| {{text anchor|POWER}}
| Caste
|
| Allows the being to represent itself as a deity, allowing it to become the leader of a civilized group. Not used by any creatures in the vanilla game. Requires {{token|CAN_SPEAK|c}} to actually do anything more than settle at a location (e.g. write books, lead armies, profane temples). Doesn't appear to do anything for creatures that are already civilized. Once the creature ascends to a position of leadership, it will proceed to act as a standard ruler for their entity and fulfill the same functions (hold tournaments, tame creatures, etc.).

|-
| {{text anchor|PREFSTRING}}
| Creature
|
*string
| Sets what other creatures [[Preferences|prefer]] about this creature. "Urist likes dwarves for their beards." Multiple entries will be chosen from at random. Creatures lacking a PREFSTRING token will never appear under another's preferences.

|-
| {{text anchor|PROCEDURAL_CREATURE_GRAPHICS}}
| Creature
|
* [[Graphics_token#Basic_creature_sprite_types|Sprite type]] or Caste then sprite type
| Makes the creature have procedural graphics built for it, like forgotten beasts/demons/titans/experiments. Must be associated with PCG_LAYERING tokens.

|-
| {{text anchor|PROFESSION_NAME}}
| Creature
|
*[[Unit type token]] (Profession)
*singular
*plural
| The generic name for members of this profession, at the creature level. In order to give members of specific castes different names for professions, use {{token|CASTE_PROFESSION_NAME|c}} instead.

|-
| {{text anchor|PRONE_TO_RAGE}}
| Caste
|
*Chance
| Creature has a percentage chance to flip out at visible non-friendly creatures. Enraged creatures attack anything regardless of timidity and get a strength bonus to their hits. This is what makes [[badger]]s so hardcore.

|-
| {{text anchor|PUS}}
| Caste
|
* <[[material token]]>
* <[[Material_definition_token#Material_States|material state]]>
| The creature has pus. Specifies the stuff secreted by [[Health_care#Infection|infected wounds]].
|}

{{alphabetical TOC|style=margin: 1em auto;}}

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

|-
| {{text anchor|RELSIZE}}
| Caste
|
*BY_CATEGORY, BY_TYPE, BY_TOKEN
*body category, type, or token
*Relsize
| Specifies a new relative size for a part than what is stated in the body plan. For example, dwarves have larger livers.

|-
| {{text anchor|REMAINS}}
| Caste
|
*singular
*plural
| What the creature's [[remains]] are called.

|-
| {{text anchor|REMAINS_COLOR}}
| Caste
|
| What color the creature's [[remains]] are.

|-
| {{text anchor|REMAINS_ON_VERMIN_BITE_DEATH}}
| Caste
|
| Goes with {{token|VERMIN_BITE|c}} and {{token|DIE_WHEN_VERMIN_BITE|c}}, the vermin creature will leave remains on death when biting. Leaving this tag out will cause the creature to disappear entirely after it bites.

|-
| {{text anchor|REMAINS_UNDETERMINED}}
| Caste
|
| Nothing.

|-
| {{text anchor|REMOVE_MATERIAL}}
| Creature
|
*material token
| Removes a material from the creature.

|-
| {{text anchor|REMOVE_TISSUE}}
| Creature
|
*tissue token
| Removes a tissue from the creature.

|-
| {{text anchor|RETRACT_INTO_BP}}
| Caste
|
*BY_TYPE, BY_CATEGORY or BY_TOKEN
*body type, [[Body_token#CATEGORY|category]], or [[Body_token#BP|token]]
*Second person ("You") retract verb text
*Third person ("The giant snail") retract verb text
*Second person cancel retract text
*Third person cancel retract text
| The creature will retract into the specified body part(s) when threatened. It will be unable to move or attack, but enemies will only be able to attack the specified body part(s). When one of the specified body part is severed off, the creature automatically unretracts and cannot retract anymore. More than one body part can be selected by using BY_TYPE or BY_CATEGORY.

Second-person descriptions are used for adventurer mode natural ability. "<pro_pos>" can be used in the descriptions, being replaced with the proper pronoun (or lack thereof) in-game.

Undead curled up creatures are buggy, specifically those that retract into their upper bodies: [[echidna]]s, [[hedgehog]]s and [[pangolin]]s.{{bug|11463}}{{bug|10519}} The upper body is prevented from collapsing by a separate body part (the middle spine), which cannot be attacked when the creature is retracted. See {{token|PREVENTS_PARENT_COLLAPSE|bo}}. Living creatures eventually succumb to blood loss, but undead creatures do not. Giant creatures also take a very long time to bleed out.
|-
| {{text anchor|RETURNS_VERMIN_KILLS_TO_OWNER}}
| Creature
|
| Cat behavior. If it kills a vermin creature and has an owner, it carries the remains in its mouth and drops them at their feet. Requires {{token|HUNTS_VERMIN|c}}.

|-
| {{text anchor|ROOT_AROUND}}
| Caste
|
*BY_TYPE, BY_CATEGORY or BY_TOKEN
*body type, [[Body_token#CATEGORY|category]], or [[Body_token#BP|token]]
*Second person ("You") verb text
*Third person ("The hen") verb text
| Creature will occasionally root around in the grass, looking for insects. Used for flavor in Adventurer Mode, spawns vermin edible for this creature in Fortress Mode. Creatures missing the specified body part will be unable to perform this action. The action produces a message (visible in adventure mode) in the form:

[creature] [verb text] the [description of creature's location]

In adventure mode, the "rooting around" ability will be included in the "natural abilities" menu, represented by its second person verb text.

|}

{{alphabetical TOC|style=margin: 1em auto;}}

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

|-
| {{text anchor|SAVAGE}}
| Creature
|
| The creature will only show up in "savage" biomes. Has no effect on cavern creatures. Cannot be combined with {{token|GOOD|c}} or {{token|EVIL|c}}.

|-
| {{text anchor|SECRETION}}
| Caste
|
*<[[material token]]>
*<[[Material_definition_token#Material_States|material state]]>
*BY_TOKEN / BY_CATEGORY / BY_TYPE
*<[[Body_token#BP|body part ID]]> / <[[Body_token#CATEGORY|category]]> or ALL / <type (e.g. [[Body_token#GRASP|GRASP]])>
*<[[Body_detail_plan_token#BP_LAYERS|tissue layer]]> or ALL
*<trigger>
| Causes the specified tissue layer(s) of the indicated body part(s) to secrete the designated material. A size 100 ('covering') [[contaminant]] is created over the affected body part(s) in its specified material state (and at the temperature appropriate to this state) when the trigger condition is met, as long as one of the secretory tissue layers is still intact. Valid triggers are:
*'''CONTINUOUS'''
Secretion occurs once every 40 [[time|ticks]] in [[fortress mode]], and every tick in [[adventurer mode]].
*'''EXERTION'''
Secretion occurs continuously (at the rate described above) whilst the creature is at minimum {{Tile|Tired|6:1}} following physical exertion. Note that this cannot occur if the creature has {{token|NOEXERT|c}}.
*'''EXTREME_EMOTION'''
Secretion occurs continuously (as above) whilst the creature is distressed. Cannot occur in creatures with {{token|NOEMOTION|c}}.

|-
| {{text anchor|SELECT_ADDITIONAL_CASTE}}
| Creature
|
*<caste>
| Adds an additional previously defined caste to the selection. Used after {{token|SELECT_CASTE|c}}.

|-
| {{text anchor|SELECT_CASTE}}
| Creature
|
*<caste> or ALL
| Selects a previously defined caste

|-
| {{text anchor|SELECT_MATERIAL}}
| Creature
|
*<[[material token]]>
| Selects a locally defined material. Can be ALL.

|-
| {{text anchor|SELECT_TISSUE}}
| Creature
|
*tissue token
| Selects a tissue for editing.

|-
| {{text anchor|SEMIMEGABEAST}}
| Caste
|
| Essentially the same as {{token|MEGABEAST|c}}, but more of them are created during worldgen. See the [[semi-megabeast]] page for details.

|-
| {{text anchor|SENSE_CREATURE_CLASS}}
| Caste
|
* <[[Creature_token#CREATURE_CLASS|creature class]]>
* [[Tilesets|<tile value or character>]]
* [[Color#Color_values|<foreground color>:<background color>:<foreground brightness>]]
| Gives the creature the ability to sense creatures belonging to the specified [[Creature_token#CREATURE_CLASS|creature class]] even when they lie far beyond line of sight, including through walls and floors. It also appears to reduce or negate the combat penalty of [[Wound#Blindness|blind]] units when fighting creatures they can sense. In [[adventure mode]], the specified tile will be used to represent sensed creatures when they cannot be seen directly.

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

|-
| {{text anchor|SKILL_LEARN_RATE}}
| Caste
|
*<[[skill_token]]>
*<percentage>
| The rate at which this creature learns this skill. Requires {{token|CAN_LEARN|c}} or {{token|INTELLIGENT|c}} to function.

|-
| {{text anchor|SKILL_LEARN_RATES}}
| Caste
|
*<percentage>
| The rate at which this creature learns all skills. Requires {{token|CAN_LEARN|c}} or {{token|INTELLIGENT|c}} to function.

|-
| {{text anchor|SKILL_RATE}}
| Caste
|
*[[skill_token]]
*<% of improvement points gained>
*<unused counter rate>
*<rust counter rate>
*<demotion counter rate>
| Like {{token|SKILL_RATES|c}}, but applies to individual skills instead. Requires {{token|CAN_LEARN|c}} or {{token|INTELLIGENT|c}} to function.

|-
| {{text anchor|SKILL_RATES}}
| Caste
|
*<% of improvement points gained>
*<unused counter rate>
*<rust counter rate>
*<demotion counter rate>
| Affects skill gain and decay. Lower numbers in the last three slots make decay occur faster ([SKILL_RATES:100:1:1:1] would cause rapid decay). The counter rates may also be replaced with NONE.
Default is [SKILL_RATES:100:8:16:16]. Requires {{token|CAN_LEARN|c}} or {{token|INTELLIGENT|c}} to function.

|-
| {{text anchor|SKILL_RUST_RATE}}
| Caste
|
*[[skill_token]]
*value
*value
*value
| The rate at which this skill decays. Lower values cause the skill to decay faster. Requires {{token|CAN_LEARN|c}} or {{token|INTELLIGENT|c}} to function.

|-
| {{text anchor|SKILL_RUST_RATES}}
| Caste
|
*value
*value
*value
| The rate at which all skills decay. Lower values cause the skills to decay faster. Requires {{token|CAN_LEARN|c}} or {{token|INTELLIGENT|c}} to function.

|-
| {{text anchor|SLAIN_CASTE_SPEECH}}
| Caste
|
*[[Speech file|text set]]
| Caste-specific {{token|SLAIN_SPEECH|c}}.

|-
| {{text anchor|SLAIN_SPEECH}}
| Creature
|
*[[Speech file|text set]]
| Boasting speeches relating to killing this creature. Examples include [[text_dwarf.txt/raw|text_dwarf.txt]] (<code>[SLAIN_SPEECH:SLAIN_DWARF]</code>) and text_elf.txt (<code>[SLAIN_SPEECH:SLAIN_ELF]</code>) in data\vanilla\vanilla_creatures\objects.

|-
| {{text anchor|SLOW_LEARNER}}
| Caste
|
| Shorthand for {{token|CAN_LEARN|c}} + <code>[[Creature_token#SKILL_LEARN_RATES|[SKILL_LEARN_RATES:50]]]</code>.{{verify}} Used by a number of 'primitive' creatures (like [[ogre]]s, [[giant]]s and [[troglodyte]]s) in the vanilla game. Applicable to player races. Prevents a player from recruiting nobility, even basic ones. Subterranean creatures with this token combined with {{token|EVIL|c}} will become servants of goblins in their civilizations, in the style of [[troll]]s.

|-
| {{text anchor|SMALL_REMAINS}}
| Caste
|
| Creature leaves "[[item token#REMAINS|remains]]" instead of a corpse. Used by [[vermin]].

|-
| {{text anchor|SMELL_TRIGGER}}
| Caste
|
*value
| Determines how keen a creature's sense of smell is - lower is better. At 10000, a creature cannot smell at all.

|-
| {{text anchor|SOLDIER_ALTTILE}}
| Creature
|
*'character' or tile number
| If this creature is active in its civilization's military, it will blink between its default tile and this one.

|-
| {{text anchor|SOUND}}
| Caste
|
* Sound application (currently accepts ALERT or PEACEFUL_INTERMITTENT)
* Sound range (in tiles)
* Sound delay (lower values = sound is produced more often)
* VOCALIZATION or NONE (determines whether the sound requires breathing or not)
* First-person description
* Third-person description
* Description when out of sight
| Creature makes sounds periodically, which can be heard in Adventure mode.
* First-person reads "You '''bark'''"
* Third-person reads "The [[capybara]] '''barks'''"
* Out of sight reads "You hear '''a loud bark'''"
with the text in bold being the description arguments of the token.

|-
| {{text anchor|SOURCE_HFID}}
| Creature
|
*Integer
| Found on generated [[angel]]s. This is the historical figure ID of the deity with which the angel is associated. Since HFIDs are not predictable before worldgen, this isn't terribly usable in mods.

|-
| {{text anchor|SPECIFIC_FOOD}}
| Caste
|
* PLANT or CREATURE
* Plant/creature ID
| Creature will only appear in biomes with this plant or creature available. Grazers given a specific type of grass (such as [[panda]]s and [[bamboo]]) will only eat that grass and nothing else, risking starvation if there's none available.

|-
| {{text anchor|SPHERE}}
| Creature
|
* [[Sphere#Available_spheres|sphere]]
| Sets what religious spheres the creature is aligned to, for purposes of being worshipped via the {{token|POWER|c}} token. Also affects the creature's name.

|-
| {{text anchor|SPOUSE_CONVERSION_TARGET}}
| Caste
|
| This creature can be converted by a night creature with {{token|SPOUSE_CONVERTER|c}}.

|-
| {{text anchor|SPOUSE_CONVERTER}}
| Caste
|
| If the creature has the {{token|NIGHT_CREATURE_HUNTER|c}} tag, it will kidnap {{token|SPOUSE_CONVERSION_TARGET|c}}s and transform them into the caste of its species with the {{token|CONVERTED_SPOUSE|c}} tag during worldgen. It may also start families this way.

|-
| {{text anchor|SPREAD_EVIL_SPHERES_IF_RULER}}
| Caste
|
| If the creature rules over a [[site]], it will cause the local landscape to be corrupted into [[Surroundings#Evil|evil surroundings]] associated with the creature's [[Creature_token#SPHERE|sphere]]s. The creature must have at least one of the following [[sphere]]s for this to take effect: BLIGHT, DEATH, DISEASE, DEFORMITY, NIGHTMARES. The first three kill vegetation, while the others sometimes do. The last two get [[Plant_token#EVIL|evil plants]] and [[Creature_token#EVIL|evil animals]] sometimes. NIGHTMARES gets [[bogeyman|bogeymen]]. [http://www.bay12forums.com/smf/index.php?topic=169696.msg8162224#msg8162224] Used by [[demon]]s in the vanilla game.

|-
| {{text anchor|STANCE_CLIMBER}}
| Caste
|
| Caste does not require <code>[[Body_token#GRASP|[GRASP]]]</code> body parts to climb -- it can climb with <code>[[Body_token#STANCE|[STANCE]]]</code> parts instead.

|-
| {{text anchor|STANDARD_GRAZER}}
| Caste
|
| Acts as {{token|GRAZER|c}} but set to 20000*G*(max size)^(-3/4), where G defaults to 100 but can be set in d_init, and the whole thing is trapped between 150 and 3 million. Used for all grazers in the default creature raws.

|-
| {{text anchor|STRANGE_MOODS}}
| Caste
|
| The creature will get [[strange mood]]s in fortress mode and can produce artifacts.

|-
| {{text anchor|SUPERNATURAL}}
| Caste
|
| Gives the creature knowledge of any secrets with <code>[[Interaction_token#IS_SECRET|[SUPERNATURAL_LEARNING_POSSIBLE]]]</code> that match its [[Creature_token#SPHERE|spheres]] and also prevents it from becoming a [[vampire]] or [[werebeast]]. Other effects are unknown.

|-
| {{text anchor|SWIMS_INNATE}}
| Caste
|
| The creature naturally knows how to swim perfectly and does not use the [[swimmer]] skill, as opposed to {{token|SWIMS_LEARNED|c}} below. However, Fortress mode AI never paths into water anyway, so it's less useful there.

|-
| {{text anchor|SWIMS_LEARNED}}
| Caste
|
| The creature swims only as well as their present [[Swimmer|swimming skill]] allows them to.

|-
| {{text anchor|SYNDROME_DILUTION_FACTOR}}
| Caste
| <[[Syndrome#SYN_IDENTIFIER|syndrome identifier]]>:<percentage>
| Dilutes the effects of syndromes which have the specified identifier. A percentage of 100 is equal to the regular syndrome effect severity, higher percentages reduce severity.
|}

{{alphabetical TOC|style=margin: 1em auto;}}

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

|-
| {{text anchor|TENDONS}}
| Caste
|
* [[material token]]
*healing rate
| The creature has tendons in its {{token|CONNECTIVE_TISSUE_ANCHOR|td}} tissues (bone or chitin by default). Cutting the bone/chitin tissue severs the tendons, disabling motor function if the target is a limb.

|-
| {{text anchor|THICKWEB}}
| Caste
|
| The creature's [[web]]s can catch larger creatures.

|-
| {{text anchor|TISSUE}}
| Creature
|
*name
| Begins defining a tissue in the creature file. Follow this with standard tissue definition tokens to define the tissue properties.

|-
| {{text anchor|TISSUE_LAYER}}
| Caste
|
*BY_TYPE, BY_CATEGORY, BY_TOKEN
*TYPE,CATEGORY, or TOKEN
*TISSUE
*LOCATION
| Adds the tissue layer to wherever it is required.
Non-argument Locations can be FRONT, RIGHT, LEFT, TOP, BOTTOM. Argument locations are AROUND and CLEANS, requiring a further body part and a % of coverage/cleansing

|-
| {{text anchor|TISSUE_LAYER_OVER}}
| Caste
|
*BY_TYPE, BY_CATEGORY, BY_TOKEN
*TYPE,CATEGORY, or TOKEN
*TISSUE
*LOCATION
| Alias for TISSUE_LAYER

|-
| {{text anchor|TISSUE_LAYER_UNDER}}
| Caste
|
*BY_TYPE, BY_CATEGORY, BY_TOKEN
*TYPE,CATEGORY, or TOKEN
*TISSUE
| Adds the tissue layer under a given part.
For example, an [[iron man]] has a gaseous poison within, and this tissue (GAS is its name) has the token [TISSUE_LEAKS] and its state is GAS, so when you puncture the iron outside and damage this tissue it leaks gas (can have a syndrome by using a previous one in the creature sample.) [TISSUE_LAYER_UNDER:BY_CATEGORY:ALL:{tissue}] {tissue} is what will be under the TISSUE_LAYER; here is an example Tissue from the 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]

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

|-
| {{text anchor|TRADE_CAPACITY}}
| Caste
|
*number
| How much the creature can carry when used by merchants. 1000 by default. Completely ignored if the animal does not also have PACK_ANIMAL or WAGON, instead using BODY_SIZE^(2/3)/20, even if they're a pack animal due to ANIMAL_ALWAYS_PACK_ANIMAL.

|-
| {{text anchor|TRAINABLE}}
| Caste
|
| Shortcut for {{token|TRAINABLE_HUNTING|c}} + {{token|TRAINABLE_WAR|c}}.

|-
| {{text anchor|TRAINABLE_HUNTING}}
| Caste
|
| Can be [[Animal trainer|trained]] as a hunting beast, increasing speed.

|-
| {{text anchor|TRAINABLE_WAR}}
| Caste
|
| Can be [[Animal trainer|trained]] as a war beast, increasing strength and endurance.

|-
| {{text anchor|TRANCES}}
| Caste
|
| Allows the creature to go into [[martial trance]]s. Used by dwarves in the vanilla game.

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

|-
| {{text anchor|TRIGGERABLE_GROUP}}
| Creature
|
*min
*max
| A large swarm of vermin can be disturbed, usually in adventurer mode.

|-
| {{text anchor|TSU_NOUN}}
| Caste
|
*noun
*SINGULAR or PLURAL
| Noun for the {{token|TISSUE_STYLE_UNIT|c}}, used in the description of the tissue layer's style.
|}

{{alphabetical TOC|style=margin: 1em auto;}}

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

|-
| {{text anchor|UBIQUITOUS}}
| Creature
|
| Creature will occur in every region with the correct biome. Does not apply to {{token|EVIL|c}}/{{token|GOOD|c}} tags. Supersedes {{token|FREQUENCY|c}} for the purposes of distributing populations through the map, they are present in every part of the valid biome. Respects {{token|FREQUENCY|c}} for the frequency of unit [[Creature token#CLUSTER_NUMBER|cluster]] spawns being of this species.

|-
| {{text anchor|UNDERGROUND_DEPTH}}
| Creature
|
*mindepth
*maxdepth
| Depth that the creature appears underground. Numbers can be from 0 to 5. 0 is actually 'above ground' and can be used if the creature is to appear both above and below ground. Values from 1-3 are the respective [[cavern]] levels, 4 is the [[magma sea]] and 5 is the [[HFS]]. A single argument may be used instead of min and max. [[Demon]]s use only 5:5; user-defined creatures with both this depth and {{token|FLIER}} will take part in the initial wave from the HFS alongside generated demons, but without {{token|FLIER}} they will only spawn from the map edges. Civilizations that can use underground plants or animals will only export (via the embark screen or caravans) things that are available at depth 1.

|-
| {{text anchor|UNDERSWIM}}
| Caste
|
| The creature is displayed as blue when in [[Water#Depth|7/7 water]]. Used on fish and amphibious creatures which swim under the water.

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

|-
| {{text anchor|USE_CASTE}}
| Creature
|
*new caste token
*old caste token
| Defines a new caste derived directly from a previous caste. The new caste inherits all properties of the old one. The effect of this tag is automatic if one has not yet defined any castes: "Any caste-level tag that occurs before castes are explicitly declared is saved up and placed on any caste that is declared later, unless the caste is explicitly derived from another caste."
Roostre: "When DF detects duplicate tokens in the raws of the same object, a failsafe seems to kick in; it takes the bottom-most of the duplicates, and disregards the others. In the case of tokens added by a mod, it prioritizes the duplicate in the mod." This means that if a tag is defined in the base-caste and redefined in the derived caste, the derived tag overwrites the base tag.

|-
| {{text anchor|USE_MATERIAL}}
| Creature
|
*new material ID
*old material ID
| Defines a new local creature material and populates it with all properties defined in the specified local creature material.

|-
| {{text anchor|USE_MATERIAL_TEMPLATE}}
| Creature
|
*new material token
*material template
| Defines a new local creature material and populates it with all properties defined in the specified template. [http://www.bay12forums.com/smf/index.php?topic=175437.msg8441368#msg8441368 There seems to be a limit of 200 materials per creature].

|-
| {{text anchor|USE_TISSUE}}
| Creature
|
*new tissue token
*old tissue id
| Defines a new local creature tissue and populates it with all properties defined in the local tissue specified in the second argument.

|-
| {{text anchor|USE_TISSUE_TEMPLATE}}
| Creature
|
*new tissue token
*tissue template
| Loads a tissue template listed in OBJECT:TISSUE_TEMPLATE files, such as tissue_template_default.txt.

|-
| {{text anchor|UTTERANCES}}
| Creature
|
| Changes the language of the creature into unintelligible 'kobold-speak', which creatures of other species will be unable to understand. If a civilized creature has this and is not part of a {{token|SKULKING|e}} civ, it will tend to start wars with all nearby civilizations and will be unable to make peace treaties due to 'inability to communicate'.
|}

{{alphabetical TOC|style=margin: 1em auto;}}

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

|-
| {{text anchor|VEGETATION}}
| Caste
|
| Like {{token|AT_PEACE_WITH_WILDLIFE}}, but also makes the creature more valued in artwork by civilisations with the PLANT [[sphere]]. [http://www.bay12forums.com/smf/index.php?topic=169696.msg8316954#msg8316954] Used by [[grimeling]]s in the vanilla game.

|-
| {{text anchor|VERMIN_BITE}}
| Caste
|
*chance of occurrence{{verify}}
*verb (bitten, stung, etc.)
* [[material token]]
* [[Material_definition_token#Material_States|material state]]
| Enables vermin to bite other creatures, injecting the specified material. See {{token|SPECIALATTACK_INJECT_EXTRACT|c}} for details about injection - this token presumably works in a similar manner.{{verify}}

|-
| {{text anchor|VERMIN_EATER}}
| Creature
|
| The vermin creature will attempt to eat exposed food. See {{token|PENETRATEPOWER|c}}. Distinct from {{token|VERMIN_ROTTER|c}}.

|-
| {{text anchor|VERMIN_FISH}}
| Creature
|
| The vermin appears in [[water]] and will attempt to swim around.

|-
| {{text anchor|VERMIN_GROUNDER}}
| Creature
|
| The creature appears in "general" surface ground locations. Note that this doesn't stop the creature from flying if it can (most vermin birds have this tag).

|-
| {{text anchor|VERMIN_HATEABLE}}
| Caste
|
| Some dwarves will [[Preferences|hate]] the creature and get unhappy thoughts when around it. See the [[Hateable|list of hateable vermin]] for details.

|-
| {{text anchor|VERMIN_MICRO}}
| Caste
|
| This makes the creature move in a swarm of creatures of the same race as it (e.g. swarm of flies, swarm of ants).

|-
| {{text anchor|VERMIN_NOFISH}}
| Caste
|
| The creature cannot be caught by [[fishing]].

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

|-
| {{text anchor|VERMIN_NOTRAP}}
| Caste
|
| The creature cannot be caught in baited [[animal trap]]s; however, a "[[Trapper|catch live land animal]]" task may still be able to capture one if a dwarf finds one roaming around.

|-
| {{text anchor|VERMIN_ROTTER}}
| Creature
|
| The vermin are attracted to rotting stuff and loose food left in the open and cause unhappy thoughts to dwarves who encounter them. Present on flies, knuckle worms, acorn flies, and blood gnats. Speeds up decay?{{verify}}

|-
| {{text anchor|VERMIN_SOIL}}
| Creature
|
| The creature randomly appears near dirt or mud, and may be uncovered by creatures that have the {{token|ROOT_AROUND|c}} interaction such as [[goose|geese]] and [[chicken]]s. Dwarves will ignore the creature when given the "Capture live land animal" task.

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

|-
| {{text anchor|VERMINHUNTER}}
| Caste
|
| Old shorthand for "does cat stuff". Contains {{token|AT_PEACE_WITH_WILDLIFE|c}} + {{token|RETURNS_VERMIN_KILLS_TO_OWNER|c}} + {{token|HUNTS_VERMIN|c}} + {{token|ADOPTS_OWNER|c}}.

|-
| {{text anchor|VESPERTINE}}
| Caste
|
| When set, the creature will only appear in the evening (between 8:00 PM and 10:05 PM) in Adventurer mode.

|-
| {{text anchor|VIEWRANGE}}
| Caste
|
*value
| Value should determine how close you have to get to a critter before it attacks (or prevents adv mode travel etc.) Default is 20.

|-
| {{text anchor|VISION_ARC}}
| Caste
|
*binocular vision arc
*non-binocular vision arc
| The width of the creature's vision arcs, in degrees (i.e. 0 to 360). The first number is binocular vision, the second is non-binocular vision. Binocular vision has a minimum of about 10 degrees, monocular, a maximum of about 350 degrees. Values past these limits will be accepted, but will default to ~10 degrees and ~350 degrees respectively. Defaults are 60:120.
|}

{{alphabetical TOC|style=margin: 1em auto;}}

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

|-
| {{text anchor|WAGON_PULLER}}
| Caste
|
| Allows the creature to pull caravan wagons. If a civilization doesn't have access to any, it is restricted to trading with pack animals.

|-
| {{text anchor|WEBBER}}
| Caste
|
* [[material token]]
| Allows the creature to create [[web]]s, and defines what the webs are made of.

|-
| {{text anchor|WEBIMMUNE}}
| Caste
|
| The creature will not get caught in thick [[web]]s. Used by creatures who can shoot thick webs (such as [[giant cave spider]]s) in order to make them immune to their own attacks.
|}

==Attack Tokens==

Attacks can use four different part selection criteria; while all vanilla attacks use only BODYPART (e.g. ATTACK:PUNCH:BODYPART:BY_TYPE:GRASP), there are other options available.

{| {{prettytable}}
|- bgcolor="#ddd"
! width="20%" | Part type token
! width="30%" | Arguments
! width="60%" | Description

|-
| {{text anchor|BODYPART}}
|
* BY_TYPE/BY_TOKEN/BY_CATEGORY
* type/token/category
| This attack uses a particular body part; for example, BY_TYPE:GRASP will make it use any part that can hold onto an object.

|-
| {{text anchor|TISSUE_LAYER}}
|
* BY_TYPE/BY_TOKEN/BY_CATEGORY
* type/token/category
* tissue layer
| This attack uses a specific tissue layer on a specific body part; BY_TYPE:GRASP:BONE will make it use the bone of the hands.

|-
| {{text anchor|CHILD_BODYPART_GROUP}}
|
* BY_TYPE/BY_TOKEN/BY_CATEGORY
* type/token/category
* BY_TYPE/BY_TOKEN/BY_CATEGORY
* type/token/category
| Uses a body part that is subordinate to another; BY_CATEGORY:ARM_LOWER:BY_TYPE:GRASP will make it use every hand attached to each lower arm (so it will generate one attack per lower arm, each of which will use every hand on that arm, assuming there are multiple hands per arm).

|-
| {{text anchor|CHILD_TISSUE_LAYER_GROUP}}
|
* BY_TYPE/BY_TOKEN/BY_CATEGORY
* type/token/category
* BY_TYPE/BY_TOKEN/BY_CATEGORY
* type/token/category
* tissue layer
| As CHILD_BODYPART_GROUP, but specifying a tissue, too.

|}

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

|-
| {{text anchor|ATTACK_SKILL}}
| Caste
|
*[[Skill token]]
| Defines the skill used by the attack.

|-
| {{text anchor|ATTACK_VERB}}
| Caste
|
*2nd person
*3rd person
| Descriptive text for the attack.

|-
| {{text anchor|ATTACK_CONTACT_PERC}}
| Caste
|
*% value
| The contact area of the attack, measured in % of the body part's volume. Note that all attack percentages can be more than 100%.

|-
| {{text anchor|ATTACK_PENETRATION_PERC}}
| Caste
|
*% value
| The penetration value of the attack, measured in % of the body part's volume. Requires ATTACK_FLAG_EDGE. Maximum value: 15000.

|-
| {{text anchor|ATTACK_PRIORITY}}
| Caste
|
*MAIN or SECOND
| Usage frequency. MAIN attacks are 100 times more frequently chosen than SECOND. Opportunity attacks ignore this preference.

|-
| {{text anchor|ATTACK_VELOCITY_MODIFIER}}
| Caste
|
*number
| The velocity multiplier of the attack, multiplied by 1000.

|-
| {{text anchor|ATTACK_FLAG_CANLATCH}}
| Caste
|
| Attacks that damage tissue have the chance to latch on in a wrestling hold. The grabbing bodypart can then use the "shake around" wrestling move, causing severe, armor-bypassing tensile damage according to the attacker's body volume.

|-
| {{text anchor|ATTACK_FLAG_WITH}}
| Caste
|
| Displays the name of the body part used to perform an attack while announcing it, e.g. "The weaver punches the bugbat with his right hand".

|-
| {{text anchor|ATTACK_FLAG_EDGE}}
| Caste
|
| The attack is edged, with all the effects on physical resistance and contact area that it entails.

|-
| {{text anchor|ATTACK_PREPARE_AND_RECOVER}}
| Caste
|
* Preparation time
* Recovery time
| Determines the length of time to prepare this attack and until one can perform this attack again. Values appear to be calculated in adventure mode ticks.

|-
| {{text anchor|ATTACK_FLAG_BAD_MULTIATTACK}}
| Caste
|
| Multiple strikes with this attack cannot be performed effectively.

|-
| {{text anchor|ATTACK_FLAG_INDEPENDENT_MULTIATTACK}}
| Caste
|
| Multiple strikes with this attack can be performed with no penalty. The creature will use all attacks with this token at once.

|-
| {{text anchor|SPECIALATTACK_INJECT_EXTRACT}}
| Caste
|
*<[[material token]]>
*<[[Material_definition_token#Material_States|material state]]>
*<min quantity>
*<max quantity>
| When added to an attack, causes the attack to inject the specified material into the victim's bloodstream. Once injected, the material will participate in [[temperature|thermal]] exchange within the creature - injecting something like molten [[iron]] (INORGANIC:IRON:LIQUID) would cause most unmodded creatures to melt (note that some of the injected material also [[contaminant|splatters]] over the bodypart used to carry out the attack, so it should be protected appropriately). If the injected material has an associated [[syndrome]] with the [[Syndrome#SYN_INJECTED|[SYN_INJECTED]]] token, it will be transmitted to the victim. If the attack is blunt, the injected material lacks the [[Material definition token#ENTERS_BLOOD|[ENTERS_BLOOD]]] token, the attacked bodypart has no [[Tissue_definition_token#VASCULAR|[VASCULAR]]] tissues, or the victim is bloodless, the material will splatter over the attacked body part instead.

|-
| {{text anchor|SPECIALATTACK_INTERACTION}}
| Caste
|
*interaction
| When this attack lands successfully, a specified interaction will take effect on the target creature. The attack must break the target creature's skin in order to work. This will take effect in worldgen as well. If the attack would break skin, the interaction will occur '''before the attack actually lands'''.

|-
| {{text anchor|SPECIALATTACK_SUCK_BLOOD}}
| Caste
|
*min
*max
| Successful attack draws out an amount of blood randomized between the min and max value. Beware that this '''will''' trigger any ingestion syndromes attached to the target creature's blood - for example, using this attack on a vampire will turn you into one too.
|}

==Tissue Layer Tokens==
Tissue layers are added to a creature's body parts by the creature tokens [[#TISSUE_LAYER|TISSUE_LAYER]], [[#TISSUE_LAYER_OVER|TISSUE_LAYER_OVER]], [[#TISSUE_LAYER_UNDER|TISSUE_LAYER_UNDER]], and the body detail plan token [[#TL_LAYERS|TL_LAYERS]].

These tissue layers are not the same thing as tissues, which are defined at creature level, but rather applications of the tissues. If the SKIN tissue of a creature is the more general and abstract notion of what skin is for that creature, then a tissue layer may be the "actual" skin on the creature's nose, head, or second toe. As most creatures have more than one body part, tissue layers are normally selected en masse.

Some tissue layer tokens are analogous to tissue definition tokens, e.g. [[#TL_CONNECTS|TL_CONNECTS]] to [[tissue_definition_token#CONNECTS|CONNECTS]].

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

|-
| {{text anchor|SELECT_TISSUE_LAYER}}
| Caste
|
*TISSUE
*BY_CATEGORY, BY_TYPE, BY_TOKEN
*Location - category, type, or token | Selects a tissue at a location
* (optional) FRONT, BACK, LEFT, RIGHT, TOP, BOTTOM, AROUND.
| Begins a selection of tissue layers.
[SELECT_TISSUE_LAYER:HEART:BY_TYPE:HEART]

|-
| {{text anchor|PLUS_TISSUE_LAYER}}
| Caste
|
*TISSUE
*BY_CATEGORY, BY_TYPE, BY_TOKEN
*Location - category, type, or token
| Adds tissue layers to those selected.

|-
| {{text anchor|SET_TL_GROUP}}
| Caste
|
*TISSUE
*BY_CATEGORY, BY_TYPE, BY_TOKEN
*Location - category, type, or token
*tissue
| Begins a selection of tissue layers. Only usable for descriptor and cosmetic purposes.

Research has implied it may be redundant with SELECT_TISSUE_LAYER, as the latter allows for cosmetics as well as "functional" tokens such as TL_MAJOR_ARTERIES. Vanilla raws still use SET_TL_GROUP though, for all cosmetic purposes. More research is needed on this subject.

|-
| {{text anchor|PLUS_TL_GROUP}}
| Caste
|
*BY_CATEGORY, BY_TYPE, BY_TOKEN
*Location - category, type, or token
*tissue
| Adds tissue layers to those selected. Like SET_TL_GROUP, it may be redundant even if used in the vanilla raws.

|-
| {{text anchor|SET_LAYER_TISSUE}}
| Caste
|
*TISSUE
| Sets a selected tissue layer to be made of a different tissue.

|-
| {{text anchor|SHEARABLE_TISSUE_LAYER}}
| Caste
|
* tissue modifier
* required value
| Tissue layer can be sheared for its component material. The specified modifier must be at least of the desired value for shearing to be possible (for example, a [[llama]]'s wool must have a LENGTH of 300 before it is shearable).

|-
| {{text anchor|TISSUE_LAYER_APPEARANCE_MODIFIER}}
| Caste
|
*QUALITY
*lowest
*lower
*low
*median
*high
*higher
*highest
| Sets the range of qualities, including LENGTH, DENSE, HIGH_POSITION, CURLY, GREASY, WRINKLY

|-
| {{text anchor|TISSUE_STYLE_UNIT}}
| Caste
|
*tissue style unit ID
*shaping
| Sets tissue layer to be the target of TISSUE_STYLE token specified for an entity, works only on entity members. Mostly used with tissues HAIR, BEARD, MOUSTACHE, SIDEBURNS.

|-
| {{text anchor|TL_COLOR_MODIFIER}}
| Caste
|
*COLOR
*freq
*COLOR
*freq etc.
| Creates a list of colors/color patterns, giving each a relative frequency. If the given color or pattern does not exist, the tissue is described as being "transparent".

|-
| {{text anchor|TLCM_GENETIC_MODEL}}
| Caste
|
| The way the color modifier is passed on to offspring. May or may not work right now.{{verify}}

|-
| {{text anchor|TLCM_IMPORTANCE}}
| Caste
|
*number
| Presumably modifies the importance of the tissue layer color modifier, for description purposes.
HOWEVER using this appears to remove all mention of colour from creature descriptions. It does not appear in any default creatures.

|-
| {{text anchor|TLCM_NOUN}}
| Caste
|
*name
*SINGULAR or PLURAL
| Names the tissue layer color modifier, and determines the noun. Also used by [[Utility:Stonesense|Stonesense]] for colouring body parts.

|-
| {{text anchor|TLCM_TIMING}}
| Caste
|
*ROOT
*start change window years
*days
*end change window years
*days
| Determines the point in the creature's life when the color change begins and ends.

|-
| {{text anchor|TL_CONNECTS}}
| Caste
|
| Gives the CONNECTS attribute to selected layers.

|-
| {{text anchor|TL_HEALING_RATE}}
| Caste
|
*value
| Changes the HEALING_RATE of the selected tissue layers.

|-
| {{text anchor|TL_MAJOR_ARTERIES}}
| Caste
|
| Gives the "major arteries" attribute to selected layers. Used to add massive bleeding properties to the throat, made from skin.

|-
| {{text anchor|TL_PAIN_RECEPTORS}}
| Caste
|
*value
| Changes the number of pain receptors for selected tissue layers.

|-
| {{text anchor|TL_RELATIVE_THICKNESS}}
| Caste
|
*value
| Changes the relative thickness for selected tissue layers.

|-
| {{text anchor|TL_VASCULAR}}
| Caste
|
*value
| Sets a new VASCULAR value (which modulates bleeding) for selected tissue layers.

|}

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

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

Graphics token

2024-10-04T22:33:10Z

DikbutDaGrate: There's a minor bug involving light gen in premium's current beta version adv-mode, where its only rendered at a certain range, but its not exactly worth documenting at the present time.

{{Quality|Exceptional}}
{{av}}
{{Modding}}
:{{for/see|an explanation of how to use the various graphics types|[[Graphics]]}}

The <code>[OBJECT:GRAPHICS]</code> [[token]] defines the use of various tile-based graphics in the game. As of version 50.01, graphics tokens have been greatly expanded to accommodate the release of the Steam & Itch premium version. These tokens, and explanations on how to use them, are listed below; the list will expand as the tokens are discovered and understood.

== Creature Graphics ==
Creature graphics are found within graphics_creature_x files (such as graphics_creature_domestic or graphics_creature_layered). All graphics files must begin with the file name, followed by the <code>[OBJECT:GRAPHICS]</code> type that tells the game that the file contains graphics definitions. A more detailed explanation on how to use these can be found in [[Graphics#Creature_Graphics|creature graphics]].

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

|-
| {{text anchor|CREATURE_GRAPHICS}}
|
* [[Creature token|creature id]]
| The simplest and most common form of creature graphics for defining one sprite for each [[#Condition|basic condition]].

Further conditions are required for this to function following the [[Graphics#Basic_Graphics|creature graphics]] format. Accepts [[Graphics#Large_Graphics|large graphics tokens]].

Additionally used to start defining a [[Graphics#Layered_Graphics|layered graphics]] set.

|-
| {{text anchor|CREATURE_CASTE_GRAPHICS}}
|
* [[Creature token|creature id]]
* [[Caste|Caste ID]]
| Nearly the same as {{token|CREATURE_GRAPHICS|g}}, but allows a separate sprite to be defined for each caste.
A simple alternative to [[Graphics#Layered Graphics|Layered Graphics]].

Requires conditions defined in [[Graphics#Basic_Graphics|creature graphics]] format. Accepts [[Graphics#Large_Graphics|large graphics tokens]].

|-
| {{text anchor|STATUE_CREATURE_GRAPHICS}}
|
* [[Creature token|creature id]]
| Format for beginning a [[Graphics#Statue_Graphics|creature statue definition]]. Defines a 1x2 vertical rectangle to be displayed when a statue depicts one of these creatures.

|-
| {{text anchor|STATUE_CREATURE_CASTE_GRAPHICS}}
|
* [[Creature token|creature id]]
* [[Caste|Caste ID]]
| Format for beginning a [[Graphics#Statue_Graphics|creature statue definition]] while specifying caste. Defines a 1x2 vertical rectangle to be displayed when a statue depicts one of these creatures.

|-
| {{text anchor|TILE_GRAPHICS_RECTANGLE}}
|
* [[Creature token|creature id]]
| Graphics for a 3x2 rectangle; for creatures, this is used exclusively for representing Forgotten Beasts based on their body parts. Uses [[Graphics#Forgotten_Beast_Graphics|forgotten beast graphics]]. It's also, however, used for interface graphics, see [[graphics_interface.txt]].

|}

=== Conditions ===
Different graphics can be defined for the same creature based on some properties about it. Below is a list of all the basic "creature texture" types that can be used as additional conditions to various basic sprites.

{| {{prettytable}}
|- bgcolor="#dddddd"
! Condition
! Description
|-
| {{text anchor|DEFAULT}} || The default condition that will be displayed unless overwritten by a more specific one below.

|-
| {{text anchor|LAW_ENFORCE}} || Displayed if the unit is law enforcement.

|-
| {{text anchor|TAX_ESCORT}} || Displayed if the unit escorts a tax collector (unused).

|-
| {{text anchor|ANIMATED}} || Displayed if the creature is raised from the dead using an I_EFFECT:ANIMATE interaction.

|-
| {{text anchor|GHOST}} || Displayed if the creature is a ghost.

|-
| {{text anchor|ADVENTURER}} || Displayed if the creature is an adventurer.

|-
| {{text anchor|CORPSE}} || Displayed for corpses.

|}

=== Basic creature sprite types ===

An individual sprite can be of any of the following classes. If "accepts secondary" is "yes", it can also have an extra condition tacked on at the end.

{| {{prettytable}}
|- bgcolor="#dddddd"
! Condition
! Description
|-
| {{text_anchor|Basic Condition}} || Any of the [[Graphics token#Conditions|above conditions]] can be used on their own, as the default for that condition class.

|-
| {{text_anchor|Unit type}} || Any [[Unit type token]] can be used. You may also append a [[Graphics token#Conditions|basic condition as above]] to further specify.

|-
| {{text_anchor|Position}} || Any [[Position token]] can be used, such as MONARCH, BROKER etc. All position tokens are raw-defined; any modded positions can have their own graphics. You may also append a [[Graphics token#Conditions|basic condition as above]] to further specify.

|-
| {{text_anchor|LIST_ICON}} || The default icon for this creature in lists, such as [[Arena]] mode or overall training.

|-
| {{text_anchor|EGG}} || The sprite for a clutch of eggs.

|-
| {{text_anchor|SKELETON}} || The sprite for a rotten corpse.

|-
| {{text_anchor|SKELETON_WITH_SKULL}} || The sprite for a rotten corpse that can have a [[totem]] made from it.

|}

=== Layered Conditions ===
Layers aren't very useful on their own, so they come with a set of conditions to define how when they are displayed and how they interact.

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

|-
| {{text_anchor|LAYER_SET}} ||
* condition
| Creature Graphics
| Begins defining a layer set for a creature's graphics. Valid values of ''condition'' are DEFAULT, PORTRAIT{{version|50.13}}, BABY:DEFAULT{{version|51.01-beta20}}, CHILD:DEFAULT{{version|51.01-beta20}}, or CORPSE Valid values for basic conditions may not work.{{verify}}

|-
| {{text_anchor|LS_PALETTE}}{{version|50.13}} ||
* name
|| Layer Set
|| Begins defining a palette for the layer set. Its name can be referenced by {{token|USE_PALETTE|g}}. Unlike the palettes used to render all [[descriptor color token]]s, it can be of arbitrary length.

|-
| {{text_anchor|LS_PALETTE_FILE}}{{version|50.13}} ||
* file name
| Palette
| The file name of the 8bit RGBA (sometimes called 32bit) in the <tt>/graphics/images</tt> folder of the mod, such as <tt>images/portraits/dwarf_portrait_body_palette.png</tt>.

|-
| {{text_anchor|LS_PALETTE_DEFAULT}}{{version|50.13}} ||
* integer
| Palette
| Defines the default row of a layer set palette, conventionally 0. The exact color values on this row will be replaced on layer images with the colors in the same column, based on what row is passed as an argument to {{token|USE_PALETTE|g}}.

|-
| {{text_anchor|LG_CONDITION_BP}}{{version|50.13}} ||
* selection criteria BY_TYPE, BY_CATEGORY, BY_TOKEN
* category, type, or token
|| Layer Group
|| Allows the entire layer group (rather than an individual layer) to be switched on and off depending on the conditions of a body part. Should accept the same tokens {{token|CONDITION_BP|g}} does. {{verify}}

|-
| {{text_anchor|END_LAYER_GROUP}} || || Layer Group
| Explicitly marks the end of a layer group, which allows layers after to not belong to any layer group.

|-
| {{text_anchor|CONDITION_ITEM_WORN}} ||
* BY_CATEGORY / BY_TOKEN
* [[Body_token#CATEGORY|category]] / [[Body_token#BP|body part token]]
* Armor type (ARMOR, GLOVES, Etc.)
* Item ID(s)
|| Armor Wieldables || Defines a clothing or armor graphic by the specific part it is equipped to, the type of armor it is, and the internal id of that item.
For example, a condition representing a right handed mitten or glove would be defined as:
<code>[CONDITION_ITEM_WORN:BY_TOKEN:RH:GLOVES:ITEM_GLOVES_MITTENS]</code>
Also accepts the input <code>ANY_HELD</code> or <code>WIELD</code> (e.g. <code>WIELD:WEAPON:ANY</code>).

|-
| {{text_anchor|SHUT_OFF_IF_ITEM_PRESENT}} ||
* BY_CATEGORY / BY_TOKEN
* [[Body_token#CATEGORY|category]] / [[Body_token#BP|body part token]]
* Armor type
* Item ID(s)
|| Armor || Causes the current layer to not be rendered if the creature has one of the items worn or equipped. Also accepts the input <code>ANY_HELD</code> or <code>WIELD</code> (e.g. <code>WIELD:WEAPON:ANY</code>).

|-
| {{text_anchor|CONDITION_CASTE}} ||
* caste name(s)
|| General
|| Displays this layer if the creature is this caste. Only one caste is accepted for each condition, but multiple caste conditions can be used in one layer and the layer will be displayed if any of them match.

|-
| {{text_anchor|CONDITION_DYE}} ||
* dye color
|| Armor
|| Should represent which color the clothing is dyed. Currently nonfunctional.{{version|50.05}}

|-
| {{text_anchor|CONDITION_NOT_DYED}} || || Armor
|| Should check if the clothing is dyed. Currently nonfunctional.{{version|50.05}}

|-
| {{text_anchor|CONDITION_MATERIAL_FLAG}} ||
* material flag
|| Material || Changes graphics based on the material an equipped item is made of. Valid material flags are similar to [[Reaction#Full_token_list|reactant conditions]] including:
* WOVEN_ITEM
* ANY_X_MATERIAL
:with X being:
:* PLANT, SILK, YARN, LEATHER, WOOD, SHELL, BONE, STONE, GEM, TOOTH, HORN, PEARL
* IS_DIVINE_MATERIAL
* NOT_ARTIFACT
* IS_CRAFTED_ARTIFACT
* METAL_ITEM_MATERIAL
* GLASS_MATERIAL
* FIRE_BUILD_SAFE
* MAGMA_BUILD_SAFE
* GROWN_NOT_CRAFTED{{version|51.01-beta20}}
[http://www.bay12forums.com/smf/index.php?topic=169696.msg8442543#msg8442543 among other, less useful ones.]

|-
| {{text_anchor|CONDITION_MATERIAL_TYPE}} ||
* material token
|| Material || Changes graphics based on the material an equipped item is made of. Valid material types take the form <code>METAL:COPPER</code> where copper can be replaced with any weapons-grade metal. General [[material token]]s are '''not''' functional. {{token|CONDITION_MATERIAL_FLAG|g}} is a better option for any material condition other than metal.

|-
| {{text_anchor|CONDITION_PROFESSION_CATEGORY}} ||
* [[Unit type token#Profession Categories|profession category token(s)]]
|| General
|| Checks the profession category of the creature to act as a condition. Multiple profession category tokens can be chained together. You can also use multiple of these tokens instead of listing them all in a single one, but this is functionally identical. Valid Profession tokens which are not categories will be ignored; values that do not match any existing Profession will be treated as <code>NONE</code> and thus apply to doctors, military, etc..

|-
| {{text_anchor|CONDITION_RANDOM_PART_INDEX}} ||
* identifier
* integer index
* integer range
|| General
|| Chooses a random layer among layers with a CONDITION_RANDOM_PART_INDEX with the same identifier. Index is which option this condition is, out of Range number of options. Ex:
<code>[CONDITION_RANDOM_PART_INDEX:HEAD:3:4]</code>
is the third possible random head out of four total options. One of these random conditions each will be put into a set of four different sprites to add some random variation in the appearance of the creature's head.

|-
| {{text_anchor|CONDITION_HAUL_COUNT_MIN}} ||
* integer
|| General
|| Counts how many items the creature is hauling. Used for {{token|PACK_ANIMAL}}s in vanilla.

|-
| {{text_anchor|CONDITION_HAUL_COUNT_MAX}} ||
* integer
|| General
|| Counts how many items the creature is hauling. Used for {{token|PACK_ANIMAL}}s in vanilla.

|-
| {{text_anchor|CONDITION_CHILD}} || || General
|| Checks if the creature is a child or baby.

|-
| {{text_anchor|CONDITION_NOT_CHILD}} || || General
|| Checks if the creature is an adult.

|-
| {{text_anchor|CONDITION_GHOST}} || || General
|| Checks if the creature is a ghost.

|-
| {{text_anchor|CONDITION_SYN_CLASS}} ||
* [[Syndrome#SYN_CLASS|SYN_CLASS]]
|| Syndrome || Changes graphics based on any syndromes the creature is affected by. Vanilla values include:
* ZOMBIE
* NECROMANCER
* VAMPCURSE
* RAISED_UNDEAD
* DISTURBED_DEAD
* GHOUL

|-
| {{text_anchor|CONDITION_TISSUE_LAYER}} ||
* BY_CATEGORY
* [[Body_token#CATEGORY|body part category]] or ALL
* [[Body_detail_plan_token#BP_LAYERS|tissue layer]] or ALL
|| Tissue
|| Selects a tissue layer to use for checking other conditions. Ex:
<code>[CONDITION_TISSUE_LAYER:BY_CATEGORY:ALL:SKIN]</code>

|-
| {{text_anchor|TISSUE_MIN_LENGTH}} ||
* integer
|| Tissue
|| Checks the current {{token|CONDITION_TISSUE_LAYER|g}}'s LENGTH [[Creature_token#TISSUE_LAYER_APPEARANCE_MODIFIER|appearance modifier]]. Is true if the LENGTH is greater than the integer input.

|-
| {{text_anchor|TISSUE_MAX_LENGTH}} ||
* integer
|| Tissue
|| Checks the current {{token|CONDITION_TISSUE_LAYER|g}}'s LENGTH [[Creature_token#TISSUE_LAYER_APPEARANCE_MODIFIER|appearance modifier]]. Is true if the LENGTH is less than the integer input.

|-
| {{text_anchor|TISSUE_MAY_HAVE_COLOR}} ||
* [[Color#Color_tokens|color token(s)]]
|| Tissue
|| Checks the selected tissue's color. Accepts multiple color tokens, and is true if the any of the colors is present in the selected tissues.

|-
| {{text_anchor|TISSUE_MAY_HAVE_SHAPING}} ||
* styling token
|| Tissue
|| Checks the current {{token|CONDITION_TISSUE_LAYER|g}}'s shaping (hairstyle). Valid tokens are NEATLY_COMBED, BRAIDED, DOUBLE_BRAIDS, PONY_TAILS, CLEAN_SHAVEN and STANDARD_HAIR/BEARD/MOUSTACHE/SIDEBURNS_SHAPINGS.{{verify}}

|-
| {{text_anchor|TISSUE_NOT_SHAPED}} || || Tissue
|| Checks the current {{token|CONDITION_TISSUE_LAYER|g}}'s color. Accepts multiple color tokens, and is true if the any of the colors is present in the selected tissues.

|-
| {{text_anchor|TISSUE_SWAP}} ||
* IF_MIN_CURLY
* integer
* tile page id
* x position
* y position
| Tissue
| Checks if a tissue is sufficiently curly, and if so swaps to display a different image. The new image is defined by the tile page ID, x position, and y position.

This condition should be within a [LAYER:... ] that has a similar graphic to the on in the TISSUE_SWAP.
The current {{token|CONDITION_TISSUE_LAYER|g}} group must also include a {{token|TISSUE_MIN_LENGTH|g}}.

|-
| {{text_anchor|ITEM_QUALITY}}{{version|50.13}} ||
* integer
| Armor Wieldables
|| Checks the current {{token|CONDITION_ITEM_WORN|g}}'s [[quality]]. 0 is base quality, 5 is masterwork. See [CONDITION_MATERIAL_FLAG:IS_CRAFTED_ARTIFACT] for [[artifact]]-quality items.

|-
| {{text_anchor|USE_PALETTE}}{{version|50.13}} ||
* layer set palette
* row
| General
|| Colors the layer using that row of either the layer-set-specific {{token|LS_PALETTE|}} or a predefined [[Graphics#Palettes|palette]] such as DEFAULT.

|-
| {{text_anchor|USE_STANDARD_PALETTE_FROM_ITEM}}{{version|50.13}} || || Armor Wieldables
|| Uses the default palette to render the layer based on the [[Material definition token#STATE_COLOR|color]] of the current {{token|CONDITION_ITEM_WORN|g}}.

|-
| {{text_anchor|CONDITION_BP}}{{version|50.13}} ||
* selection criteria BY_TYPE, BY_CATEGORY, BY_TOKEN
* category, type, or token
| Body
|| Defines a body part graphic using standard [[body token]] selection criteria.

|-
| {{text_anchor|BP_APPEARANCE_MODIFIER_RANGE}}{{version|50.13}} ||
* QUALITY
* minimum
* maximum
| Body
|| Checks if current {{token|CONDITION_BP|g}}'s {{token|BP_APPEARANCE_MODIFIER|c}} falls within the chosen range.

|-
| {{text_anchor|BP_PRESENT}}{{version|50.13}} || || Body
|| Checks if the current {{token|CONDITION_BP|g}} is present and not destroyed, pulped, or severed. Can also be applied to {{token|LG_CONDITION_BP|g}}.

|-
| {{text_anchor|BP_SCARRED}}{{version|50.13}} || || Body
|| Checks if the current {{token|CONDITION_BP|g}} is scarred. Seems to also require {{token|BP_PRESENT|g}} to avoid illogical results. {{verify}}

|}

=== Vermin Conditions ===
Special Conditions for {{token|VERMIN|c}} creature graphics:

{| {{prettytable}}
|- bgcolor="#dddddd"
! Condition
! Description
|-
| {{text anchor|VERMIN}} || The default graphic for this vermin.

|-
| {{text anchor|VERMIN_ALT}} || Image cycles every 1 second.

|-
| {{text anchor|SWARM_SMALL}} || For swarming vermin like [[fly|flies]] and [[fairy|fairies]] in small groups.

|-
| {{text anchor|SWARM_MEDIUM}} || For swarming vermin like [[fly|flies]] and [[fairy|fairies]] in medium-sized groups.

|-
| {{text anchor|SWARM_LARGE}} || For swarming vermin like [[fly|flies]] and [[fairy|fairies]] in large groups.

|-
| {{text anchor|LIGHT_VERMIN}} || For [[firefly|fireflies]] etc. Does not replace {{token|VERMIN|g}}.

|-
| {{text anchor|LIGHT_VERMIN_ALT}} || Like {{token|VERMIN_ALT|g}} for [[firefly|fireflies]] etc.

|-
| {{text anchor|LIGHT_SWARM_SMALL}} || Unused.

|-
| {{text anchor|LIGHT_SWARM_MEDIUM}} || Unused.

|-
| {{text anchor|LIGHT_SWARM_LARGE}} || Unused.

|-
| {{text anchor|REMAINS}} || Vermin corpses.

|-
| {{text anchor|HIVE}} || Vermin hives.
|}

== Item Graphics ==
Item graphics can also be defined, but are mostly hardcoded. This section of the wiki needs to be fleshed out. Descriptions of the token functions is provisional.

Item graphics currently do not support LARGE_IMAGE.

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

|-
| {{text_anchor|TILE_GRAPHICS}}
|
* Tile page ID
* x index
* y index
* Item ID
| Begins defining tile graphics for an item. Sets default tile graphic.{{verify}}

|-
| {{text_anchor|BOULDER_GRAPHICS}}
|
* Tile page ID
* x index
* y index
* Material ID
| Defines tile graphics variants to use for BOULDER items by material; currently all boulders use material palette instead.

|-
| {{text_anchor|ROUGH_GEM_GRAPHICS}}
|
* Tile page ID
* x index
* y index
* Material ID
| Defines tile graphics variants to use for ROUGH (gem) items by material; currently all rough gems use material palette instead.

|-
| {{text_anchor|BARS_GRAPHICS}}
|
* Tile page ID
* x index
* y index
* Material ID or item ID
| Defines tile graphics variants to use for BAR items by material.

|-
| {{text_anchor|FOOD_GRAPHICS}}
|
* Tile page ID
* x index
* y index
* Item ID
| Defines tile graphics for FOOD items.

|-
| {{text_anchor|CHEESE_GRAPHICS}}
|
* Tile page ID
* x index
* y index
* Material ID
| Defines tile graphics variants to use for CHEESE items by material. Unused in vanilla raws.

|-
| {{text_anchor|ARMOR_GRAPHICS}}
|
* Tile page ID
* x index
* y index
* Item ID
| Defines tile graphics for ARMOR items; this is for items not being worn by a creature.

|-
| {{text_anchor|GLOVES_GRAPHICS}}
|
* Tile page ID
* x index
* y index
* Item ID
| Defines tile graphics for GLOVES items; this is for items not being worn by a creature.

|-
| {{text_anchor|HELM_GRAPHICS}}
|
* Tile page ID
* x index
* y index
* Item ID
| Defines tile graphics for HELM items; this is for items not being worn by a creature.

|-
| {{text_anchor|PANTS_GRAPHICS}}
|
* Tile page ID
* x index
* y index
* Item ID
| Defines tile graphics for PANTS items; this is for items not being worn by a creature.

|-
| {{text_anchor|SHOES_GRAPHICS}}
|
* Tile page ID
* x index
* y index
* Item ID
| Defines tile graphics for SHOES items; this is for items not being worn by a creature.

|-
| {{text_anchor|SHOES_GRAPHICS_METAL}}
|
* Tile page ID
* x index
* y index
* Item ID
| Defines metal material tile graphics variants for SHOES items; this is for items not being worn by a creature.

|-
| {{text_anchor|SHIELD_GRAPHICS}}
|
* Tile page ID
* x index
* y index
* Item ID
| Defines tile graphics for SHIELD items; this is for items not being worn by a creature.

|-
| {{text_anchor|SHIELD_GRAPHICS_WOODEN}}
|
* Tile page ID
* x index
* y index
* Item ID
| Defines wood material tile graphics variants for SHIELD items; this is for items not being worn by a creature.

|-
| {{text_anchor|TOY_GRAPHICS}}
|
* Tile page ID
* x index
* y index
* Item ID
* Material ID
| Defines tile graphics for TOY items. Material ID in this case is one of STONE, WOOD, METAL, or GLASS.

|-
| {{text_anchor|TRAPCOMP_GRAPHICS}}
|
* Tile page ID
* x index
* y index
* Item ID
| Defines tile graphics for TRAPCOMP items.

|-
| {{text_anchor|TRAPCOMP_GRAPHICS_WEAPON_TRAP}}
|
* Tile page ID
* x index
* y index
| Defines tile graphics for TRAPCOMP items when built into a weapon trap; must follow TRAPCOMP_GRAPHICS.

|-
| {{text_anchor|TRAPCOMP_GRAPHICS_UPRIGHT_#X}}
|
* Tile page ID
* x index
* y index
| Defines tile graphics for installed upright spike traps. These comprise two-tile graphics: # is replaced with the number of spikes, 1-10; X is replaced with T (for top graphic tile) or B (bottom graphic tile). This follows the tile graphics definition of either MENACINGSPIKE or SPEAR.

|-
| {{text_anchor|SIEGEAMMO_GRAPHICS}}
|
* Item ID
| Begins defining graphics for SIEGEAMMO items.

|-
| {{text_anchor|SIEGEAMMO_GRAPHICS_STRAIGHT_DEFAULT}}
|
* Tile page ID
* x index
* y index
| Defines graphics for ballista arrows aligned orthogonally on the map; follows SEIGEAMMO_GRAPHICS.

|-
| {{text_anchor|SIEGEAMMO_GRAPHICS_STRAIGHT_WOOD}}
|
* Tile page ID
* x index
* y index
| Wooden variant of above.

|-
| {{text_anchor|SIEGEAMMO_GRAPHICS_DIAGONAL_DEFAULT}}
|
* Tile page ID
* x index
* y index
| Defines graphics for ballista arrows aligned diagonally on the map; follows SEIGEAMMO_GRAPHICS.

|-
| {{text_anchor|SIEGEAMMO_GRAPHICS_DIAGONAL_WOOD}}
|
* Tile page ID
* x index
* y index
| Wood variant of above.

|-
| {{text_anchor|AMMO_GRAPHICS}}
|
* Item ID
| Begins defining graphics for AMMO items.

|-
| {{text_anchor|AMMO_GRAPHICS_STRAIGHT_DEFAULT}}
|
* Tile page ID
* x index
* y index
| Defines graphics for AMMO items aligned orthogonally on the map; follows AMMO_GRAPHICS.

|-
| {{text_anchor|AMMO_GRAPHICS_STRAIGHT_WOOD}}
|
* Tile page ID
* x index
* y index
| Wooden variant of above.

|-
| {{text_anchor|AMMO_GRAPHICS_DIAGONAL_DEFAULT}}
|
* Tile page ID
* x index
* y index
| Defines graphics for AMMO aligned diagonally on the map; follows AMMO_GRAPHICS.

|-
| {{text_anchor|AMMO_GRAPHICS_DIAGONAL_WOOD}}
|
* Tile page ID
* x index
* y index
| Wood variant of above.

|-
| {{text_anchor|WEAPON_GRAPHICS}}
|
* Item ID
| Begins defining graphics for WEAPON items.

|-
| {{text_anchor|WEAPON_GRAPHICS_DEFAULT}}
|
* Tile page ID
* x index
* y index
| Defines default graphics for WEAPON item defined by WEAPON_GRAPHICS not being worn by creatures; follows WEAPON_GRAPHICS.

|-
| {{text_anchor|WEAPON_GRAPHICS_MATERIAL}}
|
* Tile page ID
* x index
* y index
| Defines material palette{{verify}} graphics for WEAPON item defined by WEAPON_GRAPHICS not being worn by creatures; follows WEAPON_GRAPHICS.

|-
| {{text_anchor|WEAPON_GRAPHICS_WOOD_GROWN}}
|
* Tile page ID
* x index
* y index
| Defines graphics for grown-wood WEAPON item defined by WEAPON_GRAPHICS not being worn by creatures; follows WEAPON_GRAPHICS.

|-
| {{text_anchor|WEAPON_GRAPHICS_WOOD}}
|
* Tile page ID
* x index
* y index
| Defines graphics for wooden WEAPON item defined by WEAPON_GRAPHICS not being worn by creatures; follows WEAPON_GRAPHICS.

|-
| {{text_anchor|WEAPON_GRAPHICS_WEAPON_TRAP}}
|
* Tile page ID
* x index
* y index
| Defines graphics for WEAPON item defined by WEAPON_GRAPHICS as it appears installed in a weapon trap; follows WEAPON_GRAPHICS.

|-
| {{text_anchor|TOOL_GRAPHICS}}
|
* Tile page ID
* x index
* y index
* Item ID
| Defines default graphics for TOOL items; also begins defining variant graphics for material or container conditions when followed by tokens below.

|-
| {{text_anchor|ADD_TOOL_GRAPHICS}}
|
* Item ID
| Adds graphics to an existing tool defined with TOOL_GRAPHICS, followed by the tool graphics material or container condition tokens below.

|-
| {{text_anchor|TOOL_GRAPHICS_WOOD}}
|
* Variant index
* Tile page ID
* x index
* y index
| Defines additonal variant graphics for wooden TOOL items defined by TOOL_GRAPHICS; follows TOOL_GRAPHICS or ADD_TOOL_GRAPHICS. Requires seven variants; the resulting tool graphic is selected randomly from these (they can all point to the same tile index if desired).

|-
| {{text_anchor|TOOL_GRAPHICS_STONE}}
|
* Variant index
* Tile page ID
* x index
* y index
| Defines additonal variant graphics for stone TOOL items defined by TOOL_GRAPHICS; follows TOOL_GRAPHICS or ADD_TOOL_GRAPHICS. Requires seven variants; the resulting tool graphic is selected randomly from these (they can all point to the same tile index if desired).

|-
| {{text_anchor|TOOL_GRAPHICS_METAL}}
|
* Variant index
* Tile page ID
* x index
* y index
| Defines additonal variant graphics for metal TOOL items defined by TOOL_GRAPHICS; follows TOOL_GRAPHICS or ADD_TOOL_GRAPHICS. Requires seven variants; the resulting tool graphic is selected randomly from these (they can all point to the same tile index if desired).

|-
| {{text_anchor|TOOL_GRAPHICS_GLASS}}
|
* Variant index
* Tile page ID
* x index
* y index
| Defines additonal variant graphics for glass TOOL items defined by TOOL_GRAPHICS; follows TOOL_GRAPHICS or ADD_TOOL_GRAPHICS. Requires seven variants; the resulting tool graphic is selected randomly from these (they can all point to the same tile index if desired).

|-
| {{text_anchor|TOOL_GRAPHICS_CONTAINER_WOOD_LIQUID}}
|
* Tile page ID
* x index
* y index
| Defines graphics for wooden liquid-containing containers (empty); follows ADD_TOOL_GRAPHICS definition for container.

|-
| {{text_anchor|TOOL_GRAPHICS_CONTAINER_STONE_LIQUID}}
|
* Tile page ID
* x index
* y index
| Defines graphics for stone liquid-containing containers (empty); follows ADD_TOOL_GRAPHICS definition for container.

|-
| {{text_anchor|TOOL_GRAPHICS_CONTAINER_METAL_LIQUID}}
|
* Tile page ID
* x index
* y index
| Defines graphics for metal (and glass?) liquid-containing containers (empty); follows ADD_TOOL_GRAPHICS definition for container.

|-
| {{text_anchor|TOOL_GRAPHICS_CONTAINER_LIQUID}}
|
* Tile page ID
* x index
* y index
| Defines graphics for the liquid filling a liquid-containing container; follows TOOL_GRAPHICS_CONTAINER_*_LIQUID.

|-
| {{text_anchor|TOOL_GRAPHICS_CONTAINER_WOOD_ITEM}}
|
* Tile page ID
* x index
* y index
| Defines graphics for wooden containers holding items; follows ADD_TOOL_GRAPHICS definition for container.

|-
| {{text_anchor|TOOL_GRAPHICS_CONTAINER_STONE_ITEM}}
|
* Tile page ID
* x index
* y index
| Defines graphics for stone containers holding items; follows ADD_TOOL_GRAPHICS definition for container.

|-
| {{text_anchor|TOOL_GRAPHICS_CONTAINER_METAL_ITEM}}
|
* Tile page ID
* x index
* y index
| Defines graphics for metal (and glass?) containers holding items; follows ADD_TOOL_GRAPHICS definition for container.
|-
| {{text_anchor|TOOL_GRAPHICS_HIVE_BLD}}
|
* Tile page ID
* x index
* y index
| Defines the built item graphics for HIVE items.

|-
| {{text_anchor|TOOL_GRAPHICS_HIVE_BLD_IN_USE}}
|
* Tile page ID
* x index
* y index
| Defines the built item graphics for HIVE items that have hives installed.

|-
| {{text_anchor|TOOL_GRAPHICS_HIVE_PRODUCTS}}
|
* Tile page ID
* x index
* y index
| Defines the built item graphics for HIVE items that are ready to be harvested.

|-
| {{text_anchor|TOOL_GRAPHICS_SHAPE}}
|
* Shape ID
* Tile page ID
* x index
* y index
| Defines graphics for shaped items; currently used for dice.

|}

== World Map Graphics ==
World map graphics are defined in <code>[[Game_folders_and_files#Game_folder|Dwarf Fortress]]\data\vanilla\vanilla_world_map\graphics\graphics_world_map.txt</code>
Tokens that accept variants have 5 of them:

[TILE_GRAPHICS:<tile page identifier>:<x position>:<y position>:<TOKEN>:1]
[TILE_GRAPHICS:<tile page identifier>:<x position>:<y position>:<TOKEN>:2]
[TILE_GRAPHICS:<tile page identifier>:<x position>:<y position>:<TOKEN>:3]
[TILE_GRAPHICS:<tile page identifier>:<x position>:<y position>:<TOKEN>:4]
[TILE_GRAPHICS:<tile page identifier>:<x position>:<y position>:<TOKEN>:5]

Otherwise:

[TILE_GRAPHICS:<tile page identifier>:<x position>:<y position>:<TOKEN>]

==See Also==
*[[Creature token]]
*[[Syndrome]]
*[[Creature examples]]

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

User:DikbutDaGrate

2024-10-04T20:44:25Z

DikbutDaGrate: updated user page

''Consider supporting your local gorlak community.''

User:DikbutDaGrate

2024-10-04T20:41:57Z

DikbutDaGrate: user page

''Fire snakes could probably use a better pref string.''

DF2014:Creature token

2024-10-04T18:32:51Z

DikbutDaGrate: Added Night Creature token for 47.05's article

{{Quality|Exceptional|22:04, 20 September 2016 (UTC)}}
{{av}}
{{Modding}}

The <code>[OBJECT:CREATURE]</code> [[token]] defines the properties of [[creatures]];  this is a full list of all known creature tokens:

__NOTOC__

{{clear}}
{{alphabetical TOC|style=margin: 1em auto;}}

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

|-
| {{text anchor|ADOPTS_OWNER}}
| Caste
|
| Prevents tamed creature from being made available for adoption, instead allowing it to automatically adopt whoever it wants. The basic requirements for adoption are intact, and the creature will only adopt individuals who have a [[preference]] for their species. Used by [[cat]]s in the vanilla game. When {{k|v}}iewing a tame creature with this token, the message "This animal isn't interested in your wishes" will appear instead of "This [adorable] animal can't work" or "This animal is waiting to be trained".

|-
| {{text anchor|ALCOHOL_DEPENDENT}}
| Caste
|
| Makes the creature need [[alcohol]] to get through the working day; it will choose to drink booze instead of [[water]] if possible. Going sober for too long reduces speed.

|-
| {{text anchor|ALL_ACTIVE}}
| Caste
|
| When set, the creature will appear at any time of day. Overrides {{token|DIURNAL|c}}, {{token|NOCTURNAL|c}}, {{token|CREPUSCULAR|c}}, {{token|MATUTINAL|c}}, and {{token|VESPERTINE|c}}.

|-
| {{text anchor|ALTTILE}}
| Creature
|
*'character' or tile number
| If set, the creature will blink between its {{token|TILE|c}} and its ALTTILE.

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

|-
| {{text anchor|AMPHIBIOUS}}
| Caste
|
| Allows a creature to breathe both in and out of [[water]] (unlike {{token|AQUATIC|c}}) - does not prevent drowning in [[magma]].

|-
| {{text anchor|APP_MOD_DESC_RANGE}}
| Caste
|
*Range (6 values, low to high)
| [http://www.bay12forums.com/smf/index.php?topic=113762.msg3473069#msg3473069 Forum post describing how description ranges work]

|-
| {{text anchor|APP_MOD_GENETIC_MODEL}}
| Caste
|
*Model (Accepts DOMINANT_MORE, DOMINANT_LESS, and MIX)
| Defines a genetic model for the relevant appearance modifier(s). May or may not do anything significant at present.

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

|-
| {{text anchor|APP_MOD_NOUN}}
| Caste
|
*noun
*SINGULAR or PLURAL
| Creates a noun for the appearance, and whether it is singular or plural.

|-
| {{text anchor|APP_MOD_RATE}}
| Caste
|
*Rate (integer)
*Scale (DAILY, YEARLY)
*min (growth)
*max (growth)
*start year
*start day
*end year
*end day
| Setting the growth rate of the modifier. The last two tokens can be replaced by NO_END to have growth continue indefinitely.

|-
| {{text anchor|APPLY_CREATURE_VARIATION}}
| Caste
|
*creature variation ID
*(optional) any amount of arbitrary arguments
| Applies the specified [[creature variation token|creature variation]]. See [[Creature_variation_token#Arguments_and_conditional_tokens]] for how the subsequent arguments may be used.

|-
| {{text anchor|APPLY_CURRENT_CREATURE_VARIATION}}
| Special
|
| Applies the effects of all pending {{token|CV_ADD_TAG|c}} and {{token|CV_REMOVE_TAG|c}} tokens that have been defined in the current creature.

|-
| {{text anchor|AQUATIC}}
| Caste
|
| Enables the creature to breathe in water, but causes it to air-drown on dry land.

|-
| {{text anchor|ARENA_RESTRICTED}}
| Caste
|
| Causes the creature to be excluded from the [[object testing arena]]'s creature spawning list. Typically applied to spoileriffic creatures.

|-
| {{text anchor|ARTIFICIAL_HIVEABLE}}
| Creature
|
| Enables the creature to be kept in artificial [[hive]]s by [[beekeeper]]s.

|-
| {{text anchor|AT_PEACE_WITH_WILDLIFE}}
| Caste
|
| Prevents the creature from attacking or frightening creatures with the {{Token|NATURAL|c}} tag.

|-
| {{text anchor|ATTACK}}
| Caste
|
*token
*bodypart
*selection criteria
*location
| Defines the attack name, and the body part used. See [[#Attack Tokens|below]] for valid subtokens
'''Example:''' 
<code>[ATTACK:GORE:BODYPART:BY_CATEGORY:HORN]</code> 
''GORE'' = name of the attack 
''BODYPART:BY_CATEGORY:HORN'' = the horn is used to attack (presuming the creature has one)

|-
| {{text anchor|ATTACK_TRIGGER}}
| Caste
|
*population
*exported wealth
*created wealth
| Specifies when a [[megabeast]] or [[semi-megabeast]] will attack the fortress. The attacks will start occurring when all of the requirements are met. Setting a value to 0 disables the trigger.

|}

{{alphabetical TOC|style=margin: 1em auto;}}

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

|-
| {{text anchor|BABY}}
| Caste
|
*integer
| Age at which creature is considered a child, the default is zero. One can think of this as the duration of the baby stage.

|-
| {{text anchor|BABYNAME}}
| Caste
|
*singular
*plural
| Defines a new name for a creature in baby state at the caste level. For non-caste-specific baby names, see {{token|GENERAL_BABY_NAME|c}}.

|-
| {{text anchor|BEACH_FREQUENCY}}
| Caste
|
*integer
| Creature may be subject to [[beaching]], becoming stranded on [[Beach|shores]], where they will eventually air-drown. The number indicates the frequency of the occurrence. Presumably requires the creature to be {{token|AQUATIC|c}}. Used by [[orca]]s, [[sperm whale]]s and [[sea nettle jellyfish]] in the vanilla game.

|-
| {{text anchor|BENIGN}}
| Caste
|
| The creature is non-aggressive by default, and will never automatically be engaged by companions or soldiers, running away from any creatures that are not friendly to it, and will only defend itself if it becomes enraged. Can be thought of as the counterpoint of the {{token|LARGE_PREDATOR|c}} tag. When tamed, animals with this tag will be useless for fortress defense.

|-
| {{text anchor|BIOME}}
| Creature
|
* [[biome token]]
| Select a [[biome]] the creature may appear in.

|-
| {{text anchor|BLOOD}}
| Caste
|
* <[[material token]]>
* <[[Material_definition_token#Material_States|material state]]>
| Specifies what the creature's blood is made of.

|-
| {{text anchor|BLOODSUCKER}}
| Caste
|
| Causes [[vampire]]-like behaviour; the creature will suck the [[Creature_token#BLOOD|blood]] of unconscious victims when its [[Syndrome#TIME_SINCE_SUCKED_BLOOD|thirst for blood]] grows sufficiently large. When controlling the creature in adventure mode, this can be done at will. Seems to be required to make the creature denouncable (in-world) as a creature of the night.

|-
| {{text anchor|BODY}}
| Caste
|
*body parts
| Draws body parts from OBJECT:BODY files (such as body_default.txt)
'''Example:''' 
[BODY:BODY_WITH_HEAD_FLAG:HEART:GUTS:BRAIN:MOUTH] 
This is the body from a [[purring maggot]]. It creates a body with head, a heart, some guts, a brain, and a mouth. That's all a maggot needs.

'''If the body is left undefined, the creature will cause a crash whenever it spawns.''' {{verify}}

|-
| {{text anchor|BODY_APPEARANCE_MODIFIER}}
| Caste
|
*ATTRIBUTE
*lowest
*lower
*low
*median
*high
*higher
*highest
| These body modifiers give individual creatures different characteristics. In the case of HEIGHT, BROADNESS and LENGTH, the modifier is also a percentage change to the BODY_SIZE of the individual creature. The seven numbers afterward give a distribution of ranges. Each interval has an equal chance of occurring.
'''Example:''' 
[BODY_APPEARANCE_MODIFIER:HEIGHT:90:95:98:100:102:105:110] 
''HEIGHT'' : marks the height to be changed 
''90:95:98:100:102:105:110'' : sets the range from the shortest (90% of the average height) to the tallest (110% of the average height) creature variation.

|-
| {{text anchor|BODY_DETAIL_PLAN}}
| Caste
|
*PlanName
*Arguments
| Loads a plan from 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:''' 
[BODY_DETAIL_PLAN:VERTEBRATE_TISSUE_LAYERS:SKIN:FAT:MUSCLE:BONE:CARTILAGE] 
This creates the detailed body of a [[fox]], the skin, fat, muscle, bones and cartilage out of the vertebrate tissues. 
A [[Purring maggot|maggot]] would only need: 
''[BODY_DETAIL_PLAN:EXOSKELETON_TISSUE_LAYERS:SKIN:FAT:MUSCLE]''

|-
| {{text anchor|BODY_SIZE}}
| Caste
|
*years
*days
*size
| Sets size at a given age. Size is in cubic centimeters, and for normal body materials, is roughly equal to the creature's average weight in grams.
'''Example:''' 
[BODY_SIZE:0:0:10000] 
[BODY_SIZE:1:168:50000] 
[BODY_SIZE:12:0:220000] 
This describes the size of a [[minotaur]]. Its birth size would be 10,000 cm3 (~10 kg). At 1 year and 168 days old it would be 50,000 cm3 (~50 kg). And as an adult (at 12 years old) it would be 220,000 cm3 and weigh roughly 220 kg.

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

|-
| {{text anchor|BONECARN}}
| Caste
|
| Creature eats bones. Implies {{token|CARNIVORE|c}}. [[Adventurer mode|Adventurers]] with this token are currently unable to eat bones.{{Bug|11069}}

|-
| {{text anchor|BP_ADD_TYPE}}
| Caste
|
| Adds a type to a body part - used with {{token|SET_BP_GROUP|c}}. In vanilla DF, this is used for adding the type '[[Body token#GELDABLE|GELDABLE]]' to the lower body of certain [[cat|creatures]].

|-
| {{text anchor|BP_APPEARANCE_MODIFIER}}
| Caste
|
*QUALITY
*lowest
*lower
*low
*median
*high
*higher
*highest
| Sets up the breadth of possibilities for appearance qualities for a selected BP group. EG. Eyes (CLOSE_SET, DEEP_SET, ROUND_VS_NARROW, LARGE_IRIS),Lips (THICKNESS), Nose (BROADNESS, LENGTH, UPTURNED, CONVEX), Ear (SPLAYED_OUT, HANGING_LOBES, BROADNESS, HEIGHT), Tooth (GAPS), Skull (HIGH_CHEEKBONES, BROAD_CHIN, JUTTING CHIN, SQUARE_CHIN), Neck (DEEP_VOICE, RASPY_VOICE), Head (BROADNESS, HEIGHT)

|-
| {{text anchor|BP_REMOVE_TYPE}}
| Caste
|
| Removes a type from a body part. Used with {{token|SET_BP_GROUP|c}}.

|-
| {{text anchor|BUILDINGDESTROYER}}
| Caste
|
*1 or 2
| Allows a creature to destroy furniture and buildings. Value [1] targets mostly doors, hatches, furniture and the like. Value [2] targets anything not made with the {{k|b}} + {{k|C}} commands.
|}

{{alphabetical TOC|style=margin: 1em auto;}}

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

|-
| {{text anchor|CAN_DO_INTERACTION}}
| Caste
|
*interaction token
| The creature can perform an interaction. See [[interaction token]].

|-
| {{text anchor|CAN_LEARN}}
| Caste
|
| The creature gains [[skill]]s and can have [[labor|professions]]. If a member of a civilization (even a pet) has this token, it'll need to eat, drink and sleep. Note that this token makes the creature unable to be eaten by an adventurer, so it is not recommended for uncivilized monsters. Adventurers lacking this token can allocate but not increase attributes and skills. Skills allocated will disappear on start.

|-
| {{text anchor|CAN_SPEAK}}
| Caste
|
| Can [[talking|talk]]. Note that this is not necessary for a creature to gain social skills.

|-
| {{text anchor|CANNOT_CLIMB}}
| Caste
|
| Creature cannot [[climber|climb]], even if it has free grasp parts.

|-
| {{text anchor|CANNOT_JUMP}}
| Caste
|
| Creature cannot [[jump]].

|-
| {{text anchor|CANNOT_UNDEAD}}
| Caste
|
| Acts like {{token|NOT_LIVING|c}}, except that {{token|OPPOSED_TO_LIFE|c}} creatures will attack them.

|-
| {{text anchor|CANOPENDOORS}}
| Caste
|
| Allows the creature to open [[door]]s that are set to be unpassable for pets. In adventure mode, creatures lacking this token will be unable to pass through door tiles except whilst these are occupied by other creatures.

|-
| {{text anchor|CARNIVORE}}
| Caste
|
| Creature ''only'' eats [[meat]]. If the creature goes on rampages in worldgen, it will often devour the people/animals it kills. Does not seem to affect the diet of the adventurer in adventure mode.

|-
| {{text anchor|CASTE}}
| Creature
|
*name
| Defines a [[caste]].

|-
| {{text anchor|CASTE_ALTTILE}}
| Caste
|
*tile number or "letter"
| Caste-specific {{token|ALTTILE|c}}. Requires {{token|CASTE_TILE|c}}.

|-
| {{text anchor|CASTE_COLOR}}
| Caste
|
*fg
*bg
*brightness
| Caste-specific {{token|COLOR|c}}.

|-
| {{text anchor|CASTE_GLOWCOLOR}}
| Caste
|
*fg
*bg
*brightness
| Caste-specific {{token|GLOWCOLOR|c}}.

|-
| {{text anchor|CASTE_GLOWTILE}}
| Caste
|
*tile value or "letter"
| Caste-specific {{token|GLOWTILE|c}}.

|-
| {{text anchor|CASTE_NAME}}
| Caste
|
*singular
*plural
*adjective
| Caste-specific {{token|NAME|c}}.

|-
| {{text anchor|CASTE_PROFESSION_NAME}}
| Caste
|
*[[Unit type token]] (Profession)
*singular
*plural
| Caste-specific {{token|PROFESSION_NAME|c}}.

|-
| {{text anchor|CASTE_SOLDIER_ALTTILE}}
| Caste
|
*'character' or tile number
| Caste-specific {{token|SOLDIER_ALTTILE|c}}. Requires {{token|CASTE_SOLDIER_TILE|c}}.

|-
| {{text anchor|CASTE_SOLDIER_TILE}}
| Caste
|
*'character' or tile number
| Caste-specific {{token|CREATURE_SOLDIER_TILE|c}}.

|-
| {{text anchor|CASTE_SPEECH}}
| Caste
|
*speech file
| Caste-specific {{token|SPEECH|c}}.

|-
| {{text anchor|CASTE_TILE}}
| Caste
|
* tile number or "letter"
| Caste-specific {{token|CREATURE_TILE|c}}.

|-
| {{text anchor|CAVE_ADAPT}}
| Caste
|
| Gives the creature a bonus in caves. Also causes [[cave adaptation]].

|-
| {{text anchor|CDI}}
| Caste
|
*Varies
| Specifies details for the preceding {{token|CAN_DO_INTERACTION|c}} token. See [[interaction token]].

|-
| {{text anchor|CHANGE_BODY_SIZE_PERC}}
| Caste
|
*integer
| Multiplies body size by a factor of (integer)%. 50 halves size, 200 doubles.

|-
| {{text anchor|CHANGE_FREQUENCY_PERC}}
| Creature
|
*integer
| Multiplies frequency by a factor of (integer)%.

|-
| {{text anchor|CHILD}}
| Caste
|
*integer
| Age at which creature is considered an adult - one can think of this as the duration of the [[children|child]] stage. Allows the creature's offspring to be rendered fully tame if [[animal trainer|trained]] during their childhood.

|-
| {{text anchor|CHILDNAME}}
| Caste
|
*singular
*plural
| Defines a new name for a creature in the child state at the caste level. For non-caste-specific child names, see {{token|GENERAL_CHILD_NAME|c}}.

|-
| {{text anchor|CLUSTER_NUMBER}}
| Creature
|
*min
*max
| The minimum/maximum numbers of how many creatures per spawned cluster. Certain vermin fish use this token in combination with temperate ocean and river biome tokens to perform seasonal migrations. Defaults to 1:1 if not specified.

|-
| {{text anchor|CLUTCH_SIZE}}
| Caste
|
*min
*max
|Number of [[egg]]s laid in one sitting.

|-
| {{text anchor|COLONY_EXTERNAL}}
| Caste
|
| Caste hovers around colony.

|-
| {{text anchor|COLOR}}
| Creature
|
*foreground
*background
*brightness
| Color of the creature's tile. See [[Color]] for usage.

|-
| {{text anchor|COMMON_DOMESTIC}}
| Caste
|
| When combined with any of {{token|PET|c}}, {{token|PACK_ANIMAL|c}}, {{token|WAGON_PULLER|c}} and/or {{token|MOUNT|c}}, the creature is guaranteed to be domesticated by any [[civilization]] with {{token|COMMON_DOMESTIC_PET|e}}, {{token|COMMON_DOMESTIC_PACK|e}}, {{token|COMMON_DOMESTIC_PULL|e}} and/or {{token|COMMON_DOMESTIC_MOUNT|e}} respectively. Such civilizations will always have access to the creature, even in the absence of wild populations. This token is invalid on {{token|FANCIFUL|c}} creatures.

|-
| {{text anchor|CONVERTED_SPOUSE}}
| Caste
|
| Creatures of this caste's species with the {{token|SPOUSE_CONVERTER|c}} and {{token|NIGHT_CREATURE_HUNTER|c}} tokens will kidnap {{token|SPOUSE_CONVERSION_TARGET|c}}s of an appropriate sex and convert them into castes with CONVERTED_SPOUSE.

|-
| {{text anchor|COOKABLE_LIVE}}
| Caste
|
| Set this to allow the creature to be cooked in meals without first being butchered/cleaned. Used by some water-dwelling vermin such as [[mussel]]s, [[nautilus]]es and [[oyster]]s.

|-
| {{text anchor|CRAZED}}
| Caste
|
| Creature is '[[insanity|berserk]]' and will attack all other creatures, except members of its own species that '''also''' have the CRAZED tag. It will show {{DFtext|Berserk|4:1}} in the [[unit list]]. Berserk creatures go on rampages during [[world generation|worldgen]] much more frequently than non-berserk ones.

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

|-
| {{text anchor|CREATURE_CLASS}}
| Caste
|
*classname
| An arbitrary creature classification. Can be set to anything, but the only vanilla uses are GENERAL_POISON (used in syndromes), EDIBLE_GROUND_BUG (used as targets for {{token|GOBBLE_VERMIN_CLASS|c}}), MAMMAL, and POISONOUS (both used for kobold pet eligibility). A single creature can have multiple classes.

The full list of tokens that use creature classes is:

* Creature tokens: {{token|GOBBLE_VERMIN_CLASS|c}}, {{token|GOBBLE_VERMIN_CLASS|c}}
* Interaction tokens: {{token|IT_AFFECTED_CLASS|in}}, {{token|IT_IMMUNE_CLASS|in}}
* Animal definition (Entity) tokens: {{token|ANIMAL_CLASS|e}}, {{token|ANIMAL_FORBIDDEN_CLASS|e}}
* Position (Entity) token: {{token|ALLOWED_CLASS|po}}
* Syndrome tokens: {{token|SYN_AFFECTED_CLASS|sy}}, {{token|SYN_IMMUNE_CLASS|sy}}, {{token|CE_SENSE_CREATURE_CLASS|sy}}
|-
| {{text anchor|CREATURE_SOLDIER_TILE}}
| Creature
|
*'character' or tile number
| Creatures active in their civilization's [[military]] will use this tile instead.

|-
| {{text anchor|CREATURE_TILE}}
| Creature
|
*'character' or tile number
| The symbol of the creature in ASCII mode.

|-
| {{text anchor|CREPUSCULAR}}
| Caste
|
| When set, the creature will appear at dawn (between 4:30 AM and 6:00 AM) and in the evening (between 8:00 PM and 10:05 PM) in Adventurer mode.

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

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

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

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

|-
| {{text anchor|CV_REMOVE_TAG}}
| Special
|
*TAG NAME
| Removes a tag. Used in conjunction with creature variation templates.
|}

{{alphabetical TOC|style=margin: 1em auto;}}

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

|-
| {{text anchor|DEMON}}
| Caste
|
| Found on generated [[demon]]s. Marks the caste to be used in the initial wave after breaking into the [[underworld]], and by the demon civilizations created during world-gen breachings{{verify}} {{version|0.47.01}}. Could not be specified in user-defined raws until version [[Release_information/0.47.01|0.47.01]].

|-
| {{text anchor|DESCRIPTION}}
| Caste
|
*text
| A brief description of the creature type, as displayed when viewing the creature's description/[[Thoughts and preferences|thoughts & preferences]] screen.

|-
| {{text anchor|DIE_WHEN_VERMIN_BITE}}
| Caste
|
| Causes the creature to die upon attacking. Used by [[honey bee]]s to simulate them dying after using their stingers.

|-
| {{text anchor|DIFFICULTY}}
| Caste
|
*integer
| Increases experience gain during adventure mode. Creatures with a difficulty of 11 or higher are not assigned for quests in adventure mode.

|-
| {{text anchor|DIURNAL}}
| Caste
|
| When set, the creature will only appear during the day (between 6:00 AM and 8:00 PM) in Adventurer mode.

|-
| {{text anchor|DIVE_HUNTS_VERMIN}}
| Caste
|
| The creature hunts vermin by diving from the air. On tame creatures, it has the same effect as {{token|HUNTS_VERMIN|c}}. Found on [[peregrine falcon]]s.

|-
| {{text anchor|DOES_NOT_EXIST}}
| Creature
|
| Adding this token to a creature prevents it from appearing in generated worlds (unless it's marked as [[Entity_token#ANIMAL_ALWAYS_PRESENT|always present]] for a particular civilisation). For example, adding it to [[dog]]s will lead to worlds being generated without dogs in them. Also removes the creature from the [[object testing arena]]'s spawn list. If combined with {{token|FANCIFUL|c}}, artistic depictions of the creature will occur regardless. Used by [[centaur]]s, [[chimera]]s and [[griffon]]s in the vanilla game.

Note: a creature tagged as DOES_NOT_EXIST can still be [[Interaction_token#I_EFFECT|summoned]] successfully, as long as it has a body defined in its raws. [http://www.bay12forums.com/smf/index.php?topic=165213.msg8086938#msg8086938]. It's also possible for another creature to [[Syndrome#CE_BODY_TRANSFORMATION|transform]] into it.
|}

{{alphabetical TOC|style=margin: 1em auto;}}

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

|-
| {{text anchor|EBO_ITEM}}
| Caste
|
*[[item token]]
*[[material token]] (ANY_HARD_STONE can be used for the material)
| Defines the item that the creature drops upon being [[butcher|butchered]]. Used with {{token|EXTRA_BUTCHER_OBJECT|c}}.

|-
| {{text anchor|EBO_SHAPE}}
| Caste
|
*gem shape
| The shape of the creature's extra [[butcher|butchering]] drop. Used with {{token|EXTRA_BUTCHER_OBJECT|c}}.

|-
| {{text anchor|EGG_MATERIAL}}
| Caste
|
* <[[material token]]>
* <[[Material_definition_token#Material_States|material state]]>
| Defines the material composition of [[egg]]s laid by the creature. [[creature_token#LAYS_EGGS|Egg-laying]] creatures in the default game define this 3 times, using LOCAL_CREATURE_MAT:EGGSHELL, LOCAL_CREATURE_MAT:EGG_WHITE, and then LOCAL_CREATURE_MAT:EGG_YOLK. Eggs will be made out of eggshell. Edibility is determined by tags on whites or yolk, but they otherwise do not exist.

|-
| {{text anchor|EGG_SIZE}}
| Caste
|
*size
| Determines the size of laid [[egg]]s. Doesn't affect hatching or cooking, but bigger eggs will be heavier, and may take longer to be hauled depending on the hauler's strength.

|-
| {{text anchor|EQUIPMENT_WAGON}}
| Creature
|
| Makes the creature appear as a large 3x3 [[wagon]] responsible for carrying trade goods, pulled by two {{token|WAGON_PULLER|c}} creatures and driven by a merchant.

|-
| {{text anchor|EQUIPS}}
| Caste
|
| Allows the creature to wear or wield items.

|-
| {{text anchor|EVIL}}
| Creature
|
| The creature is considered evil and will only show up in evil biomes. Civilizations with {{token|USE_EVIL_ANIMALS|e}} can domesticate them regardless of exotic status. Has no effect on cavern creatures except to restrict taming. A civilization with evil creatures can colonise evil areas.

|-
| {{text anchor|EXTRA_BUTCHER_OBJECT}}
| Caste
|
* BY_CATEGORY, BY_TYPE, BY_TOKEN
* TYPE, CATEGORY, or TOKEN
| The creature drops an additional object when [[butcher|butchered]], as defined by {{token|EBO_ITEM|c}} and {{token|EBO_SHAPE|c}}. Used for [[gizzard stone]]s in default creatures. For some materials, needs to be defined after caste definitions with SELECT_CASTE:ALL{{Bug|6355}}

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

|-
| {{text anchor|EXTRAVISION}}
| Caste
|
| The creature can see regardless of whether it has working eyes and has full 360 degree vision, making it impossible to strike the creature from a blind spot in combat.
|}

{{alphabetical TOC|style=margin: 1em auto;}}

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

|-
| {{text anchor|FANCIFUL}}
| Creature
|
| The creature is a thing of legend and known to all civilizations. Its materials cannot be requested or preferred. The tag also adds some art value modifiers. Used by a [[Fanciful|number of creatures]]. Conflicts with {{token|COMMON_DOMESTIC|c}}.

|-
| {{text anchor|FEATURE_ATTACK_GROUP}}
| Caste
|
| Found on [[Animal people#Subterranean animal people|subterranean animal-man]] tribals. Currently defunct. In previous versions, it caused these creatures to crawl out of chasms and underground rivers.

|-
| {{text anchor|FEATURE_BEAST}}
| Caste
|
| Found on [[forgotten beast]]s. Presumably makes it act as such, initiating underground attacks on fortresses, or leads to the pop-up message upon encountering one{{verify}}. Hides the creature from displaying in a world_sites_and_pops file. Does not create historical figures like generated forgotten beasts do. Could not be specified in user-defined raws until version [[Release_information/0.47.01|0.47.01]].

Requires specifying a {{token|BIOME|c}} in which the creature will live, and both surface and subterranean biomes are allowed. Does not stack with {{token|LARGE_ROAMING|c}} and if both are used the creature will not spawn. Appears to be incompatible with {{token|DEMON|c}} even if used in separate castes.

|-
| {{text anchor|FEMALE}}
| Caste
|
| Makes the creature biologically female, enabling her to [[Breeding|bear young]]. Usually specified inside a caste.

|-
| {{text anchor|FIREIMMUNE}}
| Caste
|
| Makes the creature immune to [[Interaction_token#FIREBALL|FIREBALL]] and [[Interaction_token#FIREJET|FIREJET]] attacks, and allows it to path through high temperature zones, like lava or fires. Does not, by itself, make the creature immune to the damaging effects of burning in [[fire]], and does not prevent general heat damage or melting on its own (this would require adjustments to be made to the creature's body [[Material_definition_token|materials]] - see the [[Dragon/raw|dragon raws]] for an example).

|-
| {{text anchor|FIREIMMUNE_SUPER}}
| Caste
|
| Like {{token|FIREIMMUNE|c}}, but also renders the creature immune to [[Interaction_token#DRAGONFIRE|DRAGONFIRE]] attacks.

|-
| {{text anchor|FISHITEM}}
| Caste
|
| The creature's corpse is a single [[Item_token#FISH_RAW|FISH_RAW]] food item that needs to be cleaned (into a [[Item_token#FISH|FISH]] item) at a [[fishery]] to become edible. Before being cleaned the item is referred to as "raw". The food item is categorized under "fish" on the food and stocks screens, and when uncleaned it is sorted under "raw fish" in the stocks (but does not show up on the food screen).
Without this or {{token|COOKABLE_LIVE|c}}, [[fishing|fished]] vermin will turn into food the same way as non-vermin creatures, resulting in multiple units of food (meat, brain, lungs, eyes, spleen etc.) from a single fished vermin. These units of food are categorized as meat by the game.

|-
| {{text anchor|FIXED_TEMP}}
| Caste
|
*temperature
| The creature's body is constantly at this temperature, heating up or cooling the surrounding area. Alters the temperature of the creature's inventory and all adjacent tiles, [[Temperature|with all the effects that this implies]] - may trigger wildfires at high enough values. Also makes the creature immune to extreme heat or cold, as long as the temperature set is not harmful to the materials that the creature is made from.

Note that temperatures of 12000 and higher may cause [[path|pathfinding]] issues in fortress mode.

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

|-
| {{text anchor|FLIER}}
| Caste
|
| Allows a creature to fly, independent of it having wings or not. Fortress Mode pathfinding only partially incorporates flying - flying creatures need a land path to exist between them and an area in order to access it, but as long as one such path exists, they do not need to use it, instead being able to fly over intervening obstacles. Winged creatures with this token can lose their ability to fly if their wings are crippled or severed. Winged creatures without this token will be unable to fly. (A 'wing' in this context refers to any body part with its own [[Body_token#FLIER|FLIER]] token).

|-
| {{text anchor|FREQUENCY}}
| Creature
|
*number, max 100
| Determines the chances of a creature appearing within its environment, with higher values resulting in more frequent appearance. Also affects the chance of a creature being brought in a caravan for trading. The game effectively considers all creatures that can possibly appear and uses the FREQUENCY value as a ''weight'' - for example, if there are three creatures with frequencies 10/25/50, the creature with [FREQUENCY:50] will appear approximately 58.8% of the time. Defaults to 50 if not specified. Not to be confused with {{token|POP_RATIO|c}}.
|}

{{alphabetical TOC|style=margin: 1em auto;}}

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

|-
| {{text anchor|GAIT}}
| Caste
|
* <gait type>
* <gait name>
* <max [[Gait#Speed|speed]]>
* <build up time>
* <max turning [[Gait#Speed|speed]]>
* <start [[Gait#Speed|speed]]>
* <energy expenditure>
* <gait flag(s)>
| Defines a gait by which the creature can move. See [[Gait]] for more information.

* <max speed> indicates the maximum [[Gait#Speed|speed]] achievable by a creature using this gait
* <start speed> indicates the creature's speed when it starts moving using this gait
* <build up time> indicates how long it will take for a creature using this gait to go from <start speed> to <max speed>. For example, a value of 10 means that it should be able to reach the maximum speed by moving 10 [[tile]]s in a straight line over even terrain.
* <max turning speed> indicates the maximum speed permissible when the creature suddenly changes its direction of motion. The creature's speed will be reduced to <max turning speed> if travelling at a higher speed than this before turning.
* <energy expenditure> indicates how energy-consuming the gait is. Higher values cause the creature to tire out faster. Persistent usage of a high-intensity gait will eventually lead to exhaustion and [[Status_icon#Non-flashing|collapse]].

'''NO_BUILD_UP''' can be specified instead of a <start speed> value to make the <max speed> instantly achievable upon initiating movement (this is equivalent to a <build up time> of 0). Note that <build up time> and <max turning speed> are both ignored if specified alongside this (as NO_BUILD_UP trumps <build up time> and preserves <max speed> whilst turning, and <max turning speed> cannot exceed <max speed>) so it is permissible to omit them so long as they are '''both''' omitted together.

It's possible to specify a <start speed> greater than the <max speed>; the moving creature will decelerate towards its <max speed> in this case.

'''valid gait types:'''
*'''WALK''' 
Used for moving normally over ground tiles.

*'''CRAWL''' 
Used for moving over ground tiles whilst [[Status_icon#Non-flashing|prone]].

*'''SWIM''' 
Used for moving through tiles containing [[water]] or [[magma]] at a [[Water#Depth|depth]] of at least 4/7.

*'''FLY''' 
Used for moving through [[open space]].

*'''CLIMB''' 
Used for moving whilst [[Climber|climbing]].

'''valid gait flags:'''
* '''AGILITY''' 
Speeds/slows movement depending on the creature's [[Attribute#Agility|Agility]] stat.

* '''STRENGTH''' 
Speeds/slows movement depending on the creature's [[Attribute#Strength|Strength]] stat.

* '''LAYERS_SLOW''' 
Makes [[Tissue_definition_token#THICKENS_ON_ENERGY_STORAGE|THICKENS_ON_ENERGY_STORAGE]] and [[Tissue_definition_token#THICKENS_ON_STRENGTH|THICKENS_ON_STRENGTH]] tissue layers slow movement depending on how thick they are. Adding the STRENGTH gait flag counteracts the impact of the latter layer.

* '''STEALTH_SLOWS:'''<percentage> 
Slows movement by the specified percentage when the creature is [[Ambusher|sneaking]].

|-
| {{text anchor|GENERAL_BABY_NAME}}
| Creature
|
*singular
*plural
| Like {{token|BABYNAME|c}}, but applied regardless of caste.

|-
| {{text anchor|GENERAL_CHILD_NAME}}
| Creature
|
*singular
*plural
| Like {{token|CHILDNAME|c}}, but applied regardless of caste.

|-
| {{text anchor|GENERAL_MATERIAL_FORCE_MULTIPLIER}}
| Caste
|
*value A
*value B
| Has the same function as {{token|MATERIAL_FORCE_MULTIPLIER|c}}, but applies to all attacks instead of just those involving a specific material. Appears to be overridden by MATERIAL_FORCE_MULTIPLIER ([[werebeast]]s, for example, use both tokens to provide resistance to all materials, with one exception to which they are especially vulnerable).

|-
| {{text anchor|GENERATED}}
| Creature
|
| Found on procedurally generated creatures like [[forgotten beast]]s, [[titan]]s, [[demon]]s, [[angel]]s, and [[night creature]]s. Cannot be specified in user-defined raws.

|-
| {{text anchor|GETS_INFECTIONS_FROM_ROT}}
| Caste
|
| Makes the creature get [[Health_care#Infection|infections]] from necrotic tissue.

|-
| {{text anchor|GETS_WOUND_INFECTIONS}}
| Caste
|
| Makes the creature's wounds become [[Health_care#Infection|infected]] if left untreated for too long.

|-
| {{text anchor|GLOWCOLOR}}
| Creature
|
*foreground
*background
*brightness
| The colour of the creature's {{token|GLOWTILE|c}}.

|-
| {{text anchor|GLOWTILE}}
| Creature
|
*ascii character
| If present, the being glows in the dark (generally used for Adventurer 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 {{token|CASTE_GLOWTILE|c}} instead.

|-
| {{text anchor|GNAWER}}
| Caste
|
*verb
| The creature can and will gnaw its way out of [[animal trap]]s and [[cage]]s using the specified verb, depending on the material from which it is made (normally wood).

|-
| {{text anchor|GOBBLE_VERMIN_CLASS}}
| Caste
|
*class
| The creature eats vermin of the specified class.

|-
| {{text anchor|GOBBLE_VERMIN_CREATURE}}
| Caste
|
*creature
*caste
| The creature eats a specified [[vermin]].

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

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

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

|-
| {{text anchor|GOOD}}
| Creature
|
| Creature is considered good and will only show up in good biomes - [[unicorn]]s, for example. Civilizations with {{token|USE_GOOD_ANIMALS|e}} can domesticate them regardless of exotic status. Has no effect on cavern creatures except to restrict taming. A civilization that has good creatures can colonise good areas in world-gen.

|-
| {{text anchor|GRASSTRAMPLE}}
| Caste
|
*value
| The value determines how rapidly [[grass]] is trampled when a creature steps on it - a value of 0 causes the creature to never damage grass, while a value of 100 causes grass to be trampled as rapidly as possible. Defaults to 5.

|-
| {{text anchor|GRAVITATE_BODY_SIZE}}
| Caste
|
*target value
| Used in Creature Variants. This token changes the adult body size to the average of the old adult body size and the target value and scales all intermediate growth stages by the same factor.

|-
| {{text anchor|GRAZER}}
| Caste
|
*number
| The creature is a grazer - if tamed in fortress mode, it needs a pasture to survive. The higher the number, the less frequently it needs to eat in order to live. Not used since 0.40.12, replaced by {{token|STANDARD_GRAZER|c}} to fix {{bugl|4113}}.
|}

{{alphabetical TOC|style=margin: 1em auto;}}

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

|-
| {{text anchor|HABIT}}
| Caste
|
*type
*probability
| Defines certain behaviors for the creature. The habit types are:
*COLLECT_TROPHIES
*COOK_PEOPLE
*COOK_VERMIN
*GRIND_VERMIN
*COOK_BLOOD
*GRIND_BONE_MEAL
*EAT_BONE_PORRIDGE
*USE_ANY_MELEE_WEAPON
*GIANT_NEST
*COLLECT_WEALTH.
These require the creature to have a {{token|LAIR|c}} to work properly, and also don't seem to work on creatures who are not a {{token|SEMIMEGABEAST|c}}, {{token|MEGABEAST|c}} or {{token|NIGHT_CREATURE_HUNTER|c}}.

|-
| {{text anchor|HABIT_NUM}}
| Caste
|
*number or TEST_ALL
| "If you set HABIT_NUM to a number, it should give you that exact number of habits according to the weights.".{{cite forum|60554/1719248}} All lists of HABITs are preceded by [HABIT_NUM:TEST_ALL]

|-
| {{text anchor|HAS_NERVES}}
| Caste
|
| The creature has nerves in its muscles. Cutting the muscle tissue can sever motor and sensory nerves.

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

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

|-
| {{text anchor|HOMEOTHERM}}
| Caste
|
*number or NONE
| Default 'NONE'. The creature's normal body [[temperature]]. Creature ceases maintaining temperature on death unlike fixed material temperatures. Provides minor protection from environmental temperature to the creature.

|-
| {{text anchor|HUNTS_VERMIN}}
| Caste
|
| Creature hunts and kills nearby [[vermin]].

|}

{{alphabetical TOC|style=margin: 1em auto;}}

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

|-
| {{text anchor|IMMOBILE}}
| Caste
|
| The creature cannot move. Found on [[sponge]]s. Will also stop a creature from breeding in fortress mode (MALE and FEMALE are affected, if one is IMMOBILE no breeding will happen).

|-
| {{text anchor|IMMOBILE_LAND}}
| Caste
|
| The creature is immobile while on land. Only works on {{token|AQUATIC|c}} creatures which can't breathe on land.

|-
| {{text anchor|IMMOLATE}}
| Caste
|
| The creature radiates [[fire]]. It will ignite, and potentially completely destroy, items the creature is standing on. Also gives the vermin a high chance of escaping from [[animal trap]]s and [[cage]]s made of any flammable materials (specifically ones that could be ignited by magma).

|-
| {{text anchor|INTELLIGENT}}
| Caste
|
| Alias for {{token|CAN_SPEAK|c}} + {{token|CAN_LEARN|c}} but additionally keeps creatures from being [[butcher|butchered]] by the AI during worldgen and post-gen. In fortress mode, {{token|CAN_LEARN|c}} is enough.

|-
| {{text anchor|ITEMCORPSE}}
| Caste
|
* [[item token]]
* [[material token]]
| Determines if the creature leaves behind a non-standard corpse (i.e. wood, statue, bars, stone, pool of liquid, etc.). [[Ethics]] may prevent actually using the item in jobs or reactions.

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

{{alphabetical TOC|style=margin: 1em auto;}}

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

|-
| {{text anchor|LAIR}}
| Caste
|
*type
*probability
| Found on megabeasts, semimegabeasts, and night creatures. The creature will seek out sites of this type and take them as lairs. The lair types are:
*SIMPLE_BURROW
*SIMPLE_MOUND
*WILDERNESS_LOCATION
*SHRINE
*LABYRINTH

|-
| {{text anchor|LAIR_CHARACTERISTIC}}
| Caste
|
*characteristic
*probability
| Defines certain features of the creature's lair. The only valid characteristic is HAS_DOORS.

|-
| {{text anchor|LAIR_HUNTER}}
| Caste
|
| This creature will actively hunt adventurers in its lair.

|-
| {{text anchor|LAIR_HUNTER_SPEECH}}
| Caste
|
*speech file
| What this creature says while hunting adventurers in its lair.

|-
| {{text anchor|LARGE_PREDATOR}}
| Caste
|
| Will attack things that are smaller than it (like dwarves). Only one group of "large predators" (possibly two groups on "savage" maps) will appear on any given map. In adventure mode, large predators will try to ambush and attack you (and your party will attack them back). When tamed, large predators tend to be much more aggressive to enemies than non-large predators, making them a good choice for an animal army. They may go on rampages in worldgen, and adventurers may receive quests to kill them. Also, they can be mentioned in the intro paragraph when starting a fortress e.g. "ere the wolves get hungry."

|-
| {{text anchor|LARGE_ROAMING}}
| Creature
|
| This is the core requisite tag allowing the creature to spawn as a wild animal in the appropriate biomes. Requires specifying a {{token|BIOME|c}} in which the creature will spawn. Does not require specifying a frequency, population number, or cluster number.

This tag stacks with {{token|MEGABEAST|c}}, {{token|SEMIMEGABEAST|c}}, or {{token|NIGHT_CREATURE_HUNTER|c}}; if used with one of these tags, the creature will spawn as both a boss and as a wild animal. This tag does not stack with {{token|FEATURE_BEAST|c}} and if both are used the creature will not spawn. This tag is uneffected by {{token|DEMON|c}}.

|-
| {{text anchor|LAYS_EGGS}}
| Caste
|
| Creature lays [[egg]]s instead of giving birth to live young.

|-
| {{text anchor|LAYS_UNUSUAL_EGGS}}
| Caste
|
* [[item token]]
* [[material token]]
| Creature lays the specified item instead of regular eggs.

|-
| {{text anchor|LIGAMENTS}}
| Caste
|
* [[material token]]
*healing rate
| The creature has ligaments in its {{token|CONNECTIVE_TISSUE_ANCHOR|td}} tissues (bone or chitin by default). Cutting the bone/chitin tissue severs the ligaments, disabling motor function if the target is a limb.

|-
| {{text anchor|LIGHT_GEN}}
| Caste
|
| A vermin featuring this tag will remain visible to an adventurer, even at night (without being dimmed in color along with the surrounding terrain), and from a distance (even outside the current vision cone). Subterranean vermin which feature this token will flicker in unexposed and unrevealed cavern layers while playing in Fortress Mode.

|-
| {{text anchor|LIKES_FIGHTING}}
| Caste
|
| The creature will attack enemies rather than flee from them. This tag has the same effect on player-controlled creatures - including modded dwarves. Retired as of v0.40.14 in favor of {{token|LARGE_PREDATOR|c}}.

|-
| {{text anchor|LISP}}
| Caste
|
| Creature uses "sssssnake talk" (multiplies 'S' when talking - "My name isss Recisssiz."). Used by [[Serpent man|serpent men]] and [[Reptile man|reptile men]] in the vanilla game. C's with the same pronunciation (depending on the word) are not affected by this token.

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

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

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

|-
| {{text anchor|LOCKPICKER}}
| Caste
|
| Lets a creature open [[door]]s that are set to forbidden in fortress mode.

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

|-
| {{text anchor|LOW_LIGHT_VISION}}
| Caste
|
*number
| Determines how well a creature can see in the dark - higher is better. Dwarves have 10000, which amounts to perfect nightvision.
|}

{{alphabetical TOC|style=margin: 1em auto;}}

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

|-
| {{text anchor|MAGICAL}}
| Caste
|
| According to Toady One, this is completely interchangeable with {{token|AT_PEACE_WITH_WILDLIFE|c}} and might have been used in very early versions of the game by wandering wizards or the ent-type tree creatures that used to be animated by elves. [http://www.bay12forums.com/smf/index.php?topic=169696.msg8316954#msg8316954]

|-
| {{text anchor|MAGMA_VISION}}
| Caste
|
| The creature is able to see while submerged in [[magma]].

|-
| {{text anchor|MALE}}
| Caste
|
| Makes the creature biologically male. Usually declared inside a caste.

|-
| {{text anchor|MANNERISM|MANNERISM_*}}
| Caste
|
*occasionally body part
| Adds a possible mannerism to the creature's profile. See [[creature mannerism token]] for further info.

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

|-
| {{text anchor|MATERIAL_FORCE_MULTIPLIER}}
| Caste
|
*[[Material token]]
*value A
*value B
| When struck with a weapon made of the specified material, the force exerted will be multiplied by A/B, thus making the creature more or less susceptible to this material. For example, if A is 2 and B is 1, the force exerted by the defined material will be doubled. If A is 1 and B is 2, it will be halved instead. See also {{token|GENERAL_MATERIAL_FORCE_MULTIPLIER|c}}, which can be used to make this sort of effect applicable to all materials.

|-
| {{text anchor|MATUTINAL}}
| Caste
|
| When set, the creature will only appear at dawn (between 4:30 AM and 6:00 AM) in Adventurer mode.

|-
| {{text anchor|MAXAGE}}
| Caste
|
*min
*max
| Determines the creature's natural lifespan, using the specified minimum and maximum age values (in years). Each individual creature with this token is generated with a predetermined date (calculated down to the exact [[time|tick]]!) between these values, at which it is destined to die of old age, should it live long enough. Note that the probability of death at any given age does not increase as the creature gets older [http://i.imgur.com/A1A4aA9.png].
Creatures which lack this token are naturally immortal. The [[Syndrome#CE_ADD_TAG|NO_AGING]] syndrome tag will prevent death by old age from occurring. Also note that, among civilized creatures, castes which lack this token will refuse to marry others with it, and vice versa.

|-
| {{text anchor|MEANDERER}}
| Caste
|
| Makes the creature slowly stroll around, unless it's in combat or performing a job. If combined with {{token|CAN_LEARN|c}}, will severely impact their [[pathfinding]] and lead the creature to move extremely slowly when not performing any task. Problematically applies to animal people based on the animal and war trained animals{{bug|9588}}.

|-
| {{text anchor|MEGABEAST}}
| Caste
|
| A 'boss' creature. A small number of the creatures are created during worldgen, their histories and descendants (if any) will be tracked in worldgen (as opposed to simply 'spawning'), and they will occasionally go on rampages, potentially leading to worship if they attack the same place multiple times. Their presence and number will also influence age names. When appearing in fortress mode, they will have a pop-up message announcing their arrival. They will remain hostile to military even after being tamed.{{bug|10731}} See [[megabeast]] page for more details.

Requires specifying a {{token|BIOME|c}} in which the creature will live. Subterranean biomes appear to not be allowed. Does stack with {{token|LARGE_ROAMING|c}} and if both are used the creature will spawn as both historical bosses and as wild animals.

|-
| {{text anchor|MENT_ATT_CAP_PERC}}
| Caste
|
*[[Attribute|ATTRIBUTE]] Token
*Cap %
|Default is 200. This means you can increase your attribute to 200% of its starting value (or the average value + your starting value if that is higher).

|-
| {{text anchor|MENT_ATT_RANGE}}
| Caste
|
*[[Attribute|ATTRIBUTE]]
*lowest
*lower
*low
*median
*high
*higher
*highest
| Sets up a [[Attribute#Soul_attributes|mental attribute]]'s range of values (0-5000). All mental attribute ranges default to 200:800:900:1000:1100:1300:2000.

|-
| {{text anchor|MENT_ATT_RATES}}
| Caste
|
*[[Attribute|ATTRIBUTE]] Token
*cost to improve
*unused counter rate
*rust counter rate
*demotion counter rate
| [[Attribute#Soul_attributes|Mental attribute]] gain/decay rates. Lower numbers in the last three slots make decay occur faster. Defaults are 500:4:5:4.

|-
| {{text anchor|MILKABLE}}
| Caste
|
* [[material token]]
* frequency
| Allows the creature to be [[milk]]ed in the [[farmer's workshop]]. The frequency is the amount of [[time|ticks]] the creature needs to "recharge" (i.e. how much time needs to pass before it can be milked again). Does not work on [[#CAN_LEARN|sentient]] creatures, regardless of [[ethics]].

|-
| {{text anchor|MISCHIEVIOUS}}
| Caste
|
| Alias for {{token|MISCHIEVOUS|c}}.

|-
| {{text anchor|MISCHIEVOUS}}
| Caste
|
| The creature spawns [[stealth]]ed and will attempt to path into the fortress, pulling any [[lever]]s it comes across. It will be invisible on the map and [[unit list]] until spotted by a citizen, at which point the game will pause and recenter on the creature. Used by [[gremlin]]s in the vanilla game. "They go on little missions to mess with various fortress buildings, not just levers."

|-
| {{text anchor|MODVALUE}}
| Caste
|
| Seemingly no longer used.

|-
| {{text anchor|MOUNT}}
| Caste
|
| Creature may be used as a [[mount]]. No use for the player in fortress mode, but enemy sieging forces may arrive with cavalry. Mounts are usable in adventure mode.

|-
| {{text anchor|MOUNT_EXOTIC}}
| Caste
|
| Creature may be used as a [[mount]], but civilizations cannot domesticate it in worldgen without certain exceptions.

|-
| {{text anchor|MULTIPART_FULL_VISION}}
| Caste
|
| Allows the creature to have all-around vision as long as it has multiple heads that can see.

|-
| {{text anchor|MULTIPLE_LITTER_RARE}}
| Caste
|
| Makes the species usually produce a single offspring per birth, occasionally producing twins or triplets with a 1/500 chance. Requires {{token|FEMALE|c}}.

|-
| {{text anchor|MUNDANE}}
| Creature
|
| Marks if the creature is an actual real-life creature. Only used for age-names at present.
|}

{{alphabetical TOC|style=margin: 1em auto;}}

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

|-
| {{text anchor|NAME}}
| Creature
|
*singular
*plural
*adjective
| The generic name for any creature of this type - will be used when distinctions between caste are unimportant. For names for specific castes, use {{token|CASTE_NAME|c}} instead. If left undefined, the creature will be labeled as "nothing" by the game.

|-
| {{text anchor|NATURAL}}
| Caste
|
| Animal is considered to be natural. NATURAL animals will not engage creatures tagged with {{token|AT_PEACE_WITH_WILDLIFE|c}} in combat unless they are members of a hostile entity and vice-versa.

|-
| {{text anchor|NATURAL_ANIMAL}}
| Caste
|
| Alias of {{token|NATURAL|c}}.

|-
| {{text anchor|NATURAL_SKILL}}
| Caste
|
*[[Skill_token|Skill token]]
*value
| The creature possesses the specified [[skill]] at this level inherently - that is, it begins with the skill at this level, and the skill may never rust below that. A value of 15 is legendary.

|-
| {{text anchor|NIGHT_CREATURE}}
| Caste
|
| Creatures with this token can appear on [[experiment|experiments]].
Prevents {{token|LOCAL_POPS_PRODUCE_HEROES|c}} from functioning. Causes the creature to count as {{token|NOT_LIVING|c}}. Killing a creature featuring this token provides one point of "hero" reputation. Adds the creature's description as part of the initial summary of their historical figure in legends. Prevents creature behavior enabled by {{token|LARGE_PREDATOR|c}}. People will react to creatures with this token as a night creature (natch). In adventure mode, ambushes involving these units will say "Night creature!" instead of "Ambush!"

Prevents the AI from using ANIMATE interactions unless the newly-animated opposed-to-life undead will not attack them. The check for this is specifically whether the unit is:
*a ghost
*an animated unit
*a unit with the {{token|NO_AGING|c}} token added via {{token|CE_ADD_TAG|c}}. (This allows for the default exclusion of elves and goblins, unless raised as intelligent undead.)

''This token should not be confused with other NIGHT_CREATURE_X tokens.''
''This token is not well understood at the present time.''

|-
| {{text anchor|NIGHT_CREATURE_BOGEYMAN}}
| Caste
|
| Creatures with this token can appear in [[bogeyman|bogeyman ambushes]] in [[adventure mode]], where they adopt classical bogeyman traits such as stalking the adventurer and vaporising when dawn breaks. Such traits do not manifest if the creature is encountered outside of a bogeyman ambush (for instance, as a megabeast or a civilised being). In addition, their corpses and severed body parts turn into [[smoke]] after a short while. Note that setting the "Number of Bogeyman Types" in [[advanced world generation]] to 0 will only remove randomly-generated bogeymen.

|-
| {{text anchor|NIGHT_CREATURE_EXPERIMENTER}}{{version|0.47.01}}
| Caste
|
| Found on some [[necromancer]]s. Creatures with this tag may periodically "perform horrible experiments" offscreen, during which they can use creature-targeting interactions with an <code>[[Interaction_token#I_SOURCE|[I_SOURCE:EXPERIMENT]]]</code> tag on living creatures in their area. Worlds are generated with a list of procedurally-generated experiments, allowing necromancers to turn living people and animals into [[Infected_ghoul|ghouls]] and [[Experiment|other experimental creatures]], and these will automatically be available to all experimenters; it does not appear possible to prevent this. You can mod in your own custom experiment interactions, but these are used very infrequently due to the large number of generated experiments.

|-
| {{text anchor|NIGHT_CREATURE_HUNTER}}
| Caste
|
| Found on [[night troll]]s and [[werebeast]]s. Implies that the creature is a [[night creature]], and shows its description in [[legends mode]] entry. The creature is always hostile and will start [[no quarter]] combat with any nearby creatures, except for members of its own race. Note that this tag does not override the creature's normal behavior in [[fortress mode]] except for the aforementioned aggression, and doesn't prevent the creature from fleeing the battles it started. It also removes the creature's materials from stockpile settings list, making them be stored there regardless of settings.

Does stack with {{token|LARGE_ROAMING|c}} and if both are used the creature will spawn as both historical hunters and as wild animals; this requires specifying a {{token|BIOME|c}} in which the creature will live, and subterranean biomes are allowed.

This tag causes the usual behaviour of werebeasts in worldgen, that is, fleeing towns upon being cursed and conducting raids from a lair. If this tag is absent from a deity curse, the accursed will simply be driven out of towns in a similar manner to [[vampire]]s. When paired with SPOUSE_CONVERTER, a very small population of the creature will be created during worldgen (sometimes only a single individual will be created), and their histories will be tracked (that is, they will not spawn spontaneously later, they must either have children or convert other creatures to increase their numbers). The creature will settle in a lair and go on rampages during worldgen. It will actively attempt to seek out potential conversion targets to abduct, convert, and have children with (if possible).

|-
| {{text anchor|NIGHT_CREATURE_NIGHTMARE}}{{version|0.47.01}}
| Caste
|
| Found on [[nightmare]]s. Corpses and severed body parts derived from creatures with this token turn into [[smoke]] after a short while.

|-
| {{text anchor|NO_AUTUMN}}
| Caste
|
| The creature caste does not appear in [[Calendar|autumn]].

|-
| {{text anchor|NO_CONNECTIONS_FOR_MOVEMENT}}
| Caste
|
| Creature doesn't require connected body parts to move{{verify}}; generally used on undead creatures with connections that have rotted away.

|-
| {{text anchor|NO_DIZZINESS}}
| Caste
|
| Creature cannot become [[Symptom#Dizziness|dizzy]].

|-
| {{text anchor|NO_DRINK}}
| Caste
|
| Creature does not need to drink.

|-
| {{text anchor|NO_EAT}}
| Caste
|
| Creature does not need to [[food|eat]]. Seems to cause worldgen crashes if it is part of an entity with [[entity_token#PERMITTED_JOB|[PERMITTED_JOB:FISHERMAN]]]{{verify}}

|-
| {{text anchor|NO_FEVERS}}
| Caste
|
| Creature cannot suffer [[Symptom#Fever|fevers]].

|-
| {{text anchor|NO_GENDER}}
| Caste
|
| The creature is biologically sexless. Makes the creature unable to [[breeding|breed]].

|-
| {{text anchor|NO_PHYS_ATT_GAIN}}
| Caste
|
| The creature cannot raise any [[Attribute#Body_attributes|physical attributes]].

|-
| {{text anchor|NO_PHYS_ATT_RUST}}
| Caste
|
| The creature cannot lose any [[Attribute#Body_attributes|physical attributes]].

|-
| {{text anchor|NO_SLEEP}}
| Caste
|
| Creature does not need to sleep. Can still be rendered unconscious by other means.

|-
| {{text anchor|NO_SPRING}}
| Caste
|
| The creature caste does not appear in [[Calendar|spring]].

|-
| {{text anchor|NO_SUMMER}}
| Caste
|
| The creature caste does not appear in [[Calendar|summer]].

|-
| {{text anchor|NO_THOUGHT_CENTER_FOR_MOVEMENT}}
| Caste
|
| Creature doesn't require an organ with the {{token|THOUGHT|body}} tag to survive or attack; generally used on creatures that don't have brains.

|-
| {{text anchor|NO_UNIT_TYPE_COLOR}}
| Caste
|
| Prevents creature from selecting its color based on its profession (e.g. Miner, Hunter, Wrestler).

|-
| {{text anchor|NO_VEGETATION_PERTURB}}
| Caste{{Verify}}
|
| Likely prevents the creature from leaving broken vegetation tracks.{{Verify}}

|-
| {{text anchor|NO_WINTER}}
| Caste
|
| The creature caste does not appear in [[Calendar|winter]].

|-
| {{text anchor|NOBONES}}
| Caste
|
| Creature has no bones.

|-
| {{text anchor|NOBREATHE}}
| Caste
|
| Creature doesn't need to breathe or have {{token|BREATHE|body}} parts in body, nor can it drown or be strangled. Creatures living in magma must have this tag, otherwise they will drown.

|-
| {{text anchor|NOCTURNAL}}
| Caste
|
| When set, the creature will only appear at night (after 10:05 PM and before 4:30 AM) in Adventurer mode.

|-
| {{text anchor|NOEMOTION}}
| Caste
|
| Creature has no emotions. It is immune to the effects of [[stress]] and unable to rage, and its [[need]]s cannot be fulfilled in any way. Used on [[undead]] in the vanilla game.

|-
| {{text anchor|NOEXERT}}
| Caste
|
| Creature can't become tired or over-exerted from taking too many combat actions or moving at full speed for extended periods of time.

|-
| {{text anchor|NOFEAR}}
| Caste
|
| Creature doesn't feel fear and will never flee from battle, and will be immune to [[ghost]]s' attempts to 'scare it to death'. Additionally, it causes [[bogeyman|bogeymen]] and [[nightmare]]s to become friendly towards the creature.

|-
| {{text anchor|NOMEAT}}
| Caste
|
| Creature will not drop meat when [[butcher|butchered]].

|-
| {{text anchor|NONAUSEA}}
| Caste
|
| Creature isn't nauseated by gut hits and cannot vomit.

|-
| {{text anchor|NOPAIN}}
| Caste
|
| Creature doesn't feel pain.

|-
| {{text anchor|NOSKIN}}
| Caste
|
| Creature will not drop a hide when [[butcher|butchered]].

|-
| {{text anchor|NOSKULL}}
| Caste
|
| Creature will not drop a skull on butchering, rot, or decay of severed head.

|-
| {{text anchor|NOSMELLYROT}}
| Caste
|
| Does not produce [[miasma]] when rotting.

|-
| {{text anchor|NOSTUCKINS}}
| Caste
|
| Weapons can't get stuck in the creature.

|-
| {{text anchor|NOSTUN}}
| Caste
|
| Creature can't be stunned and knocked unconscious by pain or head injuries. Creatures with this tag never wake up from sleep in Fortress Mode. If this creature needs to sleep while playing, it will die.

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

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

|-
| {{text anchor|NOTHOUGHT}}
| Caste
|
| Creature doesn't require a {{token|THOUGHT|body}} body part to survive. Has the added effect of preventing speech, though directly controlling creatures that would otherwise be capable of speaking allows them to engage in conversation.
|}

{{alphabetical TOC|style=margin: 1em auto;}}

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

|-
| {{text anchor|ODOR_LEVEL}}
| Caste
|
*number
| How easy the creature is to [[smell]]. The higher the number, the easier the creature is to sniff out. Defaults to 50. Vanilla creatures have values from 0 (undetectable) to 90 (noticeable by humans and dwarves).

|-
| {{text anchor|ODOR_STRING}}
| Caste
|
*string
| What the creature [[smell]]s like. If no odor string is defined, the creature name (not the caste name) is used.

|-
| {{text anchor|OPPOSED_TO_LIFE}}
| Caste
|
| Is hostile to all creatures except undead and other non-living ones and will show {{DFtext|Opposed to life|0:1}} in the [[unit list]]. Used by [[undead]] in the vanilla game. Functions without the {{token|NOT_LIVING|c}} token, and seems to imply said token as well. Undead will not be hostile to otherwise-living creatures given this token. Living creatures given this token will attack living creatures that lack it, while ignoring other living creatures that also have this token.

|-
| {{text anchor|ORIENTATION}}
| Caste
|
*MALE/FEMALE
*disinterested chance
*lover-possible chance
*preference(?)-possible chance
| Determines caste's likelihood of having sexual attraction to certain sexes. Values default to 75:20:5 for the same sex and 5:20:75 for the opposite sex. The first value indicates how likely to be entirely uninterested in the sex, the second decides if the creature will become lovers, the third decides if the creature will "prefer" this sex{{Verify}}. Marriage can happen as long as they are not disinterested. The values themselves are simply ratios and do not need to add up to any particular value.

|-
| {{text anchor|OUTSIDER_CONTROLLABLE}}{{version|0.42.01}}
| Caste
|
| Lets you play as an [[Adventurer_mode_character_creation#Outsider|outsider]] of this species in adventure mode.

|}

{{alphabetical TOC|style=margin: 1em auto;}}

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

|-
| {{text anchor|PACK_ANIMAL}}
| Caste
|
| Allows the creature to be used as a pack animal. Used by [[trading|merchants]] without wagons and adventurers. Also prevents creature from dropping hauled items on its own -- do ''not'' use for player-controllable creatures!

|-
| {{text anchor|PARALYZEIMMUNE}}
| Caste
|
| The creature is immune to all [[Syndrome#CE_PARALYSIS|paralyzing]] special attacks.

|-
| {{text anchor|PATTERNFLIER}}
| Caste
|
| Used to control the bat riders with paralyze-dart blowguns that flew through the 2D chasm. Doesn't do anything now.

|-
| {{text anchor|PEARL}}
| Caste
|
| In earlier versions, creature would generate [[pearl]]s. Does nothing in the current version.{{verify}}

|-
| {{text anchor|PENETRATEPOWER}}
| Caste
|
*value
| Controls the ability of [[vermin]] to find a way into containers when they are eating food from your stockpiles.

Objects made of most materials (e.g. metal) roll a number from 0-100, and if the resulting number is greater than the penetrate power, their contents escape for the time being. Objects made of [[wood]], [[leather]], [[amber]], or [[coral]] roll 0-95, and items made of [[cloth]] roll 0-90.

|-
| {{text anchor|PERSONALITY}}
| Caste
|
*ATTRIBUTE
*lowest
*median
*highest
| Determines the range and chance of personality traits. Standard is 0:50:100. See [[Personality trait]] for more info.

|-
| {{text anchor|PET}}
| Caste
|
| Allows the creature to be [[Animal_trainer|tamed]] in Fortress mode. Prerequisite for all other working animal roles. Civilizations that encounter it in worldgen will tame and domesticate it for their own use. Adding this to civilization members will classify them as pets instead of citizens, with all the [[Fun|problems]] that entails. However, you can solve these problems using the popular plugin [https://dffd.bay12games.com/file.php?id=13095| Dwarf Therapist], which is completely unaffected by the tag.

|-
| {{text anchor|PET_EXOTIC}}
| Caste
|
| Allows the creature to be [[Animal_trainer|tamed]] in Fortress mode. Prequisite for all other working animal roles. Civilizations cannot domesticate it in worldgen, with certain exceptions. More difficult to tame?{{verify}} Adding this to civilization members will classify them as pets instead of citizens, with all the [[Fun|problems]] that entails. ([[Gremlin|Example]]).

|-
| {{text anchor|PETVALUE}}
| Caste
|
*value
| How valuable a tamed animal is. Actual cost in points in the embarking screen is 1+(PETVALUE/2) for an untrained animal, 1+PETVALUE for a war/hunting one.

|-
| {{text anchor|PETVALUE_DIVISOR}}
| Caste
|
*value
| Divides the creature's {{token|PETVALUE|c}} by the specified number. Used by [[honey bee]]s to prevent a single hive from being worth a fortune.

|-
| {{text anchor|PHYS_ATT_CAP_PERC}}
| Caste
|
*[[Attribute|ATTRIBUTE]] Token
*Cap %
|Default is 200. This means you can increase your attribute to 200% of its starting value (or the average value + your starting value if that is higher).

|-
| {{text anchor|PHYS_ATT_RANGE}}
| Caste
|
*[[Attribute|ATTRIBUTE]]
*lowest
*lower
*low
*median
*high
*higher
*highest
| Sets up a [[Attribute#Body_attributes|physical attribute]]'s range of values (0-5000). All physical attribute ranges default to 200:700:900:1000:1100:1300:2000.

|-
| {{text anchor|PHYS_ATT_RATES}}
| Caste
|
*[[Attribute|ATTRIBUTE]] Token
*cost to improve
*unused counter rate
*rust counter rate
*demotion counter rate
| [[Attribute#Body_attributes|Physical attribute]] gain/decay rates. Lower numbers in the last three slots make decay occur faster. Defaults for STRENGTH, AGILITY, TOUGHNESS, and ENDURANCE are 500:3:4:3, while RECUPERATION and DISEASE_RESISTANCE default to 500:NONE:NONE:NONE.

|-
| {{text anchor|PLUS_BP_GROUP}}
| Caste
|
*BY_TYPE, BY_CATEGORY, or BY_TOKEN
*body type, category, or token
| Adds a body part group to selected body part group. Presumably used immediately after {{token|SET_BP_GROUP|c}}.

|-
| {{text anchor|PLUS_MATERIAL}}
| Creature
|
*material
| Adds a material to selected materials. Used immediately after {{token|SELECT_MATERIAL|c}}.

|-
| {{text anchor|POP_RATIO}}
| Caste
|
*number
| Weighted population of caste; Lower is rarer. Not to be confused with {{token|FREQUENCY|c}}.

|-
| {{text anchor|POPULATION_NUMBER}}
| Creature
|
*min
*max
| The minimum/maximum numbers of how many of these creatures are present in each world map tile of the appropriate region. Defaults to 1:1 if not specified.

|-
| {{text anchor|POWER}}
| Caste
|
| Allows the being to represent itself as a deity, allowing it to become the leader of a civilized group. Used by unique demons in the vanilla game. Requires {{token|CAN_SPEAK|c}} to actually do anything more than settle at a location (e.g. write books, lead armies, profane temples). Doesn't appear to do anything for creatures that are already civilized. Once the creature ascends to a position of leadership, it will proceed to act as a standard ruler for their entity and fulfill the same functions (hold tournaments, tame creatures, etc).

|-
| {{text anchor|PREFSTRING}}
| Creature
|
*string
| Sets what other creatures [[Preferences|prefer]] about this creature. "Urist likes dwarves for their beards." Multiple entries will be chosen from at random. Creatures lacking a PREFSTRING token will never appear under another's preferences.

|-
| {{text anchor|PROFESSION_NAME}}
| Creature
|
*[[Unit type token]] (Profession)
*singular
*plural
| The generic name for members of this profession, at the creature level. In order to give members of specific castes different names for professions, use {{token|CASTE_PROFESSION_NAME|c}} instead.

|-
| {{text anchor|PRONE_TO_RAGE}}
| Caste
|
*Chance
| Creature has a percentage chance to flip out at visible non-friendly creatures. Enraged creatures attack anything regardless of timidity and get a strength bonus to their hits. This is what makes [[badger]]s so hardcore.

|-
| {{text anchor|PUS}}
| Caste
|
* <[[material token]]>
* <[[Material_definition_token#Material_States|material state]]>
| The creature has pus. Specifies the stuff secreted by [[Health_care#Infection|infected wounds]].
|}

{{alphabetical TOC|style=margin: 1em auto;}}

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

|-
| {{text anchor|RELSIZE}}
| Caste
|
*BY_CATEGORY, BY_TYPE, BY_TOKEN
*body category, type, or token
*Relsize
| Specifies a new relative size for a part than what is stated in the body plan. For example, dwarves have larger livers.

|-
| {{text anchor|REMAINS}}
| Caste
|
*singular
*plural
| What the creature's [[remains]] are called.

|-
| {{text anchor|REMAINS_COLOR}}
| Caste
|
| What color the creature's [[remains]] are.

|-
| {{text anchor|REMAINS_ON_VERMIN_BITE_DEATH}}
| Caste
|
| Goes with {{token|VERMIN_BITE|c}} and {{token|DIE_WHEN_VERMIN_BITE|c}}, the vermin creature will leave remains on death when biting. Leaving this tag out will cause the creature to disappear entirely after it bites.

|-
| {{text anchor|REMAINS_UNDETERMINED}}
| Caste
|
| Unknown.

|-
| {{text anchor|REMOVE_MATERIAL}}
| Creature
|
*material token
| Removes a material from the creature.

|-
| {{text anchor|REMOVE_TISSUE}}
| Creature
|
*tissue token
| Removes a tissue from the creature.

|-
| {{text anchor|RETRACT_INTO_BP}}
| Caste
|
*BY_TYPE, BY_CATEGORY or BY_TOKEN
*body type, [[Body_token#CATEGORY|category]], or [[Body_token#BP|token]]
*Second person ("You") retract verb text
*Third person ("The giant snail") retract verb text
*Second person cancel retract text
*Third person cancel retract text
| The creature will retract into a body part when threatened. It will be unable to move or attack, but enemies will only be able to attack the specified body part. (eg. Turtle, Hedgehog)

Second-person descriptions are used for adventurer mode natural ability. "<pro_pos>" can be used in the descriptions, being replaced with the proper pronoun (or lack thereof) in-game.

Undead curled up creatures are buggy{{bug|11463}}{{bug|10519}}.
|-
| {{text anchor|RETURNS_VERMIN_KILLS_TO_OWNER}}
|
|
| Cat behavior. If it kills a vermin creature and has an owner, it carries the remains in its mouth and drops them at their feet. Requires {{token|HUNTS_VERMIN|c}}, obviously.

|-
| {{text anchor|ROOT_AROUND}}
| Caste
|
*BY_TYPE, BY_CATEGORY or BY_TOKEN
*body type, [[Body_token#CATEGORY|category]], or [[Body_token#BP|token]]
*Second person ("You") verb text
*Third person ("The hen") verb text
| Creature will occasionally root around in the grass, looking for insects. Used for flavor in Adventurer Mode, spawns vermin edible for this creature in Fortress Mode. Creatures missing the specified body part will be unable to perform this action. The action produces a message (visible in adventure mode) in the form:

[creature] [verb text] the [description of creature's location]

In adventure mode, the "rooting around" ability will be included in the "natural abilities" menu, represented by its second person verb text.

|}

{{alphabetical TOC|style=margin: 1em auto;}}

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

|-
| {{text anchor|SAVAGE}}
| Creature
|
| The creature will only show up in "savage" biomes. Has no effect on cavern creatures. Cannot be combined with {{token|GOOD|c}} or {{token|EVIL|c}}.

|-
| {{text anchor|SECRETION}}
| Caste
|
*<[[material token]]>
*<[[Material_definition_token#Material_States|material state]]>
*BY_TOKEN / BY_CATEGORY / BY_TYPE
*<[[Body_token#BP|body part ID]]> / <[[Body_token#CATEGORY|category]]> or ALL / <type (e.g. [[Body_token#GRASP|GRASP]])>
*<[[Body_detail_plan_token#BP_LAYERS|tissue layer]]> or ALL
*<trigger>
| Causes the specified tissue layer(s) of the indicated body part(s) to secrete the designated material. A size 100 ('covering') [[contaminant]] is created over the affected body part(s) in its specified material state (and at the temperature appropriate to this state) when the trigger condition is met, as long as one of the secretory tissue layers is still intact. Valid triggers are:
*'''CONTINUOUS'''
Secretion occurs once every 40 [[time|ticks]] in [[fortress mode]], and every tick in [[adventurer mode]].
*'''EXERTION'''
Secretion occurs continuously (at the rate described above) whilst the creature is at minimum {{Tile|Tired|6:1}} following physical exertion. Note that this cannot occur if the creature has {{token|NOEXERT|c}}.
*'''EXTREME_EMOTION'''
Secretion occurs continuously (as above) whilst the creature is distressed. Cannot occur in creatures with {{token|NOEMOTION|c}}.

|-
| {{text anchor|SELECT_ADDITIONAL_CASTE}}
| Creature
|
*<caste>
| Adds an additional previously defined caste to the selection. Used after {{token|SELECT_CASTE|c}}.

|-
| {{text anchor|SELECT_CASTE}}
| Creature
|
*<caste> or ALL
| Selects a previously defined caste

|-
| {{text anchor|SELECT_MATERIAL}}
| Creature
|
*<[[material token]]>
| Selects a locally defined material. Can be ALL.

|-
| {{text anchor|SELECT_TISSUE}}
| Creature
|
*tissue token
| Selects a tissue for editing.

|-
| {{text anchor|SEMIMEGABEAST}}
| Caste
|
| Essentially the same as {{token|MEGABEAST|c}}, but more of them are created during worldgen. See the [[semi-megabeast]] page for details.

|-
| {{text anchor|SENSE_CREATURE_CLASS}}
| Caste
|
* <[[Creature_token#CREATURE_CLASS|creature class]]>
* [[Tilesets|<tile value or character>]]
* [[Color#Color_values|<foreground color>:<background color>:<foreground brightness>]]
| Gives the creature the ability to sense creatures belonging to the specified [[Creature_token#CREATURE_CLASS|creature class]] even when they lie far beyond line of sight, including through walls and floors. It also appears to reduce or negate the combat penalty of [[Wound#Blindness|blind]] units when fighting creatures they can sense. In [[adventure mode]], the specified tile will be used to represent sensed creatures when they cannot be seen directly.

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

|-
| {{text anchor|SKILL_LEARN_RATE}}
| Caste
|
*<[[skill_token]]>
*<percentage>
| The rate at which this creature learns this skill. Requires {{token|CAN_LEARN|c}} or {{token|INTELLIGENT|c}} to function.

|-
| {{text anchor|SKILL_LEARN_RATES}}
| Caste
|
*<percentage>
| The rate at which this creature learns all skills. Requires {{token|CAN_LEARN|c}} or {{token|INTELLIGENT|c}} to function.

|-
| {{text anchor|SKILL_RATE}}
| Caste
|
*[[skill_token]]
*<% of improvement points gained>
*<unused counter rate>
*<rust counter rate>
*<demotion counter rate>
| Like {{token|SKILL_RATES|c}}, but applies to individual skills instead. Requires {{token|CAN_LEARN|c}} or {{token|INTELLIGENT|c}} to function.

|-
| {{text anchor|SKILL_RATES}}
| Caste
|
*<% of improvement points gained>
*<unused counter rate>
*<rust counter rate>
*<demotion counter rate>
| Affects skill gain and decay. Lower numbers in the last three slots make decay occur faster ([SKILL_RATES:100:1:1:1] would cause rapid decay). The counter rates may also be replaced with NONE.
Default is [SKILL_RATES:100:8:16:16]. Requires {{token|CAN_LEARN|c}} or {{token|INTELLIGENT|c}} to function.

|-
| {{text anchor|SKILL_RUST_RATE}}
| Caste
|
*[[skill_token]]
*value
*value
*value
| The rate at which this skill decays. Lower values cause the skill to decay faster. Requires {{token|CAN_LEARN|c}} or {{token|INTELLIGENT|c}} to function.

|-
| {{text anchor|SKILL_RUST_RATES}}
| Caste
|
*value
*value
*value
| The rate at which all skills decay. Lower values cause the skills to decay faster. Requires {{token|CAN_LEARN|c}} or {{token|INTELLIGENT|c}} to function.

|-
| {{text anchor|SLOW_LEARNER}}
| Caste
|
| Shorthand for {{token|CAN_LEARN|c}} + <code>[[Creature_token#SKILL_LEARN_RATES|[SKILL_LEARN_RATES:50]]]</code>.{{verify}} Used by a number of 'primitive' creatures (like [[ogre]]s, [[giant]]s and [[troglodyte]]s) in the vanilla game. Applicable to player races. Prevents a player from recruiting nobility, even basic ones. Subterranean creatures with this token combined with {{token|EVIL|c}} will become servants of goblins in their civilizations, in the style of [[troll]]s.

|-
| {{text anchor|SMALL_REMAINS}}
| Caste
|
| Creature leaves "[[item token#REMAINS|remains]]" instead of a corpse. Used by [[vermin]].

|-
| {{text anchor|SMELL_TRIGGER}}
| Creature
|
*value
| Determines how keen a creature's sense of smell is - lower is better. At 10000, a creature cannot smell at all.

|-
| {{text anchor|SOLDIER_ALTTILE}}
| Creature
|
*'character' or tile number
| If this creature is active in its civilization's military, it will blink between its default tile and this one.

|-
| {{text anchor|SOUND}}
| Caste
|
* Sound application (currently accepts ALERT or PEACEFUL_INTERMITTENT)
* Sound range (in tiles)
* Sound delay (lower values = sound is produced more often)
* VOCALIZATION or NONE (determines whether the sound requires breathing or not)
* First-person description
* Third-person description
* Description when out of sight
| Creature makes sounds periodically, which can be heard in Adventure mode.
* First-person reads "You '''bark'''"
* Third-person reads "The [[capybara]] '''barks'''"
* Out of sight reads "You hear '''a loud bark'''"
with the text in bold being the description arguments of the token.

|-
| {{text anchor|SOURCE_HFID}}
| Creature
|
*Integer (generic token?)
| Found on generated [[angel]]s. This is the historical figure ID of the deity with which the angel is associated. Since HFIDs are not predictable before worldgen, this isn't terribly usable in mods.

|-
| {{text anchor|SPECIFIC_FOOD}}
| Caste
|
* PLANT or CREATURE
* Plant/creature ID
| Creature will only appear in biomes with this plant or creature available. Grazers given a specific type of grass (such as [[panda]]s and [[bamboo]]) will only eat that grass and nothing else, risking starvation if there's none available.

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

|-
| {{text anchor|SPEECH_FEMALE}}
| Creature
|
*speech file
| Boasting speeches relating to killing females of this creature.

|-
| {{text anchor|SPEECH_MALE}}
| Creature
|
*speech file
| Boasting speeches relating to killing males of this creature.

|-
| {{text anchor|SPHERE}}
| Creature
|
* [[Sphere#Available_spheres|sphere]]
| Sets what religious spheres the creature is aligned to, for purposes of being worshipped via the {{token|POWER|c}} token. Also affects how the creature's name is generated.

|-
| {{text anchor|SPOUSE_CONVERSION_TARGET}}
| Caste
|
| This creature can be converted by a night creature with {{token|SPOUSE_CONVERTER|c}}.

|-
| {{text anchor|SPOUSE_CONVERTER}}
| Caste
|
| If the creature has the {{token|NIGHT_CREATURE_HUNTER|c}} tag, it will kidnap {{token|SPOUSE_CONVERSION_TARGET|c}}s and transform them into the caste of its species with the {{token|CONVERTED_SPOUSE|c}} tag during worldgen. It may also start families this way.

|-
| {{text anchor|SPREAD_EVIL_SPHERES_IF_RULER}}{{version|0.47.01}}
| Caste
|
| If the creature rules over a [[site]], it will cause the local landscape to be corrupted into [[Surroundings#Evil|evil surroundings]] associated with the creature's [[Creature_token#SPHERE|sphere]]s. The creature must have at least one of the following [[sphere]]s for this to take effect: BLIGHT, DEATH, DISEASE, DEFORMITY, NIGHTMARES. The first three kill vegetation, while the others sometimes do. The last two get [[Plant_token#EVIL|evil plants]] and [[Creature_token#EVIL|evil animals]] sometimes. NIGHTMARES gets [[bogeyman|bogeymen]]. [http://www.bay12forums.com/smf/index.php?topic=169696.msg8162224#msg8162224] Used by [[demon]]s in the vanilla game.

|-
| {{text anchor|STANCE_CLIMBER}}
| Caste
|
| Caste does not require <code>[[Body_token#GRASP|[GRASP]]]</code> body parts to climb -- it can climb with <code>[[Body_token#STANCE|[STANCE]]]</code> parts instead.

|-
| {{text anchor|STANDARD_GRAZER}}
| Caste
|
| Acts as {{token|GRAZER|c}} but set to 20000*G*(max size)^(-3/4), where G defaults to 100 but can be set in d_init, and the whole thing is trapped between 150 and 3 million. Used for all grazers in the default creature raws.

|-
| {{text anchor|STRANGE_MOODS}}{{version|0.42.01}}
| Caste
|
| The creature will get [[strange mood]]s in fortress mode and can produce artifacts.

|-
| {{text anchor|SUPERNATURAL}}
| Caste
|
| Gives the creature knowledge of any secrets with <code>[[Interaction_token#IS_SECRET|[SUPERNATURAL_LEARNING_POSSIBLE]]]</code> that match its [[Creature_token#SPHERE|spheres]] and also prevents it from becoming a [[vampire]] or [[werebeast]]. Other effects are unknown.

|-
| {{text anchor|SWIMS_INNATE}}
| Caste
|
| The creature naturally knows how to swim perfectly and does not use the [[swimmer]] skill, as opposed to {{token|SWIMS_LEARNED|c}} below. However, Fortress mode AI never paths into water anyway, so it's less useful there.

|-
| {{text anchor|SWIMS_LEARNED}}
| Caste
|
| The creature swims only as well as their present [[Swimmer|swimming skill]] allows them to.

|-
| {{text anchor|SYNDROME_DILUTION_FACTOR}}{{version|0.42.01}}
| Caste
| <[[Syndrome#SYN_IDENTIFIER|syndrome identifier]]>:<percentage>
| Dilutes the effects of syndromes which have the specified identifier. A percentage of 100 is equal to the regular syndrome effect severity, higher percentages reduce severity.
|}

{{alphabetical TOC|style=margin: 1em auto;}}

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

|-
| {{text anchor|TENDONS}}
| Caste
|
* [[material token]]
*healing rate
| The creature has tendons in its {{token|CONNECTIVE_TISSUE_ANCHOR|td}} tissues (bone or chitin by default). Cutting the bone/chitin tissue severs the tendons, disabling motor function if the target is a limb.

|-
| {{text anchor|THICKWEB}}
| Caste
|
| The creature's [[web]]s can catch larger creatures.

|-
| {{text anchor|TISSUE}}
| Creature
|
*name
| Begins defining a tissue in the creature file.

|-
| {{text anchor|TISSUE_LAYER}}
| Caste
|
*BY_TYPE, BY_CATEGORY, BY_TOKEN
*TYPE,CATEGORY, or TOKEN
*TISSUE
*LOCATION
| Adds the tissue layer to wherever it is required.
Non-argument Locations can be FRONT, RIGHT, LEFT, TOP, BOTTOM. Argument locations are AROUND and CLEANS, requiring a further body part and a % of coverage/cleansing

|-
| {{text anchor|TISSUE_LAYER_OVER}}
| Caste
|
*BY_TYPE, BY_CATEGORY, BY_TOKEN
*TYPE,CATEGORY, or TOKEN
*TISSUE
*LOCATION
| Presumably a counterpart to TISSUE_LAYER_UNDER (see below).

|-
| {{text anchor|TISSUE_LAYER_UNDER}}
| Caste
|
*BY_TYPE, BY_CATEGORY, BY_TOKEN
*TYPE,CATEGORY, or TOKEN
*TISSUE
| Adds the tissue layer under a given part.
For example, an [[iron man]] has a gaseous poison within, and this tissue (GAS is its name) has the token [TISSUE_LEAKS] and its state is GAS, so when you puncture the iron outside and damage this tissue it leaks gas (can have a syndrome by using a previous one in the creature sample.) [TISSUE_LAYER_UNDER:BY_CATEGORY:ALL:{tissue}] {tissue} is what will be under the TISSUE_LAYER; here is an example Tissue from the 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]

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

|-
| {{text anchor|TRADE_CAPACITY}}
| Caste
|
*number
| How much the creature can carry when used by merchants.

|-
| {{text anchor|TRAINABLE}}
| Caste
|
| Shortcut for {{token|TRAINABLE_HUNTING|c}} + {{token|TRAINABLE_WAR|c}}.

|-
| {{text anchor|TRAINABLE_HUNTING}}
| Caste
|
| Can be [[Animal trainer|trained]] as a hunting beast, increasing speed.

|-
| {{text anchor|TRAINABLE_WAR}}
| Caste
|
| Can be [[Animal trainer|trained]] as a war beast, increasing strength and endurance.

|-
| {{text anchor|TRANCES}}
| Caste
|
| Allows the creature to go into [[martial trance]]s. Used by dwarves in the vanilla game.

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

|-
| {{text anchor|TRIGGERABLE_GROUP}}
| Creature
|
*min
*max
| A large swarm of vermin can be disturbed, usually in adventurer mode.{{verify}}

|-
| {{text anchor|TSU_NOUN}}
| Caste
|
*noun
*SINGULAR or PLURAL
| Noun for the {{token|TISSUE_STYLE_UNIT|c}}, used in the description of the tissue layer's style.
|}

{{alphabetical TOC|style=margin: 1em auto;}}

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

|-
| {{text anchor|UBIQUITOUS}}
| Creature
|
| Creature will occur in every region with the correct biome. Does not apply to {{token|EVIL|c}}/{{token|GOOD|c}} tags.

|-
| {{text anchor|UNDERGROUND_DEPTH}}
| Creature
|
*mindepth
*maxdepth
| Depth that the creature appears underground. Numbers can be from 0 to 5. 0 is actually 'above ground' and can be used if the creature is to appear both above and below ground. Values from 1-3 are the respective [[cavern]] levels, 4 is the [[magma sea]] and 5 is the [[HFS]]. A single argument may be used instead of min and max. [[Demon]]s use only 5:5; user-defined creatures with both this depth and {{token|FLIER}} will take part in the initial wave from the HFS alongside generated demons, but without {{token|FLIER}} they will only spawn from the map edges. Civilizations that can use underground plants or animals will only export (via the embark screen or caravans) things that are available at depth 1.

|-
| {{text anchor|UNDERSWIM}}
| Caste
|
| The creature is displayed as blue when in [[Water#Depth|7/7 water]]. Used on fish and amphibious creatures which swim under the water.

|-
| {{text anchor|UNIQUE_DEMON}}
| Caste
|
| 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. Could not be specified in user-defined raws prior to version [[Release_information/0.47.01|0.47.01]].

|-
| {{text anchor|USE_CASTE}}
| Creature
|
*new caste token
*old caste token
| Defines a new caste derived directly from a previous caste. The new caste inherits all properties of the old one. The effect of this tag is automatic if one has not yet defined any castes: "Any caste-level tag that occurs before castes are explicitly declared is saved up and placed on any caste that is declared later, unless the caste is explicitly derived from another caste."

|-
| {{text anchor|USE_MATERIAL}}
| Creature
|
*new material ID
*old material ID
| Defines a new local creature material and populates it with all properties defined in the specified local creature material.

|-
| {{text anchor|USE_MATERIAL_TEMPLATE}}
| Creature
|
*new material token
*material template
| Defines a new local creature material and populates it with all properties defined in the specified template.

|-
| {{text anchor|USE_TISSUE}}
| Creature
|
*new tissue token
*old tissue id
| Defines a new local creature tissue and populates it with all properties defined in the local tissue specified in the second argument.

|-
| {{text anchor|USE_TISSUE_TEMPLATE}}
| Creature
|
*new tissue token
*tissue template
| Loads a tissue template listed in OBJECT:TISSUE_TEMPLATE files, such as tissue_template_default.txt.

|-
| {{text anchor|UTTERANCES}}
| Caste
|
| Changes the language of the creature into unintelligible 'kobold-speak', which creatures of other species will be unable to understand. If a civilized creature has this and is not part of a {{token|SKULKING|e}} civ, it will tend to start wars with all nearby civilizations and will be unable to make peace treaties due to 'inability to communicate'.
|}

{{alphabetical TOC|style=margin: 1em auto;}}

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

|-
| {{text anchor|VEGETATION}}
| Caste
|
| Like {{token|AT_PEACE_WITH_WILDLIFE}}, but also makes the creature more valued in artwork by civilisations with the PLANT [[sphere]]. [http://www.bay12forums.com/smf/index.php?topic=169696.msg8316954#msg8316954] Used by [[grimeling]]s in the vanilla game.

|-
| {{text anchor|VERMIN_BITE}}
| Caste
|
*chance of occurrence{{verify}}
*verb (bitten, stung, etc.)
* [[material token]]
* [[Material_definition_token#Material_States|material state]]
| Enables vermin to bite other creatures, injecting the specified material. See {{token|SPECIALATTACK_INJECT_EXTRACT|c}} for details about injection - this token presumably works in a similar manner.{{verify}}

|-
| {{text anchor|VERMIN_EATER}}
| Creature
|
| The vermin creature will attempt to eat exposed food. See {{token|PENETRATEPOWER|c}}. Distinct from {{token|VERMIN_ROTTER|c}}.

|-
| {{text anchor|VERMIN_FISH}}
| Creature
|
| The vermin appears in [[water]] and will attempt to swim around.

|-
| {{text anchor|VERMIN_GROUNDER}}
| Creature
|
| The creature appears in "general" surface ground locations. Note that this doesn't stop the creature from flying if it can (most vermin birds have this tag).

|-
| {{text anchor|VERMIN_HATEABLE}}
| Caste
|
| Some dwarves will [[Preferences|hate]] the creature and get unhappy thoughts when around it. See the [[Hateable|list of hateable vermin]] for details.

|-
| {{text anchor|VERMIN_MICRO}}
| Caste
|
| This makes the creature move in a swarm of creatures of the same race as it (e.g. swarm of flies, swarm of ants).

|-
| {{text anchor|VERMIN_NOFISH}}
| Caste
|
| The creature cannot be caught by [[fishing]].

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

|-
| {{text anchor|VERMIN_NOTRAP}}
| Caste
|
| The creature cannot be caught in baited [[animal trap]]s; however, a "[[Trapper|catch live land animal]]" task may still be able to capture one if a dwarf finds one roaming around.

|-
| {{text anchor|VERMIN_ROTTER}}
| Creature
|
| The vermin are attracted to rotting stuff and loose food left in the open and cause unhappy thoughts to dwarves who encounter them. Present on flies, knuckle worms, acorn flies, and blood gnats. Speeds up decay?{{verify}}

|-
| {{text anchor|VERMIN_SOIL}}
| Creature
|
| The creature randomly appears near dirt or mud, and may be uncovered by creatures that have the {{token|ROOT_AROUND|c}} interaction such as [[goose|geese]] and [[chicken]]s. Dwarves will ignore the creature when given the "Capture live land animal" task.

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

|-
| {{text anchor|VERMINHUNTER}}
| Caste
|
| Old shorthand for "does cat stuff". Contains {{token|AT_PEACE_WITH_WILDLIFE|c}} + {{token|RETURNS_VERMIN_KILLS_TO_OWNER|c}} + {{token|HUNTS_VERMIN|c}} + {{token|ADOPTS_OWNER|c}}.

|-
| {{text anchor|VESPERTINE}}
| Caste
|
| When set, the creature will only appear in the evening (between 8:00 PM and 10:05 PM) in Adventurer mode.

|-
| {{text anchor|VIEWRANGE}}
| Caste
|
*value
| Value should determine how close you have to get to a critter before it attacks (or prevents adv mode travel etc.) Default is 20.

|-
| {{text anchor|VISION_ARC}}
| Caste
|
*binocular vision arc
*non-binocular vision arc
| The width of the creature's vision arcs, in degrees (i.e. 0 to 360). The first number is binocular vision, the second is non-binocular vision. Binocular vision has a minimum of about 10 degrees, monocular, a maximum of about 350 degrees. Values past these limits will be accepted, but will default to ~10 degrees and ~350 degrees respectively.
|}

{{alphabetical TOC|style=margin: 1em auto;}}

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

|-
| {{text anchor|WAGON_PULLER}}
| Caste
|
| Allows the creature to pull caravan wagons. If a civilization doesn't have access to any, it is restricted to trading with pack animals.

|-
| {{text anchor|WEBBER}}
| Caste
|
* [[material token]]
| Allows the creature to create [[web]]s, and defines what the webs are made of.

|-
| {{text anchor|WEBIMMUNE}}
| Caste
|
| The creature will not get caught in thick [[web]]s. Used by creatures who can shoot thick webs (such as [[giant cave spider]]s) in order to make them immune to their own attacks.
|}

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

|-
| {{text anchor|ATTACK_SKILL}}
| Caste
|
*[[Skill token]]
| Defines the skill used by the attack.

|-
| {{text anchor|ATTACK_VERB}}
| Caste
|
*2nd person
*3rd person
| Descriptive text for the attack.

|-
| {{text anchor|ATTACK_CONTACT_PERC}}
| Caste
|
*% value
| The contact area of the attack, measured in % of the body part's volume. Note that all attack percentages can be more than 100%.

|-
| {{text anchor|ATTACK_PENETRATION_PERC}}
| Caste
|
*% value
| The penetration value of the attack, measured in % of the body part's volume. Requires ATTACK_FLAG_EDGE. Maximum value: 15000.

|-
| {{text anchor|ATTACK_PRIORITY}}
| Caste
|
*MAIN or SECOND
| Usage frequency. MAIN attacks are 100 times more frequently chosen than SECOND. Opportunity attacks ignore this preference.

|-
| {{text anchor|ATTACK_VELOCITY_MODIFIER}}
| Caste
|
*number
| The velocity multiplier of the attack, multiplied by 1000.

|-
| {{text anchor|ATTACK_FLAG_CANLATCH}}
| Caste
|
| Attacks that damage tissue have the chance to latch on in a wrestling hold. The grabbing bodypart can then use the "shake around" wrestling move, causing severe, armor-bypassing tensile damage according to the attacker's body volume.

|-
| {{text anchor|ATTACK_FLAG_WITH}}
| Caste
|
| Displays the name of the body part used to perform an attack while announcing it, e.g. "The weaver punches the bugbat with his right hand".

|-
| {{text anchor|ATTACK_FLAG_EDGE}}
| Caste
|
| The attack is edged, with all the effects on physical resistance and contact area that it entails.

|-
| {{text anchor|ATTACK_PREPARE_AND_RECOVER}}
| Caste
|
* Preparation time
* Recovery time
| Determines the length of time to prepare this attack and until one can perform this attack again. Values appear to be calculated in adventure mode ticks.

|-
| {{text anchor|ATTACK_FLAG_BAD_MULTIATTACK}}
| Caste
|
| Multiple strikes with this attack cannot be performed effectively.

|-
| {{text anchor|ATTACK_FLAG_INDEPENDENT_MULTIATTACK}}
| Caste
|
| Multiple strikes with this attack can be performed with no penalty. The creature will use all attacks with this token at once.

|-
| {{text anchor|SPECIALATTACK_INJECT_EXTRACT}}
| Caste
|
*<[[material token]]>
*<[[Material_definition_token#Material_States|material state]]>
*<min quantity>
*<max quantity>
| When added to an attack, causes the attack to inject the specified material into the victim's bloodstream. Once injected, the material will participate in [[temperature|thermal]] exchange within the creature - injecting something like molten [[iron]] (INORGANIC:IRON:LIQUID) would cause most unmodded creatures to melt (note that some of the injected material also [[contaminant|splatters]] over the bodypart used to carry out the attack, so it should be protected appropriately). If the injected material has an associated [[syndrome]] with the [[Syndrome#SYN_INJECTED|[SYN_INJECTED]]] token, it will be transmitted to the victim. If the attack is blunt, the injected material lacks the [[Material definition token#ENTERS_BLOOD|[ENTERS_BLOOD]]] token, the attacked bodypart has no [[Tissue_definition_token#VASCULAR|[VASCULAR]]] tissues, or the victim is bloodless, the material will splatter over the attacked body part instead.

|-
| {{text anchor|SPECIALATTACK_INTERACTION}}
| Caste
|
*interaction
| When this attack lands successfully, a specified interaction will take effect on the target creature. The attack must break the target creature's skin in order to work. This will take effect in worldgen as well. If the attack would break skin, the interaction will occur '''before the attack actually lands'''.

|-
| {{text anchor|SPECIALATTACK_SUCK_BLOOD}}
| Caste
|
*min
*max
| Successful attack draws out an amount of blood randomized between the min and max value. Beware that this '''will''' trigger any ingestion syndromes attached to the target creature's blood - for example, using this attack on a vampire will turn you into one too.
|}

==Tissue Layer Tokens==
Tissue layers are added to a creature's body parts by the creature tokens [[#TISSUE_LAYER|TISSUE_LAYER]], [[#TISSUE_LAYER_OVER|TISSUE_LAYER_OVER]], [[#TISSUE_LAYER_UNDER|TISSUE_LAYER_UNDER]], and the body detail plan token [[#TL_LAYERS|TL_LAYERS]].

These tissue layers are not the same thing as tissues, which are defined at creature level, but rather applications of the tissues. If the SKIN tissue of a creature is the more general and abstract notion of what skin is for that creature, then a tissue layer may be the "actual" skin on the creature's nose, head, or second toe. As most creatures have more than one body part, tissue layers are normally selected en masse.

Some tissue layer tokens are analogous to tissue definition tokens, e.g. [[#TL_CONNECTS|TL_CONNECTS]] to [[tissue_definition_token#CONNECTS|CONNECTS]].

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

|-
| {{text anchor|SELECT_TISSUE_LAYER}}
| Caste
|
*TISSUE
*BY_CATEGORY, BY_TYPE, BY_TOKEN
*Location - category, type, or token | Selects a tissue at a location
* (optional) FRONT, BACK, LEFT, RIGHT, TOP, BOTTOM, AROUND.
| Begins a selection of tissue layers.
[SELECT_TISSUE_LAYER:HEART:BY_TYPE:HEART]

|-
| {{text anchor|PLUS_TISSUE_LAYER}}
| Caste
|
*TISSUE
*BY_CATEGORY, BY_TYPE, BY_TOKEN
*Location - category, type, or token
| Adds tissue layers to those selected.

|-
| {{text anchor|SET_TL_GROUP}}
| Caste
|
*TISSUE
*BY_CATEGORY, BY_TYPE, BY_TOKEN
*Location - category, type, or token
*tissue
| Begins a selection of tissue layers. Only usable for descriptor and cosmetic purposes.

Research has implied it may be redundant with SELECT_TISSUE_LAYER, as the latter allows for cosmetics as well as "functional" tokens such as TL_MAJOR_ARTERIES. Vanilla raws still use SET_TL_GROUP though, for all cosmetic purposes. More research is needed on this subject.

|-
| {{text anchor|PLUS_TL_GROUP}}
| Caste
|
*BY_CATEGORY, BY_TYPE, BY_TOKEN
*Location - category, type, or token
*tissue
| Adds tissue layers to those selected. Like SET_TL_GROUP, it may be redundant even if used in the vanilla raws.

|-
| {{text anchor|SET_LAYER_TISSUE}}
| Caste
|
*TISSUE
| Sets a selected tissue layer to be made of a different tissue.

|-
| {{text anchor|SHEARABLE_TISSUE_LAYER}}
| Caste
|
* tissue modifier
* required value
| Tissue layer can be sheared for its component material. The specified modifier must be at least of the desired value for shearing to be possible (for example, a [[llama]]'s wool must have a LENGTH of 300 before it is shearable).

|-
| {{text anchor|TISSUE_LAYER_APPEARANCE_MODIFIER}}
| Caste
|
*QUALITY
*lowest
*lower
*low
*median
*high
*higher
*highest
| Sets the range of qualities, including LENGTH, DENSE, HIGH_POSITION, CURLY, GREASY, WRINKLY

|-
| {{text anchor|TISSUE_STYLE_UNIT}}
| Caste
|
*tissue style unit ID
*shaping
| Sets tissue layer to be the target of TISSUE_STYLE token specified for an entity, works only on entity members. Mostly used with tissues HAIR, BEARD, MOUSTACHE, SIDEBURNS.

|-
| {{text anchor|TL_COLOR_MODIFIER}}
| Caste
|
*COLOR
*freq
*COLOR
*freq etc.
| Creates a list of colors/color patterns, giving each a relative frequency. If the given color or pattern does not exist, the tissue is described as being "transparent".

|-
| {{text anchor|TLCM_GENETIC_MODEL}}
| Caste
|
| The way the color modifier is passed on to offspring. May or may not work right now.{{verify}}

|-
| {{text anchor|TLCM_IMPORTANCE}}
| Caste
|
*number
| Presumably modifies the importance of the tissue layer color modifier, for description purposes.
HOWEVER using this appears to remove all mention of colour from creature descriptions. It does not appear in any default creatures.

|-
| {{text anchor|TLCM_NOUN}}
| Caste
|
*name
*SINGULAR or PLURAL
| Names the tissue layer color modifier, and determines the noun. Also used by [[Utility:Stonesense|Stonesense]] for colouring body parts.

|-
| {{text anchor|TLCM_TIMING}}
| Caste
|
*ROOT
*start change window years
*days
*end change window years
*days
| Determines the point in the creature's life when the color change begins and ends.

|-
| {{text anchor|TL_CONNECTS}}
| Caste
|
| Gives the CONNECTS attribute to selected layers.

|-
| {{text anchor|TL_HEALING_RATE}}
| Caste
|
*value
| Changes the HEALING_RATE of the selected tissue layers.

|-
| {{text anchor|TL_MAJOR_ARTERIES}}
| Caste
|
| Gives the "major arteries" attribute to selected layers. Used to add massive bleeding properties to the throat, made from skin.

|-
| {{text anchor|TL_PAIN_RECEPTORS}}
| Caste
|
*value
| Changes the number of pain receptors for selected tissue layers.

|-
| {{text anchor|TL_RELATIVE_THICKNESS}}
| Caste
|
*value
| Changes the relative thickness for selected tissue layers.

|-
| {{text anchor|TL_VASCULAR}}
| Caste
|
*value
| Sets a new VASCULAR value (which modulates bleeding) for selected tissue layers.

|}

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

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

Creature token

2024-09-25T03:30:51Z

DikbutDaGrate: Light_Gen tested, proven, and clarified.

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

The <code>[OBJECT:CREATURE]</code> [[token]] begins the definition of a ''Dwarf Fortress'' [[creature]] [[raw file]]. Each creature definition that follows begins with the {{token|creature|c|creature ID}} token, and the creature's exact properties and behavior are then specified by the use of further creature tokens. All known creature tokens are listed below.

Vanilla creature definitions can be found in <code>[[Game folder|<Dwarf Fortress>]]\data\vanilla\vanilla_creatures\</code>.
Creature ID is also used with [[graphics token]]s to make customizable [[graphics set]]s.

The [[caste]] tokens allow defining sub-species within the broader creature definition, including true biological castes and lesser variations, such as sexes. Creature tokens can either be 'Creature' or 'CASTE-only' type which can only be applied to creature or cast respectively, or 'CASTE' which can be applied to both. In the table bellow, creature type distinguish tokens that can be applied to creature only, cast only and both ('creature', 'CASTE-only', and 'CASTE' respectively)

__NOTOC__
{{clear}}
{{alphabetical TOC|style=margin: 1em auto;}}

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

|-
| {{text anchor|ADOPTS_OWNER}}
| Caste
|
| Prevents tamed creature from being made available for adoption, instead allowing it to automatically adopt whoever it wants. The basic requirements for adoption are intact, and the creature will only adopt individuals who have a [[preference]] for their species. Used by [[cat]]s in the vanilla game. When {{k|v}}iewing a tame creature with this token, the message "This animal isn't interested in your wishes" will appear instead of "This [adorable] animal can't work" or "This animal is waiting to be trained".

|-
| {{text anchor|ALCOHOL_DEPENDENT}}
| Caste
|
| Makes the creature need [[alcohol]] to get through the working day; it will choose to drink booze instead of [[water]] if possible. Going sober for too long reduces speed.

|-
| {{text anchor|ALL_ACTIVE}}
| Caste
|
| Sets the creature to be active during the day, night, and twilight in Adventurer Mode. Seems to be a separate value from {{token|DIURNAL|c}}/{{token|NOCTURNAL|c}}/{{token|CREPUSCULAR|c}}, rather than implying them.{{verify|code}}

|-
| {{text anchor|ALTTILE}}
| Creature
|
*'character' or tile number
| If set, the creature will blink between its {{token|TILE|c}} and its ALTTILE.

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

|-
| {{text anchor|AMPHIBIOUS}}
| Caste
|
| Allows a creature to breathe both in and out of [[water]] (unlike {{token|AQUATIC|c}}) - does not prevent drowning in [[magma]].

|-
| {{text anchor|APP_MOD_DESC_RANGE}}
| Appearance Modifier
|
*Range (6 values, low to high)
| Based on info from [http://www.bay12forums.com/smf/index.php?topic=113762.msg3473069#msg3473069 Wannabehero on the forums]: When used with an appearance modifier token (BP_APPEARANCE_MODIFIER or BODY_APPEARANCE_MODIFIER), tells the game what numeric ranges to map to which descriptors.

The game uses 7 descriptor levels for each modifier, with the center one generally being to omit the thing from the creature description entirely. The six values in APP_MOD_DESC_RANGE define the boundaries between each described range. If this is not specified it uses the numbers 10:50:95:105:150:190.

|-
| {{text anchor|APP_MOD_GENETIC_MODEL}}
| Appearance Modifier
|
*Model (Accepts DOMINANT_MORE, DOMINANT_LESS, and MIX)
| Defines a genetic model for the relevant appearance modifier(s). May or may not do anything significant at present.

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

|-
| {{text anchor|APP_MOD_NOUN}}
| Appearance Modifier
|
*noun
*SINGULAR or PLURAL
| Creates a noun for the appearance, and whether it is singular or plural.

|-
| {{text anchor|APP_MOD_RATE}}
| Appearance Modifier
|
*Rate (integer)
*Scale (DAILY, YEARLY)
*min (growth)
*max (growth)
*start year
*start day
*end year
*end day
| Setting the growth rate of the modifier. The last two tokens can be replaced by NO_END to have growth continue indefinitely.

|-
| {{text anchor|APPLY_CREATURE_VARIATION}}
| Caste
|
*creature variation ID
*(optional) any amount of arbitrary arguments
| Applies the specified [[creature variation token|creature variation]]. See [[Creature_variation_token#Arguments_and_conditional_tokens]] for how the subsequent arguments may be used.

|-
| {{text anchor|APPLY_CURRENT_CREATURE_VARIATION}}
| Special
|
| Applies the effects of all pending {{token|CV_ADD_TAG|c}} and {{token|CV_REMOVE_TAG|c}} tokens that have been defined in the current creature.

|-
| {{text anchor|AQUATIC}}
| Caste
|
| Enables the creature to breathe in water, but causes it to air-drown on dry land.

|-
| {{text anchor|ARENA_RESTRICTED}}
| Caste
|
| Causes the creature to be excluded from the [[object testing arena]]'s creature spawning list. Typically applied to spoileriffic creatures.

|-
| {{text anchor|ARTIFICIAL_HIVEABLE}}
| Creature
|
| Enables the creature to be kept in artificial [[hive]]s by [[beekeeper]]s.

|-
| {{text anchor|AT_PEACE_WITH_WILDLIFE}}
| Caste
|
| Prevents the creature from attacking or frightening creatures with the {{Token|NATURAL|c}} tag.

|-
| {{text anchor|ATTACK}}
| Caste
|
*token
*selection criteria (it's complicated)
| Defines the attack name, and the body part used. See [[#Attack Tokens|below]] for valid subtokens
'''Example:''' 
<code>[ATTACK:GORE:BODYPART:BY_CATEGORY:HORN]</code> 
''GORE'' = name of the attack 
''BODYPART:BY_CATEGORY:HORN'' = the horn is used to attack (presuming the creature has one)

|-
| {{text anchor|ATTACK_TRIGGER}}
| Caste
|
*population
*exported wealth
*created wealth
| Specifies when a [[megabeast]] or [[semi-megabeast]] will attack the fortress. The attacks will start occurring when all of the requirements are met. Setting a value to 0 disables the trigger.

|}

{{alphabetical TOC|style=margin: 1em auto;}}

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

|-
| {{text anchor|BABY}}
| Caste
|
*integer
| Age at which creature is considered a child, the default is zero. One can think of this as the duration of the baby stage.

|-
| {{text anchor|BABYNAME}}
| Caste
|
*singular
*plural
| Defines a new name for a creature in baby state at the caste level. For non-caste-specific baby names, see {{token|GENERAL_BABY_NAME|c}}.

|-
| {{text anchor|BEACH_FREQUENCY}}
| Caste
|
*integer
| Creature may be subject to [[beaching]], becoming stranded on [[Beach|shores]], where they will eventually air-drown. The number indicates the frequency of the occurrence. Presumably requires the creature to be {{token|AQUATIC|c}}. Used by [[orca]]s, [[sperm whale]]s and [[sea nettle jellyfish]] in the vanilla game.

|-
| {{text anchor|BENIGN}}
| Caste
|
| The creature is non-aggressive by default, and will never automatically be engaged by companions or soldiers, running away from any creatures that are not friendly to it, and will only defend itself if it becomes enraged. Can be thought of as the counterpoint of the {{token|LARGE_PREDATOR|c}} tag. When tamed, animals with this tag will be useless for fortress defense.

This and {{token|TRADE_CAPACITY|c}} are required for {{token|PACK_ANIMAL|c}} to function properly, if an animal contains the aforementioned requirements without this tag: items loaded by the merchants will be dropped upon departure.

|-
| {{text anchor|BIOME}}
| Creature
|
* [[biome token]]
| Select a [[biome]] the creature may appear in.

|-
| {{text anchor|BLOOD}}
| Caste
|
* <[[material token]]>
* <[[Material_definition_token#Material_States|material state]]>
| Specifies what the creature's blood is made of.

|-
| {{text anchor|BLOODSUCKER}}
| Caste
|
| Causes [[vampire]]-like behaviour; the creature will suck the [[Creature_token#BLOOD|blood]] of unconscious victims when its [[Syndrome#TIME_SINCE_SUCKED_BLOOD|thirst for blood]] grows sufficiently large. When controlling the creature in adventure mode, this can be done at will. Seems to be required to make the creature denouncable (in-world) as a creature of the night.

|-
| {{text anchor|BODY}}
| Caste
|
*body parts
| Draws body parts from OBJECT:BODY files (such as body_default.txt)
'''Example:''' 
[BODY:BODY_WITH_HEAD_FLAG:HEART:GUTS:BRAIN:MOUTH] 
This is the body from a [[purring maggot]]. It creates a body with head, a heart, some guts, a brain, and a mouth. That's all a maggot needs.

The body parts need to be listed in an order such that any parent part appears before its connected children. For example [BODY:HEART:BODY_WITH_HEAD_FLAG] produces a "Body Token Recognized But Could Not Connect: HEART" error because HEART can't find any UPPERBODY(s) to connect to. Switching the order to [BODY:BODY_WITH_HEAD_FLAG:HEART] fixes the problem because now the UPPERBODY is created before the HEART tries to connect to it.

'''If the body is left undefined, the creature (or caste) will be tagged as [DOES_NOT_EXIST].''' {{verify}}

|-
| {{text anchor|BODY_APPEARANCE_MODIFIER}}
| Caste
|
*ATTRIBUTE
*lowest
*lower
*low
*median
*high
*higher
*highest
| These body modifiers give individual creatures different characteristics. In the case of HEIGHT, BROADNESS and LENGTH, the modifier is also a percentage change to the BODY_SIZE of the individual creature. The seven numbers afterward give a distribution of ranges. Each interval has an equal chance of occurring.
'''Example:''' 
[BODY_APPEARANCE_MODIFIER:HEIGHT:90:95:98:100:102:105:110] 
''HEIGHT'' : marks the height to be changed 
''90:95:98:100:102:105:110'' : sets the range from the shortest (90% of the average height) to the tallest (110% of the average height) creature variation.

|-
| {{text anchor|BODY_DETAIL_PLAN}}
| Caste
|
*PlanName
*Arguments
| Loads a plan from 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:''' 
[BODY_DETAIL_PLAN:VERTEBRATE_TISSUE_LAYERS:SKIN:FAT:MUSCLE:BONE:CARTILAGE] 
This creates the detailed body of a [[fox]], the skin, fat, muscle, bones and cartilage out of the vertebrate tissues. 
A [[Purring maggot|maggot]] would only need: 
''[BODY_DETAIL_PLAN:EXOSKELETON_TISSUE_LAYERS:SKIN:FAT:MUSCLE]''

|-
| {{text anchor|BODY_SIZE}}
| Caste
|
*years
*days
*size
| Sets size at a given age. Size is in cubic centimeters, and for normal body materials, is roughly equal to the creature's average weight in grams.
'''Example:''' 
[BODY_SIZE:0:0:10000] 
[BODY_SIZE:1:168:50000] 
[BODY_SIZE:12:0:220000] 
This describes the size of a [[minotaur]]. Its birth size would be 10,000 cm3 (~10 kg). At 1 year and 168 days old it would be 50,000 cm3 (~50 kg). And as an adult (at 12 years old) it would be 220,000 cm3 and weigh roughly 220 kg.

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

|-
| {{text anchor|BONECARN}}
| Caste
|
| Creature eats bones. Implies {{token|CARNIVORE|c}}. [[Adventurer mode|Adventurers]] with this token are currently unable to eat bones.{{Bug|11069}}

|-
| {{text anchor|BP_ADD_TYPE}}
| Caste
|
| Adds a type to a body part - used with {{token|SET_BP_GROUP|c}}. In vanilla DF, this is used for adding the type '[[Body token#GELDABLE|GELDABLE]]' to the lower body of certain [[cat|creatures]].

|-
| {{text anchor|BP_APPEARANCE_MODIFIER}}
| Caste
|
*QUALITY
*lowest
*lower
*low
*median
*high
*higher
*highest
| Sets up the breadth of possibilities for appearance qualities for a selected BP group. EG. Eyes (CLOSE_SET, DEEP_SET, ROUND_VS_NARROW, LARGE_IRIS),Lips (THICKNESS), Nose (BROADNESS, LENGTH, UPTURNED, CONVEX), Ear (SPLAYED_OUT, HANGING_LOBES, BROADNESS, HEIGHT), Tooth (GAPS), Skull (HIGH_CHEEKBONES, BROAD_CHIN, JUTTING CHIN, SQUARE_CHIN), Neck (DEEP_VOICE, RASPY_VOICE), Head (BROADNESS, HEIGHT)

|-
| {{text anchor|BP_REMOVE_TYPE}}
| Caste
|
| Removes a type from a body part. Used with {{token|SET_BP_GROUP|c}}.

|-
| {{text anchor|BUILDINGDESTROYER}}
| Caste
|
*1 or 2
| Allows a creature to destroy furniture and buildings. Value [1] targets mostly doors, hatches, furniture and the like. Value [2] targets anything not made with the {{k|b}} + {{k|C}} commands.
|}

{{alphabetical TOC|style=margin: 1em auto;}}

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

|-
| {{text anchor|CAN_DO_INTERACTION}}
| Caste
|
*interaction token
| The creature can perform an interaction. See [[interaction token]].

|-
| {{text anchor|CAN_LEARN}}
| Caste
|
| The creature gains [[skill]]s and can have [[labor|professions]]. If a member of a civilization (even a pet) has this token, it'll need to eat, drink and sleep. Note that this token makes the creature unable to be eaten by an adventurer, so it is not recommended for uncivilized monsters. Adventurers lacking this token can allocate but not increase attributes and skills. Skills allocated will disappear on start.

|-
| {{text anchor|CAN_SPEAK}}
| Caste
|
| Can [[talking|talk]]. Note that this is not necessary for a creature to gain social skills.

|-
| {{text anchor|CANNOT_CLIMB}}
| Caste
|
| Creature cannot [[climber|climb]], even if it has free grasp parts.

|-
| {{text anchor|CANNOT_JUMP}}
| Caste
|
| Creature cannot [[jump]].

|-
| {{text anchor|CANNOT_UNDEAD}}
| Caste
|
| Acts like {{token|NOT_LIVING|c}}, except that {{token|OPPOSED_TO_LIFE|c}} creatures will attack them.

|-
| {{text anchor|CANOPENDOORS}}
| Caste
|
| Allows the creature to open [[door]]s that are set to be unpassable for pets. In adventure mode, creatures lacking this token will be unable to pass through door tiles except whilst these are occupied by other creatures. Not currently useful in Fortress mode as doors can no longer be set unpassable for pets.{{version|50.03}}

|-
| {{text anchor|CARNIVORE}}
| Caste
|
| Creature ''only'' eats [[meat]]. If the creature goes on rampages in worldgen, it will often devour the people/animals it kills. Does not seem to affect the diet of the adventurer in adventure mode.

|-
| {{text anchor|CASTE}}
| Creature
|
*name
| Defines a [[caste]].

|-
| {{text anchor|CASTE_ALTTILE}}
| Caste
|
*tile number or "letter"
| Caste-specific {{token|ALTTILE|c}}. Requires {{token|CASTE_TILE|c}}.

|-
| {{text anchor|CASTE_COLOR}}
| Caste
|
*fg
*bg
*brightness
| Caste-specific {{token|COLOR|c}}.

|-
| {{text anchor|CASTE_GLOWCOLOR}}
| Caste
|
*fg
*bg
*brightness
| Caste-specific {{token|GLOWCOLOR|c}}.

|-
| {{text anchor|CASTE_GLOWTILE}}
| Caste
|
*tile value or "letter"
| Caste-specific {{token|GLOWTILE|c}}.

|-
| {{text anchor|CASTE_NAME}}
| Caste
|
*singular
*plural
*adjective
| While {{token|NAME|c}} describes the name of the species, {{token|CASTE_NAME|c}} names individuals of the species. Unlike other caste-specific descriptions, this token is required, even for creatures without separate castes. If left undefined, the creature will not show up in the [[arena]] and members of the species will be labeled as "nothing".

|-
| {{text anchor|CASTE_PROFESSION_NAME}}
| Caste
|
*[[Unit type token]] (Profession)
*singular
*plural
| Caste-specific {{token|PROFESSION_NAME|c}}.

|-
| {{text anchor|CASTE_SOLDIER_ALTTILE}}
| Caste
|
*'character' or tile number
| Caste-specific {{token|SOLDIER_ALTTILE|c}}. Requires {{token|CASTE_SOLDIER_TILE|c}}.

|-
| {{text anchor|CASTE_SOLDIER_TILE}}
| Caste
|
*'character' or tile number
| Caste-specific {{token|CREATURE_SOLDIER_TILE|c}}.

|-
| {{text anchor|CASTE_TILE}}
| Caste
|
* tile number or "letter"
| Caste-specific {{token|CREATURE_TILE|c}}.

|-
| {{text anchor|CAVE_ADAPT}}
| Caste
|
| Causes [[cave adaptation]].
Allows for creature's race to be involved in jokes that end in "And the [race] saw the sun and vomited on the spot!"

|-
| {{text anchor|CDI}}
| Caste
|
*Varies
| Specifies interaction details following a {{token|CAN_DO_INTERACTION|c}} token. See [[interaction token]].

|-
| {{text anchor|CHANGE_BODY_SIZE_PERC}}
| Caste
|
*integer
| Multiplies body size by a factor of (integer)%. 50 halves size, 200 doubles.

|-
| {{text anchor|CHANGE_FREQUENCY_PERC}}
| Creature
|
*integer
| Multiplies frequency by a factor of (integer)%.

|-
| {{text anchor|CHILD}}
| Caste
|
*integer
| Age at which creature is considered an adult - one can think of this as the duration of the [[children|child]] stage. Allows the creature's offspring to be rendered fully tame if [[animal trainer|trained]] during their childhood.

|-
| {{text anchor|CHILDNAME}}
| Caste
|
*singular
*plural
| Defines a new name for a creature in the child state at the caste level. For non-caste-specific child names, see {{token|GENERAL_CHILD_NAME|c}}.

|-
| {{text anchor|CLUSTER_NUMBER}}
| Creature
|
*min
*max
| The minimum/maximum numbers of how many creatures per spawned cluster. Vermin fish with this token in combination with temperate ocean and river biome tokens [http://www.bay12forums.com/smf/index.php?topic=51864.msg1122319#msg1122319 will perform seasonal migrations]. Defaults to 1:1 if not specified.

|-
| {{text anchor|CLUTCH_SIZE}}
| Caste
|
*min
*max
|Number of [[egg]]s laid in one sitting.

|-
| {{text anchor|COLONY_EXTERNAL}}
| Caste
|
| Caste hovers around colony.

|-
| {{text anchor|COLOR}}
| Creature
|
*foreground
*background
*brightness
| Color of the creature's tile. See [[Color]] for usage.

|-
| {{text anchor|COMMON_DOMESTIC}}
| Caste
|
| When combined with any of {{token|PET|c}}, {{token|PACK_ANIMAL|c}}, {{token|WAGON_PULLER|c}} and/or {{token|MOUNT|c}}, the creature is guaranteed to be domesticated by any [[civilization]] with {{token|COMMON_DOMESTIC_PET|e}}, {{token|COMMON_DOMESTIC_PACK|e}}, {{token|COMMON_DOMESTIC_PULL|e}} and/or {{token|COMMON_DOMESTIC_MOUNT|e}} respectively. Such civilizations will always have access to the creature, even in the absence of wild populations. This token is invalid on {{token|FANCIFUL|c}} creatures.

|-
| {{text anchor|CONVERTED_SPOUSE}}
| Caste
|
| Creatures of this caste's species with the {{token|SPOUSE_CONVERTER|c}} and {{token|NIGHT_CREATURE_HUNTER|c}} tokens will kidnap {{token|SPOUSE_CONVERSION_TARGET|c}}s of an appropriate sex and convert them into castes with CONVERTED_SPOUSE.

|-
| {{text anchor|COOKABLE_LIVE}}
| Caste
|
| Set this to allow the creature to be cooked in meals without first being butchered/cleaned. Used by some water-dwelling vermin such as [[mussel]]s, [[nautilus]]es and [[oyster]]s.

|-
| {{text anchor|CRAZED}}
| Caste
|
| Creature is '[[insanity|berserk]]' and will attack all other creatures, except members of its own species that '''also''' have the CRAZED tag. It will show {{DFtext|Berserk|4:1}} in the [[unit list]]. Berserk creatures go on rampages during [[world generation|worldgen]] much more frequently than non-berserk ones.

|-
| {{text anchor|COPY_TAGS_FROM}}
| Special
|
*creature ID
| Copies another specified creature. This will override any definitions made before it; essentially, it makes this creature identical to the other one, which can then be modified. Often used in combination with {{token|APPLY_CREATURE_VARIATION|c}} to import standard variations from a file. The vanilla [[giant animal]]s and [[animal person|animal people]]s are examples of this token combination.

|-
| {{text anchor|CREATURE}}
| Creature
|
*creature ID
| A unique, arbitrary identifier that begins the definition of each new creature, and is used to reference the creature in other tokens and raws.

|-
| {{text anchor|CREATURE_CLASS}}
| Caste
|
*classname
| An arbitrary creature classification. Can be set to anything, but the only vanilla uses are GENERAL_POISON (used in syndromes), EDIBLE_GROUND_BUG (used as targets for {{token|GOBBLE_VERMIN_CLASS|c}}), MAMMAL, and POISONOUS (both used for kobold pet eligibility). A single creature can have multiple classes.

The full list of tokens that use creature classes is:

* Creature tokens: {{token|GOBBLE_VERMIN_CLASS|c}}, {{token|GOBBLE_VERMIN_CLASS|c}}
* Interaction tokens: {{token|IT_AFFECTED_CLASS|in}}, {{token|IT_IMMUNE_CLASS|in}}
* Animal definition (Entity) tokens: {{token|ANIMAL_CLASS|e}}, {{token|ANIMAL_FORBIDDEN_CLASS|e}}
* Position (Entity) token: {{token|ALLOWED_CLASS|po}}
* Syndrome tokens: {{token|SYN_AFFECTED_CLASS|sy}}, {{token|SYN_IMMUNE_CLASS|sy}}, {{token|CE_SENSE_CREATURE_CLASS|sy}}
|-
| {{text anchor|CREATURE_SOLDIER_TILE}}
| Creature
|
*'character' or tile number
| Creatures active in their civilization's [[military]] will use this tile instead.

|-
| {{text anchor|CREATURE_TILE}}
| Creature
|
*'character' or tile number
| The symbol of the creature in ASCII mode.

|-
| {{text anchor|CREPUSCULAR}}
| Caste
|
| Sets the creature to be active at twilight in adventurer mode.

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

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

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

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

|-
| {{text anchor|CV_REMOVE_TAG}}
| Special
|
*TAG NAME
| Removes a tag. Used in conjunction with creature variation templates.
|}

{{alphabetical TOC|style=margin: 1em auto;}}

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

|-
| {{text anchor|DEMON}}
| Caste
|
| Found on generated [[demon]]s. Marks the caste to be used in the initial wave after breaking into the [[underworld]], and by the demon civilizations created during world-gen breachings{{verify}}.

|-
| {{text anchor|DESCRIPTION}}
| Caste
|
*text
| A brief description of the creature type, as displayed when viewing the creature's description/[[Thoughts and preferences|thoughts & preferences]] screen.

|-
| {{text anchor|DIE_WHEN_VERMIN_BITE}}
| Caste
|
| Causes the creature to die upon attacking. Used by [[honey bee]]s to simulate them dying after using their stingers.

|-
| {{text anchor|DIFFICULTY}}
| Caste
|
*integer
| Increases experience gain during adventure mode. Creatures with a difficulty of 11 or higher are not assigned for quests in adventure mode.

|-
| {{text anchor|DIURNAL}}
| Caste
|
| Sets the creature to be active during the day in Adventurer Mode.

|-
| {{text anchor|DIVE_HUNTS_VERMIN}}
| Caste
|
| The creature hunts vermin by diving from the air. On tame creatures, it has the same effect as {{token|HUNTS_VERMIN|c}}. Found on [[peregrine falcon]]s.

|-
| {{text anchor|DOES_NOT_EXIST}}
| Creature
|
| Adding this token to a creature prevents it from appearing in generated worlds (unless it's marked as [[Entity_token#ANIMAL_ALWAYS_PRESENT|always present]] for a particular civilisation). For example, adding it to [[dog]]s will lead to worlds being generated without dogs in them. Also removes the creature from the [[object testing arena]]'s spawn list. If combined with {{token|FANCIFUL|c}}, artistic depictions of the creature will occur regardless. Used by [[centaur]]s, [[chimera]]s and [[griffon]]s in the vanilla game.

Note: a creature tagged as DOES_NOT_EXIST can still be [[Interaction_token#I_EFFECT|summoned]] successfully, as long as it has a body defined in its raws. [http://www.bay12forums.com/smf/index.php?topic=165213.msg8086938#msg8086938]. It's also possible for another creature to [[Syndrome#CE_BODY_TRANSFORMATION|transform]] into it.
|}

{{alphabetical TOC|style=margin: 1em auto;}}

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

|-
| {{text anchor|EBO_ITEM}}
| Caste
|
*[[item token]]
*[[material token]] (ANY_HARD_STONE can be used for the material)
| Defines the item that the creature drops upon being [[butcher|butchered]]. Used with {{token|EXTRA_BUTCHER_OBJECT|c}}.

|-
| {{text anchor|EBO_SHAPE}}
| Caste
|
*gem shape
| The shape of the creature's extra [[butcher|butchering]] drop. Used with {{token|EXTRA_BUTCHER_OBJECT|c}}.

|-
| {{text anchor|EGG_MATERIAL}}
| Caste
|
* <[[material token]]>
* <[[Material_definition_token#Material_States|material state]]>
| Defines the material composition of [[egg]]s laid by the creature. [[creature_token#LAYS_EGGS|Egg-laying]] creatures in the default game define this 3 times, using LOCAL_CREATURE_MAT:EGGSHELL, LOCAL_CREATURE_MAT:EGG_WHITE, and then LOCAL_CREATURE_MAT:EGG_YOLK. Eggs will be made out of eggshell. Edibility is determined by tags on whites or yolk, but they otherwise do not exist.

|-
| {{text anchor|EGG_SIZE}}
| Caste
|
*size
| Determines the size of laid [[egg]]s. Doesn't affect hatching or cooking, but bigger eggs will be heavier, and may take longer to be hauled depending on the hauler's strength.

|-
| {{text anchor|EQUIPMENT_WAGON}}
| Creature
|
| Makes the creature appear as a large 3×3 [[wagon]] responsible for carrying trade goods, pulled by two {{token|WAGON_PULLER|c}} creatures and driven by a merchant.

|-
| {{text anchor|EQUIPS}}
| Caste
|
| Allows the creature to wear or wield items.

|-
| {{text anchor|EVIL}}
| Creature
|
| The creature is considered evil and will only show up in evil biomes. Civilizations with {{token|USE_EVIL_ANIMALS|e}} can domesticate them regardless of exotic status. Has no effect on cavern creatures except to restrict taming. A civilization with evil creatures can colonise evil areas.

|-
| {{text anchor|EXTRA_BUTCHER_OBJECT}}
| Caste
|
* BY_CATEGORY, BY_TYPE, BY_TOKEN
* TYPE, CATEGORY, or TOKEN
| The creature drops an additional object when [[butcher|butchered]], as defined by {{token|EBO_ITEM|c}} and {{token|EBO_SHAPE|c}}. Used for [[gizzard stone]]s in default creatures. For some materials, needs to be defined after caste definitions with SELECT_CASTE:ALL{{Bug|6355}}

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

|-
| {{text anchor|EXTRAVISION}}
| Caste
|
| The creature can see regardless of whether it has working eyes and has full 360 degree vision, making it impossible to strike the creature from a blind spot in combat. Invisible creatures will also be seen, namely [[intelligent undead]] using a "vanish" power.
|}

{{alphabetical TOC|style=margin: 1em auto;}}

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

|-
| {{text anchor|FANCIFUL}}
| Creature
|
| The creature is a thing of legend and known to all civilizations. Its materials cannot be requested or preferred. The tag also adds some art value modifiers. Used by a [[Fanciful|number of creatures]]. Conflicts with {{token|COMMON_DOMESTIC|c}}.

|-
| {{text anchor|FEATURE_ATTACK_GROUP}}
| Caste
|
| Found on [[Animal people#Subterranean animal people|subterranean animal-man]] tribals. Currently defunct. In previous versions{{verify}}, it caused these creatures to crawl out of chasms and underground rivers.

|-
| {{text anchor|FEATURE_BEAST}}
| Caste
|
| Found on [[forgotten beast]]s. Presumably makes it act as such, initiating underground attacks on fortresses, or leads to the pop-up message upon encountering one{{verify}}. Hides the creature from displaying in a world_sites_and_pops file. Does not create historical figures like generated forgotten beasts do.

Requires specifying a {{token|BIOME|c}} in which the creature will live, and both surface and subterranean biomes are allowed. Does not stack with {{token|LARGE_ROAMING|c}} and if both are used the creature will not spawn. Appears to be incompatible with {{token|DEMON|c}} even if used in separate castes.

|-
| {{text anchor|FEMALE}}
| Caste
|
| Makes the creature biologically female, enabling her to [[Breeding|bear young]]. Usually specified inside a caste.

|-
| {{text anchor|FIREIMMUNE}}
| Caste
|
| Makes the creature immune to [[Interaction_token#FIREBALL|FIREBALL]] and [[Interaction_token#FIREJET|FIREJET]] attacks, and allows it to path through high temperature zones, like lava or fires. Does not, by itself, make the creature immune to the damaging effects of burning in [[fire]], and does not prevent general heat damage or melting on its own (this would require adjustments to be made to the creature's body [[Material_definition_token|materials]] - see the [[Dragon/raw|dragon raws]] for an example).

|-
| {{text anchor|FIREIMMUNE_SUPER}}
| Caste
|
| Like {{token|FIREIMMUNE|c}}, but also renders the creature immune to [[Interaction_token#DRAGONFIRE|DRAGONFIRE]] attacks.

|-
| {{text anchor|FISHITEM}}
| Caste
|
| The creature's corpse is a single [[Item_token#FISH_RAW|FISH_RAW]] food item that needs to be cleaned (into a [[Item_token#FISH|FISH]] item) at a [[fishery]] to become edible. Before being cleaned the item is referred to as "raw". The food item is categorized under "fish" on the food and stocks screens, and when uncleaned it is sorted under "raw fish" in the stocks (but does not show up on the food screen).
Without this or {{token|COOKABLE_LIVE|c}}, [[fishing|fished]] vermin will turn into food the same way as non-vermin creatures, resulting in multiple units of food (meat, brain, lungs, eyes, spleen etc.) from a single fished vermin. These units of food are categorized as meat by the game.

|-
| {{text anchor|FIXED_TEMP}}
| Caste
|
*temperature
| The creature's body is constantly at this temperature, heating up or cooling the surrounding area. Alters the temperature of the creature's inventory and all adjacent tiles, [[Temperature|with all the effects that this implies]] - may trigger wildfires at high enough values. Also makes the creature immune to extreme heat or cold, as long as the temperature set is not harmful to the materials that the creature is made from. Corpses and body parts of creatures with a fixed temperature maintain their temperature even after death.

Note that temperatures of 12000 and higher may cause [[path|pathfinding]] issues in fortress mode.

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

|-
| {{text anchor|FLIER}}
| Caste
|
| Allows a creature to fly, independent of it having wings or not. Fortress Mode pathfinding only partially incorporates flying - flying creatures need a land path to exist between them and an area in order to access it, but as long as one such path exists, they do not need to use it, instead being able to fly over intervening obstacles. Winged creatures with this token can lose their ability to fly if their wings are crippled or severed. Winged creatures without this token will be unable to fly. (A 'wing' in this context refers to any body part with its own [[Body_token#FLIER|FLIER]] token).

|-
| {{text anchor|FREQUENCY}}
| Creature
|
*number, max 100
| Determines the chances of a creature appearing within its environment, with higher values resulting in more frequent appearance. Also affects the chance of a creature being brought in a caravan for trading.
This value is used multiply to determine the rarity of animal populations. A creature with [FREQUENCY:50] will appear in 50% of valid biomes, and be present in 50% of the area within those biomes.
When a [[Creature token#CLUSTER_NUMBER|cluster]] spawns, the game effectively considers all creatures that can possibly appear and uses the FREQUENCY value as a ''weight'' - for example, if there are three creatures with frequencies 10/25/50, the creature with [FREQUENCY:50] will appear approximately 58.8% of the time. Defaults to 50 if not specified. Not to be confused with {{token|POP_RATIO|c}}.
|}

{{alphabetical TOC|style=margin: 1em auto;}}

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

|-
| {{text anchor|GAIT}}
| Caste
|
* <gait type>
* <gait name>
* <max [[Gait#Speed|speed]]>
* <build up time>
* <max turning [[Gait#Speed|speed]]>
* <start [[Gait#Speed|speed]]>
* <energy expenditure>
* <gait flag(s)>
| Defines a gait by which the creature can move. See [[Gait]] for more information. Specifically, you likely want to use one of the existing STANDARD_X_GAITS creature variations, as described in [[Gait#Gaits_and_Modding|this subsection]].

* <max speed> indicates the maximum [[Gait#Speed|speed]] achievable by a creature using this gait
* <start speed> indicates the creature's speed when it starts moving using this gait
* <build up time> indicates how long it will take for a creature using this gait to go from <start speed> to <max speed>. For example, a value of 10 means that it should be able to reach the maximum speed by moving 10 [[tile]]s in a straight line over even terrain.
* <max turning speed> indicates the maximum speed permissible when the creature suddenly changes its direction of motion. The creature's speed will be reduced to <max turning speed> if travelling at a higher speed than this before turning.
* <energy expenditure> indicates how energy-consuming the gait is. Higher values cause the creature to tire out faster. Persistent usage of a high-intensity gait will eventually lead to exhaustion and [[Status_icon#Non-flashing|collapse]].

'''NO_BUILD_UP''' can be specified instead of a <start speed> value to make the <max speed> instantly achievable upon initiating movement (this is equivalent to a <build up time> of 0). Note that <build up time> and <max turning speed> are both ignored if specified alongside this (as NO_BUILD_UP trumps <build up time> and preserves <max speed> whilst turning, and <max turning speed> cannot exceed <max speed>) so it is permissible to omit them so long as they are '''both''' omitted together.

It's possible to specify a <start speed> greater than the <max speed>; the moving creature will decelerate towards its <max speed> in this case.

'''valid gait types:'''
*'''WALK''' 
Used for moving normally over ground tiles.

*'''CRAWL''' 
Used for moving over ground tiles whilst [[Status_icon#Non-flashing|prone]].

*'''SWIM''' 
Used for moving through tiles containing [[water]] or [[magma]] at a [[Water#Depth|depth]] of at least 4/7.

*'''FLY''' 
Used for moving through [[open space]].

*'''CLIMB''' 
Used for moving whilst [[Climber|climbing]].

'''valid gait flags:'''
* '''AGILITY''' 
Speeds/slows movement depending on the creature's [[Attribute#Agility|Agility]] stat.

* '''STRENGTH''' 
Speeds/slows movement depending on the creature's [[Attribute#Strength|Strength]] stat.

* '''LAYERS_SLOW''' 
Makes [[Tissue_definition_token#THICKENS_ON_ENERGY_STORAGE|THICKENS_ON_ENERGY_STORAGE]] and [[Tissue_definition_token#THICKENS_ON_STRENGTH|THICKENS_ON_STRENGTH]] tissue layers slow movement depending on how thick they are. Adding the STRENGTH gait flag counteracts the impact of the latter layer.

* '''STEALTH_SLOWS:'''<percentage> 
Slows movement by the specified percentage when the creature is [[Ambusher|sneaking]].

|-
| {{text anchor|GENERAL_BABY_NAME}}
| Creature
|
*singular
*plural
| Like {{token|BABYNAME|c}}, but applied regardless of caste.

|-
| {{text anchor|GENERAL_CHILD_NAME}}
| Creature
|
*singular
*plural
| Like {{token|CHILDNAME|c}}, but applied regardless of caste.

|-
| {{text anchor|GENERAL_MATERIAL_FORCE_MULTIPLIER}}
| Caste
|
*value A
*value B
| Has the same function as {{token|MATERIAL_FORCE_MULTIPLIER|c}}, but applies to all attacks instead of just those involving a specific material. Appears to be overridden by MATERIAL_FORCE_MULTIPLIER ([[werebeast]]s, for example, use both tokens to provide resistance to all materials, with one exception to which they are especially vulnerable).

|-
| {{text anchor|GENERATED}}
| Creature
|
| Found on procedurally generated creatures like [[forgotten beast]]s, [[titan]]s, [[demon]]s, [[angel]]s, and [[night creature]]s. Cannot be specified in user-defined raws.

|-
| {{text anchor|GETS_INFECTIONS_FROM_ROT}}
| Caste
|
| Makes the creature get [[Health_care#Infection|infections]] from necrotic tissue.

|-
| {{text anchor|GETS_WOUND_INFECTIONS}}
| Caste
|
| Makes the creature's wounds become [[Health_care#Infection|infected]] if left untreated for too long.

|-
| {{text anchor|GLOWCOLOR}}
| Creature
|
*foreground
*background
*brightness
| The colour of the creature's {{token|GLOWTILE|c}}.

|-
| {{text anchor|GLOWTILE}}
| Creature
|
*ascii character
| If present, the being glows in the dark (generally used for Adventurer 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 {{token|CASTE_GLOWTILE|c}} instead.

|-
| {{text anchor|GNAWER}}
| Caste
|
*verb
| The creature can and will gnaw its way out of [[animal trap]]s and [[cage]]s using the specified verb, depending on the material from which it is made (normally wood).

|-
| {{text anchor|GOBBLE_VERMIN_CLASS}}
| Caste
|
*class
| The creature eats vermin of the specified class.

|-
| {{text anchor|GOBBLE_VERMIN_CREATURE}}
| Caste
|
*creature
*caste
| The creature eats a specified [[vermin]].

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

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

|-
| {{text anchor|GO_TO_TAG}}
| Special
|
| When using tags from an existing creature, inserts new tags ''before'' the specified tag.

|-
| {{text anchor|GOOD}}
| Creature
|
| Creature is considered good and will only show up in good biomes - [[unicorn]]s, for example. Civilizations with {{token|USE_GOOD_ANIMALS|e}} can domesticate them regardless of exotic status. Has no effect on cavern creatures except to restrict taming. A civilization that has good creatures can colonise good areas in world-gen.

|-
| {{text anchor|GRASSTRAMPLE}}
| Caste
|
*value
| The value determines how rapidly [[grass]] is trampled when a creature steps on it - a value of 0 causes the creature to never damage grass, while a value of 100 causes grass to be trampled as rapidly as possible. Defaults to 5.

|-
| {{text anchor|GRAVITATE_BODY_SIZE}}
| Caste
|
*target value
| Used in Creature Variants. This token changes the adult body size to the average of the old adult body size and the target value and scales all intermediate growth stages by the same factor.

|-
| {{text anchor|GRAZER}}
| Caste
|
*number
| The creature is a grazer - if tamed in fortress mode, it needs a pasture to survive. The higher the number, the less frequently it needs to eat in order to live. Not used since 0.40.12, replaced by {{token|STANDARD_GRAZER|c}} to fix {{bugl|4113}}.
|}

{{alphabetical TOC|style=margin: 1em auto;}}

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

|-
| {{text anchor|HABIT}}
| Caste
|
*type
*probability
| Defines certain behaviors for the creature. The habit types are:
*COLLECT_TROPHIES
*COOK_PEOPLE
*COOK_VERMIN
*GRIND_VERMIN
*COOK_BLOOD
*GRIND_BONE_MEAL
*EAT_BONE_PORRIDGE
*USE_ANY_MELEE_WEAPON
*GIANT_NEST
*COLLECT_WEALTH.
These require the creature to have a {{token|LAIR|c}} to work properly, and also don't seem to work on creatures who are not a {{token|SEMIMEGABEAST|c}}, {{token|MEGABEAST|c}}, or{{token|NIGHT_CREATURE_HUNTER|c}}.

|-
| {{text anchor|HABIT_NUM}}
| Caste
|
*number or TEST_ALL
| "If you set HABIT_NUM to a number, it should give you that exact number of habits according to the weights.".{{cite forum|60554/1719248}} All lists of HABITs are preceded by [HABIT_NUM:TEST_ALL]

|-
| {{text anchor|HAS_NERVES}}
| Caste
|
| The creature has nerves in its muscles. Cutting the muscle tissue can sever motor and sensory nerves.

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

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

|-
| {{text anchor|HOMEOTHERM}}
| Caste
|
*number or NONE
| Default 'NONE'. The creature's normal body [[temperature]]. Creature ceases maintaining temperature on death unlike fixed material temperatures. Provides minor protection from environmental temperature to the creature.

|-
| {{text anchor|HUNTS_VERMIN}}
| Caste
|
| Creature hunts and kills nearby [[vermin]], randomly walking between places with food laying on the ground or in stockpiles, to check for possible [VERMIN_EATER] vermin, but they'll kill any other vermin too. Do not include this creature token on an intelligent entity that you intend to play as in fortress mode because it will prevent them from feeding themselves.

|}

{{alphabetical TOC|style=margin: 1em auto;}}

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

|-
| {{text anchor|IMMOBILE}}
| Caste
|
| The creature cannot move. Found on [[sponge]]s. Will also stop a creature from breeding in fortress mode (MALE and FEMALE are affected, if one is IMMOBILE no breeding will happen).

|-
| {{text anchor|IMMOBILE_LAND}}
| Caste
|
| The creature is immobile while on land. Only works on {{token|AQUATIC|c}} creatures which can't breathe on land.

|-
| {{text anchor|IMMOLATE}}
| Caste
|
| The creature radiates [[fire]]. It will ignite, and potentially completely destroy, items the creature is standing on. Also gives the vermin a high chance of escaping from [[animal trap]]s and [[cage]]s made of any flammable materials (specifically ones that could be ignited by magma).

|-
| {{text anchor|INTELLIGENT}}
| Caste
|
| Alias for {{token|CAN_SPEAK|c}} + {{token|CAN_LEARN|c}}.

|-
| {{text anchor|ITEMCORPSE}}
| Caste
|
* [[item token]]
* [[material token]]
| Determines if the creature leaves behind a non-standard corpse (i.e. wood, statue, bars, stone, pool of liquid, etc.). [[Ethics]] may prevent actually using the item in jobs or reactions.

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

{{alphabetical TOC|style=margin: 1em auto;}}

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

|-
| {{text anchor|LAIR}}
| Caste
|
*type
*probability
| Found on megabeasts, semimegabeasts, and night creatures. The creature will seek out sites of this type and take them as lairs. The lair types are:
*SIMPLE_BURROW
*SIMPLE_MOUND
*WILDERNESS_LOCATION
*SHRINE
*LABYRINTH

|-
| {{text anchor|LAIR_CHARACTERISTIC}}
| Caste
|
*characteristic
*probability
| Defines certain features of the creature's lair. The only valid characteristic is HAS_DOORS.

|-
| {{text anchor|LAIR_HUNTER}}
| Caste
|
| This creature will actively hunt adventurers in its lair.

|-
| {{text anchor|LAIR_HUNTER_SPEECH}}
| Caste
|
*speech file
| What this creature says while hunting adventurers in its lair.

|-
| {{text anchor|LARGE_PREDATOR}}
| Caste
|
| Will attack other creatures that are smaller than it. In [[fortress mode]], only one group of "large predators" (possibly two groups on "savage" maps) will appear on any given map. In [[adventurer mode]], large predators will try to ambush and attack you (and your party will attack them back). When tamed, large predators tend to be much more aggressive to enemies than non-large predators, making them a good choice for an animal army. They may go on rampages in worldgen, and adventurers may receive quests to kill them. Also, they can be mentioned in the intro paragraph when starting a fortress e.g. "ere the wolves get hungry."
A single biome supports 7 large predator species, picking randomly and rolling a d100 under its {{token|FREQUENCY|c}} to add it until all 7 slots are filled.

Incompatible with {{token|PACK_ANIMAL|c}} on a technicality, if included: hauled items are likely to be dropped upon entering the map (even if {{token|TRADE_CAPACITY|c}} is present) in contrast to when the merchants depart.

|-
| {{text anchor|LARGE_ROAMING}}
| Creature
|
| This is the core requisite tag allowing the creature to spawn as a wild animal in the appropriate biomes. Requires specifying a {{token|BIOME|c}} in which the creature will spawn. Does not require specifying a frequency, population number, or cluster number.

This tag stacks with {{token|MEGABEAST|c}}, {{token|SEMIMEGABEAST|c}}, or {{token|NIGHT_CREATURE_HUNTER|c}}; if used with one of these tags, the creature will spawn as both a boss and as a wild animal. This tag does not stack with {{token|FEATURE_BEAST|c}} and if both are used the creature will not spawn. This tag is unaffected by {{token|DEMON|c}}.

|-
| {{text anchor|LAYS_EGGS}}
| Caste
|
| Creature lays [[egg]]s instead of giving birth to live young.

|-
| {{text anchor|LAYS_UNUSUAL_EGGS}}
| Caste
|
* [[item token]]
* [[material token]]
| Creature lays the specified item instead of regular eggs.

|-
| {{text anchor|LIGAMENTS}}
| Caste
|
* [[material token]]
*healing rate
| The creature has ligaments in its {{token|CONNECTIVE_TISSUE_ANCHOR|td}} tissues (bone or chitin by default). Cutting the bone/chitin tissue severs the ligaments, disabling motor function if the target is a limb.

|-
| {{text anchor|LIGHT_GEN}}
| Caste
|
| A vermin featuring this tag will remain visible to an adventurer, even at night, and from a distance. Subterrain vermin which feature this token will flicker in unexposed and unrevealed cavern layers while playing in Fort Mode.
|-
| {{text anchor|LIKES_FIGHTING}}
| Caste
|
| The creature will attack enemies rather than flee from them. This tag has the same effect on player-controlled creatures - including modded dwarves. Retired as of v0.40.14 in favor of {{token|LARGE_PREDATOR|c}}.

|-
| {{text anchor|LISP}}
| Caste
|
| Creature uses "sssssnake talk" (multiplies 'S' when talking - "My name isss Recisssiz."). Used by [[Serpent man|serpent men]] and [[Reptile man|reptile men]] in the vanilla game. C's with the same pronunciation (depending on the word) are not affected by this token.

|-
| {{text anchor|LITTERSIZE}}
| Caste
|
* minimum
* maximum
| Determines the number of offspring per one birth; default 1-3, not used in vanilla raws. See also {{token|MULTIPLE_LITTER_RARE|c}}.

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

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

|-
| {{text anchor|LOCKPICKER}}
| Caste
|
| Lets a creature open [[door]]s that are set to forbidden in fortress mode.

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

|-
| {{text anchor|LOW_LIGHT_VISION}}
| Caste
|
*number
| Determines how well a creature can see in the dark - higher is better. Dwarves have 10000, which amounts to perfect nightvision.
|}

{{alphabetical TOC|style=margin: 1em auto;}}

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

|-
| {{text anchor|MAGICAL}}
| Caste
|
| According to Toady One, this is completely interchangeable with {{token|AT_PEACE_WITH_WILDLIFE|c}} and might have been used in very early versions of the game by wandering wizards or the ent-type tree creatures that used to be animated by elves. [http://www.bay12forums.com/smf/index.php?topic=169696.msg8316954#msg8316954]

|-
| {{text anchor|MAGMA_VISION}}
| Caste
|
| The creature is able to see while submerged in [[magma]].

|-
| {{text anchor|MALE}}
| Caste
|
| Makes the creature biologically male. Usually declared inside a caste.

|-
| {{text anchor|MANNERISM|MANNERISM_*}}
| Caste
|
*occasionally body part
| Adds a possible mannerism to the creature's profile. See [[creature mannerism token]] for further info.

|-
| {{text anchor|MATERIAL}}
| Creature
|
*material id
| Begins defining a new local material. Follow this with standard material definition tokens to define the material.

|-
| {{text anchor|MATERIAL_FORCE_MULTIPLIER}}
| Caste
|
*[[Material token]]
*value A
*value B
| When struck with a weapon made of the specified material, the force exerted will be multiplied by A/B, thus making the creature more or less susceptible to this material. For example, if A is 2 and B is 1, the force exerted by the defined material will be doubled. If A is 1 and B is 2, it will be halved instead. See also {{token|GENERAL_MATERIAL_FORCE_MULTIPLIER|c}}, which can be used to make this sort of effect applicable to all materials.

|-
| {{text anchor|MATUTINAL}}
| Caste
|
| Sets the creature to be active at dawn in adventurer mode.

|-
| {{text anchor|MAXAGE}}
| Caste
|
*min
*max
| Determines the creature's natural lifespan, using the specified minimum and maximum age values (in years). Each individual creature with this token is generated with a predetermined date (calculated down to the exact [[time|tick]]!) between these values, at which it is destined to die of old age, should it live long enough. Note that the probability of death at any given age does not increase as the creature gets older [http://i.imgur.com/A1A4aA9.png].
Creatures which lack this token are naturally immortal. The [[Syndrome#CE_ADD_TAG|NO_AGING]] syndrome tag will prevent death by old age from occurring. Also note that, among civilized creatures, castes which lack this token will refuse to marry others with it, and vice versa.

|-
| {{text anchor|MEANDERER}}
| Caste
|
| Makes the creature slowly stroll around, unless it's in combat or performing a job. If combined with {{token|CAN_LEARN|c}}, will severely impact their [[pathfinding]] and lead the creature to move extremely slowly when not performing any task. Problematically applies to animal people based on the animal and war trained animals{{bug|9588}}.

|-
| {{text anchor|MEGABEAST}}
| Caste
|
| A 'boss' creature. A small number of the creatures are created during worldgen, their histories and descendants (if any) will be tracked in worldgen (as opposed to simply 'spawning'), and they will occasionally go on rampages, potentially leading to worship if they attack the same place multiple times. Their presence and number will also influence age names. When appearing in fortress mode, they will have a pop-up message announcing their arrival. They will remain hostile to military even after being tamed.{{bug|10731}} See [[megabeast]] page for more details.

Requires specifying a {{token|BIOME|c}} in which the creature will live. Subterranean biomes appear to not be allowed. Does stack with {{token|LARGE_ROAMING|c}} and if both are used the creature will spawn as both historical bosses and as wild animals.

|-
| {{text anchor|MENT_ATT_CAP_PERC}}
| Caste
|
*[[Attribute|ATTRIBUTE]] Token
*Cap %
|Default is 200. This means you can increase your attribute to 200% of its starting value (or the average value + your starting value if that is higher).

|-
| {{text anchor|MENT_ATT_RANGE}}
| Caste
|
*[[Attribute|ATTRIBUTE]]
*lowest
*lower
*low
*median
*high
*higher
*highest
| Sets up a [[Attribute#Soul_attributes|mental attribute]]'s range of values (0-5000). All mental attribute ranges default to 200:800:900:1000:1100:1300:2000.

|-
| {{text anchor|MENT_ATT_RATES}}
| Caste
|
*[[Attribute|ATTRIBUTE]] Token
*cost to improve
*unused counter rate
*rust counter rate
*demotion counter rate
| [[Attribute#Soul_attributes|Mental attribute]] gain/decay rates. Lower numbers in the last three slots make decay occur faster. Defaults are 500:4:5:4.

|-
| {{text anchor|MILKABLE}}
| Caste
|
* [[material token]]
* frequency
| Allows the creature to be [[milk]]ed in the [[farmer's workshop]]. The frequency is the amount of [[time|ticks]] the creature needs to "recharge" (i.e. how much time needs to pass before it can be milked again). Does not work on [[#CAN_LEARN|sentient]] creatures, regardless of [[ethics]].

|-
| {{text anchor|MISCHIEVIOUS}}
| Caste
|
| Alias for {{token|MISCHIEVOUS|c}}.

|-
| {{text anchor|MISCHIEVOUS}}
| Caste
|
| The creature spawns [[stealth]]ed and will attempt to path into the fortress, pulling any [[lever]]s it comes across. It will be invisible on the map and [[unit list]] until spotted by a citizen, at which point the game will pause and recenter on the creature. Used by [[gremlin]]s in the vanilla game. "They go on little missions to mess with various fortress buildings, not just levers."

|-
| {{text anchor|MODVALUE}}
| Caste
|
| Seemingly no longer used.

|-
| {{text anchor|MOUNT}}
| Caste
|
| Creature may be used as a [[mount]]. No use for the player in fortress mode, but enemy sieging forces may arrive with cavalry. Mounts are usable in adventure mode.

|-
| {{text anchor|MOUNT_EXOTIC}}
| Caste
|
| Creature may be used as a [[mount]], but civilizations cannot domesticate it in worldgen without certain exceptions.

|-
| {{text anchor|MULTIPART_FULL_VISION}}
| Caste
|
| Allows the creature to have all-around vision, as long as it has multiple heads that can see.

|-
| {{text anchor|MULTIPLE_LITTER_RARE}}
| Caste
|
| Makes the species usually produce a single offspring per birth, with a 1/500 chance of using the {{token|LITTERSIZE|c}} as usual. Requires {{token|FEMALE|c}}.

|-
| {{text anchor|MUNDANE}}
| Creature
|
| Marks if the creature is an actual real-life creature. Only used for age-names at present.
|}

{{alphabetical TOC|style=margin: 1em auto;}}

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

|-
| {{text anchor|NAME}}
| Creature
|
*singular
*plural
*adjective
| The generic name for any creature of this type - will be used for referring to the species in the abstract, such as the default material prefix. For labeling individual creatures, {{token|CASTE_NAME|c}} is necessary. If left undefined, the creature will be labeled as "nothing" by the game.

Some examples of adjective use:
* "super''dwarven'' strength"
* "the ''dwarven'' hillocks of X"
* Deity species as in "''feline'' deity"
* Megabeast attacks in worldgen. One with multiple dragons being a "''draconic'' rampage"

|-
| {{text anchor|NATURAL}}
| Caste
|
| Animal is considered to be natural. NATURAL animals will not engage creatures tagged with {{token|AT_PEACE_WITH_WILDLIFE|c}} in combat unless they are members of a hostile entity and vice-versa.

|-
| {{text anchor|NATURAL_ANIMAL}}
| Caste
|
| Alias of {{token|NATURAL|c}}.

|-
| {{text anchor|NATURAL_SKILL}}
| Caste
|
*[[Skill_token|Skill token]]
*value
| The creature possesses the specified [[skill]] at this level inherently - that is, it begins with the skill at this level, and the skill may never rust below that. A value of 15 is legendary.

|-
| {{text anchor|NIGHT_CREATURE}}
| Caste
|
| Creatures with this token can appear on [[experiment|experiments]].
Prevents {{token|LOCAL_POPS_PRODUCE_HEROES|c}} from functioning. Causes the creature to count as {{token|NOT_LIVING|c}}. Killing a creature featuring this token provides one point of "hero" reputation. Adds the creature's description as part of the initial summary of their historical figure in legends. Prevents creature behavior enabled by {{token|LARGE_PREDATOR|c}}. People will react to creatures with this token as a night creature (natch). In adventure mode, ambushes involving these units will say "Night creature!" instead of "Ambush!"

Prevents the AI from using ANIMATE interactions unless the newly-animated opposed-to-life undead will not attack them. The check for this is specifically whether the unit is:
*a ghost
*an animated unit
*a unit with the {{token|NO_AGING|c}} token added via {{token|CE_ADD_TAG|c}}. (This allows for the default exclusion of elves and goblins, unless raised as intelligent undead.)

''This token should not be confused with other NIGHT_CREATURE_X tokens.''
''This token is not well understood at the present time.''

|-
| {{text anchor|NIGHT_CREATURE_BOGEYMAN}}
| Caste
|
| Creatures with this token can appear in [[bogeyman|bogeyman ambushes]] in [[adventure mode]], where they adopt classical bogeyman traits such as stalking the adventurer and vaporising when dawn breaks. Such traits do not manifest if the creature is encountered outside of a bogeyman ambush (for instance, as a megabeast or a civilised being). In addition, their corpses and severed body parts turn into [[smoke]] after a short while. Note that setting the "Number of Bogeyman Types" in [[advanced world generation]] to 0 will only remove randomly-generated bogeymen.

|-
| {{text anchor|NIGHT_CREATURE_EXPERIMENTER}}
| Caste
|
| Found on some [[necromancer]]s. Creatures with this tag may periodically "perform horrible experiments" offscreen, during which they can use creature-targeting interactions with an <code>[[Interaction_token#I_SOURCE|[I_SOURCE:EXPERIMENT]]]</code> tag on living creatures in their area. Worlds are generated with a list of procedurally-generated experiments, allowing necromancers to turn living people and animals into [[Infected_ghoul|ghouls]] and [[Experiment|other experimental creatures]], and these will automatically be available to all experimenters; it does not appear possible to prevent this. You can mod in your own custom experiment interactions, but these are used very infrequently due to the large number of generated experiments.

|-
| {{text anchor|NIGHT_CREATURE_HUNTER}}
| Caste
|
| Found on [[night troll]]s and [[werebeast]]s. Implies that the creature is a [[night creature]], and shows its description in [[legends mode]] entry. The creature is always hostile and will start [[no quarter]] combat with any nearby creatures, except for members of its own race. Note that this tag does not override the creature's normal behavior in [[fortress mode]] except for the aforementioned aggression, and doesn't prevent the creature from fleeing the battles it started. It also removes the creature's materials from stockpile settings list, making them be stored there regardless of settings.

Does stack with {{token|LARGE_ROAMING|c}} and if both are used the creature will spawn as both historical hunters and as wild animals; this requires specifying a {{token|BIOME|c}} in which the creature will live, and subterranean biomes are allowed.

This tag causes the usual behaviour of werebeasts in worldgen, that is, fleeing towns upon being cursed and conducting raids from a lair. If this tag is absent from a deity curse, the accursed will simply be driven out of towns in a similar manner to [[vampire]]s. When paired with SPOUSE_CONVERTER, a very small population of the creature will be created during worldgen (sometimes only a single individual will be created), and their histories will be tracked (that is, they will not spawn spontaneously later, they must either have children or convert other creatures to increase their numbers). The creature will settle in a lair and go on rampages during worldgen. It will actively attempt to seek out potential conversion targets to abduct, convert, and have children with (if possible).

|-
| {{text anchor|NIGHT_CREATURE_NIGHTMARE}}
| Caste
|
| Found on [[nightmare]]s. Corpses and severed body parts derived from creatures with this token turn into [[smoke]] after a short while.

|-
| {{text anchor|NO_AUTUMN}}
| Caste
|
| The creature caste does not appear in [[Calendar|autumn]].

|-
| {{text anchor|NO_CONNECTIONS_FOR_MOVEMENT}}
| Caste
|
| Creature doesn't require connected body parts to move{{verify}}; generally used on undead creatures with connections that have rotted away.

|-
| {{text anchor|NO_DIZZINESS}}
| Caste
|
| Creature cannot become [[Symptom#Dizziness|dizzy]].

|-
| {{text anchor|NO_DRINK}}
| Caste
|
| Creature does not need to drink.

|-
| {{text anchor|NO_EAT}}
| Caste
|
| Creature does not need to [[food|eat]]. Seems to cause worldgen crashes if it is part of an entity with [[entity_token#PERMITTED_JOB|[PERMITTED_JOB:FISHERMAN]]]{{verify}}

|-
| {{text anchor|NO_FEVERS}}
| Caste
|
| Creature cannot suffer [[Symptom#Fever|fevers]].

|-
| {{text anchor|NO_GENDER}}
| Caste
|
| The creature is biologically sexless, making it unable to [[breeding|breed]].

|-
| {{text anchor|NO_PHYS_ATT_GAIN}}
| Caste
|
| The creature cannot raise any [[Attribute#Body_attributes|physical attributes]].

|-
| {{text anchor|NO_PHYS_ATT_RUST}}
| Caste
|
| The creature cannot lose any [[Attribute#Body_attributes|physical attributes]].

|-
| {{text anchor|NO_SLEEP}}
| Caste
|
| Creature does not need to sleep, but can still be rendered unconscious by other means.

|-
| {{text anchor|NO_SPRING}}
| Caste
|
| The creature caste does not appear in [[Calendar|spring]].

|-
| {{text anchor|NO_SUMMER}}
| Caste
|
| The creature caste does not appear in [[Calendar|summer]].

|-
| {{text anchor|NO_THOUGHT_CENTER_FOR_MOVEMENT}}
| Caste
|
| Creature doesn't require an organ with the {{token|THOUGHT|body}} tag to survive or attack; generally used on creatures that don't have brains.

|-
| {{text anchor|NO_UNIT_TYPE_COLOR}}
| Caste
|
| Prevents creature from selecting its color based on its profession (e.g. Miner, Hunter, Wrestler).

|-
| {{text anchor|NO_VEGETATION_PERTURB}}
| Caste{{Verify}}
|
| Likely prevents the creature from leaving broken vegetation tracks.{{Verify}}

|-
| {{text anchor|NO_WINTER}}
| Caste
|
| The creature caste does not appear in [[Calendar|winter]].

|-
| {{text anchor|NOBONES}}
| Caste
|
| Creature has no bones.

|-
| {{text anchor|NOBREATHE}}
| Caste
|
| Creature doesn't need to breathe or have {{token|BREATHE|body}} parts in body, nor can it drown or be strangled. Creatures living in magma must have this tag, otherwise they will drown.

|-
| {{text anchor|NOCTURNAL}}
| Caste
|
| Sets the creature to be active at night in adventure mode.

|-
| {{text anchor|NOEMOTION}}
| Caste
|
| Creature has no emotions. It is immune to the effects of [[stress]] and unable to rage, and its [[need]]s cannot be fulfilled in any way. Used on [[undead]] in the vanilla game.

|-
| {{text anchor|NOEXERT}}
| Caste
|
| Creature can't become tired or over-exerted from taking too many combat actions, or moving at full speed for extended periods of time.

|-
| {{text anchor|NOFEAR}}
| Caste
|
| Creature doesn't feel fear and will never flee from battle, and will be immune to [[ghost]]s' attempts to 'scare it to death'. Additionally, it causes [[bogeyman|bogeymen]] and [[nightmare]]s to become friendly towards the creature.

|-
| {{text anchor|NOMEAT}}
| Caste
|
| Creature will not be hunted or fed to wild beasts.

|-
| {{text anchor|NONAUSEA}}
| Caste
|
| Creature isn't nauseated by gut hits and cannot vomit.

|-
| {{text anchor|NOPAIN}}
| Caste
|
| Creature doesn't feel pain.

|-
| {{text anchor|NOSKIN}}
| Caste
|
| Creature will not drop a hide when [[butcher|butchered]].

|-
| {{text anchor|NOSKULL}}
| Caste
|
| Creature will not drop a skull on butchering, rot, or decay of severed head.

|-
| {{text anchor|NOSMELLYROT}}
| Caste
|
| Does not produce [[miasma]] when rotting.

|-
| {{text anchor|NOSTUCKINS}}
| Caste
|
| Weapons can't get stuck in the creature.

|-
| {{text anchor|NOSTUN}}
| Caste
|
| Creature can't be stunned and knocked unconscious by pain or head injuries. Creatures with this tag never wake up from sleep in Fortress Mode. If this creature needs to sleep while playing, it will die.

|-
| {{text anchor|NOT_BUTCHERABLE}}
| Caste
|
| Corpses from this creature cannot be [[butcher|butchered]]. Does not prevent the creature from being slaughtered while alive, however.

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

|-
| {{text anchor|NOTHOUGHT}}
| Caste
|
| Creature doesn't require a {{token|THOUGHT|body}} body part to survive. Has the added effect of preventing speech, though directly controlling creatures that would otherwise be capable of speaking allows them to engage in conversation.
|}

{{alphabetical TOC|style=margin: 1em auto;}}

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

|-
| {{text anchor|ODOR_LEVEL}}
| Caste
|
*number
| How easy the creature is to [[smell]]. The higher the number, the easier the creature is to sniff out. Defaults to 50. Vanilla creatures have values from 0 (undetectable) to 90 (noticeable by humans and dwarves).

|-
| {{text anchor|ODOR_STRING}}
| Caste
|
*string
| What the creature [[smell]]s like. If no odor string is defined, the creature name (not the caste name) is used.

|-
| {{text anchor|OPPOSED_TO_LIFE}}
| Caste
|
| Is hostile to all creatures except undead and other non-living ones and will show {{DFtext|Opposed to life|0:1}} in the [[unit list]]. Used by [[undead]] in the vanilla game. Functions without the {{token|NOT_LIVING|c}} token, and seems to imply said token as well. Undead will not be hostile to otherwise-living creatures given this token. Living creatures given this token will attack living creatures that lack it, while ignoring other living creatures that also have this token.

|-
| {{text anchor|ORIENTATION}}
| Caste
|
*MALE/FEMALE
*disinterested chance
*casual chance
*strong chance
| Determines caste's likelihood of having sexual attraction to certain sexes. Values default to 75:20:5 for the same sex and 5:20:75 for the opposite sex. The first value indicates how likely to be entirely uninterested in the sex, the second decides if the creature will be able to become lovers with that sex, the third decides whether they will be able to marry in worldgen and post-worldgen world activities (which implies being able to become lovers). Marriage seems to be able to happen in fort mode play regardless, as long as they are lovers first.

|-
| {{text anchor|OUTSIDER_CONTROLLABLE}}
| Caste
|
| Lets you play as an [[Adventurer_mode_character_creation#Outsider|outsider]] of this species in adventure mode.

|}

{{alphabetical TOC|style=margin: 1em auto;}}

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

|-
| {{text anchor|PACK_ANIMAL}}
| Caste
|
| Allows the creature to be used as a pack animal. Used by [[trading|merchants]] without wagons and adventurers. Also prevents creature from dropping hauled items on its own -- do ''not'' use for player-controllable creatures! May lead to the creature being domesticated during worldgen, even if it doesn't have {{token|COMMON_DOMESTIC|c}}.

Creatures with this tag but without {{token|BENIGN|c}}, and/or with {{token|LARGE_PREDATOR|c}} leads to hauled items being dropped.

|-
| {{text anchor|PARALYZEIMMUNE}}
| Caste
|
| The creature is immune to all [[Syndrome#CE_PARALYSIS|paralyzing]] special attacks.

|-
| {{text anchor|PATTERNFLIER}}
| Caste
|
| Used to control the bat riders with paralyze-dart blowguns that flew through the 2D chasm. Doesn't do anything now.

|-
| {{text anchor|PCG_LAYERING}}
| Creature
|
*[[Procedural graphics layer|Layering type]]
| Adds a layer to the current {{token|PROCEDURAL_CREATURE_GRAPHICS|c}} definition.

|-
| {{text anchor|PEARL}}
| Caste
|
| In earlier versions, creature would generate [[pearl]]s. Does nothing in the current version.{{verify}}

|-
| {{text anchor|PENETRATEPOWER}}
| Caste
|
*value
| Controls the ability of [[vermin]] to find a way into containers when they are eating food from your stockpiles.

Objects made of most materials (e.g. metal) roll a number from 0-100, and if the resulting number is greater than the penetrate power, their contents escape for the time being. Objects made of [[wood]], [[leather]], [[amber]], or [[coral]] roll 0-95, and items made of [[cloth]] roll 0-90.

|-
| {{text anchor|PERSONALITY}}
| Caste
|
*ATTRIBUTE
*lowest
*median
*highest
| Determines the range and chance of personality traits. Standard is 0:50:100. See [[Personality trait]] for more info.

|-
| {{text anchor|PET}}
| Caste
|
| Allows the creature to be [[Animal_trainer|tamed]] in Fortress mode. Prerequisite for all other working animal roles. Civilizations that encounter it in worldgen will tame and domesticate it for their own use. Adding this to civilization members will classify them as pets instead of citizens, with all the [[Fun|problems]] that entails. However, you can solve these problems using the popular plugin [https://dffd.bay12games.com/file.php?id=13095| Dwarf Therapist], which is completely unaffected by the tag.

|-
| {{text anchor|PET_EXOTIC}}
| Caste
|
| Allows the creature to be [[Animal_trainer|tamed]] in Fortress mode. Prequisite for all other working animal roles. Civilizations cannot domesticate it in worldgen, with certain exceptions. More difficult to tame?{{verify}} Adding this to civilization members will classify them as pets instead of citizens, with all the [[Fun|problems]] that entails. ([[Gremlin|Example]]).

|-
| {{text anchor|PETVALUE}}
| Caste
|
*value
| How valuable a tamed animal is. Actual cost in points in the embarking screen is 1+(PETVALUE/2) for an untrained animal, 1+PETVALUE for a war/hunting one.

|-
| {{text anchor|PETVALUE_DIVISOR}}
| Caste
|
*value
| Divides the creature's {{token|PETVALUE|c}} by the specified number. Used by [[honey bee]]s to prevent a single hive from being worth a fortune.

|-
| {{text anchor|PHYS_ATT_CAP_PERC}}
| Caste
|
*[[Attribute|ATTRIBUTE]] Token
*Cap %
|Default is 200. This means you can increase your attribute to 200% of its starting value (or the average value + your starting value if that is higher).

|-
| {{text anchor|PHYS_ATT_RANGE}}
| Caste
|
*[[Attribute|ATTRIBUTE]]
*lowest
*lower
*low
*median
*high
*higher
*highest
| Sets up a [[Attribute#Body_attributes|physical attribute]]'s range of values (0-5000). All physical attribute ranges default to 200:700:900:1000:1100:1300:2000.

|-
| {{text anchor|PHYS_ATT_RATES}}
| Caste
|
*[[Attribute|ATTRIBUTE]] Token
*cost to improve
*unused counter rate
*rust counter rate
*demotion counter rate
| [[Attribute#Body_attributes|Physical attribute]] gain/decay rates. Lower numbers in the last three slots make decay occur faster. Defaults for STRENGTH, AGILITY, TOUGHNESS, and ENDURANCE are 500:3:4:3, while RECUPERATION and DISEASE_RESISTANCE default to 500:NONE:NONE:NONE.

|-
| {{text anchor|PLUS_BP_GROUP}}
| Caste
|
*BY_TYPE, BY_CATEGORY, or BY_TOKEN
*body type, category, or token
| Adds a body part group to selected body part group. Presumably used immediately after {{token|SET_BP_GROUP|c}}.

|-
| {{text anchor|PLUS_MATERIAL}}
| Creature
|
*material
| Adds a material to selected materials. Used immediately after {{token|SELECT_MATERIAL|c}}.

|-
| {{text anchor|POP_RATIO}}
| Caste
|
*number (max 100000)
| Weighted population of caste; Lower is rarer. Not to be confused with {{token|FREQUENCY|c}}. A weight of 0 will not prevent a caste from spawning.

|-
| {{text anchor|POPULATION_NUMBER}}
| Creature
|
*min
*max
| The minimum/maximum numbers of how many of these creatures are present in each world map tile of the appropriate region. Defaults to 1:1 if not specified.

|-
| {{text anchor|POWER}}
| Caste
|
| Allows the being to represent itself as a deity, allowing it to become the leader of a civilized group. Used by unique demons in the vanilla game. Requires {{token|CAN_SPEAK|c}} to actually do anything more than settle at a location (e.g. write books, lead armies, profane temples). Doesn't appear to do anything for creatures that are already civilized. Once the creature ascends to a position of leadership, it will proceed to act as a standard ruler for their entity and fulfill the same functions (hold tournaments, tame creatures, etc.).

|-
| {{text anchor|PREFSTRING}}
| Creature
|
*string
| Sets what other creatures [[Preferences|prefer]] about this creature. "Urist likes dwarves for their beards." Multiple entries will be chosen from at random. Creatures lacking a PREFSTRING token will never appear under another's preferences.

|-
| {{text anchor|PROCEDURAL_CREATURE_GRAPHICS}}
| Creature
|
* [[Graphics_token#Basic_creature_sprite_types|Sprite type]] or Caste then sprite type
| Makes the creature have procedural graphics built for it, like forgotten beasts/demons/titans/experiments. Must be associated with PCG_LAYERING tokens.

|-
| {{text anchor|PROFESSION_NAME}}
| Creature
|
*[[Unit type token]] (Profession)
*singular
*plural
| The generic name for members of this profession, at the creature level. In order to give members of specific castes different names for professions, use {{token|CASTE_PROFESSION_NAME|c}} instead.

|-
| {{text anchor|PRONE_TO_RAGE}}
| Caste
|
*Chance
| Creature has a percentage chance to flip out at visible non-friendly creatures. Enraged creatures attack anything regardless of timidity and get a strength bonus to their hits. This is what makes [[badger]]s so hardcore.

|-
| {{text anchor|PUS}}
| Caste
|
* <[[material token]]>
* <[[Material_definition_token#Material_States|material state]]>
| The creature has pus. Specifies the stuff secreted by [[Health_care#Infection|infected wounds]].
|}

{{alphabetical TOC|style=margin: 1em auto;}}

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

|-
| {{text anchor|RELSIZE}}
| Caste
|
*BY_CATEGORY, BY_TYPE, BY_TOKEN
*body category, type, or token
*Relsize
| Specifies a new relative size for a part than what is stated in the body plan. For example, dwarves have larger livers.

|-
| {{text anchor|REMAINS}}
| Caste
|
*singular
*plural
| What the creature's [[remains]] are called.

|-
| {{text anchor|REMAINS_COLOR}}
| Caste
|
| What color the creature's [[remains]] are.

|-
| {{text anchor|REMAINS_ON_VERMIN_BITE_DEATH}}
| Caste
|
| Goes with {{token|VERMIN_BITE|c}} and {{token|DIE_WHEN_VERMIN_BITE|c}}, the vermin creature will leave remains on death when biting. Leaving this tag out will cause the creature to disappear entirely after it bites.

|-
| {{text anchor|REMAINS_UNDETERMINED}}
| Caste
|
| Nothing.

|-
| {{text anchor|REMOVE_MATERIAL}}
| Creature
|
*material token
| Removes a material from the creature.

|-
| {{text anchor|REMOVE_TISSUE}}
| Creature
|
*tissue token
| Removes a tissue from the creature.

|-
| {{text anchor|RETRACT_INTO_BP}}
| Caste
|
*BY_TYPE, BY_CATEGORY or BY_TOKEN
*body type, [[Body_token#CATEGORY|category]], or [[Body_token#BP|token]]
*Second person ("You") retract verb text
*Third person ("The giant snail") retract verb text
*Second person cancel retract text
*Third person cancel retract text
| The creature will retract into the specified body part(s) when threatened. It will be unable to move or attack, but enemies will only be able to attack the specified body part(s). When one of the specified body part is severed off, the creature automatically unretracts and cannot retract anymore. More than one body part can be selected by using BY_TYPE or BY_CATEGORY.

Second-person descriptions are used for adventurer mode natural ability. "<pro_pos>" can be used in the descriptions, being replaced with the proper pronoun (or lack thereof) in-game.

Undead curled up creatures are buggy, specifically those that retract into their upper bodies: [[echidna]]s, [[hedgehog]]s and [[pangolin]]s.{{bug|11463}}{{bug|10519}} The upper body is prevented from collapsing by a separate body part (the middle spine), which cannot be attacked when the creature is retracted. See {{token|PREVENTS_PARENT_COLLAPSE|bo}}. Living creatures eventually succumb to blood loss, but undead creatures do not. Giant creatures also take a very long time to bleed out.
|-
| {{text anchor|RETURNS_VERMIN_KILLS_TO_OWNER}}
|
|
| Cat behavior. If it kills a vermin creature and has an owner, it carries the remains in its mouth and drops them at their feet. Requires {{token|HUNTS_VERMIN|c}}.

|-
| {{text anchor|ROOT_AROUND}}
| Caste
|
*BY_TYPE, BY_CATEGORY or BY_TOKEN
*body type, [[Body_token#CATEGORY|category]], or [[Body_token#BP|token]]
*Second person ("You") verb text
*Third person ("The hen") verb text
| Creature will occasionally root around in the grass, looking for insects. Used for flavor in Adventurer Mode, spawns vermin edible for this creature in Fortress Mode. Creatures missing the specified body part will be unable to perform this action. The action produces a message (visible in adventure mode) in the form:

[creature] [verb text] the [description of creature's location]

In adventure mode, the "rooting around" ability will be included in the "natural abilities" menu, represented by its second person verb text.

|}

{{alphabetical TOC|style=margin: 1em auto;}}

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

|-
| {{text anchor|SAVAGE}}
| Creature
|
| The creature will only show up in "savage" biomes. Has no effect on cavern creatures. Cannot be combined with {{token|GOOD|c}} or {{token|EVIL|c}}.

|-
| {{text anchor|SECRETION}}
| Caste
|
*<[[material token]]>
*<[[Material_definition_token#Material_States|material state]]>
*BY_TOKEN / BY_CATEGORY / BY_TYPE
*<[[Body_token#BP|body part ID]]> / <[[Body_token#CATEGORY|category]]> or ALL / <type (e.g. [[Body_token#GRASP|GRASP]])>
*<[[Body_detail_plan_token#BP_LAYERS|tissue layer]]> or ALL
*<trigger>
| Causes the specified tissue layer(s) of the indicated body part(s) to secrete the designated material. A size 100 ('covering') [[contaminant]] is created over the affected body part(s) in its specified material state (and at the temperature appropriate to this state) when the trigger condition is met, as long as one of the secretory tissue layers is still intact. Valid triggers are:
*'''CONTINUOUS'''
Secretion occurs once every 40 [[time|ticks]] in [[fortress mode]], and every tick in [[adventurer mode]].
*'''EXERTION'''
Secretion occurs continuously (at the rate described above) whilst the creature is at minimum {{Tile|Tired|6:1}} following physical exertion. Note that this cannot occur if the creature has {{token|NOEXERT|c}}.
*'''EXTREME_EMOTION'''
Secretion occurs continuously (as above) whilst the creature is distressed. Cannot occur in creatures with {{token|NOEMOTION|c}}.

|-
| {{text anchor|SELECT_ADDITIONAL_CASTE}}
| Creature
|
*<caste>
| Adds an additional previously defined caste to the selection. Used after {{token|SELECT_CASTE|c}}.

|-
| {{text anchor|SELECT_CASTE}}
| Creature
|
*<caste> or ALL
| Selects a previously defined caste

|-
| {{text anchor|SELECT_MATERIAL}}
| Creature
|
*<[[material token]]>
| Selects a locally defined material. Can be ALL.

|-
| {{text anchor|SELECT_TISSUE}}
| Creature
|
*tissue token
| Selects a tissue for editing.

|-
| {{text anchor|SEMIMEGABEAST}}
| Caste
|
| Essentially the same as {{token|MEGABEAST|c}}, but more of them are created during worldgen. See the [[semi-megabeast]] page for details.

|-
| {{text anchor|SENSE_CREATURE_CLASS}}
| Caste
|
* <[[Creature_token#CREATURE_CLASS|creature class]]>
* [[Tilesets|<tile value or character>]]
* [[Color#Color_values|<foreground color>:<background color>:<foreground brightness>]]
| Gives the creature the ability to sense creatures belonging to the specified [[Creature_token#CREATURE_CLASS|creature class]] even when they lie far beyond line of sight, including through walls and floors. It also appears to reduce or negate the combat penalty of [[Wound#Blindness|blind]] units when fighting creatures they can sense. In [[adventure mode]], the specified tile will be used to represent sensed creatures when they cannot be seen directly.

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

|-
| {{text anchor|SKILL_LEARN_RATE}}
| Caste
|
*<[[skill_token]]>
*<percentage>
| The rate at which this creature learns this skill. Requires {{token|CAN_LEARN|c}} or {{token|INTELLIGENT|c}} to function.

|-
| {{text anchor|SKILL_LEARN_RATES}}
| Caste
|
*<percentage>
| The rate at which this creature learns all skills. Requires {{token|CAN_LEARN|c}} or {{token|INTELLIGENT|c}} to function.

|-
| {{text anchor|SKILL_RATE}}
| Caste
|
*[[skill_token]]
*<% of improvement points gained>
*<unused counter rate>
*<rust counter rate>
*<demotion counter rate>
| Like {{token|SKILL_RATES|c}}, but applies to individual skills instead. Requires {{token|CAN_LEARN|c}} or {{token|INTELLIGENT|c}} to function.

|-
| {{text anchor|SKILL_RATES}}
| Caste
|
*<% of improvement points gained>
*<unused counter rate>
*<rust counter rate>
*<demotion counter rate>
| Affects skill gain and decay. Lower numbers in the last three slots make decay occur faster ([SKILL_RATES:100:1:1:1] would cause rapid decay). The counter rates may also be replaced with NONE.
Default is [SKILL_RATES:100:8:16:16]. Requires {{token|CAN_LEARN|c}} or {{token|INTELLIGENT|c}} to function.

|-
| {{text anchor|SKILL_RUST_RATE}}
| Caste
|
*[[skill_token]]
*value
*value
*value
| The rate at which this skill decays. Lower values cause the skill to decay faster. Requires {{token|CAN_LEARN|c}} or {{token|INTELLIGENT|c}} to function.

|-
| {{text anchor|SKILL_RUST_RATES}}
| Caste
|
*value
*value
*value
| The rate at which all skills decay. Lower values cause the skills to decay faster. Requires {{token|CAN_LEARN|c}} or {{token|INTELLIGENT|c}} to function.

|-
| {{text anchor|SLAIN_CASTE_SPEECH}}
| Caste
|
*[[Speech file|text set]]
| Caste-specific {{token|SLAIN_SPEECH|c}}.

|-
| {{text anchor|SLAIN_SPEECH}}
| Creature
|
*[[Speech file|text set]]
| Boasting speeches relating to killing this creature. Examples include [[text_dwarf.txt/raw|text_dwarf.txt]] (<code>[SLAIN_SPEECH:SLAIN_DWARF]</code>) and text_elf.txt (<code>[SLAIN_SPEECH:SLAIN_ELF]</code>) in data\vanilla\vanilla_creatures\objects.

|-
| {{text anchor|SLOW_LEARNER}}
| Caste
|
| Shorthand for {{token|CAN_LEARN|c}} + <code>[[Creature_token#SKILL_LEARN_RATES|[SKILL_LEARN_RATES:50]]]</code>.{{verify}} Used by a number of 'primitive' creatures (like [[ogre]]s, [[giant]]s and [[troglodyte]]s) in the vanilla game. Applicable to player races. Prevents a player from recruiting nobility, even basic ones. Subterranean creatures with this token combined with {{token|EVIL|c}} will become servants of goblins in their civilizations, in the style of [[troll]]s.

|-
| {{text anchor|SMALL_REMAINS}}
| Caste
|
| Creature leaves "[[item token#REMAINS|remains]]" instead of a corpse. Used by [[vermin]].

|-
| {{text anchor|SMELL_TRIGGER}}
| Creature
|
*value
| Determines how keen a creature's sense of smell is - lower is better. At 10000, a creature cannot smell at all.

|-
| {{text anchor|SOLDIER_ALTTILE}}
| Creature
|
*'character' or tile number
| If this creature is active in its civilization's military, it will blink between its default tile and this one.

|-
| {{text anchor|SOUND}}
| Caste
|
* Sound application (currently accepts ALERT or PEACEFUL_INTERMITTENT)
* Sound range (in tiles)
* Sound delay (lower values = sound is produced more often)
* VOCALIZATION or NONE (determines whether the sound requires breathing or not)
* First-person description
* Third-person description
* Description when out of sight
| Creature makes sounds periodically, which can be heard in Adventure mode.
* First-person reads "You '''bark'''"
* Third-person reads "The [[capybara]] '''barks'''"
* Out of sight reads "You hear '''a loud bark'''"
with the text in bold being the description arguments of the token.

|-
| {{text anchor|SOURCE_HFID}}
| Creature
|
*Integer
| Found on generated [[angel]]s. This is the historical figure ID of the deity with which the angel is associated. Since HFIDs are not predictable before worldgen, this isn't terribly usable in mods.

|-
| {{text anchor|SPECIFIC_FOOD}}
| Caste
|
* PLANT or CREATURE
* Plant/creature ID
| Creature will only appear in biomes with this plant or creature available. Grazers given a specific type of grass (such as [[panda]]s and [[bamboo]]) will only eat that grass and nothing else, risking starvation if there's none available.

|-
| {{text anchor|SPHERE}}
| Creature
|
* [[Sphere#Available_spheres|sphere]]
| Sets what religious spheres the creature is aligned to, for purposes of being worshipped via the {{token|POWER|c}} token. Also affects the creature's name.

|-
| {{text anchor|SPOUSE_CONVERSION_TARGET}}
| Caste
|
| This creature can be converted by a night creature with {{token|SPOUSE_CONVERTER|c}}.

|-
| {{text anchor|SPOUSE_CONVERTER}}
| Caste
|
| If the creature has the {{token|NIGHT_CREATURE_HUNTER|c}} tag, it will kidnap {{token|SPOUSE_CONVERSION_TARGET|c}}s and transform them into the caste of its species with the {{token|CONVERTED_SPOUSE|c}} tag during worldgen. It may also start families this way.

|-
| {{text anchor|SPREAD_EVIL_SPHERES_IF_RULER}}
| Caste
|
| If the creature rules over a [[site]], it will cause the local landscape to be corrupted into [[Surroundings#Evil|evil surroundings]] associated with the creature's [[Creature_token#SPHERE|sphere]]s. The creature must have at least one of the following [[sphere]]s for this to take effect: BLIGHT, DEATH, DISEASE, DEFORMITY, NIGHTMARES. The first three kill vegetation, while the others sometimes do. The last two get [[Plant_token#EVIL|evil plants]] and [[Creature_token#EVIL|evil animals]] sometimes. NIGHTMARES gets [[bogeyman|bogeymen]]. [http://www.bay12forums.com/smf/index.php?topic=169696.msg8162224#msg8162224] Used by [[demon]]s in the vanilla game.

|-
| {{text anchor|STANCE_CLIMBER}}
| Caste
|
| Caste does not require <code>[[Body_token#GRASP|[GRASP]]]</code> body parts to climb -- it can climb with <code>[[Body_token#STANCE|[STANCE]]]</code> parts instead.

|-
| {{text anchor|STANDARD_GRAZER}}
| Caste
|
| Acts as {{token|GRAZER|c}} but set to 20000*G*(max size)^(-3/4), where G defaults to 100 but can be set in d_init, and the whole thing is trapped between 150 and 3 million. Used for all grazers in the default creature raws.

|-
| {{text anchor|STRANGE_MOODS}}
| Caste
|
| The creature will get [[strange mood]]s in fortress mode and can produce artifacts.

|-
| {{text anchor|SUPERNATURAL}}
| Caste
|
| Gives the creature knowledge of any secrets with <code>[[Interaction_token#IS_SECRET|[SUPERNATURAL_LEARNING_POSSIBLE]]]</code> that match its [[Creature_token#SPHERE|spheres]] and also prevents it from becoming a [[vampire]] or [[werebeast]]. Other effects are unknown.

|-
| {{text anchor|SWIMS_INNATE}}
| Caste
|
| The creature naturally knows how to swim perfectly and does not use the [[swimmer]] skill, as opposed to {{token|SWIMS_LEARNED|c}} below. However, Fortress mode AI never paths into water anyway, so it's less useful there.

|-
| {{text anchor|SWIMS_LEARNED}}
| Caste
|
| The creature swims only as well as their present [[Swimmer|swimming skill]] allows them to.

|-
| {{text anchor|SYNDROME_DILUTION_FACTOR}}
| Caste
| <[[Syndrome#SYN_IDENTIFIER|syndrome identifier]]>:<percentage>
| Dilutes the effects of syndromes which have the specified identifier. A percentage of 100 is equal to the regular syndrome effect severity, higher percentages reduce severity.
|}

{{alphabetical TOC|style=margin: 1em auto;}}

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

|-
| {{text anchor|TENDONS}}
| Caste
|
* [[material token]]
*healing rate
| The creature has tendons in its {{token|CONNECTIVE_TISSUE_ANCHOR|td}} tissues (bone or chitin by default). Cutting the bone/chitin tissue severs the tendons, disabling motor function if the target is a limb.

|-
| {{text anchor|THICKWEB}}
| Caste
|
| The creature's [[web]]s can catch larger creatures.

|-
| {{text anchor|TISSUE}}
| Creature
|
*name
| Begins defining a tissue in the creature file. Follow this with standard tissue definition tokens to define the tissue properties.

|-
| {{text anchor|TISSUE_LAYER}}
| Caste
|
*BY_TYPE, BY_CATEGORY, BY_TOKEN
*TYPE,CATEGORY, or TOKEN
*TISSUE
*LOCATION
| Adds the tissue layer to wherever it is required.
Non-argument Locations can be FRONT, RIGHT, LEFT, TOP, BOTTOM. Argument locations are AROUND and CLEANS, requiring a further body part and a % of coverage/cleansing

|-
| {{text anchor|TISSUE_LAYER_OVER}}
| Caste
|
*BY_TYPE, BY_CATEGORY, BY_TOKEN
*TYPE,CATEGORY, or TOKEN
*TISSUE
*LOCATION
| Alias for TISSUE_LAYER

|-
| {{text anchor|TISSUE_LAYER_UNDER}}
| Caste
|
*BY_TYPE, BY_CATEGORY, BY_TOKEN
*TYPE,CATEGORY, or TOKEN
*TISSUE
| Adds the tissue layer under a given part.
For example, an [[iron man]] has a gaseous poison within, and this tissue (GAS is its name) has the token [TISSUE_LEAKS] and its state is GAS, so when you puncture the iron outside and damage this tissue it leaks gas (can have a syndrome by using a previous one in the creature sample.) [TISSUE_LAYER_UNDER:BY_CATEGORY:ALL:{tissue}] {tissue} is what will be under the TISSUE_LAYER; here is an example Tissue from the 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]

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

|-
| {{text anchor|TRADE_CAPACITY}}
| Caste
|
*number
| How much the creature can carry when used by merchants. 1000 by default. Completely ignored if the animal does not also have PACK_ANIMAL or WAGON, instead using BODY_SIZE^(2/3)/20, even if they're a pack animal due to ANIMAL_ALWAYS_PACK_ANIMAL.

|-
| {{text anchor|TRAINABLE}}
| Caste
|
| Shortcut for {{token|TRAINABLE_HUNTING|c}} + {{token|TRAINABLE_WAR|c}}.

|-
| {{text anchor|TRAINABLE_HUNTING}}
| Caste
|
| Can be [[Animal trainer|trained]] as a hunting beast, increasing speed.

|-
| {{text anchor|TRAINABLE_WAR}}
| Caste
|
| Can be [[Animal trainer|trained]] as a war beast, increasing strength and endurance.

|-
| {{text anchor|TRANCES}}
| Caste
|
| Allows the creature to go into [[martial trance]]s. Used by dwarves in the vanilla game.

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

|-
| {{text anchor|TRIGGERABLE_GROUP}}
| Creature
|
*min
*max
| A large swarm of vermin can be disturbed, usually in adventurer mode.

|-
| {{text anchor|TSU_NOUN}}
| Caste
|
*noun
*SINGULAR or PLURAL
| Noun for the {{token|TISSUE_STYLE_UNIT|c}}, used in the description of the tissue layer's style.
|}

{{alphabetical TOC|style=margin: 1em auto;}}

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

|-
| {{text anchor|UBIQUITOUS}}
| Creature
|
| Creature will occur in every region with the correct biome. Does not apply to {{token|EVIL|c}}/{{token|GOOD|c}} tags. Supersedes {{token|FREQUENCY|c}} for the purposes of distributing populations through the map, they are present in every part of the valid biome. Respects {{token|FREQUENCY|c}} for the frequency of unit [[Creature token#CLUSTER_NUMBER|cluster]] spawns being of this species.

|-
| {{text anchor|UNDERGROUND_DEPTH}}
| Creature
|
*mindepth
*maxdepth
| Depth that the creature appears underground. Numbers can be from 0 to 5. 0 is actually 'above ground' and can be used if the creature is to appear both above and below ground. Values from 1-3 are the respective [[cavern]] levels, 4 is the [[magma sea]] and 5 is the [[HFS]]. A single argument may be used instead of min and max. [[Demon]]s use only 5:5; user-defined creatures with both this depth and {{token|FLIER}} will take part in the initial wave from the HFS alongside generated demons, but without {{token|FLIER}} they will only spawn from the map edges. Civilizations that can use underground plants or animals will only export (via the embark screen or caravans) things that are available at depth 1.

|-
| {{text anchor|UNDERSWIM}}
| Caste
|
| The creature is displayed as blue when in [[Water#Depth|7/7 water]]. Used on fish and amphibious creatures which swim under the water.

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

|-
| {{text anchor|USE_CASTE}}
| Creature
|
*new caste token
*old caste token
| Defines a new caste derived directly from a previous caste. The new caste inherits all properties of the old one. The effect of this tag is automatic if one has not yet defined any castes: "Any caste-level tag that occurs before castes are explicitly declared is saved up and placed on any caste that is declared later, unless the caste is explicitly derived from another caste."
Roostre: "When DF detects duplicate tokens in the raws of the same object, a failsafe seems to kick in; it takes the bottom-most of the duplicates, and disregards the others. In the case of tokens added by a mod, it prioritizes the duplicate in the mod." This means that if a tag is defined in the base-caste and redefined in the derived caste, the derived tag overwrites the base tag.

|-
| {{text anchor|USE_MATERIAL}}
| Creature
|
*new material ID
*old material ID
| Defines a new local creature material and populates it with all properties defined in the specified local creature material.

|-
| {{text anchor|USE_MATERIAL_TEMPLATE}}
| Creature
|
*new material token
*material template
| Defines a new local creature material and populates it with all properties defined in the specified template. [http://www.bay12forums.com/smf/index.php?topic=175437.msg8441368#msg8441368 There seems to be a limit of 200 materials per creature].

|-
| {{text anchor|USE_TISSUE}}
| Creature
|
*new tissue token
*old tissue id
| Defines a new local creature tissue and populates it with all properties defined in the local tissue specified in the second argument.

|-
| {{text anchor|USE_TISSUE_TEMPLATE}}
| Creature
|
*new tissue token
*tissue template
| Loads a tissue template listed in OBJECT:TISSUE_TEMPLATE files, such as tissue_template_default.txt.

|-
| {{text anchor|UTTERANCES}}
| Creature
|
| Changes the language of the creature into unintelligible 'kobold-speak', which creatures of other species will be unable to understand. If a civilized creature has this and is not part of a {{token|SKULKING|e}} civ, it will tend to start wars with all nearby civilizations and will be unable to make peace treaties due to 'inability to communicate'.
|}

{{alphabetical TOC|style=margin: 1em auto;}}

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

|-
| {{text anchor|VEGETATION}}
| Caste
|
| Like {{token|AT_PEACE_WITH_WILDLIFE}}, but also makes the creature more valued in artwork by civilisations with the PLANT [[sphere]]. [http://www.bay12forums.com/smf/index.php?topic=169696.msg8316954#msg8316954] Used by [[grimeling]]s in the vanilla game.

|-
| {{text anchor|VERMIN_BITE}}
| Caste
|
*chance of occurrence{{verify}}
*verb (bitten, stung, etc.)
* [[material token]]
* [[Material_definition_token#Material_States|material state]]
| Enables vermin to bite other creatures, injecting the specified material. See {{token|SPECIALATTACK_INJECT_EXTRACT|c}} for details about injection - this token presumably works in a similar manner.{{verify}}

|-
| {{text anchor|VERMIN_EATER}}
| Creature
|
| The vermin creature will attempt to eat exposed food. See {{token|PENETRATEPOWER|c}}. Distinct from {{token|VERMIN_ROTTER|c}}.

|-
| {{text anchor|VERMIN_FISH}}
| Creature
|
| The vermin appears in [[water]] and will attempt to swim around.

|-
| {{text anchor|VERMIN_GROUNDER}}
| Creature
|
| The creature appears in "general" surface ground locations. Note that this doesn't stop the creature from flying if it can (most vermin birds have this tag).

|-
| {{text anchor|VERMIN_HATEABLE}}
| Caste
|
| Some dwarves will [[Preferences|hate]] the creature and get unhappy thoughts when around it. See the [[Hateable|list of hateable vermin]] for details.

|-
| {{text anchor|VERMIN_MICRO}}
| Caste
|
| This makes the creature move in a swarm of creatures of the same race as it (e.g. swarm of flies, swarm of ants).

|-
| {{text anchor|VERMIN_NOFISH}}
| Caste
|
| The creature cannot be caught by [[fishing]].

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

|-
| {{text anchor|VERMIN_NOTRAP}}
| Caste
|
| The creature cannot be caught in baited [[animal trap]]s; however, a "[[Trapper|catch live land animal]]" task may still be able to capture one if a dwarf finds one roaming around.

|-
| {{text anchor|VERMIN_ROTTER}}
| Creature
|
| The vermin are attracted to rotting stuff and loose food left in the open and cause unhappy thoughts to dwarves who encounter them. Present on flies, knuckle worms, acorn flies, and blood gnats. Speeds up decay?{{verify}}

|-
| {{text anchor|VERMIN_SOIL}}
| Creature
|
| The creature randomly appears near dirt or mud, and may be uncovered by creatures that have the {{token|ROOT_AROUND|c}} interaction such as [[goose|geese]] and [[chicken]]s. Dwarves will ignore the creature when given the "Capture live land animal" task.

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

|-
| {{text anchor|VERMINHUNTER}}
| Caste
|
| Old shorthand for "does cat stuff". Contains {{token|AT_PEACE_WITH_WILDLIFE|c}} + {{token|RETURNS_VERMIN_KILLS_TO_OWNER|c}} + {{token|HUNTS_VERMIN|c}} + {{token|ADOPTS_OWNER|c}}.

|-
| {{text anchor|VESPERTINE}}
| Caste
|
| Sets the creature to be active during the evening in adventurer mode.

|-
| {{text anchor|VIEWRANGE}}
| Caste
|
*value
| Value should determine how close you have to get to a critter before it attacks (or prevents adv mode travel etc.) Default is 20.

|-
| {{text anchor|VISION_ARC}}
| Caste
|
*binocular vision arc
*non-binocular vision arc
| The width of the creature's vision arcs, in degrees (i.e. 0 to 360). The first number is binocular vision, the second is non-binocular vision. Binocular vision has a minimum of about 10 degrees, monocular, a maximum of about 350 degrees. Values past these limits will be accepted, but will default to ~10 degrees and ~350 degrees respectively. Defaults are 60:120.
|}

{{alphabetical TOC|style=margin: 1em auto;}}

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

|-
| {{text anchor|WAGON_PULLER}}
| Caste
|
| Allows the creature to pull caravan wagons. If a civilization doesn't have access to any, it is restricted to trading with pack animals.

|-
| {{text anchor|WEBBER}}
| Caste
|
* [[material token]]
| Allows the creature to create [[web]]s, and defines what the webs are made of.

|-
| {{text anchor|WEBIMMUNE}}
| Caste
|
| The creature will not get caught in thick [[web]]s. Used by creatures who can shoot thick webs (such as [[giant cave spider]]s) in order to make them immune to their own attacks.
|}

==Attack Tokens==

Attacks can use four different part selection criteria; while all vanilla attacks use only BODYPART (e.g. ATTACK:PUNCH:BODYPART:BY_TYPE:GRASP), there are other options available.

{| {{prettytable}}
|- bgcolor="#ddd"
! width="20%" | Part type token
! width="30%" | Arguments
! width="60%" | Description

|-
| {{text anchor|BODYPART}}
|
* BY_TYPE/BY_TOKEN/BY_CATEGORY
* type/token/category
| This attack uses a particular body part; for example, BY_TYPE:GRASP will make it use any part that can hold onto an object.

|-
| {{text anchor|TISSUE_LAYER}}
|
* BY_TYPE/BY_TOKEN/BY_CATEGORY
* type/token/category
* tissue layer
| This attack uses a specific tissue layer on a specific body part; BY_TYPE:GRASP:BONE will make it use the bone of the hands.

|-
| {{text anchor|CHILD_BODYPART_GROUP}}
|
* BY_TYPE/BY_TOKEN/BY_CATEGORY
* type/token/category
* BY_TYPE/BY_TOKEN/BY_CATEGORY
* type/token/category
| Uses a body part that is subordinate to another; BY_CATEGORY:ARM_LOWER:BY_TYPE:GRASP will make it use every hand attached to each lower arm (so it will generate one attack per lower arm, each of which will use every hand on that arm, assuming there are multiple hands per arm).

|-
| {{text anchor|CHILD_TISSUE_LAYER_GROUP}}
|
* BY_TYPE/BY_TOKEN/BY_CATEGORY
* type/token/category
* BY_TYPE/BY_TOKEN/BY_CATEGORY
* type/token/category
* tissue layer
| As CHILD_BODYPART_GROUP, but specifying a tissue, too.

|}

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

|-
| {{text anchor|ATTACK_SKILL}}
| Caste
|
*[[Skill token]]
| Defines the skill used by the attack.

|-
| {{text anchor|ATTACK_VERB}}
| Caste
|
*2nd person
*3rd person
| Descriptive text for the attack.

|-
| {{text anchor|ATTACK_CONTACT_PERC}}
| Caste
|
*% value
| The contact area of the attack, measured in % of the body part's volume. Note that all attack percentages can be more than 100%.

|-
| {{text anchor|ATTACK_PENETRATION_PERC}}
| Caste
|
*% value
| The penetration value of the attack, measured in % of the body part's volume. Requires ATTACK_FLAG_EDGE. Maximum value: 15000.

|-
| {{text anchor|ATTACK_PRIORITY}}
| Caste
|
*MAIN or SECOND
| Usage frequency. MAIN attacks are 100 times more frequently chosen than SECOND. Opportunity attacks ignore this preference.

|-
| {{text anchor|ATTACK_VELOCITY_MODIFIER}}
| Caste
|
*number
| The velocity multiplier of the attack, multiplied by 1000.

|-
| {{text anchor|ATTACK_FLAG_CANLATCH}}
| Caste
|
| Attacks that damage tissue have the chance to latch on in a wrestling hold. The grabbing bodypart can then use the "shake around" wrestling move, causing severe, armor-bypassing tensile damage according to the attacker's body volume.

|-
| {{text anchor|ATTACK_FLAG_WITH}}
| Caste
|
| Displays the name of the body part used to perform an attack while announcing it, e.g. "The weaver punches the bugbat with his right hand".

|-
| {{text anchor|ATTACK_FLAG_EDGE}}
| Caste
|
| The attack is edged, with all the effects on physical resistance and contact area that it entails.

|-
| {{text anchor|ATTACK_PREPARE_AND_RECOVER}}
| Caste
|
* Preparation time
* Recovery time
| Determines the length of time to prepare this attack and until one can perform this attack again. Values appear to be calculated in adventure mode ticks.

|-
| {{text anchor|ATTACK_FLAG_BAD_MULTIATTACK}}
| Caste
|
| Multiple strikes with this attack cannot be performed effectively.

|-
| {{text anchor|ATTACK_FLAG_INDEPENDENT_MULTIATTACK}}
| Caste
|
| Multiple strikes with this attack can be performed with no penalty. The creature will use all attacks with this token at once.

|-
| {{text anchor|SPECIALATTACK_INJECT_EXTRACT}}
| Caste
|
*<[[material token]]>
*<[[Material_definition_token#Material_States|material state]]>
*<min quantity>
*<max quantity>
| When added to an attack, causes the attack to inject the specified material into the victim's bloodstream. Once injected, the material will participate in [[temperature|thermal]] exchange within the creature - injecting something like molten [[iron]] (INORGANIC:IRON:LIQUID) would cause most unmodded creatures to melt (note that some of the injected material also [[contaminant|splatters]] over the bodypart used to carry out the attack, so it should be protected appropriately). If the injected material has an associated [[syndrome]] with the [[Syndrome#SYN_INJECTED|[SYN_INJECTED]]] token, it will be transmitted to the victim. If the attack is blunt, the injected material lacks the [[Material definition token#ENTERS_BLOOD|[ENTERS_BLOOD]]] token, the attacked bodypart has no [[Tissue_definition_token#VASCULAR|[VASCULAR]]] tissues, or the victim is bloodless, the material will splatter over the attacked body part instead.

|-
| {{text anchor|SPECIALATTACK_INTERACTION}}
| Caste
|
*interaction
| When this attack lands successfully, a specified interaction will take effect on the target creature. The attack must break the target creature's skin in order to work. This will take effect in worldgen as well. If the attack would break skin, the interaction will occur '''before the attack actually lands'''.

|-
| {{text anchor|SPECIALATTACK_SUCK_BLOOD}}
| Caste
|
*min
*max
| Successful attack draws out an amount of blood randomized between the min and max value. Beware that this '''will''' trigger any ingestion syndromes attached to the target creature's blood - for example, using this attack on a vampire will turn you into one too.
|}

==Tissue Layer Tokens==
Tissue layers are added to a creature's body parts by the creature tokens [[#TISSUE_LAYER|TISSUE_LAYER]], [[#TISSUE_LAYER_OVER|TISSUE_LAYER_OVER]], [[#TISSUE_LAYER_UNDER|TISSUE_LAYER_UNDER]], and the body detail plan token [[#TL_LAYERS|TL_LAYERS]].

These tissue layers are not the same thing as tissues, which are defined at creature level, but rather applications of the tissues. If the SKIN tissue of a creature is the more general and abstract notion of what skin is for that creature, then a tissue layer may be the "actual" skin on the creature's nose, head, or second toe. As most creatures have more than one body part, tissue layers are normally selected en masse.

Some tissue layer tokens are analogous to tissue definition tokens, e.g. [[#TL_CONNECTS|TL_CONNECTS]] to [[tissue_definition_token#CONNECTS|CONNECTS]].

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

|-
| {{text anchor|SELECT_TISSUE_LAYER}}
| Caste
|
*TISSUE
*BY_CATEGORY, BY_TYPE, BY_TOKEN
*Location - category, type, or token | Selects a tissue at a location
* (optional) FRONT, BACK, LEFT, RIGHT, TOP, BOTTOM, AROUND.
| Begins a selection of tissue layers.
[SELECT_TISSUE_LAYER:HEART:BY_TYPE:HEART]

|-
| {{text anchor|PLUS_TISSUE_LAYER}}
| Caste
|
*TISSUE
*BY_CATEGORY, BY_TYPE, BY_TOKEN
*Location - category, type, or token
| Adds tissue layers to those selected.

|-
| {{text anchor|SET_TL_GROUP}}
| Caste
|
*TISSUE
*BY_CATEGORY, BY_TYPE, BY_TOKEN
*Location - category, type, or token
*tissue
| Begins a selection of tissue layers. Only usable for descriptor and cosmetic purposes.

Research has implied it may be redundant with SELECT_TISSUE_LAYER, as the latter allows for cosmetics as well as "functional" tokens such as TL_MAJOR_ARTERIES. Vanilla raws still use SET_TL_GROUP though, for all cosmetic purposes. More research is needed on this subject.

|-
| {{text anchor|PLUS_TL_GROUP}}
| Caste
|
*BY_CATEGORY, BY_TYPE, BY_TOKEN
*Location - category, type, or token
*tissue
| Adds tissue layers to those selected. Like SET_TL_GROUP, it may be redundant even if used in the vanilla raws.

|-
| {{text anchor|SET_LAYER_TISSUE}}
| Caste
|
*TISSUE
| Sets a selected tissue layer to be made of a different tissue.

|-
| {{text anchor|SHEARABLE_TISSUE_LAYER}}
| Caste
|
* tissue modifier
* required value
| Tissue layer can be sheared for its component material. The specified modifier must be at least of the desired value for shearing to be possible (for example, a [[llama]]'s wool must have a LENGTH of 300 before it is shearable).

|-
| {{text anchor|TISSUE_LAYER_APPEARANCE_MODIFIER}}
| Caste
|
*QUALITY
*lowest
*lower
*low
*median
*high
*higher
*highest
| Sets the range of qualities, including LENGTH, DENSE, HIGH_POSITION, CURLY, GREASY, WRINKLY

|-
| {{text anchor|TISSUE_STYLE_UNIT}}
| Caste
|
*tissue style unit ID
*shaping
| Sets tissue layer to be the target of TISSUE_STYLE token specified for an entity, works only on entity members. Mostly used with tissues HAIR, BEARD, MOUSTACHE, SIDEBURNS.

|-
| {{text anchor|TL_COLOR_MODIFIER}}
| Caste
|
*COLOR
*freq
*COLOR
*freq etc.
| Creates a list of colors/color patterns, giving each a relative frequency. If the given color or pattern does not exist, the tissue is described as being "transparent".

|-
| {{text anchor|TLCM_GENETIC_MODEL}}
| Caste
|
| The way the color modifier is passed on to offspring. May or may not work right now.{{verify}}

|-
| {{text anchor|TLCM_IMPORTANCE}}
| Caste
|
*number
| Presumably modifies the importance of the tissue layer color modifier, for description purposes.
HOWEVER using this appears to remove all mention of colour from creature descriptions. It does not appear in any default creatures.

|-
| {{text anchor|TLCM_NOUN}}
| Caste
|
*name
*SINGULAR or PLURAL
| Names the tissue layer color modifier, and determines the noun. Also used by [[Utility:Stonesense|Stonesense]] for colouring body parts.

|-
| {{text anchor|TLCM_TIMING}}
| Caste
|
*ROOT
*start change window years
*days
*end change window years
*days
| Determines the point in the creature's life when the color change begins and ends.

|-
| {{text anchor|TL_CONNECTS}}
| Caste
|
| Gives the CONNECTS attribute to selected layers.

|-
| {{text anchor|TL_HEALING_RATE}}
| Caste
|
*value
| Changes the HEALING_RATE of the selected tissue layers.

|-
| {{text anchor|TL_MAJOR_ARTERIES}}
| Caste
|
| Gives the "major arteries" attribute to selected layers. Used to add massive bleeding properties to the throat, made from skin.

|-
| {{text anchor|TL_PAIN_RECEPTORS}}
| Caste
|
*value
| Changes the number of pain receptors for selected tissue layers.

|-
| {{text anchor|TL_RELATIVE_THICKNESS}}
| Caste
|
*value
| Changes the relative thickness for selected tissue layers.

|-
| {{text anchor|TL_VASCULAR}}
| Caste
|
*value
| Sets a new VASCULAR value (which modulates bleeding) for selected tissue layers.

|}

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

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

DF2014:Creature token

2024-09-25T03:27:40Z

DikbutDaGrate: Very extensive testing reveals it works, just required an inordinate amount of time to verify.

{{Quality|Exceptional|22:04, 20 September 2016 (UTC)}}
{{av}}
{{Modding}}

The <code>[OBJECT:CREATURE]</code> [[token]] defines the properties of [[creatures]];  this is a full list of all known creature tokens:

__NOTOC__

{{clear}}
{{alphabetical TOC|style=margin: 1em auto;}}

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

|-
| {{text anchor|ADOPTS_OWNER}}
| Caste
|
| Prevents tamed creature from being made available for adoption, instead allowing it to automatically adopt whoever it wants. The basic requirements for adoption are intact, and the creature will only adopt individuals who have a [[preference]] for their species. Used by [[cat]]s in the vanilla game. When {{k|v}}iewing a tame creature with this token, the message "This animal isn't interested in your wishes" will appear instead of "This [adorable] animal can't work" or "This animal is waiting to be trained".

|-
| {{text anchor|ALCOHOL_DEPENDENT}}
| Caste
|
| Makes the creature need [[alcohol]] to get through the working day; it will choose to drink booze instead of [[water]] if possible. Going sober for too long reduces speed.

|-
| {{text anchor|ALL_ACTIVE}}
| Caste
|
| Sets the creature to be active during the day, night, and twilight in Adventurer Mode. Seems to be a separate value from {{token|DIURNAL|c}}/{{token|NOCTURNAL|c}}/{{token|CREPUSCULAR|c}}, rather than implying them.{{verify|code}}

|-
| {{text anchor|ALTTILE}}
| Creature
|
*'character' or tile number
| If set, the creature will blink between its {{token|TILE|c}} and its ALTTILE.

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

|-
| {{text anchor|AMPHIBIOUS}}
| Caste
|
| Allows a creature to breathe both in and out of [[water]] (unlike {{token|AQUATIC|c}}) - does not prevent drowning in [[magma]].

|-
| {{text anchor|APP_MOD_DESC_RANGE}}
| Caste
|
*Range (6 values, low to high)
| [http://www.bay12forums.com/smf/index.php?topic=113762.msg3473069#msg3473069 Forum post describing how description ranges work]

|-
| {{text anchor|APP_MOD_GENETIC_MODEL}}
| Caste
|
*Model (Accepts DOMINANT_MORE, DOMINANT_LESS, and MIX)
| Defines a genetic model for the relevant appearance modifier(s). May or may not do anything significant at present.

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

|-
| {{text anchor|APP_MOD_NOUN}}
| Caste
|
*noun
*SINGULAR or PLURAL
| Creates a noun for the appearance, and whether it is singular or plural.

|-
| {{text anchor|APP_MOD_RATE}}
| Caste
|
*Rate (integer)
*Scale (DAILY, YEARLY)
*min (growth)
*max (growth)
*start year
*start day
*end year
*end day
| Setting the growth rate of the modifier. The last two tokens can be replaced by NO_END to have growth continue indefinitely.

|-
| {{text anchor|APPLY_CREATURE_VARIATION}}
| Caste
|
*creature variation ID
*(optional) any amount of arbitrary arguments
| Applies the specified [[creature variation token|creature variation]]. See [[Creature_variation_token#Arguments_and_conditional_tokens]] for how the subsequent arguments may be used.

|-
| {{text anchor|APPLY_CURRENT_CREATURE_VARIATION}}
| Special
|
| Applies the effects of all pending {{token|CV_ADD_TAG|c}} and {{token|CV_REMOVE_TAG|c}} tokens that have been defined in the current creature.

|-
| {{text anchor|AQUATIC}}
| Caste
|
| Enables the creature to breathe in water, but causes it to air-drown on dry land.

|-
| {{text anchor|ARENA_RESTRICTED}}
| Caste
|
| Causes the creature to be excluded from the [[object testing arena]]'s creature spawning list. Typically applied to spoileriffic creatures.

|-
| {{text anchor|ARTIFICIAL_HIVEABLE}}
| Creature
|
| Enables the creature to be kept in artificial [[hive]]s by [[beekeeper]]s.

|-
| {{text anchor|AT_PEACE_WITH_WILDLIFE}}
| Caste
|
| Prevents the creature from attacking or frightening creatures with the {{Token|NATURAL|c}} tag.

|-
| {{text anchor|ATTACK}}
| Caste
|
*token
*bodypart
*selection criteria
*location
| Defines the attack name, and the body part used. See [[#Attack Tokens|below]] for valid subtokens
'''Example:''' 
<code>[ATTACK:GORE:BODYPART:BY_CATEGORY:HORN]</code> 
''GORE'' = name of the attack 
''BODYPART:BY_CATEGORY:HORN'' = the horn is used to attack (presuming the creature has one)

|-
| {{text anchor|ATTACK_TRIGGER}}
| Caste
|
*population
*exported wealth
*created wealth
| Specifies when a [[megabeast]] or [[semi-megabeast]] will attack the fortress. The attacks will start occurring when all of the requirements are met. Setting a value to 0 disables the trigger.

|}

{{alphabetical TOC|style=margin: 1em auto;}}

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

|-
| {{text anchor|BABY}}
| Caste
|
*integer
| Age at which creature is considered a child, the default is zero. One can think of this as the duration of the baby stage.

|-
| {{text anchor|BABYNAME}}
| Caste
|
*singular
*plural
| Defines a new name for a creature in baby state at the caste level. For non-caste-specific baby names, see {{token|GENERAL_BABY_NAME|c}}.

|-
| {{text anchor|BEACH_FREQUENCY}}
| Caste
|
*integer
| Creature may be subject to [[beaching]], becoming stranded on [[Beach|shores]], where they will eventually air-drown. The number indicates the frequency of the occurrence. Presumably requires the creature to be {{token|AQUATIC|c}}. Used by [[orca]]s, [[sperm whale]]s and [[sea nettle jellyfish]] in the vanilla game.

|-
| {{text anchor|BENIGN}}
| Caste
|
| The creature is non-aggressive by default, and will never automatically be engaged by companions or soldiers, running away from any creatures that are not friendly to it, and will only defend itself if it becomes enraged. Can be thought of as the counterpoint of the {{token|LARGE_PREDATOR|c}} tag. When tamed, animals with this tag will be useless for fortress defense.

|-
| {{text anchor|BIOME}}
| Creature
|
* [[biome token]]
| Select a [[biome]] the creature may appear in.

|-
| {{text anchor|BLOOD}}
| Caste
|
* <[[material token]]>
* <[[Material_definition_token#Material_States|material state]]>
| Specifies what the creature's blood is made of.

|-
| {{text anchor|BLOODSUCKER}}
| Caste
|
| Causes [[vampire]]-like behaviour; the creature will suck the [[Creature_token#BLOOD|blood]] of unconscious victims when its [[Syndrome#TIME_SINCE_SUCKED_BLOOD|thirst for blood]] grows sufficiently large. When controlling the creature in adventure mode, this can be done at will. Seems to be required to make the creature denouncable (in-world) as a creature of the night.

|-
| {{text anchor|BODY}}
| Caste
|
*body parts
| Draws body parts from OBJECT:BODY files (such as body_default.txt)
'''Example:''' 
[BODY:BODY_WITH_HEAD_FLAG:HEART:GUTS:BRAIN:MOUTH] 
This is the body from a [[purring maggot]]. It creates a body with head, a heart, some guts, a brain, and a mouth. That's all a maggot needs.

'''If the body is left undefined, the creature will cause a crash whenever it spawns.''' {{verify}}

|-
| {{text anchor|BODY_APPEARANCE_MODIFIER}}
| Caste
|
*ATTRIBUTE
*lowest
*lower
*low
*median
*high
*higher
*highest
| These body modifiers give individual creatures different characteristics. In the case of HEIGHT, BROADNESS and LENGTH, the modifier is also a percentage change to the BODY_SIZE of the individual creature. The seven numbers afterward give a distribution of ranges. Each interval has an equal chance of occurring.
'''Example:''' 
[BODY_APPEARANCE_MODIFIER:HEIGHT:90:95:98:100:102:105:110] 
''HEIGHT'' : marks the height to be changed 
''90:95:98:100:102:105:110'' : sets the range from the shortest (90% of the average height) to the tallest (110% of the average height) creature variation.

|-
| {{text anchor|BODY_DETAIL_PLAN}}
| Caste
|
*PlanName
*Arguments
| Loads a plan from 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:''' 
[BODY_DETAIL_PLAN:VERTEBRATE_TISSUE_LAYERS:SKIN:FAT:MUSCLE:BONE:CARTILAGE] 
This creates the detailed body of a [[fox]], the skin, fat, muscle, bones and cartilage out of the vertebrate tissues. 
A [[Purring maggot|maggot]] would only need: 
''[BODY_DETAIL_PLAN:EXOSKELETON_TISSUE_LAYERS:SKIN:FAT:MUSCLE]''

|-
| {{text anchor|BODY_SIZE}}
| Caste
|
*years
*days
*size
| Sets size at a given age. Size is in cubic centimeters, and for normal body materials, is roughly equal to the creature's average weight in grams.
'''Example:''' 
[BODY_SIZE:0:0:10000] 
[BODY_SIZE:1:168:50000] 
[BODY_SIZE:12:0:220000] 
This describes the size of a [[minotaur]]. Its birth size would be 10,000 cm3 (~10 kg). At 1 year and 168 days old it would be 50,000 cm3 (~50 kg). And as an adult (at 12 years old) it would be 220,000 cm3 and weigh roughly 220 kg.

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

|-
| {{text anchor|BONECARN}}
| Caste
|
| Creature eats bones. Implies {{token|CARNIVORE|c}}. [[Adventurer mode|Adventurers]] with this token are currently unable to eat bones.{{Bug|11069}}

|-
| {{text anchor|BP_ADD_TYPE}}
| Caste
|
| Adds a type to a body part - used with {{token|SET_BP_GROUP|c}}. In vanilla DF, this is used for adding the type '[[Body token#GELDABLE|GELDABLE]]' to the lower body of certain [[cat|creatures]].

|-
| {{text anchor|BP_APPEARANCE_MODIFIER}}
| Caste
|
*QUALITY
*lowest
*lower
*low
*median
*high
*higher
*highest
| Sets up the breadth of possibilities for appearance qualities for a selected BP group. EG. Eyes (CLOSE_SET, DEEP_SET, ROUND_VS_NARROW, LARGE_IRIS),Lips (THICKNESS), Nose (BROADNESS, LENGTH, UPTURNED, CONVEX), Ear (SPLAYED_OUT, HANGING_LOBES, BROADNESS, HEIGHT), Tooth (GAPS), Skull (HIGH_CHEEKBONES, BROAD_CHIN, JUTTING CHIN, SQUARE_CHIN), Neck (DEEP_VOICE, RASPY_VOICE), Head (BROADNESS, HEIGHT)

|-
| {{text anchor|BP_REMOVE_TYPE}}
| Caste
|
| Removes a type from a body part. Used with {{token|SET_BP_GROUP|c}}.

|-
| {{text anchor|BUILDINGDESTROYER}}
| Caste
|
*1 or 2
| Allows a creature to destroy furniture and buildings. Value [1] targets mostly doors, hatches, furniture and the like. Value [2] targets anything not made with the {{k|b}} + {{k|C}} commands.
|}

{{alphabetical TOC|style=margin: 1em auto;}}

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

|-
| {{text anchor|CAN_DO_INTERACTION}}
| Caste
|
*interaction token
| The creature can perform an interaction. See [[interaction token]].

|-
| {{text anchor|CAN_LEARN}}
| Caste
|
| The creature gains [[skill]]s and can have [[labor|professions]]. If a member of a civilization (even a pet) has this token, it'll need to eat, drink and sleep. Note that this token makes the creature unable to be eaten by an adventurer, so it is not recommended for uncivilized monsters. Adventurers lacking this token can allocate but not increase attributes and skills. Skills allocated will disappear on start.

|-
| {{text anchor|CAN_SPEAK}}
| Caste
|
| Can [[talking|talk]]. Note that this is not necessary for a creature to gain social skills.

|-
| {{text anchor|CANNOT_CLIMB}}
| Caste
|
| Creature cannot [[climber|climb]], even if it has free grasp parts.

|-
| {{text anchor|CANNOT_JUMP}}
| Caste
|
| Creature cannot [[jump]].

|-
| {{text anchor|CANNOT_UNDEAD}}
| Caste
|
| Acts like {{token|NOT_LIVING|c}}, except that {{token|OPPOSED_TO_LIFE|c}} creatures will attack them.

|-
| {{text anchor|CANOPENDOORS}}
| Caste
|
| Allows the creature to open [[door]]s that are set to be unpassable for pets. In adventure mode, creatures lacking this token will be unable to pass through door tiles except whilst these are occupied by other creatures.

|-
| {{text anchor|CARNIVORE}}
| Caste
|
| Creature ''only'' eats [[meat]]. If the creature goes on rampages in worldgen, it will often devour the people/animals it kills. Does not seem to affect the diet of the adventurer in adventure mode.

|-
| {{text anchor|CASTE}}
| Creature
|
*name
| Defines a [[caste]].

|-
| {{text anchor|CASTE_ALTTILE}}
| Caste
|
*tile number or "letter"
| Caste-specific {{token|ALTTILE|c}}. Requires {{token|CASTE_TILE|c}}.

|-
| {{text anchor|CASTE_COLOR}}
| Caste
|
*fg
*bg
*brightness
| Caste-specific {{token|COLOR|c}}.

|-
| {{text anchor|CASTE_GLOWCOLOR}}
| Caste
|
*fg
*bg
*brightness
| Caste-specific {{token|GLOWCOLOR|c}}.

|-
| {{text anchor|CASTE_GLOWTILE}}
| Caste
|
*tile value or "letter"
| Caste-specific {{token|GLOWTILE|c}}.

|-
| {{text anchor|CASTE_NAME}}
| Caste
|
*singular
*plural
*adjective
| Caste-specific {{token|NAME|c}}.

|-
| {{text anchor|CASTE_PROFESSION_NAME}}
| Caste
|
*[[Unit type token]] (Profession)
*singular
*plural
| Caste-specific {{token|PROFESSION_NAME|c}}.

|-
| {{text anchor|CASTE_SOLDIER_ALTTILE}}
| Caste
|
*'character' or tile number
| Caste-specific {{token|SOLDIER_ALTTILE|c}}. Requires {{token|CASTE_SOLDIER_TILE|c}}.

|-
| {{text anchor|CASTE_SOLDIER_TILE}}
| Caste
|
*'character' or tile number
| Caste-specific {{token|CREATURE_SOLDIER_TILE|c}}.

|-
| {{text anchor|CASTE_SPEECH}}
| Caste
|
*speech file
| Caste-specific {{token|SPEECH|c}}.

|-
| {{text anchor|CASTE_TILE}}
| Caste
|
* tile number or "letter"
| Caste-specific {{token|CREATURE_TILE|c}}.

|-
| {{text anchor|CAVE_ADAPT}}
| Caste
|
| Gives the creature a bonus in caves. Also causes [[cave adaptation]].

|-
| {{text anchor|CDI}}
| Caste
|
*Varies
| Specifies details for the preceding {{token|CAN_DO_INTERACTION|c}} token. See [[interaction token]].

|-
| {{text anchor|CHANGE_BODY_SIZE_PERC}}
| Caste
|
*integer
| Multiplies body size by a factor of (integer)%. 50 halves size, 200 doubles.

|-
| {{text anchor|CHANGE_FREQUENCY_PERC}}
| Creature
|
*integer
| Multiplies frequency by a factor of (integer)%.

|-
| {{text anchor|CHILD}}
| Caste
|
*integer
| Age at which creature is considered an adult - one can think of this as the duration of the [[children|child]] stage. Allows the creature's offspring to be rendered fully tame if [[animal trainer|trained]] during their childhood.

|-
| {{text anchor|CHILDNAME}}
| Caste
|
*singular
*plural
| Defines a new name for a creature in the child state at the caste level. For non-caste-specific child names, see {{token|GENERAL_CHILD_NAME|c}}.

|-
| {{text anchor|CLUSTER_NUMBER}}
| Creature
|
*min
*max
| The minimum/maximum numbers of how many creatures per spawned cluster. Certain vermin fish use this token in combination with temperate ocean and river biome tokens to perform seasonal migrations. Defaults to 1:1 if not specified.

|-
| {{text anchor|CLUTCH_SIZE}}
| Caste
|
*min
*max
|Number of [[egg]]s laid in one sitting.

|-
| {{text anchor|COLONY_EXTERNAL}}
| Caste
|
| Caste hovers around colony.

|-
| {{text anchor|COLOR}}
| Creature
|
*foreground
*background
*brightness
| Color of the creature's tile. See [[Color]] for usage.

|-
| {{text anchor|COMMON_DOMESTIC}}
| Caste
|
| When combined with any of {{token|PET|c}}, {{token|PACK_ANIMAL|c}}, {{token|WAGON_PULLER|c}} and/or {{token|MOUNT|c}}, the creature is guaranteed to be domesticated by any [[civilization]] with {{token|COMMON_DOMESTIC_PET|e}}, {{token|COMMON_DOMESTIC_PACK|e}}, {{token|COMMON_DOMESTIC_PULL|e}} and/or {{token|COMMON_DOMESTIC_MOUNT|e}} respectively. Such civilizations will always have access to the creature, even in the absence of wild populations. This token is invalid on {{token|FANCIFUL|c}} creatures.

|-
| {{text anchor|CONVERTED_SPOUSE}}
| Caste
|
| Creatures of this caste's species with the {{token|SPOUSE_CONVERTER|c}} and {{token|NIGHT_CREATURE_HUNTER|c}} tokens will kidnap {{token|SPOUSE_CONVERSION_TARGET|c}}s of an appropriate sex and convert them into castes with CONVERTED_SPOUSE.

|-
| {{text anchor|COOKABLE_LIVE}}
| Caste
|
| Set this to allow the creature to be cooked in meals without first being butchered/cleaned. Used by some water-dwelling vermin such as [[mussel]]s, [[nautilus]]es and [[oyster]]s.

|-
| {{text anchor|CRAZED}}
| Caste
|
| Creature is '[[insanity|berserk]]' and will attack all other creatures, except members of its own species that '''also''' have the CRAZED tag. It will show {{DFtext|Berserk|4:1}} in the [[unit list]]. Berserk creatures go on rampages during [[world generation|worldgen]] much more frequently than non-berserk ones.

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

|-
| {{text anchor|CREATURE_CLASS}}
| Caste
|
*classname
| An arbitrary creature classification. Can be set to anything, but the only vanilla uses are GENERAL_POISON (used in syndromes), EDIBLE_GROUND_BUG (used as targets for {{token|GOBBLE_VERMIN_CLASS|c}}), MAMMAL, and POISONOUS (both used for kobold pet eligibility). A single creature can have multiple classes.

The full list of tokens that use creature classes is:

* Creature tokens: {{token|GOBBLE_VERMIN_CLASS|c}}, {{token|GOBBLE_VERMIN_CLASS|c}}
* Interaction tokens: {{token|IT_AFFECTED_CLASS|in}}, {{token|IT_IMMUNE_CLASS|in}}
* Animal definition (Entity) tokens: {{token|ANIMAL_CLASS|e}}, {{token|ANIMAL_FORBIDDEN_CLASS|e}}
* Position (Entity) token: {{token|ALLOWED_CLASS|po}}
* Syndrome tokens: {{token|SYN_AFFECTED_CLASS|sy}}, {{token|SYN_IMMUNE_CLASS|sy}}, {{token|CE_SENSE_CREATURE_CLASS|sy}}
|-
| {{text anchor|CREATURE_SOLDIER_TILE}}
| Creature
|
*'character' or tile number
| Creatures active in their civilization's [[military]] will use this tile instead.

|-
| {{text anchor|CREATURE_TILE}}
| Creature
|
*'character' or tile number
| The symbol of the creature in ASCII mode.

|-
| {{text anchor|CREPUSCULAR}}
| Caste
|
| Sets the creature to be active at twilight in adventurer mode.

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

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

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

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

|-
| {{text anchor|CV_REMOVE_TAG}}
| Special
|
*TAG NAME
| Removes a tag. Used in conjunction with creature variation templates.
|}

{{alphabetical TOC|style=margin: 1em auto;}}

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

|-
| {{text anchor|DEMON}}
| Caste
|
| Found on generated [[demon]]s. Marks the caste to be used in the initial wave after breaking into the [[underworld]], and by the demon civilizations created during world-gen breachings{{verify}} {{version|0.47.01}}. Could not be specified in user-defined raws until version [[Release_information/0.47.01|0.47.01]].

|-
| {{text anchor|DESCRIPTION}}
| Caste
|
*text
| A brief description of the creature type, as displayed when viewing the creature's description/[[Thoughts and preferences|thoughts & preferences]] screen.

|-
| {{text anchor|DIE_WHEN_VERMIN_BITE}}
| Caste
|
| Causes the creature to die upon attacking. Used by [[honey bee]]s to simulate them dying after using their stingers.

|-
| {{text anchor|DIFFICULTY}}
| Caste
|
*integer
| Increases experience gain during adventure mode. Creatures with a difficulty of 11 or higher are not assigned for quests in adventure mode.

|-
| {{text anchor|DIURNAL}}
| Caste
|
| Sets the creature to be active during the day in Adventurer Mode.

|-
| {{text anchor|DIVE_HUNTS_VERMIN}}
| Caste
|
| The creature hunts vermin by diving from the air. On tame creatures, it has the same effect as {{token|HUNTS_VERMIN|c}}. Found on [[peregrine falcon]]s.

|-
| {{text anchor|DOES_NOT_EXIST}}
| Creature
|
| Adding this token to a creature prevents it from appearing in generated worlds (unless it's marked as [[Entity_token#ANIMAL_ALWAYS_PRESENT|always present]] for a particular civilisation). For example, adding it to [[dog]]s will lead to worlds being generated without dogs in them. Also removes the creature from the [[object testing arena]]'s spawn list. If combined with {{token|FANCIFUL|c}}, artistic depictions of the creature will occur regardless. Used by [[centaur]]s, [[chimera]]s and [[griffon]]s in the vanilla game.

Note: a creature tagged as DOES_NOT_EXIST can still be [[Interaction_token#I_EFFECT|summoned]] successfully, as long as it has a body defined in its raws. [http://www.bay12forums.com/smf/index.php?topic=165213.msg8086938#msg8086938]. It's also possible for another creature to [[Syndrome#CE_BODY_TRANSFORMATION|transform]] into it.
|}

{{alphabetical TOC|style=margin: 1em auto;}}

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

|-
| {{text anchor|EBO_ITEM}}
| Caste
|
*[[item token]]
*[[material token]] (ANY_HARD_STONE can be used for the material)
| Defines the item that the creature drops upon being [[butcher|butchered]]. Used with {{token|EXTRA_BUTCHER_OBJECT|c}}.

|-
| {{text anchor|EBO_SHAPE}}
| Caste
|
*gem shape
| The shape of the creature's extra [[butcher|butchering]] drop. Used with {{token|EXTRA_BUTCHER_OBJECT|c}}.

|-
| {{text anchor|EGG_MATERIAL}}
| Caste
|
* <[[material token]]>
* <[[Material_definition_token#Material_States|material state]]>
| Defines the material composition of [[egg]]s laid by the creature. [[creature_token#LAYS_EGGS|Egg-laying]] creatures in the default game define this 3 times, using LOCAL_CREATURE_MAT:EGGSHELL, LOCAL_CREATURE_MAT:EGG_WHITE, and then LOCAL_CREATURE_MAT:EGG_YOLK. Eggs will be made out of eggshell. Edibility is determined by tags on whites or yolk, but they otherwise do not exist.

|-
| {{text anchor|EGG_SIZE}}
| Caste
|
*size
| Determines the size of laid [[egg]]s. Doesn't affect hatching or cooking, but bigger eggs will be heavier, and may take longer to be hauled depending on the hauler's strength.

|-
| {{text anchor|EQUIPMENT_WAGON}}
| Creature
|
| Makes the creature appear as a large 3x3 [[wagon]] responsible for carrying trade goods, pulled by two {{token|WAGON_PULLER|c}} creatures and driven by a merchant.

|-
| {{text anchor|EQUIPS}}
| Caste
|
| Allows the creature to wear or wield items.

|-
| {{text anchor|EVIL}}
| Creature
|
| The creature is considered evil and will only show up in evil biomes. Civilizations with {{token|USE_EVIL_ANIMALS|e}} can domesticate them regardless of exotic status. Has no effect on cavern creatures except to restrict taming. A civilization with evil creatures can colonise evil areas.

|-
| {{text anchor|EXTRA_BUTCHER_OBJECT}}
| Caste
|
* BY_CATEGORY, BY_TYPE, BY_TOKEN
* TYPE, CATEGORY, or TOKEN
| The creature drops an additional object when [[butcher|butchered]], as defined by {{token|EBO_ITEM|c}} and {{token|EBO_SHAPE|c}}. Used for [[gizzard stone]]s in default creatures. For some materials, needs to be defined after caste definitions with SELECT_CASTE:ALL{{Bug|6355}}

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

|-
| {{text anchor|EXTRAVISION}}
| Caste
|
| The creature can see regardless of whether it has working eyes and has full 360 degree vision, making it impossible to strike the creature from a blind spot in combat.
|}

{{alphabetical TOC|style=margin: 1em auto;}}

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

|-
| {{text anchor|FANCIFUL}}
| Creature
|
| The creature is a thing of legend and known to all civilizations. Its materials cannot be requested or preferred. The tag also adds some art value modifiers. Used by a [[Fanciful|number of creatures]]. Conflicts with {{token|COMMON_DOMESTIC|c}}.

|-
| {{text anchor|FEATURE_ATTACK_GROUP}}
| Caste
|
| Found on [[Animal people#Subterranean animal people|subterranean animal-man]] tribals. Currently defunct. In previous versions, it caused these creatures to crawl out of chasms and underground rivers.

|-
| {{text anchor|FEATURE_BEAST}}
| Caste
|
| Found on [[forgotten beast]]s. Presumably makes it act as such, initiating underground attacks on fortresses, or leads to the pop-up message upon encountering one{{verify}}. Hides the creature from displaying in a world_sites_and_pops file. Does not create historical figures like generated forgotten beasts do. Could not be specified in user-defined raws until version [[Release_information/0.47.01|0.47.01]].

Requires specifying a {{token|BIOME|c}} in which the creature will live, and both surface and subterranean biomes are allowed. Does not stack with {{token|LARGE_ROAMING|c}} and if both are used the creature will not spawn. Appears to be incompatible with {{token|DEMON|c}} even if used in separate castes.

|-
| {{text anchor|FEMALE}}
| Caste
|
| Makes the creature biologically female, enabling her to [[Breeding|bear young]]. Usually specified inside a caste.

|-
| {{text anchor|FIREIMMUNE}}
| Caste
|
| Makes the creature immune to [[Interaction_token#FIREBALL|FIREBALL]] and [[Interaction_token#FIREJET|FIREJET]] attacks, and allows it to path through high temperature zones, like lava or fires. Does not, by itself, make the creature immune to the damaging effects of burning in [[fire]], and does not prevent general heat damage or melting on its own (this would require adjustments to be made to the creature's body [[Material_definition_token|materials]] - see the [[Dragon/raw|dragon raws]] for an example).

|-
| {{text anchor|FIREIMMUNE_SUPER}}
| Caste
|
| Like {{token|FIREIMMUNE|c}}, but also renders the creature immune to [[Interaction_token#DRAGONFIRE|DRAGONFIRE]] attacks.

|-
| {{text anchor|FISHITEM}}
| Caste
|
| The creature's corpse is a single [[Item_token#FISH_RAW|FISH_RAW]] food item that needs to be cleaned (into a [[Item_token#FISH|FISH]] item) at a [[fishery]] to become edible. Before being cleaned the item is referred to as "raw". The food item is categorized under "fish" on the food and stocks screens, and when uncleaned it is sorted under "raw fish" in the stocks (but does not show up on the food screen).
Without this or {{token|COOKABLE_LIVE|c}}, [[fishing|fished]] vermin will turn into food the same way as non-vermin creatures, resulting in multiple units of food (meat, brain, lungs, eyes, spleen etc.) from a single fished vermin. These units of food are categorized as meat by the game.

|-
| {{text anchor|FIXED_TEMP}}
| Caste
|
*temperature
| The creature's body is constantly at this temperature, heating up or cooling the surrounding area. Alters the temperature of the creature's inventory and all adjacent tiles, [[Temperature|with all the effects that this implies]] - may trigger wildfires at high enough values. Also makes the creature immune to extreme heat or cold, as long as the temperature set is not harmful to the materials that the creature is made from.

Note that temperatures of 12000 and higher may cause [[path|pathfinding]] issues in fortress mode.

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

|-
| {{text anchor|FLIER}}
| Caste
|
| Allows a creature to fly, independent of it having wings or not. Fortress Mode pathfinding only partially incorporates flying - flying creatures need a land path to exist between them and an area in order to access it, but as long as one such path exists, they do not need to use it, instead being able to fly over intervening obstacles. Winged creatures with this token can lose their ability to fly if their wings are crippled or severed. Winged creatures without this token will be unable to fly. (A 'wing' in this context refers to any body part with its own [[Body_token#FLIER|FLIER]] token).

|-
| {{text anchor|FREQUENCY}}
| Creature
|
*number, max 100
| Determines the chances of a creature appearing within its environment, with higher values resulting in more frequent appearance. Also affects the chance of a creature being brought in a caravan for trading. The game effectively considers all creatures that can possibly appear and uses the FREQUENCY value as a ''weight'' - for example, if there are three creatures with frequencies 10/25/50, the creature with [FREQUENCY:50] will appear approximately 58.8% of the time. Defaults to 50 if not specified. Not to be confused with {{token|POP_RATIO|c}}.
|}

{{alphabetical TOC|style=margin: 1em auto;}}

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

|-
| {{text anchor|GAIT}}
| Caste
|
* <gait type>
* <gait name>
* <max [[Gait#Speed|speed]]>
* <build up time>
* <max turning [[Gait#Speed|speed]]>
* <start [[Gait#Speed|speed]]>
* <energy expenditure>
* <gait flag(s)>
| Defines a gait by which the creature can move. See [[Gait]] for more information.

* <max speed> indicates the maximum [[Gait#Speed|speed]] achievable by a creature using this gait
* <start speed> indicates the creature's speed when it starts moving using this gait
* <build up time> indicates how long it will take for a creature using this gait to go from <start speed> to <max speed>. For example, a value of 10 means that it should be able to reach the maximum speed by moving 10 [[tile]]s in a straight line over even terrain.
* <max turning speed> indicates the maximum speed permissible when the creature suddenly changes its direction of motion. The creature's speed will be reduced to <max turning speed> if travelling at a higher speed than this before turning.
* <energy expenditure> indicates how energy-consuming the gait is. Higher values cause the creature to tire out faster. Persistent usage of a high-intensity gait will eventually lead to exhaustion and [[Status_icon#Non-flashing|collapse]].

'''NO_BUILD_UP''' can be specified instead of a <start speed> value to make the <max speed> instantly achievable upon initiating movement (this is equivalent to a <build up time> of 0). Note that <build up time> and <max turning speed> are both ignored if specified alongside this (as NO_BUILD_UP trumps <build up time> and preserves <max speed> whilst turning, and <max turning speed> cannot exceed <max speed>) so it is permissible to omit them so long as they are '''both''' omitted together.

It's possible to specify a <start speed> greater than the <max speed>; the moving creature will decelerate towards its <max speed> in this case.

'''valid gait types:'''
*'''WALK''' 
Used for moving normally over ground tiles.

*'''CRAWL''' 
Used for moving over ground tiles whilst [[Status_icon#Non-flashing|prone]].

*'''SWIM''' 
Used for moving through tiles containing [[water]] or [[magma]] at a [[Water#Depth|depth]] of at least 4/7.

*'''FLY''' 
Used for moving through [[open space]].

*'''CLIMB''' 
Used for moving whilst [[Climber|climbing]].

'''valid gait flags:'''
* '''AGILITY''' 
Speeds/slows movement depending on the creature's [[Attribute#Agility|Agility]] stat.

* '''STRENGTH''' 
Speeds/slows movement depending on the creature's [[Attribute#Strength|Strength]] stat.

* '''LAYERS_SLOW''' 
Makes [[Tissue_definition_token#THICKENS_ON_ENERGY_STORAGE|THICKENS_ON_ENERGY_STORAGE]] and [[Tissue_definition_token#THICKENS_ON_STRENGTH|THICKENS_ON_STRENGTH]] tissue layers slow movement depending on how thick they are. Adding the STRENGTH gait flag counteracts the impact of the latter layer.

* '''STEALTH_SLOWS:'''<percentage> 
Slows movement by the specified percentage when the creature is [[Ambusher|sneaking]].

|-
| {{text anchor|GENERAL_BABY_NAME}}
| Creature
|
*singular
*plural
| Like {{token|BABYNAME|c}}, but applied regardless of caste.

|-
| {{text anchor|GENERAL_CHILD_NAME}}
| Creature
|
*singular
*plural
| Like {{token|CHILDNAME|c}}, but applied regardless of caste.

|-
| {{text anchor|GENERAL_MATERIAL_FORCE_MULTIPLIER}}
| Caste
|
*value A
*value B
| Has the same function as {{token|MATERIAL_FORCE_MULTIPLIER|c}}, but applies to all attacks instead of just those involving a specific material. Appears to be overridden by MATERIAL_FORCE_MULTIPLIER ([[werebeast]]s, for example, use both tokens to provide resistance to all materials, with one exception to which they are especially vulnerable).

|-
| {{text anchor|GENERATED}}
| Creature
|
| Found on procedurally generated creatures like [[forgotten beast]]s, [[titan]]s, [[demon]]s, [[angel]]s, and [[night creature]]s. Cannot be specified in user-defined raws.

|-
| {{text anchor|GETS_INFECTIONS_FROM_ROT}}
| Caste
|
| Makes the creature get [[Health_care#Infection|infections]] from necrotic tissue.

|-
| {{text anchor|GETS_WOUND_INFECTIONS}}
| Caste
|
| Makes the creature's wounds become [[Health_care#Infection|infected]] if left untreated for too long.

|-
| {{text anchor|GLOWCOLOR}}
| Creature
|
*foreground
*background
*brightness
| The colour of the creature's {{token|GLOWTILE|c}}.

|-
| {{text anchor|GLOWTILE}}
| Creature
|
*ascii character
| If present, the being glows in the dark (generally used for Adventurer 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 {{token|CASTE_GLOWTILE|c}} instead.

|-
| {{text anchor|GNAWER}}
| Caste
|
*verb
| The creature can and will gnaw its way out of [[animal trap]]s and [[cage]]s using the specified verb, depending on the material from which it is made (normally wood).

|-
| {{text anchor|GOBBLE_VERMIN_CLASS}}
| Caste
|
*class
| The creature eats vermin of the specified class.

|-
| {{text anchor|GOBBLE_VERMIN_CREATURE}}
| Caste
|
*creature
*caste
| The creature eats a specified [[vermin]].

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

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

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

|-
| {{text anchor|GOOD}}
| Creature
|
| Creature is considered good and will only show up in good biomes - [[unicorn]]s, for example. Civilizations with {{token|USE_GOOD_ANIMALS|e}} can domesticate them regardless of exotic status. Has no effect on cavern creatures except to restrict taming. A civilization that has good creatures can colonise good areas in world-gen.

|-
| {{text anchor|GRASSTRAMPLE}}
| Caste
|
*value
| The value determines how rapidly [[grass]] is trampled when a creature steps on it - a value of 0 causes the creature to never damage grass, while a value of 100 causes grass to be trampled as rapidly as possible. Defaults to 5.

|-
| {{text anchor|GRAVITATE_BODY_SIZE}}
| Caste
|
*target value
| Used in Creature Variants. This token changes the adult body size to the average of the old adult body size and the target value and scales all intermediate growth stages by the same factor.

|-
| {{text anchor|GRAZER}}
| Caste
|
*number
| The creature is a grazer - if tamed in fortress mode, it needs a pasture to survive. The higher the number, the less frequently it needs to eat in order to live. Not used since 0.40.12, replaced by {{token|STANDARD_GRAZER|c}} to fix {{bugl|4113}}.
|}

{{alphabetical TOC|style=margin: 1em auto;}}

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

|-
| {{text anchor|HABIT}}
| Caste
|
*type
*probability
| Defines certain behaviors for the creature. The habit types are:
*COLLECT_TROPHIES
*COOK_PEOPLE
*COOK_VERMIN
*GRIND_VERMIN
*COOK_BLOOD
*GRIND_BONE_MEAL
*EAT_BONE_PORRIDGE
*USE_ANY_MELEE_WEAPON
*GIANT_NEST
*COLLECT_WEALTH.
These require the creature to have a {{token|LAIR|c}} to work properly, and also don't seem to work on creatures who are not a {{token|SEMIMEGABEAST|c}}, {{token|MEGABEAST|c}} or {{token|NIGHT_CREATURE_HUNTER|c}}.

|-
| {{text anchor|HABIT_NUM}}
| Caste
|
*number or TEST_ALL
| "If you set HABIT_NUM to a number, it should give you that exact number of habits according to the weights.".{{cite forum|60554/1719248}} All lists of HABITs are preceded by [HABIT_NUM:TEST_ALL]

|-
| {{text anchor|HAS_NERVES}}
| Caste
|
| The creature has nerves in its muscles. Cutting the muscle tissue can sever motor and sensory nerves.

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

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

|-
| {{text anchor|HOMEOTHERM}}
| Caste
|
*number or NONE
| Default 'NONE'. The creature's normal body [[temperature]]. Creature ceases maintaining temperature on death unlike fixed material temperatures. Provides minor protection from environmental temperature to the creature.

|-
| {{text anchor|HUNTS_VERMIN}}
| Caste
|
| Creature hunts and kills nearby [[vermin]].

|}

{{alphabetical TOC|style=margin: 1em auto;}}

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

|-
| {{text anchor|IMMOBILE}}
| Caste
|
| The creature cannot move. Found on [[sponge]]s. Will also stop a creature from breeding in fortress mode (MALE and FEMALE are affected, if one is IMMOBILE no breeding will happen).

|-
| {{text anchor|IMMOBILE_LAND}}
| Caste
|
| The creature is immobile while on land. Only works on {{token|AQUATIC|c}} creatures which can't breathe on land.

|-
| {{text anchor|IMMOLATE}}
| Caste
|
| The creature radiates [[fire]]. It will ignite, and potentially completely destroy, items the creature is standing on. Also gives the vermin a high chance of escaping from [[animal trap]]s and [[cage]]s made of any flammable materials (specifically ones that could be ignited by magma).

|-
| {{text anchor|INTELLIGENT}}
| Caste
|
| Alias for {{token|CAN_SPEAK|c}} + {{token|CAN_LEARN|c}} but additionally keeps creatures from being [[butcher|butchered]] by the AI during worldgen and post-gen. In fortress mode, {{token|CAN_LEARN|c}} is enough.

|-
| {{text anchor|ITEMCORPSE}}
| Caste
|
* [[item token]]
* [[material token]]
| Determines if the creature leaves behind a non-standard corpse (i.e. wood, statue, bars, stone, pool of liquid, etc.). [[Ethics]] may prevent actually using the item in jobs or reactions.

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

{{alphabetical TOC|style=margin: 1em auto;}}

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

|-
| {{text anchor|LAIR}}
| Caste
|
*type
*probability
| Found on megabeasts, semimegabeasts, and night creatures. The creature will seek out sites of this type and take them as lairs. The lair types are:
*SIMPLE_BURROW
*SIMPLE_MOUND
*WILDERNESS_LOCATION
*SHRINE
*LABYRINTH

|-
| {{text anchor|LAIR_CHARACTERISTIC}}
| Caste
|
*characteristic
*probability
| Defines certain features of the creature's lair. The only valid characteristic is HAS_DOORS.

|-
| {{text anchor|LAIR_HUNTER}}
| Caste
|
| This creature will actively hunt adventurers in its lair.

|-
| {{text anchor|LAIR_HUNTER_SPEECH}}
| Caste
|
*speech file
| What this creature says while hunting adventurers in its lair.

|-
| {{text anchor|LARGE_PREDATOR}}
| Caste
|
| Will attack things that are smaller than it (like dwarves). Only one group of "large predators" (possibly two groups on "savage" maps) will appear on any given map. In adventure mode, large predators will try to ambush and attack you (and your party will attack them back). When tamed, large predators tend to be much more aggressive to enemies than non-large predators, making them a good choice for an animal army. They may go on rampages in worldgen, and adventurers may receive quests to kill them. Also, they can be mentioned in the intro paragraph when starting a fortress e.g. "ere the wolves get hungry."

|-
| {{text anchor|LARGE_ROAMING}}
| Creature
|
| This is the core requisite tag allowing the creature to spawn as a wild animal in the appropriate biomes. Requires specifying a {{token|BIOME|c}} in which the creature will spawn. Does not require specifying a frequency, population number, or cluster number.

This tag stacks with {{token|MEGABEAST|c}}, {{token|SEMIMEGABEAST|c}}, or {{token|NIGHT_CREATURE_HUNTER|c}}; if used with one of these tags, the creature will spawn as both a boss and as a wild animal. This tag does not stack with {{token|FEATURE_BEAST|c}} and if both are used the creature will not spawn. This tag is uneffected by {{token|DEMON|c}}.

|-
| {{text anchor|LAYS_EGGS}}
| Caste
|
| Creature lays [[egg]]s instead of giving birth to live young.

|-
| {{text anchor|LAYS_UNUSUAL_EGGS}}
| Caste
|
* [[item token]]
* [[material token]]
| Creature lays the specified item instead of regular eggs.

|-
| {{text anchor|LIGAMENTS}}
| Caste
|
* [[material token]]
*healing rate
| The creature has ligaments in its {{token|CONNECTIVE_TISSUE_ANCHOR|td}} tissues (bone or chitin by default). Cutting the bone/chitin tissue severs the ligaments, disabling motor function if the target is a limb.

|-
| {{text anchor|LIGHT_GEN}}
| Caste
|
| The creature will generate light, such as in adventurer mode at night.
|-
| {{text anchor|LIKES_FIGHTING}}
| Caste
|
| The creature will attack enemies rather than flee from them. This tag has the same effect on player-controlled creatures - including modded dwarves. Retired as of v0.40.14 in favor of {{token|LARGE_PREDATOR|c}}.

|-
| {{text anchor|LISP}}
| Caste
|
| Creature uses "sssssnake talk" (multiplies 'S' when talking - "My name isss Recisssiz."). Used by [[Serpent man|serpent men]] and [[Reptile man|reptile men]] in the vanilla game. C's with the same pronunciation (depending on the word) are not affected by this token.

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

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

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

|-
| {{text anchor|LOCKPICKER}}
| Caste
|
| Lets a creature open [[door]]s that are set to forbidden in fortress mode.

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

|-
| {{text anchor|LOW_LIGHT_VISION}}
| Caste
|
*number
| Determines how well a creature can see in the dark - higher is better. Dwarves have 10000, which amounts to perfect nightvision.
|}

{{alphabetical TOC|style=margin: 1em auto;}}

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

|-
| {{text anchor|MAGICAL}}
| Caste
|
| According to Toady One, this is completely interchangeable with {{token|AT_PEACE_WITH_WILDLIFE|c}} and might have been used in very early versions of the game by wandering wizards or the ent-type tree creatures that used to be animated by elves. [http://www.bay12forums.com/smf/index.php?topic=169696.msg8316954#msg8316954]

|-
| {{text anchor|MAGMA_VISION}}
| Caste
|
| The creature is able to see while submerged in [[magma]].

|-
| {{text anchor|MALE}}
| Caste
|
| Makes the creature biologically male. Usually declared inside a caste.

|-
| {{text anchor|MANNERISM|MANNERISM_*}}
| Caste
|
*occasionally body part
| Adds a possible mannerism to the creature's profile. See [[creature mannerism token]] for further info.

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

|-
| {{text anchor|MATERIAL_FORCE_MULTIPLIER}}
| Caste
|
*[[Material token]]
*value A
*value B
| When struck with a weapon made of the specified material, the force exerted will be multiplied by A/B, thus making the creature more or less susceptible to this material. For example, if A is 2 and B is 1, the force exerted by the defined material will be doubled. If A is 1 and B is 2, it will be halved instead. See also {{token|GENERAL_MATERIAL_FORCE_MULTIPLIER|c}}, which can be used to make this sort of effect applicable to all materials.

|-
| {{text anchor|MATUTINAL}}
| Caste
|
| Sets the creature to be active at dawn in adventurer mode.

|-
| {{text anchor|MAXAGE}}
| Caste
|
*min
*max
| Determines the creature's natural lifespan, using the specified minimum and maximum age values (in years). Each individual creature with this token is generated with a predetermined date (calculated down to the exact [[time|tick]]!) between these values, at which it is destined to die of old age, should it live long enough. Note that the probability of death at any given age does not increase as the creature gets older [http://i.imgur.com/A1A4aA9.png].
Creatures which lack this token are naturally immortal. The [[Syndrome#CE_ADD_TAG|NO_AGING]] syndrome tag will prevent death by old age from occurring. Also note that, among civilized creatures, castes which lack this token will refuse to marry others with it, and vice versa.

|-
| {{text anchor|MEANDERER}}
| Caste
|
| Makes the creature slowly stroll around, unless it's in combat or performing a job. If combined with {{token|CAN_LEARN|c}}, will severely impact their [[pathfinding]] and lead the creature to move extremely slowly when not performing any task. Problematically applies to animal people based on the animal and war trained animals{{bug|9588}}.

|-
| {{text anchor|MEGABEAST}}
| Caste
|
| A 'boss' creature. A small number of the creatures are created during worldgen, their histories and descendants (if any) will be tracked in worldgen (as opposed to simply 'spawning'), and they will occasionally go on rampages, potentially leading to worship if they attack the same place multiple times. Their presence and number will also influence age names. When appearing in fortress mode, they will have a pop-up message announcing their arrival. They will remain hostile to military even after being tamed.{{bug|10731}} See [[megabeast]] page for more details.

Requires specifying a {{token|BIOME|c}} in which the creature will live. Subterranean biomes appear to not be allowed. Does stack with {{token|LARGE_ROAMING|c}} and if both are used the creature will spawn as both historical bosses and as wild animals.

|-
| {{text anchor|MENT_ATT_CAP_PERC}}
| Caste
|
*[[Attribute|ATTRIBUTE]] Token
*Cap %
|Default is 200. This means you can increase your attribute to 200% of its starting value (or the average value + your starting value if that is higher).

|-
| {{text anchor|MENT_ATT_RANGE}}
| Caste
|
*[[Attribute|ATTRIBUTE]]
*lowest
*lower
*low
*median
*high
*higher
*highest
| Sets up a [[Attribute#Soul_attributes|mental attribute]]'s range of values (0-5000). All mental attribute ranges default to 200:800:900:1000:1100:1300:2000.

|-
| {{text anchor|MENT_ATT_RATES}}
| Caste
|
*[[Attribute|ATTRIBUTE]] Token
*cost to improve
*unused counter rate
*rust counter rate
*demotion counter rate
| [[Attribute#Soul_attributes|Mental attribute]] gain/decay rates. Lower numbers in the last three slots make decay occur faster. Defaults are 500:4:5:4.

|-
| {{text anchor|MILKABLE}}
| Caste
|
* [[material token]]
* frequency
| Allows the creature to be [[milk]]ed in the [[farmer's workshop]]. The frequency is the amount of [[time|ticks]] the creature needs to "recharge" (i.e. how much time needs to pass before it can be milked again). Does not work on [[#CAN_LEARN|sentient]] creatures, regardless of [[ethics]].

|-
| {{text anchor|MISCHIEVIOUS}}
| Caste
|
| Alias for {{token|MISCHIEVOUS|c}}.

|-
| {{text anchor|MISCHIEVOUS}}
| Caste
|
| The creature spawns [[stealth]]ed and will attempt to path into the fortress, pulling any [[lever]]s it comes across. It will be invisible on the map and [[unit list]] until spotted by a citizen, at which point the game will pause and recenter on the creature. Used by [[gremlin]]s in the vanilla game. "They go on little missions to mess with various fortress buildings, not just levers."

|-
| {{text anchor|MODVALUE}}
| Caste
|
| Seemingly no longer used.

|-
| {{text anchor|MOUNT}}
| Caste
|
| Creature may be used as a [[mount]]. No use for the player in fortress mode, but enemy sieging forces may arrive with cavalry. Mounts are usable in adventure mode.

|-
| {{text anchor|MOUNT_EXOTIC}}
| Caste
|
| Creature may be used as a [[mount]], but civilizations cannot domesticate it in worldgen without certain exceptions.

|-
| {{text anchor|MULTIPART_FULL_VISION}}
| Caste
|
| Allows the creature to have all-around vision as long as it has multiple heads that can see.

|-
| {{text anchor|MULTIPLE_LITTER_RARE}}
| Caste
|
| Makes the species usually produce a single offspring per birth, occasionally producing twins or triplets with a 1/500 chance. Requires {{token|FEMALE|c}}.

|-
| {{text anchor|MUNDANE}}
| Creature
|
| Marks if the creature is an actual real-life creature. Only used for age-names at present.
|}

{{alphabetical TOC|style=margin: 1em auto;}}

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

|-
| {{text anchor|NAME}}
| Creature
|
*singular
*plural
*adjective
| The generic name for any creature of this type - will be used when distinctions between caste are unimportant. For names for specific castes, use {{token|CASTE_NAME|c}} instead. If left undefined, the creature will be labeled as "nothing" by the game.

|-
| {{text anchor|NATURAL}}
| Caste
|
| Animal is considered to be natural. NATURAL animals will not engage creatures tagged with {{token|AT_PEACE_WITH_WILDLIFE|c}} in combat unless they are members of a hostile entity and vice-versa.

|-
| {{text anchor|NATURAL_ANIMAL}}
| Caste
|
| Alias of {{token|NATURAL|c}}.

|-
| {{text anchor|NATURAL_SKILL}}
| Caste
|
*[[Skill_token|Skill token]]
*value
| The creature possesses the specified [[skill]] at this level inherently - that is, it begins with the skill at this level, and the skill may never rust below that. A value of 15 is legendary.

|-
| {{text anchor|NIGHT_CREATURE_BOGEYMAN}}
| Caste
|
| Creatures with this token can appear in [[bogeyman|bogeyman ambushes]] in [[adventure mode]], where they adopt classical bogeyman traits such as stalking the adventurer and vaporising when dawn breaks. Such traits do not manifest if the creature is encountered outside of a bogeyman ambush (for instance, as a megabeast or a civilised being). In addition, their corpses and severed body parts turn into [[smoke]] after a short while. Note that setting the "Number of Bogeyman Types" in [[advanced world generation]] to 0 will only remove randomly-generated bogeymen.

|-
| {{text anchor|NIGHT_CREATURE_EXPERIMENTER}}{{version|0.47.01}}
| Caste
|
| Found on some [[necromancer]]s. Creatures with this tag may periodically "perform horrible experiments" offscreen, during which they can use creature-targeting interactions with an <code>[[Interaction_token#I_SOURCE|[I_SOURCE:EXPERIMENT]]]</code> tag on living creatures in their area. Worlds are generated with a list of procedurally-generated experiments, allowing necromancers to turn living people and animals into [[Infected_ghoul|ghouls]] and [[Experiment|other experimental creatures]], and these will automatically be available to all experimenters; it does not appear possible to prevent this. You can mod in your own custom experiment interactions, but these are used very infrequently due to the large number of generated experiments.

|-
| {{text anchor|NIGHT_CREATURE_HUNTER}}
| Caste
|
| Found on [[night troll]]s and [[werebeast]]s. Implies that the creature is a [[night creature]], and shows its description in [[legends mode]] entry. The creature is always hostile and will start [[no quarter]] combat with any nearby creatures, except for members of its own race. Note that this tag does not override the creature's normal behavior in [[fortress mode]] except for the aforementioned aggression, and doesn't prevent the creature from fleeing the battles it started. It also removes the creature's materials from stockpile settings list, making them be stored there regardless of settings.

Does stack with {{token|LARGE_ROAMING|c}} and if both are used the creature will spawn as both historical hunters and as wild animals; this requires specifying a {{token|BIOME|c}} in which the creature will live, and subterranean biomes are allowed.

This tag causes the usual behaviour of werebeasts in worldgen, that is, fleeing towns upon being cursed and conducting raids from a lair. If this tag is absent from a deity curse, the accursed will simply be driven out of towns in a similar manner to [[vampire]]s. When paired with SPOUSE_CONVERTER, a very small population of the creature will be created during worldgen (sometimes only a single individual will be created), and their histories will be tracked (that is, they will not spawn spontaneously later, they must either have children or convert other creatures to increase their numbers). The creature will settle in a lair and go on rampages during worldgen. It will actively attempt to seek out potential conversion targets to abduct, convert, and have children with (if possible).

|-
| {{text anchor|NIGHT_CREATURE_NIGHTMARE}}{{version|0.47.01}}
| Caste
|
| Found on [[nightmare]]s. Corpses and severed body parts derived from creatures with this token turn into [[smoke]] after a short while.

|-
| {{text anchor|NO_AUTUMN}}
| Caste
|
| The creature caste does not appear in [[Calendar|autumn]].

|-
| {{text anchor|NO_CONNECTIONS_FOR_MOVEMENT}}
| Caste
|
| Creature doesn't require connected body parts to move{{verify}}; generally used on undead creatures with connections that have rotted away.

|-
| {{text anchor|NO_DIZZINESS}}
| Caste
|
| Creature cannot become [[Symptom#Dizziness|dizzy]].

|-
| {{text anchor|NO_DRINK}}
| Caste
|
| Creature does not need to drink.

|-
| {{text anchor|NO_EAT}}
| Caste
|
| Creature does not need to [[food|eat]]. Seems to cause worldgen crashes if it is part of an entity with [[entity_token#PERMITTED_JOB|[PERMITTED_JOB:FISHERMAN]]]{{verify}}

|-
| {{text anchor|NO_FEVERS}}
| Caste
|
| Creature cannot suffer [[Symptom#Fever|fevers]].

|-
| {{text anchor|NO_GENDER}}
| Caste
|
| The creature is biologically sexless. Makes the creature unable to [[breeding|breed]].

|-
| {{text anchor|NO_PHYS_ATT_GAIN}}
| Caste
|
| The creature cannot raise any [[Attribute#Body_attributes|physical attributes]].

|-
| {{text anchor|NO_PHYS_ATT_RUST}}
| Caste
|
| The creature cannot lose any [[Attribute#Body_attributes|physical attributes]].

|-
| {{text anchor|NO_SLEEP}}
| Caste
|
| Creature does not need to sleep. Can still be rendered unconscious by other means.

|-
| {{text anchor|NO_SPRING}}
| Caste
|
| The creature caste does not appear in [[Calendar|spring]].

|-
| {{text anchor|NO_SUMMER}}
| Caste
|
| The creature caste does not appear in [[Calendar|summer]].

|-
| {{text anchor|NO_THOUGHT_CENTER_FOR_MOVEMENT}}
| Caste
|
| Creature doesn't require an organ with the {{token|THOUGHT|body}} tag to survive or attack; generally used on creatures that don't have brains.

|-
| {{text anchor|NO_UNIT_TYPE_COLOR}}
| Caste
|
| Prevents creature from selecting its color based on its profession (e.g. Miner, Hunter, Wrestler).

|-
| {{text anchor|NO_VEGETATION_PERTURB}}
| Caste{{Verify}}
|
| Likely prevents the creature from leaving broken vegetation tracks.{{Verify}}

|-
| {{text anchor|NO_WINTER}}
| Caste
|
| The creature caste does not appear in [[Calendar|winter]].

|-
| {{text anchor|NOBONES}}
| Caste
|
| Creature has no bones.

|-
| {{text anchor|NOBREATHE}}
| Caste
|
| Creature doesn't need to breathe or have {{token|BREATHE|body}} parts in body, nor can it drown or be strangled. Creatures living in magma must have this tag, otherwise they will drown.

|-
| {{text anchor|NOCTURNAL}}
| Caste
|
| Sets the creature to be active at night in adventure mode.

|-
| {{text anchor|NOEMOTION}}
| Caste
|
| Creature has no emotions. It is immune to the effects of [[stress]] and unable to rage, and its [[need]]s cannot be fulfilled in any way. Used on [[undead]] in the vanilla game.

|-
| {{text anchor|NOEXERT}}
| Caste
|
| Creature can't become tired or over-exerted from taking too many combat actions or moving at full speed for extended periods of time.

|-
| {{text anchor|NOFEAR}}
| Caste
|
| Creature doesn't feel fear and will never flee from battle, and will be immune to [[ghost]]s' attempts to 'scare it to death'. Additionally, it causes [[bogeyman|bogeymen]] and [[nightmare]]s to become friendly towards the creature.

|-
| {{text anchor|NOMEAT}}
| Caste
|
| Creature will not drop meat when [[butcher|butchered]].

|-
| {{text anchor|NONAUSEA}}
| Caste
|
| Creature isn't nauseated by gut hits and cannot vomit.

|-
| {{text anchor|NOPAIN}}
| Caste
|
| Creature doesn't feel pain.

|-
| {{text anchor|NOSKIN}}
| Caste
|
| Creature will not drop a hide when [[butcher|butchered]].

|-
| {{text anchor|NOSKULL}}
| Caste
|
| Creature will not drop a skull on butchering, rot, or decay of severed head.

|-
| {{text anchor|NOSMELLYROT}}
| Caste
|
| Does not produce [[miasma]] when rotting.

|-
| {{text anchor|NOSTUCKINS}}
| Caste
|
| Weapons can't get stuck in the creature.

|-
| {{text anchor|NOSTUN}}
| Caste
|
| Creature can't be stunned and knocked unconscious by pain or head injuries. Creatures with this tag never wake up from sleep in Fortress Mode. If this creature needs to sleep while playing, it will die.

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

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

|-
| {{text anchor|NOTHOUGHT}}
| Caste
|
| Creature doesn't require a {{token|THOUGHT|body}} body part to survive. Has the added effect of preventing speech, though directly controlling creatures that would otherwise be capable of speaking allows them to engage in conversation.
|}

{{alphabetical TOC|style=margin: 1em auto;}}

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

|-
| {{text anchor|ODOR_LEVEL}}
| Caste
|
*number
| How easy the creature is to [[smell]]. The higher the number, the easier the creature is to sniff out. Defaults to 50. Vanilla creatures have values from 0 (undetectable) to 90 (noticeable by humans and dwarves).

|-
| {{text anchor|ODOR_STRING}}
| Caste
|
*string
| What the creature [[smell]]s like. If no odor string is defined, the creature name (not the caste name) is used.

|-
| {{text anchor|OPPOSED_TO_LIFE}}
| Caste
|
| Is hostile to all creatures except undead and other non-living ones and will show {{DFtext|Opposed to life|0:1}} in the [[unit list]]. Used by [[undead]] in the vanilla game. Functions without the {{token|NOT_LIVING|c}} token, and seems to imply said token as well. Undead will not be hostile to otherwise-living creatures given this token. Living creatures given this token will attack living creatures that lack it, while ignoring other living creatures that also have this token.

|-
| {{text anchor|ORIENTATION}}
| Caste
|
*MALE/FEMALE
*disinterested chance
*lover-possible chance
*preference(?)-possible chance
| Determines caste's likelihood of having sexual attraction to certain sexes. Values default to 75:20:5 for the same sex and 5:20:75 for the opposite sex. The first value indicates how likely to be entirely uninterested in the sex, the second decides if the creature will become lovers, the third decides if the creature will "prefer" this sex{{Verify}}. Marriage can happen as long as they are not disinterested. The values themselves are simply ratios and do not need to add up to any particular value.

|-
| {{text anchor|OUTSIDER_CONTROLLABLE}}{{version|0.42.01}}
| Caste
|
| Lets you play as an [[Adventurer_mode_character_creation#Outsider|outsider]] of this species in adventure mode.

|}

{{alphabetical TOC|style=margin: 1em auto;}}

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

|-
| {{text anchor|PACK_ANIMAL}}
| Caste
|
| Allows the creature to be used as a pack animal. Used by [[trading|merchants]] without wagons and adventurers. Also prevents creature from dropping hauled items on its own -- do ''not'' use for player-controllable creatures!

|-
| {{text anchor|PARALYZEIMMUNE}}
| Caste
|
| The creature is immune to all [[Syndrome#CE_PARALYSIS|paralyzing]] special attacks.

|-
| {{text anchor|PATTERNFLIER}}
| Caste
|
| Used to control the bat riders with paralyze-dart blowguns that flew through the 2D chasm. Doesn't do anything now.

|-
| {{text anchor|PEARL}}
| Caste
|
| In earlier versions, creature would generate [[pearl]]s. Does nothing in the current version.{{verify}}

|-
| {{text anchor|PENETRATEPOWER}}
| Caste
|
*value
| Controls the ability of [[vermin]] to find a way into containers when they are eating food from your stockpiles.

Objects made of most materials (e.g. metal) roll a number from 0-100, and if the resulting number is greater than the penetrate power, their contents escape for the time being. Objects made of [[wood]], [[leather]], [[amber]], or [[coral]] roll 0-95, and items made of [[cloth]] roll 0-90.

|-
| {{text anchor|PERSONALITY}}
| Caste
|
*ATTRIBUTE
*lowest
*median
*highest
| Determines the range and chance of personality traits. Standard is 0:50:100. See [[Personality trait]] for more info.

|-
| {{text anchor|PET}}
| Caste
|
| Allows the creature to be [[Animal_trainer|tamed]] in Fortress mode. Prerequisite for all other working animal roles. Civilizations that encounter it in worldgen will tame and domesticate it for their own use. Adding this to civilization members will classify them as pets instead of citizens, with all the [[Fun|problems]] that entails. However, you can solve these problems using the popular plugin [https://dffd.bay12games.com/file.php?id=13095| Dwarf Therapist], which is completely unaffected by the tag.

|-
| {{text anchor|PET_EXOTIC}}
| Caste
|
| Allows the creature to be [[Animal_trainer|tamed]] in Fortress mode. Prequisite for all other working animal roles. Civilizations cannot domesticate it in worldgen, with certain exceptions. More difficult to tame?{{verify}} Adding this to civilization members will classify them as pets instead of citizens, with all the [[Fun|problems]] that entails. ([[Gremlin|Example]]).

|-
| {{text anchor|PETVALUE}}
| Caste
|
*value
| How valuable a tamed animal is. Actual cost in points in the embarking screen is 1+(PETVALUE/2) for an untrained animal, 1+PETVALUE for a war/hunting one.

|-
| {{text anchor|PETVALUE_DIVISOR}}
| Caste
|
*value
| Divides the creature's {{token|PETVALUE|c}} by the specified number. Used by [[honey bee]]s to prevent a single hive from being worth a fortune.

|-
| {{text anchor|PHYS_ATT_CAP_PERC}}
| Caste
|
*[[Attribute|ATTRIBUTE]] Token
*Cap %
|Default is 200. This means you can increase your attribute to 200% of its starting value (or the average value + your starting value if that is higher).

|-
| {{text anchor|PHYS_ATT_RANGE}}
| Caste
|
*[[Attribute|ATTRIBUTE]]
*lowest
*lower
*low
*median
*high
*higher
*highest
| Sets up a [[Attribute#Body_attributes|physical attribute]]'s range of values (0-5000). All physical attribute ranges default to 200:700:900:1000:1100:1300:2000.

|-
| {{text anchor|PHYS_ATT_RATES}}
| Caste
|
*[[Attribute|ATTRIBUTE]] Token
*cost to improve
*unused counter rate
*rust counter rate
*demotion counter rate
| [[Attribute#Body_attributes|Physical attribute]] gain/decay rates. Lower numbers in the last three slots make decay occur faster. Defaults for STRENGTH, AGILITY, TOUGHNESS, and ENDURANCE are 500:3:4:3, while RECUPERATION and DISEASE_RESISTANCE default to 500:NONE:NONE:NONE.

|-
| {{text anchor|PLUS_BP_GROUP}}
| Caste
|
*BY_TYPE, BY_CATEGORY, or BY_TOKEN
*body type, category, or token
| Adds a body part group to selected body part group. Presumably used immediately after {{token|SET_BP_GROUP|c}}.

|-
| {{text anchor|PLUS_MATERIAL}}
| Creature
|
*material
| Adds a material to selected materials. Used immediately after {{token|SELECT_MATERIAL|c}}.

|-
| {{text anchor|POP_RATIO}}
| Caste
|
*number
| Weighted population of caste; Lower is rarer. Not to be confused with {{token|FREQUENCY|c}}.

|-
| {{text anchor|POPULATION_NUMBER}}
| Creature
|
*min
*max
| The minimum/maximum numbers of how many of these creatures are present in each world map tile of the appropriate region. Defaults to 1:1 if not specified.

|-
| {{text anchor|POWER}}
| Caste
|
| Allows the being to represent itself as a deity, allowing it to become the leader of a civilized group. Used by unique demons in the vanilla game. Requires {{token|CAN_SPEAK|c}} to actually do anything more than settle at a location (e.g. write books, lead armies, profane temples). Doesn't appear to do anything for creatures that are already civilized. Once the creature ascends to a position of leadership, it will proceed to act as a standard ruler for their entity and fulfill the same functions (hold tournaments, tame creatures, etc).

|-
| {{text anchor|PREFSTRING}}
| Creature
|
*string
| Sets what other creatures [[Preferences|prefer]] about this creature. "Urist likes dwarves for their beards." Multiple entries will be chosen from at random. Creatures lacking a PREFSTRING token will never appear under another's preferences.

|-
| {{text anchor|PROFESSION_NAME}}
| Creature
|
*[[Unit type token]] (Profession)
*singular
*plural
| The generic name for members of this profession, at the creature level. In order to give members of specific castes different names for professions, use {{token|CASTE_PROFESSION_NAME|c}} instead.

|-
| {{text anchor|PRONE_TO_RAGE}}
| Caste
|
*Chance
| Creature has a percentage chance to flip out at visible non-friendly creatures. Enraged creatures attack anything regardless of timidity and get a strength bonus to their hits. This is what makes [[badger]]s so hardcore.

|-
| {{text anchor|PUS}}
| Caste
|
* <[[material token]]>
* <[[Material_definition_token#Material_States|material state]]>
| The creature has pus. Specifies the stuff secreted by [[Health_care#Infection|infected wounds]].
|}

{{alphabetical TOC|style=margin: 1em auto;}}

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

|-
| {{text anchor|RELSIZE}}
| Caste
|
*BY_CATEGORY, BY_TYPE, BY_TOKEN
*body category, type, or token
*Relsize
| Specifies a new relative size for a part than what is stated in the body plan. For example, dwarves have larger livers.

|-
| {{text anchor|REMAINS}}
| Caste
|
*singular
*plural
| What the creature's [[remains]] are called.

|-
| {{text anchor|REMAINS_COLOR}}
| Caste
|
| What color the creature's [[remains]] are.

|-
| {{text anchor|REMAINS_ON_VERMIN_BITE_DEATH}}
| Caste
|
| Goes with {{token|VERMIN_BITE|c}} and {{token|DIE_WHEN_VERMIN_BITE|c}}, the vermin creature will leave remains on death when biting. Leaving this tag out will cause the creature to disappear entirely after it bites.

|-
| {{text anchor|REMAINS_UNDETERMINED}}
| Caste
|
| Unknown.

|-
| {{text anchor|REMOVE_MATERIAL}}
| Creature
|
*material token
| Removes a material from the creature.

|-
| {{text anchor|REMOVE_TISSUE}}
| Creature
|
*tissue token
| Removes a tissue from the creature.

|-
| {{text anchor|RETRACT_INTO_BP}}
| Caste
|
*BY_TYPE, BY_CATEGORY or BY_TOKEN
*body type, [[Body_token#CATEGORY|category]], or [[Body_token#BP|token]]
*Second person ("You") retract verb text
*Third person ("The giant snail") retract verb text
*Second person cancel retract text
*Third person cancel retract text
| The creature will retract into a body part when threatened. It will be unable to move or attack, but enemies will only be able to attack the specified body part. (eg. Turtle, Hedgehog)

Second-person descriptions are used for adventurer mode natural ability. "<pro_pos>" can be used in the descriptions, being replaced with the proper pronoun (or lack thereof) in-game.

Undead curled up creatures are buggy{{bug|11463}}{{bug|10519}}.
|-
| {{text anchor|RETURNS_VERMIN_KILLS_TO_OWNER}}
|
|
| Cat behavior. If it kills a vermin creature and has an owner, it carries the remains in its mouth and drops them at their feet. Requires {{token|HUNTS_VERMIN|c}}, obviously.

|-
| {{text anchor|ROOT_AROUND}}
| Caste
|
*BY_TYPE, BY_CATEGORY or BY_TOKEN
*body type, [[Body_token#CATEGORY|category]], or [[Body_token#BP|token]]
*Second person ("You") verb text
*Third person ("The hen") verb text
| Creature will occasionally root around in the grass, looking for insects. Used for flavor in Adventurer Mode, spawns vermin edible for this creature in Fortress Mode. Creatures missing the specified body part will be unable to perform this action. The action produces a message (visible in adventure mode) in the form:

[creature] [verb text] the [description of creature's location]

In adventure mode, the "rooting around" ability will be included in the "natural abilities" menu, represented by its second person verb text.

|}

{{alphabetical TOC|style=margin: 1em auto;}}

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

|-
| {{text anchor|SAVAGE}}
| Creature
|
| The creature will only show up in "savage" biomes. Has no effect on cavern creatures. Cannot be combined with {{token|GOOD|c}} or {{token|EVIL|c}}.

|-
| {{text anchor|SECRETION}}
| Caste
|
*<[[material token]]>
*<[[Material_definition_token#Material_States|material state]]>
*BY_TOKEN / BY_CATEGORY / BY_TYPE
*<[[Body_token#BP|body part ID]]> / <[[Body_token#CATEGORY|category]]> or ALL / <type (e.g. [[Body_token#GRASP|GRASP]])>
*<[[Body_detail_plan_token#BP_LAYERS|tissue layer]]> or ALL
*<trigger>
| Causes the specified tissue layer(s) of the indicated body part(s) to secrete the designated material. A size 100 ('covering') [[contaminant]] is created over the affected body part(s) in its specified material state (and at the temperature appropriate to this state) when the trigger condition is met, as long as one of the secretory tissue layers is still intact. Valid triggers are:
*'''CONTINUOUS'''
Secretion occurs once every 40 [[time|ticks]] in [[fortress mode]], and every tick in [[adventurer mode]].
*'''EXERTION'''
Secretion occurs continuously (at the rate described above) whilst the creature is at minimum {{Tile|Tired|6:1}} following physical exertion. Note that this cannot occur if the creature has {{token|NOEXERT|c}}.
*'''EXTREME_EMOTION'''
Secretion occurs continuously (as above) whilst the creature is distressed. Cannot occur in creatures with {{token|NOEMOTION|c}}.

|-
| {{text anchor|SELECT_ADDITIONAL_CASTE}}
| Creature
|
*<caste>
| Adds an additional previously defined caste to the selection. Used after {{token|SELECT_CASTE|c}}.

|-
| {{text anchor|SELECT_CASTE}}
| Creature
|
*<caste> or ALL
| Selects a previously defined caste

|-
| {{text anchor|SELECT_MATERIAL}}
| Creature
|
*<[[material token]]>
| Selects a locally defined material. Can be ALL.

|-
| {{text anchor|SELECT_TISSUE}}
| Creature
|
*tissue token
| Selects a tissue for editing.

|-
| {{text anchor|SEMIMEGABEAST}}
| Caste
|
| Essentially the same as {{token|MEGABEAST|c}}, but more of them are created during worldgen. See the [[semi-megabeast]] page for details.

|-
| {{text anchor|SENSE_CREATURE_CLASS}}
| Caste
|
* <[[Creature_token#CREATURE_CLASS|creature class]]>
* [[Tilesets|<tile value or character>]]
* [[Color#Color_values|<foreground color>:<background color>:<foreground brightness>]]
| Gives the creature the ability to sense creatures belonging to the specified [[Creature_token#CREATURE_CLASS|creature class]] even when they lie far beyond line of sight, including through walls and floors. It also appears to reduce or negate the combat penalty of [[Wound#Blindness|blind]] units when fighting creatures they can sense. In [[adventure mode]], the specified tile will be used to represent sensed creatures when they cannot be seen directly.

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

|-
| {{text anchor|SKILL_LEARN_RATE}}
| Caste
|
*<[[skill_token]]>
*<percentage>
| The rate at which this creature learns this skill. Requires {{token|CAN_LEARN|c}} or {{token|INTELLIGENT|c}} to function.

|-
| {{text anchor|SKILL_LEARN_RATES}}
| Caste
|
*<percentage>
| The rate at which this creature learns all skills. Requires {{token|CAN_LEARN|c}} or {{token|INTELLIGENT|c}} to function.

|-
| {{text anchor|SKILL_RATE}}
| Caste
|
*[[skill_token]]
*<% of improvement points gained>
*<unused counter rate>
*<rust counter rate>
*<demotion counter rate>
| Like {{token|SKILL_RATES|c}}, but applies to individual skills instead. Requires {{token|CAN_LEARN|c}} or {{token|INTELLIGENT|c}} to function.

|-
| {{text anchor|SKILL_RATES}}
| Caste
|
*<% of improvement points gained>
*<unused counter rate>
*<rust counter rate>
*<demotion counter rate>
| Affects skill gain and decay. Lower numbers in the last three slots make decay occur faster ([SKILL_RATES:100:1:1:1] would cause rapid decay). The counter rates may also be replaced with NONE.
Default is [SKILL_RATES:100:8:16:16]. Requires {{token|CAN_LEARN|c}} or {{token|INTELLIGENT|c}} to function.

|-
| {{text anchor|SKILL_RUST_RATE}}
| Caste
|
*[[skill_token]]
*value
*value
*value
| The rate at which this skill decays. Lower values cause the skill to decay faster. Requires {{token|CAN_LEARN|c}} or {{token|INTELLIGENT|c}} to function.

|-
| {{text anchor|SKILL_RUST_RATES}}
| Caste
|
*value
*value
*value
| The rate at which all skills decay. Lower values cause the skills to decay faster. Requires {{token|CAN_LEARN|c}} or {{token|INTELLIGENT|c}} to function.

|-
| {{text anchor|SLOW_LEARNER}}
| Caste
|
| Shorthand for {{token|CAN_LEARN|c}} + <code>[[Creature_token#SKILL_LEARN_RATES|[SKILL_LEARN_RATES:50]]]</code>.{{verify}} Used by a number of 'primitive' creatures (like [[ogre]]s, [[giant]]s and [[troglodyte]]s) in the vanilla game. Applicable to player races. Prevents a player from recruiting nobility, even basic ones. Subterranean creatures with this token combined with {{token|EVIL|c}} will become servants of goblins in their civilizations, in the style of [[troll]]s.

|-
| {{text anchor|SMALL_REMAINS}}
| Caste
|
| Creature leaves "[[item token#REMAINS|remains]]" instead of a corpse. Used by [[vermin]].

|-
| {{text anchor|SMELL_TRIGGER}}
| Creature
|
*value
| Determines how keen a creature's sense of smell is - lower is better. At 10000, a creature cannot smell at all.

|-
| {{text anchor|SOLDIER_ALTTILE}}
| Creature
|
*'character' or tile number
| If this creature is active in its civilization's military, it will blink between its default tile and this one.

|-
| {{text anchor|SOUND}}
| Caste
|
* Sound application (currently accepts ALERT or PEACEFUL_INTERMITTENT)
* Sound range (in tiles)
* Sound delay (lower values = sound is produced more often)
* VOCALIZATION or NONE (determines whether the sound requires breathing or not)
* First-person description
* Third-person description
* Description when out of sight
| Creature makes sounds periodically, which can be heard in Adventure mode.
* First-person reads "You '''bark'''"
* Third-person reads "The [[capybara]] '''barks'''"
* Out of sight reads "You hear '''a loud bark'''"
with the text in bold being the description arguments of the token.

|-
| {{text anchor|SOURCE_HFID}}
| Creature
|
*Integer (generic token?)
| Found on generated [[angel]]s. This is the historical figure ID of the deity with which the angel is associated. Since HFIDs are not predictable before worldgen, this isn't terribly usable in mods.

|-
| {{text anchor|SPECIFIC_FOOD}}
| Caste
|
* PLANT or CREATURE
* Plant/creature ID
| Creature will only appear in biomes with this plant or creature available. Grazers given a specific type of grass (such as [[panda]]s and [[bamboo]]) will only eat that grass and nothing else, risking starvation if there's none available.

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

|-
| {{text anchor|SPEECH_FEMALE}}
| Creature
|
*speech file
| Boasting speeches relating to killing females of this creature.

|-
| {{text anchor|SPEECH_MALE}}
| Creature
|
*speech file
| Boasting speeches relating to killing males of this creature.

|-
| {{text anchor|SPHERE}}
| Creature
|
* [[Sphere#Available_spheres|sphere]]
| Sets what religious spheres the creature is aligned to, for purposes of being worshipped via the {{token|POWER|c}} token. Also affects how the creature's name is generated.

|-
| {{text anchor|SPOUSE_CONVERSION_TARGET}}
| Caste
|
| This creature can be converted by a night creature with {{token|SPOUSE_CONVERTER|c}}.

|-
| {{text anchor|SPOUSE_CONVERTER}}
| Caste
|
| If the creature has the {{token|NIGHT_CREATURE_HUNTER|c}} tag, it will kidnap {{token|SPOUSE_CONVERSION_TARGET|c}}s and transform them into the caste of its species with the {{token|CONVERTED_SPOUSE|c}} tag during worldgen. It may also start families this way.

|-
| {{text anchor|SPREAD_EVIL_SPHERES_IF_RULER}}{{version|0.47.01}}
| Caste
|
| If the creature rules over a [[site]], it will cause the local landscape to be corrupted into [[Surroundings#Evil|evil surroundings]] associated with the creature's [[Creature_token#SPHERE|sphere]]s. The creature must have at least one of the following [[sphere]]s for this to take effect: BLIGHT, DEATH, DISEASE, DEFORMITY, NIGHTMARES. The first three kill vegetation, while the others sometimes do. The last two get [[Plant_token#EVIL|evil plants]] and [[Creature_token#EVIL|evil animals]] sometimes. NIGHTMARES gets [[bogeyman|bogeymen]]. [http://www.bay12forums.com/smf/index.php?topic=169696.msg8162224#msg8162224] Used by [[demon]]s in the vanilla game.

|-
| {{text anchor|STANCE_CLIMBER}}
| Caste
|
| Caste does not require <code>[[Body_token#GRASP|[GRASP]]]</code> body parts to climb -- it can climb with <code>[[Body_token#STANCE|[STANCE]]]</code> parts instead.

|-
| {{text anchor|STANDARD_GRAZER}}
| Caste
|
| Acts as {{token|GRAZER|c}} but set to 20000*G*(max size)^(-3/4), where G defaults to 100 but can be set in d_init, and the whole thing is trapped between 150 and 3 million. Used for all grazers in the default creature raws.

|-
| {{text anchor|STRANGE_MOODS}}{{version|0.42.01}}
| Caste
|
| The creature will get [[strange mood]]s in fortress mode and can produce artifacts.

|-
| {{text anchor|SUPERNATURAL}}
| Caste
|
| Gives the creature knowledge of any secrets with <code>[[Interaction_token#IS_SECRET|[SUPERNATURAL_LEARNING_POSSIBLE]]]</code> that match its [[Creature_token#SPHERE|spheres]] and also prevents it from becoming a [[vampire]] or [[werebeast]]. Other effects are unknown.

|-
| {{text anchor|SWIMS_INNATE}}
| Caste
|
| The creature naturally knows how to swim perfectly and does not use the [[swimmer]] skill, as opposed to {{token|SWIMS_LEARNED|c}} below. However, Fortress mode AI never paths into water anyway, so it's less useful there.

|-
| {{text anchor|SWIMS_LEARNED}}
| Caste
|
| The creature swims only as well as their present [[Swimmer|swimming skill]] allows them to.

|-
| {{text anchor|SYNDROME_DILUTION_FACTOR}}{{version|0.42.01}}
| Caste
| <[[Syndrome#SYN_IDENTIFIER|syndrome identifier]]>:<percentage>
| Dilutes the effects of syndromes which have the specified identifier. A percentage of 100 is equal to the regular syndrome effect severity, higher percentages reduce severity.
|}

{{alphabetical TOC|style=margin: 1em auto;}}

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

|-
| {{text anchor|TENDONS}}
| Caste
|
* [[material token]]
*healing rate
| The creature has tendons in its {{token|CONNECTIVE_TISSUE_ANCHOR|td}} tissues (bone or chitin by default). Cutting the bone/chitin tissue severs the tendons, disabling motor function if the target is a limb.

|-
| {{text anchor|THICKWEB}}
| Caste
|
| The creature's [[web]]s can catch larger creatures.

|-
| {{text anchor|TISSUE}}
| Creature
|
*name
| Begins defining a tissue in the creature file.

|-
| {{text anchor|TISSUE_LAYER}}
| Caste
|
*BY_TYPE, BY_CATEGORY, BY_TOKEN
*TYPE,CATEGORY, or TOKEN
*TISSUE
*LOCATION
| Adds the tissue layer to wherever it is required.
Non-argument Locations can be FRONT, RIGHT, LEFT, TOP, BOTTOM. Argument locations are AROUND and CLEANS, requiring a further body part and a % of coverage/cleansing

|-
| {{text anchor|TISSUE_LAYER_OVER}}
| Caste
|
*BY_TYPE, BY_CATEGORY, BY_TOKEN
*TYPE,CATEGORY, or TOKEN
*TISSUE
*LOCATION
| Presumably a counterpart to TISSUE_LAYER_UNDER (see below).

|-
| {{text anchor|TISSUE_LAYER_UNDER}}
| Caste
|
*BY_TYPE, BY_CATEGORY, BY_TOKEN
*TYPE,CATEGORY, or TOKEN
*TISSUE
| Adds the tissue layer under a given part.
For example, an [[iron man]] has a gaseous poison within, and this tissue (GAS is its name) has the token [TISSUE_LEAKS] and its state is GAS, so when you puncture the iron outside and damage this tissue it leaks gas (can have a syndrome by using a previous one in the creature sample.) [TISSUE_LAYER_UNDER:BY_CATEGORY:ALL:{tissue}] {tissue} is what will be under the TISSUE_LAYER; here is an example Tissue from the 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]

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

|-
| {{text anchor|TRADE_CAPACITY}}
| Caste
|
*number
| How much the creature can carry when used by merchants.

|-
| {{text anchor|TRAINABLE}}
| Caste
|
| Shortcut for {{token|TRAINABLE_HUNTING|c}} + {{token|TRAINABLE_WAR|c}}.

|-
| {{text anchor|TRAINABLE_HUNTING}}
| Caste
|
| Can be [[Animal trainer|trained]] as a hunting beast, increasing speed.

|-
| {{text anchor|TRAINABLE_WAR}}
| Caste
|
| Can be [[Animal trainer|trained]] as a war beast, increasing strength and endurance.

|-
| {{text anchor|TRANCES}}
| Caste
|
| Allows the creature to go into [[martial trance]]s. Used by dwarves in the vanilla game.

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

|-
| {{text anchor|TRIGGERABLE_GROUP}}
| Creature
|
*min
*max
| A large swarm of vermin can be disturbed, usually in adventurer mode.{{verify}}

|-
| {{text anchor|TSU_NOUN}}
| Caste
|
*noun
*SINGULAR or PLURAL
| Noun for the {{token|TISSUE_STYLE_UNIT|c}}, used in the description of the tissue layer's style.
|}

{{alphabetical TOC|style=margin: 1em auto;}}

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

|-
| {{text anchor|UBIQUITOUS}}
| Creature
|
| Creature will occur in every region with the correct biome. Does not apply to {{token|EVIL|c}}/{{token|GOOD|c}} tags.

|-
| {{text anchor|UNDERGROUND_DEPTH}}
| Creature
|
*mindepth
*maxdepth
| Depth that the creature appears underground. Numbers can be from 0 to 5. 0 is actually 'above ground' and can be used if the creature is to appear both above and below ground. Values from 1-3 are the respective [[cavern]] levels, 4 is the [[magma sea]] and 5 is the [[HFS]]. A single argument may be used instead of min and max. [[Demon]]s use only 5:5; user-defined creatures with both this depth and {{token|FLIER}} will take part in the initial wave from the HFS alongside generated demons, but without {{token|FLIER}} they will only spawn from the map edges. Civilizations that can use underground plants or animals will only export (via the embark screen or caravans) things that are available at depth 1.

|-
| {{text anchor|UNDERSWIM}}
| Caste
|
| The creature is displayed as blue when in [[Water#Depth|7/7 water]]. Used on fish and amphibious creatures which swim under the water.

|-
| {{text anchor|UNIQUE_DEMON}}
| Caste
|
| 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. Could not be specified in user-defined raws prior to version [[Release_information/0.47.01|0.47.01]].

|-
| {{text anchor|USE_CASTE}}
| Creature
|
*new caste token
*old caste token
| Defines a new caste derived directly from a previous caste. The new caste inherits all properties of the old one. The effect of this tag is automatic if one has not yet defined any castes: "Any caste-level tag that occurs before castes are explicitly declared is saved up and placed on any caste that is declared later, unless the caste is explicitly derived from another caste."

|-
| {{text anchor|USE_MATERIAL}}
| Creature
|
*new material ID
*old material ID
| Defines a new local creature material and populates it with all properties defined in the specified local creature material.

|-
| {{text anchor|USE_MATERIAL_TEMPLATE}}
| Creature
|
*new material token
*material template
| Defines a new local creature material and populates it with all properties defined in the specified template.

|-
| {{text anchor|USE_TISSUE}}
| Creature
|
*new tissue token
*old tissue id
| Defines a new local creature tissue and populates it with all properties defined in the local tissue specified in the second argument.

|-
| {{text anchor|USE_TISSUE_TEMPLATE}}
| Creature
|
*new tissue token
*tissue template
| Loads a tissue template listed in OBJECT:TISSUE_TEMPLATE files, such as tissue_template_default.txt.

|-
| {{text anchor|UTTERANCES}}
| Caste
|
| Changes the language of the creature into unintelligible 'kobold-speak', which creatures of other species will be unable to understand. If a civilized creature has this and is not part of a {{token|SKULKING|e}} civ, it will tend to start wars with all nearby civilizations and will be unable to make peace treaties due to 'inability to communicate'.
|}

{{alphabetical TOC|style=margin: 1em auto;}}

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

|-
| {{text anchor|VEGETATION}}
| Caste
|
| Like {{token|AT_PEACE_WITH_WILDLIFE}}, but also makes the creature more valued in artwork by civilisations with the PLANT [[sphere]]. [http://www.bay12forums.com/smf/index.php?topic=169696.msg8316954#msg8316954] Used by [[grimeling]]s in the vanilla game.

|-
| {{text anchor|VERMIN_BITE}}
| Caste
|
*chance of occurrence{{verify}}
*verb (bitten, stung, etc.)
* [[material token]]
* [[Material_definition_token#Material_States|material state]]
| Enables vermin to bite other creatures, injecting the specified material. See {{token|SPECIALATTACK_INJECT_EXTRACT|c}} for details about injection - this token presumably works in a similar manner.{{verify}}

|-
| {{text anchor|VERMIN_EATER}}
| Creature
|
| The vermin creature will attempt to eat exposed food. See {{token|PENETRATEPOWER|c}}. Distinct from {{token|VERMIN_ROTTER|c}}.

|-
| {{text anchor|VERMIN_FISH}}
| Creature
|
| The vermin appears in [[water]] and will attempt to swim around.

|-
| {{text anchor|VERMIN_GROUNDER}}
| Creature
|
| The creature appears in "general" surface ground locations. Note that this doesn't stop the creature from flying if it can (most vermin birds have this tag).

|-
| {{text anchor|VERMIN_HATEABLE}}
| Caste
|
| Some dwarves will [[Preferences|hate]] the creature and get unhappy thoughts when around it. See the [[Hateable|list of hateable vermin]] for details.

|-
| {{text anchor|VERMIN_MICRO}}
| Caste
|
| This makes the creature move in a swarm of creatures of the same race as it (e.g. swarm of flies, swarm of ants).

|-
| {{text anchor|VERMIN_NOFISH}}
| Caste
|
| The creature cannot be caught by [[fishing]].

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

|-
| {{text anchor|VERMIN_NOTRAP}}
| Caste
|
| The creature cannot be caught in baited [[animal trap]]s; however, a "[[Trapper|catch live land animal]]" task may still be able to capture one if a dwarf finds one roaming around.

|-
| {{text anchor|VERMIN_ROTTER}}
| Creature
|
| The vermin are attracted to rotting stuff and loose food left in the open and cause unhappy thoughts to dwarves who encounter them. Present on flies, knuckle worms, acorn flies, and blood gnats. Speeds up decay?{{verify}}

|-
| {{text anchor|VERMIN_SOIL}}
| Creature
|
| The creature randomly appears near dirt or mud, and may be uncovered by creatures that have the {{token|ROOT_AROUND|c}} interaction such as [[goose|geese]] and [[chicken]]s. Dwarves will ignore the creature when given the "Capture live land animal" task.

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

|-
| {{text anchor|VERMINHUNTER}}
| Caste
|
| Old shorthand for "does cat stuff". Contains {{token|AT_PEACE_WITH_WILDLIFE|c}} + {{token|RETURNS_VERMIN_KILLS_TO_OWNER|c}} + {{token|HUNTS_VERMIN|c}} + {{token|ADOPTS_OWNER|c}}.

|-
| {{text anchor|VESPERTINE}}
| Caste
|
| Sets the creature to be active during the evening in adventurer mode.

|-
| {{text anchor|VIEWRANGE}}
| Caste
|
*value
| Value should determine how close you have to get to a critter before it attacks (or prevents adv mode travel etc.) Default is 20.

|-
| {{text anchor|VISION_ARC}}
| Caste
|
*binocular vision arc
*non-binocular vision arc
| The width of the creature's vision arcs, in degrees (i.e. 0 to 360). The first number is binocular vision, the second is non-binocular vision. Binocular vision has a minimum of about 10 degrees, monocular, a maximum of about 350 degrees. Values past these limits will be accepted, but will default to ~10 degrees and ~350 degrees respectively.
|}

{{alphabetical TOC|style=margin: 1em auto;}}

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

|-
| {{text anchor|WAGON_PULLER}}
| Caste
|
| Allows the creature to pull caravan wagons. If a civilization doesn't have access to any, it is restricted to trading with pack animals.

|-
| {{text anchor|WEBBER}}
| Caste
|
* [[material token]]
| Allows the creature to create [[web]]s, and defines what the webs are made of.

|-
| {{text anchor|WEBIMMUNE}}
| Caste
|
| The creature will not get caught in thick [[web]]s. Used by creatures who can shoot thick webs (such as [[giant cave spider]]s) in order to make them immune to their own attacks.
|}

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

|-
| {{text anchor|ATTACK_SKILL}}
| Caste
|
*[[Skill token]]
| Defines the skill used by the attack.

|-
| {{text anchor|ATTACK_VERB}}
| Caste
|
*2nd person
*3rd person
| Descriptive text for the attack.

|-
| {{text anchor|ATTACK_CONTACT_PERC}}
| Caste
|
*% value
| The contact area of the attack, measured in % of the body part's volume. Note that all attack percentages can be more than 100%.

|-
| {{text anchor|ATTACK_PENETRATION_PERC}}
| Caste
|
*% value
| The penetration value of the attack, measured in % of the body part's volume. Requires ATTACK_FLAG_EDGE. Maximum value: 15000.

|-
| {{text anchor|ATTACK_PRIORITY}}
| Caste
|
*MAIN or SECOND
| Usage frequency. MAIN attacks are 100 times more frequently chosen than SECOND. Opportunity attacks ignore this preference.

|-
| {{text anchor|ATTACK_VELOCITY_MODIFIER}}
| Caste
|
*number
| The velocity multiplier of the attack, multiplied by 1000.

|-
| {{text anchor|ATTACK_FLAG_CANLATCH}}
| Caste
|
| Attacks that damage tissue have the chance to latch on in a wrestling hold. The grabbing bodypart can then use the "shake around" wrestling move, causing severe, armor-bypassing tensile damage according to the attacker's body volume.

|-
| {{text anchor|ATTACK_FLAG_WITH}}
| Caste
|
| Displays the name of the body part used to perform an attack while announcing it, e.g. "The weaver punches the bugbat with his right hand".

|-
| {{text anchor|ATTACK_FLAG_EDGE}}
| Caste
|
| The attack is edged, with all the effects on physical resistance and contact area that it entails.

|-
| {{text anchor|ATTACK_PREPARE_AND_RECOVER}}
| Caste
|
* Preparation time
* Recovery time
| Determines the length of time to prepare this attack and until one can perform this attack again. Values appear to be calculated in adventure mode ticks.

|-
| {{text anchor|ATTACK_FLAG_BAD_MULTIATTACK}}
| Caste
|
| Multiple strikes with this attack cannot be performed effectively.

|-
| {{text anchor|ATTACK_FLAG_INDEPENDENT_MULTIATTACK}}
| Caste
|
| Multiple strikes with this attack can be performed with no penalty. The creature will use all attacks with this token at once.

|-
| {{text anchor|SPECIALATTACK_INJECT_EXTRACT}}
| Caste
|
*<[[material token]]>
*<[[Material_definition_token#Material_States|material state]]>
*<min quantity>
*<max quantity>
| When added to an attack, causes the attack to inject the specified material into the victim's bloodstream. Once injected, the material will participate in [[temperature|thermal]] exchange within the creature - injecting something like molten [[iron]] (INORGANIC:IRON:LIQUID) would cause most unmodded creatures to melt (note that some of the injected material also [[contaminant|splatters]] over the bodypart used to carry out the attack, so it should be protected appropriately). If the injected material has an associated [[syndrome]] with the [[Syndrome#SYN_INJECTED|[SYN_INJECTED]]] token, it will be transmitted to the victim. If the attack is blunt, the injected material lacks the [[Material definition token#ENTERS_BLOOD|[ENTERS_BLOOD]]] token, the attacked bodypart has no [[Tissue_definition_token#VASCULAR|[VASCULAR]]] tissues, or the victim is bloodless, the material will splatter over the attacked body part instead.

|-
| {{text anchor|SPECIALATTACK_INTERACTION}}
| Caste
|
*interaction
| When this attack lands successfully, a specified interaction will take effect on the target creature. The attack must break the target creature's skin in order to work. This will take effect in worldgen as well. If the attack would break skin, the interaction will occur '''before the attack actually lands'''.

|-
| {{text anchor|SPECIALATTACK_SUCK_BLOOD}}
| Caste
|
*min
*max
| Successful attack draws out an amount of blood randomized between the min and max value. Beware that this '''will''' trigger any ingestion syndromes attached to the target creature's blood - for example, using this attack on a vampire will turn you into one too.
|}

==Tissue Layer Tokens==
Tissue layers are added to a creature's body parts by the creature tokens [[#TISSUE_LAYER|TISSUE_LAYER]], [[#TISSUE_LAYER_OVER|TISSUE_LAYER_OVER]], [[#TISSUE_LAYER_UNDER|TISSUE_LAYER_UNDER]], and the body detail plan token [[#TL_LAYERS|TL_LAYERS]].

These tissue layers are not the same thing as tissues, which are defined at creature level, but rather applications of the tissues. If the SKIN tissue of a creature is the more general and abstract notion of what skin is for that creature, then a tissue layer may be the "actual" skin on the creature's nose, head, or second toe. As most creatures have more than one body part, tissue layers are normally selected en masse.

Some tissue layer tokens are analogous to tissue definition tokens, e.g. [[#TL_CONNECTS|TL_CONNECTS]] to [[tissue_definition_token#CONNECTS|CONNECTS]].

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

|-
| {{text anchor|SELECT_TISSUE_LAYER}}
| Caste
|
*TISSUE
*BY_CATEGORY, BY_TYPE, BY_TOKEN
*Location - category, type, or token | Selects a tissue at a location
* (optional) FRONT, BACK, LEFT, RIGHT, TOP, BOTTOM, AROUND.
| Begins a selection of tissue layers.
[SELECT_TISSUE_LAYER:HEART:BY_TYPE:HEART]

|-
| {{text anchor|PLUS_TISSUE_LAYER}}
| Caste
|
*TISSUE
*BY_CATEGORY, BY_TYPE, BY_TOKEN
*Location - category, type, or token
| Adds tissue layers to those selected.

|-
| {{text anchor|SET_TL_GROUP}}
| Caste
|
*TISSUE
*BY_CATEGORY, BY_TYPE, BY_TOKEN
*Location - category, type, or token
*tissue
| Begins a selection of tissue layers. Only usable for descriptor and cosmetic purposes.

Research has implied it may be redundant with SELECT_TISSUE_LAYER, as the latter allows for cosmetics as well as "functional" tokens such as TL_MAJOR_ARTERIES. Vanilla raws still use SET_TL_GROUP though, for all cosmetic purposes. More research is needed on this subject.

|-
| {{text anchor|PLUS_TL_GROUP}}
| Caste
|
*BY_CATEGORY, BY_TYPE, BY_TOKEN
*Location - category, type, or token
*tissue
| Adds tissue layers to those selected. Like SET_TL_GROUP, it may be redundant even if used in the vanilla raws.

|-
| {{text anchor|SET_LAYER_TISSUE}}
| Caste
|
*TISSUE
| Sets a selected tissue layer to be made of a different tissue.

|-
| {{text anchor|SHEARABLE_TISSUE_LAYER}}
| Caste
|
* tissue modifier
* required value
| Tissue layer can be sheared for its component material. The specified modifier must be at least of the desired value for shearing to be possible (for example, a [[llama]]'s wool must have a LENGTH of 300 before it is shearable).

|-
| {{text anchor|TISSUE_LAYER_APPEARANCE_MODIFIER}}
| Caste
|
*QUALITY
*lowest
*lower
*low
*median
*high
*higher
*highest
| Sets the range of qualities, including LENGTH, DENSE, HIGH_POSITION, CURLY, GREASY, WRINKLY

|-
| {{text anchor|TISSUE_STYLE_UNIT}}
| Caste
|
*tissue style unit ID
*shaping
| Sets tissue layer to be the target of TISSUE_STYLE token specified for an entity, works only on entity members. Mostly used with tissues HAIR, BEARD, MOUSTACHE, SIDEBURNS.

|-
| {{text anchor|TL_COLOR_MODIFIER}}
| Caste
|
*COLOR
*freq
*COLOR
*freq etc.
| Creates a list of colors/color patterns, giving each a relative frequency. If the given color or pattern does not exist, the tissue is described as being "transparent".

|-
| {{text anchor|TLCM_GENETIC_MODEL}}
| Caste
|
| The way the color modifier is passed on to offspring. May or may not work right now.{{verify}}

|-
| {{text anchor|TLCM_IMPORTANCE}}
| Caste
|
*number
| Presumably modifies the importance of the tissue layer color modifier, for description purposes.
HOWEVER using this appears to remove all mention of colour from creature descriptions. It does not appear in any default creatures.

|-
| {{text anchor|TLCM_NOUN}}
| Caste
|
*name
*SINGULAR or PLURAL
| Names the tissue layer color modifier, and determines the noun. Also used by [[Utility:Stonesense|Stonesense]] for colouring body parts.

|-
| {{text anchor|TLCM_TIMING}}
| Caste
|
*ROOT
*start change window years
*days
*end change window years
*days
| Determines the point in the creature's life when the color change begins and ends.

|-
| {{text anchor|TL_CONNECTS}}
| Caste
|
| Gives the CONNECTS attribute to selected layers.

|-
| {{text anchor|TL_HEALING_RATE}}
| Caste
|
*value
| Changes the HEALING_RATE of the selected tissue layers.

|-
| {{text anchor|TL_MAJOR_ARTERIES}}
| Caste
|
| Gives the "major arteries" attribute to selected layers. Used to add massive bleeding properties to the throat, made from skin.

|-
| {{text anchor|TL_PAIN_RECEPTORS}}
| Caste
|
*value
| Changes the number of pain receptors for selected tissue layers.

|-
| {{text anchor|TL_RELATIVE_THICKNESS}}
| Caste
|
*value
| Changes the relative thickness for selected tissue layers.

|-
| {{text anchor|TL_VASCULAR}}
| Caste
|
*value
| Sets a new VASCULAR value (which modulates bleeding) for selected tissue layers.

|}

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

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

DF2014:Creature token

2024-09-24T23:17:29Z

DikbutDaGrate: Historical note on the functionality of Light Gen

{{Quality|Exceptional|22:04, 20 September 2016 (UTC)}}
{{av}}
{{Modding}}

The <code>[OBJECT:CREATURE]</code> [[token]] defines the properties of [[creatures]];  this is a full list of all known creature tokens:

__NOTOC__

{{clear}}
{{alphabetical TOC|style=margin: 1em auto;}}

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

|-
| {{text anchor|ADOPTS_OWNER}}
| Caste
|
| Prevents tamed creature from being made available for adoption, instead allowing it to automatically adopt whoever it wants. The basic requirements for adoption are intact, and the creature will only adopt individuals who have a [[preference]] for their species. Used by [[cat]]s in the vanilla game. When {{k|v}}iewing a tame creature with this token, the message "This animal isn't interested in your wishes" will appear instead of "This [adorable] animal can't work" or "This animal is waiting to be trained".

|-
| {{text anchor|ALCOHOL_DEPENDENT}}
| Caste
|
| Makes the creature need [[alcohol]] to get through the working day; it will choose to drink booze instead of [[water]] if possible. Going sober for too long reduces speed.

|-
| {{text anchor|ALL_ACTIVE}}
| Caste
|
| Sets the creature to be active during the day, night, and twilight in Adventurer Mode. Seems to be a separate value from {{token|DIURNAL|c}}/{{token|NOCTURNAL|c}}/{{token|CREPUSCULAR|c}}, rather than implying them.{{verify|code}}

|-
| {{text anchor|ALTTILE}}
| Creature
|
*'character' or tile number
| If set, the creature will blink between its {{token|TILE|c}} and its ALTTILE.

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

|-
| {{text anchor|AMPHIBIOUS}}
| Caste
|
| Allows a creature to breathe both in and out of [[water]] (unlike {{token|AQUATIC|c}}) - does not prevent drowning in [[magma]].

|-
| {{text anchor|APP_MOD_DESC_RANGE}}
| Caste
|
*Range (6 values, low to high)
| [http://www.bay12forums.com/smf/index.php?topic=113762.msg3473069#msg3473069 Forum post describing how description ranges work]

|-
| {{text anchor|APP_MOD_GENETIC_MODEL}}
| Caste
|
*Model (Accepts DOMINANT_MORE, DOMINANT_LESS, and MIX)
| Defines a genetic model for the relevant appearance modifier(s). May or may not do anything significant at present.

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

|-
| {{text anchor|APP_MOD_NOUN}}
| Caste
|
*noun
*SINGULAR or PLURAL
| Creates a noun for the appearance, and whether it is singular or plural.

|-
| {{text anchor|APP_MOD_RATE}}
| Caste
|
*Rate (integer)
*Scale (DAILY, YEARLY)
*min (growth)
*max (growth)
*start year
*start day
*end year
*end day
| Setting the growth rate of the modifier. The last two tokens can be replaced by NO_END to have growth continue indefinitely.

|-
| {{text anchor|APPLY_CREATURE_VARIATION}}
| Caste
|
*creature variation ID
*(optional) any amount of arbitrary arguments
| Applies the specified [[creature variation token|creature variation]]. See [[Creature_variation_token#Arguments_and_conditional_tokens]] for how the subsequent arguments may be used.

|-
| {{text anchor|APPLY_CURRENT_CREATURE_VARIATION}}
| Special
|
| Applies the effects of all pending {{token|CV_ADD_TAG|c}} and {{token|CV_REMOVE_TAG|c}} tokens that have been defined in the current creature.

|-
| {{text anchor|AQUATIC}}
| Caste
|
| Enables the creature to breathe in water, but causes it to air-drown on dry land.

|-
| {{text anchor|ARENA_RESTRICTED}}
| Caste
|
| Causes the creature to be excluded from the [[object testing arena]]'s creature spawning list. Typically applied to spoileriffic creatures.

|-
| {{text anchor|ARTIFICIAL_HIVEABLE}}
| Creature
|
| Enables the creature to be kept in artificial [[hive]]s by [[beekeeper]]s.

|-
| {{text anchor|AT_PEACE_WITH_WILDLIFE}}
| Caste
|
| Prevents the creature from attacking or frightening creatures with the {{Token|NATURAL|c}} tag.

|-
| {{text anchor|ATTACK}}
| Caste
|
*token
*bodypart
*selection criteria
*location
| Defines the attack name, and the body part used. See [[#Attack Tokens|below]] for valid subtokens
'''Example:''' 
<code>[ATTACK:GORE:BODYPART:BY_CATEGORY:HORN]</code> 
''GORE'' = name of the attack 
''BODYPART:BY_CATEGORY:HORN'' = the horn is used to attack (presuming the creature has one)

|-
| {{text anchor|ATTACK_TRIGGER}}
| Caste
|
*population
*exported wealth
*created wealth
| Specifies when a [[megabeast]] or [[semi-megabeast]] will attack the fortress. The attacks will start occurring when all of the requirements are met. Setting a value to 0 disables the trigger.

|}

{{alphabetical TOC|style=margin: 1em auto;}}

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

|-
| {{text anchor|BABY}}
| Caste
|
*integer
| Age at which creature is considered a child, the default is zero. One can think of this as the duration of the baby stage.

|-
| {{text anchor|BABYNAME}}
| Caste
|
*singular
*plural
| Defines a new name for a creature in baby state at the caste level. For non-caste-specific baby names, see {{token|GENERAL_BABY_NAME|c}}.

|-
| {{text anchor|BEACH_FREQUENCY}}
| Caste
|
*integer
| Creature may be subject to [[beaching]], becoming stranded on [[Beach|shores]], where they will eventually air-drown. The number indicates the frequency of the occurrence. Presumably requires the creature to be {{token|AQUATIC|c}}. Used by [[orca]]s, [[sperm whale]]s and [[sea nettle jellyfish]] in the vanilla game.

|-
| {{text anchor|BENIGN}}
| Caste
|
| The creature is non-aggressive by default, and will never automatically be engaged by companions or soldiers, running away from any creatures that are not friendly to it, and will only defend itself if it becomes enraged. Can be thought of as the counterpoint of the {{token|LARGE_PREDATOR|c}} tag. When tamed, animals with this tag will be useless for fortress defense.

|-
| {{text anchor|BIOME}}
| Creature
|
* [[biome token]]
| Select a [[biome]] the creature may appear in.

|-
| {{text anchor|BLOOD}}
| Caste
|
* <[[material token]]>
* <[[Material_definition_token#Material_States|material state]]>
| Specifies what the creature's blood is made of.

|-
| {{text anchor|BLOODSUCKER}}
| Caste
|
| Causes [[vampire]]-like behaviour; the creature will suck the [[Creature_token#BLOOD|blood]] of unconscious victims when its [[Syndrome#TIME_SINCE_SUCKED_BLOOD|thirst for blood]] grows sufficiently large. When controlling the creature in adventure mode, this can be done at will. Seems to be required to make the creature denouncable (in-world) as a creature of the night.

|-
| {{text anchor|BODY}}
| Caste
|
*body parts
| Draws body parts from OBJECT:BODY files (such as body_default.txt)
'''Example:''' 
[BODY:BODY_WITH_HEAD_FLAG:HEART:GUTS:BRAIN:MOUTH] 
This is the body from a [[purring maggot]]. It creates a body with head, a heart, some guts, a brain, and a mouth. That's all a maggot needs.

'''If the body is left undefined, the creature will cause a crash whenever it spawns.''' {{verify}}

|-
| {{text anchor|BODY_APPEARANCE_MODIFIER}}
| Caste
|
*ATTRIBUTE
*lowest
*lower
*low
*median
*high
*higher
*highest
| These body modifiers give individual creatures different characteristics. In the case of HEIGHT, BROADNESS and LENGTH, the modifier is also a percentage change to the BODY_SIZE of the individual creature. The seven numbers afterward give a distribution of ranges. Each interval has an equal chance of occurring.
'''Example:''' 
[BODY_APPEARANCE_MODIFIER:HEIGHT:90:95:98:100:102:105:110] 
''HEIGHT'' : marks the height to be changed 
''90:95:98:100:102:105:110'' : sets the range from the shortest (90% of the average height) to the tallest (110% of the average height) creature variation.

|-
| {{text anchor|BODY_DETAIL_PLAN}}
| Caste
|
*PlanName
*Arguments
| Loads a plan from 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:''' 
[BODY_DETAIL_PLAN:VERTEBRATE_TISSUE_LAYERS:SKIN:FAT:MUSCLE:BONE:CARTILAGE] 
This creates the detailed body of a [[fox]], the skin, fat, muscle, bones and cartilage out of the vertebrate tissues. 
A [[Purring maggot|maggot]] would only need: 
''[BODY_DETAIL_PLAN:EXOSKELETON_TISSUE_LAYERS:SKIN:FAT:MUSCLE]''

|-
| {{text anchor|BODY_SIZE}}
| Caste
|
*years
*days
*size
| Sets size at a given age. Size is in cubic centimeters, and for normal body materials, is roughly equal to the creature's average weight in grams.
'''Example:''' 
[BODY_SIZE:0:0:10000] 
[BODY_SIZE:1:168:50000] 
[BODY_SIZE:12:0:220000] 
This describes the size of a [[minotaur]]. Its birth size would be 10,000 cm3 (~10 kg). At 1 year and 168 days old it would be 50,000 cm3 (~50 kg). And as an adult (at 12 years old) it would be 220,000 cm3 and weigh roughly 220 kg.

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

|-
| {{text anchor|BONECARN}}
| Caste
|
| Creature eats bones. Implies {{token|CARNIVORE|c}}. [[Adventurer mode|Adventurers]] with this token are currently unable to eat bones.{{Bug|11069}}

|-
| {{text anchor|BP_ADD_TYPE}}
| Caste
|
| Adds a type to a body part - used with {{token|SET_BP_GROUP|c}}. In vanilla DF, this is used for adding the type '[[Body token#GELDABLE|GELDABLE]]' to the lower body of certain [[cat|creatures]].

|-
| {{text anchor|BP_APPEARANCE_MODIFIER}}
| Caste
|
*QUALITY
*lowest
*lower
*low
*median
*high
*higher
*highest
| Sets up the breadth of possibilities for appearance qualities for a selected BP group. EG. Eyes (CLOSE_SET, DEEP_SET, ROUND_VS_NARROW, LARGE_IRIS),Lips (THICKNESS), Nose (BROADNESS, LENGTH, UPTURNED, CONVEX), Ear (SPLAYED_OUT, HANGING_LOBES, BROADNESS, HEIGHT), Tooth (GAPS), Skull (HIGH_CHEEKBONES, BROAD_CHIN, JUTTING CHIN, SQUARE_CHIN), Neck (DEEP_VOICE, RASPY_VOICE), Head (BROADNESS, HEIGHT)

|-
| {{text anchor|BP_REMOVE_TYPE}}
| Caste
|
| Removes a type from a body part. Used with {{token|SET_BP_GROUP|c}}.

|-
| {{text anchor|BUILDINGDESTROYER}}
| Caste
|
*1 or 2
| Allows a creature to destroy furniture and buildings. Value [1] targets mostly doors, hatches, furniture and the like. Value [2] targets anything not made with the {{k|b}} + {{k|C}} commands.
|}

{{alphabetical TOC|style=margin: 1em auto;}}

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

|-
| {{text anchor|CAN_DO_INTERACTION}}
| Caste
|
*interaction token
| The creature can perform an interaction. See [[interaction token]].

|-
| {{text anchor|CAN_LEARN}}
| Caste
|
| The creature gains [[skill]]s and can have [[labor|professions]]. If a member of a civilization (even a pet) has this token, it'll need to eat, drink and sleep. Note that this token makes the creature unable to be eaten by an adventurer, so it is not recommended for uncivilized monsters. Adventurers lacking this token can allocate but not increase attributes and skills. Skills allocated will disappear on start.

|-
| {{text anchor|CAN_SPEAK}}
| Caste
|
| Can [[talking|talk]]. Note that this is not necessary for a creature to gain social skills.

|-
| {{text anchor|CANNOT_CLIMB}}
| Caste
|
| Creature cannot [[climber|climb]], even if it has free grasp parts.

|-
| {{text anchor|CANNOT_JUMP}}
| Caste
|
| Creature cannot [[jump]].

|-
| {{text anchor|CANNOT_UNDEAD}}
| Caste
|
| Acts like {{token|NOT_LIVING|c}}, except that {{token|OPPOSED_TO_LIFE|c}} creatures will attack them.

|-
| {{text anchor|CANOPENDOORS}}
| Caste
|
| Allows the creature to open [[door]]s that are set to be unpassable for pets. In adventure mode, creatures lacking this token will be unable to pass through door tiles except whilst these are occupied by other creatures.

|-
| {{text anchor|CARNIVORE}}
| Caste
|
| Creature ''only'' eats [[meat]]. If the creature goes on rampages in worldgen, it will often devour the people/animals it kills. Does not seem to affect the diet of the adventurer in adventure mode.

|-
| {{text anchor|CASTE}}
| Creature
|
*name
| Defines a [[caste]].

|-
| {{text anchor|CASTE_ALTTILE}}
| Caste
|
*tile number or "letter"
| Caste-specific {{token|ALTTILE|c}}. Requires {{token|CASTE_TILE|c}}.

|-
| {{text anchor|CASTE_COLOR}}
| Caste
|
*fg
*bg
*brightness
| Caste-specific {{token|COLOR|c}}.

|-
| {{text anchor|CASTE_GLOWCOLOR}}
| Caste
|
*fg
*bg
*brightness
| Caste-specific {{token|GLOWCOLOR|c}}.

|-
| {{text anchor|CASTE_GLOWTILE}}
| Caste
|
*tile value or "letter"
| Caste-specific {{token|GLOWTILE|c}}.

|-
| {{text anchor|CASTE_NAME}}
| Caste
|
*singular
*plural
*adjective
| Caste-specific {{token|NAME|c}}.

|-
| {{text anchor|CASTE_PROFESSION_NAME}}
| Caste
|
*[[Unit type token]] (Profession)
*singular
*plural
| Caste-specific {{token|PROFESSION_NAME|c}}.

|-
| {{text anchor|CASTE_SOLDIER_ALTTILE}}
| Caste
|
*'character' or tile number
| Caste-specific {{token|SOLDIER_ALTTILE|c}}. Requires {{token|CASTE_SOLDIER_TILE|c}}.

|-
| {{text anchor|CASTE_SOLDIER_TILE}}
| Caste
|
*'character' or tile number
| Caste-specific {{token|CREATURE_SOLDIER_TILE|c}}.

|-
| {{text anchor|CASTE_SPEECH}}
| Caste
|
*speech file
| Caste-specific {{token|SPEECH|c}}.

|-
| {{text anchor|CASTE_TILE}}
| Caste
|
* tile number or "letter"
| Caste-specific {{token|CREATURE_TILE|c}}.

|-
| {{text anchor|CAVE_ADAPT}}
| Caste
|
| Gives the creature a bonus in caves. Also causes [[cave adaptation]].

|-
| {{text anchor|CDI}}
| Caste
|
*Varies
| Specifies details for the preceding {{token|CAN_DO_INTERACTION|c}} token. See [[interaction token]].

|-
| {{text anchor|CHANGE_BODY_SIZE_PERC}}
| Caste
|
*integer
| Multiplies body size by a factor of (integer)%. 50 halves size, 200 doubles.

|-
| {{text anchor|CHANGE_FREQUENCY_PERC}}
| Creature
|
*integer
| Multiplies frequency by a factor of (integer)%.

|-
| {{text anchor|CHILD}}
| Caste
|
*integer
| Age at which creature is considered an adult - one can think of this as the duration of the [[children|child]] stage. Allows the creature's offspring to be rendered fully tame if [[animal trainer|trained]] during their childhood.

|-
| {{text anchor|CHILDNAME}}
| Caste
|
*singular
*plural
| Defines a new name for a creature in the child state at the caste level. For non-caste-specific child names, see {{token|GENERAL_CHILD_NAME|c}}.

|-
| {{text anchor|CLUSTER_NUMBER}}
| Creature
|
*min
*max
| The minimum/maximum numbers of how many creatures per spawned cluster. Certain vermin fish use this token in combination with temperate ocean and river biome tokens to perform seasonal migrations. Defaults to 1:1 if not specified.

|-
| {{text anchor|CLUTCH_SIZE}}
| Caste
|
*min
*max
|Number of [[egg]]s laid in one sitting.

|-
| {{text anchor|COLONY_EXTERNAL}}
| Caste
|
| Caste hovers around colony.

|-
| {{text anchor|COLOR}}
| Creature
|
*foreground
*background
*brightness
| Color of the creature's tile. See [[Color]] for usage.

|-
| {{text anchor|COMMON_DOMESTIC}}
| Caste
|
| When combined with any of {{token|PET|c}}, {{token|PACK_ANIMAL|c}}, {{token|WAGON_PULLER|c}} and/or {{token|MOUNT|c}}, the creature is guaranteed to be domesticated by any [[civilization]] with {{token|COMMON_DOMESTIC_PET|e}}, {{token|COMMON_DOMESTIC_PACK|e}}, {{token|COMMON_DOMESTIC_PULL|e}} and/or {{token|COMMON_DOMESTIC_MOUNT|e}} respectively. Such civilizations will always have access to the creature, even in the absence of wild populations. This token is invalid on {{token|FANCIFUL|c}} creatures.

|-
| {{text anchor|CONVERTED_SPOUSE}}
| Caste
|
| Creatures of this caste's species with the {{token|SPOUSE_CONVERTER|c}} and {{token|NIGHT_CREATURE_HUNTER|c}} tokens will kidnap {{token|SPOUSE_CONVERSION_TARGET|c}}s of an appropriate sex and convert them into castes with CONVERTED_SPOUSE.

|-
| {{text anchor|COOKABLE_LIVE}}
| Caste
|
| Set this to allow the creature to be cooked in meals without first being butchered/cleaned. Used by some water-dwelling vermin such as [[mussel]]s, [[nautilus]]es and [[oyster]]s.

|-
| {{text anchor|CRAZED}}
| Caste
|
| Creature is '[[insanity|berserk]]' and will attack all other creatures, except members of its own species that '''also''' have the CRAZED tag. It will show {{DFtext|Berserk|4:1}} in the [[unit list]]. Berserk creatures go on rampages during [[world generation|worldgen]] much more frequently than non-berserk ones.

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

|-
| {{text anchor|CREATURE_CLASS}}
| Caste
|
*classname
| An arbitrary creature classification. Can be set to anything, but the only vanilla uses are GENERAL_POISON (used in syndromes), EDIBLE_GROUND_BUG (used as targets for {{token|GOBBLE_VERMIN_CLASS|c}}), MAMMAL, and POISONOUS (both used for kobold pet eligibility). A single creature can have multiple classes.

The full list of tokens that use creature classes is:

* Creature tokens: {{token|GOBBLE_VERMIN_CLASS|c}}, {{token|GOBBLE_VERMIN_CLASS|c}}
* Interaction tokens: {{token|IT_AFFECTED_CLASS|in}}, {{token|IT_IMMUNE_CLASS|in}}
* Animal definition (Entity) tokens: {{token|ANIMAL_CLASS|e}}, {{token|ANIMAL_FORBIDDEN_CLASS|e}}
* Position (Entity) token: {{token|ALLOWED_CLASS|po}}
* Syndrome tokens: {{token|SYN_AFFECTED_CLASS|sy}}, {{token|SYN_IMMUNE_CLASS|sy}}, {{token|CE_SENSE_CREATURE_CLASS|sy}}
|-
| {{text anchor|CREATURE_SOLDIER_TILE}}
| Creature
|
*'character' or tile number
| Creatures active in their civilization's [[military]] will use this tile instead.

|-
| {{text anchor|CREATURE_TILE}}
| Creature
|
*'character' or tile number
| The symbol of the creature in ASCII mode.

|-
| {{text anchor|CREPUSCULAR}}
| Caste
|
| Sets the creature to be active at twilight in adventurer mode.

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

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

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

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

|-
| {{text anchor|CV_REMOVE_TAG}}
| Special
|
*TAG NAME
| Removes a tag. Used in conjunction with creature variation templates.
|}

{{alphabetical TOC|style=margin: 1em auto;}}

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

|-
| {{text anchor|DEMON}}
| Caste
|
| Found on generated [[demon]]s. Marks the caste to be used in the initial wave after breaking into the [[underworld]], and by the demon civilizations created during world-gen breachings{{verify}} {{version|0.47.01}}. Could not be specified in user-defined raws until version [[Release_information/0.47.01|0.47.01]].

|-
| {{text anchor|DESCRIPTION}}
| Caste
|
*text
| A brief description of the creature type, as displayed when viewing the creature's description/[[Thoughts and preferences|thoughts & preferences]] screen.

|-
| {{text anchor|DIE_WHEN_VERMIN_BITE}}
| Caste
|
| Causes the creature to die upon attacking. Used by [[honey bee]]s to simulate them dying after using their stingers.

|-
| {{text anchor|DIFFICULTY}}
| Caste
|
*integer
| Increases experience gain during adventure mode. Creatures with a difficulty of 11 or higher are not assigned for quests in adventure mode.

|-
| {{text anchor|DIURNAL}}
| Caste
|
| Sets the creature to be active during the day in Adventurer Mode.

|-
| {{text anchor|DIVE_HUNTS_VERMIN}}
| Caste
|
| The creature hunts vermin by diving from the air. On tame creatures, it has the same effect as {{token|HUNTS_VERMIN|c}}. Found on [[peregrine falcon]]s.

|-
| {{text anchor|DOES_NOT_EXIST}}
| Creature
|
| Adding this token to a creature prevents it from appearing in generated worlds (unless it's marked as [[Entity_token#ANIMAL_ALWAYS_PRESENT|always present]] for a particular civilisation). For example, adding it to [[dog]]s will lead to worlds being generated without dogs in them. Also removes the creature from the [[object testing arena]]'s spawn list. If combined with {{token|FANCIFUL|c}}, artistic depictions of the creature will occur regardless. Used by [[centaur]]s, [[chimera]]s and [[griffon]]s in the vanilla game.

Note: a creature tagged as DOES_NOT_EXIST can still be [[Interaction_token#I_EFFECT|summoned]] successfully, as long as it has a body defined in its raws. [http://www.bay12forums.com/smf/index.php?topic=165213.msg8086938#msg8086938]. It's also possible for another creature to [[Syndrome#CE_BODY_TRANSFORMATION|transform]] into it.
|}

{{alphabetical TOC|style=margin: 1em auto;}}

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

|-
| {{text anchor|EBO_ITEM}}
| Caste
|
*[[item token]]
*[[material token]] (ANY_HARD_STONE can be used for the material)
| Defines the item that the creature drops upon being [[butcher|butchered]]. Used with {{token|EXTRA_BUTCHER_OBJECT|c}}.

|-
| {{text anchor|EBO_SHAPE}}
| Caste
|
*gem shape
| The shape of the creature's extra [[butcher|butchering]] drop. Used with {{token|EXTRA_BUTCHER_OBJECT|c}}.

|-
| {{text anchor|EGG_MATERIAL}}
| Caste
|
* <[[material token]]>
* <[[Material_definition_token#Material_States|material state]]>
| Defines the material composition of [[egg]]s laid by the creature. [[creature_token#LAYS_EGGS|Egg-laying]] creatures in the default game define this 3 times, using LOCAL_CREATURE_MAT:EGGSHELL, LOCAL_CREATURE_MAT:EGG_WHITE, and then LOCAL_CREATURE_MAT:EGG_YOLK. Eggs will be made out of eggshell. Edibility is determined by tags on whites or yolk, but they otherwise do not exist.

|-
| {{text anchor|EGG_SIZE}}
| Caste
|
*size
| Determines the size of laid [[egg]]s. Doesn't affect hatching or cooking, but bigger eggs will be heavier, and may take longer to be hauled depending on the hauler's strength.

|-
| {{text anchor|EQUIPMENT_WAGON}}
| Creature
|
| Makes the creature appear as a large 3x3 [[wagon]] responsible for carrying trade goods, pulled by two {{token|WAGON_PULLER|c}} creatures and driven by a merchant.

|-
| {{text anchor|EQUIPS}}
| Caste
|
| Allows the creature to wear or wield items.

|-
| {{text anchor|EVIL}}
| Creature
|
| The creature is considered evil and will only show up in evil biomes. Civilizations with {{token|USE_EVIL_ANIMALS|e}} can domesticate them regardless of exotic status. Has no effect on cavern creatures except to restrict taming. A civilization with evil creatures can colonise evil areas.

|-
| {{text anchor|EXTRA_BUTCHER_OBJECT}}
| Caste
|
* BY_CATEGORY, BY_TYPE, BY_TOKEN
* TYPE, CATEGORY, or TOKEN
| The creature drops an additional object when [[butcher|butchered]], as defined by {{token|EBO_ITEM|c}} and {{token|EBO_SHAPE|c}}. Used for [[gizzard stone]]s in default creatures. For some materials, needs to be defined after caste definitions with SELECT_CASTE:ALL{{Bug|6355}}

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

|-
| {{text anchor|EXTRAVISION}}
| Caste
|
| The creature can see regardless of whether it has working eyes and has full 360 degree vision, making it impossible to strike the creature from a blind spot in combat.
|}

{{alphabetical TOC|style=margin: 1em auto;}}

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

|-
| {{text anchor|FANCIFUL}}
| Creature
|
| The creature is a thing of legend and known to all civilizations. Its materials cannot be requested or preferred. The tag also adds some art value modifiers. Used by a [[Fanciful|number of creatures]]. Conflicts with {{token|COMMON_DOMESTIC|c}}.

|-
| {{text anchor|FEATURE_ATTACK_GROUP}}
| Caste
|
| Found on [[Animal people#Subterranean animal people|subterranean animal-man]] tribals. Currently defunct. In previous versions, it caused these creatures to crawl out of chasms and underground rivers.

|-
| {{text anchor|FEATURE_BEAST}}
| Caste
|
| Found on [[forgotten beast]]s. Presumably makes it act as such, initiating underground attacks on fortresses, or leads to the pop-up message upon encountering one{{verify}}. Hides the creature from displaying in a world_sites_and_pops file. Does not create historical figures like generated forgotten beasts do. Could not be specified in user-defined raws until version [[Release_information/0.47.01|0.47.01]].

Requires specifying a {{token|BIOME|c}} in which the creature will live, and both surface and subterranean biomes are allowed. Does not stack with {{token|LARGE_ROAMING|c}} and if both are used the creature will not spawn. Appears to be incompatible with {{token|DEMON|c}} even if used in separate castes.

|-
| {{text anchor|FEMALE}}
| Caste
|
| Makes the creature biologically female, enabling her to [[Breeding|bear young]]. Usually specified inside a caste.

|-
| {{text anchor|FIREIMMUNE}}
| Caste
|
| Makes the creature immune to [[Interaction_token#FIREBALL|FIREBALL]] and [[Interaction_token#FIREJET|FIREJET]] attacks, and allows it to path through high temperature zones, like lava or fires. Does not, by itself, make the creature immune to the damaging effects of burning in [[fire]], and does not prevent general heat damage or melting on its own (this would require adjustments to be made to the creature's body [[Material_definition_token|materials]] - see the [[Dragon/raw|dragon raws]] for an example).

|-
| {{text anchor|FIREIMMUNE_SUPER}}
| Caste
|
| Like {{token|FIREIMMUNE|c}}, but also renders the creature immune to [[Interaction_token#DRAGONFIRE|DRAGONFIRE]] attacks.

|-
| {{text anchor|FISHITEM}}
| Caste
|
| The creature's corpse is a single [[Item_token#FISH_RAW|FISH_RAW]] food item that needs to be cleaned (into a [[Item_token#FISH|FISH]] item) at a [[fishery]] to become edible. Before being cleaned the item is referred to as "raw". The food item is categorized under "fish" on the food and stocks screens, and when uncleaned it is sorted under "raw fish" in the stocks (but does not show up on the food screen).
Without this or {{token|COOKABLE_LIVE|c}}, [[fishing|fished]] vermin will turn into food the same way as non-vermin creatures, resulting in multiple units of food (meat, brain, lungs, eyes, spleen etc.) from a single fished vermin. These units of food are categorized as meat by the game.

|-
| {{text anchor|FIXED_TEMP}}
| Caste
|
*temperature
| The creature's body is constantly at this temperature, heating up or cooling the surrounding area. Alters the temperature of the creature's inventory and all adjacent tiles, [[Temperature|with all the effects that this implies]] - may trigger wildfires at high enough values. Also makes the creature immune to extreme heat or cold, as long as the temperature set is not harmful to the materials that the creature is made from.

Note that temperatures of 12000 and higher may cause [[path|pathfinding]] issues in fortress mode.

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

|-
| {{text anchor|FLIER}}
| Caste
|
| Allows a creature to fly, independent of it having wings or not. Fortress Mode pathfinding only partially incorporates flying - flying creatures need a land path to exist between them and an area in order to access it, but as long as one such path exists, they do not need to use it, instead being able to fly over intervening obstacles. Winged creatures with this token can lose their ability to fly if their wings are crippled or severed. Winged creatures without this token will be unable to fly. (A 'wing' in this context refers to any body part with its own [[Body_token#FLIER|FLIER]] token).

|-
| {{text anchor|FREQUENCY}}
| Creature
|
*number, max 100
| Determines the chances of a creature appearing within its environment, with higher values resulting in more frequent appearance. Also affects the chance of a creature being brought in a caravan for trading. The game effectively considers all creatures that can possibly appear and uses the FREQUENCY value as a ''weight'' - for example, if there are three creatures with frequencies 10/25/50, the creature with [FREQUENCY:50] will appear approximately 58.8% of the time. Defaults to 50 if not specified. Not to be confused with {{token|POP_RATIO|c}}.
|}

{{alphabetical TOC|style=margin: 1em auto;}}

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

|-
| {{text anchor|GAIT}}
| Caste
|
* <gait type>
* <gait name>
* <max [[Gait#Speed|speed]]>
* <build up time>
* <max turning [[Gait#Speed|speed]]>
* <start [[Gait#Speed|speed]]>
* <energy expenditure>
* <gait flag(s)>
| Defines a gait by which the creature can move. See [[Gait]] for more information.

* <max speed> indicates the maximum [[Gait#Speed|speed]] achievable by a creature using this gait
* <start speed> indicates the creature's speed when it starts moving using this gait
* <build up time> indicates how long it will take for a creature using this gait to go from <start speed> to <max speed>. For example, a value of 10 means that it should be able to reach the maximum speed by moving 10 [[tile]]s in a straight line over even terrain.
* <max turning speed> indicates the maximum speed permissible when the creature suddenly changes its direction of motion. The creature's speed will be reduced to <max turning speed> if travelling at a higher speed than this before turning.
* <energy expenditure> indicates how energy-consuming the gait is. Higher values cause the creature to tire out faster. Persistent usage of a high-intensity gait will eventually lead to exhaustion and [[Status_icon#Non-flashing|collapse]].

'''NO_BUILD_UP''' can be specified instead of a <start speed> value to make the <max speed> instantly achievable upon initiating movement (this is equivalent to a <build up time> of 0). Note that <build up time> and <max turning speed> are both ignored if specified alongside this (as NO_BUILD_UP trumps <build up time> and preserves <max speed> whilst turning, and <max turning speed> cannot exceed <max speed>) so it is permissible to omit them so long as they are '''both''' omitted together.

It's possible to specify a <start speed> greater than the <max speed>; the moving creature will decelerate towards its <max speed> in this case.

'''valid gait types:'''
*'''WALK''' 
Used for moving normally over ground tiles.

*'''CRAWL''' 
Used for moving over ground tiles whilst [[Status_icon#Non-flashing|prone]].

*'''SWIM''' 
Used for moving through tiles containing [[water]] or [[magma]] at a [[Water#Depth|depth]] of at least 4/7.

*'''FLY''' 
Used for moving through [[open space]].

*'''CLIMB''' 
Used for moving whilst [[Climber|climbing]].

'''valid gait flags:'''
* '''AGILITY''' 
Speeds/slows movement depending on the creature's [[Attribute#Agility|Agility]] stat.

* '''STRENGTH''' 
Speeds/slows movement depending on the creature's [[Attribute#Strength|Strength]] stat.

* '''LAYERS_SLOW''' 
Makes [[Tissue_definition_token#THICKENS_ON_ENERGY_STORAGE|THICKENS_ON_ENERGY_STORAGE]] and [[Tissue_definition_token#THICKENS_ON_STRENGTH|THICKENS_ON_STRENGTH]] tissue layers slow movement depending on how thick they are. Adding the STRENGTH gait flag counteracts the impact of the latter layer.

* '''STEALTH_SLOWS:'''<percentage> 
Slows movement by the specified percentage when the creature is [[Ambusher|sneaking]].

|-
| {{text anchor|GENERAL_BABY_NAME}}
| Creature
|
*singular
*plural
| Like {{token|BABYNAME|c}}, but applied regardless of caste.

|-
| {{text anchor|GENERAL_CHILD_NAME}}
| Creature
|
*singular
*plural
| Like {{token|CHILDNAME|c}}, but applied regardless of caste.

|-
| {{text anchor|GENERAL_MATERIAL_FORCE_MULTIPLIER}}
| Caste
|
*value A
*value B
| Has the same function as {{token|MATERIAL_FORCE_MULTIPLIER|c}}, but applies to all attacks instead of just those involving a specific material. Appears to be overridden by MATERIAL_FORCE_MULTIPLIER ([[werebeast]]s, for example, use both tokens to provide resistance to all materials, with one exception to which they are especially vulnerable).

|-
| {{text anchor|GENERATED}}
| Creature
|
| Found on procedurally generated creatures like [[forgotten beast]]s, [[titan]]s, [[demon]]s, [[angel]]s, and [[night creature]]s. Cannot be specified in user-defined raws.

|-
| {{text anchor|GETS_INFECTIONS_FROM_ROT}}
| Caste
|
| Makes the creature get [[Health_care#Infection|infections]] from necrotic tissue.

|-
| {{text anchor|GETS_WOUND_INFECTIONS}}
| Caste
|
| Makes the creature's wounds become [[Health_care#Infection|infected]] if left untreated for too long.

|-
| {{text anchor|GLOWCOLOR}}
| Creature
|
*foreground
*background
*brightness
| The colour of the creature's {{token|GLOWTILE|c}}.

|-
| {{text anchor|GLOWTILE}}
| Creature
|
*ascii character
| If present, the being glows in the dark (generally used for Adventurer 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 {{token|CASTE_GLOWTILE|c}} instead.

|-
| {{text anchor|GNAWER}}
| Caste
|
*verb
| The creature can and will gnaw its way out of [[animal trap]]s and [[cage]]s using the specified verb, depending on the material from which it is made (normally wood).

|-
| {{text anchor|GOBBLE_VERMIN_CLASS}}
| Caste
|
*class
| The creature eats vermin of the specified class.

|-
| {{text anchor|GOBBLE_VERMIN_CREATURE}}
| Caste
|
*creature
*caste
| The creature eats a specified [[vermin]].

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

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

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

|-
| {{text anchor|GOOD}}
| Creature
|
| Creature is considered good and will only show up in good biomes - [[unicorn]]s, for example. Civilizations with {{token|USE_GOOD_ANIMALS|e}} can domesticate them regardless of exotic status. Has no effect on cavern creatures except to restrict taming. A civilization that has good creatures can colonise good areas in world-gen.

|-
| {{text anchor|GRASSTRAMPLE}}
| Caste
|
*value
| The value determines how rapidly [[grass]] is trampled when a creature steps on it - a value of 0 causes the creature to never damage grass, while a value of 100 causes grass to be trampled as rapidly as possible. Defaults to 5.

|-
| {{text anchor|GRAVITATE_BODY_SIZE}}
| Caste
|
*target value
| Used in Creature Variants. This token changes the adult body size to the average of the old adult body size and the target value and scales all intermediate growth stages by the same factor.

|-
| {{text anchor|GRAZER}}
| Caste
|
*number
| The creature is a grazer - if tamed in fortress mode, it needs a pasture to survive. The higher the number, the less frequently it needs to eat in order to live. Not used since 0.40.12, replaced by {{token|STANDARD_GRAZER|c}} to fix {{bugl|4113}}.
|}

{{alphabetical TOC|style=margin: 1em auto;}}

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

|-
| {{text anchor|HABIT}}
| Caste
|
*type
*probability
| Defines certain behaviors for the creature. The habit types are:
*COLLECT_TROPHIES
*COOK_PEOPLE
*COOK_VERMIN
*GRIND_VERMIN
*COOK_BLOOD
*GRIND_BONE_MEAL
*EAT_BONE_PORRIDGE
*USE_ANY_MELEE_WEAPON
*GIANT_NEST
*COLLECT_WEALTH.
These require the creature to have a {{token|LAIR|c}} to work properly, and also don't seem to work on creatures who are not a {{token|SEMIMEGABEAST|c}}, {{token|MEGABEAST|c}} or {{token|NIGHT_CREATURE_HUNTER|c}}.

|-
| {{text anchor|HABIT_NUM}}
| Caste
|
*number or TEST_ALL
| "If you set HABIT_NUM to a number, it should give you that exact number of habits according to the weights.".{{cite forum|60554/1719248}} All lists of HABITs are preceded by [HABIT_NUM:TEST_ALL]

|-
| {{text anchor|HAS_NERVES}}
| Caste
|
| The creature has nerves in its muscles. Cutting the muscle tissue can sever motor and sensory nerves.

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

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

|-
| {{text anchor|HOMEOTHERM}}
| Caste
|
*number or NONE
| Default 'NONE'. The creature's normal body [[temperature]]. Creature ceases maintaining temperature on death unlike fixed material temperatures. Provides minor protection from environmental temperature to the creature.

|-
| {{text anchor|HUNTS_VERMIN}}
| Caste
|
| Creature hunts and kills nearby [[vermin]].

|}

{{alphabetical TOC|style=margin: 1em auto;}}

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

|-
| {{text anchor|IMMOBILE}}
| Caste
|
| The creature cannot move. Found on [[sponge]]s. Will also stop a creature from breeding in fortress mode (MALE and FEMALE are affected, if one is IMMOBILE no breeding will happen).

|-
| {{text anchor|IMMOBILE_LAND}}
| Caste
|
| The creature is immobile while on land. Only works on {{token|AQUATIC|c}} creatures which can't breathe on land.

|-
| {{text anchor|IMMOLATE}}
| Caste
|
| The creature radiates [[fire]]. It will ignite, and potentially completely destroy, items the creature is standing on. Also gives the vermin a high chance of escaping from [[animal trap]]s and [[cage]]s made of any flammable materials (specifically ones that could be ignited by magma).

|-
| {{text anchor|INTELLIGENT}}
| Caste
|
| Alias for {{token|CAN_SPEAK|c}} + {{token|CAN_LEARN|c}} but additionally keeps creatures from being [[butcher|butchered]] by the AI during worldgen and post-gen. In fortress mode, {{token|CAN_LEARN|c}} is enough.

|-
| {{text anchor|ITEMCORPSE}}
| Caste
|
* [[item token]]
* [[material token]]
| Determines if the creature leaves behind a non-standard corpse (i.e. wood, statue, bars, stone, pool of liquid, etc.). [[Ethics]] may prevent actually using the item in jobs or reactions.

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

{{alphabetical TOC|style=margin: 1em auto;}}

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

|-
| {{text anchor|LAIR}}
| Caste
|
*type
*probability
| Found on megabeasts, semimegabeasts, and night creatures. The creature will seek out sites of this type and take them as lairs. The lair types are:
*SIMPLE_BURROW
*SIMPLE_MOUND
*WILDERNESS_LOCATION
*SHRINE
*LABYRINTH

|-
| {{text anchor|LAIR_CHARACTERISTIC}}
| Caste
|
*characteristic
*probability
| Defines certain features of the creature's lair. The only valid characteristic is HAS_DOORS.

|-
| {{text anchor|LAIR_HUNTER}}
| Caste
|
| This creature will actively hunt adventurers in its lair.

|-
| {{text anchor|LAIR_HUNTER_SPEECH}}
| Caste
|
*speech file
| What this creature says while hunting adventurers in its lair.

|-
| {{text anchor|LARGE_PREDATOR}}
| Caste
|
| Will attack things that are smaller than it (like dwarves). Only one group of "large predators" (possibly two groups on "savage" maps) will appear on any given map. In adventure mode, large predators will try to ambush and attack you (and your party will attack them back). When tamed, large predators tend to be much more aggressive to enemies than non-large predators, making them a good choice for an animal army. They may go on rampages in worldgen, and adventurers may receive quests to kill them. Also, they can be mentioned in the intro paragraph when starting a fortress e.g. "ere the wolves get hungry."

|-
| {{text anchor|LARGE_ROAMING}}
| Creature
|
| This is the core requisite tag allowing the creature to spawn as a wild animal in the appropriate biomes. Requires specifying a {{token|BIOME|c}} in which the creature will spawn. Does not require specifying a frequency, population number, or cluster number.

This tag stacks with {{token|MEGABEAST|c}}, {{token|SEMIMEGABEAST|c}}, or {{token|NIGHT_CREATURE_HUNTER|c}}; if used with one of these tags, the creature will spawn as both a boss and as a wild animal. This tag does not stack with {{token|FEATURE_BEAST|c}} and if both are used the creature will not spawn. This tag is uneffected by {{token|DEMON|c}}.

|-
| {{text anchor|LAYS_EGGS}}
| Caste
|
| Creature lays [[egg]]s instead of giving birth to live young.

|-
| {{text anchor|LAYS_UNUSUAL_EGGS}}
| Caste
|
* [[item token]]
* [[material token]]
| Creature lays the specified item instead of regular eggs.

|-
| {{text anchor|LIGAMENTS}}
| Caste
|
* [[material token]]
*healing rate
| The creature has ligaments in its {{token|CONNECTIVE_TISSUE_ANCHOR|td}} tissues (bone or chitin by default). Cutting the bone/chitin tissue severs the ligaments, disabling motor function if the target is a limb.

|-
| {{text anchor|LIGHT_GEN}}
| Caste
|
| The creature will generate light, such as in adventurer mode at night. Used to work correctly in prior versions of DF, confirmed for v0.23.130.23a and v0.28.181.40d. However, as of v0.47.05, use of this token is limited for use subterranean vermin in fort mode, the vermin can flicker in any unrevealed cavern layers that they are permitted to spawn in.
|-
| {{text anchor|LIKES_FIGHTING}}
| Caste
|
| The creature will attack enemies rather than flee from them. This tag has the same effect on player-controlled creatures - including modded dwarves. Retired as of v0.40.14 in favor of {{token|LARGE_PREDATOR|c}}.

|-
| {{text anchor|LISP}}
| Caste
|
| Creature uses "sssssnake talk" (multiplies 'S' when talking - "My name isss Recisssiz."). Used by [[Serpent man|serpent men]] and [[Reptile man|reptile men]] in the vanilla game. C's with the same pronunciation (depending on the word) are not affected by this token.

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

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

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

|-
| {{text anchor|LOCKPICKER}}
| Caste
|
| Lets a creature open [[door]]s that are set to forbidden in fortress mode.

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

|-
| {{text anchor|LOW_LIGHT_VISION}}
| Caste
|
*number
| Determines how well a creature can see in the dark - higher is better. Dwarves have 10000, which amounts to perfect nightvision.
|}

{{alphabetical TOC|style=margin: 1em auto;}}

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

|-
| {{text anchor|MAGICAL}}
| Caste
|
| According to Toady One, this is completely interchangeable with {{token|AT_PEACE_WITH_WILDLIFE|c}} and might have been used in very early versions of the game by wandering wizards or the ent-type tree creatures that used to be animated by elves. [http://www.bay12forums.com/smf/index.php?topic=169696.msg8316954#msg8316954]

|-
| {{text anchor|MAGMA_VISION}}
| Caste
|
| The creature is able to see while submerged in [[magma]].

|-
| {{text anchor|MALE}}
| Caste
|
| Makes the creature biologically male. Usually declared inside a caste.

|-
| {{text anchor|MANNERISM|MANNERISM_*}}
| Caste
|
*occasionally body part
| Adds a possible mannerism to the creature's profile. See [[creature mannerism token]] for further info.

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

|-
| {{text anchor|MATERIAL_FORCE_MULTIPLIER}}
| Caste
|
*[[Material token]]
*value A
*value B
| When struck with a weapon made of the specified material, the force exerted will be multiplied by A/B, thus making the creature more or less susceptible to this material. For example, if A is 2 and B is 1, the force exerted by the defined material will be doubled. If A is 1 and B is 2, it will be halved instead. See also {{token|GENERAL_MATERIAL_FORCE_MULTIPLIER|c}}, which can be used to make this sort of effect applicable to all materials.

|-
| {{text anchor|MATUTINAL}}
| Caste
|
| Sets the creature to be active at dawn in adventurer mode.

|-
| {{text anchor|MAXAGE}}
| Caste
|
*min
*max
| Determines the creature's natural lifespan, using the specified minimum and maximum age values (in years). Each individual creature with this token is generated with a predetermined date (calculated down to the exact [[time|tick]]!) between these values, at which it is destined to die of old age, should it live long enough. Note that the probability of death at any given age does not increase as the creature gets older [http://i.imgur.com/A1A4aA9.png].
Creatures which lack this token are naturally immortal. The [[Syndrome#CE_ADD_TAG|NO_AGING]] syndrome tag will prevent death by old age from occurring. Also note that, among civilized creatures, castes which lack this token will refuse to marry others with it, and vice versa.

|-
| {{text anchor|MEANDERER}}
| Caste
|
| Makes the creature slowly stroll around, unless it's in combat or performing a job. If combined with {{token|CAN_LEARN|c}}, will severely impact their [[pathfinding]] and lead the creature to move extremely slowly when not performing any task. Problematically applies to animal people based on the animal and war trained animals{{bug|9588}}.

|-
| {{text anchor|MEGABEAST}}
| Caste
|
| A 'boss' creature. A small number of the creatures are created during worldgen, their histories and descendants (if any) will be tracked in worldgen (as opposed to simply 'spawning'), and they will occasionally go on rampages, potentially leading to worship if they attack the same place multiple times. Their presence and number will also influence age names. When appearing in fortress mode, they will have a pop-up message announcing their arrival. They will remain hostile to military even after being tamed.{{bug|10731}} See [[megabeast]] page for more details.

Requires specifying a {{token|BIOME|c}} in which the creature will live. Subterranean biomes appear to not be allowed. Does stack with {{token|LARGE_ROAMING|c}} and if both are used the creature will spawn as both historical bosses and as wild animals.

|-
| {{text anchor|MENT_ATT_CAP_PERC}}
| Caste
|
*[[Attribute|ATTRIBUTE]] Token
*Cap %
|Default is 200. This means you can increase your attribute to 200% of its starting value (or the average value + your starting value if that is higher).

|-
| {{text anchor|MENT_ATT_RANGE}}
| Caste
|
*[[Attribute|ATTRIBUTE]]
*lowest
*lower
*low
*median
*high
*higher
*highest
| Sets up a [[Attribute#Soul_attributes|mental attribute]]'s range of values (0-5000). All mental attribute ranges default to 200:800:900:1000:1100:1300:2000.

|-
| {{text anchor|MENT_ATT_RATES}}
| Caste
|
*[[Attribute|ATTRIBUTE]] Token
*cost to improve
*unused counter rate
*rust counter rate
*demotion counter rate
| [[Attribute#Soul_attributes|Mental attribute]] gain/decay rates. Lower numbers in the last three slots make decay occur faster. Defaults are 500:4:5:4.

|-
| {{text anchor|MILKABLE}}
| Caste
|
* [[material token]]
* frequency
| Allows the creature to be [[milk]]ed in the [[farmer's workshop]]. The frequency is the amount of [[time|ticks]] the creature needs to "recharge" (i.e. how much time needs to pass before it can be milked again). Does not work on [[#CAN_LEARN|sentient]] creatures, regardless of [[ethics]].

|-
| {{text anchor|MISCHIEVIOUS}}
| Caste
|
| Alias for {{token|MISCHIEVOUS|c}}.

|-
| {{text anchor|MISCHIEVOUS}}
| Caste
|
| The creature spawns [[stealth]]ed and will attempt to path into the fortress, pulling any [[lever]]s it comes across. It will be invisible on the map and [[unit list]] until spotted by a citizen, at which point the game will pause and recenter on the creature. Used by [[gremlin]]s in the vanilla game. "They go on little missions to mess with various fortress buildings, not just levers."

|-
| {{text anchor|MODVALUE}}
| Caste
|
| Seemingly no longer used.

|-
| {{text anchor|MOUNT}}
| Caste
|
| Creature may be used as a [[mount]]. No use for the player in fortress mode, but enemy sieging forces may arrive with cavalry. Mounts are usable in adventure mode.

|-
| {{text anchor|MOUNT_EXOTIC}}
| Caste
|
| Creature may be used as a [[mount]], but civilizations cannot domesticate it in worldgen without certain exceptions.

|-
| {{text anchor|MULTIPART_FULL_VISION}}
| Caste
|
| Allows the creature to have all-around vision as long as it has multiple heads that can see.

|-
| {{text anchor|MULTIPLE_LITTER_RARE}}
| Caste
|
| Makes the species usually produce a single offspring per birth, occasionally producing twins or triplets with a 1/500 chance. Requires {{token|FEMALE|c}}.

|-
| {{text anchor|MUNDANE}}
| Creature
|
| Marks if the creature is an actual real-life creature. Only used for age-names at present.
|}

{{alphabetical TOC|style=margin: 1em auto;}}

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

|-
| {{text anchor|NAME}}
| Creature
|
*singular
*plural
*adjective
| The generic name for any creature of this type - will be used when distinctions between caste are unimportant. For names for specific castes, use {{token|CASTE_NAME|c}} instead. If left undefined, the creature will be labeled as "nothing" by the game.

|-
| {{text anchor|NATURAL}}
| Caste
|
| Animal is considered to be natural. NATURAL animals will not engage creatures tagged with {{token|AT_PEACE_WITH_WILDLIFE|c}} in combat unless they are members of a hostile entity and vice-versa.

|-
| {{text anchor|NATURAL_ANIMAL}}
| Caste
|
| Alias of {{token|NATURAL|c}}.

|-
| {{text anchor|NATURAL_SKILL}}
| Caste
|
*[[Skill_token|Skill token]]
*value
| The creature possesses the specified [[skill]] at this level inherently - that is, it begins with the skill at this level, and the skill may never rust below that. A value of 15 is legendary.

|-
| {{text anchor|NIGHT_CREATURE_BOGEYMAN}}
| Caste
|
| Creatures with this token can appear in [[bogeyman|bogeyman ambushes]] in [[adventure mode]], where they adopt classical bogeyman traits such as stalking the adventurer and vaporising when dawn breaks. Such traits do not manifest if the creature is encountered outside of a bogeyman ambush (for instance, as a megabeast or a civilised being). In addition, their corpses and severed body parts turn into [[smoke]] after a short while. Note that setting the "Number of Bogeyman Types" in [[advanced world generation]] to 0 will only remove randomly-generated bogeymen.

|-
| {{text anchor|NIGHT_CREATURE_EXPERIMENTER}}{{version|0.47.01}}
| Caste
|
| Found on some [[necromancer]]s. Creatures with this tag may periodically "perform horrible experiments" offscreen, during which they can use creature-targeting interactions with an <code>[[Interaction_token#I_SOURCE|[I_SOURCE:EXPERIMENT]]]</code> tag on living creatures in their area. Worlds are generated with a list of procedurally-generated experiments, allowing necromancers to turn living people and animals into [[Infected_ghoul|ghouls]] and [[Experiment|other experimental creatures]], and these will automatically be available to all experimenters; it does not appear possible to prevent this. You can mod in your own custom experiment interactions, but these are used very infrequently due to the large number of generated experiments.

|-
| {{text anchor|NIGHT_CREATURE_HUNTER}}
| Caste
|
| Found on [[night troll]]s and [[werebeast]]s. Implies that the creature is a [[night creature]], and shows its description in [[legends mode]] entry. The creature is always hostile and will start [[no quarter]] combat with any nearby creatures, except for members of its own race. Note that this tag does not override the creature's normal behavior in [[fortress mode]] except for the aforementioned aggression, and doesn't prevent the creature from fleeing the battles it started. It also removes the creature's materials from stockpile settings list, making them be stored there regardless of settings.

Does stack with {{token|LARGE_ROAMING|c}} and if both are used the creature will spawn as both historical hunters and as wild animals; this requires specifying a {{token|BIOME|c}} in which the creature will live, and subterranean biomes are allowed.

This tag causes the usual behaviour of werebeasts in worldgen, that is, fleeing towns upon being cursed and conducting raids from a lair. If this tag is absent from a deity curse, the accursed will simply be driven out of towns in a similar manner to [[vampire]]s. When paired with SPOUSE_CONVERTER, a very small population of the creature will be created during worldgen (sometimes only a single individual will be created), and their histories will be tracked (that is, they will not spawn spontaneously later, they must either have children or convert other creatures to increase their numbers). The creature will settle in a lair and go on rampages during worldgen. It will actively attempt to seek out potential conversion targets to abduct, convert, and have children with (if possible).

|-
| {{text anchor|NIGHT_CREATURE_NIGHTMARE}}{{version|0.47.01}}
| Caste
|
| Found on [[nightmare]]s. Corpses and severed body parts derived from creatures with this token turn into [[smoke]] after a short while.

|-
| {{text anchor|NO_AUTUMN}}
| Caste
|
| The creature caste does not appear in [[Calendar|autumn]].

|-
| {{text anchor|NO_CONNECTIONS_FOR_MOVEMENT}}
| Caste
|
| Creature doesn't require connected body parts to move{{verify}}; generally used on undead creatures with connections that have rotted away.

|-
| {{text anchor|NO_DIZZINESS}}
| Caste
|
| Creature cannot become [[Symptom#Dizziness|dizzy]].

|-
| {{text anchor|NO_DRINK}}
| Caste
|
| Creature does not need to drink.

|-
| {{text anchor|NO_EAT}}
| Caste
|
| Creature does not need to [[food|eat]]. Seems to cause worldgen crashes if it is part of an entity with [[entity_token#PERMITTED_JOB|[PERMITTED_JOB:FISHERMAN]]]{{verify}}

|-
| {{text anchor|NO_FEVERS}}
| Caste
|
| Creature cannot suffer [[Symptom#Fever|fevers]].

|-
| {{text anchor|NO_GENDER}}
| Caste
|
| The creature is biologically sexless. Makes the creature unable to [[breeding|breed]].

|-
| {{text anchor|NO_PHYS_ATT_GAIN}}
| Caste
|
| The creature cannot raise any [[Attribute#Body_attributes|physical attributes]].

|-
| {{text anchor|NO_PHYS_ATT_RUST}}
| Caste
|
| The creature cannot lose any [[Attribute#Body_attributes|physical attributes]].

|-
| {{text anchor|NO_SLEEP}}
| Caste
|
| Creature does not need to sleep. Can still be rendered unconscious by other means.

|-
| {{text anchor|NO_SPRING}}
| Caste
|
| The creature caste does not appear in [[Calendar|spring]].

|-
| {{text anchor|NO_SUMMER}}
| Caste
|
| The creature caste does not appear in [[Calendar|summer]].

|-
| {{text anchor|NO_THOUGHT_CENTER_FOR_MOVEMENT}}
| Caste
|
| Creature doesn't require an organ with the {{token|THOUGHT|body}} tag to survive or attack; generally used on creatures that don't have brains.

|-
| {{text anchor|NO_UNIT_TYPE_COLOR}}
| Caste
|
| Prevents creature from selecting its color based on its profession (e.g. Miner, Hunter, Wrestler).

|-
| {{text anchor|NO_VEGETATION_PERTURB}}
| Caste{{Verify}}
|
| Likely prevents the creature from leaving broken vegetation tracks.{{Verify}}

|-
| {{text anchor|NO_WINTER}}
| Caste
|
| The creature caste does not appear in [[Calendar|winter]].

|-
| {{text anchor|NOBONES}}
| Caste
|
| Creature has no bones.

|-
| {{text anchor|NOBREATHE}}
| Caste
|
| Creature doesn't need to breathe or have {{token|BREATHE|body}} parts in body, nor can it drown or be strangled. Creatures living in magma must have this tag, otherwise they will drown.

|-
| {{text anchor|NOCTURNAL}}
| Caste
|
| Sets the creature to be active at night in adventure mode.

|-
| {{text anchor|NOEMOTION}}
| Caste
|
| Creature has no emotions. It is immune to the effects of [[stress]] and unable to rage, and its [[need]]s cannot be fulfilled in any way. Used on [[undead]] in the vanilla game.

|-
| {{text anchor|NOEXERT}}
| Caste
|
| Creature can't become tired or over-exerted from taking too many combat actions or moving at full speed for extended periods of time.

|-
| {{text anchor|NOFEAR}}
| Caste
|
| Creature doesn't feel fear and will never flee from battle, and will be immune to [[ghost]]s' attempts to 'scare it to death'. Additionally, it causes [[bogeyman|bogeymen]] and [[nightmare]]s to become friendly towards the creature.

|-
| {{text anchor|NOMEAT}}
| Caste
|
| Creature will not drop meat when [[butcher|butchered]].

|-
| {{text anchor|NONAUSEA}}
| Caste
|
| Creature isn't nauseated by gut hits and cannot vomit.

|-
| {{text anchor|NOPAIN}}
| Caste
|
| Creature doesn't feel pain.

|-
| {{text anchor|NOSKIN}}
| Caste
|
| Creature will not drop a hide when [[butcher|butchered]].

|-
| {{text anchor|NOSKULL}}
| Caste
|
| Creature will not drop a skull on butchering, rot, or decay of severed head.

|-
| {{text anchor|NOSMELLYROT}}
| Caste
|
| Does not produce [[miasma]] when rotting.

|-
| {{text anchor|NOSTUCKINS}}
| Caste
|
| Weapons can't get stuck in the creature.

|-
| {{text anchor|NOSTUN}}
| Caste
|
| Creature can't be stunned and knocked unconscious by pain or head injuries. Creatures with this tag never wake up from sleep in Fortress Mode. If this creature needs to sleep while playing, it will die.

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

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

|-
| {{text anchor|NOTHOUGHT}}
| Caste
|
| Creature doesn't require a {{token|THOUGHT|body}} body part to survive. Has the added effect of preventing speech, though directly controlling creatures that would otherwise be capable of speaking allows them to engage in conversation.
|}

{{alphabetical TOC|style=margin: 1em auto;}}

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

|-
| {{text anchor|ODOR_LEVEL}}
| Caste
|
*number
| How easy the creature is to [[smell]]. The higher the number, the easier the creature is to sniff out. Defaults to 50. Vanilla creatures have values from 0 (undetectable) to 90 (noticeable by humans and dwarves).

|-
| {{text anchor|ODOR_STRING}}
| Caste
|
*string
| What the creature [[smell]]s like. If no odor string is defined, the creature name (not the caste name) is used.

|-
| {{text anchor|OPPOSED_TO_LIFE}}
| Caste
|
| Is hostile to all creatures except undead and other non-living ones and will show {{DFtext|Opposed to life|0:1}} in the [[unit list]]. Used by [[undead]] in the vanilla game. Functions without the {{token|NOT_LIVING|c}} token, and seems to imply said token as well. Undead will not be hostile to otherwise-living creatures given this token. Living creatures given this token will attack living creatures that lack it, while ignoring other living creatures that also have this token.

|-
| {{text anchor|ORIENTATION}}
| Caste
|
*MALE/FEMALE
*disinterested chance
*lover-possible chance
*preference(?)-possible chance
| Determines caste's likelihood of having sexual attraction to certain sexes. Values default to 75:20:5 for the same sex and 5:20:75 for the opposite sex. The first value indicates how likely to be entirely uninterested in the sex, the second decides if the creature will become lovers, the third decides if the creature will "prefer" this sex{{Verify}}. Marriage can happen as long as they are not disinterested. The values themselves are simply ratios and do not need to add up to any particular value.

|-
| {{text anchor|OUTSIDER_CONTROLLABLE}}{{version|0.42.01}}
| Caste
|
| Lets you play as an [[Adventurer_mode_character_creation#Outsider|outsider]] of this species in adventure mode.

|}

{{alphabetical TOC|style=margin: 1em auto;}}

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

|-
| {{text anchor|PACK_ANIMAL}}
| Caste
|
| Allows the creature to be used as a pack animal. Used by [[trading|merchants]] without wagons and adventurers. Also prevents creature from dropping hauled items on its own -- do ''not'' use for player-controllable creatures!

|-
| {{text anchor|PARALYZEIMMUNE}}
| Caste
|
| The creature is immune to all [[Syndrome#CE_PARALYSIS|paralyzing]] special attacks.

|-
| {{text anchor|PATTERNFLIER}}
| Caste
|
| Used to control the bat riders with paralyze-dart blowguns that flew through the 2D chasm. Doesn't do anything now.

|-
| {{text anchor|PEARL}}
| Caste
|
| In earlier versions, creature would generate [[pearl]]s. Does nothing in the current version.{{verify}}

|-
| {{text anchor|PENETRATEPOWER}}
| Caste
|
*value
| Controls the ability of [[vermin]] to find a way into containers when they are eating food from your stockpiles.

Objects made of most materials (e.g. metal) roll a number from 0-100, and if the resulting number is greater than the penetrate power, their contents escape for the time being. Objects made of [[wood]], [[leather]], [[amber]], or [[coral]] roll 0-95, and items made of [[cloth]] roll 0-90.

|-
| {{text anchor|PERSONALITY}}
| Caste
|
*ATTRIBUTE
*lowest
*median
*highest
| Determines the range and chance of personality traits. Standard is 0:50:100. See [[Personality trait]] for more info.

|-
| {{text anchor|PET}}
| Caste
|
| Allows the creature to be [[Animal_trainer|tamed]] in Fortress mode. Prerequisite for all other working animal roles. Civilizations that encounter it in worldgen will tame and domesticate it for their own use. Adding this to civilization members will classify them as pets instead of citizens, with all the [[Fun|problems]] that entails. However, you can solve these problems using the popular plugin [https://dffd.bay12games.com/file.php?id=13095| Dwarf Therapist], which is completely unaffected by the tag.

|-
| {{text anchor|PET_EXOTIC}}
| Caste
|
| Allows the creature to be [[Animal_trainer|tamed]] in Fortress mode. Prequisite for all other working animal roles. Civilizations cannot domesticate it in worldgen, with certain exceptions. More difficult to tame?{{verify}} Adding this to civilization members will classify them as pets instead of citizens, with all the [[Fun|problems]] that entails. ([[Gremlin|Example]]).

|-
| {{text anchor|PETVALUE}}
| Caste
|
*value
| How valuable a tamed animal is. Actual cost in points in the embarking screen is 1+(PETVALUE/2) for an untrained animal, 1+PETVALUE for a war/hunting one.

|-
| {{text anchor|PETVALUE_DIVISOR}}
| Caste
|
*value
| Divides the creature's {{token|PETVALUE|c}} by the specified number. Used by [[honey bee]]s to prevent a single hive from being worth a fortune.

|-
| {{text anchor|PHYS_ATT_CAP_PERC}}
| Caste
|
*[[Attribute|ATTRIBUTE]] Token
*Cap %
|Default is 200. This means you can increase your attribute to 200% of its starting value (or the average value + your starting value if that is higher).

|-
| {{text anchor|PHYS_ATT_RANGE}}
| Caste
|
*[[Attribute|ATTRIBUTE]]
*lowest
*lower
*low
*median
*high
*higher
*highest
| Sets up a [[Attribute#Body_attributes|physical attribute]]'s range of values (0-5000). All physical attribute ranges default to 200:700:900:1000:1100:1300:2000.

|-
| {{text anchor|PHYS_ATT_RATES}}
| Caste
|
*[[Attribute|ATTRIBUTE]] Token
*cost to improve
*unused counter rate
*rust counter rate
*demotion counter rate
| [[Attribute#Body_attributes|Physical attribute]] gain/decay rates. Lower numbers in the last three slots make decay occur faster. Defaults for STRENGTH, AGILITY, TOUGHNESS, and ENDURANCE are 500:3:4:3, while RECUPERATION and DISEASE_RESISTANCE default to 500:NONE:NONE:NONE.

|-
| {{text anchor|PLUS_BP_GROUP}}
| Caste
|
*BY_TYPE, BY_CATEGORY, or BY_TOKEN
*body type, category, or token
| Adds a body part group to selected body part group. Presumably used immediately after {{token|SET_BP_GROUP|c}}.

|-
| {{text anchor|PLUS_MATERIAL}}
| Creature
|
*material
| Adds a material to selected materials. Used immediately after {{token|SELECT_MATERIAL|c}}.

|-
| {{text anchor|POP_RATIO}}
| Caste
|
*number
| Weighted population of caste; Lower is rarer. Not to be confused with {{token|FREQUENCY|c}}.

|-
| {{text anchor|POPULATION_NUMBER}}
| Creature
|
*min
*max
| The minimum/maximum numbers of how many of these creatures are present in each world map tile of the appropriate region. Defaults to 1:1 if not specified.

|-
| {{text anchor|POWER}}
| Caste
|
| Allows the being to represent itself as a deity, allowing it to become the leader of a civilized group. Used by unique demons in the vanilla game. Requires {{token|CAN_SPEAK|c}} to actually do anything more than settle at a location (e.g. write books, lead armies, profane temples). Doesn't appear to do anything for creatures that are already civilized. Once the creature ascends to a position of leadership, it will proceed to act as a standard ruler for their entity and fulfill the same functions (hold tournaments, tame creatures, etc).

|-
| {{text anchor|PREFSTRING}}
| Creature
|
*string
| Sets what other creatures [[Preferences|prefer]] about this creature. "Urist likes dwarves for their beards." Multiple entries will be chosen from at random. Creatures lacking a PREFSTRING token will never appear under another's preferences.

|-
| {{text anchor|PROFESSION_NAME}}
| Creature
|
*[[Unit type token]] (Profession)
*singular
*plural
| The generic name for members of this profession, at the creature level. In order to give members of specific castes different names for professions, use {{token|CASTE_PROFESSION_NAME|c}} instead.

|-
| {{text anchor|PRONE_TO_RAGE}}
| Caste
|
*Chance
| Creature has a percentage chance to flip out at visible non-friendly creatures. Enraged creatures attack anything regardless of timidity and get a strength bonus to their hits. This is what makes [[badger]]s so hardcore.

|-
| {{text anchor|PUS}}
| Caste
|
* <[[material token]]>
* <[[Material_definition_token#Material_States|material state]]>
| The creature has pus. Specifies the stuff secreted by [[Health_care#Infection|infected wounds]].
|}

{{alphabetical TOC|style=margin: 1em auto;}}

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

|-
| {{text anchor|RELSIZE}}
| Caste
|
*BY_CATEGORY, BY_TYPE, BY_TOKEN
*body category, type, or token
*Relsize
| Specifies a new relative size for a part than what is stated in the body plan. For example, dwarves have larger livers.

|-
| {{text anchor|REMAINS}}
| Caste
|
*singular
*plural
| What the creature's [[remains]] are called.

|-
| {{text anchor|REMAINS_COLOR}}
| Caste
|
| What color the creature's [[remains]] are.

|-
| {{text anchor|REMAINS_ON_VERMIN_BITE_DEATH}}
| Caste
|
| Goes with {{token|VERMIN_BITE|c}} and {{token|DIE_WHEN_VERMIN_BITE|c}}, the vermin creature will leave remains on death when biting. Leaving this tag out will cause the creature to disappear entirely after it bites.

|-
| {{text anchor|REMAINS_UNDETERMINED}}
| Caste
|
| Unknown.

|-
| {{text anchor|REMOVE_MATERIAL}}
| Creature
|
*material token
| Removes a material from the creature.

|-
| {{text anchor|REMOVE_TISSUE}}
| Creature
|
*tissue token
| Removes a tissue from the creature.

|-
| {{text anchor|RETRACT_INTO_BP}}
| Caste
|
*BY_TYPE, BY_CATEGORY or BY_TOKEN
*body type, [[Body_token#CATEGORY|category]], or [[Body_token#BP|token]]
*Second person ("You") retract verb text
*Third person ("The giant snail") retract verb text
*Second person cancel retract text
*Third person cancel retract text
| The creature will retract into a body part when threatened. It will be unable to move or attack, but enemies will only be able to attack the specified body part. (eg. Turtle, Hedgehog)

Second-person descriptions are used for adventurer mode natural ability. "<pro_pos>" can be used in the descriptions, being replaced with the proper pronoun (or lack thereof) in-game.

Undead curled up creatures are buggy{{bug|11463}}{{bug|10519}}.
|-
| {{text anchor|RETURNS_VERMIN_KILLS_TO_OWNER}}
|
|
| Cat behavior. If it kills a vermin creature and has an owner, it carries the remains in its mouth and drops them at their feet. Requires {{token|HUNTS_VERMIN|c}}, obviously.

|-
| {{text anchor|ROOT_AROUND}}
| Caste
|
*BY_TYPE, BY_CATEGORY or BY_TOKEN
*body type, [[Body_token#CATEGORY|category]], or [[Body_token#BP|token]]
*Second person ("You") verb text
*Third person ("The hen") verb text
| Creature will occasionally root around in the grass, looking for insects. Used for flavor in Adventurer Mode, spawns vermin edible for this creature in Fortress Mode. Creatures missing the specified body part will be unable to perform this action. The action produces a message (visible in adventure mode) in the form:

[creature] [verb text] the [description of creature's location]

In adventure mode, the "rooting around" ability will be included in the "natural abilities" menu, represented by its second person verb text.

|}

{{alphabetical TOC|style=margin: 1em auto;}}

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

|-
| {{text anchor|SAVAGE}}
| Creature
|
| The creature will only show up in "savage" biomes. Has no effect on cavern creatures. Cannot be combined with {{token|GOOD|c}} or {{token|EVIL|c}}.

|-
| {{text anchor|SECRETION}}
| Caste
|
*<[[material token]]>
*<[[Material_definition_token#Material_States|material state]]>
*BY_TOKEN / BY_CATEGORY / BY_TYPE
*<[[Body_token#BP|body part ID]]> / <[[Body_token#CATEGORY|category]]> or ALL / <type (e.g. [[Body_token#GRASP|GRASP]])>
*<[[Body_detail_plan_token#BP_LAYERS|tissue layer]]> or ALL
*<trigger>
| Causes the specified tissue layer(s) of the indicated body part(s) to secrete the designated material. A size 100 ('covering') [[contaminant]] is created over the affected body part(s) in its specified material state (and at the temperature appropriate to this state) when the trigger condition is met, as long as one of the secretory tissue layers is still intact. Valid triggers are:
*'''CONTINUOUS'''
Secretion occurs once every 40 [[time|ticks]] in [[fortress mode]], and every tick in [[adventurer mode]].
*'''EXERTION'''
Secretion occurs continuously (at the rate described above) whilst the creature is at minimum {{Tile|Tired|6:1}} following physical exertion. Note that this cannot occur if the creature has {{token|NOEXERT|c}}.
*'''EXTREME_EMOTION'''
Secretion occurs continuously (as above) whilst the creature is distressed. Cannot occur in creatures with {{token|NOEMOTION|c}}.

|-
| {{text anchor|SELECT_ADDITIONAL_CASTE}}
| Creature
|
*<caste>
| Adds an additional previously defined caste to the selection. Used after {{token|SELECT_CASTE|c}}.

|-
| {{text anchor|SELECT_CASTE}}
| Creature
|
*<caste> or ALL
| Selects a previously defined caste

|-
| {{text anchor|SELECT_MATERIAL}}
| Creature
|
*<[[material token]]>
| Selects a locally defined material. Can be ALL.

|-
| {{text anchor|SELECT_TISSUE}}
| Creature
|
*tissue token
| Selects a tissue for editing.

|-
| {{text anchor|SEMIMEGABEAST}}
| Caste
|
| Essentially the same as {{token|MEGABEAST|c}}, but more of them are created during worldgen. See the [[semi-megabeast]] page for details.

|-
| {{text anchor|SENSE_CREATURE_CLASS}}
| Caste
|
* <[[Creature_token#CREATURE_CLASS|creature class]]>
* [[Tilesets|<tile value or character>]]
* [[Color#Color_values|<foreground color>:<background color>:<foreground brightness>]]
| Gives the creature the ability to sense creatures belonging to the specified [[Creature_token#CREATURE_CLASS|creature class]] even when they lie far beyond line of sight, including through walls and floors. It also appears to reduce or negate the combat penalty of [[Wound#Blindness|blind]] units when fighting creatures they can sense. In [[adventure mode]], the specified tile will be used to represent sensed creatures when they cannot be seen directly.

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

|-
| {{text anchor|SKILL_LEARN_RATE}}
| Caste
|
*<[[skill_token]]>
*<percentage>
| The rate at which this creature learns this skill. Requires {{token|CAN_LEARN|c}} or {{token|INTELLIGENT|c}} to function.

|-
| {{text anchor|SKILL_LEARN_RATES}}
| Caste
|
*<percentage>
| The rate at which this creature learns all skills. Requires {{token|CAN_LEARN|c}} or {{token|INTELLIGENT|c}} to function.

|-
| {{text anchor|SKILL_RATE}}
| Caste
|
*[[skill_token]]
*<% of improvement points gained>
*<unused counter rate>
*<rust counter rate>
*<demotion counter rate>
| Like {{token|SKILL_RATES|c}}, but applies to individual skills instead. Requires {{token|CAN_LEARN|c}} or {{token|INTELLIGENT|c}} to function.

|-
| {{text anchor|SKILL_RATES}}
| Caste
|
*<% of improvement points gained>
*<unused counter rate>
*<rust counter rate>
*<demotion counter rate>
| Affects skill gain and decay. Lower numbers in the last three slots make decay occur faster ([SKILL_RATES:100:1:1:1] would cause rapid decay). The counter rates may also be replaced with NONE.
Default is [SKILL_RATES:100:8:16:16]. Requires {{token|CAN_LEARN|c}} or {{token|INTELLIGENT|c}} to function.

|-
| {{text anchor|SKILL_RUST_RATE}}
| Caste
|
*[[skill_token]]
*value
*value
*value
| The rate at which this skill decays. Lower values cause the skill to decay faster. Requires {{token|CAN_LEARN|c}} or {{token|INTELLIGENT|c}} to function.

|-
| {{text anchor|SKILL_RUST_RATES}}
| Caste
|
*value
*value
*value
| The rate at which all skills decay. Lower values cause the skills to decay faster. Requires {{token|CAN_LEARN|c}} or {{token|INTELLIGENT|c}} to function.

|-
| {{text anchor|SLOW_LEARNER}}
| Caste
|
| Shorthand for {{token|CAN_LEARN|c}} + <code>[[Creature_token#SKILL_LEARN_RATES|[SKILL_LEARN_RATES:50]]]</code>.{{verify}} Used by a number of 'primitive' creatures (like [[ogre]]s, [[giant]]s and [[troglodyte]]s) in the vanilla game. Applicable to player races. Prevents a player from recruiting nobility, even basic ones. Subterranean creatures with this token combined with {{token|EVIL|c}} will become servants of goblins in their civilizations, in the style of [[troll]]s.

|-
| {{text anchor|SMALL_REMAINS}}
| Caste
|
| Creature leaves "[[item token#REMAINS|remains]]" instead of a corpse. Used by [[vermin]].

|-
| {{text anchor|SMELL_TRIGGER}}
| Creature
|
*value
| Determines how keen a creature's sense of smell is - lower is better. At 10000, a creature cannot smell at all.

|-
| {{text anchor|SOLDIER_ALTTILE}}
| Creature
|
*'character' or tile number
| If this creature is active in its civilization's military, it will blink between its default tile and this one.

|-
| {{text anchor|SOUND}}
| Caste
|
* Sound application (currently accepts ALERT or PEACEFUL_INTERMITTENT)
* Sound range (in tiles)
* Sound delay (lower values = sound is produced more often)
* VOCALIZATION or NONE (determines whether the sound requires breathing or not)
* First-person description
* Third-person description
* Description when out of sight
| Creature makes sounds periodically, which can be heard in Adventure mode.
* First-person reads "You '''bark'''"
* Third-person reads "The [[capybara]] '''barks'''"
* Out of sight reads "You hear '''a loud bark'''"
with the text in bold being the description arguments of the token.

|-
| {{text anchor|SOURCE_HFID}}
| Creature
|
*Integer (generic token?)
| Found on generated [[angel]]s. This is the historical figure ID of the deity with which the angel is associated. Since HFIDs are not predictable before worldgen, this isn't terribly usable in mods.

|-
| {{text anchor|SPECIFIC_FOOD}}
| Caste
|
* PLANT or CREATURE
* Plant/creature ID
| Creature will only appear in biomes with this plant or creature available. Grazers given a specific type of grass (such as [[panda]]s and [[bamboo]]) will only eat that grass and nothing else, risking starvation if there's none available.

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

|-
| {{text anchor|SPEECH_FEMALE}}
| Creature
|
*speech file
| Boasting speeches relating to killing females of this creature.

|-
| {{text anchor|SPEECH_MALE}}
| Creature
|
*speech file
| Boasting speeches relating to killing males of this creature.

|-
| {{text anchor|SPHERE}}
| Creature
|
* [[Sphere#Available_spheres|sphere]]
| Sets what religious spheres the creature is aligned to, for purposes of being worshipped via the {{token|POWER|c}} token. Also affects how the creature's name is generated.

|-
| {{text anchor|SPOUSE_CONVERSION_TARGET}}
| Caste
|
| This creature can be converted by a night creature with {{token|SPOUSE_CONVERTER|c}}.

|-
| {{text anchor|SPOUSE_CONVERTER}}
| Caste
|
| If the creature has the {{token|NIGHT_CREATURE_HUNTER|c}} tag, it will kidnap {{token|SPOUSE_CONVERSION_TARGET|c}}s and transform them into the caste of its species with the {{token|CONVERTED_SPOUSE|c}} tag during worldgen. It may also start families this way.

|-
| {{text anchor|SPREAD_EVIL_SPHERES_IF_RULER}}{{version|0.47.01}}
| Caste
|
| If the creature rules over a [[site]], it will cause the local landscape to be corrupted into [[Surroundings#Evil|evil surroundings]] associated with the creature's [[Creature_token#SPHERE|sphere]]s. The creature must have at least one of the following [[sphere]]s for this to take effect: BLIGHT, DEATH, DISEASE, DEFORMITY, NIGHTMARES. The first three kill vegetation, while the others sometimes do. The last two get [[Plant_token#EVIL|evil plants]] and [[Creature_token#EVIL|evil animals]] sometimes. NIGHTMARES gets [[bogeyman|bogeymen]]. [http://www.bay12forums.com/smf/index.php?topic=169696.msg8162224#msg8162224] Used by [[demon]]s in the vanilla game.

|-
| {{text anchor|STANCE_CLIMBER}}
| Caste
|
| Caste does not require <code>[[Body_token#GRASP|[GRASP]]]</code> body parts to climb -- it can climb with <code>[[Body_token#STANCE|[STANCE]]]</code> parts instead.

|-
| {{text anchor|STANDARD_GRAZER}}
| Caste
|
| Acts as {{token|GRAZER|c}} but set to 20000*G*(max size)^(-3/4), where G defaults to 100 but can be set in d_init, and the whole thing is trapped between 150 and 3 million. Used for all grazers in the default creature raws.

|-
| {{text anchor|STRANGE_MOODS}}{{version|0.42.01}}
| Caste
|
| The creature will get [[strange mood]]s in fortress mode and can produce artifacts.

|-
| {{text anchor|SUPERNATURAL}}
| Caste
|
| Gives the creature knowledge of any secrets with <code>[[Interaction_token#IS_SECRET|[SUPERNATURAL_LEARNING_POSSIBLE]]]</code> that match its [[Creature_token#SPHERE|spheres]] and also prevents it from becoming a [[vampire]] or [[werebeast]]. Other effects are unknown.

|-
| {{text anchor|SWIMS_INNATE}}
| Caste
|
| The creature naturally knows how to swim perfectly and does not use the [[swimmer]] skill, as opposed to {{token|SWIMS_LEARNED|c}} below. However, Fortress mode AI never paths into water anyway, so it's less useful there.

|-
| {{text anchor|SWIMS_LEARNED}}
| Caste
|
| The creature swims only as well as their present [[Swimmer|swimming skill]] allows them to.

|-
| {{text anchor|SYNDROME_DILUTION_FACTOR}}{{version|0.42.01}}
| Caste
| <[[Syndrome#SYN_IDENTIFIER|syndrome identifier]]>:<percentage>
| Dilutes the effects of syndromes which have the specified identifier. A percentage of 100 is equal to the regular syndrome effect severity, higher percentages reduce severity.
|}

{{alphabetical TOC|style=margin: 1em auto;}}

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

|-
| {{text anchor|TENDONS}}
| Caste
|
* [[material token]]
*healing rate
| The creature has tendons in its {{token|CONNECTIVE_TISSUE_ANCHOR|td}} tissues (bone or chitin by default). Cutting the bone/chitin tissue severs the tendons, disabling motor function if the target is a limb.

|-
| {{text anchor|THICKWEB}}
| Caste
|
| The creature's [[web]]s can catch larger creatures.

|-
| {{text anchor|TISSUE}}
| Creature
|
*name
| Begins defining a tissue in the creature file.

|-
| {{text anchor|TISSUE_LAYER}}
| Caste
|
*BY_TYPE, BY_CATEGORY, BY_TOKEN
*TYPE,CATEGORY, or TOKEN
*TISSUE
*LOCATION
| Adds the tissue layer to wherever it is required.
Non-argument Locations can be FRONT, RIGHT, LEFT, TOP, BOTTOM. Argument locations are AROUND and CLEANS, requiring a further body part and a % of coverage/cleansing

|-
| {{text anchor|TISSUE_LAYER_OVER}}
| Caste
|
*BY_TYPE, BY_CATEGORY, BY_TOKEN
*TYPE,CATEGORY, or TOKEN
*TISSUE
*LOCATION
| Presumably a counterpart to TISSUE_LAYER_UNDER (see below).

|-
| {{text anchor|TISSUE_LAYER_UNDER}}
| Caste
|
*BY_TYPE, BY_CATEGORY, BY_TOKEN
*TYPE,CATEGORY, or TOKEN
*TISSUE
| Adds the tissue layer under a given part.
For example, an [[iron man]] has a gaseous poison within, and this tissue (GAS is its name) has the token [TISSUE_LEAKS] and its state is GAS, so when you puncture the iron outside and damage this tissue it leaks gas (can have a syndrome by using a previous one in the creature sample.) [TISSUE_LAYER_UNDER:BY_CATEGORY:ALL:{tissue}] {tissue} is what will be under the TISSUE_LAYER; here is an example Tissue from the 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]

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

|-
| {{text anchor|TRADE_CAPACITY}}
| Caste
|
*number
| How much the creature can carry when used by merchants.

|-
| {{text anchor|TRAINABLE}}
| Caste
|
| Shortcut for {{token|TRAINABLE_HUNTING|c}} + {{token|TRAINABLE_WAR|c}}.

|-
| {{text anchor|TRAINABLE_HUNTING}}
| Caste
|
| Can be [[Animal trainer|trained]] as a hunting beast, increasing speed.

|-
| {{text anchor|TRAINABLE_WAR}}
| Caste
|
| Can be [[Animal trainer|trained]] as a war beast, increasing strength and endurance.

|-
| {{text anchor|TRANCES}}
| Caste
|
| Allows the creature to go into [[martial trance]]s. Used by dwarves in the vanilla game.

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

|-
| {{text anchor|TRIGGERABLE_GROUP}}
| Creature
|
*min
*max
| A large swarm of vermin can be disturbed, usually in adventurer mode.{{verify}}

|-
| {{text anchor|TSU_NOUN}}
| Caste
|
*noun
*SINGULAR or PLURAL
| Noun for the {{token|TISSUE_STYLE_UNIT|c}}, used in the description of the tissue layer's style.
|}

{{alphabetical TOC|style=margin: 1em auto;}}

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

|-
| {{text anchor|UBIQUITOUS}}
| Creature
|
| Creature will occur in every region with the correct biome. Does not apply to {{token|EVIL|c}}/{{token|GOOD|c}} tags.

|-
| {{text anchor|UNDERGROUND_DEPTH}}
| Creature
|
*mindepth
*maxdepth
| Depth that the creature appears underground. Numbers can be from 0 to 5. 0 is actually 'above ground' and can be used if the creature is to appear both above and below ground. Values from 1-3 are the respective [[cavern]] levels, 4 is the [[magma sea]] and 5 is the [[HFS]]. A single argument may be used instead of min and max. [[Demon]]s use only 5:5; user-defined creatures with both this depth and {{token|FLIER}} will take part in the initial wave from the HFS alongside generated demons, but without {{token|FLIER}} they will only spawn from the map edges. Civilizations that can use underground plants or animals will only export (via the embark screen or caravans) things that are available at depth 1.

|-
| {{text anchor|UNDERSWIM}}
| Caste
|
| The creature is displayed as blue when in [[Water#Depth|7/7 water]]. Used on fish and amphibious creatures which swim under the water.

|-
| {{text anchor|UNIQUE_DEMON}}
| Caste
|
| 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. Could not be specified in user-defined raws prior to version [[Release_information/0.47.01|0.47.01]].

|-
| {{text anchor|USE_CASTE}}
| Creature
|
*new caste token
*old caste token
| Defines a new caste derived directly from a previous caste. The new caste inherits all properties of the old one. The effect of this tag is automatic if one has not yet defined any castes: "Any caste-level tag that occurs before castes are explicitly declared is saved up and placed on any caste that is declared later, unless the caste is explicitly derived from another caste."

|-
| {{text anchor|USE_MATERIAL}}
| Creature
|
*new material ID
*old material ID
| Defines a new local creature material and populates it with all properties defined in the specified local creature material.

|-
| {{text anchor|USE_MATERIAL_TEMPLATE}}
| Creature
|
*new material token
*material template
| Defines a new local creature material and populates it with all properties defined in the specified template.

|-
| {{text anchor|USE_TISSUE}}
| Creature
|
*new tissue token
*old tissue id
| Defines a new local creature tissue and populates it with all properties defined in the local tissue specified in the second argument.

|-
| {{text anchor|USE_TISSUE_TEMPLATE}}
| Creature
|
*new tissue token
*tissue template
| Loads a tissue template listed in OBJECT:TISSUE_TEMPLATE files, such as tissue_template_default.txt.

|-
| {{text anchor|UTTERANCES}}
| Caste
|
| Changes the language of the creature into unintelligible 'kobold-speak', which creatures of other species will be unable to understand. If a civilized creature has this and is not part of a {{token|SKULKING|e}} civ, it will tend to start wars with all nearby civilizations and will be unable to make peace treaties due to 'inability to communicate'.
|}

{{alphabetical TOC|style=margin: 1em auto;}}

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

|-
| {{text anchor|VEGETATION}}
| Caste
|
| Like {{token|AT_PEACE_WITH_WILDLIFE}}, but also makes the creature more valued in artwork by civilisations with the PLANT [[sphere]]. [http://www.bay12forums.com/smf/index.php?topic=169696.msg8316954#msg8316954] Used by [[grimeling]]s in the vanilla game.

|-
| {{text anchor|VERMIN_BITE}}
| Caste
|
*chance of occurrence{{verify}}
*verb (bitten, stung, etc.)
* [[material token]]
* [[Material_definition_token#Material_States|material state]]
| Enables vermin to bite other creatures, injecting the specified material. See {{token|SPECIALATTACK_INJECT_EXTRACT|c}} for details about injection - this token presumably works in a similar manner.{{verify}}

|-
| {{text anchor|VERMIN_EATER}}
| Creature
|
| The vermin creature will attempt to eat exposed food. See {{token|PENETRATEPOWER|c}}. Distinct from {{token|VERMIN_ROTTER|c}}.

|-
| {{text anchor|VERMIN_FISH}}
| Creature
|
| The vermin appears in [[water]] and will attempt to swim around.

|-
| {{text anchor|VERMIN_GROUNDER}}
| Creature
|
| The creature appears in "general" surface ground locations. Note that this doesn't stop the creature from flying if it can (most vermin birds have this tag).

|-
| {{text anchor|VERMIN_HATEABLE}}
| Caste
|
| Some dwarves will [[Preferences|hate]] the creature and get unhappy thoughts when around it. See the [[Hateable|list of hateable vermin]] for details.

|-
| {{text anchor|VERMIN_MICRO}}
| Caste
|
| This makes the creature move in a swarm of creatures of the same race as it (e.g. swarm of flies, swarm of ants).

|-
| {{text anchor|VERMIN_NOFISH}}
| Caste
|
| The creature cannot be caught by [[fishing]].

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

|-
| {{text anchor|VERMIN_NOTRAP}}
| Caste
|
| The creature cannot be caught in baited [[animal trap]]s; however, a "[[Trapper|catch live land animal]]" task may still be able to capture one if a dwarf finds one roaming around.

|-
| {{text anchor|VERMIN_ROTTER}}
| Creature
|
| The vermin are attracted to rotting stuff and loose food left in the open and cause unhappy thoughts to dwarves who encounter them. Present on flies, knuckle worms, acorn flies, and blood gnats. Speeds up decay?{{verify}}

|-
| {{text anchor|VERMIN_SOIL}}
| Creature
|
| The creature randomly appears near dirt or mud, and may be uncovered by creatures that have the {{token|ROOT_AROUND|c}} interaction such as [[goose|geese]] and [[chicken]]s. Dwarves will ignore the creature when given the "Capture live land animal" task.

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

|-
| {{text anchor|VERMINHUNTER}}
| Caste
|
| Old shorthand for "does cat stuff". Contains {{token|AT_PEACE_WITH_WILDLIFE|c}} + {{token|RETURNS_VERMIN_KILLS_TO_OWNER|c}} + {{token|HUNTS_VERMIN|c}} + {{token|ADOPTS_OWNER|c}}.

|-
| {{text anchor|VESPERTINE}}
| Caste
|
| Sets the creature to be active during the evening in adventurer mode.

|-
| {{text anchor|VIEWRANGE}}
| Caste
|
*value
| Value should determine how close you have to get to a critter before it attacks (or prevents adv mode travel etc.) Default is 20.

|-
| {{text anchor|VISION_ARC}}
| Caste
|
*binocular vision arc
*non-binocular vision arc
| The width of the creature's vision arcs, in degrees (i.e. 0 to 360). The first number is binocular vision, the second is non-binocular vision. Binocular vision has a minimum of about 10 degrees, monocular, a maximum of about 350 degrees. Values past these limits will be accepted, but will default to ~10 degrees and ~350 degrees respectively.
|}

{{alphabetical TOC|style=margin: 1em auto;}}

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

|-
| {{text anchor|WAGON_PULLER}}
| Caste
|
| Allows the creature to pull caravan wagons. If a civilization doesn't have access to any, it is restricted to trading with pack animals.

|-
| {{text anchor|WEBBER}}
| Caste
|
* [[material token]]
| Allows the creature to create [[web]]s, and defines what the webs are made of.

|-
| {{text anchor|WEBIMMUNE}}
| Caste
|
| The creature will not get caught in thick [[web]]s. Used by creatures who can shoot thick webs (such as [[giant cave spider]]s) in order to make them immune to their own attacks.
|}

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

|-
| {{text anchor|ATTACK_SKILL}}
| Caste
|
*[[Skill token]]
| Defines the skill used by the attack.

|-
| {{text anchor|ATTACK_VERB}}
| Caste
|
*2nd person
*3rd person
| Descriptive text for the attack.

|-
| {{text anchor|ATTACK_CONTACT_PERC}}
| Caste
|
*% value
| The contact area of the attack, measured in % of the body part's volume. Note that all attack percentages can be more than 100%.

|-
| {{text anchor|ATTACK_PENETRATION_PERC}}
| Caste
|
*% value
| The penetration value of the attack, measured in % of the body part's volume. Requires ATTACK_FLAG_EDGE. Maximum value: 15000.

|-
| {{text anchor|ATTACK_PRIORITY}}
| Caste
|
*MAIN or SECOND
| Usage frequency. MAIN attacks are 100 times more frequently chosen than SECOND. Opportunity attacks ignore this preference.

|-
| {{text anchor|ATTACK_VELOCITY_MODIFIER}}
| Caste
|
*number
| The velocity multiplier of the attack, multiplied by 1000.

|-
| {{text anchor|ATTACK_FLAG_CANLATCH}}
| Caste
|
| Attacks that damage tissue have the chance to latch on in a wrestling hold. The grabbing bodypart can then use the "shake around" wrestling move, causing severe, armor-bypassing tensile damage according to the attacker's body volume.

|-
| {{text anchor|ATTACK_FLAG_WITH}}
| Caste
|
| Displays the name of the body part used to perform an attack while announcing it, e.g. "The weaver punches the bugbat with his right hand".

|-
| {{text anchor|ATTACK_FLAG_EDGE}}
| Caste
|
| The attack is edged, with all the effects on physical resistance and contact area that it entails.

|-
| {{text anchor|ATTACK_PREPARE_AND_RECOVER}}
| Caste
|
* Preparation time
* Recovery time
| Determines the length of time to prepare this attack and until one can perform this attack again. Values appear to be calculated in adventure mode ticks.

|-
| {{text anchor|ATTACK_FLAG_BAD_MULTIATTACK}}
| Caste
|
| Multiple strikes with this attack cannot be performed effectively.

|-
| {{text anchor|ATTACK_FLAG_INDEPENDENT_MULTIATTACK}}
| Caste
|
| Multiple strikes with this attack can be performed with no penalty. The creature will use all attacks with this token at once.

|-
| {{text anchor|SPECIALATTACK_INJECT_EXTRACT}}
| Caste
|
*<[[material token]]>
*<[[Material_definition_token#Material_States|material state]]>
*<min quantity>
*<max quantity>
| When added to an attack, causes the attack to inject the specified material into the victim's bloodstream. Once injected, the material will participate in [[temperature|thermal]] exchange within the creature - injecting something like molten [[iron]] (INORGANIC:IRON:LIQUID) would cause most unmodded creatures to melt (note that some of the injected material also [[contaminant|splatters]] over the bodypart used to carry out the attack, so it should be protected appropriately). If the injected material has an associated [[syndrome]] with the [[Syndrome#SYN_INJECTED|[SYN_INJECTED]]] token, it will be transmitted to the victim. If the attack is blunt, the injected material lacks the [[Material definition token#ENTERS_BLOOD|[ENTERS_BLOOD]]] token, the attacked bodypart has no [[Tissue_definition_token#VASCULAR|[VASCULAR]]] tissues, or the victim is bloodless, the material will splatter over the attacked body part instead.

|-
| {{text anchor|SPECIALATTACK_INTERACTION}}
| Caste
|
*interaction
| When this attack lands successfully, a specified interaction will take effect on the target creature. The attack must break the target creature's skin in order to work. This will take effect in worldgen as well. If the attack would break skin, the interaction will occur '''before the attack actually lands'''.

|-
| {{text anchor|SPECIALATTACK_SUCK_BLOOD}}
| Caste
|
*min
*max
| Successful attack draws out an amount of blood randomized between the min and max value. Beware that this '''will''' trigger any ingestion syndromes attached to the target creature's blood - for example, using this attack on a vampire will turn you into one too.
|}

==Tissue Layer Tokens==
Tissue layers are added to a creature's body parts by the creature tokens [[#TISSUE_LAYER|TISSUE_LAYER]], [[#TISSUE_LAYER_OVER|TISSUE_LAYER_OVER]], [[#TISSUE_LAYER_UNDER|TISSUE_LAYER_UNDER]], and the body detail plan token [[#TL_LAYERS|TL_LAYERS]].

These tissue layers are not the same thing as tissues, which are defined at creature level, but rather applications of the tissues. If the SKIN tissue of a creature is the more general and abstract notion of what skin is for that creature, then a tissue layer may be the "actual" skin on the creature's nose, head, or second toe. As most creatures have more than one body part, tissue layers are normally selected en masse.

Some tissue layer tokens are analogous to tissue definition tokens, e.g. [[#TL_CONNECTS|TL_CONNECTS]] to [[tissue_definition_token#CONNECTS|CONNECTS]].

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

|-
| {{text anchor|SELECT_TISSUE_LAYER}}
| Caste
|
*TISSUE
*BY_CATEGORY, BY_TYPE, BY_TOKEN
*Location - category, type, or token | Selects a tissue at a location
* (optional) FRONT, BACK, LEFT, RIGHT, TOP, BOTTOM, AROUND.
| Begins a selection of tissue layers.
[SELECT_TISSUE_LAYER:HEART:BY_TYPE:HEART]

|-
| {{text anchor|PLUS_TISSUE_LAYER}}
| Caste
|
*TISSUE
*BY_CATEGORY, BY_TYPE, BY_TOKEN
*Location - category, type, or token
| Adds tissue layers to those selected.

|-
| {{text anchor|SET_TL_GROUP}}
| Caste
|
*TISSUE
*BY_CATEGORY, BY_TYPE, BY_TOKEN
*Location - category, type, or token
*tissue
| Begins a selection of tissue layers. Only usable for descriptor and cosmetic purposes.

Research has implied it may be redundant with SELECT_TISSUE_LAYER, as the latter allows for cosmetics as well as "functional" tokens such as TL_MAJOR_ARTERIES. Vanilla raws still use SET_TL_GROUP though, for all cosmetic purposes. More research is needed on this subject.

|-
| {{text anchor|PLUS_TL_GROUP}}
| Caste
|
*BY_CATEGORY, BY_TYPE, BY_TOKEN
*Location - category, type, or token
*tissue
| Adds tissue layers to those selected. Like SET_TL_GROUP, it may be redundant even if used in the vanilla raws.

|-
| {{text anchor|SET_LAYER_TISSUE}}
| Caste
|
*TISSUE
| Sets a selected tissue layer to be made of a different tissue.

|-
| {{text anchor|SHEARABLE_TISSUE_LAYER}}
| Caste
|
* tissue modifier
* required value
| Tissue layer can be sheared for its component material. The specified modifier must be at least of the desired value for shearing to be possible (for example, a [[llama]]'s wool must have a LENGTH of 300 before it is shearable).

|-
| {{text anchor|TISSUE_LAYER_APPEARANCE_MODIFIER}}
| Caste
|
*QUALITY
*lowest
*lower
*low
*median
*high
*higher
*highest
| Sets the range of qualities, including LENGTH, DENSE, HIGH_POSITION, CURLY, GREASY, WRINKLY

|-
| {{text anchor|TISSUE_STYLE_UNIT}}
| Caste
|
*tissue style unit ID
*shaping
| Sets tissue layer to be the target of TISSUE_STYLE token specified for an entity, works only on entity members. Mostly used with tissues HAIR, BEARD, MOUSTACHE, SIDEBURNS.

|-
| {{text anchor|TL_COLOR_MODIFIER}}
| Caste
|
*COLOR
*freq
*COLOR
*freq etc.
| Creates a list of colors/color patterns, giving each a relative frequency. If the given color or pattern does not exist, the tissue is described as being "transparent".

|-
| {{text anchor|TLCM_GENETIC_MODEL}}
| Caste
|
| The way the color modifier is passed on to offspring. May or may not work right now.{{verify}}

|-
| {{text anchor|TLCM_IMPORTANCE}}
| Caste
|
*number
| Presumably modifies the importance of the tissue layer color modifier, for description purposes.
HOWEVER using this appears to remove all mention of colour from creature descriptions. It does not appear in any default creatures.

|-
| {{text anchor|TLCM_NOUN}}
| Caste
|
*name
*SINGULAR or PLURAL
| Names the tissue layer color modifier, and determines the noun. Also used by [[Utility:Stonesense|Stonesense]] for colouring body parts.

|-
| {{text anchor|TLCM_TIMING}}
| Caste
|
*ROOT
*start change window years
*days
*end change window years
*days
| Determines the point in the creature's life when the color change begins and ends.

|-
| {{text anchor|TL_CONNECTS}}
| Caste
|
| Gives the CONNECTS attribute to selected layers.

|-
| {{text anchor|TL_HEALING_RATE}}
| Caste
|
*value
| Changes the HEALING_RATE of the selected tissue layers.

|-
| {{text anchor|TL_MAJOR_ARTERIES}}
| Caste
|
| Gives the "major arteries" attribute to selected layers. Used to add massive bleeding properties to the throat, made from skin.

|-
| {{text anchor|TL_PAIN_RECEPTORS}}
| Caste
|
*value
| Changes the number of pain receptors for selected tissue layers.

|-
| {{text anchor|TL_RELATIVE_THICKNESS}}
| Caste
|
*value
| Changes the relative thickness for selected tissue layers.

|-
| {{text anchor|TL_VASCULAR}}
| Caste
|
*value
| Sets a new VASCULAR value (which modulates bleeding) for selected tissue layers.

|}

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

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

Graphics token

2024-09-09T02:34:01Z

DikbutDaGrate: It works now, although you still won't encounter any light gen vermin in vanilla.

{{Quality|Exceptional}}
{{av}}
{{Modding}}
:{{for/see|an explanation of how to use the various graphics types|[[Graphics]]}}

The <code>[OBJECT:GRAPHICS]</code> [[token]] defines the use of various tile-based graphics in the game. As of version 50.01, graphics tokens have been greatly expanded to accommodate the release of the Steam & Itch premium version. These tokens, and explanations on how to use them, are listed below; the list will expand as the tokens are discovered and understood.

== Creature Graphics ==
Creature graphics are found within graphics_creature_x files (such as graphics_creature_domestic or graphics_creature_layered). All graphics files must begin with the file name, followed by the <code>[OBJECT:GRAPHICS]</code> type that tells the game that the file contains graphics definitions. A more detailed explanation on how to use these can be found in [[Graphics#Creature_Graphics|creature graphics]].

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

|-
| {{text anchor|CREATURE_GRAPHICS}}
|
* [[Creature token|creature id]]
| The simplest and most common form of creature graphics for defining one sprite for each [[#Condition|basic condition]].

Further conditions are required for this to function following the [[Graphics#Basic_Graphics|creature graphics]] format. Accepts [[Graphics#Large_Graphics|large graphics tokens]].

Additionally used to start defining a [[Graphics#Layered_Graphics|layered graphics]] set.

|-
| {{text anchor|CREATURE_CASTE_GRAPHICS}}
|
* [[Creature token|creature id]]
* [[Caste|Caste ID]]
| Nearly the same as {{token|CREATURE_GRAPHICS|g}}, but allows a separate sprite to be defined for each caste.
A simple alternative to [[Graphics#Layered Graphics|Layered Graphics]].

Requires conditions defined in [[Graphics#Basic_Graphics|creature graphics]] format. Accepts [[Graphics#Large_Graphics|large graphics tokens]].

|-
| {{text anchor|STATUE_CREATURE_GRAPHICS}}
|
* [[Creature token|creature id]]
| Format for beginning a [[Graphics#Statue_Graphics|creature statue definition]]. Defines a 1x2 vertical rectangle to be displayed when a statue depicts one of these creatures.

|-
| {{text anchor|STATUE_CREATURE_CASTE_GRAPHICS}}
|
* [[Creature token|creature id]]
* [[Caste|Caste ID]]
| Format for beginning a [[Graphics#Statue_Graphics|creature statue definition]] while specifying caste. Defines a 1x2 vertical rectangle to be displayed when a statue depicts one of these creatures.

|-
| {{text anchor|TILE_GRAPHICS_RECTANGLE}}
|
* [[Creature token|creature id]]
| Graphics for a 3x2 rectangle; for creatures, this is used exclusively for representing Forgotten Beasts based on their body parts. Uses [[Graphics#Forgotten_Beast_Graphics|forgotten beast graphics]]. It's also, however, used for interface graphics, see [[graphics_interface.txt]].

|}

=== Conditions ===
Different graphics can be defined for the same creature based on some properties about it. Below is a list of all the basic "creature texture" types that can be used as additional conditions to various basic sprites.

{| {{prettytable}}
|- bgcolor="#dddddd"
! Condition
! Description
|-
| {{text anchor|DEFAULT}} || The default condition that will be displayed unless overwritten by a more specific one below.

|-
| {{text anchor|LAW_ENFORCE}} || Displayed if the unit is law enforcement.

|-
| {{text anchor|TAX_ESCORT}} || Displayed if the unit escorts a tax collector (unused).

|-
| {{text anchor|ANIMATED}} || Displayed if the creature is raised from the dead using an I_EFFECT:ANIMATE interaction.

|-
| {{text anchor|GHOST}} || Displayed if the creature is a ghost.

|-
| {{text anchor|ADVENTURER}} || Displayed if the creature is an adventurer.

|-
| {{text anchor|CORPSE}} || Displayed for corpses.

|}

=== Basic creature sprite types ===

An individual sprite can be of any of the following classes. If "accepts secondary" is "yes", it can also have an extra condition tacked on at the end.

{| {{prettytable}}
|- bgcolor="#dddddd"
! Condition
! Description
|-
| {{text_anchor|Basic Condition}} || Any of the [[Graphics token#Conditions|above conditions]] can be used on their own, as the default for that condition class.

|-
| {{text_anchor|Unit type}} || Any [[Unit type token]] can be used. You may also append a [[Graphics token#Conditions|basic condition as above]] to further specify.

|-
| {{text_anchor|Position}} || Any [[Position token]] can be used, such as MONARCH, BROKER etc. All position tokens are raw-defined; any modded positions can have their own graphics. You may also append a [[Graphics token#Conditions|basic condition as above]] to further specify.

|-
| {{text_anchor|LIST_ICON}} || The default icon for this creature in lists, such as [[Arena]] mode or overall training.

|-
| {{text_anchor|EGG}} || The sprite for a clutch of eggs.

|-
| {{text_anchor|SKELETON}} || The sprite for a rotten corpse.

|-
| {{text_anchor|SKELETON_WITH_SKULL}} || The sprite for a rotten corpse that can have a [[totem]] made from it.

|}

=== Layered Conditions ===
Layers aren't very useful on their own, so they come with a set of conditions to define how when they are displayed and how they interact.

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

|-
| {{text_anchor|LAYER_SET}} ||
* condition
| Creature Graphics
| Begins defining a layer set for a creature's graphics. Valid values of ''condition'' are DEFAULT, PORTRAIT{{version|50.13}}, BABY:DEFAULT{{version|51.01-beta20}}, CHILD:DEFAULT{{version|51.01-beta20}}, or CORPSE Valid values for basic conditions may not work.{{verify}}

|-
| {{text_anchor|LS_PALETTE}}{{version|50.13}} ||
* name
|| Layer Set
|| Begins defining a palette for the layer set. Its name can be referenced by {{token|USE_PALETTE|g}}. Unlike the palettes used to render all [[descriptor color token]]s, it can be of arbitrary length.

|-
| {{text_anchor|LS_PALETTE_FILE}}{{version|50.13}} ||
* file name
| Palette
| The file name of the 8bit RGBA (sometimes called 32bit) in the <tt>/graphics/images</tt> folder of the mod, such as <tt>images/portraits/dwarf_portrait_body_palette.png</tt>.

|-
| {{text_anchor|LS_PALETTE_DEFAULT}}{{version|50.13}} ||
* integer
| Palette
| Defines the default row of a layer set palette, conventionally 0. The exact color values on this row will be replaced on layer images with the colors in the same column, based on what row is passed as an argument to {{token|USE_PALETTE|g}}.

|-
| {{text_anchor|LG_CONDITION_BP}}{{version|50.13}} ||
* selection criteria BY_TYPE, BY_CATEGORY, BY_TOKEN
* category, type, or token
|| Layer Group
|| Allows the entire layer group (rather than an individual layer) to be switched on and off depending on the conditions of a body part. Should accept the same tokens {{token|CONDITION_BP|g}} does. {{verify}}

|-
| {{text_anchor|END_LAYER_GROUP}} || || Layer Group
| Explicitly marks the end of a layer group, which allows layers after to not belong to any layer group.

|-
| {{text_anchor|CONDITION_ITEM_WORN}} ||
* BY_CATEGORY / BY_TOKEN
* [[Body_token#CATEGORY|category]] / [[Body_token#BP|body part token]]
* Armor type (ARMOR, GLOVES, Etc.)
* Item ID(s)
|| Armor Wieldables || Defines a clothing or armor graphic by the specific part it is equipped to, the type of armor it is, and the internal id of that item.
For example, a condition representing a right handed mitten or glove would be defined as:
<code>[CONDITION_ITEM_WORN:BY_TOKEN:RH:GLOVES:ITEM_GLOVES_MITTENS]</code>
Also accepts the input <code>ANY_HELD</code> or <code>WIELD</code> (e.g. <code>WIELD:WEAPON:ANY</code>).

|-
| {{text_anchor|SHUT_OFF_IF_ITEM_PRESENT}} ||
* BY_CATEGORY / BY_TOKEN
* [[Body_token#CATEGORY|category]] / [[Body_token#BP|body part token]]
* Armor type
* Item ID(s)
|| Armor || Causes the current layer to not be rendered if the creature has one of the items worn or equipped. Also accepts the input <code>ANY_HELD</code> or <code>WIELD</code> (e.g. <code>WIELD:WEAPON:ANY</code>).

|-
| {{text_anchor|CONDITION_CASTE}} ||
* caste name(s)
|| General
|| Displays this layer if the creature is this caste. Only one caste is accepted for each condition, but multiple caste conditions can be used in one layer and the layer will be displayed if any of them match.

|-
| {{text_anchor|CONDITION_DYE}} ||
* dye color
|| Armor
|| Should represent which color the clothing is dyed. Currently nonfunctional.{{version|50.05}}

|-
| {{text_anchor|CONDITION_NOT_DYED}} || || Armor
|| Should check if the clothing is dyed. Currently nonfunctional.{{version|50.05}}

|-
| {{text_anchor|CONDITION_MATERIAL_FLAG}} ||
* material flag
|| Material || Changes graphics based on the material an equipped item is made of. Valid material flags are similar to [[Reaction#Full_token_list|reactant conditions]] including:
* WOVEN_ITEM
* ANY_X_MATERIAL
:with X being:
:* PLANT, SILK, YARN, LEATHER, WOOD, SHELL, BONE, STONE, GEM, TOOTH, HORN, PEARL
* IS_DIVINE_MATERIAL
* NOT_ARTIFACT
* IS_CRAFTED_ARTIFACT
* METAL_ITEM_MATERIAL
* GLASS_MATERIAL
* FIRE_BUILD_SAFE
* MAGMA_BUILD_SAFE
* GROWN_NOT_CRAFTED{{version|51.01-beta20}}
[http://www.bay12forums.com/smf/index.php?topic=169696.msg8442543#msg8442543 among other, less useful ones.]

|-
| {{text_anchor|CONDITION_MATERIAL_TYPE}} ||
* material token
|| Material || Changes graphics based on the material an equipped item is made of. Valid material types take the form <code>METAL:COPPER</code> where copper can be replaced with any weapons-grade metal. General [[material token]]s are '''not''' functional. {{token|CONDITION_MATERIAL_FLAG|g}} is a better option for any material condition other than metal.

|-
| {{text_anchor|CONDITION_PROFESSION_CATEGORY}} ||
* [[Unit type token#Profession Categories|profession category token(s)]]
|| General
|| Checks the profession category of the creature to act as a condition. Multiple profession category tokens can be chained together. You can also use multiple of these tokens instead of listing them all in a single one, but this is functionally identical. Valid Profession tokens which are not categories will be ignored; values that do not match any existing Profession will be treated as <code>NONE</code> and thus apply to doctors, military, etc..

|-
| {{text_anchor|CONDITION_RANDOM_PART_INDEX}} ||
* identifier
* integer index
* integer range
|| General
|| Chooses a random layer among layers with a CONDITION_RANDOM_PART_INDEX with the same identifier. Index is which option this condition is, out of Range number of options. Ex:
<code>[CONDITION_RANDOM_PART_INDEX:HEAD:3:4]</code>
is the third possible random head out of four total options. One of these random conditions each will be put into a set of four different sprites to add some random variation in the appearance of the creature's head.

|-
| {{text_anchor|CONDITION_HAUL_COUNT_MIN}} ||
* integer
|| General
|| Counts how many items the creature is hauling. Used for {{token|PACK_ANIMAL}}s in vanilla.

|-
| {{text_anchor|CONDITION_HAUL_COUNT_MAX}} ||
* integer
|| General
|| Counts how many items the creature is hauling. Used for {{token|PACK_ANIMAL}}s in vanilla.

|-
| {{text_anchor|CONDITION_CHILD}} || || General
|| Checks if the creature is a child or baby.

|-
| {{text_anchor|CONDITION_NOT_CHILD}} || || General
|| Checks if the creature is an adult.

|-
| {{text_anchor|CONDITION_GHOST}} || || General
|| Checks if the creature is a ghost.

|-
| {{text_anchor|CONDITION_SYN_CLASS}} ||
* [[Syndrome#SYN_CLASS|SYN_CLASS]]
|| Syndrome || Changes graphics based on any syndromes the creature is affected by. Vanilla values include:
* ZOMBIE
* NECROMANCER
* VAMPCURSE
* RAISED_UNDEAD
* DISTURBED_DEAD
* GHOUL

|-
| {{text_anchor|CONDITION_TISSUE_LAYER}} ||
* BY_CATEGORY
* [[Body_token#CATEGORY|body part category]] or ALL
* [[Body_detail_plan_token#BP_LAYERS|tissue layer]] or ALL
|| Tissue
|| Selects a tissue layer to use for checking other conditions. Ex:
<code>[CONDITION_TISSUE_LAYER:BY_CATEGORY:ALL:SKIN]</code>

|-
| {{text_anchor|TISSUE_MIN_LENGTH}} ||
* integer
|| Tissue
|| Checks the current {{token|CONDITION_TISSUE_LAYER|g}}'s LENGTH [[Creature_token#TISSUE_LAYER_APPEARANCE_MODIFIER|appearance modifier]]. Is true if the LENGTH is greater than the integer input.

|-
| {{text_anchor|TISSUE_MAX_LENGTH}} ||
* integer
|| Tissue
|| Checks the current {{token|CONDITION_TISSUE_LAYER|g}}'s LENGTH [[Creature_token#TISSUE_LAYER_APPEARANCE_MODIFIER|appearance modifier]]. Is true if the LENGTH is less than the integer input.

|-
| {{text_anchor|TISSUE_MAY_HAVE_COLOR}} ||
* [[Color#Color_tokens|color token(s)]]
|| Tissue
|| Checks the selected tissue's color. Accepts multiple color tokens, and is true if the any of the colors is present in the selected tissues.

|-
| {{text_anchor|TISSUE_MAY_HAVE_SHAPING}} ||
* styling token
|| Tissue
|| Checks the current {{token|CONDITION_TISSUE_LAYER|g}}'s shaping (hairstyle). Valid tokens are NEATLY_COMBED, BRAIDED, DOUBLE_BRAIDS, PONY_TAILS, CLEAN_SHAVEN and STANDARD_HAIR/BEARD/MOUSTACHE/SIDEBURNS_SHAPINGS.{{verify}}

|-
| {{text_anchor|TISSUE_NOT_SHAPED}} || || Tissue
|| Checks the current {{token|CONDITION_TISSUE_LAYER|g}}'s color. Accepts multiple color tokens, and is true if the any of the colors is present in the selected tissues.

|-
| {{text_anchor|TISSUE_SWAP}} ||
* IF_MIN_CURLY
* integer
* tile page id
* x position
* y position
| Tissue
| Checks if a tissue is sufficiently curly, and if so swaps to display a different image. The new image is defined by the tile page ID, x position, and y position.

This condition should be within a [LAYER:... ] that has a similar graphic to the on in the TISSUE_SWAP.
The current {{token|CONDITION_TISSUE_LAYER|g}} group must also include a {{token|TISSUE_MIN_LENGTH|g}}.

|-
| {{text_anchor|ITEM_QUALITY}}{{version|50.13}} ||
* integer
| Armor Wieldables
|| Checks the current {{token|CONDITION_ITEM_WORN|g}}'s [[quality]]. 0 is base quality, 5 is masterwork. See [CONDITION_MATERIAL_FLAG:IS_CRAFTED_ARTIFACT] for [[artifact]]-quality items.

|-
| {{text_anchor|USE_PALETTE}}{{version|50.13}} ||
* layer set palette
* row
| General
|| Colors the layer using that row of either the layer-set-specific {{token|LS_PALETTE|}} or a predefined [[Graphics#Palettes|palette]] such as DEFAULT.

|-
| {{text_anchor|USE_STANDARD_PALETTE_FROM_ITEM}}{{version|50.13}} || || Armor Wieldables
|| Uses the default palette to render the layer based on the [[Material definition token#STATE_COLOR|color]] of the current {{token|CONDITION_ITEM_WORN|g}}.

|-
| {{text_anchor|CONDITION_BP}}{{version|50.13}} ||
* selection criteria BY_TYPE, BY_CATEGORY, BY_TOKEN
* category, type, or token
| Body
|| Defines a body part graphic using standard [[body token]] selection criteria.

|-
| {{text_anchor|BP_APPEARANCE_MODIFIER_RANGE}}{{version|50.13}} ||
* QUALITY
* minimum
* maximum
| Body
|| Checks if current {{token|CONDITION_BP|g}}'s {{token|BP_APPEARANCE_MODIFIER|c}} falls within the chosen range.

|-
| {{text_anchor|BP_PRESENT}}{{version|50.13}} || || Body
|| Checks if the current {{token|CONDITION_BP|g}} is present and not destroyed, pulped, or severed. Can also be applied to {{token|LG_CONDITION_BP|g}}.

|-
| {{text_anchor|BP_SCARRED}}{{version|50.13}} || || Body
|| Checks if the current {{token|CONDITION_BP|g}} is scarred. Seems to also require {{token|BP_PRESENT|g}} to avoid illogical results. {{verify}}

|}

=== Vermin Conditions ===
Special Conditions for {{token|VERMIN|c}} creature graphics:

{| {{prettytable}}
|- bgcolor="#dddddd"
! Condition
! Description
|-
| {{text anchor|VERMIN}} || The default graphic for this vermin.

|-
| {{text anchor|VERMIN_ALT}} || Image cycles every 1 second.

|-
| {{text anchor|SWARM_SMALL}} || For swarming vermin like [[fly|flies]] and [[fairy|fairies]] in small groups.

|-
| {{text anchor|SWARM_MEDIUM}} || For swarming vermin like [[fly|flies]] and [[fairy|fairies]] in medium-sized groups.

|-
| {{text anchor|SWARM_LARGE}} || For swarming vermin like [[fly|flies]] and [[fairy|fairies]] in large groups.

|-
| {{text anchor|LIGHT_VERMIN}} || For [[firefly|fireflies]] etc. Does not replace {{token|VERMIN|g}}.

|-
| {{text anchor|LIGHT_VERMIN_ALT}} || Like {{token|VERMIN_ALT|g}} for [[firefly|fireflies]] etc. However, [LIGHT_GEN] is bugged and does not work at the present time.

|-
| {{text anchor|LIGHT_SWARM_SMALL}} || Unused. Would work for small sized swarms of light producing vermin, if [LIGHT_GEN] was working.

|-
| {{text anchor|LIGHT_SWARM_MEDIUM}} || Unused. Would work for medium sized swarms of light producing vermin, if [LIGHT_GEN] was working.

|-
| {{text anchor|LIGHT_SWARM_LARGE}} || Unused. Would work for large sized swarms of light producing vermin, if [LIGHT_GEN] was working.

|-
| {{text anchor|REMAINS}} || Vermin corpses.

|-
| {{text anchor|HIVE}} || Vermin hives.
|}

== Item Graphics ==
Item graphics can also be defined, but are mostly hardcoded. This section of the wiki needs to be fleshed out. Descriptions of the token functions is provisional.

Item graphics currently do not support LARGE_IMAGE.

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

|-
| {{text_anchor|TILE_GRAPHICS}}
|
* Tile page ID
* x index
* y index
* Item ID
| Begins defining tile graphics for an item. Sets default tile graphic.{{verify}}

|-
| {{text_anchor|BOULDER_GRAPHICS}}
|
* Tile page ID
* x index
* y index
* Material ID
| Defines tile graphics variants to use for BOULDER items by material; currently all boulders use material palette instead.

|-
| {{text_anchor|ROUGH_GEM_GRAPHICS}}
|
* Tile page ID
* x index
* y index
* Material ID
| Defines tile graphics variants to use for ROUGH (gem) items by material; currently all rough gems use material palette instead.

|-
| {{text_anchor|BARS_GRAPHICS}}
|
* Tile page ID
* x index
* y index
* Material ID or item ID
| Defines tile graphics variants to use for BAR items by material.

|-
| {{text_anchor|FOOD_GRAPHICS}}
|
* Tile page ID
* x index
* y index
* Item ID
| Defines tile graphics for FOOD items.

|-
| {{text_anchor|CHEESE_GRAPHICS}}
|
* Tile page ID
* x index
* y index
* Material ID
| Defines tile graphics variants to use for CHEESE items by material. Unused in vanilla raws.

|-
| {{text_anchor|ARMOR_GRAPHICS}}
|
* Tile page ID
* x index
* y index
* Item ID
| Defines tile graphics for ARMOR items; this is for items not being worn by a creature.

|-
| {{text_anchor|GLOVES_GRAPHICS}}
|
* Tile page ID
* x index
* y index
* Item ID
| Defines tile graphics for GLOVES items; this is for items not being worn by a creature.

|-
| {{text_anchor|HELM_GRAPHICS}}
|
* Tile page ID
* x index
* y index
* Item ID
| Defines tile graphics for HELM items; this is for items not being worn by a creature.

|-
| {{text_anchor|PANTS_GRAPHICS}}
|
* Tile page ID
* x index
* y index
* Item ID
| Defines tile graphics for PANTS items; this is for items not being worn by a creature.

|-
| {{text_anchor|SHOES_GRAPHICS}}
|
* Tile page ID
* x index
* y index
* Item ID
| Defines tile graphics for SHOES items; this is for items not being worn by a creature.

|-
| {{text_anchor|SHOES_GRAPHICS_METAL}}
|
* Tile page ID
* x index
* y index
* Item ID
| Defines metal material tile graphics variants for SHOES items; this is for items not being worn by a creature.

|-
| {{text_anchor|SHIELD_GRAPHICS}}
|
* Tile page ID
* x index
* y index
* Item ID
| Defines tile graphics for SHIELD items; this is for items not being worn by a creature.

|-
| {{text_anchor|SHIELD_GRAPHICS_WOODEN}}
|
* Tile page ID
* x index
* y index
* Item ID
| Defines wood material tile graphics variants for SHIELD items; this is for items not being worn by a creature.

|-
| {{text_anchor|TOY_GRAPHICS}}
|
* Tile page ID
* x index
* y index
* Item ID
* Material ID
| Defines tile graphics for TOY items. Material ID in this case is one of STONE, WOOD, METAL, or GLASS.

|-
| {{text_anchor|TRAPCOMP_GRAPHICS}}
|
* Tile page ID
* x index
* y index
* Item ID
| Defines tile graphics for TRAPCOMP items.

|-
| {{text_anchor|TRAPCOMP_GRAPHICS_WEAPON_TRAP}}
|
* Tile page ID
* x index
* y index
| Defines tile graphics for TRAPCOMP items when built into a weapon trap; must follow TRAPCOMP_GRAPHICS.

|-
| {{text_anchor|TRAPCOMP_GRAPHICS_UPRIGHT_#X}}
|
* Tile page ID
* x index
* y index
| Defines tile graphics for installed upright spike traps. These comprise two-tile graphics: # is replaced with the number of spikes, 1-10; X is replaced with T (for top graphic tile) or B (bottom graphic tile). This follows the tile graphics definition of either MENACINGSPIKE or SPEAR.

|-
| {{text_anchor|SIEGEAMMO_GRAPHICS}}
|
* Item ID
| Begins defining graphics for SIEGEAMMO items.

|-
| {{text_anchor|SIEGEAMMO_GRAPHICS_STRAIGHT_DEFAULT}}
|
* Tile page ID
* x index
* y index
| Defines graphics for ballista arrows aligned orthogonally on the map; follows SEIGEAMMO_GRAPHICS.

|-
| {{text_anchor|SIEGEAMMO_GRAPHICS_STRAIGHT_WOOD}}
|
* Tile page ID
* x index
* y index
| Wooden variant of above.

|-
| {{text_anchor|SIEGEAMMO_GRAPHICS_DIAGONAL_DEFAULT}}
|
* Tile page ID
* x index
* y index
| Defines graphics for ballista arrows aligned diagonally on the map; follows SEIGEAMMO_GRAPHICS.

|-
| {{text_anchor|SIEGEAMMO_GRAPHICS_DIAGONAL_WOOD}}
|
* Tile page ID
* x index
* y index
| Wood variant of above.

|-
| {{text_anchor|AMMO_GRAPHICS}}
|
* Item ID
| Begins defining graphics for AMMO items.

|-
| {{text_anchor|AMMO_GRAPHICS_STRAIGHT_DEFAULT}}
|
* Tile page ID
* x index
* y index
| Defines graphics for AMMO items aligned orthogonally on the map; follows AMMO_GRAPHICS.

|-
| {{text_anchor|AMMO_GRAPHICS_STRAIGHT_WOOD}}
|
* Tile page ID
* x index
* y index
| Wooden variant of above.

|-
| {{text_anchor|AMMO_GRAPHICS_DIAGONAL_DEFAULT}}
|
* Tile page ID
* x index
* y index
| Defines graphics for AMMO aligned diagonally on the map; follows AMMO_GRAPHICS.

|-
| {{text_anchor|AMMO_GRAPHICS_DIAGONAL_WOOD}}
|
* Tile page ID
* x index
* y index
| Wood variant of above.

|-
| {{text_anchor|WEAPON_GRAPHICS}}
|
* Item ID
| Begins defining graphics for WEAPON items.

|-
| {{text_anchor|WEAPON_GRAPHICS_DEFAULT}}
|
* Tile page ID
* x index
* y index
| Defines default graphics for WEAPON item defined by WEAPON_GRAPHICS not being worn by creatures; follows WEAPON_GRAPHICS.

|-
| {{text_anchor|WEAPON_GRAPHICS_MATERIAL}}
|
* Tile page ID
* x index
* y index
| Defines material palette{{verify}} graphics for WEAPON item defined by WEAPON_GRAPHICS not being worn by creatures; follows WEAPON_GRAPHICS.

|-
| {{text_anchor|WEAPON_GRAPHICS_WOOD_GROWN}}
|
* Tile page ID
* x index
* y index
| Defines graphics for grown-wood WEAPON item defined by WEAPON_GRAPHICS not being worn by creatures; follows WEAPON_GRAPHICS.

|-
| {{text_anchor|WEAPON_GRAPHICS_WOOD}}
|
* Tile page ID
* x index
* y index
| Defines graphics for wooden WEAPON item defined by WEAPON_GRAPHICS not being worn by creatures; follows WEAPON_GRAPHICS.

|-
| {{text_anchor|WEAPON_GRAPHICS_WEAPON_TRAP}}
|
* Tile page ID
* x index
* y index
| Defines graphics for WEAPON item defined by WEAPON_GRAPHICS as it appears installed in a weapon trap; follows WEAPON_GRAPHICS.

|-
| {{text_anchor|TOOL_GRAPHICS}}
|
* Tile page ID
* x index
* y index
* Item ID
| Defines default graphics for TOOL items; also begins defining variant graphics for material or container conditions when followed by tokens below.

|-
| {{text_anchor|ADD_TOOL_GRAPHICS}}
|
* Item ID
| Adds graphics to an existing tool defined with TOOL_GRAPHICS, followed by the tool graphics material or container condition tokens below.

|-
| {{text_anchor|TOOL_GRAPHICS_WOOD}}
|
* Variant index
* Tile page ID
* x index
* y index
| Defines additonal variant graphics for wooden TOOL items defined by TOOL_GRAPHICS; follows TOOL_GRAPHICS or ADD_TOOL_GRAPHICS. Requires seven variants; the resulting tool graphic is selected randomly from these (they can all point to the same tile index if desired).

|-
| {{text_anchor|TOOL_GRAPHICS_STONE}}
|
* Variant index
* Tile page ID
* x index
* y index
| Defines additonal variant graphics for stone TOOL items defined by TOOL_GRAPHICS; follows TOOL_GRAPHICS or ADD_TOOL_GRAPHICS. Requires seven variants; the resulting tool graphic is selected randomly from these (they can all point to the same tile index if desired).

|-
| {{text_anchor|TOOL_GRAPHICS_METAL}}
|
* Variant index
* Tile page ID
* x index
* y index
| Defines additonal variant graphics for metal TOOL items defined by TOOL_GRAPHICS; follows TOOL_GRAPHICS or ADD_TOOL_GRAPHICS. Requires seven variants; the resulting tool graphic is selected randomly from these (they can all point to the same tile index if desired).

|-
| {{text_anchor|TOOL_GRAPHICS_GLASS}}
|
* Variant index
* Tile page ID
* x index
* y index
| Defines additonal variant graphics for glass TOOL items defined by TOOL_GRAPHICS; follows TOOL_GRAPHICS or ADD_TOOL_GRAPHICS. Requires seven variants; the resulting tool graphic is selected randomly from these (they can all point to the same tile index if desired).

|-
| {{text_anchor|TOOL_GRAPHICS_CONTAINER_WOOD_LIQUID}}
|
* Tile page ID
* x index
* y index
| Defines graphics for wooden liquid-containing containers (empty); follows ADD_TOOL_GRAPHICS definition for container.

|-
| {{text_anchor|TOOL_GRAPHICS_CONTAINER_STONE_LIQUID}}
|
* Tile page ID
* x index
* y index
| Defines graphics for stone liquid-containing containers (empty); follows ADD_TOOL_GRAPHICS definition for container.

|-
| {{text_anchor|TOOL_GRAPHICS_CONTAINER_METAL_LIQUID}}
|
* Tile page ID
* x index
* y index
| Defines graphics for metal (and glass?) liquid-containing containers (empty); follows ADD_TOOL_GRAPHICS definition for container.

|-
| {{text_anchor|TOOL_GRAPHICS_CONTAINER_LIQUID}}
|
* Tile page ID
* x index
* y index
| Defines graphics for the liquid filling a liquid-containing container; follows TOOL_GRAPHICS_CONTAINER_*_LIQUID.

|-
| {{text_anchor|TOOL_GRAPHICS_CONTAINER_WOOD_ITEM}}
|
* Tile page ID
* x index
* y index
| Defines graphics for wooden containers holding items; follows ADD_TOOL_GRAPHICS definition for container.

|-
| {{text_anchor|TOOL_GRAPHICS_CONTAINER_STONE_ITEM}}
|
* Tile page ID
* x index
* y index
| Defines graphics for stone containers holding items; follows ADD_TOOL_GRAPHICS definition for container.

|-
| {{text_anchor|TOOL_GRAPHICS_CONTAINER_METAL_ITEM}}
|
* Tile page ID
* x index
* y index
| Defines graphics for metal (and glass?) containers holding items; follows ADD_TOOL_GRAPHICS definition for container.
|-
| {{text_anchor|TOOL_GRAPHICS_HIVE_BLD}}
|
* Tile page ID
* x index
* y index
| Defines the built item graphics for HIVE items.

|-
| {{text_anchor|TOOL_GRAPHICS_HIVE_BLD_IN_USE}}
|
* Tile page ID
* x index
* y index
| Defines the built item graphics for HIVE items that have hives installed.

|-
| {{text_anchor|TOOL_GRAPHICS_HIVE_PRODUCTS}}
|
* Tile page ID
* x index
* y index
| Defines the built item graphics for HIVE items that are ready to be harvested.

|-
| {{text_anchor|TOOL_GRAPHICS_SHAPE}}
|
* Shape ID
* Tile page ID
* x index
* y index
| Defines graphics for shaped items; currently used for dice.

|}

== World Map Graphics ==
World map graphics are defined in <code>[[Game_folders_and_files#Game_folder|Dwarf Fortress]]\data\vanilla\vanilla_world_map\graphics\graphics_world_map.txt</code>
Tokens that accept variants have 5 of them:

[TILE_GRAPHICS:<tile page identifier>:<x position>:<y position>:<TOKEN>:1]
[TILE_GRAPHICS:<tile page identifier>:<x position>:<y position>:<TOKEN>:2]
[TILE_GRAPHICS:<tile page identifier>:<x position>:<y position>:<TOKEN>:3]
[TILE_GRAPHICS:<tile page identifier>:<x position>:<y position>:<TOKEN>:4]
[TILE_GRAPHICS:<tile page identifier>:<x position>:<y position>:<TOKEN>:5]

Otherwise:

[TILE_GRAPHICS:<tile page identifier>:<x position>:<y position>:<TOKEN>]

==See Also==
*[[Creature token]]
*[[Syndrome]]
*[[Creature examples]]

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

Strange mood

2024-08-31T22:45:23Z

DikbutDaGrate: /* Fell */ Confirmed this awhile ago during a future of the fortress, but hadn't found a good way adding that bit of obscure information till today.

{{Quality|Exceptional}}
{{av}}
{{buggy|bugsection=Bugs}}
{{minorspoiler}}
[[File:strange_mood_prev.png|thumb|350px|right|A dwarf losing ownership of his mind. ''Artwork by Zippy'']]
Periodically, individual [[Dwarf|dwarves]] are struck with an idea for a [[legendary artifact]] and enter a '''strange mood'''. Dwarves which enter a strange mood will stop whatever they are doing, and pursue the construction of this artifact to the exclusion of all else – they will not stop to eat, drink, or sleep; pretty much the ''only'' thing that can pause a "moody" dwarf is giving birth, after which they will immediately get back to making the artifact. If they do not manage to begin construction of the artifact within a handful of months, they will go [[#Failure|insane]] and die (one way or another) soon afterward.

Note: Any creature with the {{token|STRANGE_MOODS}} token is able to enter strange moods in [[Legends|history]] and [[fortress mode]], though, by default, this ability is unique to dwarves.

==Overview==
[[File:mood_announce_v50_x2.png|right]]Once your fortress has at least 20 dwarves, occasionally, one of them will be struck by a "strange mood". These largely random events will be seen as an [[announcement]], and will pause the game.

A dwarf struck by a strange mood will seek an appropriate workshop, immediately claim it for the duration of the mood, attempt to collect the materials to create their [[artifact]] of choice, and, once those have been collected, proceed to do so. Depending on the exact mood (see [[Strange mood#Types of moods|types of moods]], below), both the workshop and the artifact are based on the highest "moodable skill" of that dwarf (see "[[Strange mood#Skills and Workshops|Skills and Workshops]]", below).

At the end of this process, if successful, the dwarf will '''usually''' gain enough [[experience]] to become Legendary (or higher), and then return to life as normal, but now with a Legendary skill. The "possessed" mood is an exception to this rule, as it does not grant any experience upon completion.

A dwarf cannot be struck by more than one mood in their lifetime.

=== In fortress mode ===
[[File:workshop_claimed_sample.png|thumb|300px|right|Information from a forcefully claimed workshop.]]
# The game will announce that the dwarf has entered one of five different types of strange moods. The [[#Types of moods|types of moods]] are listed below. While in a mood, a dwarf will display a blinking exclamation point (see [[Status icon|status icons]]).
# For the duration of the mood, the dwarf will claim a workshop related to the skill that the mood affects (not all skills are eligible), kick out any dwarf who was using it, and render it otherwise unusable until the mood has ended. If a moody dwarf does not claim a workshop, it is because the appropriate workshop does not exist. (See [[#Skills and workshops|skills and workshops]] below to determine which workshop(s) might be required.) A moody dwarf will ''not'' be able to build a needed workshop; another dwarf with the appropriate [[labor]] designation must do so for them, if one is necessary. Furnaces are also counted as a workshop.
# After claiming a workshop, the dwarf will set about collecting the required materials for their artifact. If the dwarf remains idle inside the workshop, it's because they cannot find the right material. Reference the [[#Demands|demands]] section to determine what may be required. Important Note: They will only collect these materials in the order that they require them. In other words, you have to determine where they are on the list of required materials and then provide the next one before they will continue collecting other materials.
# Once all materials have been gathered, the game will once again pause and center, and the moody dwarf will begin construction. Upon completion, the dwarf will create a semi-random artifact related to the skill affected and gain [[legendary]] (or higher) status in that skill (unless the mood type is [[#Possessed|possessed]]). See the [[#Skills and workshops|skills and workshops]] for information on which skills can be gained, or the [[#Artifacts created|artifacts created]] section for more details on the artifacts themselves.
# While you have some control over the skill the dwarf uses, and so some (but less) control over the type of artifact created, and (with some effort) the materials used, you have no control over which dwarf is struck by a mood, nor the type of mood that strikes them, nor the specific type of artifact created.
# The conditions necessary for a strange mood to occur have been fully understood due to a disassembly of the game; see below for the exact mechanics.

===In world generation===
Long before your seven dwarves [[embark]] on their adventure, non-player dwarves may also be struck by strange moods during world generation, albeit these are treated more abstractly. These events are a primary source of non-player artifacts that are scattered across the outside world when the game starts (see [[Mission]]). They have the same properties and quality as any artifact your fortress could have produced, and may be stolen or pillaged just like any other non-player artifact.

== Skills and workshops ==
If struck by a Fey, Secretive or Possessed mood, the workshop and artifact will be based on the highest "moodable skill" that a dwarf possesses. Not all skills are moodable. Fell and Macabre moods will either claim a butcher's shop and use Bonecarving, or a tanner's shop and use Tanning (see [[Strange mood#Types of moods|Types of moods]], below).

{| class="wikitable sortable" cellpadding="4" style="border:1px solid black;border-collapse:collapse;text-align:left;float:right;margin:0 0 20px 30px;vertical-align:top;"
|-
! Highest skill
! Workshop required
|- style="background-color:palegreen"
| [[Armorsmith]]
| [[Metalsmith's forge]] (or [[Magma forge]])
|- style="background-color:palegreen"
| [[Bone carver]]
| [[Craftsdwarf's workshop]]
|- style="background-color:palegreen"
| [[Bowyer]]
| [[Bowyer's workshop]]
|- style="background-color:wheat"
| [[Carpenter]]
| [[Carpenter's workshop]]
|- style="background-color:palegreen"
| [[Clothier]]
| [[Clothier's shop]]
|- style="background-color:lightgray"
| [[Engraver]]
| [[Craftsdwarf's workshop]]
|- style="background-color:wheat"
| [[Gem cutter]]
| [[Jeweler's workshop]]
|- style="background-color:wheat"
| [[Gem setter]]
| [[Jeweler's workshop]]
|- style="background-color:wheat"
| [[Glassmaker]]
| [[Glass furnace]] (or [[Magma glass furnace]])
|- style="background-color:palegreen"
| [[Leatherworker]]
| [[Leather works]]
|- style="background-color:wheat"
| [[Mason]]
| [[Stoneworker's workshop]]
|- style="background-color:palegreen"
| [[Mechanic]]
| [[Mechanic's workshop]]
|- style="background-color:wheat"
| [[Metal crafter]]
| [[Metalsmith's forge]] (or [[Magma forge]])
|- style="background-color:wheat"
| [[Blacksmith|Metalsmith]]
| [[Metalsmith's forge]] (or [[Magma forge]])
|- style="background-color:wheat"
| [[Miner]]
| [[Stoneworker's workshop]]
|- style="background-color:wheat"
| [[Stone carver]]
| [[Stoneworker's workshop]]
|- style="background-color:lightgray"
| [[Stone crafter]]
| [[Craftsdwarf's workshop]]
|- style="background-color:wheat"
| [[Stonecutter]]
| [[Stoneworker's workshop]]
|- style="background-color:wheat"
| [[Tanner]]
| [[Leather works]]
|- style="background-color:palegreen"
| [[Weaponsmith]]
| [[Metalsmith's forge]] (or [[Magma forge]])
|- style="background-color:wheat"
| [[Weaver]]
| [[Clothier's shop]]
|- style="background-color:lightgray"
| [[Wood crafter]]
| [[Craftsdwarf's workshop]]
|- style="background-color:lightgray"
| <none>
| [[Craftsdwarf's workshop]]
|}

A dwarf will claim a workshop according to their highest applicable [[skill]]. If not [[Strange mood#Possessed|possessed]], completion of the artifact grants roughly 10,000 [[experience]] in that skill. This will transform a previously unskilled dwarf to one of Accomplished-level (on average). The table to the right describes all applicable skills and their potential workshop requirements – there are only 20 skills that determine the workshop and that can be affected by a mood (sometimes referred to as '''moodable''' skills.) If a dwarf does not possess at least one of the moodable skills listed to the right, they will take over a [[craftsdwarf's workshop]] and gain one of [[bone carver]], [[stone crafter]], or [[wood crafter]] skills, producing an artifact [[craft]].

When selecting the desired mood skill, only the level itself is checked, and if the highest level found is shared by multiple skills, then one will be selected randomly.

This fact can be utilized to maximize the possibility of getting a dwarf with the specific legendary skill you want: since ''non''-moodable skills are ignored, whenever possible make sure that each dwarf's highest ''moodable'' skill is one of those you want. Have all your peasants, [[farmer]]s, non-professional military and other dwarves without any moodable skills do one job each in the skill(s) you most want; if a "[[experience|dabbling]]" skill is the highest moodable skill they have, that is the skill that will be used. [[Guildhall]]s related to moodable skills may both help and hinder, as demonstrations will increase skill levels without any jobs being done.

[[Scholar]]s may discuss mechanics as part of their work and gain a small amount of experience in it. This is the only skill that scholars discuss that is moodable.

=== "Best" skills ===
Some skills produce generally useful and valuable items, and others produce only trinkets or jewelry. While "best" is very subjective, balancing the artifact itself with the Legendary skill the mood (usually!) produces, and both of those against the needs and goals of the current fortress, generally speaking the skills can be broken down into tiers of usefulness.

Note that in addition to an artifact, the mood will (usually) raise the dwarf to Legendary in the chosen skill; often this is, from a practical standpoint, more valuable than an artifact, so you might consider trying to push poorly-trained dwarves towards moodable skills you have a need for, instead, in case they are struck by a mood.

* [[Weaponsmith]] is one of the "best" skills. While the moody dwarf might create a questionable lead spear or lightweight aluminum mace, the odds are they'll create something that is still more deadly than its ☼steel☼ equivalent. And with a little manipulation, you can at least make sure the item ''is'' steel, although they could still give you a non-dwarf weapon. [[Mechanic]] is a close second for reliability and usefulness –- any mechanism's [[quality]] modifies the chance for a trap to hit its target, and an artifact lever or trap in a room will make its value skyrocket (even if not connected to anything!). Note that, despite popular belief, traps made with artifact mechanisms can still jam ([https://www.reddit.com/r/dwarffortress/comments/wj2ego/i_thought_traps_made_with_artifact_mechanisms/ source]).
* [[Armorsmith]] is similarly valuable, having a decent chance to create something with exceptional value for your military (or at least one member of it), but, similar to weapons, this requires manipulating available material to avoid getting [[Armor#Material|soft]], useless gold or lead [[armor]] pieces. And, while moody [[Bowyer]]s can create artifact wood/bone [[crossbow]]s of great accuracy, they can also give you [[blowgun]]s. Good luck with either one.
* Artifact [[furniture]] is unbreakable by building destroyers and creates otherwise-impossible fortress defense options. A dwarf with a preference for doors, hatches, or floodgates will always produce that item, which can then be locked against many enemies that would otherwise break through. It can also have huge monetary worth for improving room value, and placing an artifact item where all can pass by and admire it will be good for general morale. These skills include [[Mason]]s, [[Miner]]s (who are treated the same as masons), [[Carpenter]]s, and [[Blacksmith|Metalsmith]]s. Many of these can also produce items from the lower-utility lists, below. But maybe you'll get an artifact [[mug]] for your tavern. Good luck with that, too.
* These next are (very?) odds-against; chances are good that they'll produce something on one of the ''next'' lists, or at best some nice furniture, but there's a (very) small chance it'll be something truly useful as well as valuable. [[Clothier]]s can make an artifact [[rope]], and [[metal crafter]]s can create [[chain]]s, either of which can be used for your main [[well]]. Similarly with a [[carpenter]] or [[blacksmith]] and [[bucket]]s. [[Glassmaker]]s can create an artifact trap component. [[Leatherworker]]s and [[tanner]]s can create [[shield]]s, and both they and [[bone carver]]s can create artifact Leather/Bone Armor pieces, which are great if you have Hunters, etc. Which are all better than the next two...
* Next to last are skills that produce an artifact that could only be worn by one dwarf, and perhaps admired by others they come in contact with. [[Clothier]]s and [[weaver]]s fall just below some of the above: for no ability to produce anything except wearable, non-military items. [[Gem cutter]]s and [[Gem setter]]s can fall on this list too, as creating something of pure monetary value and no practical use in your dwarven society. One exception to the general uselessness of clothing artifacts is [[Adamantine]] clothing, especially cloaks; its material allows it to accord the wearer meaningful protection, and unlike normal Adamantine clothing, its status as an artifact renders it immune to wear (which otherwise renders such clothing impractical.)
* Last on the list are "crafts" – surprisingly valuable trinkets in the form of amulets, totems, rings, figurines – or, at best, crowns, which at least ''sound'' impressive. These skills are [[engraver]], [[stone crafter]], and [[wood crafter]] (and a distinct chance from several of the skills mentioned earlier: [[bone carver]], [[gem cutter]], [[gem setter]], [[glassmaker]], and [[metalcrafter]].)
:* Peasants, defined here as having no moodable skill, always produce from the crafts list: It's always a good idea to have every newly arrived "peasant" migrant craft just one item from the moodable skill of your choice, to avoid such a tragic waste of dwarfcraft.

== Types of moods ==
For each of the following types of moods, the first message is how the mood is [[Announcement|announced]]; the second message appears in the dwarf's profile when he or she is viewed with the {{K|v}} key. All moody dwarves will have "Strange Mood" listed as their active task and are "quite content", regardless of any recent [[thought]]s they may have had.

=== Fey ===
* {{Gametext|<dwarf> is taken by a fey mood!|7:1}}
: ''Has the aspect of one fey!''

This is the most basic strange mood. Fey dwarves will clearly state their demands when the workshop they are in is examined.

=== Secretive ===
* {{Gametext|<dwarf> withdraws from society...|7:0}}
: ''Peculiarly secretive...''

Secretive moods are the same as fey moods, except a secretive dwarf will sketch pictures of their required materials instead of clearly stating their demands if they cannot find what they need. Descriptions of all these [[#Demands|secretive requirements]] can be seen only by viewing the workshop that the moody dwarf has claimed, with {{k|q}}, and then only while the dwarf is waiting inside it. More than one "picture" is likely; these will cycle through the entire list automatically if any one is not available. (Since materials are gathered ''in order'', it's quite possible that only one of a long list is needed to allow the moody dwarf to continue on their project. If the dwarf has gathered some of the materials (seen as "tasked" when looking at the workshop with {{k|t}}), then the next in the list is what they are looking for.)

=== Possessed ===
* {{Gametext|<dwarf> has been possessed!|5:1}}
: ''Possessed by unknown forces!''

Possessed dwarves have cryptic material requests, and have the unfortunate distinction of not receiving any experience upon the successful construction of an artifact. No controllable circumstances lead to a possessed mood instead of one of the more desirable fey or secretive moods, it is purely luck-based. Possessed dwarves will mutter the name of the artifact they are working on (which, under some circumstances, might end up being ''their own name'') once they have all the materials they need.

Possession is the only mood that does '''''not''''' result in a jump in [[experience]].

A possessed dwarf that "keeps muttering <name of the artifact>..." has already gathered everything they need.

=== Fell ===
* {{Gametext|<dwarf> looses a roaring laughter, fell and terrible!|5:0}}
: ''Has a horrible fell look!''

A dwarf that goes into a fell mood will try to take over a [[butcher's shop]] or a [[tanner's shop]]. If neither are available, any other workshop will be used instead. The dwarf will then ''murder'' the nearest dwarf, drag the corpse into the shop and make some sort of object out of dwarf [[leather]] or [[bone]]. The unfortunate dwarf is killed on the spot – no dragging to the workshop, just sneaking up behind them, killing them, and dragging their corpse to the workshop. Once the artifact is completed, the fell dwarf will become a legendary [[bone carver]] or [[leatherworker]]. Only unhappy dwarves may enter a fell mood.

Amusingly, it seems fell dwarves can also murder [[ghost]]s. If they do, they will murder a living dwarf as well, since ghosts obviously don't yield a corpse to butcher.{{bug|4681}}

Aside from the loss of a potentially important dwarf in the wrong place at the wrong time, there doesn't seem to be any downside to a fell mood. The end result is always an artifact and a legendary craftsdwarf. Since the only ingredient used (a dwarf) is available in abundance, a fell mood will only fail if the fell dwarf is completely isolated from other dwarves, or if the proper workshop does not exist.

If no one is around to witness the murder, whichever dwarf Urist McEmo decides to slaughter will be reported as missing some time after their death. If the murder is witnessed (or if the <s>idiot</s> dwarf in fell mood reports themself), the moody dwarf will be subject to dwarven [[justice]].

A fell mood "reagent" is not merely limited to dwarves, however. In truth, any intelligent creature can be subjected to the creative imagination of the terrible laughing dwarves. Legends speak of [[werebeast]] attacks being halted by timely appearances of fell dwarves. Indeed, there are even whispers of fell mood dwarves smuggling [[clowns]] from the [[circus]] into their forts to be used in their strange artifice. In cases where an unusual intelligent creature made from a material such as [[vomit]] happens to fall prey to the depredations of a fell dwarf, the resultant crafted object will be selected randomly from the list of craftable [[shell]] items, but will be made from the victim's primary material instead of shell.

=== Macabre ===
* {{Gametext|<dwarf> begins to stalk and brood...|0:1}}
: ''Brooding darkly...''

Macabre moods are similar to fell moods, but the dwarf will not murder a fellow dwarf. A macabre dwarf may require [[bone]]s, [[skull]]s, or vermin [[remains]]; if you do not happen to have any, you will have to make some, e.g. by butchering an animal and/or allowing a [[cat]] to go hunting, or let the moody dwarf go [[insane]]. Like fell moods, only unhappy dwarves can enter macabre moods.

==Caveats==
* Shells are perhaps the most difficult-to-obtain material for a strange mood, though there are several {{catlink|Shell|creatures}} that produce shells. Some of these, such as [[armadillo]]s and [[common snapping turtle]]s, are butcherable. Vermin from [[fishing]] are the easiest and most renewable source of shells. [[Pond turtle]]s are common in many embarks in [[murky pool]]s, but usually only appear in small numbers, and can go extinct easily. A stream or river almost guarantees a functionally inexhaustible supply of [[mussel]]s. [[Nautilus]]es can also serve as sources of shells when cleaned at a fishery. Nevertheless, shells are rare and hard to acquire. Currently, the only way of trading for shells is to hope that the [[elven]] caravan brings some tamed shell-producing large creature. Traded [[cave lobster]]s and [[turtle]]s are ''processed'' fish (with the shells already removed). Tamed vermin with shells cannot be butchered for their shells, since the only way to get a vermin's shell is to [[Fish cleaning|clean]] it. Since all shelled non-vermin animals are [[exotic pet|exotic]], only elves will bring them. If you should be fortunate enough to acquire some breeding, shelled, butcherable animals, it's probably worth keeping a breeding pair around in case of future need. Only dwarves with a [[preference]] for shells will demand shells in a strange mood.
* All demands for cloth are for a specific generic type (plant, silk, or yarn). Clothiers and Weavers will demand [[adamantine]] cloth if any is available, otherwise the type will be the generic form of the dwarf's first cloth preference, or a randomly chosen variety if the dwarf has no preference (or if the cloth is for a decoration, not the primary material). Types of cloth your fortress has not produced are '''not''' excluded, so it's best to keep a few bolts of each type of cloth in reserve.
* Should the claimed workshop be a [[magma forge]] and lose power due to insufficient magma beneath it, the mood will fail immediately and the dwarf will go [[insanity|insane]]. Should the forge be in danger of losing power, you should forbid it before it is claimed and wait until it is powered up reliably. Once magma forges are built, at least some dwarves will no longer be satisfied with a regular forge. Similarly, if a workshop claimed by a dwarf is deconstructed, destroyed or [[Creature_token#BUILDING_DESTROYER|toppled]] the mood will immediately fail and the dwarf will go insane.
* If one of a claimed workshop's building materials are selected and toggled to forbidden, this will also cause the mood to immediately fail and the dwarf to go insane.
* The mood's primary material will only be mentioned ''once'' in the dwarf's requests, even if the dwarf wants more than one unit of it. [http://www.bay12forums.com/smf/index.php?topic=75139.0]
* The item type of the artifact to be created is not decided until the instant the mood ''ends''. Saving (even after a dwarf has begun to gather materials) will allow you to reload and the result may be a different artifact (unless the moody dwarf's preferences force a particular item type). If you want to get an artifact platinum warhammer, make sure to have platinum nearby and/or block access to any other materials.
* You can restart the artifact creating process, even after the dwarf has gathered most of the components, by forbidding the claimed items (use {{k|t}} to view the contents of the workshop, select the undesired material, and press {{k|f}} to forbid it). If other items of that type are available, the dwarf will immediately switch to them.
* Each request for bones is actually a request for any kind of bone [[stack]], not individual bones. If they request bones more than one time, then they need that many stacks. Any size stack will do and the entire stack will be used. Bones come from [[butcher]]ing, rotted animal corpses do not count, even if they are skeletons. [[Tame]] animal corpses, whether they were pets or strays, can only be butchered as a result of a [[Butcher#Slaughtering|slaughter]] task, tame animals that died by any other means cannot be butchered. Slaughter a puppy. [http://www.bay12forums.com/smf/index.php?topic=105002.0]

== Demands ==
Once a workshop is claimed, the dwarf will begin collecting materials. Each artifact will require 1-3 "base items" and up to 7 additional items for decorations. The dwarf may well need several items of one material!

If the moody dwarf remains idle, then the necessary materials are not available. [[Forbid|Forbidden]] items must be reclaimed ({{K|i}} – {{K|F}}) before they may be used, but moody dwarves will ignore settings regarding [[economic stone]]. Click on the workshop to receive a series of clues about what the dwarf needs. '''Hints that stay active for longer than 2 seconds mean that multiple pieces of that material will be required; each single demand will be displayed for 2 seconds, so if it says "gems... shining" for 6 seconds, 3 gems are demanded. However, the mood's primary material will always be shown for only 2 seconds, even if more than one is required.''' Materials will always be fetched ''in order'', so if at least one item has already been retrieved (the items will show up with "TSK" ("task") next to them when the workshop is viewed with the {{K|t}} context menu), it will usually be possible to tell what item is required next.

If you want your dwarves to construct their artifacts out of valuable materials instead of whatever useless thing happens to be close at hand, you can selectively forbid types of material through the stocks screen so that only the material you want them to use is available; though this might interfere with the normal crafting operations of your fortress, the disruption is generally short-lived (as long as you remember to unforbid them again afterwards!). You can even forbid something a moody dwarf is carrying (which may be necessary sometimes, since while they are not waiting in the workshop, they will not tell you what they need); the dwarf will finish hauling it to the workshop, but then immediately go searching for another. This trick can mean the difference between a bauxite statue decorated with moss agates and a native platinum statue encrusted with diamonds. Be aware that this may not always work – see below for more information.

Burrows allow even better control over a moody dwarf's material usage. Simply by creating a burrow around the claimed workshop and another part over the desired material, a moody dwarf can be controlled without forbidding every single stone in the fortress. A moody dwarf will follow the burrow definitions just like a regular worker, but be mindful that they will not leave the burrow to get materials that are outside of their assigned burrow. A problem can arise when bones from an outside refuse stockpile are needed by a moody dwarf that is assigned to a burrow.

The various demands are translated here:

:{| class="wikitable" style="text-align:left;width:90%;"
|-
! Material
! Fey
! Macabre
! Secretive
! Possessed
|-
|
| <dwarf> screams "I must have <demand>!"
| <dwarf> broods "Yes. I need <demand>."
| <dwarf> sketches pictures of <demand>.
| <dwarf> mutters "<artifact> needs <demand>..."
|-
| [[Stone]]
| colspan=2 | rock
| a quarry
| stone... rock
|-
| Stone/metal [[block]]s
| colspan=2 | rock blocks
| square blocks
| blocks... bricks
|-
| [[Wood]]
| colspan=2 | wood logs
| a forest
| tree... life
|-
| Metal [[bar]]
| colspan=2 | metal bars
| shining bars of metal
| bars... metal
|-
| [[Gem]]s (cut)
| colspan=3 | cut gems
| gems... shining
|-
| [[Gem]]s (raw)
| colspan=3 | rough gems
| rough... color
|-
| Green [[glass]]
| colspan=2 | raw green glass
| glass
| raw... green
|-
| Clear glass
| colspan=2 | raw clear glass{{verify}}
| glass and burning wood
| raw... clear
|-
| Crystal glass
| colspan=2 | raw crystal glass{{verify}}
| rough gems and glass
| raw... crystal
|-
| [[Bone]] [http://www.bay12forums.com/smf/index.php?topic=105002.0;topicseen stack]
| colspan=2 | bones
| skeletons
| bones... yes
|-
| [[Shell]] {{cite talk/this|Re:_.22Verify.22_on_the_shell_row_of_the_demands_table}}
| colspan=3 | shells
| a shell...
|-
| [[Leather]]
| colspan=2 | tanned hides
| stacked leather
| leather... skin
|-
| [[Cloth]] (plant fiber)
| colspan=2 | plant cloth
| stacked cloth
| cloth... thread
|-
| [[Cloth]] (silk)
| colspan=2 | silk cloth
| stacked cloth
| cloth... thread
|-
| [[Cloth]] (yarn)
| colspan=2 | yarn cloth
| stacked cloth
| cloth... thread
|-
| [[Skull]]{{verify}}
| colspan=2 | body parts
| death
| a corpse
|}

Dwarves in macabre moods may also say "Leave me. I need... things... certain things", in which case they want special items, such as [[skull]]s or vermin [[remains]].

Related to the above behavior, moody dwarves demanding rock blocks will also accept blocks forged from metal bars.

*The first item demanded by the dwarf is based on the moodable skill being used – stoneworkers (miners, engravers, masons, stone crafters, and mechanics) will demand boulders, woodworkers (carpenters, wood crafters, and bowyers) will demand logs, leatherworkers and tanners will demand leather, weavers and clothiers will demand cloth, metalworkers will demand metal bars, gem cutters/setters will demand rough gems, glassmakers will demand raw glass, and bone carvers will demand bones.
**Metalworkers will demand adamantine wafers if any are available (unforbidden). If not, they will demand a preferred metal ''if'' you have ''ever'' smelted any bars of it – fey moods will state this outright, while for secretive moods and possessions, you will need to check the dwarf's [[preferences]] to see which metal they like. Metal bars acquired via [[trade]] or by melting down items (such as Goblinite) do ''not'' count as smelted. Otherwise, they will select any available metal(s).
**Weavers and clothiers will demand [[adamantine]] cloth if any is available (unforbidden). If not, they will demand a generic type of cloth (silk, plant fiber, or yarn) that matches a specific cloth preference (e.g. a dwarf that likes cave spider silk will require ''any'' type of silk cloth, and a dwarf who likes more than one type of cloth will demand whichever one appears first in their list). Dwarves without a cloth preference will demand a generic type at random.
**Glassmakers will demand their preferred type of glass ''if'' you've produced any of it (or if it's green glass); if they don't prefer any type of glass, they will randomly select one type of glass you've produced (though they will always assume you have created green glass). Note that acquiring raw glass from a caravan does ''not'' count as producing it.
**Dwarves in macabre moods will select either 1 vermin remains, 1 stack of bones, or 1-3 skulls.
**Bone carvers will demand shells if they like a type of shell; if not, they will demand bones.
**All preference-based material requests are decided the instant the mood begins – by the time the workshop is claimed, it is too late to change the dwarf's mind.
*The remaining "decoration" items are selected randomly from the following list: wood logs, metal bars, small gems, rock blocks, rough gems, boulders, bones, leather, plant/silk/yarn cloth, or raw glass (green/clear/crystal, based on what you've produced).
**Decoration items will never be the same type as the primary mood material.
**Certain mood professions will also explicitly avoid using certain items for decorations – most of these match up with the primary mood material, but miners, engravers, masons, and stonecrafters will additionally avoid requesting rock blocks.
**If you have not produced any raw glass in your fortress, moody dwarves will never request it.
**Dwarves in macabre moods have a 50% chance to replace each decoration item with either remains or bones.
*Gem cutters and gem setters have a 50% chance of only gathering a single rough gem and nothing else – when they do this, they produce a "perfect gem" with a single decoration.

Once all materials have been gathered, viewing the workshop with {{K|q}} will display a special message depending on the type of mood:
* Fey – "<dwarf> works furiously!"
* Secretive – "<dwarf> works secretly..."
* Possessed – "<dwarf> keeps muttering <artifact>..."
* Macabre – "<dwarf> works, darkly brooding..."
* Fell – "<dwarf> works with menacing fury!"

== The mechanics of moods ==

=== Frequency===
When a fortress is started, an internal counter is set to 1000. Every 100 frames (12 times per day), this counter is decremented by 1, running down to zero in about 3 months. When the counter would ordinarily be decremented when it has already reached zero, there is a 1 in 500 chance that a strange mood will strike. This means that, once all conditions are met and the clock is ticking, while there is approximately a 2.4% chance of a strange mood per day, or a ~52% chance of at least one strange mood per month, there is no guarantee when a mood will strike – might be sooner, might be (almost) never. The counter resets to 1000 once a mood begins and continues counting down as the mood progresses, resetting again if it reaches zero before the mood finishes.

=== Conditions ===
In order for a dwarf to be struck with a strange mood, three conditions must be met:
:* There is no currently active strange mood,
:* The maximum number of artifacts is not met,
:* There are at least 20 eligible dwarves ''(see below)'', including dwarves who have already created artifacts.

If all three of these conditions are true, the game may trigger a strange mood according to the frequency.

==== Maximum number of artifacts ====
The maximum number of artifacts in any one fortress is limited by the lower of:
* The number of items created divided by 100.1 Mined-out rock ''does'' count as an "item created", though it is not clear whether bolts or units of drink are counted individually.
* The number of revealed [[subterranean]] tiles divided by 2304 (this is an area equivalent to a 48x48 square). Once you discover and explore the [[cavern]]s and [[magma sea]], this limit becomes largely irrelevant, and using a [[utilities#DFHack|"reveal" utility]] will eliminate it altogether, though strip-mining an area entirely and exposing it to the surface will count ''against'' this.
:1 – actually the sum of all items by type ''and'' by type+subtype+material, divided by 200. Furthermore, destroying items does '''not''' decrement these counters, so casting and mining [[obsidian]] will count toward this.

==== Eligibility ====
The deciding factor for eligibility is a dwarf's actual [[profession]]. ''(Note that "[[Skill#Professions|custom professions]]" have no effect on this!)'' Thus, dwarves may enter strange moods regardless of what skills they have or don't have, so long as they are of an acceptable profession. Dwarves who have already created an artifact are not eligible to create another, and since every mood ends in either an artifact or death, every dwarf may enter at most one mood. Dwarves who have obtained one or more legendary skills without creating artifacts ''may'' enter strange moods and will simply become even ''more'' legendary.

On-duty dwarves with a [[Soldier#Soldier professions|military profession]] other than "Recruit" ''cannot'' enter moods. Incidental military skills make no difference – eligibility (and weighting) depends purely on the actual ''[[profession]]'' as listed at the time (with the exception of unit leaders, whose on-duty and off-duty titles are the same). Soldiers are still capable of entering moods if they are ''off duty'' and thus in Civilian mode, but you don't have to worry about your axedwarves getting a burst of inspiration mid-combat and then wandering off to make a highest-quality craftsdwarfship gabbro scepter decorated with cow bone menacing spikes, cow bone rings and a cow bone image of hamster men while the trolls sack your settlement.

Children may enter moods, but babies will not.

Any other profession is eligible to enter a mood, but not all have the same ''chance'' to enter a mood.

:''('''Note''' – Specifically, and to avoid previous misunderstandings, [[Strand extractor]], [[Clerk]]/[[Administrator]]/[[Trader]], [[Doctor]] (and related), [[Soldier#Recruits|Recruit]] and [[Child]] ''are'' moodable professions.)''

There are several additional factors which will prevent a dwarf from entering a mood:
* Being unable to pick up items ("cannot grasp")
* Being dragged by/dragging another unit (off to [[jail]]/leading livestock to a [[cage]], [[chain]], [[pasture]], [[Activity zone#Pit/Pond|pit/pond zone]], or to the [[butcher's shop]] or [[farmer's workshop]].)

=== Chance ===
When determining who will have a strange mood, each eligible dwarf is put into a weighted lottery, where the chance of being selected is based on the dwarf's [[profession]]. Most professions receive 6 "tickets", but some receive additional tickets to improve their odds.

{| class="wikitable" cellspacing="0" border="2" cellpadding="5"
|-
! Weighting
! Professions
|-
| 21 ||Armorer, Blacksmith, Bone Carver, Clothier, Craftsdwarf, Jeweler, Gem Cutter, Gem Setter, Glassmaker, Leatherworker, Metalcrafter, Metalsmith, Stonecrafter, Weaponsmith, Weaver, Woodcrafter
|-
| 11 ||Bowyer, Carpenter, Stoneworker, Stone Carver, Woodworker
|-
| 6 ||Engraver, Mechanic, Miner, Tanner, and all other [[profession]]s (including Peasant).
|}

:'''''Example:''' What this means is: if you had 21 dwarves, made up of 20 eligible farmers, furnace operators, miners, woodcutters etc. (with 6 chances each) plus one Armorer (with 21 chances), that one Armorer would have a 21 in 141 chance (20 dwarves x 6 chances each = 120 + 21 chances more = 141 total) of the mood striking them. That's about 1 in 7, while the other 20 have a 6 in 141 chance each, or about 1 in 24. The odds are still against the armorer, but much better than for any other single dwarf.''

Note that not every profession has a moodable skill. A Soaper, Furnace Operator, or Strand Extractor can be taken by a mood, but that will not make those skills legendary, nor will they create an artifact bar of soap, bar of metal, or wafer of adamantine.

=== Timing ===
A dwarf will go [[Insanity|insane]] after exactly 50000 ticks (which, at 1200 ticks per day, works out to 41.66 days, or almost a month and a half) waiting for an item they demand. However:
*The insanity countdown is reset after every item they bring to the workshop.
*It doesn't run while they are out getting something, working on their construction or on their way to claim a workshop. Only during time spent idling without either the required workshop or a required item do they spiral towards madness.
*Dwarves under strange moods do not feel hunger, thirst or drowsiness.

=== Fuel ===

{{D for dwarf}}

Curiously, [[metalsmith]]s in strange moods do not seem to require any [[fuel]] to complete their [[metal]] [[artifact]]s. It is believed that they, consumed by artistic passion, fuel the forges with their own beards, vigorously fanning the flaming hairs while they feed the furnace more beard. Such a sacrifice is a dwarf's own beard that only an artifact merits its removal. Only an artifact's completion can mollify its creator's shame; dwarves unable to complete this great pursuit go insane, not because of its failure, but because they cannot endure the inevitable humiliation.

Legend has it that the world's first [[elf]] once attempted to forge the world's most powerful artifact, imbued with magic to control all dwarves. But, because he could not suffer to cut a tree for fuel, he was unable to do so. Faced with no alternative, he kidnapped each of the seven ancient dwarves by tempting them with [[booze]], an unfamiliar drink to the first dwarves. He then forcefully shaved them and created [[charcoal]] from their beards.

Enraged by their loss, the dwarves set out to find the elf's home, based in the world's first tree. They startled the engrossed elf who fled with nothing but a handful of the tree's unborn children. After reclaiming the beard-charcoal, the dwarves set fire to this tree. Alight in flames hotter than the sun, the tree burned in what is believed to have been the world's hottest fire – a fire so hot that the tree's roots melted the inside of the earth, creating a worldwide [[magma sea]]. The elf watched this fire and swore revenge on the dwarves.

After realizing their beards could not be recovered from their charred state, the dwarves agreed to sprinkle the charcoal over the earth, as a gift and reminder to future dwarves. In doing so, they created the world's [[bituminous coal]] deposits. They then spent the next years searching for a way to create the drink they had been given. Discovering new drinks along their pursuit, the dwarves eventually perfected the hidden art of brewing booze and passed this emerging knowledge to coming generations.

== Artifacts created ==
The type of artifact created depends on the type of mood, the dwarf's highest moodable skill, and the base material. Masons and miners will always create some kind of stone furniture; bone carvers, a bone or shell object (including furniture); carpenters, a piece of wooden furniture; engravers and stone crafters, a stone craft; metalworkers, metal crafts, weapons, or armor (depending on the type of metalworker); weavers and clothiers, an article of clothing; tanners and leatherworkers, a leather armor or object. If a dwarf has no moodable skills, they will randomly select stone crafting, wood crafting, or bone carving as their mood skill and produce their artifact accordingly. The precise type of craft created is usually somewhat random, but if a dwarf has a personality preference for a particular item type, such as gauntlets or floodgates or crowns, and that thing is an available choice given the dwarf's profession, they are guaranteed to create an object of that type (if multiple preferences match, one will be randomly selected).

The first object grabbed by the dwarf will be the base material; all other materials will be used as [[decoration]]s. If a dwarf grabs a piece of [[chalk]] and makes a statue, for instance, it will be a "chalk statue", but an artifact can potentially include bone, cloth, gems, leather, metal, shell, stone, and wood decorations all at once. In some cases, a moody dwarf will produce an item which normally cannot be made from that material, leading to such odd constructions as an [[obsidian]] [[bed]], [[ruby]] [[floodgate]], or turtle [[shell]] [[cage]], but the actual item types available for each mood type are still very much restricted (e.g. only a glassmaker or jeweler can make a [[window]], and a moody clothier cannot produce an article of clothing that could not normally be made from cloth).

{| class="wikitable" cellpadding="4" style="border:1px solid black;border-collapse:collapse;text-align:left;"
|-
! Mood / Skill
! Artifact type
|-
| [[Armorsmith]]
| Each equipment item with [METAL] (mail shirt, breastplate, leggings, greaves, gauntlet, low boot, high boot, cap, helm, mask), any shield
|-
| [[Bone carver]] (bone)
| Each equipment item with [BARRED] (leggings, greaves, gauntlet, helm), any shield, instrument, toy, door, bed, chair, table, statue, coffer, bin, armor stand, weapon rack, cabinet, coffin, floodgate, hatch cover, grate, chain, cage, animal trap, figurine, amulet, scepter, crown, ring, earring, bracelet, any weapon, any trap component†
|-
| [[Bone carver]] (shell)
| Each equipment item with [SCALED] (leggings, gauntlet, helm), figurine, amulet, crown, ring, earring, bracelet, chain, cage, animal trap, instrument, toy
|-
| [[Bowyer]]
| Each ranged weapon (crossbow, bow, blowgun)
|-
| [[Carpenter]]
| Door, bed, chair, table, statue, chest, bin, armor stand, weapon rack, cabinet, coffin, floodgate, hatch cover, grate, cage, barrel, bucket, animal trap, splint, crutch
|-
| [[Clothier]]
| rowspan=2| Each equipment item with [SOFT] (dress, shirt, tunic, toga, vest, robe, coat, cloak, cape, trousers, loincloth, thong, short skirt, skirt, long skirt, braies, glove, mitten, sock, sandal, shoe, chausses, cap, hood, mask, turban, head veil, face veil, headscarf), bag, rope
|-
| [[Weaver]]
|-
| [[Engraver]]
| Figurine, amulet, scepter, crown, ring, earring, bracelet, goblet, instrument, toy
|-
| Fell Mood
| rowspan=3| Each equipment item with [LEATHER] (dress, shirt, tunic, toga, vest, robe, coat, cloak, cape, armor, trousers, loincloth, thong, short skirt, skirt, long skirt, braies, leggings, glove, mitten, sock, sandal, shoe, chausses, low boot, high boot, cap, hood, mask, turban, head veil, face veil, headscarf, helm), any shield, bag, backpack, quiver, instrument
|-
| [[Leatherworker]]
|-
| [[Tanner]]
|-
| [[Gem cutter]]
| rowspan=3| Perfect gem‡, door, bed, chair, table, statue, box, armor stand, weapon rack, cabinet, coffin, floodgate, hatch cover, grate, figurine, amulet, scepter, crown, ring, earring, bracelet, chain, flask, goblet, cage, barrel, bucket, animal trap, window, instrument, toy
|-
| [[Gem setter]]
|-
| [[Glassmaker]]
|-
| Macabre Mood (vermin remains)
| Amulet, bracelet, earring
|-
| [[Mason]]
| rowspan=4| Door, bed, chair, table, statue, quern, millstone, coffer, armor stand, weapon rack, cabinet, coffin, floodgate, hatch cover, grate
|-
| [[Stonecutter]]
|-
| [[Stone carver]]
|-
| [[Miner]]
|-
| [[Mechanic]]
| Mechanism
|-
| [[Metal crafter]]
| Figurine, amulet, scepter, crown, ring, earring, bracelet, chain, flask, goblet, instrument, toy
|-
| [[Metalsmith]]
| Door, bed, chair, table, statue, coffer, armor stand, weapon rack, cabinet, anvil, coffin, floodgate, hatch cover, grate, cage, barrel, bucket, animal trap, pipe section†, splint, crutch
|-
| [[Stone crafter]]
| Figurine, amulet, scepter, crown, ring, earring, bracelet, goblet, instrument, toy
|-
| [[Weaponsmith]]
| Any weapon, any trap component†
|-
| [[Wood crafter]]
| Figurine, amulet, scepter, crown, ring, earring, bracelet, goblet, instrument, toy
|}
:† ''chance of selection for this entry is reduced by 90%''
:‡ ''this item may only be selected at the beginning of the mood (50% chance)''

If your dwarf does not have a preference for any possible items, the game will randomly select one from the list. Entries with "any" are treated as collective entries with a single chance and will randomly choose a subtype which your civilization is capable of making. This explains why bowyers and clothiers will regularly produce foreign artifacts, while weaponsmiths will not unless they have exotic preferences.

== Success ==
Once created, most [[artifact]]s will be available for use just like a normal item of its type. Artifact [[armor]] and [[weapon]]s gain extra bonuses in combat, while artifact clothing is immune to [[wear]]. Artifact mechanisms installed in weapon traps will improve attack rolls. Artifact furniture is useful for raising the value of a [[noble]]'s room. Artifact mechanisms, trap components, or weapons in [[weapon trap|weapon trap]]s can also boost a room's value considerably. Other artifacts that can be used in construction (such as [[barrel]]s, [[bucket]]s, and [[anvil]]s) may be used similarly. Artifact [[door]]s and [[hatch]]es are immune to [[building destroyer]]s, and artifact [[cage]]s can even hold gnawing vermin. All artifacts can be displayed in a [[display case]] or on a [[pedestal]], or [[trade]]d to a [[caravan]] for supplies.

Successfully creating an artifact grants a very strong happy [[thought]] (enough to make the creator totally ecstatic for several months) as well as granting the creator partial ''immunity to insanity'' – even if your fortress is left in a terrible state, any dwarf who has created an artifact is exempt from going [[insane]] due to prolonged unhappiness. The dwarf may also cry, found as a coating of dwarf tears on both their eyes.

== Failure ==
If you can't provide the desired workshop and all the required component materials within a couple of months, the dwarf will go [[insanity|insane]], which cancels the mood and the artifact. As if that's not bad enough, any dwarf who goes insane will soon die, one way or another.

A dwarf who is '''stark raving mad''', '''melancholy''', or '''catatonic''' is harmless to others (until they die and start a [[tantrum]] spiral), but a '''berserk''' dwarf will attack other dwarves and possibly pull levers at random. You may want to station a squad nearby or assign a few war dogs to the dwarf on the chance that they will lash out. If you build your workshops inside enclosed rooms with doors you can also lock the moody dwarf in the room until he or she starves. In extreme cases, building a wall around an open workshop is the best precaution.

==Bugs==
There are many bugs reported related to moody dwarves. As has been the case in 40d, most turned out to be (understandable) failures of the player to grasp the mechanics of artifact creation and demands. ([http://bay12games.com/dwarves/mantisbt/view_all_bug_page.php Bug tracker])
* If a dwarf dies due to failing to complete an artifact, a memorial made to the dwarf will read that the dwarf did create it, despite the failure, and will even list the name of the artifact that never came to be. {{bug|3640}}
* When producing an item that is normally made in pairs (gloves, boots, etc.), only a single artifact will be created.
* Attacking a dwarf who fails their mood with your militia may result in a loyalty cascade. {{bug|7107}}
* Dwarves entering a strange mood when isolated (e.g. on a stepladder) cause severe lag. {{bug|8698}}
* If the mood primary component is forbidden while working, but the strange mood still has other items tasked, the result is an iron artifact. {{bug|5625}}
* If the dwarf starts constructing the artifact and is scared off by a hostile creature before completion, they may become stuck. {{bug|9833}} Removing the floors around them, then dropping an item on them should cause them to dodge, fall, and return to the workshop.{{cite forum|161598}}

== Troubleshooting ==

'''Problem''': Moody dwarf does not claim a workshop
:'''Solution''': Check for highest moodable skill and build the corresponding workshop. If no moodable skills, build a craftsdwarf's workshop. Once [[magma forge]]s have been built, some dwarves may demand to work at a magma-powered forge or furnace while others might still insist on a coal-powered one. If a forge is needed, make sure you built a forge, not smelter. Note that [[forbid]]den workshops cannot be claimed. Verify if the dwarf is assigned to a burrow and/or if there is a civilian alert set to a burrow. If so, verify that the burrow allows access to the workshop being sought after.

'''Problem''': Moody dwarf waits in claimed workshop
:'''Solution''': Desired material is unavailable. Determine which material is requested next (materials are collected in the same order as shown in the dwarf's request list) and make some available, if possible. Be aware that some lists contain duplicates and you will need to make a seperate stack available for each one. Note that dwarves with [[preference]]s may demand a specific type of material ([[brass]] bars or [[yarn]] cloth, for example). [[Forbid]]den and inaccessible materials cannot be collected, nor can material located outside the moody dwarf's [[burrow]].

'''Problem''': No dwarf has entered a mood for a long time
:'''Solution''': Strange moods require at least 20 dwarves; if you have that many, you've probably hit one of the two caps. Exploring the caverns can increase the number of revealed tiles very quickly, while [[craft]]ing [[goblet]]s will quickly raise your item count; [[exploratory mining]] will count toward ''both'' caps, simultaneously revealing tiles and producing boulders, though more slowly than exploring or crafting. Exposing excavated terrain to the sky is counterproductive, as it will ''lower'' your artifact cap (since the cap only counts revealed ''subterranean'' tiles).

'''Problem''': Moody dwarf wants stacked cloth, but all types are available and he's not moving
:'''Solution''': Dwarves will not take items from active hospitals. If you have no cloth available outside of hospitals, try disabling or temporarily removing the hospital designation from their zones. They will then proceed to take new items, even if they don't go for the cloth right away. It is also possible that the desired cloth has been partially consumed in order to make wound dressings.

==Trivia==

[https://www.youtube.com/watch?v=K6454rENbtc Strange Moods], by Dabu, is the fourth track in the first Premium [[soundtrack]] volume, occasionally playing during [[Fortress mode]].

{{D for Dwarf}}
It is widely said that Tarn Adams has been in the grips of a fey mood for two decades now, and we are playing his artifact. However, neither [[human]]s nor [[giant toad]]s can enter strange moods, so this must surely be a joke.

{{Category|Fortress mode}}
{{Category|Dwarves}}
[[Ru:Strange mood]]

Fairy

2024-06-19T22:21:46Z

DikbutDaGrate: Minor alteration of sentence structure

{{Quality|Fine}}
{{verminlookup/0
|image=fairy_sprite.png}}
{{av}}
{{creaturedesc}}

'''Fairies''' are a type of [[fanciful]] above-ground [[vermin]] that live in [[good]] areas. They, alongside [[pixie]]s, are the only intelligent vermin in the game, though they can't be interacted with on the basis of being vermin. When encountered in [[adventure mode]], they will glow in the dark. They possess a [[pet]] value of 10. As they possess the VERMIN_NOTRAP token, they cannot be captured by placing [[animal trap]]s, but they can still be trapped using the ''catch live land animal'' task.

Despite their description, they do not actually have wings at all, let alone lacy ones (though they can still fly, even without them). A comment in their raws implies [[Main:Toady One|Toady]] plans to eventually give them lacy wings.

While a token in their creature raws should enable them to generate light, they cannot, as they lack the necessary graphical tokens and sprite creature graphics to do so.

Some [[dwarves]] [[Preferences|like]] fairies for their ''lacy wings'' and their ''babylike giggles''.

[[File:fairy_preview.jpg|thumb|269px|center|Note: Wings may not function in-game.]]

{{gamedata}}
{{vermin}}

Pixie

2024-06-19T22:21:05Z

DikbutDaGrate: Is unable to generate light.

{{Quality|Superior}}
{{verminlookup/0
|image=pixie_sprite.png}}
{{av}}
{{creaturedesc}}

'''Pixies''' are a very common type of [[fanciful]] above-ground [[vermin]] that live in [[good]] areas. They drift in the air in faintly glowing, colorful groups, dancing intricately. Repetitive music and recreational pixie dust use are likely involved. They, alongside [[Fairy|fairies]], are the only intelligent vermin in the game, though they can't be interacted with on the basis of being vermin. When encountered in [[adventure mode]], they will glow in the dark. While they possess a [[pet]] value of 10, they can't be captured with [[animal trap]]s.

Despite their description (and what their sprite in the [[premium version]], for that matter, shows), pixies do not actually have wings (though they can still fly without them). A comment on their raws implies [[Main:Toady One|Toady]] plans to eventually give them lacy wings.

While a token in their creature raws should enable swarms of these creatures to generate light, they cannot, as they lack the necessary graphical tokens and sprite creature graphics to do so.

Some [[dwarves]] [[Preferences|like]] pixies for their ''shifting colors'' and their ''intricate aerial dances''.

[[File:pixie_preview.jpg|thumb|180px|center|Much smaller than pictured.]]

{{gamedata}}
{{vermin}}

Fairy

2024-06-19T22:18:51Z

DikbutDaGrate: Is unable to generate light.

{{Quality|Fine}}
{{verminlookup/0
|image=fairy_sprite.png}}
{{av}}
{{creaturedesc}}

'''Fairies''' are a type of [[fanciful]] above-ground [[vermin]] that live in [[good]] areas. They, alongside [[pixie]]s, are the only intelligent vermin in the game, though they can't be interacted with on the basis of being vermin. When encountered in [[adventure mode]], they will glow in the dark. They possess a [[pet]] value of 10. As they possess the VERMIN_NOTRAP token, they cannot be captured by placing [[animal trap]]s, but they can still be trapped using the ''catch live land animal'' task.

Despite their description, they do not actually have wings at all, let alone lacy ones (though they can still fly, even without them). A comment in their raws implies [[Main:Toady One|Toady]] plans to eventually give them lacy wings.

While a token in their creature raws should enable them to generate light, they cannot, as there is nothing in either their graphical raws, or their sprite creature graphics which would allow them to.

Some [[dwarves]] [[Preferences|like]] fairies for their ''lacy wings'' and their ''babylike giggles''.

[[File:fairy_preview.jpg|thumb|269px|center|Note: Wings may not function in-game.]]

{{gamedata}}
{{vermin}}

Graphics token

2024-06-19T22:13:37Z

DikbutDaGrate: clarification on LIGHT_GEN

{{Quality|Exceptional}}
{{av}}
{{Modding}}
:{{for/see|an explanation of how to use the various graphics types|[[Graphics]]}}

The <code>[OBJECT:GRAPHICS]</code> [[token]] defines the use of various tile-based graphics in the game. As of version 50.01, graphics tokens have been greatly expanded to accommodate the release of the Steam & Itch premium version. These tokens, and explanations on how to use them, are listed below; the list will expand as the tokens are discovered and understood.

== Creature Graphics ==
Creature graphics are found within graphics_creature_x files (such as graphics_creature_domestic or graphics_creature_layered). All graphics files must begin with the file name, followed by the <code>[OBJECT:GRAPHICS]</code> type that tells the game that the file contains graphics definitions. A more detailed explanation on how to use these can be found in [[Graphics#Creature_Graphics|creature graphics]].

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

|-
| {{text anchor|CREATURE_GRAPHICS}}
|
* [[Creature token|creature id]]
| The simplest and most common form of creature graphics for defining one sprite for each [[#Condition|basic condition]].

Further conditions are required for this to function following the [[Graphics#Basic_Graphics|creature graphics]] format. Accepts [[Graphics#Large_Graphics|large graphics tokens]].

Additionally used to start defining a [[Graphics#Layered_Graphics|layered graphics]] set.

|-
| {{text anchor|CREATURE_CASTE_GRAPHICS}}
|
* [[Creature token|creature id]]
* [[Caste|Caste ID]]
| Nearly the same as {{token|CREATURE_GRAPHICS|g}}, but allows a separate sprite to be defined for each caste.
A simple alternative to [[Graphics#Layered Graphics|Layered Graphics]].

Requires conditions defined in [[Graphics#Basic_Graphics|creature graphics]] format. Accepts [[Graphics#Large_Graphics|large graphics tokens]].

|-
| {{text anchor|STATUE_CREATURE_GRAPHICS}}
|
* [[Creature token|creature id]]
| Format for beginning a [[Graphics#Statue_Graphics|creature statue definition]]. Defines a 1x2 vertical rectangle to be displayed when a statue depicts one of these creatures.

|-
| {{text anchor|STATUE_CREATURE_CASTE_GRAPHICS}}
|
* [[Creature token|creature id]]
* [[Caste|Caste ID]]
| Format for beginning a [[Graphics#Statue_Graphics|creature statue definition]] while specifying caste. Defines a 1x2 vertical rectangle to be displayed when a statue depicts one of these creatures.

|-
| {{text anchor|TILE_GRAPHICS_RECTANGLE}}
|
* [[Creature token|creature id]]
| Graphics for a 3x2 rectangle; for creatures, this is used exclusively for representing Forgotten Beasts based on their body parts. Uses [[Graphics#Forgotten_Beast_Graphics|forgotten beast graphics]]. It's also, however, used for interface graphics, see [[graphics_interface.txt]].

|}

=== Conditions ===
Different graphics can be defined for the same creature based on some properties about it. Below is a list of all the basic "creature texture" types that can be used as additional conditions to various basic sprites.

{| {{prettytable}}
|- bgcolor="#dddddd"
! Condition
! Description
|-
| {{text anchor|DEFAULT}} || The default condition that will be displayed unless overwritten by a more specific one below.

|-
| {{text anchor|LAW_ENFORCE}} || Displayed if the unit is law enforcement.

|-
| {{text anchor|TAX_ESCORT}} || Displayed if the unit escorts a tax collector (unused).

|-
| {{text anchor|ANIMATED}} || Displayed if the creature is raised from the dead using an I_EFFECT:ANIMATE interaction.

|-
| {{text anchor|GHOST}} || Displayed if the creature is a ghost.

|-
| {{text anchor|ADVENTURER}} || Displayed if the creature is an adventurer.

|-
| {{text anchor|CORPSE}} || Displayed for corpses.

|}

=== Basic creature sprite types ===

An individual sprite can be of any of the following classes. If "accepts secondary" is "yes", it can also have an extra condition tacked on at the end.

{| {{prettytable}}
|- bgcolor="#dddddd"
! Condition
! Description
|-
| {{text_anchor|Basic Condition}} || Any of the [[Graphics token#Conditions|above conditions]] can be used on their own, as the default for that condition class.

|-
| {{text_anchor|Unit type}} || Any [[Unit type token]] can be used. You may also append a [[Graphics token#Conditions|basic condition as above]] to further specify.

|-
| {{text_anchor|Position}} || Any [[Position token]] can be used, such as MONARCH, BROKER etc. All position tokens are raw-defined; any modded positions can have their own graphics. You may also append a [[Graphics token#Conditions|basic condition as above]] to further specify.

|-
| {{text_anchor|LIST_ICON}} || The default icon for this creature in lists, such as [[Arena]] mode or overall training.

|-
| {{text_anchor|EGG}} || The sprite for a clutch of eggs.

|-
| {{text_anchor|SKELETON}} || The sprite for a rotten corpse.

|-
| {{text_anchor|SKELETON_WITH_SKULL}} || The sprite for a rotten corpse that can have a [[totem]] made from it.

|}

=== Layered Conditions ===
Layers aren't very useful on their own, so they come with a set of conditions to define how when they are displayed and how they interact.

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

|-
| {{text_anchor|LAYER_SET}} ||
* condition
| Creature Graphics
| Begins defining a layer set for a creature's graphics. Valid values of ''condition'' are DEFAULT, PORTRAIT{{version|50.13}}, or CORPSE. Valid values for basic conditions may not work.{{verify}}

|-
| {{text_anchor|LS_PALETTE}}{{version|50.13}} ||
* name
|| Layer Set
|| Begins defining a palette for the layer set. Its name can be referenced by {{token|USE_PALETTE|g}}. Unlike the palettes used to render all [[descriptor color token]]s, it can be of arbitrary length.

|-
| {{text_anchor|LS_PALETTE_FILE}}{{version|50.13}} ||
* file name
| Palette
| The file name of the 8bit RGBA (sometimes called 32bit) in the <tt>/graphics/images</tt> folder of the mod, such as <tt>images/portraits/dwarf_portrait_body_palette.png</tt>.

|-
| {{text_anchor|LS_PALETTE_DEFAULT}}{{version|50.13}} ||
* integer
| Palette
| Defines the default row of a layer set palette, conventionally 0. The exact color values on this row will be replaced on layer images with the colors in the same column, based on what row is passed as an argument to {{token|USE_PALETTE|g}}.

|-
| {{text_anchor|LG_CONDITION_BP}}{{version|50.13}} ||
* selection criteria BY_TYPE, BY_CATEGORY, BY_TOKEN
* category, type, or token
|| Layer Group
|| Allows the entire layer group (rather than an individual layer) to be switched on and off depending on the conditions of a body part. Should accept the same tokens {{token|CONDITION_BP|g}} does. {{verify}}

|-
| {{text_anchor|END_LAYER_GROUP}} || || Layer Group
| Explicitly marks the end of a layer group, which allows layers after to not belong to any layer group.

|-
| {{text_anchor|CONDITION_ITEM_WORN}} ||
* BY_CATEGORY / BY_TOKEN
* [[Body_token#CATEGORY|category]] / [[Body_token#BP|body part token]]
* Armor type (ARMOR, GLOVES, Etc.)
* Item ID(s)
|| Armor Wieldables || Defines a clothing or armor graphic by the specific part it is equipped to, the type of armor it is, and the internal id of that item.
For example, a condition representing a right handed mitten or glove would be defined as:
<code>[CONDITION_ITEM_WORN:BY_TOKEN:RH:GLOVES:ITEM_GLOVES_MITTENS]</code>
Also accepts the input <code>ANY_HELD</code> or <code>WIELD</code> (e.g. <code>WIELD:WEAPON:ANY</code>).

|-
| {{text_anchor|SHUT_OFF_IF_ITEM_PRESENT}} ||
* BY_CATEGORY / BY_TOKEN
* [[Body_token#CATEGORY|category]] / [[Body_token#BP|body part token]]
* Armor type
* Item ID(s)
|| Armor || Causes the current layer to not be rendered if the creature has one of the items worn or equipped. Also accepts the input <code>ANY_HELD</code> or <code>WIELD</code> (e.g. <code>WIELD:WEAPON:ANY</code>).

|-
| {{text_anchor|CONDITION_CASTE}} ||
* caste name(s)
|| General
|| Displays this layer if the creature is this caste. Only one caste is accepted for each condition, but multiple caste conditions can be used in one layer and the layer will be displayed if any of them match.

|-
| {{text_anchor|CONDITION_DYE}} ||
* dye color
|| Armor
|| Should represent which color the clothing is dyed. Currently nonfunctional.{{version|50.05}}

|-
| {{text_anchor|CONDITION_NOT_DYED}} || || Armor
|| Should check if the clothing is dyed. Currently nonfunctional.{{version|50.05}}

|-
| {{text_anchor|CONDITION_MATERIAL_FLAG}} ||
* material flag
|| Material || Changes graphics based on the material an equipped item is made of. Valid material flags are similar to [[Reaction#Full_token_list|reactant conditions]] including:
* WOVEN_ITEM
* ANY_X_MATERIAL
:with X being:
:* PLANT, SILK, YARN, LEATHER, WOOD, SHELL, BONE, STONE, GEM, TOOTH, HORN, PEARL
* IS_DIVINE_MATERIAL
* NOT_ARTIFACT
* IS_CRAFTED_ARTIFACT
* METAL_ITEM_MATERIAL
* GLASS_MATERIAL
* FIRE_BUILD_SAFE
* MAGMA_BUILD_SAFE
[http://www.bay12forums.com/smf/index.php?topic=169696.msg8442543#msg8442543 among other, less useful ones.]

|-
| {{text_anchor|CONDITION_MATERIAL_TYPE}} ||
* material token
|| Material || Changes graphics based on the material an equipped item is made of. Valid material types take the form <code>METAL:COPPER</code> where copper can be replaced with any weapons-grade metal. General [[material token]]s are '''not''' functional. {{token|CONDITION_MATERIAL_FLAG|g}} is a better option for any material condition other than metal.

|-
| {{text_anchor|CONDITION_PROFESSION_CATEGORY}} ||
* [[Unit type token#Profession Categories|profession category token(s)]]
|| General
|| Checks the profession category of the creature to act as a condition. Multiple profession category tokens can be chained together. You can also use multiple of these tokens instead of listing them all in a single one, but this is functionally identical. Valid Profession tokens which are not categories will be ignored; values that do not match any existing Profession will be treated as <code>NONE</code> and thus apply to doctors, military, etc..

|-
| {{text_anchor|CONDITION_RANDOM_PART_INDEX}} ||
* identifier
* integer index
* integer range
|| General
|| Chooses a random layer among layers with a CONDITION_RANDOM_PART_INDEX with the same identifier. Index is which option this condition is, out of Range number of options. Ex:
<code>[CONDITION_RANDOM_PART_INDEX:HEAD:3:4]</code>
is the third possible random head out of four total options. One of these random conditions each will be put into a set of four different sprites to add some random variation in the appearance of the creature's head.

|-
| {{text_anchor|CONDITION_HAUL_COUNT_MIN}} ||
* integer
|| General
|| Counts how many items the creature is hauling. Used for {{token|PACK_ANIMAL}}s in vanilla.

|-
| {{text_anchor|CONDITION_HAUL_COUNT_MAX}} ||
* integer
|| General
|| Counts how many items the creature is hauling. Used for {{token|PACK_ANIMAL}}s in vanilla.

|-
| {{text_anchor|CONDITION_CHILD}} || || General
|| Checks if the creature is a child or baby.

|-
| {{text_anchor|CONDITION_NOT_CHILD}} || || General
|| Checks if the creature is an adult.

|-
| {{text_anchor|CONDITION_GHOST}} || || General
|| Checks if the creature is a ghost.

|-
| {{text_anchor|CONDITION_SYN_CLASS}} ||
* [[Syndrome#SYN_CLASS|SYN_CLASS]]
|| Syndrome || Changes graphics based on any syndromes the creature is affected by. Vanilla values include:
* ZOMBIE
* NECROMANCER
* VAMPCURSE
* RAISED_UNDEAD
* DISTURBED_DEAD
* GHOUL

|-
| {{text_anchor|CONDITION_TISSUE_LAYER}} ||
* BY_CATEGORY
* [[Body_token#CATEGORY|body part category]] or ALL
* [[Body_detail_plan_token#BP_LAYERS|tissue layer]] or ALL
|| Tissue
|| Selects a tissue layer to use for checking other conditions. Ex:
<code>[CONDITION_TISSUE_LAYER:BY_CATEGORY:ALL:SKIN]</code>

|-
| {{text_anchor|TISSUE_MIN_LENGTH}} ||
* integer
|| Tissue
|| Checks the current {{token|CONDITION_TISSUE_LAYER|g}}'s LENGTH [[Creature_token#TISSUE_LAYER_APPEARANCE_MODIFIER|appearance modifier]]. Is true if the LENGTH is greater than the integer input.

|-
| {{text_anchor|TISSUE_MAX_LENGTH}} ||
* integer
|| Tissue
|| Checks the current {{token|CONDITION_TISSUE_LAYER|g}}'s LENGTH [[Creature_token#TISSUE_LAYER_APPEARANCE_MODIFIER|appearance modifier]]. Is true if the LENGTH is less than the integer input.

|-
| {{text_anchor|TISSUE_MAY_HAVE_COLOR}} ||
* [[Color#Color_tokens|color token(s)]]
|| Tissue
|| Checks the selected tissue's color. Accepts multiple color tokens, and is true if the any of the colors is present in the selected tissues.

|-
| {{text_anchor|TISSUE_MAY_HAVE_SHAPING}} ||
* styling token
|| Tissue
|| Checks the current {{token|CONDITION_TISSUE_LAYER|g}}'s shaping (hairstyle). Valid tokens are NEATLY_COMBED, BRAIDED, DOUBLE_BRAIDS, PONY_TAILS, CLEAN_SHAVEN and STANDARD_HAIR/BEARD/MOUSTACHE/SIDEBURNS_SHAPINGS.{{verify}}

|-
| {{text_anchor|TISSUE_NOT_SHAPED}} || || Tissue
|| Checks the current {{token|CONDITION_TISSUE_LAYER|g}}'s color. Accepts multiple color tokens, and is true if the any of the colors is present in the selected tissues.

|-
| {{text_anchor|TISSUE_SWAP}} ||
* IF_MIN_CURLY
* integer
* tile page id
* x position
* y position
| Tissue
| Checks if a tissue is sufficiently curly, and if so swaps to display a different image. The new image is defined by the tile page ID, x position, and y position.

This condition should be within a [LAYER:... ] that has a similar graphic to the on in the TISSUE_SWAP.
The current {{token|CONDITION_TISSUE_LAYER|g}} group must also include a {{token|TISSUE_MIN_LENGTH|g}}.

|-
| {{text_anchor|ITEM_QUALITY}}{{version|50.13}} ||
* integer
| Armor Wieldables{{verify}}
|| Checks the current {{token|CONDITION_ITEM_WORN|g}}'s [[quality]]. 0 is base quality, 5 is masterwork. See [CONDITION_MATERIAL_FLAG:IS_CRAFTED_ARTIFACT] for [[artifact]]-quality items.

|-
| {{text_anchor|USE_PALETTE}}{{version|50.13}} ||
* layer set palette
* row
| General
|| Colors the layer using that row of the layer-set-specific {{token|LS_PALETTE|g}}.

|-
| {{text_anchor|USE_STANDARD_PALETTE_FROM_ITEM}}{{version|50.13}} || || Armor Wieldables{{verify}}
|| Uses the default palette to render the layer based on the [[Material definition token#STATE_COLOR|color]] of the current {{token|CONDITION_ITEM_WORN|g}}.

|-
| {{text_anchor|CONDITION_BP}}{{version|50.13}} ||
* selection criteria BY_TYPE, BY_CATEGORY, BY_TOKEN
* category, type, or token
| Body
|| Defines a body part graphic using standard [[body token]] selection criteria.

|-
| {{text_anchor|BP_APPEARANCE_MODIFIER_RANGE}}{{version|50.13}} ||
* QUALITY
* minimum
* maximum
| Body
|| Checks if current {{token|CONDITION_BP|g}}'s {{token|BP_APPEARANCE_MODIFIER|c}} falls within the chosen range.

|-
| {{text_anchor|BP_PRESENT}}{{version|50.13}} || || Body
|| Checks if the current {{token|CONDITION_BP|g}} is present and not destroyed, pulped, or severed. Can also be applied to {{token|LG_CONDITION_BP|g}}.

|-
| {{text_anchor|BP_SCARRED}}{{version|50.13}} || || Body
|| Checks if the current {{token|CONDITION_BP|g}} is scarred. Seems to also require {{token|BP_PRESENT|g}} to avoid illogical results. {{verify}}

|}

=== Vermin Conditions ===
Special Conditions for {{token|VERMIN|c}} creature graphics:

{| {{prettytable}}
|- bgcolor="#dddddd"
! Condition
! Description
|-
| {{text anchor|VERMIN}} || The default graphic for this vermin.

|-
| {{text anchor|VERMIN_ALT}} || Image cycles every 1 second.

|-
| {{text anchor|SWARM_SMALL}} || For swarming vermin like [[fly|flies]] and [[fairy|fairies]] in small groups.

|-
| {{text anchor|SWARM_MEDIUM}} || For swarming vermin like [[fly|flies]] and [[fairy|fairies]] in medium-sized groups.

|-
| {{text anchor|SWARM_LARGE}} || For swarming vermin like [[fly|flies]] and [[fairy|fairies]] in large groups.

|-
| {{text anchor|LIGHT_VERMIN}} || For [[firefly|fireflies]] etc. Does not replace {{token|VERMIN|g}}. However, [LIGHT_GEN] is bugged and does not work at the present time.

|-
| {{text anchor|LIGHT_VERMIN_ALT}} || Like {{token|VERMIN_ALT|g}} for [[firefly|fireflies]] etc. However, [LIGHT_GEN] is bugged and does not work at the present time.

|-
| {{text anchor|LIGHT_SWARM_SMALL}} || Unused. Would work for small sized swarms of light producing vermin, if [LIGHT_GEN] was working.

|-
| {{text anchor|LIGHT_SWARM_MEDIUM}} || Unused. Would work for medium sized swarms of light producing vermin, if [LIGHT_GEN] was working.

|-
| {{text anchor|LIGHT_SWARM_LARGE}} || Unused. Would work for large sized swarms of light producing vermin, if [LIGHT_GEN] was working.

|-
| {{text anchor|REMAINS}} || Vermin corpses.

|-
| {{text anchor|HIVE}} || Vermin hives.
|}

== Item Graphics ==
Item graphics can also be defined, but are mostly hardcoded. This section of the wiki needs to be fleshed out. Descriptions of the token functions is provisional.

Item graphics currently do not support LARGE_IMAGE.

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

|-
| {{text_anchor|TILE_GRAPHICS}}
|
* Tile page ID
* x index
* y index
* Item ID
| Begins defining tile graphics for an item. Sets default tile graphic.{{verify}}

|-
| {{text_anchor|BOULDER_GRAPHICS}}
|
* Tile page ID
* x index
* y index
* Material ID
| Defines tile graphics variants to use for BOULDER items by material; currently all boulders use material palette instead.

|-
| {{text_anchor|ROUGH_GEM_GRAPHICS}}
|
* Tile page ID
* x index
* y index
* Material ID
| Defines tile graphics variants to use for ROUGH (gem) items by material; currently all rough gems use material palette instead.

|-
| {{text_anchor|BARS_GRAPHICS}}
|
* Tile page ID
* x index
* y index
* Material ID or item ID
| Defines tile graphics variants to use for BAR items by material.

|-
| {{text_anchor|FOOD_GRAPHICS}}
|
* Tile page ID
* x index
* y index
* Item ID
| Defines tile graphics for FOOD items.

|-
| {{text_anchor|CHEESE_GRAPHICS}}
|
* Tile page ID
* x index
* y index
* Material ID
| Defines tile graphics variants to use for CHEESE items by material. Unused in vanilla raws.

|-
| {{text_anchor|ARMOR_GRAPHICS}}
|
* Tile page ID
* x index
* y index
* Item ID
| Defines tile graphics for ARMOR items; this is for items not being worn by a creature.

|-
| {{text_anchor|GLOVES_GRAPHICS}}
|
* Tile page ID
* x index
* y index
* Item ID
| Defines tile graphics for GLOVES items; this is for items not being worn by a creature.

|-
| {{text_anchor|HELM_GRAPHICS}}
|
* Tile page ID
* x index
* y index
* Item ID
| Defines tile graphics for HELM items; this is for items not being worn by a creature.

|-
| {{text_anchor|PANTS_GRAPHICS}}
|
* Tile page ID
* x index
* y index
* Item ID
| Defines tile graphics for PANTS items; this is for items not being worn by a creature.

|-
| {{text_anchor|SHOES_GRAPHICS}}
|
* Tile page ID
* x index
* y index
* Item ID
| Defines tile graphics for SHOES items; this is for items not being worn by a creature.

|-
| {{text_anchor|SHOES_GRAPHICS_METAL}}
|
* Tile page ID
* x index
* y index
* Item ID
| Defines metal material tile graphics variants for SHOES items; this is for items not being worn by a creature.

|-
| {{text_anchor|SHIELD_GRAPHICS}}
|
* Tile page ID
* x index
* y index
* Item ID
| Defines tile graphics for SHIELD items; this is for items not being worn by a creature.

|-
| {{text_anchor|SHIELD_GRAPHICS_WOODEN}}
|
* Tile page ID
* x index
* y index
* Item ID
| Defines wood material tile graphics variants for SHIELD items; this is for items not being worn by a creature.

|-
| {{text_anchor|TOY_GRAPHICS}}
|
* Tile page ID
* x index
* y index
* Item ID
* Material ID
| Defines tile graphics for TOY items. Material ID in this case is one of STONE, WOOD, METAL, or GLASS.

|-
| {{text_anchor|TRAPCOMP_GRAPHICS}}
|
* Tile page ID
* x index
* y index
* Item ID
| Defines tile graphics for TRAPCOMP items.

|-
| {{text_anchor|TRAPCOMP_GRAPHICS_WEAPON_TRAP}}
|
* Tile page ID
* x index
* y index
| Defines tile graphics for TRAPCOMP items when built into a weapon trap; must follow TRAPCOMP_GRAPHICS.

|-
| {{text_anchor|TRAPCOMP_GRAPHICS_UPRIGHT_#X}}
|
* Tile page ID
* x index
* y index
| Defines tile graphics for installed upright spike traps. These comprise two-tile graphics: # is replaced with the number of spikes, 1-10; X is replaced with T (for top graphic tile) or B (bottom graphic tile). This follows the tile graphics definition of either MENACINGSPIKE or SPEAR.

|-
| {{text_anchor|SIEGEAMMO_GRAPHICS}}
|
* Item ID
| Begins defining graphics for SIEGEAMMO items.

|-
| {{text_anchor|SIEGEAMMO_GRAPHICS_STRAIGHT_DEFAULT}}
|
* Tile page ID
* x index
* y index
| Defines graphics for ballista arrows aligned orthogonally on the map; follows SEIGEAMMO_GRAPHICS.

|-
| {{text_anchor|SIEGEAMMO_GRAPHICS_STRAIGHT_WOOD}}
|
* Tile page ID
* x index
* y index
| Wooden variant of above.

|-
| {{text_anchor|SIEGEAMMO_GRAPHICS_DIAGONAL_DEFAULT}}
|
* Tile page ID
* x index
* y index
| Defines graphics for ballista arrows aligned diagonally on the map; follows SEIGEAMMO_GRAPHICS.

|-
| {{text_anchor|SIEGEAMMO_GRAPHICS_DIAGONAL_WOOD}}
|
* Tile page ID
* x index
* y index
| Wood variant of above.

|-
| {{text_anchor|AMMO_GRAPHICS}}
|
* Item ID
| Begins defining graphics for AMMO items.

|-
| {{text_anchor|AMMO_GRAPHICS_STRAIGHT_DEFAULT}}
|
* Tile page ID
* x index
* y index
| Defines graphics for AMMO items aligned orthogonally on the map; follows AMMO_GRAPHICS.

|-
| {{text_anchor|AMMO_GRAPHICS_STRAIGHT_WOOD}}
|
* Tile page ID
* x index
* y index
| Wooden variant of above.

|-
| {{text_anchor|AMMO_GRAPHICS_DIAGONAL_DEFAULT}}
|
* Tile page ID
* x index
* y index
| Defines graphics for AMMO aligned diagonally on the map; follows AMMO_GRAPHICS.

|-
| {{text_anchor|AMMO_GRAPHICS_DIAGONAL_WOOD}}
|
* Tile page ID
* x index
* y index
| Wood variant of above.

|-
| {{text_anchor|WEAPON_GRAPHICS}}
|
* Item ID
| Begins defining graphics for WEAPON items.

|-
| {{text_anchor|WEAPON_GRAPHICS_DEFAULT}}
|
* Tile page ID
* x index
* y index
| Defines default graphics for WEAPON item defined by WEAPON_GRAPHICS not being worn by creatures; follows WEAPON_GRAPHICS.

|-
| {{text_anchor|WEAPON_GRAPHICS_MATERIAL}}
|
* Tile page ID
* x index
* y index
| Defines material palette{{verify}} graphics for WEAPON item defined by WEAPON_GRAPHICS not being worn by creatures; follows WEAPON_GRAPHICS.

|-
| {{text_anchor|WEAPON_GRAPHICS_WOOD_GROWN}}
|
* Tile page ID
* x index
* y index
| Defines graphics for grown-wood WEAPON item defined by WEAPON_GRAPHICS not being worn by creatures; follows WEAPON_GRAPHICS.

|-
| {{text_anchor|WEAPON_GRAPHICS_WOOD}}
|
* Tile page ID
* x index
* y index
| Defines graphics for wooden WEAPON item defined by WEAPON_GRAPHICS not being worn by creatures; follows WEAPON_GRAPHICS.

|-
| {{text_anchor|WEAPON_GRAPHICS_WEAPON_TRAP}}
|
* Tile page ID
* x index
* y index
| Defines graphics for WEAPON item defined by WEAPON_GRAPHICS as it appears installed in a weapon trap; follows WEAPON_GRAPHICS.

|-
| {{text_anchor|TOOL_GRAPHICS}}
|
* Tile page ID
* x index
* y index
* Item ID
| Defines default graphics for TOOL items; also begins defining variant graphics for material or container conditions when followed by tokens below.

|-
| {{text_anchor|ADD_TOOL_GRAPHICS}}
|
* Item ID
| Adds graphics to an existing tool defined with TOOL_GRAPHICS, followed by the tool graphics material or container condition tokens below.

|-
| {{text_anchor|TOOL_GRAPHICS_WOOD}}
|
* Variant index
* Tile page ID
* x index
* y index
| Defines additonal variant graphics for wooden TOOL items defined by TOOL_GRAPHICS; follows TOOL_GRAPHICS or ADD_TOOL_GRAPHICS. Requires seven variants; the resulting tool graphic is selected randomly from these (they can all point to the same tile index if desired).

|-
| {{text_anchor|TOOL_GRAPHICS_STONE}}
|
* Variant index
* Tile page ID
* x index
* y index
| Defines additonal variant graphics for stone TOOL items defined by TOOL_GRAPHICS; follows TOOL_GRAPHICS or ADD_TOOL_GRAPHICS. Requires seven variants; the resulting tool graphic is selected randomly from these (they can all point to the same tile index if desired).

|-
| {{text_anchor|TOOL_GRAPHICS_METAL}}
|
* Variant index
* Tile page ID
* x index
* y index
| Defines additonal variant graphics for metal TOOL items defined by TOOL_GRAPHICS; follows TOOL_GRAPHICS or ADD_TOOL_GRAPHICS. Requires seven variants; the resulting tool graphic is selected randomly from these (they can all point to the same tile index if desired).

|-
| {{text_anchor|TOOL_GRAPHICS_GLASS}}
|
* Variant index
* Tile page ID
* x index
* y index
| Defines additonal variant graphics for glass TOOL items defined by TOOL_GRAPHICS; follows TOOL_GRAPHICS or ADD_TOOL_GRAPHICS. Requires seven variants; the resulting tool graphic is selected randomly from these (they can all point to the same tile index if desired).

|-
| {{text_anchor|TOOL_GRAPHICS_CONTAINER_WOOD_LIQUID}}
|
* Tile page ID
* x index
* y index
| Defines graphics for wooden liquid-containing containers (empty); follows ADD_TOOL_GRAPHICS definition for container.

|-
| {{text_anchor|TOOL_GRAPHICS_CONTAINER_STONE_LIQUID}}
|
* Tile page ID
* x index
* y index
| Defines graphics for stone liquid-containing containers (empty); follows ADD_TOOL_GRAPHICS definition for container.

|-
| {{text_anchor|TOOL_GRAPHICS_CONTAINER_METAL_LIQUID}}
|
* Tile page ID
* x index
* y index
| Defines graphics for metal (and glass?) liquid-containing containers (empty); follows ADD_TOOL_GRAPHICS definition for container.

|-
| {{text_anchor|TOOL_GRAPHICS_CONTAINER_LIQUID}}
|
* Tile page ID
* x index
* y index
| Defines graphics for the liquid filling a liquid-containing container; follows TOOL_GRAPHICS_CONTAINER_*_LIQUID.

|-
| {{text_anchor|TOOL_GRAPHICS_CONTAINER_WOOD_ITEM}}
|
* Tile page ID
* x index
* y index
| Defines graphics for wooden containers holding items; follows ADD_TOOL_GRAPHICS definition for container.

|-
| {{text_anchor|TOOL_GRAPHICS_CONTAINER_STONE_ITEM}}
|
* Tile page ID
* x index
* y index
| Defines graphics for stone containers holding items; follows ADD_TOOL_GRAPHICS definition for container.

|-
| {{text_anchor|TOOL_GRAPHICS_CONTAINER_METAL_ITEM}}
|
* Tile page ID
* x index
* y index
| Defines graphics for metal (and glass?) containers holding items; follows ADD_TOOL_GRAPHICS definition for container.
|-
| {{text_anchor|TOOL_GRAPHICS_HIVE_BLD}}
|
* Tile page ID
* x index
* y index
| Defines the built item graphics for HIVE items.

|-
| {{text_anchor|TOOL_GRAPHICS_HIVE_BLD_IN_USE}}
|
* Tile page ID
* x index
* y index
| Defines the built item graphics for HIVE items that have hives installed.

|-
| {{text_anchor|TOOL_GRAPHICS_HIVE_PRODUCTS}}
|
* Tile page ID
* x index
* y index
| Defines the built item graphics for HIVE items that are ready to be harvested.

|-
| {{text_anchor|TOOL_GRAPHICS_SHAPE}}
|
* Shape ID
* Tile page ID
* x index
* y index
| Defines graphics for shaped items; currently used for dice.

|}

== World Map Graphics ==
World map graphics are defined in <code>[[Game_folders_and_files#Game_folder|Dwarf Fortress]]\data\vanilla\vanilla_world_map\graphics\graphics_world_map.txt</code>
Tokens that accept variants have 5 of them:

[TILE_GRAPHICS:<tile page identifier>:<x position>:<y position>:<TOKEN>:1]
[TILE_GRAPHICS:<tile page identifier>:<x position>:<y position>:<TOKEN>:2]
[TILE_GRAPHICS:<tile page identifier>:<x position>:<y position>:<TOKEN>:3]
[TILE_GRAPHICS:<tile page identifier>:<x position>:<y position>:<TOKEN>:4]
[TILE_GRAPHICS:<tile page identifier>:<x position>:<y position>:<TOKEN>:5]

Otherwise:

[TILE_GRAPHICS:<tile page identifier>:<x position>:<y position>:<TOKEN>]

==See Also==
*[[Creature token]]
*[[Syndrome]]
*[[Creature examples]]

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

Creature token

2024-06-17T23:32:51Z

DikbutDaGrate: More formatting

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

The <code>[OBJECT:CREATURE]</code> [[token]] begins the definition of a ''Dwarf Fortress'' [[creature]] [[raw file]]. Each creature definition that follows begins with the {{token|creature|c|creature ID}} token, and the creature's exact properties and behavior are then specified by the use of further creature tokens. All known creature tokens are listed below.

Vanilla creature definitions can be found in <code>[[Game folder|<Dwarf Fortress>]]\data\vanilla\vanilla_creatures\</code>.
Creature ID is also used with [[graphics token]]s to make customizable [[graphics set]]s.

The [[caste]] tokens allow defining sub-species within the broader creature definition, including true biological castes and lesser variations, such as sexes. Creature tokens can either be 'Creature' or 'CASTE-only' type which can only be applied to creature or cast respectively, or 'CASTE' which can be applied to both. In the table bellow, creature type distinguish tokens that can be applied to creature only, cast only and both ('creature', 'CASTE-only', and 'CASTE' respectively)

__NOTOC__
{{clear}}
{{alphabetical TOC|style=margin: 1em auto;}}

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

|-
| {{text anchor|ADOPTS_OWNER}}
| Caste
|
| Prevents tamed creature from being made available for adoption, instead allowing it to automatically adopt whoever it wants. The basic requirements for adoption are intact, and the creature will only adopt individuals who have a [[preference]] for their species. Used by [[cat]]s in the vanilla game. When {{k|v}}iewing a tame creature with this token, the message "This animal isn't interested in your wishes" will appear instead of "This [adorable] animal can't work" or "This animal is waiting to be trained".

|-
| {{text anchor|ALCOHOL_DEPENDENT}}
| Caste
|
| Makes the creature need [[alcohol]] to get through the working day; it will choose to drink booze instead of [[water]] if possible. Going sober for too long reduces speed.

|-
| {{text anchor|ALL_ACTIVE}}
| Caste
|
| Sets the creature to be active during the day, night, and twilight in Adventurer Mode. Seems to be a separate value from {{token|DIURNAL|c}}/{{token|NOCTURNAL|c}}/{{token|CREPUSCULAR|c}}, rather than implying them.{{verify|code}}

|-
| {{text anchor|ALTTILE}}
| Creature
|
*'character' or tile number
| If set, the creature will blink between its {{token|TILE|c}} and its ALTTILE.

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

|-
| {{text anchor|AMPHIBIOUS}}
| Caste
|
| Allows a creature to breathe both in and out of [[water]] (unlike {{token|AQUATIC|c}}) - does not prevent drowning in [[magma]].

|-
| {{text anchor|APP_MOD_DESC_RANGE}}
| Appearance Modifier
|
*Range (6 values, low to high)
| Based on info from [http://www.bay12forums.com/smf/index.php?topic=113762.msg3473069#msg3473069 Wannabehero on the forums]: When used with an appearance modifier token (BP_APPEARANCE_MODIFIER or BODY_APPEARANCE_MODIFIER), tells the game what numeric ranges to map to which descriptors.

The game uses 7 descriptor levels for each modifier, with the center one generally being to omit the thing from the creature description entirely. The six values in APP_MOD_DESC_RANGE define the boundaries between each described range. If this is not specified it uses the numbers 10:50:95:105:150:190.

|-
| {{text anchor|APP_MOD_GENETIC_MODEL}}
| Appearance Modifier
|
*Model (Accepts DOMINANT_MORE, DOMINANT_LESS, and MIX)
| Defines a genetic model for the relevant appearance modifier(s). May or may not do anything significant at present.

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

|-
| {{text anchor|APP_MOD_NOUN}}
| Appearance Modifier
|
*noun
*SINGULAR or PLURAL
| Creates a noun for the appearance, and whether it is singular or plural.

|-
| {{text anchor|APP_MOD_RATE}}
| Appearance Modifier
|
*Rate (integer)
*Scale (DAILY, YEARLY)
*min (growth)
*max (growth)
*start year
*start day
*end year
*end day
| Setting the growth rate of the modifier. The last two tokens can be replaced by NO_END to have growth continue indefinitely.

|-
| {{text anchor|APPLY_CREATURE_VARIATION}}
| Caste
|
*creature variation ID
*(optional) any amount of arbitrary arguments
| Applies the specified [[creature variation token|creature variation]]. See [[Creature_variation_token#Arguments_and_conditional_tokens]] for how the subsequent arguments may be used.

|-
| {{text anchor|APPLY_CURRENT_CREATURE_VARIATION}}
| Special
|
| Applies the effects of all pending {{token|CV_ADD_TAG|c}} and {{token|CV_REMOVE_TAG|c}} tokens that have been defined in the current creature.

|-
| {{text anchor|AQUATIC}}
| Caste
|
| Enables the creature to breathe in water, but causes it to air-drown on dry land.

|-
| {{text anchor|ARENA_RESTRICTED}}
| Caste
|
| Causes the creature to be excluded from the [[object testing arena]]'s creature spawning list. Typically applied to spoileriffic creatures.

|-
| {{text anchor|ARTIFICIAL_HIVEABLE}}
| Creature
|
| Enables the creature to be kept in artificial [[hive]]s by [[beekeeper]]s.

|-
| {{text anchor|AT_PEACE_WITH_WILDLIFE}}
| Caste
|
| Prevents the creature from attacking or frightening creatures with the {{Token|NATURAL|c}} tag.

|-
| {{text anchor|ATTACK}}
| Caste
|
*token
*selection criteria (it's complicated)
| Defines the attack name, and the body part used. See [[#Attack Tokens|below]] for valid subtokens
'''Example:''' 
<code>[ATTACK:GORE:BODYPART:BY_CATEGORY:HORN]</code> 
''GORE'' = name of the attack 
''BODYPART:BY_CATEGORY:HORN'' = the horn is used to attack (presuming the creature has one)

|-
| {{text anchor|ATTACK_TRIGGER}}
| Caste
|
*population
*exported wealth
*created wealth
| Specifies when a [[megabeast]] or [[semi-megabeast]] will attack the fortress. The attacks will start occurring when all of the requirements are met. Setting a value to 0 disables the trigger.

|}

{{alphabetical TOC|style=margin: 1em auto;}}

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

|-
| {{text anchor|BABY}}
| Caste
|
*integer
| Age at which creature is considered a child, the default is zero. One can think of this as the duration of the baby stage.

|-
| {{text anchor|BABYNAME}}
| Caste
|
*singular
*plural
| Defines a new name for a creature in baby state at the caste level. For non-caste-specific baby names, see {{token|GENERAL_BABY_NAME|c}}.

|-
| {{text anchor|BEACH_FREQUENCY}}
| Caste
|
*integer
| Creature may be subject to [[beaching]], becoming stranded on [[Beach|shores]], where they will eventually air-drown. The number indicates the frequency of the occurrence. Presumably requires the creature to be {{token|AQUATIC|c}}. Used by [[orca]]s, [[sperm whale]]s and [[sea nettle jellyfish]] in the vanilla game.

|-
| {{text anchor|BENIGN}}
| Caste
|
| The creature is non-aggressive by default, and will never automatically be engaged by companions or soldiers, running away from any creatures that are not friendly to it, and will only defend itself if it becomes enraged. Can be thought of as the counterpoint of the {{token|LARGE_PREDATOR|c}} tag. When tamed, animals with this tag will be useless for fortress defense.

This and {{token|TRADE_CAPACITY|c}} are required for {{token|PACK_ANIMAL|c}} to function properly, if an animal contains the aforementioned requirements without this tag: items loaded by the merchants will be dropped upon departure.

|-
| {{text anchor|BIOME}}
| Creature
|
* [[biome token]]
| Select a [[biome]] the creature may appear in.

|-
| {{text anchor|BLOOD}}
| Caste
|
* <[[material token]]>
* <[[Material_definition_token#Material_States|material state]]>
| Specifies what the creature's blood is made of.

|-
| {{text anchor|BLOODSUCKER}}
| Caste
|
| Causes [[vampire]]-like behaviour; the creature will suck the [[Creature_token#BLOOD|blood]] of unconscious victims when its [[Syndrome#TIME_SINCE_SUCKED_BLOOD|thirst for blood]] grows sufficiently large. When controlling the creature in adventure mode, this can be done at will. Seems to be required to make the creature denouncable (in-world) as a creature of the night.

|-
| {{text anchor|BODY}}
| Caste
|
*body parts
| Draws body parts from OBJECT:BODY files (such as body_default.txt)
'''Example:''' 
[BODY:BODY_WITH_HEAD_FLAG:HEART:GUTS:BRAIN:MOUTH] 
This is the body from a [[purring maggot]]. It creates a body with head, a heart, some guts, a brain, and a mouth. That's all a maggot needs.

The body parts need to be listed in an order such that any parent part appears before its connected children. For example [BODY:HEART:BODY_WITH_HEAD_FLAG] produces a "Body Token Recognized But Could Not Connect: HEART" error because HEART can't find any UPPERBODY(s) to connect to. Switching the order to [BODY:BODY_WITH_HEAD_FLAG:HEART] fixes the problem because now the UPPERBODY is created before the HEART tries to connect to it.

'''If the body is left undefined, the creature (or caste) will be tagged as [DOES_NOT_EXIST].''' {{verify}}

|-
| {{text anchor|BODY_APPEARANCE_MODIFIER}}
| Caste
|
*ATTRIBUTE
*lowest
*lower
*low
*median
*high
*higher
*highest
| These body modifiers give individual creatures different characteristics. In the case of HEIGHT, BROADNESS and LENGTH, the modifier is also a percentage change to the BODY_SIZE of the individual creature. The seven numbers afterward give a distribution of ranges. Each interval has an equal chance of occurring.
'''Example:''' 
[BODY_APPEARANCE_MODIFIER:HEIGHT:90:95:98:100:102:105:110] 
''HEIGHT'' : marks the height to be changed 
''90:95:98:100:102:105:110'' : sets the range from the shortest (90% of the average height) to the tallest (110% of the average height) creature variation.

|-
| {{text anchor|BODY_DETAIL_PLAN}}
| Caste
|
*PlanName
*Arguments
| Loads a plan from 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:''' 
[BODY_DETAIL_PLAN:VERTEBRATE_TISSUE_LAYERS:SKIN:FAT:MUSCLE:BONE:CARTILAGE] 
This creates the detailed body of a [[fox]], the skin, fat, muscle, bones and cartilage out of the vertebrate tissues. 
A [[Purring maggot|maggot]] would only need: 
''[BODY_DETAIL_PLAN:EXOSKELETON_TISSUE_LAYERS:SKIN:FAT:MUSCLE]''

|-
| {{text anchor|BODY_SIZE}}
| Caste
|
*years
*days
*size
| Sets size at a given age. Size is in cubic centimeters, and for normal body materials, is roughly equal to the creature's average weight in grams.
'''Example:''' 
[BODY_SIZE:0:0:10000] 
[BODY_SIZE:1:168:50000] 
[BODY_SIZE:12:0:220000] 
This describes the size of a [[minotaur]]. Its birth size would be 10,000 cm3 (~10 kg). At 1 year and 168 days old it would be 50,000 cm3 (~50 kg). And as an adult (at 12 years old) it would be 220,000 cm3 and weigh roughly 220 kg.

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

|-
| {{text anchor|BONECARN}}
| Caste
|
| Creature eats bones. Implies {{token|CARNIVORE|c}}. [[Adventurer mode|Adventurers]] with this token are currently unable to eat bones.{{Bug|11069}}

|-
| {{text anchor|BP_ADD_TYPE}}
| Caste
|
| Adds a type to a body part - used with {{token|SET_BP_GROUP|c}}. In vanilla DF, this is used for adding the type '[[Body token#GELDABLE|GELDABLE]]' to the lower body of certain [[cat|creatures]].

|-
| {{text anchor|BP_APPEARANCE_MODIFIER}}
| Caste
|
*QUALITY
*lowest
*lower
*low
*median
*high
*higher
*highest
| Sets up the breadth of possibilities for appearance qualities for a selected BP group. EG. Eyes (CLOSE_SET, DEEP_SET, ROUND_VS_NARROW, LARGE_IRIS),Lips (THICKNESS), Nose (BROADNESS, LENGTH, UPTURNED, CONVEX), Ear (SPLAYED_OUT, HANGING_LOBES, BROADNESS, HEIGHT), Tooth (GAPS), Skull (HIGH_CHEEKBONES, BROAD_CHIN, JUTTING CHIN, SQUARE_CHIN), Neck (DEEP_VOICE, RASPY_VOICE), Head (BROADNESS, HEIGHT)

|-
| {{text anchor|BP_REMOVE_TYPE}}
| Caste
|
| Removes a type from a body part. Used with {{token|SET_BP_GROUP|c}}.

|-
| {{text anchor|BUILDINGDESTROYER}}
| Caste
|
*1 or 2
| Allows a creature to destroy furniture and buildings. Value [1] targets mostly doors, hatches, furniture and the like. Value [2] targets anything not made with the {{k|b}} + {{k|C}} commands.
|}

{{alphabetical TOC|style=margin: 1em auto;}}

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

|-
| {{text anchor|CAN_DO_INTERACTION}}
| Caste
|
*interaction token
| The creature can perform an interaction. See [[interaction token]].

|-
| {{text anchor|CAN_LEARN}}
| Caste
|
| The creature gains [[skill]]s and can have [[labor|professions]]. If a member of a civilization (even a pet) has this token, it'll need to eat, drink and sleep. Note that this token makes the creature unable to be eaten by an adventurer, so it is not recommended for uncivilized monsters. Adventurers lacking this token can allocate but not increase attributes and skills. Skills allocated will disappear on start.

|-
| {{text anchor|CAN_SPEAK}}
| Caste
|
| Can [[talking|talk]]. Note that this is not necessary for a creature to gain social skills.

|-
| {{text anchor|CANNOT_CLIMB}}
| Caste
|
| Creature cannot [[climber|climb]], even if it has free grasp parts.

|-
| {{text anchor|CANNOT_JUMP}}
| Caste
|
| Creature cannot [[jump]].

|-
| {{text anchor|CANNOT_UNDEAD}}
| Caste
|
| Acts like {{token|NOT_LIVING|c}}, except that {{token|OPPOSED_TO_LIFE|c}} creatures will attack them.

|-
| {{text anchor|CANOPENDOORS}}
| Caste
|
| Allows the creature to open [[door]]s that are set to be unpassable for pets. In adventure mode, creatures lacking this token will be unable to pass through door tiles except whilst these are occupied by other creatures. Not currently useful in Fortress mode as doors can no longer be set unpassable for pets.{{version|50.03}}

|-
| {{text anchor|CARNIVORE}}
| Caste
|
| Creature ''only'' eats [[meat]]. If the creature goes on rampages in worldgen, it will often devour the people/animals it kills. Does not seem to affect the diet of the adventurer in adventure mode.

|-
| {{text anchor|CASTE}}
| Creature
|
*name
| Defines a [[caste]].

|-
| {{text anchor|CASTE_ALTTILE}}
| Caste
|
*tile number or "letter"
| Caste-specific {{token|ALTTILE|c}}. Requires {{token|CASTE_TILE|c}}.

|-
| {{text anchor|CASTE_COLOR}}
| Caste
|
*fg
*bg
*brightness
| Caste-specific {{token|COLOR|c}}.

|-
| {{text anchor|CASTE_GLOWCOLOR}}
| Caste
|
*fg
*bg
*brightness
| Caste-specific {{token|GLOWCOLOR|c}}.

|-
| {{text anchor|CASTE_GLOWTILE}}
| Caste
|
*tile value or "letter"
| Caste-specific {{token|GLOWTILE|c}}.

|-
| {{text anchor|CASTE_NAME}}
| Caste
|
*singular
*plural
*adjective
| While {{token|NAME|c}} describes the name of the species, {{token|CASTE_NAME|c}} names individuals of the species. Unlike other caste-specific descriptions, this token is required, even for creatures without separate castes. If left undefined, the creature will not show up in the [[arena]] and members of the species will be labeled as "nothing".

|-
| {{text anchor|CASTE_PROFESSION_NAME}}
| Caste
|
*[[Unit type token]] (Profession)
*singular
*plural
| Caste-specific {{token|PROFESSION_NAME|c}}.

|-
| {{text anchor|CASTE_SOLDIER_ALTTILE}}
| Caste
|
*'character' or tile number
| Caste-specific {{token|SOLDIER_ALTTILE|c}}. Requires {{token|CASTE_SOLDIER_TILE|c}}.

|-
| {{text anchor|CASTE_SOLDIER_TILE}}
| Caste
|
*'character' or tile number
| Caste-specific {{token|CREATURE_SOLDIER_TILE|c}}.

|-
| {{text anchor|CASTE_TILE}}
| Caste
|
* tile number or "letter"
| Caste-specific {{token|CREATURE_TILE|c}}.

|-
| {{text anchor|CAVE_ADAPT}}
| Caste
|
| Gives the creature a bonus in caves. Also causes [[cave adaptation]].

|-
| {{text anchor|CDI}}
| Caste
|
*Varies
| Specifies interaction details following a {{token|CAN_DO_INTERACTION|c}} token. See [[interaction token]].

|-
| {{text anchor|CHANGE_BODY_SIZE_PERC}}
| Caste
|
*integer
| Multiplies body size by a factor of (integer)%. 50 halves size, 200 doubles.

|-
| {{text anchor|CHANGE_FREQUENCY_PERC}}
| Creature
|
*integer
| Multiplies frequency by a factor of (integer)%.

|-
| {{text anchor|CHILD}}
| Caste
|
*integer
| Age at which creature is considered an adult - one can think of this as the duration of the [[children|child]] stage. Allows the creature's offspring to be rendered fully tame if [[animal trainer|trained]] during their childhood.

|-
| {{text anchor|CHILDNAME}}
| Caste
|
*singular
*plural
| Defines a new name for a creature in the child state at the caste level. For non-caste-specific child names, see {{token|GENERAL_CHILD_NAME|c}}.

|-
| {{text anchor|CLUSTER_NUMBER}}
| Creature
|
*min
*max
| The minimum/maximum numbers of how many creatures per spawned cluster. Vermin fish with this token in combination with temperate ocean and river biome tokens [http://www.bay12forums.com/smf/index.php?topic=51864.msg1122319#msg1122319 will perform seasonal migrations]. Defaults to 1:1 if not specified.

|-
| {{text anchor|CLUTCH_SIZE}}
| Caste
|
*min
*max
|Number of [[egg]]s laid in one sitting.

|-
| {{text anchor|COLONY_EXTERNAL}}
| Caste
|
| Caste hovers around colony.

|-
| {{text anchor|COLOR}}
| Creature
|
*foreground
*background
*brightness
| Color of the creature's tile. See [[Color]] for usage.

|-
| {{text anchor|COMMON_DOMESTIC}}
| Caste
|
| When combined with any of {{token|PET|c}}, {{token|PACK_ANIMAL|c}}, {{token|WAGON_PULLER|c}} and/or {{token|MOUNT|c}}, the creature is guaranteed to be domesticated by any [[civilization]] with {{token|COMMON_DOMESTIC_PET|e}}, {{token|COMMON_DOMESTIC_PACK|e}}, {{token|COMMON_DOMESTIC_PULL|e}} and/or {{token|COMMON_DOMESTIC_MOUNT|e}} respectively. Such civilizations will always have access to the creature, even in the absence of wild populations. This token is invalid on {{token|FANCIFUL|c}} creatures.

|-
| {{text anchor|CONVERTED_SPOUSE}}
| Caste
|
| Creatures of this caste's species with the {{token|SPOUSE_CONVERTER|c}} and {{token|NIGHT_CREATURE_HUNTER|c}} tokens will kidnap {{token|SPOUSE_CONVERSION_TARGET|c}}s of an appropriate sex and convert them into castes with CONVERTED_SPOUSE.

|-
| {{text anchor|COOKABLE_LIVE}}
| Caste
|
| Set this to allow the creature to be cooked in meals without first being butchered/cleaned. Used by some water-dwelling vermin such as [[mussel]]s, [[nautilus]]es and [[oyster]]s.

|-
| {{text anchor|CRAZED}}
| Caste
|
| Creature is '[[insanity|berserk]]' and will attack all other creatures, except members of its own species that '''also''' have the CRAZED tag. It will show {{DFtext|Berserk|4:1}} in the [[unit list]]. Berserk creatures go on rampages during [[world generation|worldgen]] much more frequently than non-berserk ones.

|-
| {{text anchor|COPY_TAGS_FROM}}
| Special
|
*creature ID
| Copies another specified creature. This will override any definitions made before it; essentially, it makes this creature identical to the other one, which can then be modified. Often used in combination with {{token|APPLY_CREATURE_VARIATION|c}} to import standard variations from a file. The vanilla [[giant animal]]s and [[animal person|animal people]]s are examples of this token combination.

|-
| {{text anchor|CREATURE}}
| Creature
|
*creature ID
| A unique, arbitrary identifier that begins the definition of each new creature, and is used to reference the creature in other tokens and raws.

|-
| {{text anchor|CREATURE_CLASS}}
| Caste
|
*classname
| An arbitrary creature classification. Can be set to anything, but the only vanilla uses are GENERAL_POISON (used in syndromes), EDIBLE_GROUND_BUG (used as targets for {{token|GOBBLE_VERMIN_CLASS|c}}), MAMMAL, and POISONOUS (both used for kobold pet eligibility). A single creature can have multiple classes.

The full list of tokens that use creature classes is:

* Creature tokens: {{token|GOBBLE_VERMIN_CLASS|c}}, {{token|GOBBLE_VERMIN_CLASS|c}}
* Interaction tokens: {{token|IT_AFFECTED_CLASS|in}}, {{token|IT_IMMUNE_CLASS|in}}
* Animal definition (Entity) tokens: {{token|ANIMAL_CLASS|e}}, {{token|ANIMAL_FORBIDDEN_CLASS|e}}
* Position (Entity) token: {{token|ALLOWED_CLASS|po}}
* Syndrome tokens: {{token|SYN_AFFECTED_CLASS|sy}}, {{token|SYN_IMMUNE_CLASS|sy}}, {{token|CE_SENSE_CREATURE_CLASS|sy}}
|-
| {{text anchor|CREATURE_SOLDIER_TILE}}
| Creature
|
*'character' or tile number
| Creatures active in their civilization's [[military]] will use this tile instead.

|-
| {{text anchor|CREATURE_TILE}}
| Creature
|
*'character' or tile number
| The symbol of the creature in ASCII mode.

|-
| {{text anchor|CREPUSCULAR}}
| Caste
|
| Sets the creature to be active at twilight in adventurer mode.

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

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

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

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

|-
| {{text anchor|CV_REMOVE_TAG}}
| Special
|
*TAG NAME
| Removes a tag. Used in conjunction with creature variation templates.
|}

{{alphabetical TOC|style=margin: 1em auto;}}

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

|-
| {{text anchor|DEMON}}
| Caste
|
| Found on generated [[demon]]s. Marks the caste to be used in the initial wave after breaking into the [[underworld]], and by the demon civilizations created during world-gen breachings{{verify}}.

|-
| {{text anchor|DESCRIPTION}}
| Caste
|
*text
| A brief description of the creature type, as displayed when viewing the creature's description/[[Thoughts and preferences|thoughts & preferences]] screen.

|-
| {{text anchor|DIE_WHEN_VERMIN_BITE}}
| Caste
|
| Causes the creature to die upon attacking. Used by [[honey bee]]s to simulate them dying after using their stingers.

|-
| {{text anchor|DIFFICULTY}}
| Caste
|
*integer
| Increases experience gain during adventure mode. Creatures with a difficulty of 11 or higher are not assigned for quests in adventure mode.

|-
| {{text anchor|DIURNAL}}
| Caste
|
| Sets the creature to be active during the day in Adventurer Mode.

|-
| {{text anchor|DIVE_HUNTS_VERMIN}}
| Caste
|
| The creature hunts vermin by diving from the air. On tame creatures, it has the same effect as {{token|HUNTS_VERMIN|c}}. Found on [[peregrine falcon]]s.

|-
| {{text anchor|DOES_NOT_EXIST}}
| Creature
|
| Adding this token to a creature prevents it from appearing in generated worlds (unless it's marked as [[Entity_token#ANIMAL_ALWAYS_PRESENT|always present]] for a particular civilisation). For example, adding it to [[dog]]s will lead to worlds being generated without dogs in them. Also removes the creature from the [[object testing arena]]'s spawn list. If combined with {{token|FANCIFUL|c}}, artistic depictions of the creature will occur regardless. Used by [[centaur]]s, [[chimera]]s and [[griffon]]s in the vanilla game.

Note: a creature tagged as DOES_NOT_EXIST can still be [[Interaction_token#I_EFFECT|summoned]] successfully, as long as it has a body defined in its raws. [http://www.bay12forums.com/smf/index.php?topic=165213.msg8086938#msg8086938]. It's also possible for another creature to [[Syndrome#CE_BODY_TRANSFORMATION|transform]] into it.
|}

{{alphabetical TOC|style=margin: 1em auto;}}

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

|-
| {{text anchor|EBO_ITEM}}
| Caste
|
*[[item token]]
*[[material token]] (ANY_HARD_STONE can be used for the material)
| Defines the item that the creature drops upon being [[butcher|butchered]]. Used with {{token|EXTRA_BUTCHER_OBJECT|c}}.

|-
| {{text anchor|EBO_SHAPE}}
| Caste
|
*gem shape
| The shape of the creature's extra [[butcher|butchering]] drop. Used with {{token|EXTRA_BUTCHER_OBJECT|c}}.

|-
| {{text anchor|EGG_MATERIAL}}
| Caste
|
* <[[material token]]>
* <[[Material_definition_token#Material_States|material state]]>
| Defines the material composition of [[egg]]s laid by the creature. [[creature_token#LAYS_EGGS|Egg-laying]] creatures in the default game define this 3 times, using LOCAL_CREATURE_MAT:EGGSHELL, LOCAL_CREATURE_MAT:EGG_WHITE, and then LOCAL_CREATURE_MAT:EGG_YOLK. Eggs will be made out of eggshell. Edibility is determined by tags on whites or yolk, but they otherwise do not exist.

|-
| {{text anchor|EGG_SIZE}}
| Caste
|
*size
| Determines the size of laid [[egg]]s. Doesn't affect hatching or cooking, but bigger eggs will be heavier, and may take longer to be hauled depending on the hauler's strength.

|-
| {{text anchor|EQUIPMENT_WAGON}}
| Creature
|
| Makes the creature appear as a large 3×3 [[wagon]] responsible for carrying trade goods, pulled by two {{token|WAGON_PULLER|c}} creatures and driven by a merchant.

|-
| {{text anchor|EQUIPS}}
| Caste
|
| Allows the creature to wear or wield items.

|-
| {{text anchor|EVIL}}
| Creature
|
| The creature is considered evil and will only show up in evil biomes. Civilizations with {{token|USE_EVIL_ANIMALS|e}} can domesticate them regardless of exotic status. Has no effect on cavern creatures except to restrict taming. A civilization with evil creatures can colonise evil areas.

|-
| {{text anchor|EXTRA_BUTCHER_OBJECT}}
| Caste
|
* BY_CATEGORY, BY_TYPE, BY_TOKEN
* TYPE, CATEGORY, or TOKEN
| The creature drops an additional object when [[butcher|butchered]], as defined by {{token|EBO_ITEM|c}} and {{token|EBO_SHAPE|c}}. Used for [[gizzard stone]]s in default creatures. For some materials, needs to be defined after caste definitions with SELECT_CASTE:ALL{{Bug|6355}}

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

|-
| {{text anchor|EXTRAVISION}}
| Caste
|
| The creature can see regardless of whether it has working eyes and has full 360 degree vision, making it impossible to strike the creature from a blind spot in combat. Invisible creatures will also be seen, namely [[intelligent undead]] using a "vanish" power.
|}

{{alphabetical TOC|style=margin: 1em auto;}}

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

|-
| {{text anchor|FANCIFUL}}
| Creature
|
| The creature is a thing of legend and known to all civilizations. Its materials cannot be requested or preferred. The tag also adds some art value modifiers. Used by a [[Fanciful|number of creatures]]. Conflicts with {{token|COMMON_DOMESTIC|c}}.

|-
| {{text anchor|FEATURE_ATTACK_GROUP}}
| Caste
|
| Found on [[Animal people#Subterranean animal people|subterranean animal-man]] tribals. Currently defunct. In previous versions{{verify}}, it caused these creatures to crawl out of chasms and underground rivers.

|-
| {{text anchor|FEATURE_BEAST}}
| Caste
|
| Found on [[forgotten beast]]s. Presumably makes it act as such, initiating underground attacks on fortresses, or leads to the pop-up message upon encountering one{{verify}}. Hides the creature from displaying in a world_sites_and_pops file. Does not create historical figures like generated forgotten beasts do.

Requires specifying a {{token|BIOME|c}} in which the creature will live, and both surface and subterranean biomes are allowed. Does not stack with {{token|LARGE_ROAMING|c}} and if both are used the creature will not spawn. Appears to be incompatible with {{token|DEMON|c}} even if used in separate castes.

|-
| {{text anchor|FEMALE}}
| Caste
|
| Makes the creature biologically female, enabling her to [[Breeding|bear young]]. Usually specified inside a caste.

|-
| {{text anchor|FIREIMMUNE}}
| Caste
|
| Makes the creature immune to [[Interaction_token#FIREBALL|FIREBALL]] and [[Interaction_token#FIREJET|FIREJET]] attacks, and allows it to path through high temperature zones, like lava or fires. Does not, by itself, make the creature immune to the damaging effects of burning in [[fire]], and does not prevent general heat damage or melting on its own (this would require adjustments to be made to the creature's body [[Material_definition_token|materials]] - see the [[Dragon/raw|dragon raws]] for an example).

|-
| {{text anchor|FIREIMMUNE_SUPER}}
| Caste
|
| Like {{token|FIREIMMUNE|c}}, but also renders the creature immune to [[Interaction_token#DRAGONFIRE|DRAGONFIRE]] attacks.

|-
| {{text anchor|FISHITEM}}
| Caste
|
| The creature's corpse is a single [[Item_token#FISH_RAW|FISH_RAW]] food item that needs to be cleaned (into a [[Item_token#FISH|FISH]] item) at a [[fishery]] to become edible. Before being cleaned the item is referred to as "raw". The food item is categorized under "fish" on the food and stocks screens, and when uncleaned it is sorted under "raw fish" in the stocks (but does not show up on the food screen).
Without this or {{token|COOKABLE_LIVE|c}}, [[fishing|fished]] vermin will turn into food the same way as non-vermin creatures, resulting in multiple units of food (meat, brain, lungs, eyes, spleen etc.) from a single fished vermin. These units of food are categorized as meat by the game.

|-
| {{text anchor|FIXED_TEMP}}
| Caste
|
*temperature
| The creature's body is constantly at this temperature, heating up or cooling the surrounding area. Alters the temperature of the creature's inventory and all adjacent tiles, [[Temperature|with all the effects that this implies]] - may trigger wildfires at high enough values. Also makes the creature immune to extreme heat or cold, as long as the temperature set is not harmful to the materials that the creature is made from. Corpses and body parts of creatures with a fixed temperature maintain their temperature even after death.

Note that temperatures of 12000 and higher may cause [[path|pathfinding]] issues in fortress mode.

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

|-
| {{text anchor|FLIER}}
| Caste
|
| Allows a creature to fly, independent of it having wings or not. Fortress Mode pathfinding only partially incorporates flying - flying creatures need a land path to exist between them and an area in order to access it, but as long as one such path exists, they do not need to use it, instead being able to fly over intervening obstacles. Winged creatures with this token can lose their ability to fly if their wings are crippled or severed. Winged creatures without this token will be unable to fly. (A 'wing' in this context refers to any body part with its own [[Body_token#FLIER|FLIER]] token).

|-
| {{text anchor|FREQUENCY}}
| Creature
|
*number, max 100
| Determines the chances of a creature appearing within its environment, with higher values resulting in more frequent appearance. Also affects the chance of a creature being brought in a caravan for trading.
This value is used multiply to determine the rarity of animal populations. A creature with [FREQUENCY:50] will appear in 50% of valid biomes, and be present in 50% of the area within those biomes.
When a [[Creature token#CLUSTER_NUMBER|cluster]] spawns, the game effectively considers all creatures that can possibly appear and uses the FREQUENCY value as a ''weight'' - for example, if there are three creatures with frequencies 10/25/50, the creature with [FREQUENCY:50] will appear approximately 58.8% of the time. Defaults to 50 if not specified. Not to be confused with {{token|POP_RATIO|c}}.
|}

{{alphabetical TOC|style=margin: 1em auto;}}

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

|-
| {{text anchor|GAIT}}
| Caste
|
* <gait type>
* <gait name>
* <max [[Gait#Speed|speed]]>
* <build up time>
* <max turning [[Gait#Speed|speed]]>
* <start [[Gait#Speed|speed]]>
* <energy expenditure>
* <gait flag(s)>
| Defines a gait by which the creature can move. See [[Gait]] for more information. Specifically, you likely want to use one of the existing STANDARD_X_GAITS creature variations, as described in [[Gait#Gaits_and_Modding|this subsection]].

* <max speed> indicates the maximum [[Gait#Speed|speed]] achievable by a creature using this gait
* <start speed> indicates the creature's speed when it starts moving using this gait
* <build up time> indicates how long it will take for a creature using this gait to go from <start speed> to <max speed>. For example, a value of 10 means that it should be able to reach the maximum speed by moving 10 [[tile]]s in a straight line over even terrain.
* <max turning speed> indicates the maximum speed permissible when the creature suddenly changes its direction of motion. The creature's speed will be reduced to <max turning speed> if travelling at a higher speed than this before turning.
* <energy expenditure> indicates how energy-consuming the gait is. Higher values cause the creature to tire out faster. Persistent usage of a high-intensity gait will eventually lead to exhaustion and [[Status_icon#Non-flashing|collapse]].

'''NO_BUILD_UP''' can be specified instead of a <start speed> value to make the <max speed> instantly achievable upon initiating movement (this is equivalent to a <build up time> of 0). Note that <build up time> and <max turning speed> are both ignored if specified alongside this (as NO_BUILD_UP trumps <build up time> and preserves <max speed> whilst turning, and <max turning speed> cannot exceed <max speed>) so it is permissible to omit them so long as they are '''both''' omitted together.

It's possible to specify a <start speed> greater than the <max speed>; the moving creature will decelerate towards its <max speed> in this case.

'''valid gait types:'''
*'''WALK''' 
Used for moving normally over ground tiles.

*'''CRAWL''' 
Used for moving over ground tiles whilst [[Status_icon#Non-flashing|prone]].

*'''SWIM''' 
Used for moving through tiles containing [[water]] or [[magma]] at a [[Water#Depth|depth]] of at least 4/7.

*'''FLY''' 
Used for moving through [[open space]].

*'''CLIMB''' 
Used for moving whilst [[Climber|climbing]].

'''valid gait flags:'''
* '''AGILITY''' 
Speeds/slows movement depending on the creature's [[Attribute#Agility|Agility]] stat.

* '''STRENGTH''' 
Speeds/slows movement depending on the creature's [[Attribute#Strength|Strength]] stat.

* '''LAYERS_SLOW''' 
Makes [[Tissue_definition_token#THICKENS_ON_ENERGY_STORAGE|THICKENS_ON_ENERGY_STORAGE]] and [[Tissue_definition_token#THICKENS_ON_STRENGTH|THICKENS_ON_STRENGTH]] tissue layers slow movement depending on how thick they are. Adding the STRENGTH gait flag counteracts the impact of the latter layer.

* '''STEALTH_SLOWS:'''<percentage> 
Slows movement by the specified percentage when the creature is [[Ambusher|sneaking]].

|-
| {{text anchor|GENERAL_BABY_NAME}}
| Creature
|
*singular
*plural
| Like {{token|BABYNAME|c}}, but applied regardless of caste.

|-
| {{text anchor|GENERAL_CHILD_NAME}}
| Creature
|
*singular
*plural
| Like {{token|CHILDNAME|c}}, but applied regardless of caste.

|-
| {{text anchor|GENERAL_MATERIAL_FORCE_MULTIPLIER}}
| Caste
|
*value A
*value B
| Has the same function as {{token|MATERIAL_FORCE_MULTIPLIER|c}}, but applies to all attacks instead of just those involving a specific material. Appears to be overridden by MATERIAL_FORCE_MULTIPLIER ([[werebeast]]s, for example, use both tokens to provide resistance to all materials, with one exception to which they are especially vulnerable).

|-
| {{text anchor|GENERATED}}
| Creature
|
| Found on procedurally generated creatures like [[forgotten beast]]s, [[titan]]s, [[demon]]s, [[angel]]s, and [[night creature]]s. Cannot be specified in user-defined raws.

|-
| {{text anchor|GETS_INFECTIONS_FROM_ROT}}
| Caste
|
| Makes the creature get [[Health_care#Infection|infections]] from necrotic tissue.

|-
| {{text anchor|GETS_WOUND_INFECTIONS}}
| Caste
|
| Makes the creature's wounds become [[Health_care#Infection|infected]] if left untreated for too long.

|-
| {{text anchor|GLOWCOLOR}}
| Creature
|
*foreground
*background
*brightness
| The colour of the creature's {{token|GLOWTILE|c}}.

|-
| {{text anchor|GLOWTILE}}
| Creature
|
*ascii character
| If present, the being glows in the dark (generally used for Adventurer 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 {{token|CASTE_GLOWTILE|c}} instead.

|-
| {{text anchor|GNAWER}}
| Caste
|
*verb
| The creature can and will gnaw its way out of [[animal trap]]s and [[cage]]s using the specified verb, depending on the material from which it is made (normally wood).

|-
| {{text anchor|GOBBLE_VERMIN_CLASS}}
| Caste
|
*class
| The creature eats vermin of the specified class.

|-
| {{text anchor|GOBBLE_VERMIN_CREATURE}}
| Caste
|
*creature
*caste
| The creature eats a specified [[vermin]].

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

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

|-
| {{text anchor|GO_TO_TAG}}
| Special
|
| When using tags from an existing creature, inserts new tags ''before'' the specified tag.

|-
| {{text anchor|GOOD}}
| Creature
|
| Creature is considered good and will only show up in good biomes - [[unicorn]]s, for example. Civilizations with {{token|USE_GOOD_ANIMALS|e}} can domesticate them regardless of exotic status. Has no effect on cavern creatures except to restrict taming. A civilization that has good creatures can colonise good areas in world-gen.

|-
| {{text anchor|GRASSTRAMPLE}}
| Caste
|
*value
| The value determines how rapidly [[grass]] is trampled when a creature steps on it - a value of 0 causes the creature to never damage grass, while a value of 100 causes grass to be trampled as rapidly as possible. Defaults to 5.

|-
| {{text anchor|GRAVITATE_BODY_SIZE}}
| Caste
|
*target value
| Used in Creature Variants. This token changes the adult body size to the average of the old adult body size and the target value and scales all intermediate growth stages by the same factor.

|-
| {{text anchor|GRAZER}}
| Caste
|
*number
| The creature is a grazer - if tamed in fortress mode, it needs a pasture to survive. The higher the number, the less frequently it needs to eat in order to live. Not used since 0.40.12, replaced by {{token|STANDARD_GRAZER|c}} to fix {{bugl|4113}}.
|}

{{alphabetical TOC|style=margin: 1em auto;}}

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

|-
| {{text anchor|HABIT}}
| Caste
|
*type
*probability
| Defines certain behaviors for the creature. The habit types are:
*COLLECT_TROPHIES
*COOK_PEOPLE
*COOK_VERMIN
*GRIND_VERMIN
*COOK_BLOOD
*GRIND_BONE_MEAL
*EAT_BONE_PORRIDGE
*USE_ANY_MELEE_WEAPON
*GIANT_NEST
*COLLECT_WEALTH.
These require the creature to have a {{token|LAIR|c}} to work properly, and also don't seem to work on creatures who are not a {{token|SEMIMEGABEAST|c}}, {{token|MEGABEAST|c}}, or{{token|NIGHT_CREATURE_HUNTER|c}}.

|-
| {{text anchor|HABIT_NUM}}
| Caste
|
*number or TEST_ALL
| "If you set HABIT_NUM to a number, it should give you that exact number of habits according to the weights.".{{cite forum|60554/1719248}} All lists of HABITs are preceded by [HABIT_NUM:TEST_ALL]

|-
| {{text anchor|HAS_NERVES}}
| Caste
|
| The creature has nerves in its muscles. Cutting the muscle tissue can sever motor and sensory nerves.

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

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

|-
| {{text anchor|HOMEOTHERM}}
| Caste
|
*number or NONE
| Default 'NONE'. The creature's normal body [[temperature]]. Creature ceases maintaining temperature on death unlike fixed material temperatures. Provides minor protection from environmental temperature to the creature.

|-
| {{text anchor|HUNTS_VERMIN}}
| Caste
|
| Creature hunts and kills nearby [[vermin]], randomly walking between places with food laying on the ground or in stockpiles, to check for possible [VERMIN_EATER] vermin, but they'll kill any other vermin too. Do not include this creature token on an intelligent entity that you intend to play as in fortress mode because it will prevent them from feeding themselves.

|}

{{alphabetical TOC|style=margin: 1em auto;}}

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

|-
| {{text anchor|IMMOBILE}}
| Caste
|
| The creature cannot move. Found on [[sponge]]s. Will also stop a creature from breeding in fortress mode (MALE and FEMALE are affected, if one is IMMOBILE no breeding will happen).

|-
| {{text anchor|IMMOBILE_LAND}}
| Caste
|
| The creature is immobile while on land. Only works on {{token|AQUATIC|c}} creatures which can't breathe on land.

|-
| {{text anchor|IMMOLATE}}
| Caste
|
| The creature radiates [[fire]]. It will ignite, and potentially completely destroy, items the creature is standing on. Also gives the vermin a high chance of escaping from [[animal trap]]s and [[cage]]s made of any flammable materials (specifically ones that could be ignited by magma).

|-
| {{text anchor|INTELLIGENT}}
| Caste
|
| Alias for {{token|CAN_SPEAK|c}} + {{token|CAN_LEARN|c}}.

|-
| {{text anchor|ITEMCORPSE}}
| Caste
|
* [[item token]]
* [[material token]]
| Determines if the creature leaves behind a non-standard corpse (i.e. wood, statue, bars, stone, pool of liquid, etc.). [[Ethics]] may prevent actually using the item in jobs or reactions.

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

{{alphabetical TOC|style=margin: 1em auto;}}

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

|-
| {{text anchor|LAIR}}
| Caste
|
*type
*probability
| Found on megabeasts, semimegabeasts, and night creatures. The creature will seek out sites of this type and take them as lairs. The lair types are:
*SIMPLE_BURROW
*SIMPLE_MOUND
*WILDERNESS_LOCATION
*SHRINE
*LABYRINTH

|-
| {{text anchor|LAIR_CHARACTERISTIC}}
| Caste
|
*characteristic
*probability
| Defines certain features of the creature's lair. The only valid characteristic is HAS_DOORS.

|-
| {{text anchor|LAIR_HUNTER}}
| Caste
|
| This creature will actively hunt adventurers in its lair.

|-
| {{text anchor|LAIR_HUNTER_SPEECH}}
| Caste
|
*speech file
| What this creature says while hunting adventurers in its lair.

|-
| {{text anchor|LARGE_PREDATOR}}
| Caste
|
| Will attack other creatures that are smaller than it. In [[fortress mode]], only one group of "large predators" (possibly two groups on "savage" maps) will appear on any given map. In [[adventurer mode]], large predators will try to ambush and attack you (and your party will attack them back). When tamed, large predators tend to be much more aggressive to enemies than non-large predators, making them a good choice for an animal army. They may go on rampages in worldgen, and adventurers may receive quests to kill them. Also, they can be mentioned in the intro paragraph when starting a fortress e.g. "ere the wolves get hungry."
A single biome supports 7 large predator species, picking randomly and rolling a d100 under its {{token|FREQUENCY|c}} to add it until all 7 slots are filled.

Incompatible with {{token|PACK_ANIMAL|c}} on a technicality, if included: hauled items are likely to be dropped upon entering the map (even if {{token|TRADE_CAPACITY|c}} is present) in contrast to when the merchants depart.

|-
| {{text anchor|LARGE_ROAMING}}
| Creature
|
| This is the core requisite tag allowing the creature to spawn as a wild animal in the appropriate biomes. Requires specifying a {{token|BIOME|c}} in which the creature will spawn. Does not require specifying a frequency, population number, or cluster number.

This tag stacks with {{token|MEGABEAST|c}}, {{token|SEMIMEGABEAST|c}}, or {{token|NIGHT_CREATURE_HUNTER|c}}; if used with one of these tags, the creature will spawn as both a boss and as a wild animal. This tag does not stack with {{token|FEATURE_BEAST|c}} and if both are used the creature will not spawn. This tag is unaffected by {{token|DEMON|c}}.

|-
| {{text anchor|LAYS_EGGS}}
| Caste
|
| Creature lays [[egg]]s instead of giving birth to live young.

|-
| {{text anchor|LAYS_UNUSUAL_EGGS}}
| Caste
|
* [[item token]]
* [[material token]]
| Creature lays the specified item instead of regular eggs.

|-
| {{text anchor|LIGAMENTS}}
| Caste
|
* [[material token]]
*healing rate
| The creature has ligaments in its {{token|CONNECTIVE_TISSUE_ANCHOR|td}} tissues (bone or chitin by default). Cutting the bone/chitin tissue severs the ligaments, disabling motor function if the target is a limb.

|-
| {{text anchor|LIGHT_GEN}}
| Caste
|
| A vermin featuring this tag will remain visible to an adventurer, even at night, and from a distance. Ostensibly bugged as of v0.47.05.

|-
| {{text anchor|LIKES_FIGHTING}}
| Caste
|
| The creature will attack enemies rather than flee from them. This tag has the same effect on player-controlled creatures - including modded dwarves. Retired as of v0.40.14 in favor of {{token|LARGE_PREDATOR|c}}.

|-
| {{text anchor|LISP}}
| Caste
|
| Creature uses "sssssnake talk" (multiplies 'S' when talking - "My name isss Recisssiz."). Used by [[Serpent man|serpent men]] and [[Reptile man|reptile men]] in the vanilla game. C's with the same pronunciation (depending on the word) are not affected by this token.

|-
| {{text anchor|LITTERSIZE}}
| Caste
|
* minimum
* maximum
| Determines the number of offspring per one birth; default 1-3, not used in vanilla raws. See also {{token|MULTIPLE_LITTER_RARE|c}}.

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

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

|-
| {{text anchor|LOCKPICKER}}
| Caste
|
| Lets a creature open [[door]]s that are set to forbidden in fortress mode.

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

|-
| {{text anchor|LOW_LIGHT_VISION}}
| Caste
|
*number
| Determines how well a creature can see in the dark - higher is better. Dwarves have 10000, which amounts to perfect nightvision.
|}

{{alphabetical TOC|style=margin: 1em auto;}}

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

|-
| {{text anchor|MAGICAL}}
| Caste
|
| According to Toady One, this is completely interchangeable with {{token|AT_PEACE_WITH_WILDLIFE|c}} and might have been used in very early versions of the game by wandering wizards or the ent-type tree creatures that used to be animated by elves. [http://www.bay12forums.com/smf/index.php?topic=169696.msg8316954#msg8316954]

|-
| {{text anchor|MAGMA_VISION}}
| Caste
|
| The creature is able to see while submerged in [[magma]].

|-
| {{text anchor|MALE}}
| Caste
|
| Makes the creature biologically male. Usually declared inside a caste.

|-
| {{text anchor|MANNERISM|MANNERISM_*}}
| Caste
|
*occasionally body part
| Adds a possible mannerism to the creature's profile. See [[creature mannerism token]] for further info.

|-
| {{text anchor|MATERIAL}}
| Creature
|
*material id
| Begins defining a new local material. Follow this with standard material definition tokens to define the material.

|-
| {{text anchor|MATERIAL_FORCE_MULTIPLIER}}
| Caste
|
*[[Material token]]
*value A
*value B
| When struck with a weapon made of the specified material, the force exerted will be multiplied by A/B, thus making the creature more or less susceptible to this material. For example, if A is 2 and B is 1, the force exerted by the defined material will be doubled. If A is 1 and B is 2, it will be halved instead. See also {{token|GENERAL_MATERIAL_FORCE_MULTIPLIER|c}}, which can be used to make this sort of effect applicable to all materials.

|-
| {{text anchor|MATUTINAL}}
| Caste
|
| Sets the creature to be active at dawn in adventurer mode.

|-
| {{text anchor|MAXAGE}}
| Caste
|
*min
*max
| Determines the creature's natural lifespan, using the specified minimum and maximum age values (in years). Each individual creature with this token is generated with a predetermined date (calculated down to the exact [[time|tick]]!) between these values, at which it is destined to die of old age, should it live long enough. Note that the probability of death at any given age does not increase as the creature gets older [http://i.imgur.com/A1A4aA9.png].
Creatures which lack this token are naturally immortal. The [[Syndrome#CE_ADD_TAG|NO_AGING]] syndrome tag will prevent death by old age from occurring. Also note that, among civilized creatures, castes which lack this token will refuse to marry others with it, and vice versa.

|-
| {{text anchor|MEANDERER}}
| Caste
|
| Makes the creature slowly stroll around, unless it's in combat or performing a job. If combined with {{token|CAN_LEARN|c}}, will severely impact their [[pathfinding]] and lead the creature to move extremely slowly when not performing any task. Problematically applies to animal people based on the animal and war trained animals{{bug|9588}}.

|-
| {{text anchor|MEGABEAST}}
| Caste
|
| A 'boss' creature. A small number of the creatures are created during worldgen, their histories and descendants (if any) will be tracked in worldgen (as opposed to simply 'spawning'), and they will occasionally go on rampages, potentially leading to worship if they attack the same place multiple times. Their presence and number will also influence age names. When appearing in fortress mode, they will have a pop-up message announcing their arrival. They will remain hostile to military even after being tamed.{{bug|10731}} See [[megabeast]] page for more details.

Requires specifying a {{token|BIOME|c}} in which the creature will live. Subterranean biomes appear to not be allowed. Does stack with {{token|LARGE_ROAMING|c}} and if both are used the creature will spawn as both historical bosses and as wild animals.

|-
| {{text anchor|MENT_ATT_CAP_PERC}}
| Caste
|
*[[Attribute|ATTRIBUTE]] Token
*Cap %
|Default is 200. This means you can increase your attribute to 200% of its starting value (or the average value + your starting value if that is higher).

|-
| {{text anchor|MENT_ATT_RANGE}}
| Caste
|
*[[Attribute|ATTRIBUTE]]
*lowest
*lower
*low
*median
*high
*higher
*highest
| Sets up a [[Attribute#Soul_attributes|mental attribute]]'s range of values (0-5000). All mental attribute ranges default to 200:800:900:1000:1100:1300:2000.

|-
| {{text anchor|MENT_ATT_RATES}}
| Caste
|
*[[Attribute|ATTRIBUTE]] Token
*cost to improve
*unused counter rate
*rust counter rate
*demotion counter rate
| [[Attribute#Soul_attributes|Mental attribute]] gain/decay rates. Lower numbers in the last three slots make decay occur faster. Defaults are 500:4:5:4.

|-
| {{text anchor|MILKABLE}}
| Caste
|
* [[material token]]
* frequency
| Allows the creature to be [[milk]]ed in the [[farmer's workshop]]. The frequency is the amount of [[time|ticks]] the creature needs to "recharge" (i.e. how much time needs to pass before it can be milked again). Does not work on [[#CAN_LEARN|sentient]] creatures, regardless of [[ethics]].

|-
| {{text anchor|MISCHIEVIOUS}}
| Caste
|
| Alias for {{token|MISCHIEVOUS|c}}.

|-
| {{text anchor|MISCHIEVOUS}}
| Caste
|
| The creature spawns [[stealth]]ed and will attempt to path into the fortress, pulling any [[lever]]s it comes across. It will be invisible on the map and [[unit list]] until spotted by a citizen, at which point the game will pause and recenter on the creature. Used by [[gremlin]]s in the vanilla game. "They go on little missions to mess with various fortress buildings, not just levers."

|-
| {{text anchor|MODVALUE}}
| Caste
|
| Seemingly no longer used.

|-
| {{text anchor|MOUNT}}
| Caste
|
| Creature may be used as a [[mount]]. No use for the player in fortress mode, but enemy sieging forces may arrive with cavalry. Mounts are usable in adventure mode.

|-
| {{text anchor|MOUNT_EXOTIC}}
| Caste
|
| Creature may be used as a [[mount]], but civilizations cannot domesticate it in worldgen without certain exceptions.

|-
| {{text anchor|MULTIPART_FULL_VISION}}
| Caste
|
| Allows the creature to have all-around vision as long as it has multiple heads that can see.

|-
| {{text anchor|MULTIPLE_LITTER_RARE}}
| Caste
|
| Makes the species usually produce a single offspring per birth, with a 1/500 chance of using the {{token|LITTERSIZE|c}} as usual. Requires {{token|FEMALE|c}}.

|-
| {{text anchor|MUNDANE}}
| Creature
|
| Marks if the creature is an actual real-life creature. Only used for age-names at present.
|}

{{alphabetical TOC|style=margin: 1em auto;}}

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

|-
| {{text anchor|NAME}}
| Creature
|
*singular
*plural
*adjective
| The generic name for any creature of this type - will be used for referring to the species in the abstract, such as the default material prefix. For labeling individual creatures, {{token|CASTE_NAME|c}} is necessary. If left undefined, the creature will be labeled as "nothing" by the game.

Some examples of adjective use:
* "super''dwarven'' strength"
* "the ''dwarven'' hillocks of X"
* Deity species as in "''feline'' deity"
* Megabeast attacks in worldgen. One with multiple dragons being a "''draconic'' rampage"

|-
| {{text anchor|NATURAL}}
| Caste
|
| Animal is considered to be natural. NATURAL animals will not engage creatures tagged with {{token|AT_PEACE_WITH_WILDLIFE|c}} in combat unless they are members of a hostile entity and vice-versa.

|-
| {{text anchor|NATURAL_ANIMAL}}
| Caste
|
| Alias of {{token|NATURAL|c}}.

|-
| {{text anchor|NATURAL_SKILL}}
| Caste
|
*[[Skill_token|Skill token]]
*value
| The creature possesses the specified [[skill]] at this level inherently - that is, it begins with the skill at this level, and the skill may never rust below that. A value of 15 is legendary.

|-
| {{text anchor|NIGHT_CREATURE}}
| Caste
|
| Creatures with this token can appear on [[experiment|experiments]].
Prevents {{token|LOCAL_POPS_PRODUCE_HEROES|c}} from functioning. Causes the creature to count as {{token|NOT_LIVING|c}}. Killing a creature featuring this token provides one point of "hero" reputation. Adds the creature's description as part of the initial summary of their historical figure in legends. Prevents creature behavior enabled by {{token|LARGE_PREDATOR|c}}. People will react to creatures with this token as a night creature (natch). In adventure mode, ambushes involving these units will say "Night creature!" instead of "Ambush!"

Prevents the AI from using ANIMATE interactions unless the newly-animated opposed-to-life undead will not attack them. The check for this is specifically whether the unit is:
*a ghost
*an animated unit
*a unit with the {{token|NO_AGING|c}} token added via {{token|CE_ADD_TAG|c}}. (This allows for the default exclusion of elves and goblins, unless raised as intelligent undead.)

''This token should not be confused with other NIGHT_CREATURE_X tokens.''
''This token is not well understood at the present time.''

|-
| {{text anchor|NIGHT_CREATURE_BOGEYMAN}}
| Caste
|
| Creatures with this token can appear in [[bogeyman|bogeyman ambushes]] in [[adventure mode]], where they adopt classical bogeyman traits such as stalking the adventurer and vaporising when dawn breaks. Such traits do not manifest if the creature is encountered outside of a bogeyman ambush (for instance, as a megabeast or a civilised being). In addition, their corpses and severed body parts turn into [[smoke]] after a short while. Note that setting the "Number of Bogeyman Types" in [[advanced world generation]] to 0 will only remove randomly-generated bogeymen.

|-
| {{text anchor|NIGHT_CREATURE_EXPERIMENTER}}
| Caste
|
| Found on some [[necromancer]]s. Creatures with this tag may periodically "perform horrible experiments" offscreen, during which they can use creature-targeting interactions with an <code>[[Interaction_token#I_SOURCE|[I_SOURCE:EXPERIMENT]]]</code> tag on living creatures in their area. Worlds are generated with a list of procedurally-generated experiments, allowing necromancers to turn living people and animals into [[Infected_ghoul|ghouls]] and [[Experiment|other experimental creatures]], and these will automatically be available to all experimenters; it does not appear possible to prevent this. You can mod in your own custom experiment interactions, but these are used very infrequently due to the large number of generated experiments.

|-
| {{text anchor|NIGHT_CREATURE_HUNTER}}
| Caste
|
| Found on [[night troll]]s and [[werebeast]]s. Implies that the creature is a [[night creature]], and shows its description in [[legends mode]] entry. The creature is always hostile and will start [[no quarter]] combat with any nearby creatures, except for members of its own race. Note that this tag does not override the creature's normal behavior in [[fortress mode]] except for the aforementioned aggression, and doesn't prevent the creature from fleeing the battles it started. It also removes the creature's materials from stockpile settings list, making them be stored there regardless of settings.

Does stack with {{token|LARGE_ROAMING|c}} and if both are used the creature will spawn as both historical hunters and as wild animals; this requires specifying a {{token|BIOME|c}} in which the creature will live, and subterranean biomes are allowed.

This tag causes the usual behaviour of werebeasts in worldgen, that is, fleeing towns upon being cursed and conducting raids from a lair. If this tag is absent from a deity curse, the accursed will simply be driven out of towns in a similar manner to [[vampire]]s. When paired with SPOUSE_CONVERTER, a very small population of the creature will be created during worldgen (sometimes only a single individual will be created), and their histories will be tracked (that is, they will not spawn spontaneously later, they must either have children or convert other creatures to increase their numbers). The creature will settle in a lair and go on rampages during worldgen. It will actively attempt to seek out potential conversion targets to abduct, convert, and have children with (if possible).

|-
| {{text anchor|NIGHT_CREATURE_NIGHTMARE}}
| Caste
|
| Found on [[nightmare]]s. Corpses and severed body parts derived from creatures with this token turn into [[smoke]] after a short while.

|-
| {{text anchor|NO_AUTUMN}}
| Caste
|
| The creature caste does not appear in [[Calendar|autumn]].

|-
| {{text anchor|NO_CONNECTIONS_FOR_MOVEMENT}}
| Caste
|
| Creature doesn't require connected body parts to move{{verify}}; generally used on undead creatures with connections that have rotted away.

|-
| {{text anchor|NO_DIZZINESS}}
| Caste
|
| Creature cannot become [[Symptom#Dizziness|dizzy]].

|-
| {{text anchor|NO_DRINK}}
| Caste
|
| Creature does not need to drink.

|-
| {{text anchor|NO_EAT}}
| Caste
|
| Creature does not need to [[food|eat]]. Seems to cause worldgen crashes if it is part of an entity with [[entity_token#PERMITTED_JOB|[PERMITTED_JOB:FISHERMAN]]]{{verify}}

|-
| {{text anchor|NO_FEVERS}}
| Caste
|
| Creature cannot suffer [[Symptom#Fever|fevers]].

|-
| {{text anchor|NO_GENDER}}
| Caste
|
| The creature is biologically sexless. Makes the creature unable to [[breeding|breed]].

|-
| {{text anchor|NO_PHYS_ATT_GAIN}}
| Caste
|
| The creature cannot raise any [[Attribute#Body_attributes|physical attributes]].

|-
| {{text anchor|NO_PHYS_ATT_RUST}}
| Caste
|
| The creature cannot lose any [[Attribute#Body_attributes|physical attributes]].

|-
| {{text anchor|NO_SLEEP}}
| Caste
|
| Creature does not need to sleep. Can still be rendered unconscious by other means.

|-
| {{text anchor|NO_SPRING}}
| Caste
|
| The creature caste does not appear in [[Calendar|spring]].

|-
| {{text anchor|NO_SUMMER}}
| Caste
|
| The creature caste does not appear in [[Calendar|summer]].

|-
| {{text anchor|NO_THOUGHT_CENTER_FOR_MOVEMENT}}
| Caste
|
| Creature doesn't require an organ with the {{token|THOUGHT|body}} tag to survive or attack; generally used on creatures that don't have brains.

|-
| {{text anchor|NO_UNIT_TYPE_COLOR}}
| Caste
|
| Prevents creature from selecting its color based on its profession (e.g. Miner, Hunter, Wrestler).

|-
| {{text anchor|NO_VEGETATION_PERTURB}}
| Caste{{Verify}}
|
| Likely prevents the creature from leaving broken vegetation tracks.{{Verify}}

|-
| {{text anchor|NO_WINTER}}
| Caste
|
| The creature caste does not appear in [[Calendar|winter]].

|-
| {{text anchor|NOBONES}}
| Caste
|
| Creature has no bones.

|-
| {{text anchor|NOBREATHE}}
| Caste
|
| Creature doesn't need to breathe or have {{token|BREATHE|body}} parts in body, nor can it drown or be strangled. Creatures living in magma must have this tag, otherwise they will drown.

|-
| {{text anchor|NOCTURNAL}}
| Caste
|
| Sets the creature to be active at night in adventure mode.

|-
| {{text anchor|NOEMOTION}}
| Caste
|
| Creature has no emotions. It is immune to the effects of [[stress]] and unable to rage, and its [[need]]s cannot be fulfilled in any way. Used on [[undead]] in the vanilla game.

|-
| {{text anchor|NOEXERT}}
| Caste
|
| Creature can't become tired or over-exerted from taking too many combat actions or moving at full speed for extended periods of time.

|-
| {{text anchor|NOFEAR}}
| Caste
|
| Creature doesn't feel fear and will never flee from battle, and will be immune to [[ghost]]s' attempts to 'scare it to death'. Additionally, it causes [[bogeyman|bogeymen]] and [[nightmare]]s to become friendly towards the creature.

|-
| {{text anchor|NOMEAT}}
| Caste
|
| Creature will not be hunted or fed to wild beasts.

|-
| {{text anchor|NONAUSEA}}
| Caste
|
| Creature isn't nauseated by gut hits and cannot vomit.

|-
| {{text anchor|NOPAIN}}
| Caste
|
| Creature doesn't feel pain.

|-
| {{text anchor|NOSKIN}}
| Caste
|
| Creature will not drop a hide when [[butcher|butchered]].

|-
| {{text anchor|NOSKULL}}
| Caste
|
| Creature will not drop a skull on butchering, rot, or decay of severed head.

|-
| {{text anchor|NOSMELLYROT}}
| Caste
|
| Does not produce [[miasma]] when rotting.

|-
| {{text anchor|NOSTUCKINS}}
| Caste
|
| Weapons can't get stuck in the creature.

|-
| {{text anchor|NOSTUN}}
| Caste
|
| Creature can't be stunned and knocked unconscious by pain or head injuries. Creatures with this tag never wake up from sleep in Fortress Mode. If this creature needs to sleep while playing, it will die.

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

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

|-
| {{text anchor|NOTHOUGHT}}
| Caste
|
| Creature doesn't require a {{token|THOUGHT|body}} body part to survive. Has the added effect of preventing speech, though directly controlling creatures that would otherwise be capable of speaking allows them to engage in conversation.
|}

{{alphabetical TOC|style=margin: 1em auto;}}

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

|-
| {{text anchor|ODOR_LEVEL}}
| Caste
|
*number
| How easy the creature is to [[smell]]. The higher the number, the easier the creature is to sniff out. Defaults to 50. Vanilla creatures have values from 0 (undetectable) to 90 (noticeable by humans and dwarves).

|-
| {{text anchor|ODOR_STRING}}
| Caste
|
*string
| What the creature [[smell]]s like. If no odor string is defined, the creature name (not the caste name) is used.

|-
| {{text anchor|OPPOSED_TO_LIFE}}
| Caste
|
| Is hostile to all creatures except undead and other non-living ones and will show {{DFtext|Opposed to life|0:1}} in the [[unit list]]. Used by [[undead]] in the vanilla game. Functions without the {{token|NOT_LIVING|c}} token, and seems to imply said token as well. Undead will not be hostile to otherwise-living creatures given this token. Living creatures given this token will attack living creatures that lack it, while ignoring other living creatures that also have this token.

|-
| {{text anchor|ORIENTATION}}
| Caste
|
*MALE/FEMALE
*disinterested chance
*casual chance
*strong chance
| Determines caste's likelihood of having sexual attraction to certain sexes. Values default to 75:20:5 for the same sex and 5:20:75 for the opposite sex. The first value indicates how likely to be entirely uninterested in the sex, the second decides if the creature will be able to become lovers with that sex, the third decides whether they will be able to marry in worldgen and post-worldgen world activities (which implies being able to become lovers). Marriage seems to be able to happen in fort mode play regardless, as long as they are lovers first.

|-
| {{text anchor|OUTSIDER_CONTROLLABLE}}
| Caste
|
| Lets you play as an [[Adventurer_mode_character_creation#Outsider|outsider]] of this species in adventure mode.

|}

{{alphabetical TOC|style=margin: 1em auto;}}

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

|-
| {{text anchor|PACK_ANIMAL}}
| Caste
|
| Allows the creature to be used as a pack animal. Used by [[trading|merchants]] without wagons and adventurers. Also prevents creature from dropping hauled items on its own -- do ''not'' use for player-controllable creatures! May lead to the creature being domesticated during worldgen, even if it doesn't have {{token|COMMON_DOMESTIC|c}}.

Creatures with this tag but without {{token|BENIGN|c}}, and/or with {{token|LARGE_PREDATOR|c}} leads to hauled items being dropped.

|-
| {{text anchor|PARALYZEIMMUNE}}
| Caste
|
| The creature is immune to all [[Syndrome#CE_PARALYSIS|paralyzing]] special attacks.

|-
| {{text anchor|PATTERNFLIER}}
| Caste
|
| Used to control the bat riders with paralyze-dart blowguns that flew through the 2D chasm. Doesn't do anything now.

|-
| {{text anchor|PCG_LAYERING}}
| Creature
|
*[[Procedural graphics layer|Layering type]]
| Adds a layer to the current {{token|PROCEDURAL_CREATURE_GRAPHICS|c}} definition.

|-
| {{text anchor|PEARL}}
| Caste
|
| In earlier versions, creature would generate [[pearl]]s. Does nothing in the current version.{{verify}}

|-
| {{text anchor|PENETRATEPOWER}}
| Caste
|
*value
| Controls the ability of [[vermin]] to find a way into containers when they are eating food from your stockpiles.

Objects made of most materials (e.g. metal) roll a number from 0-100, and if the resulting number is greater than the penetrate power, their contents escape for the time being. Objects made of [[wood]], [[leather]], [[amber]], or [[coral]] roll 0-95, and items made of [[cloth]] roll 0-90.

|-
| {{text anchor|PERSONALITY}}
| Caste
|
*ATTRIBUTE
*lowest
*median
*highest
| Determines the range and chance of personality traits. Standard is 0:50:100. See [[Personality trait]] for more info.

|-
| {{text anchor|PET}}
| Caste
|
| Allows the creature to be [[Animal_trainer|tamed]] in Fortress mode. Prerequisite for all other working animal roles. Civilizations that encounter it in worldgen will tame and domesticate it for their own use. Adding this to civilization members will classify them as pets instead of citizens, with all the [[Fun|problems]] that entails. However, you can solve these problems using the popular plugin [https://dffd.bay12games.com/file.php?id=13095| Dwarf Therapist], which is completely unaffected by the tag.

|-
| {{text anchor|PET_EXOTIC}}
| Caste
|
| Allows the creature to be [[Animal_trainer|tamed]] in Fortress mode. Prequisite for all other working animal roles. Civilizations cannot domesticate it in worldgen, with certain exceptions. More difficult to tame?{{verify}} Adding this to civilization members will classify them as pets instead of citizens, with all the [[Fun|problems]] that entails. ([[Gremlin|Example]]).

|-
| {{text anchor|PETVALUE}}
| Caste
|
*value
| How valuable a tamed animal is. Actual cost in points in the embarking screen is 1+(PETVALUE/2) for an untrained animal, 1+PETVALUE for a war/hunting one.

|-
| {{text anchor|PETVALUE_DIVISOR}}
| Caste
|
*value
| Divides the creature's {{token|PETVALUE|c}} by the specified number. Used by [[honey bee]]s to prevent a single hive from being worth a fortune.

|-
| {{text anchor|PHYS_ATT_CAP_PERC}}
| Caste
|
*[[Attribute|ATTRIBUTE]] Token
*Cap %
|Default is 200. This means you can increase your attribute to 200% of its starting value (or the average value + your starting value if that is higher).

|-
| {{text anchor|PHYS_ATT_RANGE}}
| Caste
|
*[[Attribute|ATTRIBUTE]]
*lowest
*lower
*low
*median
*high
*higher
*highest
| Sets up a [[Attribute#Body_attributes|physical attribute]]'s range of values (0-5000). All physical attribute ranges default to 200:700:900:1000:1100:1300:2000.

|-
| {{text anchor|PHYS_ATT_RATES}}
| Caste
|
*[[Attribute|ATTRIBUTE]] Token
*cost to improve
*unused counter rate
*rust counter rate
*demotion counter rate
| [[Attribute#Body_attributes|Physical attribute]] gain/decay rates. Lower numbers in the last three slots make decay occur faster. Defaults for STRENGTH, AGILITY, TOUGHNESS, and ENDURANCE are 500:3:4:3, while RECUPERATION and DISEASE_RESISTANCE default to 500:NONE:NONE:NONE.

|-
| {{text anchor|PLUS_BP_GROUP}}
| Caste
|
*BY_TYPE, BY_CATEGORY, or BY_TOKEN
*body type, category, or token
| Adds a body part group to selected body part group. Presumably used immediately after {{token|SET_BP_GROUP|c}}.

|-
| {{text anchor|PLUS_MATERIAL}}
| Creature
|
*material
| Adds a material to selected materials. Used immediately after {{token|SELECT_MATERIAL|c}}.

|-
| {{text anchor|POP_RATIO}}
| Caste
|
*number (max 100000)
| Weighted population of caste; Lower is rarer. Not to be confused with {{token|FREQUENCY|c}}. A weight of 0 will not prevent a caste from spawning.

|-
| {{text anchor|POPULATION_NUMBER}}
| Creature
|
*min
*max
| The minimum/maximum numbers of how many of these creatures are present in each world map tile of the appropriate region. Defaults to 1:1 if not specified.

|-
| {{text anchor|POWER}}
| Caste
|
| Allows the being to represent itself as a deity, allowing it to become the leader of a civilized group. Used by unique demons in the vanilla game. Requires {{token|CAN_SPEAK|c}} to actually do anything more than settle at a location (e.g. write books, lead armies, profane temples). Doesn't appear to do anything for creatures that are already civilized. Once the creature ascends to a position of leadership, it will proceed to act as a standard ruler for their entity and fulfill the same functions (hold tournaments, tame creatures, etc.).

|-
| {{text anchor|PREFSTRING}}
| Creature
|
*string
| Sets what other creatures [[Preferences|prefer]] about this creature. "Urist likes dwarves for their beards." Multiple entries will be chosen from at random. Creatures lacking a PREFSTRING token will never appear under another's preferences.

|-
| {{text anchor|PROCEDURAL_CREATURE_GRAPHICS}}
| Creature
|
* [[Graphics_token#Basic_creature_sprite_types|Sprite type]] or Caste then sprite type
| Makes the creature have procedural graphics built for it, like forgotten beasts/demons/titans/experiments. Must be associated with PCG_LAYERING tokens.

|-
| {{text anchor|PROFESSION_NAME}}
| Creature
|
*[[Unit type token]] (Profession)
*singular
*plural
| The generic name for members of this profession, at the creature level. In order to give members of specific castes different names for professions, use {{token|CASTE_PROFESSION_NAME|c}} instead.

|-
| {{text anchor|PRONE_TO_RAGE}}
| Caste
|
*Chance
| Creature has a percentage chance to flip out at visible non-friendly creatures. Enraged creatures attack anything regardless of timidity and get a strength bonus to their hits. This is what makes [[badger]]s so hardcore.

|-
| {{text anchor|PUS}}
| Caste
|
* <[[material token]]>
* <[[Material_definition_token#Material_States|material state]]>
| The creature has pus. Specifies the stuff secreted by [[Health_care#Infection|infected wounds]].
|}

{{alphabetical TOC|style=margin: 1em auto;}}

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

|-
| {{text anchor|RELSIZE}}
| Caste
|
*BY_CATEGORY, BY_TYPE, BY_TOKEN
*body category, type, or token
*Relsize
| Specifies a new relative size for a part than what is stated in the body plan. For example, dwarves have larger livers.

|-
| {{text anchor|REMAINS}}
| Caste
|
*singular
*plural
| What the creature's [[remains]] are called.

|-
| {{text anchor|REMAINS_COLOR}}
| Caste
|
| What color the creature's [[remains]] are.

|-
| {{text anchor|REMAINS_ON_VERMIN_BITE_DEATH}}
| Caste
|
| Goes with {{token|VERMIN_BITE|c}} and {{token|DIE_WHEN_VERMIN_BITE|c}}, the vermin creature will leave remains on death when biting. Leaving this tag out will cause the creature to disappear entirely after it bites.

|-
| {{text anchor|REMAINS_UNDETERMINED}}
| Caste
|
| Unknown.

|-
| {{text anchor|REMOVE_MATERIAL}}
| Creature
|
*material token
| Removes a material from the creature.

|-
| {{text anchor|REMOVE_TISSUE}}
| Creature
|
*tissue token
| Removes a tissue from the creature.

|-
| {{text anchor|RETRACT_INTO_BP}}
| Caste
|
*BY_TYPE, BY_CATEGORY or BY_TOKEN
*body type, [[Body_token#CATEGORY|category]], or [[Body_token#BP|token]]
*Second person ("You") retract verb text
*Third person ("The giant snail") retract verb text
*Second person cancel retract text
*Third person cancel retract text
| The creature will retract into the specified body part(s) when threatened. It will be unable to move or attack, but enemies will only be able to attack the specified body part(s). When one of the specified body part is severed off, the creature automatically unretracts and cannot retract anymore. More than one body part can be selected by using BY_TYPE or BY_CATEGORY.

Second-person descriptions are used for adventurer mode natural ability. "<pro_pos>" can be used in the descriptions, being replaced with the proper pronoun (or lack thereof) in-game.

Undead curled up creatures are buggy, specifically those that retract into their upper bodies: [[echidna]]s, [[hedgehog]]s and [[pangolin]]s.{{bug|11463}}{{bug|10519}} The upper body is prevented from collapsing by a separate body part (the middle spine), which cannot be attacked when the creature is retracted. See {{token|PREVENTS_PARENT_COLLAPSE|bo}}. Living creatures eventually succumb to blood loss, but undead creatures do not. Giant creatures also take a very long time to bleed out.
|-
| {{text anchor|RETURNS_VERMIN_KILLS_TO_OWNER}}
|
|
| Cat behavior. If it kills a vermin creature and has an owner, it carries the remains in its mouth and drops them at their feet. Requires {{token|HUNTS_VERMIN|c}}.

|-
| {{text anchor|ROOT_AROUND}}
| Caste
|
*BY_TYPE, BY_CATEGORY or BY_TOKEN
*body type, [[Body_token#CATEGORY|category]], or [[Body_token#BP|token]]
*Second person ("You") verb text
*Third person ("The hen") verb text
| Creature will occasionally root around in the grass, looking for insects. Used for flavor in Adventurer Mode, spawns vermin edible for this creature in Fortress Mode. Creatures missing the specified body part will be unable to perform this action. The action produces a message (visible in adventure mode) in the form:

[creature] [verb text] the [description of creature's location]

In adventure mode, the "rooting around" ability will be included in the "natural abilities" menu, represented by its second person verb text.

|}

{{alphabetical TOC|style=margin: 1em auto;}}

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

|-
| {{text anchor|SAVAGE}}
| Creature
|
| The creature will only show up in "savage" biomes. Has no effect on cavern creatures. Cannot be combined with {{token|GOOD|c}} or {{token|EVIL|c}}.

|-
| {{text anchor|SECRETION}}
| Caste
|
*<[[material token]]>
*<[[Material_definition_token#Material_States|material state]]>
*BY_TOKEN / BY_CATEGORY / BY_TYPE
*<[[Body_token#BP|body part ID]]> / <[[Body_token#CATEGORY|category]]> or ALL / <type (e.g. [[Body_token#GRASP|GRASP]])>
*<[[Body_detail_plan_token#BP_LAYERS|tissue layer]]> or ALL
*<trigger>
| Causes the specified tissue layer(s) of the indicated body part(s) to secrete the designated material. A size 100 ('covering') [[contaminant]] is created over the affected body part(s) in its specified material state (and at the temperature appropriate to this state) when the trigger condition is met, as long as one of the secretory tissue layers is still intact. Valid triggers are:
*'''CONTINUOUS'''
Secretion occurs once every 40 [[time|ticks]] in [[fortress mode]], and every tick in [[adventurer mode]].
*'''EXERTION'''
Secretion occurs continuously (at the rate described above) whilst the creature is at minimum {{Tile|Tired|6:1}} following physical exertion. Note that this cannot occur if the creature has {{token|NOEXERT|c}}.
*'''EXTREME_EMOTION'''
Secretion occurs continuously (as above) whilst the creature is distressed. Cannot occur in creatures with {{token|NOEMOTION|c}}.

|-
| {{text anchor|SELECT_ADDITIONAL_CASTE}}
| Creature
|
*<caste>
| Adds an additional previously defined caste to the selection. Used after {{token|SELECT_CASTE|c}}.

|-
| {{text anchor|SELECT_CASTE}}
| Creature
|
*<caste> or ALL
| Selects a previously defined caste

|-
| {{text anchor|SELECT_MATERIAL}}
| Creature
|
*<[[material token]]>
| Selects a locally defined material. Can be ALL.

|-
| {{text anchor|SELECT_TISSUE}}
| Creature
|
*tissue token
| Selects a tissue for editing.

|-
| {{text anchor|SEMIMEGABEAST}}
| Caste
|
| Essentially the same as {{token|MEGABEAST|c}}, but more of them are created during worldgen. See the [[semi-megabeast]] page for details.

|-
| {{text anchor|SENSE_CREATURE_CLASS}}
| Caste
|
* <[[Creature_token#CREATURE_CLASS|creature class]]>
* [[Tilesets|<tile value or character>]]
* [[Color#Color_values|<foreground color>:<background color>:<foreground brightness>]]
| Gives the creature the ability to sense creatures belonging to the specified [[Creature_token#CREATURE_CLASS|creature class]] even when they lie far beyond line of sight, including through walls and floors. It also appears to reduce or negate the combat penalty of [[Wound#Blindness|blind]] units when fighting creatures they can sense. In [[adventure mode]], the specified tile will be used to represent sensed creatures when they cannot be seen directly.

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

|-
| {{text anchor|SKILL_LEARN_RATE}}
| Caste
|
*<[[skill_token]]>
*<percentage>
| The rate at which this creature learns this skill. Requires {{token|CAN_LEARN|c}} or {{token|INTELLIGENT|c}} to function.

|-
| {{text anchor|SKILL_LEARN_RATES}}
| Caste
|
*<percentage>
| The rate at which this creature learns all skills. Requires {{token|CAN_LEARN|c}} or {{token|INTELLIGENT|c}} to function.

|-
| {{text anchor|SKILL_RATE}}
| Caste
|
*[[skill_token]]
*<% of improvement points gained>
*<unused counter rate>
*<rust counter rate>
*<demotion counter rate>
| Like {{token|SKILL_RATES|c}}, but applies to individual skills instead. Requires {{token|CAN_LEARN|c}} or {{token|INTELLIGENT|c}} to function.

|-
| {{text anchor|SKILL_RATES}}
| Caste
|
*<% of improvement points gained>
*<unused counter rate>
*<rust counter rate>
*<demotion counter rate>
| Affects skill gain and decay. Lower numbers in the last three slots make decay occur faster ([SKILL_RATES:100:1:1:1] would cause rapid decay). The counter rates may also be replaced with NONE.
Default is [SKILL_RATES:100:8:16:16]. Requires {{token|CAN_LEARN|c}} or {{token|INTELLIGENT|c}} to function.

|-
| {{text anchor|SKILL_RUST_RATE}}
| Caste
|
*[[skill_token]]
*value
*value
*value
| The rate at which this skill decays. Lower values cause the skill to decay faster. Requires {{token|CAN_LEARN|c}} or {{token|INTELLIGENT|c}} to function.

|-
| {{text anchor|SKILL_RUST_RATES}}
| Caste
|
*value
*value
*value
| The rate at which all skills decay. Lower values cause the skills to decay faster. Requires {{token|CAN_LEARN|c}} or {{token|INTELLIGENT|c}} to function.

|-
| {{text anchor|SLAIN_CASTE_SPEECH}}
| Caste
|
*[[Speech file|text set]]
| Caste-specific {{token|SLAIN_SPEECH|c}}.

|-
| {{text anchor|SLAIN_SPEECH}}
| Creature
|
*[[Speech file|text set]]
| Boasting speeches relating to killing this creature. Examples include [[text_dwarf.txt/raw|text_dwarf.txt]] (<code>[SLAIN_SPEECH:SLAIN_DWARF]</code>) and text_elf.txt (<code>[SLAIN_SPEECH:SLAIN_ELF]</code>) in data\vanilla\vanilla_creatures\objects.

|-
| {{text anchor|SLOW_LEARNER}}
| Caste
|
| Shorthand for {{token|CAN_LEARN|c}} + <code>[[Creature_token#SKILL_LEARN_RATES|[SKILL_LEARN_RATES:50]]]</code>.{{verify}} Used by a number of 'primitive' creatures (like [[ogre]]s, [[giant]]s and [[troglodyte]]s) in the vanilla game. Applicable to player races. Prevents a player from recruiting nobility, even basic ones. Subterranean creatures with this token combined with {{token|EVIL|c}} will become servants of goblins in their civilizations, in the style of [[troll]]s.

|-
| {{text anchor|SMALL_REMAINS}}
| Caste
|
| Creature leaves "[[item token#REMAINS|remains]]" instead of a corpse. Used by [[vermin]].

|-
| {{text anchor|SMELL_TRIGGER}}
| Creature
|
*value
| Determines how keen a creature's sense of smell is - lower is better. At 10000, a creature cannot smell at all.

|-
| {{text anchor|SOLDIER_ALTTILE}}
| Creature
|
*'character' or tile number
| If this creature is active in its civilization's military, it will blink between its default tile and this one.

|-
| {{text anchor|SOUND}}
| Caste
|
* Sound application (currently accepts ALERT or PEACEFUL_INTERMITTENT)
* Sound range (in tiles)
* Sound delay (lower values = sound is produced more often)
* VOCALIZATION or NONE (determines whether the sound requires breathing or not)
* First-person description
* Third-person description
* Description when out of sight
| Creature makes sounds periodically, which can be heard in Adventure mode.
* First-person reads "You '''bark'''"
* Third-person reads "The [[capybara]] '''barks'''"
* Out of sight reads "You hear '''a loud bark'''"
with the text in bold being the description arguments of the token.

|-
| {{text anchor|SOURCE_HFID}}
| Creature
|
*Integer
| Found on generated [[angel]]s. This is the historical figure ID of the deity with which the angel is associated. Since HFIDs are not predictable before worldgen, this isn't terribly usable in mods.

|-
| {{text anchor|SPECIFIC_FOOD}}
| Caste
|
* PLANT or CREATURE
* Plant/creature ID
| Creature will only appear in biomes with this plant or creature available. Grazers given a specific type of grass (such as [[panda]]s and [[bamboo]]) will only eat that grass and nothing else, risking starvation if there's none available.

|-
| {{text anchor|SPHERE}}
| Creature
|
* [[Sphere#Available_spheres|sphere]]
| Sets what religious spheres the creature is aligned to, for purposes of being worshipped via the {{token|POWER|c}} token. Also affects the layout of hidden fun stuff, and the creature's name.

|-
| {{text anchor|SPOUSE_CONVERSION_TARGET}}
| Caste
|
| This creature can be converted by a night creature with {{token|SPOUSE_CONVERTER|c}}.

|-
| {{text anchor|SPOUSE_CONVERTER}}
| Caste
|
| If the creature has the {{token|NIGHT_CREATURE_HUNTER|c}} tag, it will kidnap {{token|SPOUSE_CONVERSION_TARGET|c}}s and transform them into the caste of its species with the {{token|CONVERTED_SPOUSE|c}} tag during worldgen. It may also start families this way.

|-
| {{text anchor|SPREAD_EVIL_SPHERES_IF_RULER}}
| Caste
|
| If the creature rules over a [[site]], it will cause the local landscape to be corrupted into [[Surroundings#Evil|evil surroundings]] associated with the creature's [[Creature_token#SPHERE|sphere]]s. The creature must have at least one of the following [[sphere]]s for this to take effect: BLIGHT, DEATH, DISEASE, DEFORMITY, NIGHTMARES. The first three kill vegetation, while the others sometimes do. The last two get [[Plant_token#EVIL|evil plants]] and [[Creature_token#EVIL|evil animals]] sometimes. NIGHTMARES gets [[bogeyman|bogeymen]]. [http://www.bay12forums.com/smf/index.php?topic=169696.msg8162224#msg8162224] Used by [[demon]]s in the vanilla game.

|-
| {{text anchor|STANCE_CLIMBER}}
| Caste
|
| Caste does not require <code>[[Body_token#GRASP|[GRASP]]]</code> body parts to climb -- it can climb with <code>[[Body_token#STANCE|[STANCE]]]</code> parts instead.

|-
| {{text anchor|STANDARD_GRAZER}}
| Caste
|
| Acts as {{token|GRAZER|c}} but set to 20000*G*(max size)^(-3/4), where G defaults to 100 but can be set in d_init, and the whole thing is trapped between 150 and 3 million. Used for all grazers in the default creature raws.

|-
| {{text anchor|STRANGE_MOODS}}
| Caste
|
| The creature will get [[strange mood]]s in fortress mode and can produce artifacts.

|-
| {{text anchor|SUPERNATURAL}}
| Caste
|
| Gives the creature knowledge of any secrets with <code>[[Interaction_token#IS_SECRET|[SUPERNATURAL_LEARNING_POSSIBLE]]]</code> that match its [[Creature_token#SPHERE|spheres]] and also prevents it from becoming a [[vampire]] or [[werebeast]]. Other effects are unknown.

|-
| {{text anchor|SWIMS_INNATE}}
| Caste
|
| The creature naturally knows how to swim perfectly and does not use the [[swimmer]] skill, as opposed to {{token|SWIMS_LEARNED|c}} below. However, Fortress mode AI never paths into water anyway, so it's less useful there.

|-
| {{text anchor|SWIMS_LEARNED}}
| Caste
|
| The creature swims only as well as their present [[Swimmer|swimming skill]] allows them to.

|-
| {{text anchor|SYNDROME_DILUTION_FACTOR}}
| Caste
| <[[Syndrome#SYN_IDENTIFIER|syndrome identifier]]>:<percentage>
| Dilutes the effects of syndromes which have the specified identifier. A percentage of 100 is equal to the regular syndrome effect severity, higher percentages reduce severity.
|}

{{alphabetical TOC|style=margin: 1em auto;}}

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

|-
| {{text anchor|TENDONS}}
| Caste
|
* [[material token]]
*healing rate
| The creature has tendons in its {{token|CONNECTIVE_TISSUE_ANCHOR|td}} tissues (bone or chitin by default). Cutting the bone/chitin tissue severs the tendons, disabling motor function if the target is a limb.

|-
| {{text anchor|THICKWEB}}
| Caste
|
| The creature's [[web]]s can catch larger creatures.

|-
| {{text anchor|TISSUE}}
| Creature
|
*name
| Begins defining a tissue in the creature file. Follow this with standard tissue definition tokens to define the tissue properties.

|-
| {{text anchor|TISSUE_LAYER}}
| Caste
|
*BY_TYPE, BY_CATEGORY, BY_TOKEN
*TYPE,CATEGORY, or TOKEN
*TISSUE
*LOCATION
| Adds the tissue layer to wherever it is required.
Non-argument Locations can be FRONT, RIGHT, LEFT, TOP, BOTTOM. Argument locations are AROUND and CLEANS, requiring a further body part and a % of coverage/cleansing

|-
| {{text anchor|TISSUE_LAYER_OVER}}
| Caste
|
*BY_TYPE, BY_CATEGORY, BY_TOKEN
*TYPE,CATEGORY, or TOKEN
*TISSUE
*LOCATION
| Alias for TISSUE_LAYER

|-
| {{text anchor|TISSUE_LAYER_UNDER}}
| Caste
|
*BY_TYPE, BY_CATEGORY, BY_TOKEN
*TYPE,CATEGORY, or TOKEN
*TISSUE
| Adds the tissue layer under a given part.
For example, an [[iron man]] has a gaseous poison within, and this tissue (GAS is its name) has the token [TISSUE_LEAKS] and its state is GAS, so when you puncture the iron outside and damage this tissue it leaks gas (can have a syndrome by using a previous one in the creature sample.) [TISSUE_LAYER_UNDER:BY_CATEGORY:ALL:{tissue}] {tissue} is what will be under the TISSUE_LAYER; here is an example Tissue from the 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]

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

|-
| {{text anchor|TRADE_CAPACITY}}
| Caste
|
*number
| How much the creature can carry when used by merchants. 1000 by default. If a civilization uses a custom pack animal via ALWAYS_PACK, you must manually add a capacity to the raws of that creature itself. Capacity defaults to null leading to empty caravans.

|-
| {{text anchor|TRAINABLE}}
| Caste
|
| Shortcut for {{token|TRAINABLE_HUNTING|c}} + {{token|TRAINABLE_WAR|c}}.

|-
| {{text anchor|TRAINABLE_HUNTING}}
| Caste
|
| Can be [[Animal trainer|trained]] as a hunting beast, increasing speed.

|-
| {{text anchor|TRAINABLE_WAR}}
| Caste
|
| Can be [[Animal trainer|trained]] as a war beast, increasing strength and endurance.

|-
| {{text anchor|TRANCES}}
| Caste
|
| Allows the creature to go into [[martial trance]]s. Used by dwarves in the vanilla game.

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

|-
| {{text anchor|TRIGGERABLE_GROUP}}
| Creature
|
*min
*max
| A large swarm of vermin can be disturbed, usually in adventurer mode.{{verify}}

|-
| {{text anchor|TSU_NOUN}}
| Caste
|
*noun
*SINGULAR or PLURAL
| Noun for the {{token|TISSUE_STYLE_UNIT|c}}, used in the description of the tissue layer's style.
|}

{{alphabetical TOC|style=margin: 1em auto;}}

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

|-
| {{text anchor|UBIQUITOUS}}
| Creature
|
| Creature will occur in every region with the correct biome. Does not apply to {{token|EVIL|c}}/{{token|GOOD|c}} tags. Supersedes {{token|FREQUENCY|c}} for the purposes of distributing populations through the map, they are present in every part of the valid biome. Respects {{token|FREQUENCY|c}} for the frequency of unit [[Creature token#CLUSTER_NUMBER|cluster]] spawns being of this species.

|-
| {{text anchor|UNDERGROUND_DEPTH}}
| Creature
|
*mindepth
*maxdepth
| Depth that the creature appears underground. Numbers can be from 0 to 5. 0 is actually 'above ground' and can be used if the creature is to appear both above and below ground. Values from 1-3 are the respective [[cavern]] levels, 4 is the [[magma sea]] and 5 is the [[HFS]]. A single argument may be used instead of min and max. [[Demon]]s use only 5:5; user-defined creatures with both this depth and {{token|FLIER}} will take part in the initial wave from the HFS alongside generated demons, but without {{token|FLIER}} they will only spawn from the map edges. Civilizations that can use underground plants or animals will only export (via the embark screen or caravans) things that are available at depth 1.

|-
| {{text anchor|UNDERSWIM}}
| Caste
|
| The creature is displayed as blue when in [[Water#Depth|7/7 water]]. Used on fish and amphibious creatures which swim under the water.

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

|-
| {{text anchor|USE_CASTE}}
| Creature
|
*new caste token
*old caste token
| Defines a new caste derived directly from a previous caste. The new caste inherits all properties of the old one. The effect of this tag is automatic if one has not yet defined any castes: "Any caste-level tag that occurs before castes are explicitly declared is saved up and placed on any caste that is declared later, unless the caste is explicitly derived from another caste."
Roostre: "When DF detects duplicate tokens in the raws of the same object, a failsafe seems to kick in; it takes the bottom-most of the duplicates, and disregards the others. In the case of tokens added by a mod, it prioritizes the duplicate in the mod." This means that if a tag is defined in the base-caste and redefined in the derived caste, the derived tag overwrites the base tag.

|-
| {{text anchor|USE_MATERIAL}}
| Creature
|
*new material ID
*old material ID
| Defines a new local creature material and populates it with all properties defined in the specified local creature material.

|-
| {{text anchor|USE_MATERIAL_TEMPLATE}}
| Creature
|
*new material token
*material template
| Defines a new local creature material and populates it with all properties defined in the specified template. [http://www.bay12forums.com/smf/index.php?topic=175437.msg8441368#msg8441368 There seems to be a limit of 200 materials per creature].

|-
| {{text anchor|USE_TISSUE}}
| Creature
|
*new tissue token
*old tissue id
| Defines a new local creature tissue and populates it with all properties defined in the local tissue specified in the second argument.

|-
| {{text anchor|USE_TISSUE_TEMPLATE}}
| Creature
|
*new tissue token
*tissue template
| Loads a tissue template listed in OBJECT:TISSUE_TEMPLATE files, such as tissue_template_default.txt.

|-
| {{text anchor|UTTERANCES}}
| Creature
|
| Changes the language of the creature into unintelligible 'kobold-speak', which creatures of other species will be unable to understand. If a civilized creature has this and is not part of a {{token|SKULKING|e}} civ, it will tend to start wars with all nearby civilizations and will be unable to make peace treaties due to 'inability to communicate'.
|}

{{alphabetical TOC|style=margin: 1em auto;}}

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

|-
| {{text anchor|VEGETATION}}
| Caste
|
| Like {{token|AT_PEACE_WITH_WILDLIFE}}, but also makes the creature more valued in artwork by civilisations with the PLANT [[sphere]]. [http://www.bay12forums.com/smf/index.php?topic=169696.msg8316954#msg8316954] Used by [[grimeling]]s in the vanilla game.

|-
| {{text anchor|VERMIN_BITE}}
| Caste
|
*chance of occurrence{{verify}}
*verb (bitten, stung, etc.)
* [[material token]]
* [[Material_definition_token#Material_States|material state]]
| Enables vermin to bite other creatures, injecting the specified material. See {{token|SPECIALATTACK_INJECT_EXTRACT|c}} for details about injection - this token presumably works in a similar manner.{{verify}}

|-
| {{text anchor|VERMIN_EATER}}
| Creature
|
| The vermin creature will attempt to eat exposed food. See {{token|PENETRATEPOWER|c}}. Distinct from {{token|VERMIN_ROTTER|c}}.

|-
| {{text anchor|VERMIN_FISH}}
| Creature
|
| The vermin appears in [[water]] and will attempt to swim around.

|-
| {{text anchor|VERMIN_GROUNDER}}
| Creature
|
| The creature appears in "general" surface ground locations. Note that this doesn't stop the creature from flying if it can (most vermin birds have this tag).

|-
| {{text anchor|VERMIN_HATEABLE}}
| Caste
|
| Some dwarves will [[Preferences|hate]] the creature and get unhappy thoughts when around it. See the [[Hateable|list of hateable vermin]] for details.

|-
| {{text anchor|VERMIN_MICRO}}
| Caste
|
| This makes the creature move in a swarm of creatures of the same race as it (e.g. swarm of flies, swarm of ants).

|-
| {{text anchor|VERMIN_NOFISH}}
| Caste
|
| The creature cannot be caught by [[fishing]].

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

|-
| {{text anchor|VERMIN_NOTRAP}}
| Caste
|
| The creature cannot be caught in baited [[animal trap]]s; however, a "[[Trapper|catch live land animal]]" task may still be able to capture one if a dwarf finds one roaming around.

|-
| {{text anchor|VERMIN_ROTTER}}
| Creature
|
| The vermin are attracted to rotting stuff and loose food left in the open and cause unhappy thoughts to dwarves who encounter them. Present on flies, knuckle worms, acorn flies, and blood gnats. Speeds up decay?{{verify}}

|-
| {{text anchor|VERMIN_SOIL}}
| Creature
|
| The creature randomly appears near dirt or mud, and may be uncovered by creatures that have the {{token|ROOT_AROUND|c}} interaction such as [[goose|geese]] and [[chicken]]s. Dwarves will ignore the creature when given the "Capture live land animal" task.

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

|-
| {{text anchor|VERMINHUNTER}}
| Caste
|
| Old shorthand for "does cat stuff". Contains {{token|AT_PEACE_WITH_WILDLIFE|c}} + {{token|RETURNS_VERMIN_KILLS_TO_OWNER|c}} + {{token|HUNTS_VERMIN|c}} + {{token|ADOPTS_OWNER|c}}.

|-
| {{text anchor|VESPERTINE}}
| Caste
|
| Sets the creature to be active during the evening in adventurer mode.

|-
| {{text anchor|VIEWRANGE}}
| Caste
|
*value
| Value should determine how close you have to get to a critter before it attacks (or prevents adv mode travel etc.) Default is 20.

|-
| {{text anchor|VISION_ARC}}
| Caste
|
*binocular vision arc
*non-binocular vision arc
| The width of the creature's vision arcs, in degrees (i.e. 0 to 360). The first number is binocular vision, the second is non-binocular vision. Binocular vision has a minimum of about 10 degrees, monocular, a maximum of about 350 degrees. Values past these limits will be accepted, but will default to ~10 degrees and ~350 degrees respectively. Defaults are 60:120.
|}

{{alphabetical TOC|style=margin: 1em auto;}}

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

|-
| {{text anchor|WAGON_PULLER}}
| Caste
|
| Allows the creature to pull caravan wagons. If a civilization doesn't have access to any, it is restricted to trading with pack animals.

|-
| {{text anchor|WEBBER}}
| Caste
|
* [[material token]]
| Allows the creature to create [[web]]s, and defines what the webs are made of.

|-
| {{text anchor|WEBIMMUNE}}
| Caste
|
| The creature will not get caught in thick [[web]]s. Used by creatures who can shoot thick webs (such as [[giant cave spider]]s) in order to make them immune to their own attacks.
|}

==Attack Tokens==

Attacks can use four different part selection criteria; while all vanilla attacks use only BODYPART (e.g. ATTACK:PUNCH:BODYPART:BY_TYPE:GRASP), there are other options available.

{| {{prettytable}}
|- bgcolor="#ddd"
! width="20%" | Part type token
! width="30%" | Arguments
! width="60%" | Description

|-
| {{text anchor|BODYPART}}
|
* BY_TYPE/BY_TOKEN/BY_CATEGORY
* type/token/category
| This attack uses a particular body part; for example, BY_TYPE:GRASP will make it use any part that can hold onto an object.

|-
| {{text anchor|TISSUE_LAYER}}
|
* BY_TYPE/BY_TOKEN/BY_CATEGORY
* type/token/category
* tissue layer
| This attack uses a specific tissue layer on a specific body part; BY_TYPE:GRASP:BONE will make it use the bone of the hands.

|-
| {{text anchor|CHILD_BODYPART_GROUP}}
|
* BY_TYPE/BY_TOKEN/BY_CATEGORY
* type/token/category
* BY_TYPE/BY_TOKEN/BY_CATEGORY
* type/token/category
| Uses a body part that is subordinate to another; BY_CATEGORY:ARM_LOWER:BY_TYPE:GRASP will make it use every hand attached to each lower arm (so it will generate one attack per lower arm, each of which will use every hand on that arm, assuming there are multiple hands per arm).

|-
| {{text anchor|CHILD_TISSUE_LAYER_GROUP}}
|
* BY_TYPE/BY_TOKEN/BY_CATEGORY
* type/token/category
* BY_TYPE/BY_TOKEN/BY_CATEGORY
* type/token/category
* tissue layer
| As CHILD_BODYPART_GROUP, but specifying a tissue, too.

|}

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

|-
| {{text anchor|ATTACK_SKILL}}
| Caste
|
*[[Skill token]]
| Defines the skill used by the attack.

|-
| {{text anchor|ATTACK_VERB}}
| Caste
|
*2nd person
*3rd person
| Descriptive text for the attack.

|-
| {{text anchor|ATTACK_CONTACT_PERC}}
| Caste
|
*% value
| The contact area of the attack, measured in % of the body part's volume. Note that all attack percentages can be more than 100%.

|-
| {{text anchor|ATTACK_PENETRATION_PERC}}
| Caste
|
*% value
| The penetration value of the attack, measured in % of the body part's volume. Requires ATTACK_FLAG_EDGE. Maximum value: 15000.

|-
| {{text anchor|ATTACK_PRIORITY}}
| Caste
|
*MAIN or SECOND
| Usage frequency. MAIN attacks are 100 times more frequently chosen than SECOND. Opportunity attacks ignore this preference.

|-
| {{text anchor|ATTACK_VELOCITY_MODIFIER}}
| Caste
|
*number
| The velocity multiplier of the attack, multiplied by 1000.

|-
| {{text anchor|ATTACK_FLAG_CANLATCH}}
| Caste
|
| Attacks that damage tissue have the chance to latch on in a wrestling hold. The grabbing bodypart can then use the "shake around" wrestling move, causing severe, armor-bypassing tensile damage according to the attacker's body volume.

|-
| {{text anchor|ATTACK_FLAG_WITH}}
| Caste
|
| Displays the name of the body part used to perform an attack while announcing it, e.g. "The weaver punches the bugbat with his right hand".

|-
| {{text anchor|ATTACK_FLAG_EDGE}}
| Caste
|
| The attack is edged, with all the effects on physical resistance and contact area that it entails.

|-
| {{text anchor|ATTACK_PREPARE_AND_RECOVER}}
| Caste
|
* Preparation time
* Recovery time
| Determines the length of time to prepare this attack and until one can perform this attack again. Values appear to be calculated in adventure mode ticks.

|-
| {{text anchor|ATTACK_FLAG_BAD_MULTIATTACK}}
| Caste
|
| Multiple strikes with this attack cannot be performed effectively.

|-
| {{text anchor|ATTACK_FLAG_INDEPENDENT_MULTIATTACK}}
| Caste
|
| Multiple strikes with this attack can be performed with no penalty. The creature will use all attacks with this token at once.

|-
| {{text anchor|SPECIALATTACK_INJECT_EXTRACT}}
| Caste
|
*<[[material token]]>
*<[[Material_definition_token#Material_States|material state]]>
*<min quantity>
*<max quantity>
| When added to an attack, causes the attack to inject the specified material into the victim's bloodstream. Once injected, the material will participate in [[temperature|thermal]] exchange within the creature - injecting something like molten [[iron]] (INORGANIC:IRON:LIQUID) would cause most unmodded creatures to melt (note that some of the injected material also [[contaminant|splatters]] over the bodypart used to carry out the attack, so it should be protected appropriately). If the injected material has an associated [[syndrome]] with the [[Syndrome#SYN_INJECTED|[SYN_INJECTED]]] token, it will be transmitted to the victim. If the attack is blunt, the injected material lacks the [[Material definition token#ENTERS_BLOOD|[ENTERS_BLOOD]]] token, the attacked bodypart has no [[Tissue_definition_token#VASCULAR|[VASCULAR]]] tissues, or the victim is bloodless, the material will splatter over the attacked body part instead.

|-
| {{text anchor|SPECIALATTACK_INTERACTION}}
| Caste
|
*interaction
| When this attack lands successfully, a specified interaction will take effect on the target creature. The attack must break the target creature's skin in order to work. This will take effect in worldgen as well. If the attack would break skin, the interaction will occur '''before the attack actually lands'''.

|-
| {{text anchor|SPECIALATTACK_SUCK_BLOOD}}
| Caste
|
*min
*max
| Successful attack draws out an amount of blood randomized between the min and max value. Beware that this '''will''' trigger any ingestion syndromes attached to the target creature's blood - for example, using this attack on a vampire will turn you into one too.
|}

==Tissue Layer Tokens==
Tissue layers are added to a creature's body parts by the creature tokens [[#TISSUE_LAYER|TISSUE_LAYER]], [[#TISSUE_LAYER_OVER|TISSUE_LAYER_OVER]], [[#TISSUE_LAYER_UNDER|TISSUE_LAYER_UNDER]], and the body detail plan token [[#TL_LAYERS|TL_LAYERS]].

These tissue layers are not the same thing as tissues, which are defined at creature level, but rather applications of the tissues. If the SKIN tissue of a creature is the more general and abstract notion of what skin is for that creature, then a tissue layer may be the "actual" skin on the creature's nose, head, or second toe. As most creatures have more than one body part, tissue layers are normally selected en masse.

Some tissue layer tokens are analogous to tissue definition tokens, e.g. [[#TL_CONNECTS|TL_CONNECTS]] to [[tissue_definition_token#CONNECTS|CONNECTS]].

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

|-
| {{text anchor|SELECT_TISSUE_LAYER}}
| Caste
|
*TISSUE
*BY_CATEGORY, BY_TYPE, BY_TOKEN
*Location - category, type, or token | Selects a tissue at a location
* (optional) FRONT, BACK, LEFT, RIGHT, TOP, BOTTOM, AROUND.
| Begins a selection of tissue layers.
[SELECT_TISSUE_LAYER:HEART:BY_TYPE:HEART]

|-
| {{text anchor|PLUS_TISSUE_LAYER}}
| Caste
|
*TISSUE
*BY_CATEGORY, BY_TYPE, BY_TOKEN
*Location - category, type, or token
| Adds tissue layers to those selected.

|-
| {{text anchor|SET_TL_GROUP}}
| Caste
|
*TISSUE
*BY_CATEGORY, BY_TYPE, BY_TOKEN
*Location - category, type, or token
*tissue
| Begins a selection of tissue layers. Only usable for descriptor and cosmetic purposes.

Research has implied it may be redundant with SELECT_TISSUE_LAYER, as the latter allows for cosmetics as well as "functional" tokens such as TL_MAJOR_ARTERIES. Vanilla raws still use SET_TL_GROUP though, for all cosmetic purposes. More research is needed on this subject.

|-
| {{text anchor|PLUS_TL_GROUP}}
| Caste
|
*BY_CATEGORY, BY_TYPE, BY_TOKEN
*Location - category, type, or token
*tissue
| Adds tissue layers to those selected. Like SET_TL_GROUP, it may be redundant even if used in the vanilla raws.

|-
| {{text anchor|SET_LAYER_TISSUE}}
| Caste
|
*TISSUE
| Sets a selected tissue layer to be made of a different tissue.

|-
| {{text anchor|SHEARABLE_TISSUE_LAYER}}
| Caste
|
* tissue modifier
* required value
| Tissue layer can be sheared for its component material. The specified modifier must be at least of the desired value for shearing to be possible (for example, a [[llama]]'s wool must have a LENGTH of 300 before it is shearable).

|-
| {{text anchor|TISSUE_LAYER_APPEARANCE_MODIFIER}}
| Caste
|
*QUALITY
*lowest
*lower
*low
*median
*high
*higher
*highest
| Sets the range of qualities, including LENGTH, DENSE, HIGH_POSITION, CURLY, GREASY, WRINKLY

|-
| {{text anchor|TISSUE_STYLE_UNIT}}
| Caste
|
*tissue style unit ID
*shaping
| Sets tissue layer to be the target of TISSUE_STYLE token specified for an entity, works only on entity members. Mostly used with tissues HAIR, BEARD, MOUSTACHE, SIDEBURNS.

|-
| {{text anchor|TL_COLOR_MODIFIER}}
| Caste
|
*COLOR
*freq
*COLOR
*freq etc.
| Creates a list of colors/color patterns, giving each a relative frequency. If the given color or pattern does not exist, the tissue is described as being "transparent".

|-
| {{text anchor|TLCM_GENETIC_MODEL}}
| Caste
|
| The way the color modifier is passed on to offspring. May or may not work right now.{{verify}}

|-
| {{text anchor|TLCM_IMPORTANCE}}
| Caste
|
*number
| Presumably modifies the importance of the tissue layer color modifier, for description purposes.
HOWEVER using this appears to remove all mention of colour from creature descriptions. It does not appear in any default creatures.

|-
| {{text anchor|TLCM_NOUN}}
| Caste
|
*name
*SINGULAR or PLURAL
| Names the tissue layer color modifier, and determines the noun. Also used by [[Utility:Stonesense|Stonesense]] for colouring body parts.

|-
| {{text anchor|TLCM_TIMING}}
| Caste
|
*ROOT
*start change window years
*days
*end change window years
*days
| Determines the point in the creature's life when the color change begins and ends.

|-
| {{text anchor|TL_CONNECTS}}
| Caste
|
| Gives the CONNECTS attribute to selected layers.

|-
| {{text anchor|TL_HEALING_RATE}}
| Caste
|
*value
| Changes the HEALING_RATE of the selected tissue layers.

|-
| {{text anchor|TL_MAJOR_ARTERIES}}
| Caste
|
| Gives the "major arteries" attribute to selected layers. Used to add massive bleeding properties to the throat, made from skin.

|-
| {{text anchor|TL_PAIN_RECEPTORS}}
| Caste
|
*value
| Changes the number of pain receptors for selected tissue layers.

|-
| {{text anchor|TL_RELATIVE_THICKNESS}}
| Caste
|
*value
| Changes the relative thickness for selected tissue layers.

|-
| {{text anchor|TL_VASCULAR}}
| Caste
|
*value
| Sets a new VASCULAR value (which modulates bleeding) for selected tissue layers.

|}

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

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