v50 Steam/Premium information for editors
  • v50 information can now be added to pages in the main namespace. v0.47 information can still be found in the DF2014 namespace. See here for more details on the new versioning policy.
  • Use this page to report any issues related to the migration.
This notice may be cached—the current version can be found here.

Difference between revisions of "Creature token"

From Dwarf Fortress Wiki
Jump to navigation Jump to search
(in this edit, ive added important new information to the HUNTS_VERMIN creature token)
(490 intermediate revisions by 98 users not shown)
Line 1: Line 1:
−
{{Quality|Fine|18:45, 26 August 2014 (UTC)}}
+
{{Quality|Exceptional}}
−
{{Migrated_article}}
 
 
{{av}}
 
{{av}}
 +
{{Modding}}
  
−
A full list of all known creature tokens.
+
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.  
  
−
__NOTOC__
+
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.
  
−
<div align="center">
+
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)
−
{{alphabetical TOC}}
+
 
−
</div>
+
__NOTOC__
 +
{{clear}}
 +
{{alphabetical TOC|style=margin: 1em auto;}}
  
 
==A==
 
==A==
Line 23: Line 26:
 
| Caste
 
| Caste
 
|
 
|
−
| Tame creature cannot be made available for adoption, instead automatically adopting whoever it wants. It appears that the basic requirements for adoption are intact; for example, the creature is more likely to adopt an owner which likes creatures of that species.{{verify}}
+
| 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".
  
 
|-
 
|-
Line 29: Line 32:
 
| Caste
 
| Caste
 
|   
 
|   
−
| Creature needs alcohol to get through the working day, choosing to drink booze instead of water if possible. Going sober for too long reduces speed.
+
| 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.
  
 
|-
 
|-
Line 35: Line 38:
 
| Caste
 
| Caste
 
|   
 
|   
−
| Sets if the creature is active in day, night, and twilight. Seems to be a separate value from DIURNAL/NOCTURNAL/CREPUSCULAR, rather than implying them.  
+
| 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}}
 
| {{text anchor|ALTTILE}}
 
| Creature
 
| Creature
−
|
+
|  
−
| If set, the creature will blink between its [TILE] and its [ALTTILE].  
+
*'character' or tile number
 +
| If set, the creature will blink between its {{token|TILE|c}} and its ALTTILE.  
  
 
|-
 
|-
Line 47: Line 51:
 
| Caste
 
| Caste
 
|   
 
|   
−
| Instead of charging relentlessly at prey, a creature with this tag will wait till the prey is within a few squares before charging.{{verify}}
+
| 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}}
  
 
|-
 
|-
Line 53: Line 57:
 
| Caste
 
| Caste
 
|   
 
|   
−
| Allows a creature to breathe with or without [[water]]. Implies [AQUATIC].
+
| 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}}
 
| {{text anchor|APP_MOD_DESC_RANGE}}
−
| Caste
+
| Appearance Modifier
 
|
 
|
−
*Range
+
*Range (6 values, low to high)
−
| [http://www.bay12forums.com/smf/index.php?topic=60554.msg1766793#msg1766793 Forum post describing how description ranges work]
+
| 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.
  
 
|-
 
|-
 
| {{text anchor|APP_MOD_GENETIC_MODEL}}
 
| {{text anchor|APP_MOD_GENETIC_MODEL}}
−
| Caste
+
| Appearance Modifier
 
|
 
|
 
*Model (Accepts DOMINANT_MORE, DOMINANT_LESS, and MIX)
 
*Model (Accepts DOMINANT_MORE, DOMINANT_LESS, and MIX)
Line 71: Line 77:
 
|-
 
|-
 
| {{text anchor|APP_MOD_IMPORTANCE}}
 
| {{text anchor|APP_MOD_IMPORTANCE}}
−
| Caste
+
| Appearance Modifier
 
|
 
|
 
*number
 
*number
Line 78: Line 84:
 
|-
 
|-
 
| {{text anchor|APP_MOD_NOUN}}
 
| {{text anchor|APP_MOD_NOUN}}
−
| Caste
+
| Appearance Modifier
 
|  
 
|  
 
*noun
 
*noun
 
*SINGULAR or PLURAL  
 
*SINGULAR or PLURAL  
−
| creates a noun for the appearance and whether it is singular or plural
+
| Creates a noun for the appearance, and whether it is singular or plural.
  
 
|-
 
|-
 
| {{text anchor|APP_MOD_RATE}}
 
| {{text anchor|APP_MOD_RATE}}
−
| Caste
+
| Appearance Modifier
 
|  
 
|  
 
*Rate (integer)
 
*Rate (integer)
−
*Scale (DAILY, YEARLY)
+
*Scale (DAILY, YEARLY)
−
*min:max of growth
+
*min (growth)
−
*start year:start day
+
*max (growth)
−
*end year:end day  
+
*start year
−
| setting the growth rate of the modifier. The last two tokens can be replaced by NO_END to have growth continue indefinitely.
+
*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}}
 
| {{text anchor|APPLY_CREATURE_VARIATION}}
−
| Special
+
| Caste
 
|  
 
|  
−
*CV TEMPLATE NAME
+
*creature variation ID
−
| Applies the specified [[creature variation token|creature variation]].
+
*(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.
  
 
|-
 
|-
Line 106: Line 116:
 
| Special
 
| Special
 
|   
 
|   
−
| Applies the effects of all pending [[#CV_ADD_TAG|CV_ADD_TAG]] and [[#CV_REMOVE_TAG|CV_REMOVE_TAG]] tokens that have been defined in the current creature.
+
| 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.
  
 
|-
 
|-
Line 112: Line 122:
 
| Caste
 
| Caste
 
|   
 
|   
−
| Creature can breathe in water, but air-drowns on dry land.  
+
| Enables the creature to breathe in water, but causes it to air-drown on dry land.  
  
 
|-
 
|-
Line 118: Line 128:
 
| Caste
 
| Caste
 
|   
 
|   
−
| Does not appear in arena mode list.
+
| Causes the creature to be excluded from the [[object testing arena]]'s creature spawning list.  Typically applied to spoileriffic creatures.
  
 
|-
 
|-
Line 124: Line 134:
 
| Creature
 
| Creature
 
|
 
|
−
| Can be kept in artificial hives by beekeepers.
+
| Enables the creature to be kept in artificial [[hive]]s by [[beekeeper]]s.
  
 
|-
 
|-
Line 130: Line 140:
 
| Caste
 
| Caste
 
|
 
|
−
| Does not attack or frighten creatures with the NATURAL tag.
+
| Prevents the creature from attacking or frightening creatures with the {{Token|NATURAL|c}} tag.
  
 
|-
 
|-
Line 137: Line 147:
 
|  
 
|  
 
*token
 
*token
−
*bodypart
+
*selection criteria (it's complicated)
−
*selection criteria
 
−
*location
 
 
| Defines the attack name, and the body part used. See [[#Attack Tokens|below]] for valid subtokens
 
| Defines the attack name, and the body part used. See [[#Attack Tokens|below]] for valid subtokens
 
'''Example:'''<br />
 
'''Example:'''<br />
−
[ATTACK:GORE:BODYPART:BY_CATEGORY:HORN]<br />
+
<code>[ATTACK:GORE:BODYPART:BY_CATEGORY:HORN]</code><br />
−
''GORE'' : name of the attack<br />
+
''GORE'' = name of the attack<br />
−
''BODYPART:BY_CATEGORY:HORN'' :  the horn is used to attack (presuming the creature has one)
+
''BODYPART:BY_CATEGORY:HORN'' = the horn is used to attack (presuming the creature has one)
  
 
|-
 
|-
 
| {{text anchor|ATTACK_TRIGGER}}
 
| {{text anchor|ATTACK_TRIGGER}}
 
| Caste
 
| Caste
−
| pop:exported wealth:created wealth
+
|  
−
| Specifies when a [[megabeast]] will attack the fortress.
+
*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.
  
 
|}
 
|}
  
−
<div align="center">
+
{{alphabetical TOC|style=margin: 1em auto;}}
−
{{alphabetical TOC}}
 
−
</div>
 
  
 
==B==
 
==B==
Line 169: Line 178:
 
| {{text anchor|BABY}}
 
| {{text anchor|BABY}}
 
| Caste
 
| Caste
−
| integer  
+
|  
−
| Age at which creature is considered a child. Default is zero. One can think of this as the duration of the baby stage.
+
*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}}
 
| {{text anchor|BABYNAME}}
 
| Caste
 
| Caste
−
| singular:plural  
+
|  
−
| Defines a new name for a creature in baby state at the caste level. For non-caste-specific baby names, see GENERAL_BABY_NAME.
+
*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}}
 
| {{text anchor|BEACH_FREQUENCY}}
 
| Caste
 
| Caste
−
|
+
|  
−
| [[Whale]]s and [[Sea nettle jellyfish|jellyfish]] have this. Controls the beaching frequency of the creature.  
+
*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.
  
 
|-
 
|-
Line 188: Line 201:
 
| Caste
 
| Caste
 
|   
 
|   
−
| The creature is non-aggressive by default, but may lash out if agitated or disturbed.
+
| 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.
  
 
|-
 
|-
Line 195: Line 208:
 
|  
 
|  
 
* [[biome token]]
 
* [[biome token]]
−
| Select a [[Biome]] the creature may appear in.
+
| Select a [[biome]] the creature may appear in.
  
 
|-
 
|-
Line 201: Line 214:
 
| Caste
 
| Caste
 
|  
 
|  
−
* [[material token]]
+
* <[[material token]]>
−
*matter state (LIQUID, GAS, SOLID)
+
* <[[Material_definition_token#Material_States|material state]]>
 
| Specifies what the creature's blood is made of.
 
| Specifies what the creature's blood is made of.
  
Line 209: Line 222:
 
| Caste
 
| Caste
 
|  
 
|  
−
| Seems to be required to make the creature denouncable as a creature of the night.
+
| 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}}
 
| {{text anchor|BODY}}
 
| Caste
 
| Caste
−
| body parts  
+
|  
 +
*body parts  
 
| Draws body parts from OBJECT:BODY files (such as body_default.txt)
 
| Draws body parts from OBJECT:BODY files (such as body_default.txt)
 
'''Example:'''<br />
 
'''Example:'''<br />
 
[BODY:BODY_WITH_HEAD_FLAG:HEART:GUTS:BRAIN:MOUTH] <br />
 
[BODY:BODY_WITH_HEAD_FLAG:HEART:GUTS:BRAIN:MOUTH] <br />
−
This is the body from a [[Purring maggot]]. It creates a body with head, a heart, some guts, a brain, and a mouth. That's all a maggot needs.
+
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}}
  
 
|-
 
|-
Line 225: Line 243:
 
|  
 
|  
 
*ATTRIBUTE
 
*ATTRIBUTE
−
*lowest:lower:low:median:high:higher:highest  
+
*lowest
−
| 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.
+
*lower
 +
*low
 +
*median
 +
*high
 +
*higher
 +
*highest  
 +
| These body modifiers give individual creatures different characteristics. In the case of HEIGHT, BROADNESS and LENGTH, the modifier is also a percentage change to the BODY_SIZE of the individual creature. The seven numbers afterward give a distribution of ranges. Each interval has an equal chance of occurring.
 
'''Example:'''<br />
 
'''Example:'''<br />
 
[BODY_APPEARANCE_MODIFIER:HEIGHT:90:95:98:100:102:105:110] <br />
 
[BODY_APPEARANCE_MODIFIER:HEIGHT:90:95:98:100:102:105:110] <br />
 
''HEIGHT'' : marks the height to be changed <br />
 
''HEIGHT'' : marks the height to be changed <br />
−
''90:95:98:100:102:105:110'' : sets the range from the shortest (90% of the average height) to the tallest (110% of the average height) creature variation.
+
''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}}
 
| {{text anchor|BODY_DETAIL_PLAN}}
 
| Caste
 
