Difference between revisions of "Creature token"

Latest revision as of 00:51, 17 May 2024

xTATTEREDx · +FINE+ · *SUPERIOR* · ≡EXCEPTIONAL≡ · ☼MASTERWORK☼

v50.13 · v0.47.05

This article is about the current version of DF.
Note that some content may still need to be updated.

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

Vanilla creature definitions can be found in <Dwarf Fortress>\data\vanilla\vanilla_creatures\. Creature ID is also used with graphics tokens to make customizable graphics sets.

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)

Contents A B C D E F G H I J K L M N O P Q R S T U V W X Y Z top

A[edit]

Token	Type	Arguments	Description
ADOPTS_OWNER	Caste		Prevents tamed creature from being made available for adoption, instead allowing it to automatically adopt whoever it wants. The basic requirements for adoption are intact, and the creature will only adopt individuals who have a preference for their species. Used by cats in the vanilla game. When viewing 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".
ALCOHOL_DEPENDENT	Caste		Makes the creature need alcohol to get through the working day; it will choose to drink booze instead of water if possible. Going sober for too long reduces speed.
ALL_ACTIVE	Caste		Sets the creature to be active during the day, night, and twilight in Adventurer Mode. Seems to be a separate value from `[DIURNAL]`/`[NOCTURNAL]`/`[CREPUSCULAR]`, rather than implying them.^[Verify]
ALTTILE	Creature	'character' or tile number	If set, the creature will blink between its `[TILE]` and its ALTTILE.
AMBUSHPREDATOR	Caste		Found on `[LARGE_PREDATOR]`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]
AMPHIBIOUS	Caste		Allows a creature to breathe both in and out of water (unlike `[AQUATIC]`) - does not prevent drowning in magma.
APP_MOD_DESC_RANGE	Appearance Modifier	Range (6 values, low to high)	Based on info from Wannabehero on the forums: When used with an appearance modifier token (BP_APPEARANCE_MODIFIER or BODY_APPEARANCE_MODIFIER), tells the game what numeric ranges to map to which descriptors. The game uses 7 descriptor levels for each modifier, with the center one generally being to omit the thing from the creature description entirely. The six values in APP_MOD_DESC_RANGE define the boundaries between each described range. If this is not specified it uses the numbers 10:50:95:105:150:190.
APP_MOD_GENETIC_MODEL	Appearance Modifier	Model (Accepts DOMINANT_MORE, DOMINANT_LESS, and MIX)	Defines a genetic model for the relevant appearance modifier(s). May or may not do anything significant at present.
APP_MOD_IMPORTANCE	Appearance Modifier	number	Determines how important the appearance modifier is, for determining whether it shows up in the creature description.^[Verify]
APP_MOD_NOUN	Appearance Modifier	noun SINGULAR or PLURAL	Creates a noun for the appearance, and whether it is singular or plural.
APP_MOD_RATE	Appearance Modifier	Rate (integer) Scale (DAILY, YEARLY) min (growth) max (growth) start year start day end year end day	Setting the growth rate of the modifier. The last two tokens can be replaced by NO_END to have growth continue indefinitely.
APPLY_CREATURE_VARIATION	Caste	creature variation ID (optional) any amount of arbitrary arguments	Applies the specified creature variation. See Creature_variation_token#Arguments_and_conditional_tokens for how the subsequent arguments may be used.
APPLY_CURRENT_CREATURE_VARIATION	Special		Applies the effects of all pending `[CV_ADD_TAG]` and `[CV_REMOVE_TAG]` tokens that have been defined in the current creature.
AQUATIC	Caste		Enables the creature to breathe in water, but causes it to air-drown on dry land.
ARENA_RESTRICTED	Caste		Causes the creature to be excluded from the object testing arena's creature spawning list. Typically applied to spoileriffic creatures.
ARTIFICIAL_HIVEABLE	Creature		Enables the creature to be kept in artificial hives by beekeepers.
AT_PEACE_WITH_WILDLIFE	Caste		Prevents the creature from attacking or frightening creatures with the `[NATURAL]` tag.
ATTACK	Caste	token selection criteria (it's complicated)	Defines the attack name, and the body part used. See below for valid subtokens Example: `[ATTACK:GORE:BODYPART:BY_CATEGORY:HORN]` GORE = name of the attack BODYPART:BY_CATEGORY:HORN = the horn is used to attack (presuming the creature has one)
ATTACK_TRIGGER	Caste	population exported wealth created wealth	Specifies when a megabeast or semi-megabeast will attack the fortress. The attacks will start occurring when all of the requirements are met. Setting a value to 0 disables the trigger.

Contents A B C D E F G H I J K L M N O P Q R S T U V W X Y Z top

B[edit]

Token	Type	Arguments	Description
BABY	Caste	integer	Age at which creature is considered a child, the default is zero. One can think of this as the duration of the baby stage.
BABYNAME	Caste	singular plural	Defines a new name for a creature in baby state at the caste level. For non-caste-specific baby names, see `[GENERAL_BABY_NAME]`.
BEACH_FREQUENCY	Caste	integer	Creature may be subject to beaching, becoming stranded on shores, where they will eventually air-drown. The number indicates the frequency of the occurrence. Presumably requires the creature to be `[AQUATIC]`. Used by orcas, sperm whales and sea nettle jellyfish in the vanilla game.
BENIGN	Caste		The creature is non-aggressive by default, and will never automatically be engaged by companions or soldiers, running away from any creatures that are not friendly to it, and will only defend itself if it becomes enraged. Can be thought of as the counterpoint of the `[LARGE_PREDATOR]` tag. When tamed, animals with this tag will be useless for fortress defense. This and `[TRADE_CAPACITY]` are required for `[PACK_ANIMAL]` to function properly, if an animal contains the aforementioned requirements without this tag: items loaded by the merchants will be dropped upon departure.
BIOME	Creature	biome token	Select a biome the creature may appear in.
BLOOD	Caste	<material token> <material state>	Specifies what the creature's blood is made of.
BLOODSUCKER	Caste		Causes vampire-like behaviour; the creature will suck the blood of unconscious victims when its 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.
BODY	Caste	body parts	Draws body parts from OBJECT:BODY files (such as body_default.txt) Example: [BODY:BODY_WITH_HEAD_FLAG:HEART:GUTS:BRAIN:MOUTH] This is the body from a purring maggot. It creates a body with head, a heart, some guts, a brain, and a mouth. That's all a maggot needs. The body parts need to be listed in an order such that any parent part appears before its connected children. For example [BODY:HEART:BODY_WITH_HEAD_FLAG] produces a "Body Token Recognized But Could Not Connect: HEART" error because HEART can't find any UPPERBODY(s) to connect to. Switching the order to [BODY:BODY_WITH_HEAD_FLAG:HEART] fixes the problem because now the UPPERBODY is created before the HEART tries to connect to it. If the body is left undefined, the creature (or caste) will be tagged as [DOES_NOT_EXIST].^[Verify]
BODY_APPEARANCE_MODIFIER	Caste	ATTRIBUTE lowest lower low median high higher highest	These body modifiers give individual creatures different characteristics. In the case of HEIGHT, BROADNESS and LENGTH, the modifier is also a percentage change to the BODY_SIZE of the individual creature. The seven numbers afterward give a distribution of ranges. Each interval has an equal chance of occurring. Example: [BODY_APPEARANCE_MODIFIER:HEIGHT:90:95:98:100:102:105:110] HEIGHT : marks the height to be changed 90:95:98:100:102:105:110 : sets the range from the shortest (90% of the average height) to the tallest (110% of the average height) creature variation.
BODY_DETAIL_PLAN	Caste	PlanName Arguments	Loads a plan from listed OBJECT:BODY_DETAIL_PLAN files, such as b_detail_plan_default.txt. Mass applies USE_MATERIAL_TEMPLATE, mass alters RELSIZE, alters body part positions, and will allow tissue layers to be defined. Tissue layers are defined in order of skin to bone here. Example: [BODY_DETAIL_PLAN:VERTEBRATE_TISSUE_LAYERS:SKIN:FAT:MUSCLE:BONE:CARTILAGE] This creates the detailed body of a fox, the skin, fat, muscle, bones and cartilage out of the vertebrate tissues. A maggot would only need: [BODY_DETAIL_PLAN:EXOSKELETON_TISSUE_LAYERS:SKIN:FAT:MUSCLE]
BODY_SIZE	Caste	years days size	Sets size at a given age. Size is in cubic centimeters, and for normal body materials, is roughly equal to the creature's average weight in grams. Example: [BODY_SIZE:0:0:10000] [BODY_SIZE:1:168:50000] [BODY_SIZE:12:0:220000] This describes the size of a minotaur. Its birth size would be 10,000 cm³ (~10 kg). At 1 year and 168 days old it would be 50,000 cm³ (~50 kg). And as an adult (at 12 years old) it would be 220,000 cm³ and weigh roughly 220 kg.
BODYGLOSS	Caste	gloss	Substitutes body part text with replacement text. Draws gloss information from OBJECT:BODY files (such as body_default.txt)
BONECARN	Caste		Creature eats bones. Implies `[CARNIVORE]`. Adventurers with this token are currently unable to eat bones.^Bug:11069
BP_ADD_TYPE	Caste		Adds a type to a body part - used with `[SET_BP_GROUP]`. In vanilla DF, this is used for adding the type 'GELDABLE' to the lower body of certain creatures.
BP_APPEARANCE_MODIFIER	Caste	QUALITY lowest lower low median high higher highest	Sets up the breadth of possibilities for appearance qualities for a selected BP group. EG. Eyes (CLOSE_SET, DEEP_SET, ROUND_VS_NARROW, LARGE_IRIS),Lips (THICKNESS), Nose (BROADNESS, LENGTH, UPTURNED, CONVEX), Ear (SPLAYED_OUT, HANGING_LOBES, BROADNESS, HEIGHT), Tooth (GAPS), Skull (HIGH_CHEEKBONES, BROAD_CHIN, JUTTING CHIN, SQUARE_CHIN), Neck (DEEP_VOICE, RASPY_VOICE), Head (BROADNESS, HEIGHT)
BP_REMOVE_TYPE	Caste		Removes a type from a body part. Used with `[SET_BP_GROUP]`.
BUILDINGDESTROYER	Caste	1 or 2	Allows a creature to destroy furniture and buildings. Value [1] targets mostly doors, hatches, furniture and the like. Value [2] targets anything not made with the b + C commands.

Contents A B C D E F G H I J K L M N O P Q R S T U V W X Y Z top

C[edit]

Token	Type	Arguments	Description
CAN_DO_INTERACTION	Caste	interaction token	The creature can perform an interaction. See interaction token.
CAN_LEARN	Caste		The creature gains skills and can have professions. If a member of a civilization (even a pet) has this token, it'll need to eat, drink and sleep. Note that this token makes the creature unable to be 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.
CAN_SPEAK	Caste		Can talk. Note that this is not necessary for a creature to gain social skills.
CANNOT_CLIMB	Caste		Creature cannot climb, even if it has free grasp parts.
CANNOT_JUMP	Caste		Creature cannot jump.
CANNOT_UNDEAD	Caste		Acts like `[NOT_LIVING]`, except that `[OPPOSED_TO_LIFE]` creatures will attack them.
CANOPENDOORS	Caste		Allows the creature to open doors 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.^v50.03
CARNIVORE	Caste		Creature only eats meat. If the creature goes on rampages in worldgen, it will often devour the people/animals it kills. Does not seem to affect the diet of the adventurer in adventure mode.
CASTE	Creature	name	Defines a caste.
CASTE_ALTTILE	Caste	tile number or "letter"	Caste-specific `[ALTTILE]`. Requires `[CASTE_TILE]`.
CASTE_COLOR	Caste	fg bg brightness	Caste-specific `[COLOR]`.
CASTE_GLOWCOLOR	Caste	fg bg brightness	Caste-specific `[GLOWCOLOR]`.
CASTE_GLOWTILE	Caste	tile value or "letter"	Caste-specific `[GLOWTILE]`.
CASTE_NAME	Caste	singular plural adjective	While `[NAME]` describes the name of the species, `[CASTE_NAME]` 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".
CASTE_PROFESSION_NAME	Caste	Unit type token (Profession) singular plural	Caste-specific `[PROFESSION_NAME]`.
CASTE_SOLDIER_ALTTILE	Caste	'character' or tile number	Caste-specific `[SOLDIER_ALTTILE]`. Requires `[CASTE_SOLDIER_TILE]`.
CASTE_SOLDIER_TILE	Caste	'character' or tile number	Caste-specific `[CREATURE_SOLDIER_TILE]`.
CASTE_TILE	Caste	tile number or "letter"	Caste-specific `[CREATURE_TILE]`.
CAVE_ADAPT	Caste		Gives the creature a bonus in caves. Also causes cave adaptation.
CDI	Caste	Varies	Specifies interaction details following a `[CAN_DO_INTERACTION]` token. See interaction token.
CHANGE_BODY_SIZE_PERC	Caste	integer	Multiplies body size by a factor of (integer)%. 50 halves size, 200 doubles.
CHANGE_FREQUENCY_PERC	Creature	integer	Multiplies frequency by a factor of (integer)%.
CHILD	Caste	integer	Age at which creature is considered an adult - one can think of this as the duration of the child stage. Allows the creature's offspring to be rendered fully tame if trained during their childhood.
CHILDNAME	Caste	singular plural	Defines a new name for a creature in the child state at the caste level. For non-caste-specific child names, see `[GENERAL_CHILD_NAME]`.
CLUSTER_NUMBER	Creature	min max	The minimum/maximum numbers of how many creatures per spawned cluster. Vermin fish with this token in combination with temperate ocean and river biome tokens will perform seasonal migrations. Defaults to 1:1 if not specified.
CLUTCH_SIZE	Caste	min max	Number of eggs laid in one sitting.
COLONY_EXTERNAL	Caste		Caste hovers around colony.
COLOR	Creature	foreground background brightness	Color of the creature's tile. See Color for usage.
COMMON_DOMESTIC	Caste		When combined with any of `[PET]`, `[PACK_ANIMAL]`, `[WAGON_PULLER]` and/or `[MOUNT]`, the creature is guaranteed to be domesticated by any civilization with `[COMMON_DOMESTIC_PET]`, `[COMMON_DOMESTIC_PACK]`, `[COMMON_DOMESTIC_PULL]` and/or `[COMMON_DOMESTIC_MOUNT]` respectively. Such civilizations will always have access to the creature, even in the absence of wild populations. This token is invalid on `[FANCIFUL]` creatures.
CONVERTED_SPOUSE	Caste		Creatures of this caste's species with the `[SPOUSE_CONVERTER]` and `[NIGHT_CREATURE_HUNTER]` tokens will kidnap `[SPOUSE_CONVERSION_TARGET]`s of an appropriate sex and convert them into castes with CONVERTED_SPOUSE.
COOKABLE_LIVE	Caste		Set this to allow the creature to be cooked in meals without first being butchered/cleaned. Used by some water-dwelling vermin such as mussels, nautiluses and oysters.
CRAZED	Caste		Creature is 'berserk' and will attack all other creatures, except members of its own species that also have the CRAZED tag. It will show Berserk in the unit list. Berserk creatures go on rampages during worldgen much more frequently than non-berserk ones.
COPY_TAGS_FROM	Special	creature ID	Copies another specified creature. This will override any definitions made before it; essentially, it makes this creature identical to the other one, which can then be modified. Often used in combination with `[APPLY_CREATURE_VARIATION]` to import standard variations from a file. The vanilla giant animals and animal peoples are examples of this token combination.
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.
CREATURE_CLASS	Caste	classname	An arbitrary creature classification. Can be set to anything, but the only vanilla uses are GENERAL_POISON (used in syndromes), EDIBLE_GROUND_BUG (used as targets for `[GOBBLE_VERMIN_CLASS]`), 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: `[GOBBLE_VERMIN_CLASS]`, `[GOBBLE_VERMIN_CLASS]` Interaction tokens: `[IT_AFFECTED_CLASS]`, `[IT_IMMUNE_CLASS]` Animal definition (Entity) tokens: `[ANIMAL_CLASS]`, `[ANIMAL_FORBIDDEN_CLASS]` Position (Entity) token: `[ALLOWED_CLASS]` Syndrome tokens: `[SYN_AFFECTED_CLASS]`, `[SYN_IMMUNE_CLASS]`, `[CE_SENSE_CREATURE_CLASS]`
CREATURE_SOLDIER_TILE	Creature	'character' or tile number	Creatures active in their civilization's military will use this tile instead.
CREATURE_TILE	Creature	'character' or tile number	The symbol of the creature in ASCII mode.
CREPUSCULAR	Caste		Sets the creature to be active at twilight in adventurer mode.
CURIOUSBEAST_EATER	Caste		Allows a creature to 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.
CURIOUSBEAST_GUZZLER	Caste		Allows a creature to (very quickly) drink your alcohol. Or spill the barrel to the ground. Also affects undead versions of the creature. 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.
CURIOUSBEAST_ITEM	Caste		Allows a creature to 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.
CV_ADD_TAG	Special	TAG NAME	Adds a tag. Used in conjunction with creature variation templates.
CV_REMOVE_TAG	Special	TAG NAME	Removes a tag. Used in conjunction with creature variation templates.

Contents A B C D E F G H I J K L M N O P Q R S T U V W X Y Z top

D[edit]

Token	Type	Arguments	Description
DEMON	Caste		Found on generated demons. 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].
DESCRIPTION	Caste	text	A brief description of the creature type, as displayed when viewing the creature's description/thoughts & preferences screen.
DIE_WHEN_VERMIN_BITE	Caste		Causes the creature to die upon attacking. Used by honey bees to simulate them dying after using their stingers.
DIFFICULTY	Caste	integer	Increases experience gain during adventure mode. Creatures with a difficulty of 11 or higher are not assigned for quests in adventure mode.
DIURNAL	Caste		Sets the creature to be active during the day in Adventurer Mode.
DIVE_HUNTS_VERMIN	Caste		The creature hunts vermin by diving from the air. On tame creatures, it has the same effect as `[HUNTS_VERMIN]`. Found on peregrine falcons.
DOES_NOT_EXIST	Creature		Adding this token to a creature prevents it from appearing in generated worlds (unless it's marked as always present for a particular civilisation). For example, adding it to dogs 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 `[FANCIFUL]`, artistic depictions of the creature will occur regardless. Used by centaurs, chimeras and griffons in the vanilla game. Note: a creature tagged as DOES_NOT_EXIST can still be summoned successfully, as long as it has a body defined in its raws. [1]. It's also possible for another creature to transform into it.

Contents A B C D E F G H I J K L M N O P Q R S T U V W X Y Z top

E[edit]

Token	Type	Arguments	Description
EBO_ITEM	Caste	item token material token (ANY_HARD_STONE can be used for the material)	Defines the item that the creature drops upon being butchered. Used with `[EXTRA_BUTCHER_OBJECT]`.
EBO_SHAPE	Caste	gem shape	The shape of the creature's extra butchering drop. Used with `[EXTRA_BUTCHER_OBJECT]`.
EGG_MATERIAL	Caste	<material token> <material state>	Defines the material composition of eggs laid by the creature. 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.
EGG_SIZE	Caste	size	Determines the size of laid eggs. 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.
EQUIPMENT_WAGON	Creature		Makes the creature appear as a large 3×3 wagon responsible for carrying trade goods, pulled by two `[WAGON_PULLER]` creatures and driven by a merchant.
EQUIPS	Caste		Allows the creature to wear or wield items.
EVIL	Creature		The creature is considered evil and will only show up in evil biomes. Civilizations with `[USE_EVIL_ANIMALS]` can domesticate them regardless of exotic status. Has no effect on cavern creatures except to restrict taming. A civilization with evil creatures can colonise evil areas.
EXTRA_BUTCHER_OBJECT	Caste	BY_CATEGORY, BY_TYPE, BY_TOKEN TYPE, CATEGORY, or TOKEN	The creature drops an additional object when butchered, as defined by `[EBO_ITEM]` and `[EBO_SHAPE]`. Used for gizzard stones in default creatures. For some materials, needs to be defined after caste definitions with SELECT_CASTE:ALL^Bug:6355
EXTRACT	Caste	material token	Defines a creature extract which can be obtained via small animal dissection.
EXTRAVISION	Caste		The creature can see regardless of whether it has working eyes and has full 360 degree vision, making it impossible to strike the creature from a blind spot in combat. Invisible creatures will also be seen, namely intelligent undead using a "vanish" power.

Contents A B C D E F G H I J K L M N O P Q R S T U V W X Y Z top

F[edit]

Token	Type	Arguments	Description
FANCIFUL	Creature		The creature is a thing of legend and known to all civilizations. Its materials cannot be requested or preferred. The tag also adds some art value modifiers. Used by a number of creatures. Conflicts with `[COMMON_DOMESTIC]`.
FEATURE_ATTACK_GROUP	Caste		Found on subterranean animal-man tribals. Currently defunct. In previous versions^[Verify], it caused these creatures to crawl out of chasms and underground rivers.
FEATURE_BEAST	Caste		Found on forgotten beasts. 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 `[BIOME]` in which the creature will live, and both surface and subterranean biomes are allowed. Does not stack with `[LARGE_ROAMING]` and if both are used the creature will not spawn. Appears to be incompatible with `[DEMON]` even if used in separate castes.
FEMALE	Caste		Makes the creature biologically female, enabling her to bear young. Usually specified inside a caste.
FIREIMMUNE	Caste		Makes the creature immune to FIREBALL and 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 materials - see the dragon raws for an example).
FIREIMMUNE_SUPER	Caste		Like `[FIREIMMUNE]`, but also renders the creature immune to DRAGONFIRE attacks.
FISHITEM	Caste		The creature's corpse is a single FISH_RAW food item that needs to be cleaned (into a 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 `[COOKABLE_LIVE]`, 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.
FIXED_TEMP	Caste	temperature	The creature's body is constantly at this temperature, heating up or cooling the surrounding area. Alters the temperature of the creature's inventory and all adjacent tiles, 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 pathfinding issues in fortress mode.
FLEEQUICK	Caste		If engaged in combat, the creature will flee at the first sign of resistance. Used by kobolds in the vanilla game.
FLIER	Caste		Allows a creature to fly, independent of it having wings or not. Fortress Mode pathfinding only partially incorporates flying - flying creatures need a land path to exist between them and an area in order to access it, but as long as one such path exists, they do not need to use it, instead being able to fly over intervening obstacles. Winged creatures with this token can lose their ability to fly if their wings are crippled or severed. Winged creatures without this token will be unable to fly. (A 'wing' in this context refers to any body part with its own FLIER token).
FREQUENCY	Creature	number, max 100	Determines the chances of a creature appearing within its environment, with higher values resulting in more frequent appearance. Also affects the chance of a creature being brought in a caravan for trading. This value is used multiply to determine the rarity of animal populations. A creature with [FREQUENCY:50] will appear in 50% of valid biomes, and be present in 50% of the area within those biomes. When a 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 `[POP_RATIO]`.

