Dwarf Fortress Wiki - User contributions [en]

v0.31:Creature token

2011-02-20T19:43:35Z

SpitefulFox: LAYS_UNUSUAL_EGGS

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

Tentative at best in some cases.

__NOTOC__

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

==A==
{| {{prettytable}}
|- bgcolor="#ddd"
! width="20%" | Token
! width="20%" | Arguments
! width="60%" | Description
|-
| ALCOHOL_DEPENDENT
|
| Creature needs alcohol to get through the working day.

|-
| ALL_ACTIVE
|
| Sets if the creature is active in day, night, and twilight. Seems to be a separate value from DIURNAL/NOCTURNAL/CREPUSCULAR, rather than implying them.

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

|-
| AMBUSHPREDATOR
|
| Makes the creature start out hidden. Used by {{L|giant cave spider}}s. May make {{L|web}}s hidden too.

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

|-
| APP_MOD_DESC_RANGE
| ?
| ?

|-
| APP_MOD_GENETIC_MODEL
|
|

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

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

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

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

|-
| APPLY_CURRENT_CREATURE_VARIATION
|
| Applies loaded Creature Variation

|-
| AQUATIC
|
| Allows a creature to breathe underwater, but causes it to "drown" out of {{L| water}}.

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

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

|-
| ATTACK
|
*token
*bodypart
*selection criteria
*location
| Defines the attack name, and the body part used.
'''Example:'''<br />
[ATTACK:GORE:BODYPART:BY_CATEGORY:HORN]<br />
''GORE'' : name of the attack<br />
''BODYPART:BY_CATEGORY:HORN'' : the horn is used to attack (presuming the creature has one)

|-
| ATTACK_CONTACT_PERC
|
*% value
| amount of available tissue used in attack

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

|-
| ATTACK_FLAG_EDGE
|
| attack type

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

|-
| ATTACK_PENETRATION_PERC
|
*% value
| probably amount of material that makes contact when penetration is done

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

|-
| ATTACK_SKILL
|
*skill used ({{L|Skill tokens}})
| defines the attack skill used

|-
| ATTACK_TRIGGER
| pop:exported wealth:created wealth{{verify}}
| stages when a megabeast will attack a site

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

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

|}

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