| Caste
−
| PlanName, PlanName:type:type:type:etc.
+
|  
−
| loads a plan listed OBJECT:BODY_DETAIL_PLAN files, such as b_detail_plan_default.txt. Mass applies USE_MATERIAL_TEMPLATE, mass alters RELSIZE, alters body part positions, and will allow tissue layers to be defined. Tissue layers are defined in order of skin to bone here.
+
*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:'''<br />
 
'''Example:'''<br />
 
[BODY_DETAIL_PLAN:VERTEBRATE_TISSUE_LAYERS:SKIN:FAT:MUSCLE:BONE:CARTILAGE] <br />
 
[BODY_DETAIL_PLAN:VERTEBRATE_TISSUE_LAYERS:SKIN:FAT:MUSCLE:BONE:CARTILAGE] <br />
Line 246: Line 272:
 
| {{text anchor|BODY_SIZE}}
 
| {{text anchor|BODY_SIZE}}
 
| Caste
 
| 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.
+
*years
 +
*days
 +
*size  
 +
| Sets size at a given age. Size is in cubic centimeters, and for normal body materials, is roughly equal to the creature's average weight in grams.
 
'''Example:'''<br />
 
'''Example:'''<br />
 
[BODY_SIZE:0:0:10000]<br />
 
[BODY_SIZE:0:0:10000]<br />
 
[BODY_SIZE:1:168:50000]<br />
 
[BODY_SIZE:1:168:50000]<br />
 
[BODY_SIZE:12:0:220000]<br />
 
[BODY_SIZE:12:0:220000]<br />
−
This describes the size of a [[minotaur]]. His birth size would be 10,000 cm<sup>3</sup> (~10 kg). At 1 year and 168 days old he would be 50,000 cm<sup>3</sup> (~50 kg). And as an adult (at 12 years old) he would be 220,000 cm<sup>3</sup> and weigh roughly 220 kg.
+
This describes the size of a [[minotaur]]. Its birth size would be 10,000 cm<sup>3</sup> (~10 kg). At 1 year and 168 days old it would be 50,000 cm<sup>3</sup> (~50 kg). And as an adult (at 12 years old) it would be 220,000 cm<sup>3</sup> and weigh roughly 220 kg.
  
 
|-
 
|-
 
| {{text anchor|BODYGLOSS}}
 
| {{text anchor|BODYGLOSS}}
 
| Caste
 
| Caste
−
| gloss  
+
|  
 +
*gloss  
 
| Substitutes body part text with replacement text. Draws gloss information from OBJECT:BODY files (such as body_default.txt)
 
| Substitutes body part text with replacement text. Draws gloss information from OBJECT:BODY files (such as body_default.txt)
  
Line 264: Line 294:
 
| Caste
 
| Caste
 
|   
 
|   
−
| Creature eats bones. Implies CARNIVORE and has the same worldgen problem.
+
| 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]].  
  
 
|-
 
|-
Line 271: Line 307:
 
|  
 
|  
 
*QUALITY
 
*QUALITY
−
*lowest:lower:low:median:high:higher:highest  
+
*lowest
−
| 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)
+
*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}}
 
| {{text anchor|BUILDINGDESTROYER}}
 
| Caste
 
| Caste
−
| 1 or 2  
+
|  
−
| Allows a creature to destroy furniture and buildings. Value [1] targets mostly doors, hatches, furniture and the like. Value [2] targets anything not made with the b + C commands.  
+
*1 or 2  
 +
| Allows a creature to destroy furniture and buildings. Value [1] targets mostly doors, hatches, furniture and the like. Value [2] targets anything not made with the {{k|b}} + {{k|C}} commands.  
 
|}
 
|}
  
−
<div align="center">
+
{{alphabetical TOC|style=margin: 1em auto;}}
−
{{alphabetical TOC}}
 
−
</div>
 
  
 
==C==
 
==C==
Line 296: Line 343:
 
| {{text anchor|CAN_DO_INTERACTION}}
 
| {{text anchor|CAN_DO_INTERACTION}}
 
| Caste
 
| Caste
−
| interaction token
+
|  
−
| The creature can perform an interaction. See [[interaction token]].
+
*interaction token
 +
| The creature can perform an interaction. See [[interaction token]].
  
 
|-
 
|-
Line 303: Line 351:
 
| Caste
 
| Caste
 
|   
 
|   
−
| The creature gains skills and can have professions. Note that this token makes the creature unable to be butchered by an adventurer so it is not recommended for uncivilized monsters. Adventurers lacking this token can allocate but not increase attributes and skills. skills allocated will disappear on start.
+
| 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.
  
 
|-
 
|-
Line 309: Line 357:
 
| Caste
 
| Caste
 
|   
 
|   
−
| Can talk. Note that it is not necessary for a creature to gain social skills. If a member of a civilization (such as a pet) has this token, it'll need to eat and drink.{{verify}}
+
| Can [[talking|talk]]. Note that this is not necessary for a creature to gain social skills.
  
 
|-
 
|-
 
| {{text anchor|CANNOT_CLIMB}}
 
| {{text anchor|CANNOT_CLIMB}}
−
| Caste {{Verify}}
+
| Caste
 
|   
 
|   
−
| Creature cannot climb, even if it has free grasps.
+
| Creature cannot [[climber|climb]], even if it has free grasp parts.
  
 
|-
 
|-
Line 321: Line 369:
 
| Caste
 
| Caste
 
|   
 
|   
−
| Creature cannot jump.
+
| Creature cannot [[jump]].
  
 
|-
 
|-
Line 327: Line 375:
 
| Caste
 
| Caste
 
|   
 
|   
−
| Alias for NOT_LIVING
+
| Acts like {{token|NOT_LIVING|c}}, except that {{token|OPPOSED_TO_LIFE|c}} creatures will attack them.
  
 
|-
 
|-
Line 333: Line 381:
 
| Caste
 
| Caste
 
|   
 
|   
−
| Allows the creature to open doors.  
+
| 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}}
  
 
|-
 
|-
Line 339: Line 387:
 
| Caste
 
| Caste
 
|   
 
|   
−
| Creature ''only'' eats meat. If the creature goes on rampages in worldgen, it will often devour the people/animals it kills. Currently bugged in worldgen -- exclusively carnivore civilizations always starve out (possibly false in 40.xx). Goblins and kobolds live off raw exceptions. Civilizations with [NO_EAT] token will still starve to death.
+
| 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.
  
 
|-
 
|-
Line 346: Line 394:
 
|  
 
|  
 
*name  
 
*name  
−
| Defines a caste.
+
| Defines a [[caste]].
  
 
|-
 
|-
Line 353: Line 401:
 
|
 
|
 
*tile number or "letter"
 
*tile number or "letter"
−
| Caste-specific ALT_TILE. Requires CASTE_TILE.
+
| Caste-specific {{token|ALTTILE|c}}. Requires {{token|CASTE_TILE|c}}.
  
 
|-
 
|-
Line 362: Line 410:
 
*bg
 
*bg
 
*brightness
 
*brightness
−
| Caste-specific COLOR.
+
| Caste-specific {{token|COLOR|c}}.
  
 
|-
 
|-
Line 371: Line 419:
 
*bg
 
*bg
 
*brightness
 
*brightness
−
| Caste-specific GLOWCOLOR.
+
| Caste-specific {{token|GLOWCOLOR|c}}.
  
 
|-
 
|-
Line 378: Line 426:
 
|
 
|
 
*tile value or "letter"
 
*tile value or "letter"
−
| Caste-specific GLOWTILE.
+
| Caste-specific {{token|GLOWTILE|c}}.
  
 
|-
 
|-
 
| {{text anchor|CASTE_NAME}}
 
| {{text anchor|CASTE_NAME}}
 
| Caste
 
| Caste
−
| singular:plural:adjective  
+
|  
−
| Caste-specific NAME.
+
*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".
  
 
|-
 
|-
Line 393: Line 444:
 
*singular
 
*singular
 
*plural  
 
*plural  
−
| Caste-specific PROFESSION_NAME.
+
| Caste-specific {{token|PROFESSION_NAME|c}}.
  
 
|-
 
|-
 
| {{text anchor|CASTE_SOLDIER_ALTTILE}}
 
| {{text anchor|CASTE_SOLDIER_ALTTILE}}
 
| Caste
 
| Caste
−
| 'character' or tile number
+
|  
−
| Caste-specific SOLDIER_ALTTILE. Requires CASTE_SOLDIER_TILE.
+
*'character' or tile number
 +
| Caste-specific {{token|SOLDIER_ALTTILE|c}}. Requires {{token|CASTE_SOLDIER_TILE|c}}.
  
 
|-
 
|-
 
| {{text anchor|CASTE_SOLDIER_TILE}}
 
| {{text anchor|CASTE_SOLDIER_TILE}}
 
| Caste
 
| Caste
−
| 'character' or tile number
+
|  
−
| Caste-specific CREATURE_SOLDIER_TILE.
+
*'character' or tile number
−
 
+
| Caste-specific {{token|CREATURE_SOLDIER_TILE|c}}.
−
|-
 
−
| {{text anchor|CASTE_SPEECH}}
 
−
| Caste
 
−
| speech file
 
−
| Caste-specific SPEECH.
 
  
 
|-
 
|-
Line 418: Line 465:
 
|
 
|
 
* tile number or "letter"
 
* tile number or "letter"
−
| Caste-specific CREATURE_TILE.
+
| Caste-specific {{token|CREATURE_TILE|c}}.
  
 
|-
 
|-
Line 424: Line 471:
 
| Caste
 
| Caste
 
|   
 
|   
−
| Gives the creature a bonus in caves. Also causes [[Cave adaptation]].  
+
| Gives the creature a bonus in caves. Also causes [[cave adaptation]].  
  
 
|-
 
|-
 
| {{text anchor|CDI}}
 
| {{text anchor|CDI}}
 
| Caste
 
| Caste
−
| Varies
+
|  
−
| Specifies details for the preceding CAN_DO_INTERACTION token. See [[Interaction token]].
+
*Varies
 +
| Specifies interaction details following a {{token|CAN_DO_INTERACTION|c}} token. See [[interaction token]].
  
 
|-
 
|-
 
| {{text anchor|CHANGE_BODY_SIZE_PERC}}
 
| {{text anchor|CHANGE_BODY_SIZE_PERC}}
 
| Caste
 
| Caste
−
| integer
+
|  
 +
*integer
 
| Multiplies body size by a factor of (integer)%. 50 halves size, 200 doubles.
 
| Multiplies body size by a factor of (integer)%. 50 halves size, 200 doubles.
  
Line 441: Line 490:
 
| {{text anchor|CHANGE_FREQUENCY_PERC}}
 
| {{text anchor|CHANGE_FREQUENCY_PERC}}
 
| Creature
 
| Creature
−
| integer
+
|  
−
| Multiplies frequency by a factor of (integer)%.
+
*integer
 +
| Multiplies frequency by a factor of (integer)%.
  
 
|-
 
|-
 
| {{text anchor|CHILD}}
 
| {{text anchor|CHILD}}
 
| Caste
 
| Caste
−
| integer  
+
|  
−
| age at which creature is considered an adult. One can think of this as the duration of the child stage.
+
*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}}
 
| {{text anchor|CHILDNAME}}
 
| Caste
 
| Caste
−
| singular:plural  
+
|  
−
| Defines a new name for a creature in child state at the caste level. For non-caste-specific child names, see GENERAL_CHILD_NAME.
+
*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}}.
  
 
|-
 
|-
Line 462: Line 515:
 
*min
 
*min
 
*max
 
*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.
+
| 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.
−
e.g. [CLUSTER_NUMBER:1:3]
 
  
 
|-
 
|-
Line 471: Line 523:
 
*min
 
*min
 
*max
 
*max
−
|Number of eggs laid in one sitting.
+
|Number of [[egg]]s laid in one sitting.
  
 
|-
 
|-
Line 482: Line 534:
 
| {{text anchor|COLOR}}
 
| {{text anchor|COLOR}}
 
| Creature
 
| Creature
−
| foreground:background:brightness  
+
|  
 +
*foreground
 +
*background
 +
*brightness  
 
| Color of the creature's tile. See [[Color]] for usage.
 
| Color of the creature's tile. See [[Color]] for usage.
  
Line 489: Line 544:
 
| Caste
 
| Caste
 
|   
 
|   
−
| Any civilization with USE_COMMON_DOMESTIC tag (humans, dwarves) has domesticated this creature by default and always has access to it, even without any wild populations. Useless without PET, PACK_ANIMAL, WAGON_PULLER or MOUNT tags and invalid on FANCIFUL creatures.
+
| 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.
  
 
|-
 
|-
Line 495: Line 550:
 
| Caste
 
| Caste
 
|
 
|
−
| Creatures of this caste's species with the SPOUSE_CONVERTER and NIGHT_CREATURE_HUNTER tokens will kidnap SPOUSE_CONVERSION_TARGETs of an appropriate sex and convert them into castes with CONVERTED_SPOUSE.
+
| 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.
  
 
|-
 
|-
Line 501: Line 556:
 
| Caste
 
| Caste
 
|   
 
|   
−
| Set this to allow the creature to be cooked in meals without first being butchered/cleaned. Used for mussels, for one.
+
| 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.
  
 
|-
 
|-
Line 507: Line 562:
 
| Caste
 
| Caste
 
|  
 
|  
−
| Creature is 'berserk' and will attack all other creatures, except members of its own species that ALSO have the CRAZED tag.
+
| 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.
  
 
|-
 
|-
Line 513: Line 568:
 
| Special
 
| Special
 
|  
 
|  
−
*CREATURE NAME
+
*creature ID
−
| Copies tags from another specified creature.
+
| 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.
  
 
|-
 
|-
Line 521: Line 583:
 
|
 
|
 
*classname
 
*classname
−
| An arbitrary creature classification. Can be set to anything, but only existing uses are GENERAL_POISON (used in syndromes) and EDIBLE_GROUND_BUG (valid targets for GOBBLE_VERMIN_x tokens). A single creature can have multiple classes. Eligibility for certain entity positions can also be permitted or restricted by this tag.
+
| 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}}
 
| {{text anchor|CREATURE_SOLDIER_TILE}}
 
| Creature
 
| Creature
−
| 'character' or tile number
+
|  
−
| Creatures active in their civilization's military will use this tile instead.
+
*'character' or tile number
 +
| Creatures active in their civilization's [[military]] will use this tile instead.
  
 
|-
 
|-
 
| {{text anchor|CREATURE_TILE}}
 
| {{text anchor|CREATURE_TILE}}
 
| Creature
 
| Creature
−
| 'character' or tile number  
+
|  
 +
*'character' or tile number  
 
| The symbol of the creature in ASCII mode.
 
| The symbol of the creature in ASCII mode.
  
Line 539: Line 610:
 
| Caste
 
| Caste
 
|   
 
|   
−
| Sets if the creature is active at twilight.
+
| Sets the creature to be active at twilight in adventurer mode.
  
 
|-
 
|-
Line 545: Line 616:
 
| Caste
 
| Caste
 
|   
 
|   
−
| Allows a creature to steal and eat edible items from a site.  
+
| 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.
  
 
|-
 
|-
Line 551: Line 622:
 
| Caste
 
| Caste
 
|   
 
|   
−
| Allows a creature to (very quickly) drink your alcohol. Or spill the barrel to the ground. Also affects undead versions of the creature.
+
| 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.
  
 
|-
 
|-
Line 557: Line 628:
 
| Caste
 
| Caste
 
|   
 
|   
−
| Allows a creature to steal things (apparently the highest value it can find). If the creature goes on rampages in worldgen, it will often steal items instead of attacking. Kea birds are infamous for this.
+
| 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.
  
 
|-
 
|-
Line 564: Line 635:
 
|  
 
|  
 
*TAG NAME  
 
*TAG NAME  
−
| Adds a tag. Used in conjunction with creature variation templates.
+
| Adds a tag. Used in conjunction with creature variation templates.
  
 
|-
 
|-
Line 574: Line 645:
 
|}
 
|}
  
−
<div align="center">
+
{{alphabetical TOC|style=margin: 1em auto;}}
−
{{alphabetical TOC}}
 
−
</div>
 
  
 
==D==
 
==D==
Line 590: Line 659:
 
| Caste
 
| Caste
 
|   
 
|   
−
| Found on generated [[demon]]s. Cannot be specified in user-defined raws.
+
| 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}}
 
| {{text anchor|DESCRIPTION}}
 
| Caste
 
| Caste
−
| text  
+
|  
−
| A brief description of the creature type.
+
*text  
 +
| A brief description of the creature type, as displayed when viewing the creature's description/[[Thoughts and preferences|thoughts & preferences]] screen.
  
 
|-
 
|-
Line 602: Line 672:
 
| Caste
 
| Caste
 
|
 
|
−
| Dies upon attacking. Used for [[bee]] stings.
+
| Causes the creature to die upon attacking. Used by [[honey bee]]s to simulate them dying after using their stingers.
  
 
|-
 
|-
 
| {{text anchor|DIFFICULTY}}
 
| {{text anchor|DIFFICULTY}}
 
| Caste
 
| Caste
−
| integer  
+
|  
−
| Increases experience gain during adventure mode. Creatures with 11 or higher are not assigned for quests in adventure mode.
+
*integer  
 +
| Increases experience gain during adventure mode. Creatures with a difficulty of 11 or higher are not assigned for quests in adventure mode.
  
 
|-
 
|-
Line 614: Line 685:
 
| Caste
 
| Caste
 
|   
 
|   
−
| Sets if the creature is active in day.  
+
| Sets the creature to be active during the day in Adventurer Mode.
  
 
|-
 
|-
Line 620: Line 691:
 
| Caste
 
| Caste
 
|  
 
|  
−
| Found on [[peregrine falcon]]s. The creature hunts vermin by diving from the air. Does not seem to work on tame creatures.
+
| 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.
  
 
|-
 
|-
Line 626: Line 697:
 
| Creature
 
| Creature
 
|   
 
|   
−
| Creature does not actually exist; used for a few [[fanciful]] creatures of myth.
+
| 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.
 
|}
 
|}
  
−
<div align="center">
+
{{alphabetical TOC|style=margin: 1em auto;}}
−
{{alphabetical TOC}}
 
−
</div>
 
  
 
==E==
 
==E==
Line 644: Line 715:
 
| {{text anchor|EBO_ITEM}}
 
| {{text anchor|EBO_ITEM}}
 
| Caste
 
| Caste
−
| [[item token]]:[[material token]] (ANY_HARD_STONE can be used for the material)
+
|  
−
| Defines the item that the creature drops upon being butchered. Used with EXTRA_BUTCHER_OBJECT.
+
*[[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}}
 
| {{text anchor|EBO_SHAPE}}
 
| Caste
 
| Caste
−
| gem shape
+
|  
−
| The shape of the extra item of the creature upon butchering. Used with EXTRA_BUTCHER_OBJECT.
+
*gem shape
 +
| The shape of the creature's extra [[butcher|butchering]] drop. Used with {{token|EXTRA_BUTCHER_OBJECT|c}}.
  
 
|-
 
|-
Line 657: Line 731:
 
| Caste
 
| Caste
 
|
 
|
−
* [[material token]]
+
* <[[material token]]>
−
*state (SOLID, LIQUID, or GAS)
+
* <[[Material_definition_token#Material_States|material state]]>
−
| Egg material. Egg-laying creatures will define this 3 times, using LOCAL_CREATURE_MAT:EGGSHELL, LOCAL_CREATURE_MAT:EGG_WHITE, and then LOCAL_CREATURE_MAT:EGG_YOLK. Eggs will be made out of eggshell. Edibility is determined by tags on whites or yolk, but they otherwise do not exist.
+
| 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.
  
 
|-
 
|-
Line 666: Line 740:
 
|
 
|
 
*size
 
*size
−
| Determines the size of eggs.
+
| 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.
  
 
|-
 
|-
Line 672: Line 746:
 
| Creature
 
| Creature
 
|   
 
|   
−
| Makes the creature into a large 3x3 creature responsible for carrying trade goods, pulled by two [WAGON_PULLER]s and driven by a merchant.
+
| 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.
  
 
|-
 
|-
Line 684: Line 758:
 
| Creature
 
| Creature
 
|   
 
|   
−
| Creature is considered evil and will only show up in evil biomes. Civilizations with USE_EVIL_ANIMALS can domesticate them regardless of exotic status. Has no effect on cavern creatures.
+
| 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.
  
 
|-
 
|-
Line 692: Line 766:
 
* BY_CATEGORY, BY_TYPE, BY_TOKEN
 
* BY_CATEGORY, BY_TYPE, BY_TOKEN
 
* TYPE, CATEGORY, or TOKEN
 
* TYPE, CATEGORY, or TOKEN
−
| The creature drops an additional object when butchered (typically a gizzard stone), defined by EBO_ITEM and EBO_SHAPE.
+
| 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}}
  
 
|-
 
|-
Line 705: Line 779:
 
| Caste
 
| Caste
 
|   
 
|   
−
| Creature can see regardless of whether it has working eyes.  
+
| 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.
 
|}
 
|}
  
−
<div align="center">
+
{{alphabetical TOC|style=margin: 1em auto;}}
−
{{alphabetical TOC}}
 
−
</div>
 
  
 
==F==
 
==F==
Line 724: Line 796:
 
| Creature
 
| Creature
 
|   
 
|   
−
| The creature is a thing of legend and known to all civilizations. Its materials cannot be requested or preferred. The tag also adds some art value modifiers. Used for things like dragons and other legendary creatures. Conflicts with {{token|COMMON_DOMESTIC|c}}
+
| 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}}.
  
 
|-
 
|-
Line 730: Line 802:
 
| Caste
 
| Caste
 
|
 
|
−
| Found on subterranean animal-man tribals.
+
| 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.
  
 
|-
 
|-
Line 736: Line 808:
 
| Caste
 
| Caste
 
|
 
|
−
| Found on [[forgotten beast]]s. Cannot be specified in user-defined raws.
+
| 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.
  
 
|-
 
|-
Line 742: Line 816:
 
| Caste
 
| Caste
 
|   
 
|   
−
| The creature is female and can bear young. Usually determined inside a caste.
+
| Makes the creature biologically female, enabling her to [[Breeding|bear young]]. Usually specified inside a caste.
  
 
|-
 
|-
Line 748: Line 822:
 
| Caste
 
| Caste
 
|   
 
|   
−
| The creature is immune to FIREBALL and FIREJET attacks.
+
| 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).
  
 
|-
 
|-
Line 754: Line 828:
 
| Caste
 
| Caste
 
|   
 
|   
−
| The creature is immune to DRAGONFIRE attacks. Implies {{token|FIREIMMUNE|c}}.  
+
| Like {{token|FIREIMMUNE|c}}, but also renders the creature immune to [[Interaction_token#DRAGONFIRE|DRAGONFIRE]] attacks.  
  
 
|-
 
|-
Line 760: Line 834:
 
| Caste
 
| Caste
 
|   
 
|   
−
| Needs to be cleaned at a fishery
+
| 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}}
 
| {{text anchor|FIXED_TEMP}}
 
| Caste
 
| Caste
−
| temperature  
+
|  
−
| The natural heat generated by the creature.
+
*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.
  
 
|-
 
|-
Line 772: Line 850:
 
| Caste
 
| Caste
 
|   
 
|   
−
| Determines how soon a creature flees in a losing battle. Creatures with this tag will flee at the first sign of resistance.
+
| If engaged in combat, the creature will flee at the first sign of resistance. Used by [[kobold]]s in the vanilla game.
  
 
|-
 
|-
Line 778: Line 856:
 
| Caste
 
| Caste
 
|   
 
|   
−
| Allows a creature to fly. Fortress Mode pathfinding only partially incorporates flying - flying creatures need a land path to exist between them and an area in order to access it, but as long as one such path exists, they do not need to use it, instead being able to fly over intervening obstacles.
+
| 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).
  
 
|-
 
|-
Line 785: Line 863:
 
|
 
|
 
*number, max 100
 
*number, max 100
−
| Determines the chances of a creature appearing within its environment, with higher values resulting in more frequent appearance. The game effectively considers all creatures that can possibly appear and uses the FREQUENCY value as a ''weight'' - for example, if there are three creatures with frequencies 10/25/50, the creature with [FREQUENCY:50] will appear approximately 58.8% of the time. Defaults to 50 if not specified. Not to be confused with {{token|POP_RATIO|c}}.
+
| 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}}.
 
|}
 
|}
  
−
<div align="center">
+
{{alphabetical TOC|style=margin: 1em auto;}}
−
{{alphabetical TOC}}
 
−
</div>
 
  
 
==G==
 
==G==
Line 804: Line 882:
 
| Caste
 
| Caste
 
|  
 
|  
−
* type (WALK, CLIMB, SWIM, CRAWL, or FLY)
+
* <gait type>
−
* gait name
+
* <gait name>
−
* full speed
+
* <max [[Gait#Speed|speed]]>
−
* build up time:max turning speed:start speed (or NO_BUILD_UP for instant use)
+
* <build up time>
−
* energy use
+
* <max turning [[Gait#Speed|speed]]>
−
* Optional flags:
+
* <start [[Gait#Speed|speed]]>
−
** LAYERS_SLOW - if gait is slowed by increased weight
+
* <energy expenditure>
−
** STRENGTH - if gait is affected by strength stat
+
* <gait flag(s)>
−
** AGILITY - if gait is affected by agility stat
+
| 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]].
−
** STEALTH_SLOWS:penalty  - if gait is slowed by being stealthed
+
 
−
| Defines a gait at 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'''<br>
 +