Contents A B C D E F G H I J K L M N O P Q R S T U V W X Y Z top

G[edit]

Token	Type	Arguments	Description
GAIT	Caste	<gait type> <gait name> <max speed> <build up time> <max turning speed> <start speed> <energy expenditure> <gait flag(s)>	Defines a gait by which the creature can move. See Gait for more information. Specifically, you likely want to use one of the existing STANDARD_X_GAITS creature variations, as described in this subsection. <max speed> indicates the maximum 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 tiles 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 collapse. NO_BUILD_UP can be specified instead of a <start speed> value to make the <max speed> instantly achievable upon initiating movement (this is equivalent to a <build up time> of 0). Note that <build up time> and <max turning speed> are both ignored if specified alongside this (as NO_BUILD_UP trumps <build up time> and preserves <max speed> whilst turning, and <max turning speed> cannot exceed <max speed>) so it is permissible to omit them so long as they are both omitted together. It's possible to specify a <start speed> greater than the <max speed>; the moving creature will decelerate towards its <max speed> in this case. valid gait types: WALK Used for moving normally over ground tiles. CRAWL Used for moving over ground tiles whilst prone. SWIM Used for moving through tiles containing water or magma at a depth of at least 4/7. FLY Used for moving through open space. CLIMB Used for moving whilst climbing. valid gait flags: AGILITY Speeds/slows movement depending on the creature's Agility stat. STRENGTH Speeds/slows movement depending on the creature's Strength stat. LAYERS_SLOW Makes THICKENS_ON_ENERGY_STORAGE and THICKENS_ON_STRENGTH tissue layers slow movement depending on how thick they are. Adding the STRENGTH gait flag counteracts the impact of the latter layer. STEALTH_SLOWS:<percentage> Slows movement by the specified percentage when the creature is sneaking.
GENERAL_BABY_NAME	Creature	singular plural	Like `[BABYNAME]`, but applied regardless of caste.
GENERAL_CHILD_NAME	Creature	singular plural	Like `[CHILDNAME]`, but applied regardless of caste.
GENERAL_MATERIAL_FORCE_MULTIPLIER	Caste	value A value B	Has the same function as `[MATERIAL_FORCE_MULTIPLIER]`, but applies to all attacks instead of just those involving a specific material. Appears to be overridden by MATERIAL_FORCE_MULTIPLIER (werebeasts, for example, use both tokens to provide resistance to all materials, with one exception to which they are especially vulnerable).
GENERATED	Creature		Found on procedurally generated creatures like forgotten beasts, titans, demons, angels, and night creatures. Cannot be specified in user-defined raws.
GETS_INFECTIONS_FROM_ROT	Caste		Makes the creature get infections from necrotic tissue.
GETS_WOUND_INFECTIONS	Caste		Makes the creature's wounds become infected if left untreated for too long.
GLOWCOLOR	Creature	foreground background brightness	The colour of the creature's `[GLOWTILE]`.
GLOWTILE	Creature	ascii character	If present, the being glows in the dark (generally used for Adventurer Mode). The tile is what replaces the being's current tile when it is obscured from your sight by darkness. The default setting for kobolds (a yellow quotation mark) provides a nice "glowing eyes" effect. The game is also hardcoded to automatically convert quotation mark GLOWTILES into apostrophes if the creature has lost one eye. This works at the generic creature level - for caste-specific glow tiles, use `[CASTE_GLOWTILE]` instead.
GNAWER	Caste	verb	The creature can and will gnaw its way out of animal traps and cages using the specified verb, depending on the material from which it is made (normally wood).
GOBBLE_VERMIN_CLASS	Caste	class	The creature eats vermin of the specified class.
GOBBLE_VERMIN_CREATURE	Caste	creature caste	The creature eats a specified vermin.
GO_TO_END	Special		When using tags from an existing creature, inserts new tags at the end of the creature.
GO_TO_START	Special		When using tags from an existing creature, i