==B==
{| {{prettytable}}
|- bgcolor="#ddd"
! width="20%" | Token
! width="20%" | Arguments
! width="60%" | Description
|-
| BABY
| integer
| age at which creature is considered a child. Default is zero. One can think of this as the duration of the baby stage.

|-
| BABYNAME
| singular:plural
| name at caste level

|-
| BEACH_FREQUENCY
|
| {{L|Whale}}s and {{L|Sea nettle jellyfish|jellyfish}} have this. Controls the beaching frequency of the creature.

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

|-
| BIOME
|
* biome token
| Select a {{L|Biome}} the creature may appear in.

|-
| BLOOD, PUS, OTHER MATERIAL state definition
|
*selection criteria. Often LOCAL_CREATURE_MAT, although other selection criteria may work too.
*selected material
*matter state (LIQUID, GAS, ALL_SOLID)
| Controls bleeding behaviour

|-
| BODY
| body parts
| Draws body parts from OBJECT:BODY files (such as body_default.txt)
'''Example:'''<br />
[BODY:BODY_WITH_HEAD_FLAG:HEART:GUTS:BRAIN:MOUTH] <br />
This is the body from a {{L|Purring maggot}}. It creates a body with head, a heart, some guts, a brain, and a mouth. Thats all a maggot needs.

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

|-
| BODY_DETAIL_PLAN
| PlanName, PlanName:type:type:type:etc
| loads a plan listed OBJECT:BODY_DETAIL_PLAN files, such as b_detail_plan_default.txt. Mass applies USE_MATERIAL_TEMPLATE, mass alters RELSIZE, alters body part positions, and will allow tissue layers to be defined. Tissue layers are defined in order of skin to bone here.
'''Example:'''<br />
[BODY_DETAIL_PLAN:VERTEBRATE_TISSUE_LAYERS:SKIN:FAT:MUSCLE:BONE:CARTILAGE] <br />
This creates the detailed body of a {{L|fox}}, the skin, fat, muscle, bones and cartilage out of the vertebrate tissues.<br />
A {{L|Purring maggot|maggot}} would only need:<br />
''[BODY_DETAIL_PLAN:EXOSKELETON_TISSUE_LAYERS:SKIN:FAT:MUSCLE]''

|-
| BODY_SIZE
| years:days:size
| sets up size at a given time. Size is roughly equal to the creature's average weight in grams.
'''Example:'''<br />
[BODY_SIZE:0:0:10000]<br />
[BODY_SIZE:1:168:50000]<br />
[BODY_SIZE:12:0:220000]<br />
This describes the size of a {{L|minotaur}}. His birth size would be 10000 (~10 kg). With 1 year and 168 days he would be 50000 tall (~50 kg). As an adult (with 12 years) he would weight roughly 220 kg

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

|-
| BONECARN
|
| Creature 'eats' bones. Eating bones makes their happiness go up, but can cause death (suffocation){{verify}}. Implies CARNIVORE.

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

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

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

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

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

|-
| CAN_SPEAK
|
| Can talk. Note that it is not necessary for a creature to gain social skills.

|-
| CANNOT_UNDEAD
|
| Cannot be turned into a zombie or skeletal undead

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

|-
| CARNIVORE
|
| Creature ''only'' eats meat

|-
| CASTE
|
*name
| defines a caste

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

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

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

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

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

|-
| CASTE_PROFESSION_NAME
|
*Profession
*singular
*plural
| alters the name of the given profession, caste-specific

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

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

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

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

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

|-
| CE_X
|
*SEV:<value> (severity, higher is worse)
*PROB:<value(1-100)> (probability)
*RESISTABLE (optional) allows resistance
*SIZE_DILUTES (optional) lessens effect based on size
Place effected:
*LOCALIZED (optional)
*VASCULAR_ONLY (optional)
*MUSCULAR_ONLY (optional)
*BP:(select BY_CATEGORY, BY_TYPE, or BY_TOKEN):category, type or token:tissues affected (specific or ALL) (optional)
Timeline:
*Start:effect start time
*Peak:effect peak time
*End:effect end time
| Specifies the way that a syndrome affects a creature -- more detail can be found on the [[Syndrome#Creature effect tokens|Syndromes page]]

|-
| CHANGE_BODY_SIZE_PERC
|
|

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

|-
| CHILD_BODYPART_GROUP
|
*master selection, BY_CATEGORY, BY_TYPE, BY_TOKEN.
*master location
*specific selection, BY_CATEGORY, BY_TYPE, BY_TOKEN.
*specific location
| selects all parts of a group to be used.

|-
| CHILDNAME
| singular:plural
| name at caste level

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

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

|-
| COLDDAM_POINT
| value
| The minimum temperature limit before the currently selected material will start receiving damage from freezing. Used mostly in material templates.

|-
| COLONY_EXTERNAL
|
| Caste hovers around colony.

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

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

|-
| CONVERTED_SPOUSE
|
| Found only at caste level. Creatures of this caste's species with the SPOUSE_CONVERTER and NIGHT_CREATURE_HUNTER tokens will kidnap SPOUSE_CONVERSION_TARGETs of an appropriate sex and convert them into castes with CONVERTED_SPOUSE.

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

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

|-
| CREATURE
| name
| begins defining a new creature with the specified name.

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

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

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

|-
| CREPUSCULAR
|
| Sets if the creature is active at twilight. This tag functions as a combination of the two tags VESPERTINE and MATUTINAL.

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

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

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

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

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

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

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

|-
| DEMON
|
| Typically found on genned [[demon]]s; sets the creature as a potential spawn for [[Hidden Fun Stuff]]

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

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

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

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

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

|-
| DRAGONFIREBREATH
|
| Creature breathes fire in a cone.
|}

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

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

|-
| EGG_MATERIAL
|
*LOCAL_CREATURE_MAT
*EGGSHELL/EGG_WHITE/EGG_YOLK
*state (solid, liquid, or gas)
| Egg material. Eggs will be made out of eggshell. Edibility is determined by tags on whites or yolk, but they otherwise do not exist.

|-
| EGG_SIZE
|
*size
| Size of creature's egg?

|-
| EQUIPMENT_WAGON
|
| Makes the creature into a large 3x3 creature responsible for carrying trade goods, pulled by two [WAGON_PULLER]s and driven by a merchant.

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

|-
| EVIL
|
| Determines whether creature can show up on "evil" maps

|-
| EXTRAVISION
|
| Creature can see regardless of whether it has working eyes.
|}

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

==F==
{| {{prettytable}}
|- bgcolor="#ddd"
! width="20%" | Token
! width="20%" | Arguments
! width="60%" | Description
|-
| FANCIFUL
|
| Makes every civilization know about the creature. The creature won't occur in regular material preference lists. The tag also adds some art value modifiers. Used for things like dragons and other legendary creatures.

|-
| FEATURE_ATTACK_GROUP
|
| Found on subterranean animalmen.

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

|-
| FIREBREATH
|
| The creature breathes fire projectiles (as opposed to DRAGONFIREBREATH, which is in a cone).

|-
| FIREIMMUNE
|
| As of version v0.28.181.40d, the FIREIMMUNE token had no effect on a creature's resistance to flame or heat. However, it did affect ability to swim in magma in adventure mode, as well as display of "You are caught in a pool of magma!" warning messages. It is unknown if these effects persist in DF 2010.

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

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

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

|-
| FLEEQUICK
|
| Determines how soon a creature flees in a losing battle.

|-
| FLIER
|
| Allows a creature to fly. Fortress Mode pathfinding only partially incorporates pathfinding - flying dwarves need a land path to exist between them and an area in order to access it, but as long as one such path exists, they do not need to use it, instead being able to fly over intervening obstacles.

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

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

==G==
{| {{prettytable}}
|- bgcolor="#ddd"
! width="20%" | Token
! width="20%" | Arguments
! width="60%" | Description
|-
| GENERAL_BABY_NAME
| singular:plural
| name at creature level

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

|-
| GENERATED
|
| Found on procedurally generated creatures like [[Forgotten beast]]s, (biome name) titans and [[Demon]]s.

|-
| GETS_INFECTIONS_FROM_ROT
|
| creature can be infected by rot

|-
| GETS_WOUND_INFECTIONS
|
| creature can get infections from wounds

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

|-
| GLOWTILE
| ascii character
| If present, the being glows in the dark (generally used for Adventure Mode). The tile is what replaces the being's current tile when it is obscured from your sight by darkness. The default setting for kobolds (a yellow quotation mark) provides a nice "glowing eyes" effect. The game is also hardcoded to automatically convert quotation mark GLOWTILES into apostrophes if the creature has lost one eye. This works at the generic creature level - for caste-specific glow tiles, use CASTE_GLOWTILE instead.

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

|-
| GO_TO_END
|
| uncertain use, definitely refers to Creature Variants template

|-
| GO_TO_START
|
| uncertain use, definitely refers to Creature Variants template

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

|-
| GRASSTRAMPLE
| value
| Determines the percentage chance of trampling and killing grass when a creature steps on it. Set [GRASSTRAMPLE:0] to make grass never trampled by the creature.

|-
| GRAVITATE_BODY_SIZE
|
| Creature Variants template command, alter body size.

|-
| GRAZER
|
*number
| Animals is a grazer. The higher the number, the less grass it needs.
|}

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

==H==
{| {{prettytable}}
|- bgcolor="#ddd"
! width="20%" | Token
! width="20%" | Arguments
! width="60%" | Description
|-
| HABIT
| type:probability
| Defines certain behaviors for the creature. The habit types are COLLECT_TROPHIES, COOK_PEOPLE, COOK_VERMIN, GRIND_VERMIN, COOK_BLOOD, GRIND_BONE_MEAL, EAT_BONE_PORRIDGE, USE_ANY_MELEE_WEAPON, and COLLECT_WEALTH. These may require the creature to have a lair to work properly.

|-
| HABIT_NUM
| number or TEST_ALL
| Unknown. All lists of HABITs are preceded by [HABIT_NUM:TEST_ALL]

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

|-
| HEATDAM_POINT
| value
| The maximum temperature limit before the currently selected material will start receiving damage from heat. Used mostly in material templates.

|-
| HIVE_PRODUCT
|
*number
*time
*item tokens
| What product is harvested from beekeeping.

|-
| HOMEOTHERM
|
| Default 'NONE'. The creature's normal body [[DF2010:Temperature |temperature]]
|}

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

==I==
{| {{prettytable}}
|- bgcolor="#ddd"
! width="20%" | Token
! width="20%" | Arguments
! width="60%" | Description
|-
| IF_EXISTS_SET_BOILING_POINT
| value
| The temperature at which the creature boils into gases.

|-
| IF_EXISTS_SET_MELTING_POINT
| value
| The temperature at which the creature will melt into goo.

|-
| IGNITE_POINT
| value
| The temperature at which the creature will burst into flames.

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

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

|-
| INSULATION
| value
| increases the insulation of a selected material (usually hair, feathers or skin)

|-
| INTELLIGENT
|
| Implies CAN_SPEAK and CAN_LEARN. CAN_LEARN probably means the creature gets skills and professions. Not recommended for uncivilized monsters.

|-
| ITEMCORPSE
|
* [[Item token]]
* subtype
NO_SUBTYPE
* matgloss token
* NO_RACEGLOSS
USE_RACEGLOSS USE_SHARPSTONE
| Determines if the creature leaves behind a non-standard corpse (i.e. wood, statue, bars, ash from ghost etc). The first parameter determines the item type; the second parameter is the subtype indicated in the raw file (such as WEAPON_WHIP); the third indicates the material type if the item type takes a specific material (e.g. ""IRON"" if the corpse type is ""STATUE""). USE_RACEGLOSS applies if the creature has a material glossary assigned by the ""HAS_RACEGLOSS:"" flag and will select necessary adjectives and material from that glossary.
As of 31_01, RACEGLOSS may no longer be in the game.{{verify}}

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

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

==L==
{| {{prettytable}}
|- bgcolor="#ddd"
! width="20%" | Token
! width="20%" | Arguments
! width="60%" | Description
|-
| LAIR
| type:probability
| Found on megabeasts, semimegabeasts, and night creatues. The creature will seek out sites of this type and take them as lairs. The lair types are SIMPLE_BURROW, SIMPLE_MOUND, SHRINE, and LABYRINTH.

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

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

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

|-
| LARGE_PREDATOR
|
| Will attack things that are smaller than it (like dwarves). Only one group of "large predators" will appear on any given map (possibly two groups on "savage" maps). In adventure mode, large predators will try to ambush and attack you (and your party will attack them back). Also, they can be mentioned in the intro paragraph when starting a fortress e.g. "ere the wolves get hungry."

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

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

|-
| LAYS_UNUSUAL_EGGS
| Item tokens
| Creature lays a particular item instead of regular eggs. As of v0.31.19, this tag only makes the game crash.

|-
| LIGAMENTS
|
*selection criteria. Often LOCAL_CREATURE_MAT, although other selection criteria may work too.
*selected material. Almost always SINEW of the creature's materials.
*healing rate
| defines the material and healing rate of ligaments.

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

|-
| LIKES_FIGHTING
|
| The creature will attack enemies rather than flee from them. This tag has the same effect on player-controlled creatures - included modded dwarves.

|-
| LISP
|
| Creature multiplies 'S' when talking. Ex: "My name isss Recisssiz."

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

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

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

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

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

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

|-
| MALE
|
| all male

|-
| MANNERISM_??
|
*occassionally body part
| Adds a possible mannerism to the creature's profile.
Refer to {{L|Creature Token Mannerisms|Mannerisms}}

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

|-
| MATERIAL_BREATH_ATTACK
|
*MATERIAL TYPE (TISSUE, INORGANIC)
*MATERIAL NAME
*MATERIAL STATE (TRAILING_DUST_FLOW, TRAILING_VAPOR_FLOW, TRAILING_GAS_FLOW, SOLID_GLOB, LIQUID_GLOB, UNDIRECTED_GAS, UNDIRECTED_VAPOR, UNDIRECTED_DUST)
| Creates an attack referencing a material, using a given type of breath attack.

|-
| MAXAGE
| min:max
| range of time in which death from old age may occur

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

|-
| MEGABEAST
|
| Appears on fortress territory in Fortress Mode occasionally. Implies SEMIMEGABEAST. Also can be worshipped

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

|-
| MENT_ATT_RANGE
|
*ATTRIBUTE
*lowest:lower:low:median:high:higher:highest | sets up a mental attribute's range of values. Max of 5000.

|-
| MENT_ATT_RATES
|
*ATTRIBUTE Token
*cost to improve
*unused counter rate
*rust counter rate
*demotion counter rate
| Attribute gain/decay rates. Defaults for are 500:2:3:2, except for RECUPERATION and DISEASE_RESISTANCE that don't have change rates. The last three slots may be replaced by NONE.

|-
| MILKABLE
|
*LOCAL_CREATURE_MAT:MILK:amount
| Allows the creature to be milked.

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

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

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

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

|-
| MULTIPLY_VALUE
|
*Multiplier
| multiplies value of materials

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

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

==N==
{| {{prettytable}}
|- bgcolor="#ddd"
! width="20%" | Token
! width="20%" | Arguments
! width="60%" | Description
|-
| NAME
| singular:plural:adjective
| The generic name for any creature of this type - will be used when distinctions between caste are unimportant. For names for specific castes, use CASTE_NAME instead.

|-
| NATURAL
|
| Animal is considered to be natural.

|-
| NATURAL_SKILL
| skill:value
| The creature possesses this skill at this level inherently. It begins with this skill at this level, and the skill may never rust below this level.

|-
| NIGHT_CREATURE_BOGEYMAN
|
| Found on bogeymen. Presumably makes the creature attack the player at night in hordes like bogeymen do.

|-
| NIGHT_CREATURE_HUNTER
|
| If this creature has SPOUSE_CONVERTER, it will actively attempt to seek out potential conversion targets, abduct them, and convert them. Night creatures will seek out one SPOUSE_CONVERSION_TARGET of the opposite sex, convert them, and then have children with them. NIGHT_CREATURE_HUNTERs without SPOUSE_CONVERTER will not be placed.

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

|-
| NO_DIZZINESS
|
| Creature cannot become dizzy

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

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

|-
| NO_FEVERS
|
| Creature cannot suffer fevers

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

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

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

|-
| NO_THOUGHT_CENTER_FOR_MOVEMENT
|
| Probably shorthand for movement being unaffected by damage in general.

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

|-
| NOBONES
|
| Creature has no bones.

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

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

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

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

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

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

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

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

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

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

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

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

|-
| NOSTUN
|
| Creature can't be stunned. Evidence suggests creatures with this tag never wake up from sleep in Fortress Mode.

|-
| NOT_BUTCHERABLE
|
| Cannot be butchered

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

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

==P==
{| {{prettytable}}
|- bgcolor="#ddd"
! width="20%" | Token
! width="20%" | Arguments
! width="60%" | Description
|-
| PACK_ANIMAL
|
| Allows the creature to be used as a pack animal. Currently only used by merchants.

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

|-
| PATTERNFLIER
|
|

|-
| PEARL
|
| Creature will generate pearls.

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

|-
| PERSONALITY
|
*ATTRIBUTE
*lowest:median:highest
| Determines the range and chance of personality traits. Standard is 0:50:100. See [[DF2010:Personality_trait|Personality traits]] for more info.

|-
| PET
|
| Allows the creature to be tamed.

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

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

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

|-
| PHYS_ATT_RANGE
|
*ATTRIBUTE
*lowest
*lower
*low
*median
*high
*higher
*highest
| sets up a physical attribute's range of values. Max of 5000.

|-
| PHYS_ATT_RATES
|
*ATTRIBUTE Token
*cost to improve
*unused counter rate
*rust counter rate
*demotion counter rate
| Attribute gain/decay rates. Defaults for are 500:2:3:2, except for RECUPERATION and DISEASE_RESISTANCE that don't have change rates. The last three slots may be replaced by NONE.

|-
| PLUS_BP_GROUP
|
*BY_TYPE, BY_CATEGORY, or BY_TOKEN
*body type, category, or token
| Adds a body part group to selected body part group.

|-
| PLUS_MATERIAL
|
*material
| Adds a material to selected materials.

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

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

|-
| POP_RATIO
|
| Weighted population of caste

|-
| POPULATION_NUMBER
| min:max
| The minimum/maximum numbers of how many of these creatures can show up on a map per year.

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

|-
| PREFSTRING
| string
| Sets what other creatures like about this creature. "Urist likes dwarves for their beards." Multiple entries will be chosen from at random

|-
| PROFESSION_NAME
|
*Profession
*singular
*plural
| The generic name for members of this profession, at the creature level. In order to give members of specific castes different names for professions, use CASTE_PROFESSION_NAME instead.
|}

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

==R==
{| {{prettytable}}
|- bgcolor="#ddd"
! width="20%" | Token
! width="20%" | Arguments
! width="60%" | Description
|-
| RELSIZE
|
*BY_CATEGORY, BY_TYPE, BY_TOKEN
*body category, type, or token
*Relsize
| Specifies a new relative size for a part than what is stated in the body plan. For example, Dwarves have larger livers.

|-
| REMAINS_COLOR
|
|

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

|-
| REMAINS_UNDETERMINED
|
|

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

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

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

==S==
{| {{prettytable}}
|- bgcolor="#ddd"
! width="20%" | Token
! width="20%" | Arguments
! width="60%" | Description
|-
| SAVAGE
|
| Allows creature to show up on (and limits it to) "savage" maps.

|-
| SECRETION
|
*MATERIAL REF (eg LOCAL_CREATURE_MAT
*Material name
*Material State
*location secreted from (by_type, by_category, by_token)
*body part
*tissue layer
| creates a secreted material on given tissue on a given part of the body."

|-
| SELECT_ADDITIONAL_CASTE
|
*caste name
| adds an additional previously defined caste to the selection

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

|-
| SELECT_MATERIAL
|
*MATERIAL NAME
| Selects the material. Can be ALL.

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

|-
| SELECT_TISSUE_LAYER
|
*TISSUE
*BY_CATEGORY, BY_TYPE, BY_TOKEN
*Location - category, type, or token | Selects a tissue at a location
* (optional) FRONT, BACK, LEFT, RIGHT, TOP, BOTTOM, AROUND.
| Selects a tissue layer for descriptor and cosmetic purposes.

|-
| SEMIMEGABEAST
|
| Appears as boss creature in quests. Makes history by rampaging around towns. Possibly inhabits non-mountain caves.

|-
| SET_BP_GROUP
|
*selection criteria BY_TYPE, BY_CATEGORY, BY_TOKEN
*category, type, or token
| selection token"

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

|-
| SHEARABLE_TISSUE_LAYER
| ?
| Can be sheared for wool?

|-
| SKILL_LEARN_RATE
| {{L|skill_token}}:percentage
| The rate at which this creature learns this skill.

|-
| SKILL_LEARN_RATES
| percentage
| The rate at which this creature learns all skills.

|-
| SKILL_RATE
| {{L|skill_token}}:percentage:value:value:value
| As SKILL_RATES for individual skills.

|-
| SKILL_RATES
|
*% of improvement points you get
*unused counter rate
*rust counter rate
*demotion counter rate
| Affects skill gain and decay. Lower numbers in the last three slots make decay occur faster ([SKILL_RATES:100:1:1:1] would cause rapid decay). The counter rates may also be replaced with NONE.
Default is [SKILL_RATES:100:8:8:16]. [SLOW_LEARNER] changes the 100 to a 50.

|-
| SKILL_RUST_RATE
| {{L|skill_token}}:value:value:value
| The rate at which this skill decays. Lower values cause the skill to decay faster.

|-
| SKILL_RUST_RATES
| {{L|skill_token}}:value:value:value
| The rate at which all skills decay. Lower values cause the skills to decay faster.

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

|-
| SMALL_REMAINS
|
| If a creature has this token, it'll leave a small corpse that only rots once, and without miasma.

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

|-
| SPEC_HEAT
| value
| Amount of energy required for the creature to heat up or cool down.

|-
| SPECIALATTACK_INJECT_EXTRACT
|
*material source, eg. LOCAL_CREATURE_MAT, INORGANIC
*MATERIAL eg.POISON,
*MATTERSTATE (ALL_SOLID, LIQUID, GAS)
*min:max
| attack type addition that injects a material into the victim.

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

|-
| SPEECH
| speech file
| Boasting speeches relating to killing this creature. Examples include dwarf.txt and elf.txt in the Speech folder in Data.u

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

|-
| SPHERE
|
*sphere name
| Sets what religious spheres the creature is aligned to, for purposes of being worshipped via the [POWER] token. Also affects the layout of hidden fun stuff, and the creature's name.

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

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

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

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

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

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

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

|-
| SYN_CONTACT
|
| syndrome can be contracted on contact.

|-
| SYN_IMMUNE_CREATURE
|
| creates an exception for the creature so that it not affected by the syndrome.

|-
| SYN_INHALED
|
| syndrome can be contracted by inhalation, eg. poison dust.

|-
| SYN_INJECTED
|
| syndrome can be contracted by injection, eg. snake bite.

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

|-
| SYNDROME
|
| begins definition of a syndrome for poison use
|}

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

==T==
{| {{prettytable}}
|- bgcolor="#ddd"
! width="20%" | Token
! width="20%" | Arguments
! width="60%" | Description
|-
| TENDONS
|
*selection criteria. Often LOCAL_CREATURE_MAT, although other selection criteria may work too.
*selected tissue
*healing rate
| Defines the material and healing rare of tendons.

|-
| THICKWEB
|
| The creature's webs can catch larger creatures. May imply [AMBUSHPREDATOR].

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

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

|-
| TISSUE_LAYER_UNDER
|
*BY_TYPE, BY_CATEGORY, BY_TOKEN
*TYPE,CATEGORY, or TOKEN
*TISSUE
*LOCATION
| Adds the tissue layer under a given part ex. is Iron Man he has a gaseous poison within him and this tissue (GAS is its name) has the token [TISSUE_LEAKS] and its state is GAS so when you puncture the iron outside and damage this tissue it leaks gas (can have a syndrome by using a previous one in the creature sample.) [TISSUE_LAYER_UNDER:BY_CATEGORY:ALL:{tissue}] {tissue} is what will be under the TISSUE_LAYER here is an example Tissue from Iron Man
[TISSUE:GAS]
[TISSUE_NAME:gas:NP]
[TISSUE_MATERIAL:LOCAL_CREATURE_MAT:GAS]
[TISSUE_MAT_STATE:GAS]
[RELATIVE_THICKNESS:50]
[TISSUE_LEAKS]
[TISSUE_SHAPE:LAYER]

|-
| TISSUE_LAYER_APPEARANCE_MODIFIER
|
*QUALITY
*lowest:lower:low:median:high:higher:highest
| sets the range of qualities, including LENGTH, DENSE, HIGH_POSITION, CURLY, GREASY, WRINKLY

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

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

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

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

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

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

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

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

|-
| TRAINABLE
|
| Implies both [TRAINABLE_HUNTING] and [TRAINABLE_WAR].

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

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

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

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

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

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

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

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

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

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

|-
| UNDERSWIM
|
| Creature swims under the water and can't be seen.{{verify}}

|-
| UNIQUE_DEMON
|
| Typically found on genned [[demon]]s; sets the creature as capable of "emerging from the underworld" and taking over during worldgen.

|-
| USE_CASTE
|
*caste token
|

|-
| USE_MATERIAL
|
*new material token
*old material id
| Uses a local creature mat to define a new material?{{verify}}

|-
| USE_MATERIAL_TEMPLATE
|
*new material token
*material template
| Loads a material, and gives it a shortname for later reference

|-
| USE_TISSUE
|
*new tissue token
*old tissue id
| Uses a local creature mat to define a new material?{{verify}}

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

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

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

==V==
{| {{prettytable}}
|- bgcolor="#ddd"
! width="20%" | Token
! width="20%" | Arguments
! width="60%" | Description
|-
| VEGETATION
|
| unknown

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

|-
| VERMIN_BITE
|
*amount
*verb (bitten, stung)
*LOCAL_CREATURE_MAT
*MATERIAL
| vermin bites, and injects something.

|-
| VERMIN_EATER
|
| Vermin can nibble food?{{verify}}

|-
| VERMIN_FISH
|
| Acts like a fish

|-
| VERMIN_GROUNDER
|
| The creature can be picked up if you stand over it. (Requires confirmation)
'I think this is a habitat flag like VERMIN_SOIL, VERMIN_CHASM, etc. It seems to appear on creatures that don't otherwise have one. – Peristarkawan 17:27, 24 May 2007 (EDT)'

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

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

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

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

|-
| VERMIN_NOTRAP
|
| The creature cannot be caught by trappers or animal traps. However, this may not work in all cases, as both dragonflies and fairies can be caught by trappers. This is possibly overridden by the VERMIN_GROUNDER token, allowing trappers set to Catch a Live Land Animal to pick up and thus trap the animal. (speculation by Flippantelf 04:45, 15 June 2009 (UTC))

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

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

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

|-
| VERMINHUNTER
|
| A creature with this tag will hunt down vermin and kill them. Sometimes they will eat the vermin, but most of the time they will bring it to their owner. This tag also makes impossible to assign an owner to the animal. The animal chooses it's own owner instead (like a cat). If assigned to a playable race, members of that race will ONLY be able to eat vermin.

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

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

==W==
{| {{prettytable}}
|- bgcolor="#ddd"
! width="20%" | Token
! width="20%" | Arguments
! width="60%" | Description
|-
| WAGON_PULLER
|
| Allows the creature to pull caravan wagons.

|-
| WEBBER
|
*LOCAL_CREATURE_MAT
*MATERIAL (eg SILK)
| allows the creature to web, and defines what the webs are made of.

|-
| WEBIMMUNE
|
| The creature will not get caught in webs.
|}

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

v0.31 Talk:Modding guide

2011-02-20T06:02:10Z

SpitefulFox:

==What can/cannot be modded==
I don't see any information in mechanism modding. So far I'm assuming that's because they are not(yet at least) moddable. I've looked through the raws pretty thoroughly, and searched the bay12 forum mod section. I do see the raw for editing the mechanism components, what i'd like to be able to do is define my own mechanisms etc. Am I just missing something obvious? --[[User:MadGreyOne|MadGreyOne]]
:Besides the contents of ~data\speech, only the things mentioned on this page (ie the contents of ~\raw) can be modified. Mechanical components/furniture/siege engines/the standard, non-custom workshops/ai routines/whatever else don't have any presence in the raws, and hence can't be modified. I considered making a list of things that modders can't change, but put it aside at the time. --[[User:3|3]] 04:37, 6 December 2010 (UTC)

== Modding Liquids ==
Does anyone know if you can mod water? all i want to do is drop the freezing temp a bit to stop ice from forming, but i can't find it anywhere in the raws. Thanks.
--[[User:Rogue ork|rogue ork]] 16:47, 20 february 2011

Water is hardcoded, so you can't mod it. --[[User:SpitefulFox|SpitefulFox]] 06:02, 20 February 2011 (UTC)

v0.31:Tool token

2011-02-20T04:45:40Z

SpitefulFox: Added new .19 token

{{quality|Exceptional|21:46, 21 November 2010 (UTC)}}{{av}}

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

|-
| ITEM_TOOL
|
*id
| Token used to refer to the tool. <font color="red">Required</font>.

|-
| NAME
|
*singular
*plural
| Name of the tool. <font color="red">Required</font>.

|-
| ADJECTIVE
|
*adjective
| Adjective preceding the material name (e.g. "large copper dagger")

|-
| SIZE
|
*size
| Volume of tool in mL or cm^3 cubed. <font color="red">Required</font>.

|-
| SKILL
|
*Skill token
| The skill to determine effectiveness in melee with this tool. <font color="red">Required</font>.

|-
| RANGED
|
*Skill token
*Ammo item token
| Makes this tool a ranged weapon that uses the specified ammo. The specified skill determines accuracy in ranged combat.

|-
| SHOOT_FORCE
|
*value
|

|-
| SHOOT_MAXVEL
|
*value
|

|-
| TWO_HANDED
|
*size
| Creatures under this size (in cm^3) must use the tool two-handed. <font color="red">Required</font>.

|-
| MINIMUM_SIZE
|
*size
| Minimum body size (in cm^3) to use the tool at all (multigrasp required until TWO_HANDED value) <font color="red">Required</font>.

|-
| MATERIAL_SIZE
|
*value
| Number of bar units needed for forging, as well as the amount gained from melting. <font color="red">Required</font>.

|-
| ATTACK
|
*attacktype:BLUNT or EDGE
*contact_area:value
*penetration_size:value
*verb2nd:string
*verb3rd:string
*noun:string
*velocity_multiplier:value
| You can have many ATTACK tags and one will be randomly selected for each attack, with EDGE attacks 100 times more common than BLUNT attacks. <font color="red">Required</font>.

|-
| HARD_MAT
|
| Permits the tool to be made from any "hard" material, such as stone.

|-
| METAL_MAT
|
| Permits the tool to be made from any metal.

|-
| METAL_WEAPON_MAT
|
| Permits the tool to be made from any weapons-grade metal.

|-
| VALUE
|
*num
| Defines the item value of the tool.

|-
| TILE
|
*num
| Defines the tile used to represent the tool.

|-
| TOOL_USE
|
*tool use, see below
| Defines the task performed using the tool.

|-
| WEIGHT
|
*num
| Unused.

|-
| CONTAINER_CAPACITY
|
*amount
| How much the item can contain?

|}

Valid tool uses (and the default tools used for these tasks) are as follows:
* LIQUID_COOKING (cauldron)
* LIQUID_SCOOP (ladle)
* GRIND_POWDER_RECEPTACLE (mortar)
* GRIND_POWDER_GRINDER (pestle)
* MEAT_CARVING (carving knife)
* MEAT_BONING (boning knife)
* MEAT_SLICING (slicing knife)
* MEAT_CLEAVING (meat cleaver)
* HOLD_MEAT_FOR_CARVING (carving fork)
* MEAL_CONTAINER (bowl)

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

v0.31:Creature token

2011-02-20T04:42:44Z

SpitefulFox: Added new .19 tokens

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

Tentative at best in some cases.

__NOTOC__

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

==A==
{| {{prettytable}}
|- bgcolor="#ddd"
! width="20%" | Token
! width="20%" | Arguments
! width="60%" | Description
|-
| ALCOHOL_DEPENDENT
|
| Creature needs alcohol to get through the working day.

|-
| ALL_ACTIVE
|
| Sets if the creature is active in day, night, and twilight. Seems to be a separate value from DIURNAL/NOCTURNAL/CREPUSCULAR, rather than implying them.

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

|-
| AMBUSHPREDATOR
|
| Makes the creature start out hidden. Used by {{L|giant cave spider}}s. May make {{L|web}}s hidden too.

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

|-
| APP_MOD_DESC_RANGE
| ?
| ?

|-
| APP_MOD_GENETIC_MODEL
|
|

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

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

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

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

|-
| APPLY_CURRENT_CREATURE_VARIATION
|
| Applies loaded Creature Variation

|-
| AQUATIC
|
| Allows a creature to breathe underwater, but causes it to "drown" out of {{L| water}}.

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

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

|-
| ATTACK
|
*token
*bodypart
*selection criteria
*location
| Defines the attack name, and the body part used.
'''Example:'''<br />
[ATTACK:GORE:BODYPART:BY_CATEGORY:HORN]<br />
''GORE'' : name of the attack<br />
''BODYPART:BY_CATEGORY:HORN'' : the horn is used to attack (presuming the creature has one)

|-
| ATTACK_CONTACT_PERC
|
*% value
| amount of available tissue used in attack

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

|-
| ATTACK_FLAG_EDGE
|
| attack type

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

|-
| ATTACK_PENETRATION_PERC
|
*% value
| probably amount of material that makes contact when penetration is done

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

|-
| ATTACK_SKILL
|
*skill used ({{L|Skill tokens}})
| defines the attack skill used

|-
| ATTACK_TRIGGER
| pop:exported wealth:created wealth{{verify}}
| stages when a megabeast will attack a site

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

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

|}

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

==B==
{| {{prettytable}}
|- bgcolor="#ddd"
! width="20%" | Token
! width="20%" | Arguments
! width="60%" | Description
|-
| BABY
| integer
| age at which creature is considered a child. Default is zero. One can think of this as the duration of the baby stage.

|-
| BABYNAME
| singular:plural
| name at caste level

|-
| BEACH_FREQUENCY
|
| {{L|Whale}}s and {{L|Sea nettle jellyfish|jellyfish}} have this. Controls the beaching frequency of the creature.

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

|-
| BIOME
|
* biome token
| Select a {{L|Biome}} the creature may appear in.

|-
| BLOOD, PUS, OTHER MATERIAL state definition
|
*selection criteria. Often LOCAL_CREATURE_MAT, although other selection criteria may work too.
*selected material
*matter state (LIQUID, GAS, ALL_SOLID)
| Controls bleeding behaviour

|-
| BODY
| body parts
| Draws body parts from OBJECT:BODY files (such as body_default.txt)
'''Example:'''<br />
[BODY:BODY_WITH_HEAD_FLAG:HEART:GUTS:BRAIN:MOUTH] <br />
This is the body from a {{L|Purring maggot}}. It creates a body with head, a heart, some guts, a brain, and a mouth. Thats all a maggot needs.

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

|-
| BODY_DETAIL_PLAN
| PlanName, PlanName:type:type:type:etc
| loads a plan listed OBJECT:BODY_DETAIL_PLAN files, such as b_detail_plan_default.txt. Mass applies USE_MATERIAL_TEMPLATE, mass alters RELSIZE, alters body part positions, and will allow tissue layers to be defined. Tissue layers are defined in order of skin to bone here.
'''Example:'''<br />
[BODY_DETAIL_PLAN:VERTEBRATE_TISSUE_LAYERS:SKIN:FAT:MUSCLE:BONE:CARTILAGE] <br />
This creates the detailed body of a {{L|fox}}, the skin, fat, muscle, bones and cartilage out of the vertebrate tissues.<br />
A {{L|Purring maggot|maggot}} would only need:<br />
''[BODY_DETAIL_PLAN:EXOSKELETON_TISSUE_LAYERS:SKIN:FAT:MUSCLE]''

|-
| BODY_SIZE
| years:days:size
| sets up size at a given time. Size is roughly equal to the creature's average weight in grams.
'''Example:'''<br />
[BODY_SIZE:0:0:10000]<br />
[BODY_SIZE:1:168:50000]<br />
[BODY_SIZE:12:0:220000]<br />
This describes the size of a {{L|minotaur}}. His birth size would be 10000 (~10 kg). With 1 year and 168 days he would be 50000 tall (~50 kg). As an adult (with 12 years) he would weight roughly 220 kg

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

|-
| BONECARN
|
| Creature 'eats' bones. Eating bones makes their happiness go up, but can cause death (suffocation){{verify}}. Implies CARNIVORE.

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

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

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

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

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

|-
| CAN_SPEAK
|
| Can talk. Note that it is not necessary for a creature to gain social skills.

|-
| CANNOT_UNDEAD
|
| Cannot be turned into a zombie or skeletal undead

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

|-
| CARNIVORE
|
| Creature ''only'' eats meat

|-
| CASTE
|
*name
| defines a caste

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

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

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

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

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

|-
| CASTE_PROFESSION_NAME
|
*Profession
*singular
*plural
| alters the name of the given profession, caste-specific

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

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

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

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

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

|-
| CE_X
|
*SEV:<value> (severity, higher is worse)
*PROB:<value(1-100)> (probability)
*RESISTABLE (optional) allows resistance
*SIZE_DILUTES (optional) lessens effect based on size
Place effected:
*LOCALIZED (optional)
*VASCULAR_ONLY (optional)
*MUSCULAR_ONLY (optional)
*BP:(select BY_CATEGORY, BY_TYPE, or BY_TOKEN):category, type or token:tissues affected (specific or ALL) (optional)
Timeline:
*Start:effect start time
*Peak:effect peak time
*End:effect end time
| Specifies the way that a syndrome affects a creature -- more detail can be found on the [[Syndrome#Creature effect tokens|Syndromes page]]

|-
| CHANGE_BODY_SIZE_PERC
|
|

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

|-
| CHILD_BODYPART_GROUP
|
*master selection, BY_CATEGORY, BY_TYPE, BY_TOKEN.
*master location
*specific selection, BY_CATEGORY, BY_TYPE, BY_TOKEN.
*specific location
| selects all parts of a group to be used.

|-
| CHILDNAME
| singular:plural
| name at caste level

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

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

|-
| COLDDAM_POINT
| value
| The minimum temperature limit before the currently selected material will start receiving damage from freezing. Used mostly in material templates.

|-
| COLONY_EXTERNAL
|
| Caste hovers around colony.

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

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

|-
| CONVERTED_SPOUSE
|
| Found only at caste level. Creatures of this caste's species with the SPOUSE_CONVERTER and NIGHT_CREATURE_HUNTER tokens will kidnap SPOUSE_CONVERSION_TARGETs of an appropriate sex and convert them into castes with CONVERTED_SPOUSE.

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

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

|-
| CREATURE
| name
| begins defining a new creature with the specified name.

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

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

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

|-
| CREPUSCULAR
|
| Sets if the creature is active at twilight. This tag functions as a combination of the two tags VESPERTINE and MATUTINAL.

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

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

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

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

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

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

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

|-
| DEMON
|
| Typically found on genned [[demon]]s; sets the creature as a potential spawn for [[Hidden Fun Stuff]]

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

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

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

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

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

|-
| DRAGONFIREBREATH
|
| Creature breathes fire in a cone.
|}

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

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

|-
| EGG_MATERIAL
|
*LOCAL_CREATURE_MAT
*EGGSHELL/EGG_WHITE/EGG_YOLK
*state (solid, liquid, or gas)
| Egg material. Eggs will be made out of eggshell. Edibility is determined by tags on whites or yolk, but they otherwise do not exist.

|-
| EGG_SIZE
|
*size
| Size of creature's egg?

|-
| EQUIPMENT_WAGON
|
| Makes the creature into a large 3x3 creature responsible for carrying trade goods, pulled by two [WAGON_PULLER]s and driven by a merchant.

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

|-
| EVIL
|
| Determines whether creature can show up on "evil" maps

|-
| EXTRAVISION
|
| Creature can see regardless of whether it has working eyes.
|}

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

==F==
{| {{prettytable}}
|- bgcolor="#ddd"
! width="20%" | Token
! width="20%" | Arguments
! width="60%" | Description
|-
| FANCIFUL
|
| Makes every civilization know about the creature. The creature won't occur in regular material preference lists. The tag also adds some art value modifiers. Used for things like dragons and other legendary creatures.

|-
| FEATURE_ATTACK_GROUP
|
| Found on subterranean animalmen.

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

|-
| FIREBREATH
|
| The creature breathes fire projectiles (as opposed to DRAGONFIREBREATH, which is in a cone).

|-
| FIREIMMUNE
|
| As of version v0.28.181.40d, the FIREIMMUNE token had no effect on a creature's resistance to flame or heat. However, it did affect ability to swim in magma in adventure mode, as well as display of "You are caught in a pool of magma!" warning messages. It is unknown if these effects persist in DF 2010.

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

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

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

|-
| FLEEQUICK
|
| Determines how soon a creature flees in a losing battle.

|-
| FLIER
|
| Allows a creature to fly. Fortress Mode pathfinding only partially incorporates pathfinding - flying dwarves need a land path to exist between them and an area in order to access it, but as long as one such path exists, they do not need to use it, instead being able to fly over intervening obstacles.

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

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

==G==
{| {{prettytable}}
|- bgcolor="#ddd"
! width="20%" | Token
! width="20%" | Arguments
! width="60%" | Description
|-
| GENERAL_BABY_NAME
| singular:plural
| name at creature level

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

|-
| GENERATED
|
| Found on procedurally generated creatures like [[Forgotten beast]]s, (biome name) titans and [[Demon]]s.

|-
| GETS_INFECTIONS_FROM_ROT
|
| creature can be infected by rot

|-
| GETS_WOUND_INFECTIONS
|
| creature can get infections from wounds

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

|-
| GLOWTILE
| ascii character
| If present, the being glows in the dark (generally used for Adventure Mode). The tile is what replaces the being's current tile when it is obscured from your sight by darkness. The default setting for kobolds (a yellow quotation mark) provides a nice "glowing eyes" effect. The game is also hardcoded to automatically convert quotation mark GLOWTILES into apostrophes if the creature has lost one eye. This works at the generic creature level - for caste-specific glow tiles, use CASTE_GLOWTILE instead.

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

|-
| GO_TO_END
|
| uncertain use, definitely refers to Creature Variants template

|-
| GO_TO_START
|
| uncertain use, definitely refers to Creature Variants template

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

|-
| GRASSTRAMPLE
| value
| Determines the percentage chance of trampling and killing grass when a creature steps on it. Set [GRASSTRAMPLE:0] to make grass never trampled by the creature.

|-
| GRAVITATE_BODY_SIZE
|
| Creature Variants template command, alter body size.

|-
| GRAZER
|
*number
| Animals is a grazer. The higher the number, the less grass it needs.
|}

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

==H==
{| {{prettytable}}
|- bgcolor="#ddd"
! width="20%" | Token
! width="20%" | Arguments
! width="60%" | Description
|-
| HABIT
| type:probability
| Defines certain behaviors for the creature. The habit types are COLLECT_TROPHIES, COOK_PEOPLE, COOK_VERMIN, GRIND_VERMIN, COOK_BLOOD, GRIND_BONE_MEAL, EAT_BONE_PORRIDGE, USE_ANY_MELEE_WEAPON, and COLLECT_WEALTH. These may require the creature to have a lair to work properly.

|-
| HABIT_NUM
| number or TEST_ALL
| Unknown. All lists of HABITs are preceded by [HABIT_NUM:TEST_ALL]

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

|-
| HEATDAM_POINT
| value
| The maximum temperature limit before the currently selected material will start receiving damage from heat. Used mostly in material templates.

|-
| HIVE_PRODUCT
|
*number
*time
*item tokens
| What product is harvested from beekeeping.

|-
| HOMEOTHERM
|
| Default 'NONE'. The creature's normal body [[DF2010:Temperature |temperature]]
|}

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

==I==
{| {{prettytable}}
|- bgcolor="#ddd"
! width="20%" | Token
! width="20%" | Arguments
! width="60%" | Description
|-
| IF_EXISTS_SET_BOILING_POINT
| value
| The temperature at which the creature boils into gases.

|-
| IF_EXISTS_SET_MELTING_POINT
| value
| The temperature at which the creature will melt into goo.

|-
| IGNITE_POINT
| value
| The temperature at which the creature will burst into flames.

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

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

|-
| INSULATION
| value
| increases the insulation of a selected material (usually hair, feathers or skin)

|-
| INTELLIGENT
|
| Implies CAN_SPEAK and CAN_LEARN. CAN_LEARN probably means the creature gets skills and professions. Not recommended for uncivilized monsters.

|-
| ITEMCORPSE
|
* [[Item token]]
* subtype
NO_SUBTYPE
* matgloss token
* NO_RACEGLOSS
USE_RACEGLOSS USE_SHARPSTONE
| Determines if the creature leaves behind a non-standard corpse (i.e. wood, statue, bars, ash from ghost etc). The first parameter determines the item type; the second parameter is the subtype indicated in the raw file (such as WEAPON_WHIP); the third indicates the material type if the item type takes a specific material (e.g. ""IRON"" if the corpse type is ""STATUE""). USE_RACEGLOSS applies if the creature has a material glossary assigned by the ""HAS_RACEGLOSS:"" flag and will select necessary adjectives and material from that glossary.
As of 31_01, RACEGLOSS may no longer be in the game.{{verify}}

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

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

==L==
{| {{prettytable}}
|- bgcolor="#ddd"
! width="20%" | Token
! width="20%" | Arguments
! width="60%" | Description
|-
| LAIR
| type:probability
| Found on megabeasts, semimegabeasts, and night creatues. The creature will seek out sites of this type and take them as lairs. The lair types are SIMPLE_BURROW, SIMPLE_MOUND, SHRINE, and LABYRINTH.

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

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

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

|-
| LARGE_PREDATOR
|
| Will attack things that are smaller than it (like dwarves). Only one group of "large predators" will appear on any given map (possibly two groups on "savage" maps). In adventure mode, large predators will try to ambush and attack you (and your party will attack them back). Also, they can be mentioned in the intro paragraph when starting a fortress e.g. "ere the wolves get hungry."

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

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

|-
| LIGAMENTS
|
*selection criteria. Often LOCAL_CREATURE_MAT, although other selection criteria may work too.
*selected material. Almost always SINEW of the creature's materials.
*healing rate
| defines the material and healing rate of ligaments.

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

|-
| LIKES_FIGHTING
|
| The creature will attack enemies rather than flee from them. This tag has the same effect on player-controlled creatures - included modded dwarves.

|-
| LISP
|
| Creature multiplies 'S' when talking. Ex: "My name isss Recisssiz."

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

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

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

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

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

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

|-
| MALE
|
| all male

|-
| MANNERISM_??
|
*occassionally body part
| Adds a possible mannerism to the creature's profile.
Refer to {{L|Creature Token Mannerisms|Mannerisms}}

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

|-
| MATERIAL_BREATH_ATTACK
|
*MATERIAL TYPE (TISSUE, INORGANIC)
*MATERIAL NAME
*MATERIAL STATE (TRAILING_DUST_FLOW, TRAILING_VAPOR_FLOW, TRAILING_GAS_FLOW, SOLID_GLOB, LIQUID_GLOB, UNDIRECTED_GAS, UNDIRECTED_VAPOR, UNDIRECTED_DUST)
| Creates an attack referencing a material, using a given type of breath attack.

|-
| MAXAGE
| min:max
| range of time in which death from old age may occur

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

|-
| MEGABEAST
|
| Appears on fortress territory in Fortress Mode occasionally. Implies SEMIMEGABEAST. Also can be worshipped

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

|-
| MENT_ATT_RANGE
|
*ATTRIBUTE
*lowest:lower:low:median:high:higher:highest | sets up a mental attribute's range of values. Max of 5000.

|-
| MENT_ATT_RATES
|
*ATTRIBUTE Token
*cost to improve
*unused counter rate
*rust counter rate
*demotion counter rate
| Attribute gain/decay rates. Defaults for are 500:2:3:2, except for RECUPERATION and DISEASE_RESISTANCE that don't have change rates. The last three slots may be replaced by NONE.

|-
| MILKABLE
|
*LOCAL_CREATURE_MAT:MILK:amount
| Allows the creature to be milked.

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

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

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

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

|-
| MULTIPLY_VALUE
|
*Multiplier
| multiplies value of materials

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

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

==N==
{| {{prettytable}}
|- bgcolor="#ddd"
! width="20%" | Token
! width="20%" | Arguments
! width="60%" | Description
|-
| NAME
| singular:plural:adjective
| The generic name for any creature of this type - will be used when distinctions between caste are unimportant. For names for specific castes, use CASTE_NAME instead.

|-
| NATURAL
|
| Animal is considered to be natural.

|-
| NATURAL_SKILL
| skill:value
| The creature possesses this skill at this level inherently. It begins with this skill at this level, and the skill may never rust below this level.

|-
| NIGHT_CREATURE_BOGEYMAN
|
| Found on bogeymen. Presumably makes the creature attack the player at night in hordes like bogeymen do.

|-
| NIGHT_CREATURE_HUNTER
|
| If this creature has SPOUSE_CONVERTER, it will actively attempt to seek out potential conversion targets, abduct them, and convert them. Night creatures will seek out one SPOUSE_CONVERSION_TARGET of the opposite sex, convert them, and then have children with them. NIGHT_CREATURE_HUNTERs without SPOUSE_CONVERTER will not be placed.

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

|-
| NO_DIZZINESS
|
| Creature cannot become dizzy

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

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

|-
| NO_FEVERS
|
| Creature cannot suffer fevers

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

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

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

|-
| NO_THOUGHT_CENTER_FOR_MOVEMENT
|
| Probably shorthand for movement being unaffected by damage in general.

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

|-
| NOBONES
|
| Creature has no bones.

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

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

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

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

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

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

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

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

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

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

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

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

|-
| NOSTUN
|
| Creature can't be stunned. Evidence suggests creatures with this tag never wake up from sleep in Fortress Mode.

|-
| NOT_BUTCHERABLE
|
| Cannot be butchered

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

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

==P==
{| {{prettytable}}
|- bgcolor="#ddd"
! width="20%" | Token
! width="20%" | Arguments
! width="60%" | Description
|-
| PACK_ANIMAL
|
| Allows the creature to be used as a pack animal. Currently only used by merchants.

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

|-
| PATTERNFLIER
|
|

|-
| PEARL
|
| Creature will generate pearls.

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

|-
| PERSONALITY
|
*ATTRIBUTE
*lowest:median:highest
| Determines the range and chance of personality traits. Standard is 0:50:100. See [[DF2010:Personality_trait|Personality traits]] for more info.

|-
| PET
|
| Allows the creature to be tamed.

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

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

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

|-
| PHYS_ATT_RANGE
|
*ATTRIBUTE
*lowest
*lower
*low
*median
*high
*higher
*highest
| sets up a physical attribute's range of values. Max of 5000.

|-
| PHYS_ATT_RATES
|
*ATTRIBUTE Token
*cost to improve
*unused counter rate
*rust counter rate
*demotion counter rate
| Attribute gain/decay rates. Defaults for are 500:2:3:2, except for RECUPERATION and DISEASE_RESISTANCE that don't have change rates. The last three slots may be replaced by NONE.

|-
| PLUS_BP_GROUP
|
*BY_TYPE, BY_CATEGORY, or BY_TOKEN
*body type, category, or token
| Adds a body part group to selected body part group.

|-
| PLUS_MATERIAL
|
*material
| Adds a material to selected materials.

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

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

|-
| POP_RATIO
|
| Weighted population of caste

|-
| POPULATION_NUMBER
| min:max
| The minimum/maximum numbers of how many of these creatures can show up on a map per year.

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

|-
| PREFSTRING
| string
| Sets what other creatures like about this creature. "Urist likes dwarves for their beards." Multiple entries will be chosen from at random

|-
| PROFESSION_NAME
|
*Profession
*singular
*plural
| The generic name for members of this profession, at the creature level. In order to give members of specific castes different names for professions, use CASTE_PROFESSION_NAME instead.
|}

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

==R==
{| {{prettytable}}
|- bgcolor="#ddd"
! width="20%" | Token
! width="20%" | Arguments
! width="60%" | Description
|-
| RELSIZE
|
*BY_CATEGORY, BY_TYPE, BY_TOKEN
*body category, type, or token
*Relsize
| Specifies a new relative size for a part than what is stated in the body plan. For example, Dwarves have larger livers.

|-
| REMAINS_COLOR
|
|

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

|-
| REMAINS_UNDETERMINED
|
|

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

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

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

==S==
{| {{prettytable}}
|- bgcolor="#ddd"
! width="20%" | Token
! width="20%" | Arguments
! width="60%" | Description
|-
| SAVAGE
|
| Allows creature to show up on (and limits it to) "savage" maps.

|-
| SECRETION
|
*MATERIAL REF (eg LOCAL_CREATURE_MAT
*Material name
*Material State
*location secreted from (by_type, by_category, by_token)
*body part
*tissue layer
| creates a secreted material on given tissue on a given part of the body."

|-
| SELECT_ADDITIONAL_CASTE
|
*caste name
| adds an additional previously defined caste to the selection

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

|-
| SELECT_MATERIAL
|
*MATERIAL NAME
| Selects the material. Can be ALL.

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

|-
| SELECT_TISSUE_LAYER
|
*TISSUE
*BY_CATEGORY, BY_TYPE, BY_TOKEN
*Location - category, type, or token | Selects a tissue at a location
* (optional) FRONT, BACK, LEFT, RIGHT, TOP, BOTTOM, AROUND.
| Selects a tissue layer for descriptor and cosmetic purposes.

|-
| SEMIMEGABEAST
|
| Appears as boss creature in quests. Makes history by rampaging around towns. Possibly inhabits non-mountain caves.

|-
| SET_BP_GROUP
|
*selection criteria BY_TYPE, BY_CATEGORY, BY_TOKEN
*category, type, or token
| selection token"

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

|-
| SHEARABLE_TISSUE_LAYER
| ?
| Can be sheared for wool?

|-
| SKILL_LEARN_RATE
| {{L|skill_token}}:percentage
| The rate at which this creature learns this skill.

|-
| SKILL_LEARN_RATES
| percentage
| The rate at which this creature learns all skills.

|-
| SKILL_RATE
| {{L|skill_token}}:percentage:value:value:value
| As SKILL_RATES for individual skills.

|-
| SKILL_RATES
|
*% of improvement points you get
*unused counter rate
*rust counter rate
*demotion counter rate
| Affects skill gain and decay. Lower numbers in the last three slots make decay occur faster ([SKILL_RATES:100:1:1:1] would cause rapid decay). The counter rates may also be replaced with NONE.
Default is [SKILL_RATES:100:8:8:16]. [SLOW_LEARNER] changes the 100 to a 50.

|-
| SKILL_RUST_RATE
| {{L|skill_token}}:value:value:value
| The rate at which this skill decays. Lower values cause the skill to decay faster.

|-
| SKILL_RUST_RATES
| {{L|skill_token}}:value:value:value
| The rate at which all skills decay. Lower values cause the skills to decay faster.

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

|-
| SMALL_REMAINS
|
| If a creature has this token, it'll leave a small corpse that only rots once, and without miasma.

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

|-
| SPEC_HEAT
| value
| Amount of energy required for the creature to heat up or cool down.

|-
| SPECIALATTACK_INJECT_EXTRACT
|
*material source, eg. LOCAL_CREATURE_MAT, INORGANIC
*MATERIAL eg.POISON,
*MATTERSTATE (ALL_SOLID, LIQUID, GAS)
*min:max
| attack type addition that injects a material into the victim.

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

|-
| SPEECH
| speech file
| Boasting speeches relating to killing this creature. Examples include dwarf.txt and elf.txt in the Speech folder in Data.u

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

|-
| SPHERE
|
*sphere name
| Sets what religious spheres the creature is aligned to, for purposes of being worshipped via the [POWER] token. Also affects the layout of hidden fun stuff, and the creature's name.

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

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

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

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

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

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

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

|-
| SYN_CONTACT
|
| syndrome can be contracted on contact.

|-
| SYN_IMMUNE_CREATURE
|
| creates an exception for the creature so that it not affected by the syndrome.

|-
| SYN_INHALED
|
| syndrome can be contracted by inhalation, eg. poison dust.

|-
| SYN_INJECTED
|
| syndrome can be contracted by injection, eg. snake bite.

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

|-
| SYNDROME
|
| begins definition of a syndrome for poison use
|}

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

==T==
{| {{prettytable}}
|- bgcolor="#ddd"
! width="20%" | Token
! width="20%" | Arguments
! width="60%" | Description
|-
| TENDONS
|
*selection criteria. Often LOCAL_CREATURE_MAT, although other selection criteria may work too.
*selected tissue
*healing rate
| Defines the material and healing rare of tendons.

|-
| THICKWEB
|
| The creature's webs can catch larger creatures. May imply [AMBUSHPREDATOR].

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

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

|-
| TISSUE_LAYER_UNDER
|
*BY_TYPE, BY_CATEGORY, BY_TOKEN
*TYPE,CATEGORY, or TOKEN
*TISSUE
*LOCATION
| Adds the tissue layer under a given part ex. is Iron Man he has a gaseous poison within him and this tissue (GAS is its name) has the token [TISSUE_LEAKS] and its state is GAS so when you puncture the iron outside and damage this tissue it leaks gas (can have a syndrome by using a previous one in the creature sample.) [TISSUE_LAYER_UNDER:BY_CATEGORY:ALL:{tissue}] {tissue} is what will be under the TISSUE_LAYER here is an example Tissue from Iron Man
[TISSUE:GAS]
[TISSUE_NAME:gas:NP]
[TISSUE_MATERIAL:LOCAL_CREATURE_MAT:GAS]
[TISSUE_MAT_STATE:GAS]
[RELATIVE_THICKNESS:50]
[TISSUE_LEAKS]
[TISSUE_SHAPE:LAYER]

|-
| TISSUE_LAYER_APPEARANCE_MODIFIER
|
*QUALITY
*lowest:lower:low:median:high:higher:highest
| sets the range of qualities, including LENGTH, DENSE, HIGH_POSITION, CURLY, GREASY, WRINKLY

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

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

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

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

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

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

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

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

|-
| TRAINABLE
|
| Implies both [TRAINABLE_HUNTING] and [TRAINABLE_WAR].

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

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

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

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

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

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

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

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

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

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

|-
| UNDERSWIM
|
| Creature swims under the water and can't be seen.{{verify}}

|-
| UNIQUE_DEMON
|
| Typically found on genned [[demon]]s; sets the creature as capable of "emerging from the underworld" and taking over during worldgen.

|-
| USE_CASTE
|
*caste token
|

|-
| USE_MATERIAL
|
*new material token
*old material id
| Uses a local creature mat to define a new material?{{verify}}

|-
| USE_MATERIAL_TEMPLATE
|
*new material token
*material template
| Loads a material, and gives it a shortname for later reference

|-
| USE_TISSUE
|
*new tissue token
*old tissue id
| Uses a local creature mat to define a new material?{{verify}}

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

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

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

==V==
{| {{prettytable}}
|- bgcolor="#ddd"
! width="20%" | Token
! width="20%" | Arguments
! width="60%" | Description
|-
| VEGETATION
|
| unknown

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

|-
| VERMIN_BITE
|
*amount
*verb (bitten, stung)
*LOCAL_CREATURE_MAT
*MATERIAL
| vermin bites, and injects something.

|-
| VERMIN_EATER
|
| Vermin can nibble food?{{verify}}

|-
| VERMIN_FISH
|
| Acts like a fish

|-
| VERMIN_GROUNDER
|
| The creature can be picked up if you stand over it. (Requires confirmation)
'I think this is a habitat flag like VERMIN_SOIL, VERMIN_CHASM, etc. It seems to appear on creatures that don't otherwise have one. – Peristarkawan 17:27, 24 May 2007 (EDT)'

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

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

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

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

|-
| VERMIN_NOTRAP
|
| The creature cannot be caught by trappers or animal traps. However, this may not work in all cases, as both dragonflies and fairies can be caught by trappers. This is possibly overridden by the VERMIN_GROUNDER token, allowing trappers set to Catch a Live Land Animal to pick up and thus trap the animal. (speculation by Flippantelf 04:45, 15 June 2009 (UTC))

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

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

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

|-
| VERMINHUNTER
|
| A creature with this tag will hunt down vermin and kill them. Sometimes they will eat the vermin, but most of the time they will bring it to their owner. This tag also makes impossible to assign an owner to the animal. The animal chooses it's own owner instead (like a cat). If assigned to a playable race, members of that race will ONLY be able to eat vermin.

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

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

==W==
{| {{prettytable}}
|- bgcolor="#ddd"
! width="20%" | Token
! width="20%" | Arguments
! width="60%" | Description
|-
| WAGON_PULLER
|
| Allows the creature to pull caravan wagons.

|-
| WEBBER
|
*LOCAL_CREATURE_MAT
*MATERIAL (eg SILK)
| allows the creature to web, and defines what the webs are made of.

|-
| WEBIMMUNE
|
| The creature will not get caught in webs.
|}

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

v0.31:Material definition token

2011-02-20T04:17:48Z

SpitefulFox: Added yarn tag.

{{av}}

The following tokens can be used in material templates, as well as materials defined in other raw files.

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

|-
| MATERIAL_TEMPLATE
|
*id
| The name of the material template. Used when defining a template in material template files; the id is used as an argument when calling for material templates elsewhere.

|-
| STATE_COLOR
|
*state
*color
| The state may be SOLID, LIQUID, GAS, POWDER/SOLID_POWDER, PASTE/SOLID_PASTE, PRESSED/SOLID_PRESSED, ALL_SOLID, or ALL.
Color comes from descriptor_color_standard.txt and is used to indicate the color of the material. The nearest color value is used to display contaminants made of this material.
[STATE_COLOR:ALL_SOLID:GREY]

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

|-
| STATE_ADJ
|
*state
*adjective
| Like STATE_NAME, but used in different situations. Equipment made from the material uses the adjective.

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

|-
| DISPLAY_COLOR
|
*foreground color
*background color
*foreground brightness
| The on-screen color of the material. Uses a standard 3-digit {{L|Color|color token}}. Equivalent to [TILE_COLOR:a:b:c], [BUILD_COLOR:b:a:X] (X = 1 if 'a' equals 'b', 0 otherwise), and [BASIC_COLOR:a:c]

|-
| TILE_COLOR
|
*foreground color
*background color
*foreground brightness
| The color of unmined tiles containing this material (for stone and soil), as well as {{L|engraving}}s in this material.

|-
| BUILD_COLOR
|
*foreground color
*background color
*foreground brightness
| The color of objects made of this material which use both the foreground and background color: {{L|door}}s, {{L|floodgate}}s, {{L|hatch cover}}s, {{L|bin}}s, {{L|barrel}}s, and {{L|cage}}s.

|-
| BASIC_COLOR
|
*color
*brightness
| The color of objects made of this material which use only the foreground color, including workshops, floors and boulders, and smoothed walls.

|-
| MATERIAL_VALUE
|
*value
| Value modifier for the material.

|-
| SPEC_HEAT
|
*specific heat capacity
| See {{L|SPEC HEAT}}

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

|-
| MELTING_POINT
|
*temperature
| Temperature at which the material melts. May be set to NONE.

|-
| BOILING_POINT
|
*temperature
| Temperature at which the material boils. May be set to NONE.

|-
| HEATDAM_POINT
|
*temperature
| Temperature above which the material takes damage from heat. May be set to NONE. If the material has an ignite point but no heatdam point it may burn for very long time (around 9-10 months).

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

|-
| MAT_FIXED_TEMP
|
*temperature
| Constant temperature of the material. May be set to NONE.

|-
| SOLID_DENSITY
|
*density
| Affects the weight of the material. Also affects combat calculations; affects blunt-force damage and ability of edged weapons to pierce tissue layers.{{verify}}
It is displayed as a 4 or more digit number such as 11340 for lead. 11340 kg·m^3 = 11340
|-
| LIQUID_DENSITY
|
*density
| It works the same as above, except it is for the liquid state.

|-
| MOLAR_MASS
|
*value
| Supposedly not used.

|-
| IMPACT_YIELD
|
*value
| Used for blunt-force combat.

|-
| IMPACT_FRACTURE
|
*value
| Used for blunt-force combat.

|-
| IMPACT_STRAIN_AT_YIELD or IMPACT_ELASTICITY
|
*value
| Used for blunt-force combat.

|-
| COMPRESSIVE_YIELD
|
*value
| [http://www.bay12forums.com/smf/index.php?topic=30026.msg1007133;topicseen#msg1007133 Supposedly used only during wrestling.]

|-
| COMPRESSIVE_FRACTURE
|
*value
| [http://www.bay12forums.com/smf/index.php?topic=30026.msg1007133;topicseen#msg1007133 Supposedly used only during wrestling.]

|-
| COMPRESSIVE_STRAIN_AT_YIELD or COMPRESSIVE_ELASTICITY
|
*value
| [http://www.bay12forums.com/smf/index.php?topic=30026.msg1007133;topicseen#msg1007133 Supposedly used only during wrestling.]

|-
| TENSILE_YIELD
|
*value
| [http://www.bay12forums.com/smf/index.php?topic=30026.msg1007133;topicseen#msg1007133 Supposedly used only during wrestling.]

|-
| TENSILE_FRACTURE
|
*value
| [http://www.bay12forums.com/smf/index.php?topic=30026.msg1007133;topicseen#msg1007133 Supposedly used only during wrestling.]

|-
| TENSILE_STRAIN_AT_YIELD or TENSILE_ELASTICITY
|
*value
| [http://www.bay12forums.com/smf/index.php?topic=30026.msg1007133;topicseen#msg1007133 Supposedly used only during wrestling.]

|-
| TORSION_YIELD
|
*value
| [http://www.bay12forums.com/smf/index.php?topic=30026.msg1007133;topicseen#msg1007133 Supposedly used only during wrestling.]

|-
| TORSION_FRACTURE
|
*value
| [http://www.bay12forums.com/smf/index.php?topic=30026.msg1007133;topicseen#msg1007133 Supposedly used only during wrestling.]

|-
| TORSION_STRAIN_AT_YIELD or TORSION_ELASTICITY
|
*value
| [http://www.bay12forums.com/smf/index.php?topic=30026.msg1007133;topicseen#msg1007133 Supposedly used only during wrestling.]

|-
| SHEAR_YIELD
|
*value
| Used for cutting calculations.

|-
| SHEAR_FRACTURE
|
*value
| Used for cutting calculations.

|-
| SHEAR_STRAIN_AT_YIELD or SHEAR_ELASTICITY
|
*value
| Used for cutting calculations.

|-
| BENDING_YIELD
|
*value
| [http://www.bay12forums.com/smf/index.php?topic=30026.msg1007133;topicseen#msg1007133 Supposedly used only during wrestling.]

|-
| BENDING_FRACTURE
|
*value
| [http://www.bay12forums.com/smf/index.php?topic=30026.msg1007133;topicseen#msg1007133 Supposedly used only during wrestling.]

|-
| BENDING_STRAIN_AT_YIELD or BENDING_ELASTICITY
|
*value
| [http://www.bay12forums.com/smf/index.php?topic=30026.msg1007133;topicseen#msg1007133 Supposedly used only during wrestling.]

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

|-
| ABSORPTION
|
*value
| Supposedly not used.

|-
| ITEMS_HARD
|
*none
|

|-
| ITEMS_QUERN
|
*none
|

|-
| ITEMS_WEAPON
|
*none
| Melee {{L|Weapons#Manufactured_weapons|weapons}} can be made out of this material.

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

|-
| ITEMS_AMMO
|
*none
| {{L|Weapon#Ammunition|Ammunition}} can be made out of this material.

|-
| ITEMS_DIGGER
|
*none
| {{L|Weapon#Dwarf-manufactured_weapons|Picks}} can be made out of this material.

|-
| ITEMS_ANVIL
|
*none
| {{L|Anvil}}s can be made out of this material.

|-
| ITEMS_ARMOR
|
*none
| {{L|Armor}} can be made out of this material.

|-
| ITEMS_SIEGE_ENGINE
|
*none
| Siege engine parts can be made out of this material.{{verify}}

|-
| ITEMS_BARRED
|
*none
|

|-
| ITEMS_SCALED
|
*none
|

|-
| ITEMS_LEATHER
|
*none
| {{L|Leather}} items can be made from this material.

|-
| ITEMS_SOFT
|
*none
|

|-
| ITEMS_DELICATE
|
*none
|

|-
| ITEMS_METAL
|
*none
|

|-
| IS_STONE
|
| Used to define that said material is stone.

|-
| IS_METAL
|
| Used only in the metal template. Not used anywhere else.

|-
| IS_GLASS
|
|

|-
| IS_GEM
|
* name
* plural
* state
| Used to indicate that said material is a gemstone - when mined out, rough gems will be yielded instead of boulders. Plural can be STP to automatically append an "s" to the singular form, and OVERWRITE_SOLID will override the relevant STATE_NAME.

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

|-
| ALCOHOL_PLANT
|
|

|-
| ALCOHOL_CREATURE
|
|

|-
| CHEESE_PLANT
|
|

|-
| CHEESE_CREATURE
|
|

|-
| POWDER_MISC_PLANT
|
|

|-
| POWDER_MISC_CREATURE
|
|

|-
| STOCKPILE_GLOB
|
|

|-
| LIQUID_MISC_PLANT
|
|

|-
| LIQUID_MISC_CREATURE
|
|

|-
| LIQUID_MISC_OTHER
|
|

|-
| STRUCTURAL_PLANT_MAT
|
|

|-
| SEED_MAT
|
|

|-
| LEAF_MAT
|
|

|-
| BONE
|
|

|-
| THREAD_PLANT
|
|

|-
| TOOTH
|
|

|-
| PEARL
|
|

|-
| HORN
|
|

|-
| SHELL
|
|

|-
| LEATHER
|
|

|-
| SILK
|
|

|-
| WOOD
|
|

|-
| SOAP
|
|

|-
| MEAT
|
|

|-
| GENERATES_MIASMA
|
|

|-
| ROTS
|
|

|-
| BLOOD_MAP_DESCRIPTOR
|
|

|-
| ICHOR_MAP_DESCRIPTOR
|
|

|-
| GOO_MAP_DESCRIPTOR
|
|

|-
| SLIME_MAP_DESCRIPTOR
|
|

|-
| PUS_MAP_DESCRIPTOR
|
|

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

|-
| EDIBLE_RAW
|
| Can be eaten raw.

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

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

|-
| STONE_NAME
|
| Name of stones mined out if material is a stone.

|-
| LAVA
|
| Causes the material to seal magma pipes, be produced by the magma + water reaction and be used in the construction of Dark Fortresses

|-
| TEMP_DIET_INFO
|
|

|-
| SLIME
|
|

|-
| ICHOR
|
|

|-
| GOO
|
|

|-
| FILTH
|
|

|-
| POWDER_DYE
|
|

|-
| ITEM_SYMBOL
|
|

|-
| IF_EXISTS_SET_HEATDAM_POINT
|
*temperature
| Changes a material's HEATDAM_POINT, but only if it was not set to NONE.

|-
| IF_EXISTS_SET_COLDDAM_POINT
|
*temperature
| Changes a material's COLDDAM_POINT, but only if it was not set to NONE.

|-
| IF_EXISTS_SET_IGNITE_POINT
|
*temperature
| Changes a material's IGNITE_POINT, but only if it was not set to NONE.

|-
| IF_EXISTS_SET_MELTING_POINT
|
*temperature
| Changes a material's MELTING_POINT, but only if it was not set to NONE.

|-
| IF_EXISTS_SET_BOILING_POINT
|
*temperature
| Changes a material's BOILING_POINT, but only if it was not set to NONE.

|-
| IF_EXISTS_SET_MAT_FIXED_TEMP
|
*temperature
| Changes a material's MAT_FIXED_TEMP, but only if it was not set to NONE.

|-
| EXTRACT_STORAGE
|
|

|-
| BUTCHER_SPECIAL
|
*item type
*valueONE
| All instances in the material templates have NONE as the second argument. Possibly subtype?
[BUTCHER_SPECIAL:MEAT:NONE]
[BUTCHER_SPECIAL:GLOB:NONE]

|-
| MEAT_NAME
|
*prefix
*name
*adjective?
| When the creature is butchered, its organs will be named via this token.

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

|-
| MATERIAL_REACTION_PRODUCT
|
*reaction reference
*material:subtype
| Used with reaction raws to preserve material source from reagent to product. First argument comes from HAS_MATERIAL_REACTION_PRODUCT in reaction raws. Second argument is a material reference, generally LOCAL_CREATURE_MAT:SUBTYPE but potentially also LOCAL_PLANT_MAT:SUBTYPE or even CREATURE_MAT:CREATURE_ID:SUBTYPE, PLANT_MAT:PLANT_ID:SUBTYPE, or INORGANIC:STONETYPE.
[MATERIAL_REACTION_PRODUCT:TAN_MAT:LOCAL_CREATURE_MAT:LEATHER]

|-
| HARDENS_WITH_WATER
|
| Allows the material to be used to make {{L|healthcare|casts}}.

|-
| SOAP_LEVEL
|
*value
|

|-
| MULTIPLY_VALUE
|
*value
| Multiplies the value of the selected material. Seen in local creature materials.

|-
| SYNDROME
|
| Begins defining a {{L|Syndrome}}. Supposedly does not work with templates.{{verify}}

|-
| UNDIGGABLE
|
| Used for a stone that cannot be dug into.
|-
| YARN
|
| Is yarn.
|}

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

v0.31:Plant token

2011-02-20T04:01:23Z

SpitefulFox: Added grass tags

{{quality|Fine|08:00, 22 May 2010 (UTC)}}{{av}}
The default plants are stored in the plant_standard.txt file.

==Basic Tokens==
{| {{prettytable}}
|- style='background-color:#ddd'
! width="20%" | Token
! width="20%" | Arguments
! width="60%" | Description
|-
| PLANT
|
*name
| The ID of this plant used by the game. <font color="red">Required</font>.

|-
| NAME
|
*name
| The singular form of the plants name as seen in game. <font color="red">Required</font>.

|-
| NAME_PLURAL
|
*name
| The plural form of the plants name as seen in game. <font color="red">Required</font>.

|-
| ADJ
|
*adjective
| The word or phrase used to describe items made from this plant.

|-
|PREFSTRING
|
*reason
| What dwarves can like this object for (e.g. "Urist likes plump helmets for their rounded tops.")

|-
| VALUE
|
*value
| Value of harvested plant.

|-
| PICKED_TILE
|
*tile
| The tile used when harvested. May either be a number or letter within apostrophes(confirm?).<font color="red">Required</font>. See [[character table]].

|-
| PICKED_COLOR
|
*foreground
*background
*bright
| The {{l|color}} of the plant in farms.

|-
| SHRUB_TILE
|
*tile
| What tile is used for shrubs bearing this plant. Can be either a number or a character inside apostrophes.

|-
| DEAD_SHRUB_TILE
|
*tile
| What tile is used when the plant has withered. Can be either a number or a character inside apostrophes.

|-
| SHRUB_COLOR
|
*foreground
*background
*bright
| The [[color]] of shrubs bearing this plant.

|-
| DEAD_SHRUB_COLOR
|
*foreground
*background
*bright
|The [[color]] of dead shrubs that bore this plant.

|}

==Plant Materials==
Materials defined within a plant can be modified by all valid material tokens and may only be accessed by the local plant.

{| {{prettytable}}
|- style='background-color:#ddd'
! width="20%" | Token
! width="20%" | Arguments
! width="60%" | Description
|-
| USE_MATERIAL_TEMPLATE
|
*material_name
*template_name
| Starts defining a new local plant material with the given name using the specified template. material_name is used to reference the newly created material from the same plant.

|-
| BASIC_MAT
|
*material_type
*material name
| Sets the basic(structural) material of the plant. material_type is LOCAL_PLANT_MAT for materials defined inside the plant. According to Toady, you can use other materials (for instance, iron) but the game may hiccup on plants that aren't structurally plants.

|-
| TREE
|
*material_type
*material_name
| The material to use for trees made of this plant. material_type is LOCAL_PLANT_MAT for materials defined in the plant.

|-
| LEAVES
|
*name
*name_plural
*tile
*foreground
*background
*bright
*wilt_foreground
*wilt_background
*wilt_bright
*material_type
*material_name
| The material used by the leaves of this plant. material_type is LOCAL_PLANT_MAT for materials defined in the plant.

|-
|SEED
|
*name
*name_plural
*foreground
*background
*bright
*material_type
*material_name
| The material used by the seeds of this plant, as well as the singular and plural forms of the name for the seeds and their color. material_type is LOCAL_PLANT_MAT for materials defined in the plant.

|-
| DRINK
|
*material_type
*material_name
| The material to be used for drinks made from this plant. material_type is LOCAL_PLANT_MAT for materials defined in the plant.

|-
| MILL
|
*material_type
*material_name
| The material to be used by the ground version of this plant. material_type is LOCAL_PLANT_MAT for materials defined in the plant.

|-
|THREAD
|
*material_type
*material_name
| The material of threads made from this plant. material_type is LOCAL_PLANT_MAT for materials defined in the plant.

|-
|EXTRACT_BARREL
|
*material_type
*material_name
| The material that is used for the extract put into barrels. Should correspond to a material with the [EXTRACT_STORAGE:BARREL] token. material_type is LOCAL_PLANT_MAT for materials defined in the plant.

|-
| EXTRACT_VIAL
|
*material_type
*material_name
| The material that is used for the extract put into vials. Should correspond to a material with the [EXTRACT_STORAGE:FLASK] token. material_type is LOCAL_PLANT_MAT for materials defined in the plant. These are extracted at a {{L|Farmer's workshop}}, not a {{L|Still}}.

|-
| EXTRACT_STILL_VIAL
|
*material_type
*material_name
| The material that is used for the extract put into vials. Should correspond to a material with the [EXTRACT_STORAGE:FLASK] token. material_type is LOCAL_PLANT_MAT for materials defined in the plant. These are extracted at a {{L|Still}}, not a {{L|Farmer's workshop}}.

|-
| EXTRACT_STORAGE
|
*storage_type (BARREL or FLASK)
| Used in material definitions, defines where the new material is stored.

|-
| EDIBLE_VERMIN
|
| Used in material definitions, lets vermin eat this part of the plant.

|-
| EDIBLE_RAW
|
| Used in material definitions, lets entities eat this part of the plant raw. Not mutually exclusive with EDIBLE_COOKED.

|-
| EDIBLE_COOKED
|
| Used in material definition, allows entities to cook this part of the plant. Not mutually exclusive with EDIBLE_RAW.

|}

==Growing Tokens==
{| {{prettytable}}
|- style='background-color:#ddd'
! width="20%" | Token
! width="20%" | Arguments
! width="60%" | Description
|-
| GROWDUR
|
*time
| How long the plant takes to grow. See {{l|Time}}.

|-
| BIOME
|
*biome
| What {{L|biome token|biome}} this plant appears in.

|-
| SPRING
|
| This plant may be planted and will grow in the spring. Not mutually exclusive with other season tokens.

|-
| SUMMER
|
| This plant may be planted and will grow during the summer. Not mutually exclusive with other season tokens.

|-
| AUTUMN
|
| This plant may be planted and will grow during the autumn. Not mutually exclusive with other season tokens.

|-
| WINTER
|
| This plant may be planted and will grow during the winter. Not mutually exclusive with other season tokens.

|-
| WET
|
| This plant appears near water features. Not mutually exclusive with the DRY token.

|-
| DRY
|
| This plant appears away from water features. Not mutually exclusive with the WET token.

|-
| EVIL
|
| This plant appears only in evil biomes. Mutually exclusive with GOOD.

|-
| GOOD
|
| This plant appears only in good biomes. Mutually exclusive with EVIL.

|-
| SAVAGE
|
| This plant appears only in savage biomes. Not mutually exclusive with GOOD or EVIL.

|-
| FREQUENCY
|
*freq (0-100)
| How frequently shrubs of this plant are generated in a particular area.

|-
| CLUSTERSIZE
|
*size
| The maximum stack size collected when gathered or harvested.

|-
| UNDERGROUND_DEPTH
|
*minimum
*maximum
| Designates the highest and lowest levels that the plant can appear in if its {{L|biome token|biome}} is subterranean. Dwarven civilizations will only export (via the embark screen or caravans) things that available at depth 1.

|}

==Tree Tokens==
Trees cannot be used for seeds/food/drink/thread at this point, however, the structural material is designated in the same way.
Trees now appear under plant_standard instead of matgloss_wood.
{| {{prettytable}}
|- style='background-color:#ddd'
! width="20%" | Token
! width="20%" | Arguments
! width="60%" | Description

|-
| AUTUMNCOLOR
|
*foreground
*background
*bright
| The [[color]] that this tree turns in Autumn.

|-
|TREE_TILE
|
*tile
| The tile used for the tree on the map. May be a number or a character inside apostrophes.

|-
| TREE_COLOR
|
*foreground
*background
*bright
| The [[color]] of the tree on the map.

|-
| DEAD_TREE_COLOR
|
*foreground
*background
*bright
| The [[color]] of the tree on the map when dead.

|-
| SAPLING
|
| Marks this tree as having a sapling stage(?).

|-
| SAPLING_COLOR
|
*foreground
*background
*bright
| The [[color]] of the tree when it is a sapling.

|-
| DEAD_SAPLING_COLOR
|
*foreground
*background
*bright
| The [[color]] of the tree when it is a dead sapling.

|}

==Grass Tokens==

{| {{prettytable}}
|- style='background-color:#ddd'
! width="20%" | Token
! width="20%" | Arguments
! width="60%" | Description

|-
| GRASS
|
| Plant is a type of grass.
|-
| GRASS_TILES
|
*tile
*tile
*tile
*tile
|Tiles for a surface covered in grass.
|-
| ALT_GRASS_TILES
|
*tile
*tile
*tile
*tile
|Grass tiles will alternate between these and GRASS_TILES. Currently used for wormy tendrils and eyeballs.
|-
| GRASS_COLORS
|
*foreground
*background
*bright
*foreground
*background
*bright
*foreground
*background
*bright
*foreground
*background
*bright
|Colors of grass tiles.
|-
| ALT_PERIOD
|
*number?
*number?
|How often the grass switches between alternate tiles?
|}

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