Used for moving normally over ground tiles.
 +
 
 +
*'''CRAWL'''<br>
 +
Used for moving over ground tiles whilst [[Status_icon#Non-flashing|prone]].
 +
 
 +
*'''SWIM'''<br>
 +
Used for moving through tiles containing [[water]] or [[magma]] at a [[Water#Depth|depth]] of at least 4/7.
 +
 
 +
*'''FLY'''<br>
 +
Used for moving through [[open space]].
 +
 
 +
*'''CLIMB'''<br>
 +
Used for moving whilst [[Climber|climbing]].
 +
 
 +
 
 +
'''valid gait flags:'''
 +
* '''AGILITY'''<br>
 +
Speeds/slows movement depending on the creature's [[Attribute#Agility|Agility]] stat.
 +
 
 +
* '''STRENGTH'''<br>
 +
Speeds/slows movement depending on the creature's [[Attribute#Strength|Strength]] stat.
 +
 
 +
* '''LAYERS_SLOW'''<br>
 +
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><br>
 +
Slows movement by the specified percentage when the creature is [[Ambusher|sneaking]].
  
 
|-
 
|-
 
| {{text anchor|GENERAL_BABY_NAME}}
 
| {{text anchor|GENERAL_BABY_NAME}}
 
| Creature
 
| Creature
−
| singular:plural  
+
|  
−
| BABYNAME applied regardless of caste.
+
*singular
 +
*plural  
 +
| Like {{token|BABYNAME|c}}, but applied regardless of caste.
  
 
|-
 
|-
 
| {{text anchor|GENERAL_CHILD_NAME}}
 
| {{text anchor|GENERAL_CHILD_NAME}}
 
| Creature
 
| Creature
−
| singular:plural  
+
|  
−
| CHILDNAME applied regardless of caste.
+
*singular
 +
*plural  
 +
| Like {{token|CHILDNAME|c}}, but applied regardless of caste.
  
 
|-
 
|-
 
| {{text anchor|GENERAL_MATERIAL_FORCE_MULTIPLIER}}
 
| {{text anchor|GENERAL_MATERIAL_FORCE_MULTIPLIER}}
 
| Caste
 
| Caste
−
| A:B
+
|  
−
| Attacks against the creature have their force modified by A/B. For example, 1:2 will halve the force of an attack made against the creature. {{verify}}
+
*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).
  
 
|-
 
|-
Line 838: Line 961:
 
| Creature
 
| Creature
 
|   
 
|   
−
| Found on procedurally generated creatures like [[Forgotten beast]]s, (biome name) [[titan]]s, [[Demon]]s, and [[night creature]]s. Cannot be specified in user-defined raws.
+
| 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.
  
 
|-
 
|-
Line 844: Line 967:
 
| Caste
 
| Caste
 
|   
 
|   
−
| Creature can get infections from necrotic tissue.
+
| Makes the creature get [[Health_care#Infection|infections]] from necrotic tissue.
  
 
|-
 
|-
Line 850: Line 973:
 
| Caste
 
| Caste
 
|   
 
|   
−
| This creature's wounds can become infected if left untreated for too long.
+
| Makes the creature's wounds become [[Health_care#Infection|infected]] if left untreated for too long.
  
 
|-
 
|-
Line 859: Line 982:
 
*background
 
*background
 
*brightness  
 
*brightness  
−
| The colour of the creature's GLOWTILE.
+
| The colour of the creature's {{token|GLOWTILE|c}}.
  
 
|-
 
|-
 
| {{text anchor|GLOWTILE}}
 
| {{text anchor|GLOWTILE}}
 
| Creature
 
| Creature
−
| ascii character  
+
|  
−
| If present, the being glows in the dark (generally used for Adventure Mode). The tile is what replaces the being's current tile when it is obscured from your sight by darkness. The default setting for kobolds (a yellow quotation mark) provides a nice "glowing eyes" effect. The game is also hardcoded to automatically convert quotation mark GLOWTILES into apostrophes if the creature has lost one eye. This works at the generic creature level - for caste-specific glow tiles, use CASTE_GLOWTILE instead.
+
*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}}
 
| {{text anchor|GNAWER}}
 
| Caste
 
| 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). Currently, all gnawers brought onto the map by [[Elf|Elven]] caravans will almost immediately escape from their wooden cages{{bug|6343}}.
+
*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}}
 