@@ Line 1: / Line 1: @@
-{{Quality|Exceptional|22:04, 20 September 2016 (UTC)}}
+{{Quality|Exceptional}}
 {{av}}
+{{Modding}}
-A full list of all known [[creature]] [[token]]s.
+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==
@@ Line 22: / Line 26: @@
 | Caste
 |
-| Prevents tamed creature from being made available for adoption, instead allowing it to automatically adopt whoever it wants. The basic requirements for adoption are intact, and the creature will only adopt individuals who have a [[preference]] for their species. Used by [[cat]]s in the vanilla game.
+| 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 34: / Line 38: @@
 | Caste
 |
-| Sets the creature to be active during the day, night, and twilight in Adventurer Mode. Seems to be a separate value from {{token|DIURNAL|c}}/{{token|NOCTURNAL|c}}/{{token|CREPUSCULAR|c}}, rather than implying them.
+| 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}}
 |-
@@ Line 57: / Line 61: @@
 |-
 | {{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. If this is not specified it uses the numbers 10:50:95:105:150:190.
 |-
 | {{text anchor|APP_MOD_GENETIC_MODEL}}
-| Caste
+| Appearance Modifier
 |
 *Model (Accepts DOMINANT_MORE, DOMINANT_LESS, and MIX)
@@ Line 71: / Line 77: @@
 |-
 | {{text anchor|APP_MOD_IMPORTANCE}}
-| Caste
+| Appearance Modifier
 |
 *number
@@ Line 78: / Line 84: @@
 |-
 | {{text anchor|APP_MOD_NOUN}}
-| Caste
+| Appearance Modifier
 |
 *noun
@@ Line 86: / Line 92: @@
 |-
 | {{text anchor|APP_MOD_RATE}}
-| Caste
+| Appearance Modifier
 |
 *Rate (integer)
@@ Line 102: / Line 108: @@
 | 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 133: / Line 140: @@
 | Caste
 |
-| Prevents the creature from attacking or frighten creatures with the {{Token|NATURAL|c}} tag.
+| Prevents the creature from attacking or frightening creatures with the {{Token|NATURAL|c}} tag.
 |-
@@ Line 140: / Line 147: @@
 |
 *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
 '''Example:'''<br />
@@ Line 156: / Line 161: @@
 *exported wealth
 *created wealth
-| Specifies when a [[megabeast]] or [[semi-megabeast]] will attack the fortress. The attacks will start occuring when at least one of the requirements is met. Setting a value to 0 disables the trigger.
+| 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==
@@ Line 198: / Line 201: @@
 | Caste
 |
-| The creature is non-aggressive by default, and will never automatically be engaged by companions or soldiers. It will run away from any creatures that are not friendly to it, and will only defend itself if it becomes enraged. Can be thought of as the counterpoint of the {{token|LARGE_PREDATOR|c}} tag. When tamed, animals with this tag will be useless for fortress defense.
+| The creature is non-aggressive by default, and will never automatically be engaged by companions or soldiers, running away from any creatures that are not friendly to it, and will only defend itself if it becomes enraged. Can be thought of as the counterpoint of the {{token|LARGE_PREDATOR|c}} tag. When tamed, animals with this tag will be useless for fortress defense.
+This and {{token|TRADE_CAPACITY|c}} are required for {{token|PACK_ANIMAL|c}} to function properly, if an animal contains the aforementioned requirements without this tag: items loaded by the merchants will be dropped upon departure.
 |-
@@ Line 219: / Line 224: @@
 | Caste
 |
-| Causes [[vampire]]-like behaviour; the creature will suck the [[Creature_token#BLOOD|blood]] of unconscious victims when its [[Syndrome#TIME_SINCE_SUCKED_BLOOD|thirst for blood]] grows sufficiently large. When controlling the creature in adventure mode, this can be done at will. Seems to be required to make the creature denouncable 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.
 |-
@@ Line 231: / Line 236: @@
 This is the body from a [[purring maggot]]. It creates a body with head, a heart, some guts, a brain, and a mouth. That's all a maggot needs.
-'''If the body is left undefined, the creature will cause a crash whenever it spawns.''' {{Bug|}}
+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 257: / Line 264: @@
 *PlanName
 *Arguments
-| 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.
+| 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 />
 [BODY_DETAIL_PLAN:VERTEBRATE_TISSUE_LAYERS:SKIN:FAT:MUSCLE:BONE:CARTILAGE] <br />
@@ Line 325: / Line 332: @@
 |}
-<div align="center">
+{{alphabetical TOC|style=margin: 1em auto;}}
-{{alphabetical TOC}}
-</div>
 ==C==
@@ Line 378: / Line 383: @@
 | Caste
 |
-| Allows the creature to open [[door]]s that are set to be unpassable for pets. In adventure mode, creatures lacking this token will be unable to pass through door tiles except whilst these are occupied by other creatures.
+| 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 384: / Line 389: @@
 | Caste
 |
-| Creature ''only'' eats [[meat]]. If the creature goes on rampages in worldgen, it will often devour the people/animals it kills.
+| 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 432: / Line 437: @@
 *plural
 *adjective
-| Caste-specific {{token|NAME|c}}.
+| 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 456: / Line 461: @@
 *'character' or tile number
 | Caste-specific {{token|CREATURE_SOLDIER_TILE|c}}.
-|-
-| {{text anchor|CASTE_SPEECH}}
-| Caste
-|
-*speech file
-| Caste-specific {{token|SPEECH|c}}.
 |-
@@ Line 482: / Line 480: @@
 |
 *Varies
-| Specifies details for the preceding {{token|CAN_DO_INTERACTION|c}} token. See [[interaction token]].
+| Specifies interaction details following a {{token|CAN_DO_INTERACTION|c}} token. See [[interaction token]].
 |-
@@ Line 511: / Line 509: @@
 *singular
 *plural
-| Defines a new name for a creature in child state at the caste level. For non-caste-specific child names, see {{token|GENERAL_CHILD_NAME|c}}.
+| 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 519: / Line 517: @@
 *min
 *max
-| The minimum/maximum numbers of how many creatures per spawned cluster. Certain vermin fish use this token in combination with temperate ocean and river biome tokens to perform seasonal migrations. Defaults to 1:1 if not specified.
+| 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.
 |-
@@ Line 570: / Line 568: @@
 |-
 | {{text anchor|COPY_TAGS_FROM}}
-| Spec
+| Special
 |
-*CREATURE NAME
+*creature ID
-| Copies creature tags, but not caste tags, from another specified creature. Used when making creature variations (i.e. giant animals and [[animal people]]). Often used in combination with {{token|APPLY_CREATURE_VARIATION|c}} to import standard variations from a file. Variations are documented in c_variation_default.txt, which also contains the code for giant animals and animal people.
+| 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 580: / Line 585: @@
 |
 *classname
-| An arbitrary creature classification. Can be set to anything, but only existing uses are GENERAL_POISON (used in syndromes), EDIBLE_GROUND_BUG (valid targets for GOBBLE_VERMIN_x tokens), and MAMMAL (self-explanatory). 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}}
@@ Line 618: / Line 630: @@
 | Caste
 |
-| Allows a creature to [[Steals items|steal things]] (apparently, of the highest value it can find). It will attempt to grab an item of value and immediately make its way to the map's edge, where it will disappear with it. If the creature goes on rampages in worldgen, it will often steal items instead of attacking - [[kea]] birds are infamous for this. Trained and tame instances of the creature will no longer display this behavior. Also, makes the creature unable to drop hauled items until it enters combat.
+| 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 635: / Line 647: @@
 |}