| {{text anchor|GOBBLE_VERMIN_CLASS}}
 
| Caste
 
| Caste
−
| class
+
|  
−
| The creature eats vermin of the specified class.
+
*class
 +
| The creature eats vermin of the specified class.
  
 
|-
 
|-
 
| {{text anchor|GOBBLE_VERMIN_CREATURE}}
 
| {{text anchor|GOBBLE_VERMIN_CREATURE}}
 
| Caste
 
| Caste
−
| creature:caste
+
|  
−
| The creature eats a specified vermin.
+
*creature
 +
*caste
 +
| The creature eats a specified [[vermin]].
  
 
|-
 
|-
Line 901: Line 1,029:
 
| Special
 
| Special
 
|   
 
|   
−
| When using tags from an existing creature, inserts new tags after the specified tag.
+
| When using tags from an existing creature, inserts new tags ''before'' the specified tag.
  
 
|-
 
|-
Line 907: Line 1,035:
 
| Creature
 
| Creature
 
|   
 
|   
−
| Creature is considered good and will only show up in good biomes. [[unicorn]]s for example. Civilizations with USE_GOOD_ANIMALS can domesticate them regardless of exotic status. Has no effect on cavern creatures except to restrict taming. A civilization that has good creatures can colonise good areas in world-gen.
+
| 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}}
 
| {{text anchor|GRASSTRAMPLE}}
 
| Caste
 
| 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.
+
*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}}
 
| {{text anchor|GRAVITATE_BODY_SIZE}}
 
| Caste
 
| Caste
−
| target value
+
|  
 +
*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.
 
| 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.
  
Line 926: Line 1,056:
 
|
 
|
 
*number
 
*number
−
| The creature is a grazer. If tamed in Fortress mode, it needs a pasture to survive. The higher the number, the less frequently it needs to eat in order to live. See [[Pasture]] for details on its issues.
+
| 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}}.
 
|}
 
|}
  
−
<div align="center">
+
{{alphabetical TOC|style=margin: 1em auto;}}
−
{{alphabetical TOC}}
 
−
</div>
 
  
 
==H==
 
==H==
Line 944: Line 1,072:
 
| {{text anchor|HABIT}}
 
| {{text anchor|HABIT}}
 
| Caste
 
| Caste
−
| type:probability
+
|  
−
| Defines certain behaviors for the creature. The habit types are COLLECT_TROPHIES, COOK_PEOPLE, COOK_VERMIN, GRIND_VERMIN, COOK_BLOOD, GRIND_BONE_MEAL, EAT_BONE_PORRIDGE, USE_ANY_MELEE_WEAPON, GIANT_NEST, and COLLECT_WEALTH. These require the creature to have a lair to work properly, and also don't seem to work on creatures who are not (SEMI)MEGABEASTs or NIGHT_CREATURE_HUNTERs.
+
*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}}
 
| {{text anchor|HABIT_NUM}}
 
| Caste
 
| Caste
−
| number or TEST_ALL
+
|  
−
| "If you set HABIT_NUM to a number, it should give you that exact number of habits according to the weights.".<sup>[[http://www.bay12forums.com/smf/index.php?topic=60554.msg1719248#msg1719248 source post]]</sup> All lists of HABITs are preceded by [HABIT_NUM:TEST_ALL]
+
*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]
  
 
|-
 
|-
Line 964: Line 1,106:
 
|   
 
|   
 
| The creature has a shell. Seemingly no longer used - holdover from previous versions.
 
| The creature has a shell. Seemingly no longer used - holdover from previous versions.
−
 
−
|-
 
−
| {{text anchor|HFID}}
 
−
| Creature
 
−
| Integer (generic token?)
 
−
| Found on generated [[angel]]s.  Seemingly identifies a historical figure with said hist figure ID, possibly to associate it with hist figure.
 
  
 
|-
 
|-
Line 983: Line 1,119:
 
| {{text anchor|HOMEOTHERM}}
 
| {{text anchor|HOMEOTHERM}}
 
| Caste
 
| Caste
−
|
+
|  
−
| Default 'NONE'. The creature's normal body [[temperature]]
+
*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.
  
 
|-
 
|-
Line 990: Line 1,127:
 
| Caste
 
| Caste
 
|
 
|
−
| Creature hunts and kills nearby vermin.
+
| 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.
  
 
|}
 
|}
  
−
<div align="center">
+
{{alphabetical TOC|style=margin: 1em auto;}}
−
{{alphabetical TOC}}
 
−
</div>
 
  
 
==I==
 
==I==
Line 1,010: Line 1,145:
 
| Caste
 
| 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)
+
| 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).
  
 
|-
 
|-
Line 1,016: Line 1,151:
 
| Caste
 
| Caste
 
|   
 
|   
−
| The creature is immobile while on land. Only works on AQUATIC creatures which can't breathe on land.
+
| The creature is immobile while on land. Only works on {{token|AQUATIC|c}} creatures which can't breathe on land.
  
 
|-
 
|-
Line 1,022: Line 1,157:
 
| Caste
 
| Caste
 
|   
 
|   
−
| The creature radiates fire. It will ignite, and potentially completely destroy, items the creature is standing on. Keep booze away from critters with this tag. Also gives the vermin a high chance of escaping from [[animal trap]]s and [[cage]]s made of certain materials.
+
| 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).
  
 
|-
 
|-
Line 1,028: Line 1,163:
 
| Caste
 
| Caste
 
|   
 
|   
−
| Alias for [CAN_SPEAK] + [CAN_LEARN].
+
| Alias for {{token|CAN_SPEAK|c}} + {{token|CAN_LEARN|c}}.
  
 
|-
 
|-
 
| {{text anchor|ITEMCORPSE}}
 
| {{text anchor|ITEMCORPSE}}
 
| Caste
 
| Caste
−
|    
+
|
 
* [[item token]]
 
* [[item token]]
 
* [[material token]]
 
* [[material token]]
−
| Determines if the creature leaves behind a non-standard corpse (i.e. wood, statue, bars, ash from ghost etc.).
+
| 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}}
 
| {{text anchor|ITEMCORPSE_QUALITY}}
 
| Caste
 
| Caste
−
|
+
|  
−
| The quality of an item-type corpse left behind; 5 is masterpiece-level.  
+
* number
 +
| The [[quality]] of an item-type corpse left behind. Valid values are: 0 for ordinary, 1 for well-crafted, 2 for finely-crafted, 3 for superior, 4 for exceptional, 5 for masterpiece.
 
|}
 
|}
  
−
<div align="center">
+
{{alphabetical TOC|style=margin: 1em auto;}}
−
{{alphabetical TOC}}
 
−
</div>
 
  
 
==L==
 
==L==
Line 1,060: Line 1,194:
 
| {{text anchor|LAIR}}
 
| {{text anchor|LAIR}}
 
| Caste
 
| Caste
−
| type:probability
+
|  
−
| Found on megabeasts, semimegabeasts, and night creatures. The creature will seek out sites of this type and take them as lairs. The lair types are SIMPLE_BURROW, SIMPLE_MOUND, WILDERNESS_LOCATION, SHRINE, and LABYRINTH.
+
*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}}
 
| {{text anchor|LAIR_CHARACTERISTIC}}
 
| Caste
 
| Caste
−
| characteristic:probability
+
|  
 +
*characteristic
 +
*probability
 
| Defines certain features of the creature's lair. The only valid characteristic is HAS_DOORS.
 
| Defines certain features of the creature's lair. The only valid characteristic is HAS_DOORS.
  
Line 1,078: Line 1,221:
 
| {{text anchor|LAIR_HUNTER_SPEECH}}
 
| {{text anchor|LAIR_HUNTER_SPEECH}}
 
| Caste
 
| Caste
−
| speech file
+
|  
 +
*speech file
 
| What this creature says while hunting adventurers in its lair.
 
| What this creature says while hunting adventurers in its lair.
  
Line 1,085: Line 1,229:
 
| Caste
 
| Caste
 
|   
 
|   
−
| Will attack things that are smaller than it (like dwarves). Only one group of "large predators" will appear on any given map (possibly two groups on "savage" maps). In adventure mode, large predators will try to ambush and attack you (and your party will attack them back). When tamed, large predators tend to be much more aggressive to enemies than non-large predators, making them a good choice for an animal army. They may go on rampages in worldgen, and adventurers may receive quests to kill them. Also, they can be mentioned in the intro paragraph when starting a fortress e.g. "ere the wolves get hungry."  
+
| 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.
  
 
|-
 
|-
Line 1,091: Line 1,236:
 
| Creature
 
| Creature
 
|   
 
|   
−
| In Fortress Mode, spawns outdoors and is not a vermin 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}}.
  
 
|-
 
|-
Line 1,097: Line 1,244:
 
| Caste
 
| Caste
 
|
 
|
−
| Creature lays eggs instead of giving birth to live young.
+
| Creature lays [[egg]]s instead of giving birth to live young.
  
 
|-
 
|-
Line 1,105: Line 1,252:
 
* [[item token]]
 
* [[item token]]
 
* [[material token]]
 
* [[material token]]
−
| Creature lays a particular item instead of regular eggs.
+
| Creature lays the specified item instead of regular eggs.
  
 
|-
 
|-
Line 1,113: Line 1,260:
 
* [[material token]]
 
* [[material token]]
 
*healing rate  
 
*healing rate  
−
| Creature has ligaments in its bones. Cutting the bone tissue severs them, disabling motor function if the target is a limb.
+
| 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.
−
 
 
  
 
|-
 
|-
Line 1,126: Line 1,272:
 
| Caste
 
| Caste
 
|   
 
|   
−
| The creature will attack enemies rather than flee from them. This tag has the same effect on player-controlled creatures - included modded dwarves. Retired as of v0.40.14.
+
| 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}}.
  
 
|-
 
|-
Line 1,132: Line 1,278:
 
| Caste
 
| Caste
 
|  
 
|  
−
| Creature uses "sssssnake talk" (multiplies 'S' when talking - "My name isss Recisssiz.")
+
| 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.
  
 
|-
 
|-
Line 1,140: Line 1,286:
 
* minimum
 
* minimum
 
* maximum
 
* maximum
−
| Determines the range of how many creatures are generated when giving birth. [LITTERSIZE:1:2]
+
| 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.
  
 
|-
 
|-
Line 1,146: Line 1,304:
 
| Caste
 
| Caste
 
|   
 
|   
−
| Lets a creature open doors that are set to forbidden in Fortress Mode.
+
| Lets a creature open [[door]]s that are set to forbidden in fortress mode.
  
 
|-
 
|-
Line 1,157: Line 1,315:
 
| {{text anchor|LOW_LIGHT_VISION}}
 
| {{text anchor|LOW_LIGHT_VISION}}
 
| Caste
 
| Caste
−
| number
+
|  
−
| Determines how well a creature can see in the dark.  Higher is better. Dwarves have 10000, which amounts to perfect nightvision.
+
*number
 +
| Determines how well a creature can see in the dark - higher is better. Dwarves have 10000, which amounts to perfect nightvision.
 
|}
 
|}
  
−
<div align="center">
+
{{alphabetical TOC|style=margin: 1em auto;}}
−
{{alphabetical TOC}}
 
−
</div>
 
  
 
==M==
 
==M==
Line 1,177: Line 1,334:
 
| Caste
 
| Caste
 
|   
 
|   
−
| Unknown.
+
| 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]
  
 
|-
 
|-
Line 1,183: Line 1,340:
 
| Caste
 
| Caste
 
|   
 
|   
−
| Creature's able to see while covered in magma.  
+
| The creature is able to see while submerged in [[magma]].  
  
 
|-
 
|-
Line 1,189: Line 1,346:
 
| Caste
 
| Caste
 
|   
 
|   
−
| The creature is male. Usually declared inside a caste.
+
| Makes the creature biologically male. Usually declared inside a caste.
  
 
|-  
 
|-  
Line 1,196: Line 1,353:
 
|  
 
|  
 
*occasionally body part  
 
*occasionally body part  
−
| Adds a possible mannerism to the creature's profile.
+
| Adds a possible mannerism to the creature's profile. See [[creature mannerism token]] for further info.
−
See [[Creature mannerism token]] for further info.
 
  
 
|-
 
|-
Line 1,204: Line 1,360:
 
|
 
|
 
*material id
 
*material id
−
| Begins defining a new material.{{verify}}
+
| Begins defining a new local material. Follow this with standard material definition tokens to define the material.
  
 
|-
 
|-
Line 1,211: Line 1,367:
 
|  
 
|  
 
*[[Material token]]
 
*[[Material token]]
−
*A:B
+
*value A
−
| Set the force multiplier of a specific material against the creature to A/B. For example, 10:1 multiplies the force by 10. {{verify}}
+
*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.
  
 
|-
 
|-
Line 1,218: Line 1,375:
 
| Caste
 
| Caste
 
|  
 
|  
−
| Sets if the creature is active in dawn.  
+
| Sets the creature to be active at dawn in adventurer mode.  
  
 
|-
 
|-
 
| {{text anchor|MAXAGE}}
 
| {{text anchor|MAXAGE}}
 
| Caste
 
| Caste
−
| min:max  
+
|  
−
| Range of time in years in which death from old age may occur. Once a creature reaches the min value, it has a random chance each season of dying from old age. Unknown if the chance increases with further age.
+
*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.
  
 
|-
 
|-
Line 1,230: Line 1,390:
 
| Caste
 
| Caste
 
|   
 
|   
−
| Gives a creature random movement.  
+
| 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}}.
  
 
|-
 
|-
Line 1,236: Line 1,396:
 
| Caste
 
| Caste
 
|   
 
|   
−
| A 'boss' creature. A small number of the creature are created during worldgen, their histories and descendants (if any) will be tracked in worldgen (as opposed to simply 'spawning'), and they will occasionally go on rampages, potentially leading to worship if they attack the same place multiple times. Their presence and number will also influence age names. When appearing in Fortress Mode, they will have a pop-up message announcing their arrival.
+
| 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.
  
 
|-
 
|-
Line 1,242: Line 1,404:
 
| Caste
 
| Caste
 
|
 
|
−
*[[DF2012:Attribute|ATTRIBUTE]] Token
+
*[[Attribute|ATTRIBUTE]] Token
 
*Cap %
 
*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).
 
|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).
Line 1,250: Line 1,412:
 
| Caste
 
| Caste
 
|
 
|
−
*[[DF2012:Attribute|ATTRIBUTE]]
+
*[[Attribute|ATTRIBUTE]]
−
*lowest:lower:low:median:high:higher:highest  
+
*lowest
−
| Sets up a mental attribute's range of values (0-5000). All mental attribute ranges default to 200:800:900:1000:1100:1300:2000.
+
*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.
  
 
|-
 
|-
Line 1,258: Line 1,426:
 
| Caste
 
| Caste
 
|  
 
|  
−
*[[DF2012:Attribute|ATTRIBUTE]] Token
+
*[[Attribute|ATTRIBUTE]] Token
 
*cost to improve
 
*cost to improve
 
*unused counter rate
 
*unused counter rate
 
*rust counter rate
 
*rust counter rate
 
*demotion counter rate
 
*demotion counter rate
−
| Mental attribute gain/decay rates. Defaults are 500:4:5:4.
+
| [[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.
  
 
|-
 
|-
Line 1,271: Line 1,439:
 
* [[material token]]
 
* [[material token]]
 
* frequency
 
* frequency
−
| Allows the creature to be milked in the farmer's workshop. The frequency is the amount of time units the creature needs to "recharge".  
+
| 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]].
  
 
|-
 
|-
Line 1,277: Line 1,445:
 
| Caste
 
| Caste
 
|
 
|
−
| Alias for MISCHIEVOUS.
+
| Alias for {{token|MISCHIEVOUS|c}}.
  
 
|-
 
|-
Line 1,283: Line 1,451:
 
| Caste
 
| Caste
 
|   
 
|   
−
| Will pull any levers it comes across. Also makes creature spawn invisible and with several ranks in Ambusher. "They go on little missions to mess with various fortress buildings, not just levers."  
+
| 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."  
  
 
|-
 
|-
Line 1,295: Line 1,463:
 
| Caste
 
| Caste
 
|   
 
|   
−
| Creature may be used as a mount. No use for the player, but enemy siegers may arrive with cavalry.
+
| 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.
  
 
|-
 
|-
Line 1,301: Line 1,469:
 
| Caste
 
| Caste
 
|   
 
|   
−
| Creature may be used as a mount, but civilizations cannot domesticate it in worldgen without certain exceptions.
+
| Creature may be used as a [[mount]], but civilizations cannot domesticate it in worldgen without certain exceptions.
  
 
|-
 
|-
 
| {{text anchor|MULTIPART_FULL_VISION}}
 
| {{text anchor|MULTIPART_FULL_VISION}}
−
| Caste {{Verify}}
+
| Caste
 
|   
 
|   
−
| Allows the creature to have all-around vision as long as it has multiple heads(?) that can see. {{Verify}}
+
| Allows the creature to have all-around vision as long as it has multiple heads that can see.
  
 
|-
 
|-
Line 1,313: Line 1,481:
 
| Caste
 
| Caste
 
|   
 
|   
−
| Makes the species usually produce a single offspring per birth, occasionally producing twins or triplets using typical real-world human probabilities. Requires [[Creature_token#FEMALE|FEMALE]]. Compare with [[Creature_token#LITTERSIZE|LITTERSIZE]]. If LITTERSIZE and MULTIPLE_LITTER_RARE are both absent, one offspring is guaranteed per birth.
+
| 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}}.
  
 
|-
 
|-
Line 1,322: Line 1,490:
 
|}
 
|}
  
−
<div align="center">
+
{{alphabetical TOC|style=margin: 1em auto;}}
−
{{alphabetical TOC}}
 
−
</div>
 
  
 
==N==
 
==N==
Line 1,337: Line 1,503:
 
| {{text anchor|NAME}}
 
| {{text anchor|NAME}}
 
| Creature
 
| Creature
−
| singular:plural:adjective  
+
|  
−
| The generic name for any creature of this type - will be used when distinctions between caste are unimportant. For names for specific castes, use CASTE_NAME instead. If left undefined, the creature will be labeled as "nothing" by the game.
+
*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"
  
 
|-
 
|-
Line 1,344: Line 1,519:
 
| Caste
 
| Caste
 
|   
 
|   
−
| Animal is considered to be natural. Creatures with AT_PEACE_WITH_WILDLIFE will not fight with them.
+
| 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.
  
 
|-
 
|-
Line 1,350: Line 1,525:
 
| Caste
 
| Caste
 
|  
 
|  
−
| Alias of NATURAL.
+
| Alias of {{token|NATURAL|c}}.
  
 
|-
 
|-
 
| {{text anchor|NATURAL_SKILL}}
 
| {{text anchor|NATURAL_SKILL}}
 
| Caste
 