-<div align="center">
+{{alphabetical TOC|style=margin: 1em auto;}}
-{{alphabetical TOC}}
-</div>
 ==D==
@@ Line 651: / Line 661: @@
 | Caste
 |
-| Found on generated [[demon]]s. Marks the caste to be used in the initial wave after breaking into the [[underworld]], and by the demon civilizations created during world-gen breachings{{verify}} {{version|0.47.01}}. Could not be specified in user-defined raws until version [[Release_information/0.47.01|0.47.01]].
+| 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}}.
 |-
@@ Line 694: / Line 704: @@
 |}
-<div align="center">
+{{alphabetical TOC|style=margin: 1em auto;}}
-{{alphabetical TOC}}
-</div>
 ==E==
@@ Line 740: / Line 748: @@
 | Creature
 |
-| Makes the creature appear as a large 3x3 [[wagon]] responsible for carrying trade goods, pulled by two {{token|WAGON_PULLER|c}} creatures and driven by a merchant.
+| Makes the creature appear as a large 3×3 [[wagon]] responsible for carrying trade goods, pulled by two {{token|WAGON_PULLER|c}} creatures and driven by a merchant.
 |-
@@ Line 773: / Line 781: @@
 | Caste
 |
-| The creature can see regardless of whether it has working eyes and has full 360 degree vision, making it impossible to strike the creature from a blind spot in combat.
+| 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==
@@ Line 798: / Line 804: @@
 | Caste
 |