| Caste
−
| [[Skill_token|Skill token]]:value
+
|  
−
| The creature possesses this skill at this level inherently. It begins with this skill at this level, and the skill may never rust below this level. A value of 16 is legendary. Requires CAN_LEARN or INTELLIGENT to function in .25 or earlier.
+
*[[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.
  
 
|-
 
|-
Line 1,362: Line 1,539:
 
| Caste
 
| Caste
 
|
 
|
−
| Found on bogeymen. Creatures with this tag will join other bogeymen in attacking adventurers at night, and will also adopt their other behaviors, such as vanishing in smoke upon being killed. This does not affect the creature's presence elsewhere, such as for generated megabeasts, normal creatures, entity members, etc. Setting the number of bogeyman types to zero in the world gen parameters will remove only the randomly-generated bogeymen.
+
| 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.
  
 
|-
 
|-
Line 1,368: Line 1,551:
 
| Caste
 
| Caste
 
|
 
|
−
| A very small population of the creature will be created during worldgen (sometimes only a single individual will be created), and their histories will be tracked (that is, they will not spawn spontaneously later, they must either have children or convert other creatures to increase their numbers).   The creature will settle in a lair and go on rampages during worldgen. If this creature has SPOUSE_CONVERTER, it will actively attempt to seek out potential conversion targets to abduct, convert, and have children with (if possible).
+
| 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).
  
−
This tag causes the usual behaviour of [[werebeast]]s in worldgen, that is, fleeing towns upon being cursed and conducting raids from a lair.  If this tag is absent from a deity curse, the accursed will simply be driven out of towns in a similar manner to [[vampire]]s.
+
|-
 +
| {{text anchor|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.
  
 
|-
 
|-
Line 1,376: Line 1,567:
 
| Caste
 
| Caste
 
|   
 
|   
−
| This creature caste does not appear in [[Calendar|autumn]].
+
| The creature caste does not appear in [[Calendar|autumn]].
  
 
|-
 
|-
Line 1,388: Line 1,579:
 
| Caste
 
| Caste
 
|   
 
|   
−
| Creature cannot become dizzy.
+
| Creature cannot become [[Symptom#Dizziness|dizzy]].
  
 
|-
 
|-
Line 1,400: Line 1,591:
 
| Caste
 
| Caste
 
|   
 
|   
−
| Creature does not need to eat.  
+
| 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}}
  
 
|-
 
|-
Line 1,406: Line 1,597:
 
| Caste
 
| Caste
 
|   
 
|   
−
| Creature cannot suffer fevers.
+
| Creature cannot suffer [[Symptom#Fever|fevers]].
  
 
|-
 
|-
Line 1,412: Line 1,603:
 
| Caste
 
| Caste
 
|
 
|
−
| Creature has no gender.
+
| The creature is biologically sexless. Makes the creature unable to [[breeding|breed]].
  
 
|-
 
|-
Line 1,418: Line 1,609:
 
| Caste
 
| Caste
 
|
 
|
−
| The affected caste cannot gain any physical skills.
+
| The creature cannot raise any [[Attribute#Body_attributes|physical attributes]].
  
 
|-
 
|-
Line 1,424: Line 1,615:
 
| Caste
 
| Caste
 
|  
 
|  
−
| The affected caste cannot lose any physical skills.
+
| The creature cannot lose any [[Attribute#Body_attributes|physical attributes]].
  
 
|-
 
|-
Line 1,430: Line 1,621:
 
| Caste
 
| Caste
 
|   
 
|   
−
| Creature does not need to sleep.  
+
| Creature does not need to sleep. Can still be rendered unconscious by other means.
  
 
|-
 
|-
Line 1,436: Line 1,627:
 
| Caste
 
| Caste
 
|   
 
|   
−
| This creature caste does not appear in [[Calendar|spring]].
+
| The creature caste does not appear in [[Calendar|spring]].
  
 
|-
 
|-
Line 1,442: Line 1,633:
 
| Caste
 
| Caste
 
|   
 
|   
−
| This creature caste does not appear in [[Calendar|summer]].
+
| The creature caste does not appear in [[Calendar|summer]].
  
 
|-
 
|-
Line 1,448: Line 1,639:
 
| Caste
 
| Caste
 
|   
 
|   
−
| Creature doesn't require an organ with the [THOUGHT] tag to survive or attack; generally used on creatures that don't have brains.
+
| 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.
  
 
|-
 
|-
Line 1,466: Line 1,657:
 
| Caste
 
| Caste
 
|   
 
|   
−
| This creature caste does not appear in [[Calendar|winter]].
+
| The creature caste does not appear in [[Calendar|winter]].
  
 
|-
 
|-
Line 1,478: Line 1,669:
 
| Caste
 
| Caste
 
|   
 
|   
−
| Creature doesn't need to breathe or have [BREATHE] parts in body. Cannot drown or be strangled.  
+
| 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.
  
 
|-
 
|-
Line 1,484: Line 1,675:
 
| Caste
 
| Caste
 
|   
 
|   
−
| Sets if the creature is active in night.  
+
| Sets the creature to be active at night in adventure mode.  
  
 
|-
 
|-
Line 1,490: Line 1,681:
 
| Caste
 
| Caste
 
|   
 
|   
−
| The creature has no emotions, and does not rage.
+
| 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.
  
 
|-
 
|-
Line 1,496: Line 1,687:
 
| Caste
 
| Caste
 
|   
 
|   
−
| Creature can't become tired or over-exerted from taking too many combat actions.  
+
| Creature can't become tired or over-exerted from taking too many combat actions or moving at full speed for extended periods of time.  
  
 
|-
 
|-
Line 1,502: Line 1,693:
 
| Caste
 
| Caste
 
|   
 
|   
−
| Creature doesn't feel fear and will never run away from battle.  
+
| 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.
  
 
|-
 
|-
Line 1,508: Line 1,699:
 
| Caste
 
| Caste
 
|   
 
|   
−
| Creature will not drop meat when butchered.
+
| Creature will not be hunted or fed to wild beasts.
  
 
|-
 
|-
Line 1,526: Line 1,717:
 
| Caste
 
| Caste
 
|   
 
|   
−
| Creature will not drop a hide when butchered.  
+
| Creature will not drop a hide when [[butcher|butchered]].  
  
 
|-
 
|-
Line 1,532: Line 1,723:
 
| Caste
 
| Caste
 
|   
 
|   
−
| Creature will not drop a skull on butcher, rot, or decay of severed head.
+
| Creature will not drop a skull on butchering, rot, or decay of severed head.
  
 
|-
 
|-
Line 1,538: Line 1,729:
 
| Caste
 
| Caste
 
|   
 
|   
−
| Does not produce miasma when rotting.
+
| Does not produce [[miasma]] when rotting.
  
 
|-
 
|-
Line 1,544: Line 1,735:
 
| Caste
 
| Caste
 
|   
 
|   
−
| Weapons can't get stuck in creature.  
+
| Weapons can't get stuck in the creature.  
  
 
|-
 
|-
Line 1,550: Line 1,741:
 
| Caste
 
| Caste
 
|   
 
|   
−
| Creature can't be stunned. Creatures with this tag never wake up from sleep in Fortress Mode and stay drowsy.{{verify}} If this creature must eat and drink while playing, it WILL die.
+
| Creature can't be stunned and knocked unconscious by pain or head injuries. Creatures with this tag never wake up from sleep in Fortress Mode. If this creature needs to sleep while playing, it <b>will</b> die.
  
 
|-
 
|-
Line 1,556: Line 1,747:
 
| Caste
 
| Caste
 
|   
 
|   
−
| Cannot be butchered
+
| Cannot be [[butcher|butchered]].
  
 
|-
 
|-
Line 1,562: Line 1,753:
 
| Caste
 
| Caste
 
|  
 
|  
−
| Cannot be raised from the dead.
+
| 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.
  
 
|-
 
|-
Line 1,568: Line 1,759:
 
| Caste
 
| Caste
 
|   
 
|   
−
| Creature doesn't require a [THOUGHT] body part to survive.  If it does not have NO_THOUGHT_CENTER_FOR_MOVEMENT as well, it will be unable to use any attacks other than the default 'push'. Has the added effect of preventing speech.
+
| 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.
 
|}
 
|}
  
−
<div align="center">
+
{{alphabetical TOC|style=margin: 1em auto;}}
−
{{alphabetical TOC}}
 
−
</div>
 
  
 
==O==
 
==O==
Line 1,586: Line 1,775:
 
| {{text anchor|ODOR_LEVEL}}
 
| {{text anchor|ODOR_LEVEL}}
 
| Caste
 
| Caste
−
| number
+
|  
−
| How easy the creature is to smell. The higher the number, the easier the creature can be smelled. Zero is odorless. Default is 50.
+
*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}}
 
| {{text anchor|ODOR_STRING}}
 
| Caste
 
| Caste
−
| string
+
|  
−
| What the creature smells like. If no odor string is defined, the creature name (not the caste name) is used.
+
*string
 +
| What the creature [[smell]]s like. If no odor string is defined, the creature name (not the caste name) is used.
  
 
|-
 
|-
Line 1,599: Line 1,790:
 
| Caste
 
| Caste
 
|  
 
|  
−
| Is hostile to all creatures except undead and other non-living ones. Used for [[Undead]].
+
| 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}}
 
| {{text anchor|ORIENTATION}}
 
| Caste
 
| Caste
−
| MALE/FEMALE:disinterested chance:lover-possible chance:commitment-possible chance
+
|  
−
| Determines caste's likelihood of having sexual attraction to certain sexes. Values default to 75:20:5 for the same sex and 5:20:75 for the opposite sex. The values themselves are simply ratios and do not need to add up to any particular value.
+
*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.
  
 
|}
 
|}
  
−
<div align="center">
+
{{alphabetical TOC|style=margin: 1em auto;}}
−
{{alphabetical TOC}}
 
−
</div>
 
  
 
==P==
 
==P==
Line 1,625: Line 1,824:
 
| Caste
 
| Caste
 
|   
 
|   
−
| Allows the creature to be used as a pack animal. Currently only used by merchants without wagons. Also prevents creature from dropping hauled items on its own -- do not use for player-controllable creatures!
+
| 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}}.
  
 
|-
 
|-
Line 1,631: Line 1,830:
 
| Caste
 
| Caste
 
|   
 
|   
−
| The creature is immune to all paralyzing special attacks.
+
| The creature is immune to all [[Syndrome#CE_PARALYSIS|paralyzing]] special attacks.
  
 
|-
 
|-
Line 1,637: Line 1,836:
 
| Caste
 
| Caste
 
|   
 
|   
−
| Unknown. No creatures currently have this token.
+
| 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.  
  
 
|-
 
|-
Line 1,643: Line 1,849:
 
| Caste
 
| Caste
 
|   
 
|   
−
| In earlier versions, creature would generate pearls. Does nothing in the current version.
+
| In earlier versions, creature would generate [[pearl]]s. Does nothing in the current version.{{verify}}
  
 
|-
 
|-
 
| {{text anchor|PENETRATEPOWER}}
 
| {{text anchor|PENETRATEPOWER}}
 
| Caste
 
| Caste
−
| value  
+
|  
−
| Controls the ability of vermin to find a way into containers when they are eating food from your stockpiles.
+
*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.
  
 
|-
 
|-
Line 1,656: Line 1,865:
 
|  
 
|  
 
*ATTRIBUTE
 
*ATTRIBUTE
−
*lowest:median:highest  
+
*lowest
 +
*median
 +
*highest  
 
| Determines the range and chance of personality traits. Standard is 0:50:100. See [[Personality trait]] for more info.
 
| Determines the range and chance of personality traits. Standard is 0:50:100. See [[Personality trait]] for more info.
  
Line 1,663: Line 1,874:
 
| Caste
 
| Caste
 
|   
 
|   
−
| Allows the creature to be tamed in Fortress mode. Prequisite for all other working animal roles and allows all females of the species to breed regardless of marital status. 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.
+
| 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.
  
 
|-
 
|-
Line 1,669: Line 1,880:
 
| Caste
 
| Caste
 
|   
 
|   
−
| Allows the creature to be tamed in Fortress mode. Prequisite for all other working animal roles and allows all females of the species to breed regardless of marital status. Civilizations cannot domesticate it in worldgen without certain exceptions. More difficult to tame?{{verify}} Adding this to civilization members will classify them as pets instead of citizens, with all the [[Fun|problems]] that entails.
+
| 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}}
 
| {{text anchor|PETVALUE}}
 
| Caste
 
| Caste
−
| value  
+
|  
 +
*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.  
 
| 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.  
  
Line 1,680: Line 1,892:
 
| {{text anchor|PETVALUE_DIVISOR}}
 
| {{text anchor|PETVALUE_DIVISOR}}
 
| Caste
 
| Caste
−
| value
+
|  
−
| Divides the creature's PETVALUE by the specified number. Used for bees to prevent a single hive from being worth a fortune.
+
*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.
  
 
|-
 
|-
Line 1,687: Line 1,900:
 
| Caste
 
| Caste
 
|
 
|
−
*[[DF2012:Attribute|ATTRIBUTE]] Token
+
*[[Attribute|ATTRIBUTE]] Token
 
*Cap %
 
*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).
+
|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).
  
 
|-
 
|-
Line 1,695: Line 1,908:
 
| Caste
 
| Caste
 
|  
 
|  
−
*[[DF2012:Attribute|ATTRIBUTE]]
+
*[[Attribute|ATTRIBUTE]]
−
*lowest:lower:low:median:high:higher:highest  
+
*lowest
−
| Sets up a physical attribute's range of values (0-5000). All physical attribute ranges default to 200:700:900:1000:1100:1300:2000.
+
*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.
  
 
|-
 
|-
Line 1,703: Line 1,922:
 
| Caste
 
| Caste
 
|  
 
|  
−
*[[DF2012:Attribute|ATTRIBUTE]] Token
+
*[[Attribute|ATTRIBUTE]] Token
 
*cost to improve
 
*cost to improve
 
*unused counter rate
 
*unused counter rate
 
*rust counter rate
 
*rust counter rate
 
*demotion counter rate
 
*demotion counter rate
−
| Physical attribute gain/decay rates. Defaults for STRENGTH, AGILITY, TOUGHNESS, and ENDURANCE are 500:3:4:3, while RECUPERATION and DISEASE_RESISTANCE default to 500:NONE:NONE:NONE.
+
| [[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.
  
 
|-
 
|-
Line 1,716: Line 1,935:
 
*BY_TYPE, BY_CATEGORY, or BY_TOKEN
 
*BY_TYPE, BY_CATEGORY, or BY_TOKEN
 
*body type, category, or token
 
*body type, category, or token
−
| Adds a body part group to selected body part group. Presumably used immediately after SET_BP_GROUP.
+
| Adds a body part group to selected body part group. Presumably used immediately after {{token|SET_BP_GROUP|c}}.
  
 
|-
 
|-
Line 1,723: Line 1,942:
 
|  
 
|  
 
*material
 
*material
−
| Adds a material to selected materials. Used immediately after SELECT_MATERIAL.
+
| Adds a material to selected materials. Used immediately after {{token|SELECT_MATERIAL|c}}.
  
 
|-
 
|-
Line 1,729: Line 1,948:
 
| Caste
 
| Caste
 
|   
 
|   
−
| Weighted population of caste; Lower is rarer. Not to be confused with FREQUENCY.
+
*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}}
 