-| Found on [[Animal people#Subterranean animal people|subterranean animal-man]] tribals. Currently defunct. In previous versions, it caused these creatures to crawl out of chasms and underground rivers.
+| 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 804: / Line 810: @@
 | Caste
 |
-| Found on [[forgotten beast]]s. Presumably makes it act as such, initiating underground attacks on fortresses, or leads to the pop-up message upon encountering one{{verify}}. Could not be specified in user-defined raws until version [[Release_information/0.47.01|0.47.01]].
+| 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 836: / Line 844: @@
 |
 *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.
+| 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 857: / Line 865: @@
 |
 *number, max 100
-| Determines the chances of a creature appearing within its environment, with higher values resulting in more frequent appearance. Also affects the chance of a creature being brought in a caravan for trading. The game effectively considers all creatures that can possibly appear and uses the FREQUENCY value as a ''weight'' - for example, if there are three creatures with frequencies 10/25/50, the creature with [FREQUENCY:50] will appear approximately 58.8% of the time. Defaults to 50 if not specified. Not to be confused with {{token|POP_RATIO|c}}.
+| 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==
@@ Line 884: / Line 892: @@
 * <energy expenditure>
 * <gait flag(s)>
-| Defines a gait by which the creature can move. See [[Gait]] for more information.
+| Defines a gait by which the creature can move. See [[Gait]] for more information. Specifically, you likely want to use one of the existing STANDARD_X_GAITS creature variations, as described in [[Gait#Gaits_and_Modding|this subsection]].
 * <max speed> indicates the maximum [[Gait#Speed|speed]] achievable by a creature using this gait
@@ Line 1,023: / Line 1,031: @@
 | 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 1,050: / Line 1,058: @@
 |
 *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==
@@ Line 1,082: / Line 1,088: @@
 *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}}.
+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}}.
 |-
@@ Line 1,102: / Line 1,108: @@
 |
 | 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. This is the historical figure ID of the deity with which the angel is associated.
 |-
@@ Line 1,130: / Line 1,129: @@
 | 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==
@@ Line 1,162: / Line 1,159: @@
 | 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,168: / Line 1,165: @@
 | Caste
 |
-| Alias for {{token|CAN_SPEAK|c}} + {{token|CAN_LEARN|c}} but additionally keeps creatures from being [[butcher|butchered]] by the AI during worldgen and post-gen. In fortress mode, {{token|CAN_LEARN|c}} is enough.
+| Alias for {{token|CAN_SPEAK|c}} + {{token|CAN_LEARN|c}}.
 |-
@@ Line 1,176: / Line 1,173: @@
 * [[item token]]
 * [[material token]]
-| Determines if the creature leaves behind a non-standard corpse (i.e. wood, statue, bars, stone, pool of liquid, 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.
 |-
@@ Line 1,186: / Line 1,183: @@
 |}
-<div align="center">
+{{alphabetical TOC|style=margin: 1em auto;}}
-{{alphabetical TOC}}
-</div>
 ==L==
@@ Line 1,236: / Line 1,231: @@
 | Caste
 |
-| Will attack things that are smaller than it (like dwarves). Only one group of "large predators" (possibly two groups on "savage" maps) will appear on any given map. In adventure mode, large predators will try to ambush and attack you (and your party will attack them back). When tamed, large predators tend to be much more aggressive to enemies than non-large predators, making them a good choice for an animal army. They may go on rampages in worldgen, and adventurers may receive quests to kill them. Also, they can be mentioned in the intro paragraph when starting a fortress e.g. "ere the wolves get hungry."
+| Will attack other creatures that are smaller than it. In [[fortress mode]], only one group of "large predators" (possibly two groups on "savage" maps) will appear on any given map. In [[adventurer mode]], large predators will try to ambush and attack you (and your party will attack them back). When tamed, large predators tend to be much more aggressive to enemies than non-large predators, making them a good choice for an animal army. They may go on rampages in worldgen, and adventurers may receive quests to kill them. Also, they can be mentioned in the intro paragraph when starting a fortress e.g. "ere the wolves get hungry."
+A single biome supports 7 large predator species, picking randomly and rolling a d100 under its {{token|FREQUENCY|c}} to add it until all 7 slots are filled.
+Incompatible with {{token|PACK_ANIMAL|c}} on a technicality, if included: hauled items are likely to be dropped upon entering the map (even if {{token|TRADE_CAPACITY|c}} is present) in contrast to when the merchants depart.
 |-
@@ Line 1,242: / Line 1,240: @@
 | Creature
 |
-| Creature can spawn as a wild animal in the appropriate biomes.
+| 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,270: / Line 1,270: @@
 | Caste
 |
-| The creature will generate light, such as in adventurer mode at night.
+| A vermin featuring this tag will remain visible to an adventurer, even at night, and from a distance. Ostensibly bugged as of v0.47.05.
 |-
@@ Line 1,290: / Line 1,290: @@
 * minimum
 * maximum
-| Determines the number of offspring per one birth.
+| 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}}{{version|0.42.01}}
+| {{text anchor|LOCAL_POPS_CONTROLLABLE}}
 | Creature
 |
@@ Line 1,299: / Line 1,299: @@
 |-
-| {{text anchor|LOCAL_POPS_PRODUCE_HEROES}}{{version|0.42.01}}
+| {{text anchor|LOCAL_POPS_PRODUCE_HEROES}}
 |
 |
@@ Line 1,324: / Line 1,324: @@
 |}
-<div align="center">
+{{alphabetical TOC|style=margin: 1em auto;}}
-{{alphabetical TOC}}
-</div>
 ==M==
@@ Line 1,340: / Line 1,338: @@
 | Caste
 |
-| No function, presumably a placeholder.
+| 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,366: / Line 1,364: @@
 |
 *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,396: / Line 1,394: @@
 | Caste
 |
-| Makes the creature slowly stroll around, unless it's in combat or performing a job. If combined with {{token|CAN_LEARN|c}}, will severely impact their [[pathfinding]] and lead the creature to move extremely slowly when not performing any task.
+| 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,404: / Line 1,402: @@
 | 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.
+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,487: / Line 1,485: @@
 | Caste
 |
-| Makes the species usually produce a single offspring per birth, occasionally producing twins or triplets using typical real-world human probabilities. Requires {{token|FEMALE|c}}.
+| 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,496: / Line 1,494: @@
 |}
-<div align="center">
+{{alphabetical TOC|style=margin: 1em auto;}}
-{{alphabetical TOC}}
-</div>
 ==N==
@@ Line 1,515: / Line 1,511: @@
 *plural
 *adjective
-| The generic name for any creature of this type - will be used when distinctions between caste are unimportant. For names for specific castes, use {{token|CASTE_NAME|c}} instead. If left undefined, the creature will be labeled as "nothing" by the game.
+| 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,544: / Line 1,546: @@
 |-
-| {{text anchor|NIGHT_CREATURE_EXPERIMENTER}}{{version|0.47.01}}
+| {{text anchor|NIGHT_CREATURE_EXPERIMENTER}}
 | Caste
 |
-| Found on some [[necromancer]]s. Creatures with this tag will experiment and create strange hybrid creatures. This tag appears to be all that is needed to allow necromancers or modded secrets to create every category of procedural experimental creature.(Though more testing is required to fully confirm this)[http://www.bay12forums.com/smf/index.php?topic=175437.msg8085255#msg8085255]
+| 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,554: / Line 1,556: @@
 |
 | Found on [[night troll]]s and [[werebeast]]s. Implies that the creature is a [[night creature]], and shows its description in [[legends mode]] entry. The creature is always hostile and will start [[no quarter]] combat with any nearby creatures, except for members of its own race. Note that this tag does not override the creature's normal behavior in [[fortress mode]] except for the aforementioned aggression, and doesn't prevent the creature from fleeing the battles it started. It also removes the creature's materials from stockpile settings list, making them be stored there regardless of settings.
+Does stack with {{token|LARGE_ROAMING|c}} and if both are used the creature will spawn as both historical hunters and as wild animals; this requires specifying a {{token|BIOME|c}} in which the creature will live, and subterranean biomes are allowed.
 This tag causes the usual behaviour of werebeasts in worldgen, that is, fleeing towns upon being cursed and conducting raids from a lair. If this tag is absent from a deity curse, the accursed will simply be driven out of towns in a similar manner to [[vampire]]s. When paired with SPOUSE_CONVERTER, a very small population of the creature will be created during worldgen (sometimes only a single individual will be created), and their histories will be tracked (that is, they will not spawn spontaneously later, they must either have children or convert other creatures to increase their numbers). The creature will settle in a lair and go on rampages during worldgen. It will actively attempt to seek out potential conversion targets to abduct, convert, and have children with (if possible).
 |-
-| {{text anchor|NIGHT_CREATURE_NIGHTMARE}}{{version|0.47.01}}
+| {{text anchor|NIGHT_CREATURE_NIGHTMARE}}
 | Caste
 |
@@ Line 1,591: / Line 1,595: @@
 | Caste
 |
-| Creature does not need to [[food|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,699: / Line 1,703: @@
 | Caste
 |
-| Creature will not drop meat when [[butcher|butchered]].
+| Creature will not be hunted or fed to wild beasts.
 |-
@@ Line 1,762: / Line 1,766: @@
 |}
-<div align="center">
+{{alphabetical TOC|style=margin: 1em auto;}}
-{{alphabetical TOC}}
-</div>
 ==O==
@@ Line 1,779: / Line 1,781: @@
 |
 *number
-| How easy the creature is to [[smell]]. The higher the number, the easier the creature can be smelt. Zero is odorless, default is 50.
+| 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).
 |-
@@ Line 1,800: / Line 1,802: @@
 *MALE/FEMALE
 *disinterested chance
-*lover-possible chance
+*casual chance
-*commitment-possible 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 become lovers but not marry, the third decides if the creature will marry this sex. The values themselves are simply ratios and do not need to add up to any particular value.
+| 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}}{{version|0.42.01}}
+| {{text anchor|OUTSIDER_CONTROLLABLE}}
 | Caste
 |