| {{text anchor|POPULATION_NUMBER}}
 
| Creature
 
| Creature
−
| min:max  
+
|  
−
| The minimum/maximum numbers of how many of these creatures are present in each world map tile of the appropriate region.
+
*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.
  
 
|-
 
|-
Line 1,741: Line 1,963:
 
| Caste
 
| Caste
 
|
 
|
−
| Allows the being to represent itself as a deity. Requires CAN_SPEAK to actually do anything more than settle at a location (e.g. write books, lead armies, profane temples). Doesn't appear to do anything for creatures that are already civilized.
+
| 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}}
 
| {{text anchor|PREFSTRING}}
 
| Creature
 
| Creature
−
| string
+
|  
−
| Sets what other creatures like about this creature. "Urist likes dwarves for their beards." Multiple entries will be chosen from at random
+
*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}}
+
| {{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
 
| Creature
 
|  
 
|  
Line 1,756: Line 1,986:
 
*singular
 
*singular
 
*plural  
 
*plural  
−
| The generic name for members of this profession, at the creature level. In order to give members of specific castes different names for professions, use CASTE_PROFESSION_NAME instead.
+
| 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}}
 
| {{text anchor|PRONE_TO_RAGE}}
 
| Caste
 
| Caste
−
| Chance
+
|  
−
| Creature has a percentage chance to flip out at visible non-friendly creatures. Enraged creatures attack anything regardless of timidity and get a strength bonus to their hits. This is what makes badgers so hardcore.
+
*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.
  
 
|-
 
|-
Line 1,768: Line 1,999:
 
| Caste
 
| Caste
 
|  
 
|  
−
* [[material token]]
+
* <[[material token]]>
−
*matter state (LIQUID, GAS, SOLID)
+
* <[[Material_definition_token#Material_States|material state]]>
−
| The creature has pus. Specifies the stuff secreted by infected wounds.
+
| The creature has pus. Specifies the stuff secreted by [[Health_care#Infection|infected wounds]].
 
|}
 
|}
  
−
<div align="center">
+
{{alphabetical TOC|style=margin: 1em auto;}}
−
{{alphabetical TOC}}
 
−
</div>
 
  
 
==R==
 
==R==
Line 1,792: Line 2,021:
 
*body category, type, or token
 
*body category, type, or token
 
*Relsize  
 
*Relsize  
−
| Specifies a new relative size for a part than what is stated in the body plan. For example, Dwarves have larger livers.
+
| 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}}
 
| {{text anchor|REMAINS}}
 
| Caste
 
| Caste
−
| singular:plural
+
|  
−
| What creature's remains are called.
+
*singular
 +
*plural
 +
| What the creature's [[remains]] are called.
  
 
|-
 
|-
Line 1,804: Line 2,035:
 
| Caste
 
| Caste
 
|
 
|
−
| What color creature's remains are.
+
| What color the creature's [[remains]] are.
  
 
|-
 
|-
Line 1,810: Line 2,041:
 
| Caste
 
| Caste
 
|
 
|
−
| Goes with VERMIN_BITE and DIE_WHEN_VERMIN_BITE, the vermin creature will leave remains on death when biting. Leaving this tag out will cause the creature to disappear entirely after it bites.
+
| 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.
  
 
|-
 
|-
Line 1,823: Line 2,054:
 
|  
 
|  
 
*material token  
 
*material token  
−
| Removes a material from a creature.
+
| Removes a material from the creature.
  
 
|-
 
|-
Line 1,829: Line 2,060:
 
| Creature
 
| Creature
 
|
 
|
−
*material token
+
*tissue token
−
| Removes a tissue from a creature.
+
| Removes a tissue from the creature.
  
 
|-
 
|-
Line 1,837: Line 2,068:
 
|
 
|
 
*BY_TYPE, BY_CATEGORY or BY_TOKEN
 
*BY_TYPE, BY_CATEGORY or BY_TOKEN
−
*TYPE, CATEGORY or TOKEN
+
*body type, [[Body_token#CATEGORY|category]], or [[Body_token#BP|token]]
−
| The creature will retract into a body part when threatened. It will be unable to move or attack, but enemies will only be able to attack the specified body part.
+
*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}}
 
| {{text anchor|RETURNS_VERMIN_KILLS_TO_OWNER}}
 
|
 
|
 
|
 
|
−
| Cat behavior. If it kills a vermin creature and has an owner, it carries the remains in its mouth and drops them at his feet. Requires HUNTS_VERMIN, obviously.
+
| 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}}.
  
 
|-
 
|-
Line 1,850: Line 2,088:
 
| Caste
 
| Caste
 
|  
 
|  
−
| Creature will occasionally root around in the grass, looking for insects.  Used for flavor in Adventure Mode, spawns vermin edible by this creature in Fortress Mode.
+
*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.
  
 
|}
 
|}
  
−
<div align="center">
+
{{alphabetical TOC|style=margin: 1em auto;}}
−
{{alphabetical TOC}}
 
−
</div>
 
  
 
==S==
 
==S==
Line 1,870: Line 2,114:
 
| Creature
 
| Creature
 
|   
 
|   
−
| The creature will only show up in "savage" biomes.
+
| 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}}.
  
 
|-
 
|-
Line 1,876: Line 2,120:
 
| Caste
 
| Caste
 
|  
 