@@ Line 1,812: / Line 1,814: @@
 |}
-<div align="center">
+{{alphabetical TOC|style=margin: 1em auto;}}
-{{alphabetical TOC}}
-</div>
 ==P==
@@ Line 1,828: / Line 1,828: @@
 | Caste
 |
-| Allows the creature to be used as a pack animal. Currently only used by [[trading|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}}.
+Creatures with this tag but without {{token|BENIGN|c}}, and/or with {{token|LARGE_PREDATOR|c}} leads to hauled items being dropped.
 |-
@@ Line 1,841: / Line 1,843: @@
 |
 | 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,853: / Line 1,862: @@
 |
 *value
-| Controls the ability of [[vermin]] to find a way into containers when they are eating food from your stockpiles. The value for vermin in the game's current version ranges from 1-3. A higher value is better at penetrating containers.
+| 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,943: / Line 1,954: @@
 | Caste
 |
-*number
+*number (max 100000)
-| Weighted population of caste; Lower is rarer. Not to be confused with {{token|FREQUENCY|c}}.
+| 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.
 |-
@@ Line 1,958: / Line 1,969: @@
 | Caste
 |
-| Allows the being to represent itself as a deity, allowing it to become the leader of a civilized group. Used by unique demons in the vanilla game. Requires {{token|CAN_SPEAK|c}} to actually do anything more than settle at a location (e.g. write books, lead armies, profane temples). Doesn't appear to do anything for creatures that are already civilized. Once the creature ascends to a position of leadership, it will proceed to act as a standard ruler for their entity and fulfill the same functions (hold tournaments, tame creatures, etc).
+| 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.).
 |-
@@ Line 1,966: / Line 1,977: @@
 *string
 | Sets what other creatures [[Preferences|prefer]] about this creature. "Urist likes dwarves for their beards." Multiple entries will be chosen from at random. Creatures lacking a PREFSTRING token will never appear under another's preferences.
+|-
+| {{text anchor|PROCEDURAL_CREATURE_GRAPHICS}}
+| Creature
+|
+* [[Graphics_token#Basic_creature_sprite_types|Sprite type]] or Caste then sprite type
+| Makes the creature have procedural graphics built for it, like forgotten beasts/demons/titans/experiments. Must be associated with PCG_LAYERING tokens.
 |-
@@ Line 1,992: / Line 2,010: @@
 |}
-<div align="center">
+{{alphabetical TOC|style=margin: 1em auto;}}
-{{alphabetical TOC}}
-</div>
 ==R==
@@ Line 2,063: / Line 2,079: @@
 *Second person cancel retract text
 *Third person cancel retract text
-| The creature will retract into a body part when threatened. It will be unable to move or attack, but enemies will only be able to attack the specified body part. (eg. Turtle, Hedgehog)
+| 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{{bug|11463}}{{bug|10519}}.
+Undead curled up creatures are buggy, specifically those that retract into their upper bodies: [[echidna]]s, [[hedgehog]]s and [[pangolin]]s.{{bug|11463}}{{bug|10519}} The upper body is prevented from collapsing by a separate body part (the middle spine), which cannot be attacked when the creature is retracted. See {{token|PREVENTS_PARENT_COLLAPSE|bo}}. Living creatures eventually succumb to blood loss, but undead creatures do not. Giant creatures also take a very long time to bleed out.
 |-
 | {{text anchor|RETURNS_VERMIN_KILLS_TO_OWNER}}
 |
 |
-| Cat behavior. If it kills a vermin creature and has an owner, it carries the remains in its mouth and drops them at their feet. Requires {{token|HUNTS_VERMIN|c}}, 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 2,090: / Line 2,106: @@
 |}
-<div align="center">
+{{alphabetical TOC|style=margin: 1em auto;}}
-{{alphabetical TOC}}
-</div>
 ==S==
@@ Line 2,146: / Line 2,160: @@
 *<[[material token]]>
 | Selects a locally defined material. Can be ALL.
+|-
+| {{text anchor|SELECT_TISSUE}}
+| Creature
+|
+*tissue token
+| Selects a tissue for editing.
 |-
@@ Line 2,169: / Line 2,190: @@
 *category, type, or token
 | Begins a selection of body parts.
-|-
-| {{text anchor|SET_TL_GROUP}}
-| Caste
-|
-*TISSUE
-*BY_CATEGORY, BY_TYPE, BY_TOKEN
-*Location - category, type, or token
-*tissue
-| Begins a selection of tissue layers
-|-
-| {{text anchor|SHEARABLE_TISSUE_LAYER}}
-| Caste
-|
-* tissue modifier
-* required value
-| Tissue layer can be sheared for its component material. The specified modifier must be at least of the desired value for shearing to be possible (for example, a [[llama]]'s wool must have a LENGTH of 300 before it is shearable).
 |-
@@ Line 2,243: / Line 2,246: @@
 *value
 | The rate at which all skills decay. Lower values cause the skills to decay faster. Requires {{token|CAN_LEARN|c}} or {{token|INTELLIGENT|c}} to function.
+|-
+| {{text anchor|SLAIN_CASTE_SPEECH}}
+| Caste
+|
+*[[Speech file|text set]]
+| Caste-specific {{token|SLAIN_SPEECH|c}}.
+|-
+| {{text anchor|SLAIN_SPEECH}}
+| Creature
+|
+*[[Speech file|text set]]
+| Boasting speeches relating to killing this creature. Examples include [[text_dwarf.txt/raw|text_dwarf.txt]] (<code>[SLAIN_SPEECH:SLAIN_DWARF]</code>) and text_elf.txt (<code>[SLAIN_SPEECH:SLAIN_ELF]</code>) in data\vanilla\vanilla_creatures\objects.
 |-
@@ Line 2,261: / Line 2,278: @@
 |
 *value
-| Determines how keen a creature's sense of smell is. Lower is better. At 10000, a creature cannot smell at all.
+| Determines how keen a creature's sense of smell is - lower is better. At 10000, a creature cannot smell at all.
 |-
@@ Line 2,286: / Line 2,303: @@
 * Out of sight reads "You hear '''a loud bark'''"
 with the text in bold being the description arguments of the token.
+|-
+| {{text anchor|SOURCE_HFID}}
+| Creature
+|
+*Integer
+| Found on generated [[angel]]s. This is the historical figure ID of the deity with which the angel is associated. Since HFIDs are not predictable before worldgen, this isn't terribly usable in mods.
 |-
@@ Line 2,294: / Line 2,318: @@
 * Plant/creature ID
 | Creature will only appear in biomes with this plant or creature available. Grazers given a specific type of grass (such as [[panda]]s and [[bamboo]]) will only eat that grass and nothing else, risking starvation if there's none available.
-|-
-| {{text anchor|SPEECH}}
-| Creature
-|
-*speech file
-| Boasting speeches relating to killing this creature. Examples include dwarf.txt and elf.txt in data\speech.
-|-
-| {{text anchor|SPEECH_FEMALE}}
-| Creature
-|
-*speech file
-| Boasting speeches relating to killing females of this creature.
-|-
-| {{text anchor|SPEECH_MALE}}
-| Creature
-|
-*speech file
-| Boasting speeches relating to killing males of this creature.
 |-
@@ Line 2,336: / Line 2,339: @@
 |-
-| {{text anchor|SPREAD_EVIL_SPHERES_IF_RULER}}{{version|0.47.01}}
+| {{text anchor|SPREAD_EVIL_SPHERES_IF_RULER}}
 | Caste
 |
@@ Line 2,354: / Line 2,357: @@
 |-
-| {{text anchor|STRANGE_MOODS}}{{version|0.42.01}}
+| {{text anchor|STRANGE_MOODS}}
 | Caste
 |
@@ Line 2,363: / Line 2,366: @@
 | Caste
 |
-| Gives the creature knowledge of any secrets with <code>[[Interaction_token#IS_SECRET|[SUPERNATURAL_LEARNING_POSSIBLE]]]</code> that match its [[Creature_token#SPHERE|spheres]]. Also prevents it from becoming a [[vampire]] or a [[werebeast]]. 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,378: / Line 2,381: @@
 |-
-| {{text anchor|SYNDROME_DILUTION_FACTOR}}{{version|0.42.01}}
+| {{text anchor|SYNDROME_DILUTION_FACTOR}}
 | Caste
 | <[[Syndrome#SYN_IDENTIFIER|syndrome identifier]]>:<percentage>
@@ Line 2,384: / Line 2,387: @@
 |}
-<div align="center">
+{{alphabetical TOC|style=margin: 1em auto;}}
-{{alphabetical TOC}}
-</div>
 ==T==
@@ Line 2,415: / Line 2,416: @@
 |
 *name
-| Begins defining a tissue in the creature file.
+| Begins defining a tissue in the creature file. Follow this with standard tissue definition tokens to define the tissue properties.
+|-
+| {{text anchor|TISSUE_LAYER}}
+| Caste
+|
+*BY_TYPE, BY_CATEGORY, BY_TOKEN
+*TYPE,CATEGORY, or TOKEN
+*TISSUE
+*LOCATION
+| Adds the tissue layer to wherever it is required.
+Non-argument Locations can be FRONT, RIGHT, LEFT, TOP, BOTTOM. Argument locations are AROUND and CLEANS, requiring a further body part and a % of coverage/cleansing
 |-
-| {{text anchor|TITAN}}
+| {{text anchor|TISSUE_LAYER_OVER}}
 | Caste
 |
-| Found on [[titan]]s. Cannot be specified in user-defined raws.
+*BY_TYPE, BY_CATEGORY, BY_TOKEN
+*TYPE,CATEGORY, or TOKEN
+*TISSUE
+*LOCATION
+| Alias for TISSUE_LAYER
 |-
-| {{text anchor|TL_COLOR_MODIFIER}}
+| {{text anchor|TISSUE_LAYER_UNDER}}
 | Caste
 |
-*COLOR
+*BY_TYPE, BY_CATEGORY, BY_TOKEN
-*freq
+*TYPE,CATEGORY, or TOKEN
-*COLOR
+*TISSUE
-*freq etc.
+| Adds the tissue layer under a given part.
-| Creates a list of colors/color patterns, giving each a relative frequency. If the given color or pattern does not exist, the tissue is described as being "transparent".
+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_GENETIC_MODEL}}
+| {{text anchor|TITAN}}
 | Caste
 |
-| The way the color modifier is passed on to offspring. May or may not work right now.{{verify}}
+| Found on [[titan]]s. Cannot be specified in user-defined raws.
 |-
-| {{text anchor|TLCM_IMPORTANCE}}
+| {{text anchor|TRADE_CAPACITY}}
 | Caste
 |
 *number
-| Presumably modifies the importance of the tissue layer color modifier, for description purposes.
+| 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.
-HOWEVER using this appears to remove all mention of colour from creature descriptions. It does not appear in any default creatures.
 |-
-| {{text anchor|TLCM_NOUN}}
+| {{text anchor|TRAINABLE}}
 | Caste
 |
-*name
+| Shortcut for {{token|TRAINABLE_HUNTING|c}} + {{token|TRAINABLE_WAR|c}}.
-*SINGULAR or PLURAL
-| Names the tissue layer color modifier, and determines the noun. Also used by [[Utility:Stonesense|Stonesense]] for colouring body parts.
 |-
-| {{text anchor|TLCM_TIMING}}
+| {{text anchor|TRAINABLE_HUNTING}}
 | Caste
 |
-*ROOT
+| Can be [[Animal trainer|trained]] as a hunting beast, increasing speed.
-*start change window years
-*days
-*end change window years
-*days
-| Determines the point in the creature's life when the color change begins and ends.
-|-
-| {{text anchor|TRADE_CAPACITY}}
-| Caste
-|
-*number
-| How much the creature can carry when used by merchants.
-|-
-| {{text anchor|TRAINABLE}}
-| Caste
-|
-| Shortcut for {{token|TRAINABLE_HUNTING|c}} + {{token|TRAINABLE_WAR|c}}.
-|-
-| {{text anchor|TRAINABLE_HUNTING}}
-| Caste
-|
-| Can be [[Animal trainer|trained]] as a hunting beast, increasing speed.
 |-
 | {{text anchor|TRAINABLE_WAR}}
@@ Line 2,520: / Line 2,510: @@
 |}
-<div align="center">
+{{alphabetical TOC|style=margin: 1em auto;}}
-{{alphabetical TOC}}
-</div>
 ==U==
@@ Line 2,536: / Line 2,524: @@
 | Creature
 |
-| Creature will occur in every region with the correct biome. Does not apply to {{token|EVIL|c}}/{{token|GOOD|c}} 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,544: / Line 2,532: @@
 *mindepth
 *maxdepth
-| Depth that the creature appears underground. Numbers can be from 0 to 5. 0 is actually 'above ground' and can be used if the creature is to appear both above and below ground. Values from 1 to 3 are the respective [[cavern]] levels, 4 is the [[magma sea]] and 5 is the [[HFS]]. A single argument may be used instead of min and max. [[Demon]]s use only 5:5; user-defined creatures with both this depth and {{token|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 are 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,556: / Line 2,544: @@
 | Caste
 |
-| Found on generated [[demon]]s; causes the game to create a single named instance of the demon which will emerge from the underworld and take over civilizations during worldgen. Could not be specified in user-defined raws prior to version [[Release_information/0.47.01|0.47.01]].
+| 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,565: / Line 2,553: @@
 *old caste token
 | Defines a new caste derived directly from a previous caste. The new caste inherits all properties of the old one. The effect of this tag is automatic if one has not yet defined any castes: "Any caste-level tag that occurs before castes are explicitly declared is saved up and placed on any caste that is declared later, unless the caste is explicitly derived from another caste."
+Roostre: "When DF detects duplicate tokens in the raws of the same object, a failsafe seems to kick in; it takes the bottom-most of the duplicates, and disregards the others. In the case of tokens added by a mod, it prioritizes the duplicate in the mod." This means that if a tag is defined in the base-caste and redefined in the derived caste, the derived tag overwrites the base tag.
 |-
@@ Line 2,580: / Line 2,569: @@
 *new material token
 *material template
-| Defines a new local creature material and populates it with all properties defined in the specified template.
+| Defines a new local creature material and populates it with all properties defined in the specified template. [http://www.bay12forums.com/smf/index.php?topic=175437.msg8441368#msg8441368 There seems to be a limit of 200 materials per creature].
 |-
@@ Line 2,600: / Line 2,589: @@
 |-
 | {{text anchor|UTTERANCES}}
-| Caste
+| Creature
 |
 | Changes the language of the creature into unintelligible 'kobold-speak', which creatures of other species will be unable to understand. If a civilized creature has this and is not part of a {{token|SKULKING|e}} civ, it will tend to start wars with all nearby civilizations and will be unable to make peace treaties due to 'inability to communicate'.
 |}
-<div align="center">
+{{alphabetical TOC|style=margin: 1em auto;}}
-{{alphabetical TOC}}
-</div>
 ==V==
@@ Line 2,621: / Line 2,608: @@
 | Caste
 |
-| The creature is made of swampstuff. Doesn't appear to do anything in particular. Used by [[grimeling]]s in the vanilla game.
+| Like {{token|AT_PEACE_WITH_WILDLIFE}}, but also makes the creature more valued in artwork by civilisations with the PLANT [[sphere]]. [http://www.bay12forums.com/smf/index.php?topic=169696.msg8316954#msg8316954] Used by [[grimeling]]s in the vanilla game.
 |-
@@ Line 2,724: / Line 2,711: @@
 *binocular vision arc
 *non-binocular vision arc
-| The width of the creature's vision arcs, in degrees (i.e. 0 to 360). The first number is binocular vision, the second is non-binocular vision.  Binocular vision has a minimum of about 10 degrees, monocular, a maximum of about 350 degrees. Values past these limits will be accepted, but will default to ~10 degrees and ~350 degrees respectively.
+| The width of the creature's vision arcs, in degrees (i.e. 0 to 360). The first number is binocular vision, the second is non-binocular vision.  Binocular vision has a minimum of about 10 degrees, monocular, a maximum of about 350 degrees. Values past these limits will be accepted, but will default to ~10 degrees and ~350 degrees respectively. Defaults are 60:120.
 |}
-<div align="center">
+{{alphabetical TOC|style=margin: 1em auto;}}
-{{alphabetical TOC}}
-</div>
 ==W==
@@ Line 2,760: / Line 2,745: @@
 ==Attack Tokens==
+Attacks can use four different part selection criteria; while all vanilla attacks use only BODYPART (e.g. ATTACK:PUNCH:BODYPART:BY_TYPE:GRASP), there are other options available.
 {| {{prettytable}}
 |- bgcolor="#ddd"
-! width="20%" | Token
+! width="20%" | Part type token
-! width="10%" | Type
+! width="30%" | Arguments
-! width="20%" | Arguments
+! width="60%" | Description
-! width="50%" | Description
 |-
-| {{text anchor|ATTACK_SKILL}}
+| {{text anchor|BODYPART}}
-| Caste
 |
-*[[Skill token]]
+* BY_TYPE/BY_TOKEN/BY_CATEGORY
-| Defines the skill used by the attack.
+* type/token/category
+| This attack uses a particular body part; for example, BY_TYPE:GRASP will make it use any part that can hold onto an object.
+|-
+| {{text anchor|TISSUE_LAYER}}
+|
+* BY_TYPE/BY_TOKEN/BY_CATEGORY
+* type/token/category
+* tissue layer
+| This attack uses a specific tissue layer on a specific body part; BY_TYPE:GRASP:BONE will make it use the bone of the hands.
+|-
+| {{text anchor|CHILD_BODYPART_GROUP}}
+|
+* BY_TYPE/BY_TOKEN/BY_CATEGORY
+* type/token/category
+* BY_TYPE/BY_TOKEN/BY_CATEGORY
+* type/token/category
+| Uses a body part that is subordinate to another; BY_CATEGORY:ARM_LOWER:BY_TYPE:GRASP will make it use every hand attached to each lower arm (so it will generate one attack per lower arm, each of which will use every hand on that arm, assuming there are multiple hands per arm).
+|-
+| {{text anchor|CHILD_TISSUE_LAYER_GROUP}}
+|
+* BY_TYPE/BY_TOKEN/BY_CATEGORY
+* type/token/category
+* BY_TYPE/BY_TOKEN/BY_CATEGORY
+* type/token/category
+* tissue layer
+| As CHILD_BODYPART_GROUP, but specifying a tissue, too.
+|}
+{| {{prettytable}}
+|- bgcolor="#ddd"
+! width="20%" | Token
+! width="10%" | Type
+! width="20%" | Arguments
+! width="50%" | Description
+|-
+| {{text anchor|ATTACK_SKILL}}
+| Caste
+|
+*[[Skill token]]
+| Defines the skill used by the attack.
 |-
@@ Line 2,874: / Line 2,904: @@
 |}
-==Important Related Tokens==
+==Tissue Layer Tokens==
-These next groups of tokens include several tokens that are not technically classified as creature tokens in the string dump, but bear mentioning in this list, as they are used frequently in creature raws. (Some regular creature tokens may also be reprinted for the sake of ease of navigation)
+Tissue layers are added to a creature's body parts by the creature tokens [[#TISSUE_LAYER|TISSUE_LAYER]], [[#TISSUE_LAYER_OVER|TISSUE_LAYER_OVER]], [[#TISSUE_LAYER_UNDER|TISSUE_LAYER_UNDER]], and the body detail plan token [[#TL_LAYERS|TL_LAYERS]].
-===Tissue Modification===
+These tissue layers are not the same thing as tissues, which are defined at creature level, but rather applications of the tissues. If the SKIN tissue of a creature is the more general and abstract notion of what skin is for that creature, then a tissue layer may be the "actual" skin on the creature's nose, head, or second toe. As most creatures have more than one body part, tissue layers are normally selected en masse.
-This next group of tokens deals setting and modifying properties of previously defined tissues. (See also [[Tissue definition token]])
+Some tissue layer tokens are analogous to tissue definition tokens, e.g. [[#TL_CONNECTS|TL_CONNECTS]] to [[tissue_definition_token#CONNECTS|CONNECTS]].
 {| {{prettytable}}
@@ Line 2,887: / Line 2,917: @@
 ! width="20%" | Arguments
 ! width="50%" | Description
+|-
+| {{text anchor|SELECT_TISSUE_LAYER}}
+| Caste
+|
+*TISSUE
+*BY_CATEGORY, BY_TYPE, BY_TOKEN
+*Location - category, type, or token | Selects a tissue at a location
+* (optional) FRONT, BACK, LEFT, RIGHT, TOP, BOTTOM, AROUND.
+| Begins a selection of tissue layers.
+[SELECT_TISSUE_LAYER:HEART:BY_TYPE:HEART]
 |-
@@ Line 2,895: / Line 2,936: @@
 *BY_CATEGORY, BY_TYPE, BY_TOKEN
 *Location - category, type, or token
-| Adds a tissue to those selected
+| Adds tissue layers to those selected.
 |-
-| {{text anchor|PLUS_TL_GROUP}}
+| {{text anchor|SET_TL_GROUP}}
 | Caste
 |
@@ Line 2,905: / Line 2,946: @@
 *Location - category, type, or token
 *tissue
-| continues a selection of tissue layers
+| Begins a selection of tissue layers. Only usable for descriptor and cosmetic purposes.
-|-
+Research has implied it may be redundant with SELECT_TISSUE_LAYER, as the latter allows for cosmetics as well as "functional" tokens such as TL_MAJOR_ARTERIES. Vanilla raws still use SET_TL_GROUP though, for all cosmetic purposes. More research is needed on this subject.
-| {{text anchor|SELECT_TISSUE}}
-| Creature
-|
-*tissue token
-| Selects a tissue for editing.
 |-
-| {{text anchor|SELECT_TISSUE_LAYER}}
+| {{text anchor|PLUS_TL_GROUP}}
 | Caste
 |
-*TISSUE
 *BY_CATEGORY, BY_TYPE, BY_TOKEN
-*Location - category, type, or token | Selects a tissue at a location
+*Location - category, type, or token
-* (optional) FRONT, BACK, LEFT, RIGHT, TOP, BOTTOM, AROUND.
+*tissue
-| Selects a tissue layer for descriptor and cosmetic purposes.
+| Adds tissue layers to those selected. Like SET_TL_GROUP, it may be redundant even if used in the vanilla raws.
-[SELECT_TISSUE_LAYER:SKIN:BY_TYPE:UPPERBODY]
 |-
@@ Line 2,933: / Line 2,967: @@
 |-
-| {{text anchor|TISSUE_LAYER}}
+| {{text anchor|SHEARABLE_TISSUE_LAYER}}
-| Caste
-|
-*BY_TYPE, BY_CATEGORY, BY_TOKEN
-*TYPE,CATEGORY, or TOKEN
-*TISSUE
-*LOCATION
-| Adds the tissue layer to wherever it is required.
-Non-argument Locations can be FRONT, RIGHT, LEFT, TOP, BOTTOM. Argument locations are AROUND and CLEANS, requiring a further body part and a % of coverage/cleansing
-|-
-| {{text anchor|TISSUE_LAYER_OVER}}
 | Caste
 |
-*BY_TYPE, BY_CATEGORY, BY_TOKEN
+* tissue modifier
-*TYPE,CATEGORY, or TOKEN
+* required value
-*TISSUE
+| Tissue layer can be sheared for its component material. The specified modifier must be at least of the desired value for shearing to be possible (for example, a [[llama]]'s wool must have a LENGTH of 300 before it is shearable).
-*LOCATION
-| Presumably a counterpart to TISSUE_LAYER_UNDER (see below).
 |-
-| {{text anchor|TISSUE_LAYER_UNDER}}
+| {{text anchor|TISSUE_LAYER_APPEARANCE_MODIFIER}}
 | Caste
 |
-*BY_TYPE, BY_CATEGORY, BY_TOKEN
+*QUALITY
-*TYPE,CATEGORY, or TOKEN
-*TISSUE
-| Adds the tissue layer under a given part.
-For example an Iron Man has a gaseous poison within and this tissue (GAS is its name) has the token [TISSUE_LEAKS] and its state is GAS so when you puncture the iron outside and damage this tissue it leaks gas (can have a syndrome by using a previous one in the creature sample.) [TISSUE_LAYER_UNDER:BY_CATEGORY:ALL:{tissue}] {tissue} is what will be under the TISSUE_LAYER here is an example Tissue from Iron Man:<br>
-[TISSUE:GAS] [TISSUE_NAME:gas:NP] [TISSUE_MATERIAL:LOCAL_CREATURE_MAT:GAS] [TISSUE_MAT_STATE:GAS] [RELATIVE_THICKNESS:50] [TISSUE_LEAKS] [TISSUE_SHAPE:LAYER]
-|-
-| {{text anchor|TISSUE_LAYER_APPEARANCE_MODIFIER}}
-| Caste
-|
-*QUALITY
 *lowest
 *lower
@@ Line 2,984: / Line 2,995: @@
 *shaping
 | Sets tissue layer to be the target of TISSUE_STYLE token specified for an entity, works only on entity members. Mostly used with tissues HAIR, BEARD, MOUSTACHE, SIDEBURNS.
+|-
+| {{text anchor|TL_COLOR_MODIFIER}}
+| Caste
+|
+*COLOR
+*freq
+*COLOR
+*freq etc.
+| Creates a list of colors/color patterns, giving each a relative frequency. If the given color or pattern does not exist, the tissue is described as being "transparent".
+|-
+| {{text anchor|TLCM_GENETIC_MODEL}}
+| Caste
+|
+| The way the color modifier is passed on to offspring. May or may not work right now.{{verify}}
+|-
+| {{text anchor|TLCM_IMPORTANCE}}
+| Caste
+|
+*number
+| Presumably modifies the importance of the tissue layer color modifier, for description purposes.
+HOWEVER using this appears to remove all mention of colour from creature descriptions. It does not appear in any default creatures.
+|-
+| {{text anchor|TLCM_NOUN}}
+| Caste
+|
+*name
+*SINGULAR or PLURAL
+| Names the tissue layer color modifier, and determines the noun. Also used by [[Utility:Stonesense|Stonesense]] for colouring body parts.
+|-
+| {{text anchor|TLCM_TIMING}}
+| Caste
+|
+*ROOT
+*start change window years
+*days
+*end change window years
+*days
+| Determines the point in the creature's life when the color change begins and ends.
 |-
@@ Line 3,033: / Line 3,087: @@
 *[[Syndrome]]
 *[[Tissue definition token]]
+*[[Creature examples]]
 {{Category|Modding}}
 {{Category|Tokens}}
 [[ru:Creature token]]