|  
−
* [[material token]]
+
*<[[material token]]>
−
*Material State
+
*<[[Material_definition_token#Material_States|material state]]>
−
*location secreted from (by_type, by_category, by_token)
+
*BY_TOKEN / BY_CATEGORY / BY_TYPE
−
*body part  
+
*<[[Body_token#BP|body part ID]]> / <[[Body_token#CATEGORY|category]]> or ALL / <type (e.g. [[Body_token#GRASP|GRASP]])>
−
*tissue layer  
+
*<[[Body_detail_plan_token#BP_LAYERS|tissue layer]]> or ALL
−
*trigger
+
*<trigger>
−
| creates a secreted material on given tissue on a given part of the body. Valid triggers are:
+
| 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
+
*'''CONTINUOUS'''
−
*EXTREME_EMOTION
+
Secretion occurs once every 40 [[time|ticks]] in [[fortress mode]], and every tick in [[adventurer mode]].
−
*EXERTION
+
*'''EXERTION'''
−
 
+
Secretion occurs continuously (at the rate described above) whilst the creature is at minimum <span style="font-size:75%">{{Tile|Tired|6:1}}</span> 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}}.
  
 
|-
 
|-
Line 1,892: Line 2,138:
 
| Creature
 
| Creature
 
|  
 
|  
−
*caste name
+
*<caste>
−
| adds an additional previously defined caste to the selection. Used after SELECT_CASTE.
+
| Adds an additional previously defined caste to the selection. Used after {{token|SELECT_CASTE|c}}.
  
 
|-
 
|-
Line 1,899: Line 2,145:
 
| Creature
 
| Creature
 
|  
 
|  
−
*caste name, or ALL  
+
*<caste> or ALL  
−
| selects a previously defined caste
+
| Selects a previously defined caste
  
 
|-
 
|-
Line 1,906: Line 2,152:
 
| Creature
 
| Creature
 
|  
 
|  
−
*Material token
+
*<[[material token]]>
 
| Selects a locally defined material. Can be ALL.
 
| Selects a locally defined material. Can be ALL.
 +
 +
|-
 +
| {{text anchor|SELECT_TISSUE}}
 +
| Creature
 +
|
 +
*tissue token
 +
| Selects a tissue for editing.
  
 
|-
 
|-
Line 1,913: Line 2,166:
 
| Caste
 
| Caste
 
|  
 
|  
−
| Essentially the same as MEGABEAST, but more of them are created during worldgen.
+
| Essentially the same as {{token|MEGABEAST|c}}, but more of them are created during worldgen. See the [[semi-megabeast]] page for details.
  
 
|-
 
|-
Line 1,919: Line 2,172:
 
| Caste
 
| Caste
 
|  
 
|  
−
* Creature class
+
* <[[Creature_token#CREATURE_CLASS|creature class]]>
−
* [[Tilesets|Tile]]
+
* [[Tilesets|<tile value or character>]]
−
* [[Color|Color]]
+
* [[Color#Color_values|<foreground color>:<background color>:<foreground brightness>]]
−
| Allows creature to sense creatures with a certain creature class through walls, floors etc. Sense will be with tile and color specified.
+
| 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.
−
 
 
  
 
|-
 
|-
Line 1,934: Line 2,186:
  
 
|-
 
|-
−
| {{text anchor|SET_TL_GROUP}}
+
| {{text anchor|SKILL_LEARN_RATE}}
 
| Caste
 
| Caste
 
|  
 
|  
−
*TISSUE
+
*<[[skill_token]]>
−
*BY_CATEGORY, BY_TYPE, BY_TOKEN
+
*<percentage>
−
*Location - category, type, or token
+
| The rate at which this creature learns this skill. Requires {{token|CAN_LEARN|c}} or {{token|INTELLIGENT|c}} to function.
−
*tissue
 
−
| begins a selection of tissue layers
 
  
 
|-
 
|-
−
| {{text anchor|SHEARABLE_TISSUE_LAYER}}
+
| {{text anchor|SKILL_LEARN_RATES}}
 
| Caste
 
| Caste
−
|
+
|  
−
* tissue modifier
+
*<percentage>
−
* required value
+
| The rate at which this creature learns all skills. Requires {{token|CAN_LEARN|c}} or {{token|INTELLIGENT|c}} to function.
−
| Tissue layer can be sheared for its component material. The specified modifier must be at least of the desired value for shearing to be possible (a llama's wool must have a LENGTH of 300 before it is shearable).
 
−
 
 
−
|-
 
−
| {{text anchor|SKILL_LEARN_RATE}}
 
−
| Caste
 
−
| [[skill_token]]:percentage
 
−
| The rate at which this creature learns this skill. Requires CAN_LEARN or INTELLIGENT to function.
 
−
 
 
−
|-
 
−
| {{text anchor|SKILL_LEARN_RATES}}
 
−
| Caste
 
−
| percentage
 
−
| The rate at which this creature learns all skills.  Requires CAN_LEARN or INTELLIGENT to function.
 
  
 
|-
 
|-
 
| {{text anchor|SKILL_RATE}}
 
| {{text anchor|SKILL_RATE}}
 
| Caste
 
| Caste
−
| [[skill_token]]:percentage:value:value:value
+
|  
−
| As SKILL_RATES for individual skills. Requires CAN_LEARN or INTELLIGENT to function.
+
*[[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.
  
 
|-
 
|-
Line 1,973: Line 2,215:
 
| Caste
 
| Caste
 
|   
 
|   
−
*% of improvement points you get
+
*<% of improvement points gained>
−
*unused counter rate
+
*<unused counter rate>
−
*rust counter rate
+
*<rust counter rate>
−
*demotion 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.
 
| Affects skill gain and decay. Lower numbers in the last three slots make decay occur faster ([SKILL_RATES:100:1:1:1] would cause rapid decay). The counter rates may also be replaced with NONE.
−
Default is [SKILL_RATES:100:8:16:16]. Requires CAN_LEARN or INTELLIGENT to function.
+
Default is [SKILL_RATES:100:8:16:16]. Requires {{token|CAN_LEARN|c}} or {{token|INTELLIGENT|c}} to function.
  
 
|-
 
|-
 
| {{text anchor|SKILL_RUST_RATE}}
 
| {{text anchor|SKILL_RUST_RATE}}
 
| Caste
 
| Caste
−
| [[skill_token]]:value:value:value
+
|  
−
| The rate at which this skill decays. Lower values cause the skill to decay faster. Requires CAN_LEARN or INTELLIGENT to function.
+
*[[skill_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}}
 
| {{text anchor|SKILL_RUST_RATES}}
 
| Caste
 
| Caste
−
| value:value:value
+
|  
−
| The rate at which all skills decay. Lower values cause the skills to decay faster. Requires CAN_LEARN or INTELLIGENT to function.
+
*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
 +
|
 +
*text set
 +
| Caste-specific {{token|SLAIN_SPEECH|c}}.
 +
 
 +
|-
 +
| {{text anchor|SLAIN_SPEECH}}
 +
| Creature
 +
|
 +
*text set
 +
| Boasting speeches relating to killing this creature. Examples include text_dwarf.txt and text_elf.txt in data\vanilla\vanilla_creatures\objects.
  
 
|-
 
|-
Line 1,996: Line 2,259:
 
| Caste
 
| Caste
 
|   
 
|   
−
| Shorthand for [CAN_LEARN] + [SKILL_LEARN_RATES:50].{{verify}} Used for ogres and giants. Applicable to player races.  
+
| 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.
  
 
|-
 
|-
Line 2,002: Line 2,265:
 
| Caste
 
| Caste
 
|   
 
|   
−
| Creature leaves a "remains" instead of a corpse. Used for vermin.
+
| Creature leaves "[[item token#REMAINS|remains]]" instead of a corpse. Used by [[vermin]].
  
 
|-
 
|-
 
| {{text anchor|SMELL_TRIGGER}}
 
| {{text anchor|SMELL_TRIGGER}}
 
| Creature
 
| Creature
−
| value
+
|  
−
| Determines how keen a creature's sense of smell is. Lower is better. At 10000, a creature cannot smell at all.
+
*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}}
 
| {{text anchor|SOLDIER_ALTTILE}}
 
| Creature
 
| Creature
−
| 'character' or tile number
+
|  
 +
*'character' or tile number
 
| If this creature is active in its civilization's military, it will blink between its default tile and this one.
 
| If this creature is active in its civilization's military, it will blink between its default tile and this one.
  
Line 2,029: Line 2,294:
 
| Creature makes sounds periodically, which can be heard in Adventure mode.
 
| Creature makes sounds periodically, which can be heard in Adventure mode.
 
* First-person reads "You '''bark'''"
 
* First-person reads "You '''bark'''"
−
* Third-person reads "The capybara '''barks'''"
+
* Third-person reads "The [[capybara]] '''barks'''"
 
* Out of sight reads "You hear '''a loud bark'''"
 
* Out of sight reads "You hear '''a loud bark'''"
 
with the text in bold being the description arguments of the token.
 
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.
  
 
|-
 
|-
Line 2,039: Line 2,311:
 
* PLANT or CREATURE
 
* PLANT or CREATURE
 
* Plant/creature ID
 
* Plant/creature ID
−
| Creature can will only graze or eat the designated plant or creature parts.
+
| 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.
 
  
 
|-
 
|-
Line 2,063: Line 2,317:
 
| Creature
 
| Creature
 
|  
 
|  
−
*sphere name
+
* [[Sphere#Available_spheres|sphere]]
−
| Sets what religious spheres the creature is aligned to, for purposes of being worshipped via the [POWER] token. Also affects the layout of hidden fun stuff, and the creature's name.
+
| 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.
  
 
|-
 
|-
Line 2,070: Line 2,324:
 
| Caste
 
| Caste
 
|
 
|
−
| This creature can be converted by a night creature with SPOUSE_CONVERTED.
+
| This creature can be converted by a night creature with {{token|SPOUSE_CONVERTER|c}}.
  
 
|-
 
|-
Line 2,076: Line 2,330:
 
| Caste
 
| Caste
 
|
 
|
−
| If the creature has the NIGHT_CREATURE_HUNTER tag, it will kidnap SPOUSE_CONVERSION_TARGETs and transform them into the caste of its species with the CONVERTED_SPOUSE tag during worldgen. It may also start families this way.
+
| 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}}
 
| {{text anchor|STANCE_CLIMBER}}
−
| Caste {{verify}}
+
| Caste
 
|
 
|
−
| Caste does not require GRASP body parts to climb -- it can climb with STANCE parts instead.
+
| 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.
  
 
|-
 
|-
Line 2,088: Line 2,348:
 
| Caste
 
| Caste
 
|
 
|
−
| Acts as GRAZER but set to 20000*G*(max size)^(-3/4), where G defaults to 100 but can be set in d_init, and the whole thing is trapped between 150 and 3 million. Used in all default creature RAWs for grazers.
+
| 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.
  
 
|-
 
|-
Line 2,094: Line 2,360:
 
| Caste
 
| Caste
 
|  
 
|  
−
| Gives the creature knowledge of any secrets with SUPERNATURAL_LEARNING_POSSIBLE that match its spheres. Other effects are unknown.
+
| 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.
  
 
|-
 
|-
Line 2,100: Line 2,366:
 
| Caste
 
| Caste
 
|   
 
|   
−
| The creature naturally knows how to swim, as opposed to [SWIMS_LEARNED] below. However, Fortress mode AI never paths into water anyway, so it's less useful there.  
+
| 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.  
  
 
|-
 
|-
Line 2,106: Line 2,372:
 
| Caste
 
| Caste
 
|   
 
|   
−
| The creature doesn't know how to swim unless it has learned the skill. Requires [CAN_LEARN], obviously.  
+
| 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.
 
|}
 
|}
  
−
<div align="center">
+
{{alphabetical TOC|style=margin: 1em auto;}}
−
{{alphabetical TOC}}
 
−
</div>
 
  
 
==T==
 
==T==
Line 2,128: Line 2,397:
 
* [[material token]]
 
* [[material token]]
 
*healing rate  
 
*healing rate  
−
| The creature has tendons in its bones. Cutting the bone tissue severs them, disabling motor function if the target is a limb.
+
| 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.
  
 
|-
 
|-
Line 2,134: Line 2,403:
 
| Caste
 
| Caste
 
|   
 
|   
−
| The creature's webs can catch larger creatures.
+
| The creature's [[web]]s can catch larger creatures.
  
 
|-
 
|-
 
| {{text anchor|TISSUE}}
 
| {{text anchor|TISSUE}}
 
| Creature
 
| Creature
−
| name  
+
|  
−
| Begins defining a tissue in the creature file.
+
*name  
 +
| Begins defining a tissue in the creature file. Follow this with standard tissue definition tokens to define the tissue properties.
  
 
|-
 
|-
−
| {{text anchor|TITAN}}
+
| {{text anchor|TISSUE_LAYER}}
 
| Caste
 
| Caste
−
|
+
|  
−
| Found on [[titan]]s. Cannot be specified in user-defined raws.
+
*BY_TYPE, BY_CATEGORY, BY_TOKEN
−
 
+
*TYPE,CATEGORY, or TOKEN
−
|-
+
*TISSUE
−
| {{text anchor|TL_COLOR_MODIFIER}}
+
*LOCATION
−
| Caste
+
| Adds the tissue layer to wherever it is required.
−
| COLOR:freq:COLOR:freq etc.  
+
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
−
| Creates a list of color patterns, giving each a relative frequency.
 
  
 
|-
 
|-
−
| {{text anchor|TLCM_GENETIC_MODEL}}
+
| {{text anchor|TISSUE_LAYER_OVER}}
 
| Caste
 
| Caste
 
|
 
|
−
| The way the color modifier is passed on to offspring. May or may not work right now.{{verify}}
+
*BY_TYPE, BY_CATEGORY, BY_TOKEN
 +
*TYPE,CATEGORY, or TOKEN
 +
*TISSUE
 +
*LOCATION
 +
| Alias for TISSUE_LAYER
  
 
|-
 
|-
−
| {{text anchor|TLCM_IMPORTANCE}}
+
| {{text anchor|TISSUE_LAYER_UNDER}}
 
| Caste
 
| Caste
−
|
+
|  
−
*number
+
*BY_TYPE, BY_CATEGORY, BY_TOKEN
−
| Presumably modifies the importance of the tissue layer color modifier, for description purposes.
+
*TYPE,CATEGORY, or TOKEN
−
HOWEVER using this appears to remove all mention of colour from creature descriptions. It does not appear in any default creatures.
+
*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:<br>
 +
[TISSUE:GAS] [TISSUE_NAME:gas:NP] [TISSUE_MATERIAL:LOCAL_CREATURE_MAT:GAS] [TISSUE_MAT_STATE:GAS] [RELATIVE_THICKNESS:50] [TISSUE_LEAKS] [TISSUE_SHAPE:LAYER]
  
 
|-
 
|-
−
| {{text anchor|TLCM_NOUN}}
+
| {{text anchor|TITAN}}
 
| Caste
 
| Caste
−
|  
+
|
−
*name
+
| Found on [[titan]]s. Cannot be specified in user-defined raws.
−
*SINGULAR or PLURAL
 
−
| Names the tissue layer color modifier, and determines the noun. Also used by stonesense for colouring body parts.  
 
  
 
|-
 
|-
−
| {{text anchor|TLCM_TIMING}}
+
| {{text anchor|TRADE_CAPACITY}}
−
| Caste
 
−
|
 
−
*ROOT
 
−
*start change window years:days:end change window years:days
 
−
| determines the point in the creature's life where the color change begins
 
−
 
 
−
|-
 
−
| {{text anchor|TRADE_CAPACITY}}
 
 
| Caste
 
| Caste
 
|   
 
|   
−
| How much the creature can carry when used by merchants.  
+
*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.
  
 
|-
 
|-
Line 2,194: Line 2,461:
 
| Caste
 
| Caste
 
|   
 
|   
−
| Shortcut for [TRAINABLE_HUNTING] + [TRAINABLE_WAR].
+
| Shortcut for {{token|TRAINABLE_HUNTING|c}} + {{token|TRAINABLE_WAR|c}}.
  
 
|-
 
|-
Line 2,200: Line 2,467:
 
| Caste
 
| Caste
 
|   
 
|   
−
| Can be trained as a hunting beast, increasing speed.
+
| Can be [[Animal trainer|trained]] as a hunting beast, increasing speed.
  
 
|-
 
|-
Line 2,206: Line 2,473:
 
| Caste
 
| Caste
 
|   
 
|   
−
| Can be trained as a war beast, increasing strength and endurance.
+
| Can be [[Animal trainer|trained]] as a war beast, increasing strength and endurance.
  
 
|-
 
|-
Line 2,212: Line 2,479:
 
| Caste
 
| Caste
 
|   
 
|   
−
| Allows the creature to go into martial trances.
+
| Allows the creature to go into [[martial trance]]s. Used by dwarves in the vanilla game.
  
 
|-
 
|-
Line 2,218: Line 2,485:
 
| Caste
 
| Caste
 
|   
 
|   
−
| The creature is immune to traps. Probably every procedurally generated megabeast has this.
+
| 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}}
 
| {{text anchor|TRIGGERABLE_GROUP}}
 
| Creature
 
| Creature
−
| min:max  
+
|  
−
| A large swarm of vermin can be disturbed, usually in Adventure mode.{{verify}}
+
*min
 +
*max  
 +
| A large swarm of vermin can be disturbed, usually in adventurer mode.{{verify}}
  
 
|-
 
|-
Line 2,232: Line 2,501:
 
*noun
 
*noun
 
*SINGULAR or PLURAL  
 
*SINGULAR or PLURAL  
−
| Noun for the TISSUE_STYLE_UNIT, used in the description of the tissue layer's style.
+
| Noun for the {{token|TISSUE_STYLE_UNIT|c}}, used in the description of the tissue layer's style.
 
|}
 
|}
  
−
<div align="center">
+
{{alphabetical TOC|style=margin: 1em auto;}}
−
{{alphabetical TOC}}
 
−
</div>
 
  
 
==U==
 
==U==
Line 2,251: Line 2,518:
 
| Creature
 
| Creature
 
|
 
|
−
| Creature will occur in every region with the correct biome. Does not apply to evil/good tags.
+
| 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.
  
 
|-
 
|-
Line 2,259: Line 2,526:
 
*mindepth
 
*mindepth
 
*maxdepth  
 
*maxdepth  
−
| Depth the creature appears underground. Numbers can be from 0 to 5. 0 is actually 'above ground' and can be used if the creature is to appear both above and below ground. A single argument may be used instead of min and max. Only magma creatures use 4 or 5 in the default raws.  [[Demon]]s use only 5:5; user-defined creatures with both this depth and [FLIER] will take part in the initial wave from the HFS alongside generated demons.  Without [FLIER], they will only spawn from the map edges. Civilizations that can use underground plants or animals will only export (via the embark screen or caravans) things that available at depth 1.
+
| 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.
  
 
|-
 
|-
Line 2,265: Line 2,532:
 
| Caste
 
| Caste
 
|   
 
|   
−
| Creature swims under the water and can't be seen. Seems to be a relic from the 2D era.
+
| The creature is displayed as blue when in [[Water#Depth|7/7 water]]. Used on fish and amphibious creatures which swim under the water.
  
 
|-
 
|-
Line 2,271: Line 2,538:
 
| Caste
 
| Caste
 
|   
 
|   
−
| Typically found on generated [[demon]]s; causes the game to create a single named instance of the demon which will emerge from the underworld and take over civilizations during worldgen. Cannot be specified in user-defined raws.
+
| 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.
  
 
|-
 
|-
Line 2,280: Line 2,547:
 
*old 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."
 
| 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.