Dwarf Fortress Wiki - User contributions [en]

v0.31:Creature token

2011-05-14T16:33:34Z

3: /* C */

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

A full list of all known creature tokens.

__NOTOC__

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

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

|-
| ADOPTS_OWNER
|
| Tame creature cannot be made available for adoption, instead automatically adopting whoever it wants. It appears that the basic requirements for adoption are intact; for example, the creature is more likely to adopt an owner which likes creatures of that species.{{verify}}

|-
| ALCOHOL_DEPENDENT
|
| 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.{{verify}}

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

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

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

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

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

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

|-
| ATTACK_TRIGGER
| pop:exported wealth:created wealth
| Specifies when a {{L|megabeast}} will attack the fortress.

|}

<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
| Defines a new name for a creature in baby state at the caste level. For non-caste-specific baby names, see GENERAL_BABY_NAME.

|-
| BEACH_FREQUENCY
|
| {{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|elephant}}s), which will generally avoid dwarves, although they may chase and/or attack them if they get too close).

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

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

|-
| 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. If a member of a civilization (such as a pet) has this token, it'll need to eat and drink.{{verify}}

|-
| CANNOT_UNDEAD
|
| Cannot be turned into a zombie or skeletal undead. Also prevents ghosts of that creature appearing.

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

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

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

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

|-
| CHILDNAME
| singular:plural
| Defines a new name for a creature in child state at the caste level. For non-caste-specific child names, see GENERAL_CHILD_NAME.

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

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

|-
| 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
|
| Found on generated {{L|demon}}s; sets the creature as potential {{L|hell}} spawn

|-
| 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
|
* {{L|material token}}
*state (SOLID, LIQUID, or GAS)
| Egg material. Egg-laying creatures will define this 3 times, using LOCAL_CREATURE_MAT:EGGSHELL, LOCAL_CREATURE_MAT:EGG_WHITE, and then LOCAL_CREATURE_MAT:EGG_YOLK. Eggs will be made out of eggshell. Edibility is determined by tags on whites or yolk, but they otherwise do not exist.

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

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

|-
| EXTRACT
|
* {{L|material token}}
| Defines a creature extract which can be obtained via {{L|small animal dissection}}.

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

|-
| FEATURE_BEAST
|
| Found on {{L|forgotten beast}}s.

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

|-
| 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]. Not to be confused with POP_RATIO
|}

<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 {{L|Forgotten beast}}s, (biome name) {{L|titan}}s, {{L|Demon}}s, and {{L|night creature}}s.

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

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

|-
| 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
|
| When using tags from an existing creature, inserts new tags at the end of the creature.

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

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

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

|-
| GRASSTRAMPLE
| value
| Determines the percentage chance (or possibly wait time until next trample) of trampling and killing grass when a creature steps on it. Delete the tag to make the creature never trample grass.

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

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

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

==H==
{| {{prettytable}}
|- bgcolor="#ddd"
! width="20%" | Token
! width="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, GIANT_NEST, 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.

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

|-
| HIVE_PRODUCT
|
*number
*{{L|time}}
*{{L|item token}}s
| What product is harvested from {{L|Beekeeping industry|beekeeping}}.

|-
| HOMEOTHERM
|
| Default 'NONE'. The creature's normal body {{L|temperature}}

|-
| HUNTS_VERMIN
|
| Creature hunts and kills nearby vermin.

|}

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

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

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

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

|-
| ITEMCORPSE
|
* {{L|item token}}:subtype
* {{L|material token}}
| Determines if the creature leaves behind a non-standard corpse (i.e. wood, statue, bars, ash from ghost etc).

|-
| 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, WILDERNESS_LOCATION, 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
|
* {{L|item token}}
* {{L|material token}}
| Creature lays a particular item instead of regular eggs.

|-
| LIGAMENTS
|
* {{L|material token}}
*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

|-
| MAGICAL
|
| Unknown.

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

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

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

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

|-
| MATERIAL_BREATH_ATTACK
|
* {{L|material token}}
* breath attack type (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.

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

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

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

|-
| MEGABEAST
|
| Appears on fortress territory in Fortress Mode occasionally. Can also 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 to prevent rust entirely.

|-
| MILKABLE
|
* {{L|material token}}
* frequency
| 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."

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

|-
| 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. Requires CAN_LEARN or INTELLIGENT to function.

|-
| 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_GENDER
|
| Creature has no gender.

|-
| 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
|
| Creatures doesn't require an organ with the [THOUGHT] tag to survive; generally used on creatures that don't have brains.

|-
| 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. Creatures with this tag never wake up from sleep in Fortress Mode and stay drowsy. If this creature must eat and drink while playing, it WILL die.

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

|-
| PETVALUE_DIVISOR
| value
| Divides the creature's PETVALUE by the specified number. Used for bees to prevent a single hive from being worth a fortune.

|-
|PHYS_ATT_CAP_PERC
|
*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. Presumably used immediately after SET_BP_GROUP.

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

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

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

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

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

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

==R==
{| {{prettytable}}
|- bgcolor="#ddd"
! width="20%" | Token
! width="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
| singular:plural
| What creature's remains are called.

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

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

|-
| REMAINS_UNDETERMINED
|
| Unknown.

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

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

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

|}

<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
|
* {{L|material token}}
*Material State
*location secreted from (by_type, by_category, by_token)
*body part
*tissue layer
| creates a secreted material on given tissue on a given part of the body.

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

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

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

|-
| 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
| Begins a selection of body parts.

|-
| 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
|
* tissue modifier
* required value
| Tissue layer can be sheared for its component material. The specified modifier must be at least of the desired value for shearing to be possible (a llama's wool must have a LENGTH of 300 before it is shearable).

|-
| SKILL_LEARN_RATE
| {{L|skill_token}}:percentage
| The rate at which this creature learns this skill. Requires CAN_LEARN or INTELLIGENT to function.

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

|-
| SKILL_RATE
| {{L|skill_token}}:percentage:value:value:value
| As SKILL_RATES for individual skills. Requires CAN_LEARN or INTELLIGENT to function.

|-
| 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. Requires CAN_LEARN or INTELLIGENT to function.

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

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

|-
| SLOW_LEARNER
|
| 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 "remains" instead of a corpse.

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

|-
| SOUND
|
* Sound application (currently accepts ALERT or PEACEFUL_INTERMITTENT)
* Sound range (in tiles)
* Sound delay (lower values = sound is produced more often)
* VOCALIZATION or NONE (determines whether the sound requires breathing or not)
* First-person description
* Third-person description
* Description when out of sight
| Creature makes sounds periodically, which can be heard in Adventure mode.

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

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

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

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

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

|}

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

==T==
{| {{prettytable}}
|- bgcolor="#ddd"
! width="20%" | Token
! width="20%" | Arguments
! width="60%" | Description
|-
| TENDONS
|
* {{L|material token}}
*healing rate
| Defines the material and healing rate of tendons.

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

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

|-
| TITAN
|
| Found on {{L|titan}}s.

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

|-
| 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 generated {{L|demon}}s; causes the game to create a single named instance of the demon which will emerge from the underworld and take over civilizations during worldgen. Cannot be used for modder-defined creatures.

|-
| USE_CASTE
|
*new caste token
*old caste token
| Defines a new caste derived directly from a previous caste. The new caste inherits all properties of the old one. The effect of this tag is automatic if one has not yet defined any castes: "Any caste-level tag that occurs before castes are explicitly declared is saved up and placed on any caste that is declared later, unless the caste is explicitly derived from another caste."

|-
| USE_MATERIAL
|
*new material token
*old material id
| Defines a new local creature material and populates it with all properties defined in the specified material. Old material id accepts any valid material id, including INORGANIC:X, CREATURE_MAT:C:X, LOCAL_CREATURE_MAT:X, and others (where X is a material id from that set, and C is a valid creature id).{{verify}}

|-
| USE_MATERIAL_TEMPLATE
|
*new material token
*material template
| Defines a new local creature material and populates it with all properties defined in the specified template.

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

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

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

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

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

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

|-
| VERMIN_HATEABLE
|
| 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 in baited animal traps; however, a "catch live land animal" task may still be able to capture one if a dwarf finds one roaming around.

|-
| VERMIN_ROTTER
|
| 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
|
| Implies AT_PEACE_WITH_WILDLIFE, RETURNS_VERMIN_KILLS_TO_OWNER, HUNTS_VERMIN, and ADOPTS_OWNER.

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

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

<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
|
* {{L|material token}}
| Allows the creature to create webs, and defines what the webs are made of.

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

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

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

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

|-
| ATTACK_CONTACT_PERC
|
*% value
| amount of available tissue used in 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_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").

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

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

|-
| ATTACK_FLAG_EDGE
|
| attack type

|-
| SPECIALATTACK_INJECT_EXTRACT
|
* {{L|material token}}
*state (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.
|}

==Important Related Tokens==
These next groups of tokens include several tokens that are not technically classified as creature tokens in string dump, but bear mentioning in this as they are used frequently in creature raws. (Some regular creature tokens may also be reprinted for the sake of ease of navigation)

===Tissue Modification===
This next group of tokens deals setting and modifying tissue properties. (See also {{L|Tissue definition token}})

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

|-
| INSULATION
|
*value
| Tissue supplies the creature with heat insulation. Higher values result in more insulation.

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

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

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

|-
| 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_OVER
|
*BY_TYPE, BY_CATEGORY, BY_TOKEN
*TYPE,CATEGORY, or TOKEN
*TISSUE
*LOCATION
| Presumably a counterpart to TISSUE_LAYER_UNDER (see below).

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

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

|-
| TISSUE_LEAKS
|
| The selected tissue leaks out of the creature when the layers above it are pierced. As per an iron man's internal poison gas.

|-
| TISSUE_MATERIAL
|
*VALUE (material)
*MATERIAL (material subtype)
| Defines the tissue material. VALUE can be LOCAL_CREATURE_MAT, INORGANIC etc. MATERIAL is a subtype of the material, e.g. [TISSUE_MATERIAL:INORGANIC:BRONZE]

|-
| 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_CONNECTS
|
| Presumably gives the CONNECTS attribute to selected layers.

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

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

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

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

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

|}

==See Also==
*{{L|Body detail plan token}}
*{{L|Body token}}
*{{L|Material definition token}}
*{{L|Syndrome}}
*{{L|Tissue definition token}}

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

v0.31:Creature token

2011-05-14T16:27:26Z

3: /* A */

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

A full list of all known creature tokens.

__NOTOC__

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

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

|-
| ADOPTS_OWNER
|
| Tame creature cannot be made available for adoption, instead automatically adopting whoever it wants. It appears that the basic requirements for adoption are intact; for example, the creature is more likely to adopt an owner which likes creatures of that species.{{verify}}

|-
| ALCOHOL_DEPENDENT
|
| 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.{{verify}}

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

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

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

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

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

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

|-
| ATTACK_TRIGGER
| pop:exported wealth:created wealth
| Specifies when a {{L|megabeast}} will attack the fortress.

|}

<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
| Defines a new name for a creature in baby state at the caste level. For non-caste-specific baby names, see GENERAL_BABY_NAME.

|-
| BEACH_FREQUENCY
|
| {{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|elephant}}s), which will generally avoid dwarves, although they may chase and/or attack them if they get too close).

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

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

|-
| 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. Also prevents ghosts of that creature appearing.

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

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

|-
| CHILDNAME
| singular:plural
| Defines a new name for a creature in child state at the caste level. For non-caste-specific child names, see GENERAL_CHILD_NAME.

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

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

|-
| 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
|
| Found on generated {{L|demon}}s; sets the creature as potential {{L|hell}} spawn

|-
| 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
|
* {{L|material token}}
*state (SOLID, LIQUID, or GAS)
| Egg material. Egg-laying creatures will define this 3 times, using LOCAL_CREATURE_MAT:EGGSHELL, LOCAL_CREATURE_MAT:EGG_WHITE, and then LOCAL_CREATURE_MAT:EGG_YOLK. Eggs will be made out of eggshell. Edibility is determined by tags on whites or yolk, but they otherwise do not exist.

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

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

|-
| EXTRACT
|
* {{L|material token}}
| Defines a creature extract which can be obtained via {{L|small animal dissection}}.

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

|-
| FEATURE_BEAST
|
| Found on {{L|forgotten beast}}s.

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

|-
| 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]. Not to be confused with POP_RATIO
|}

<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 {{L|Forgotten beast}}s, (biome name) {{L|titan}}s, {{L|Demon}}s, and {{L|night creature}}s.

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

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

|-
| 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
|
| When using tags from an existing creature, inserts new tags at the end of the creature.

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

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

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

|-
| GRASSTRAMPLE
| value
| Determines the percentage chance (or possibly wait time until next trample) of trampling and killing grass when a creature steps on it. Delete the tag to make the creature never trample grass.

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

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

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

==H==
{| {{prettytable}}
|- bgcolor="#ddd"
! width="20%" | Token
! width="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, GIANT_NEST, 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.

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

|-
| HIVE_PRODUCT
|
*number
*{{L|time}}
*{{L|item token}}s
| What product is harvested from {{L|Beekeeping industry|beekeeping}}.

|-
| HOMEOTHERM
|
| Default 'NONE'. The creature's normal body {{L|temperature}}

|-
| HUNTS_VERMIN
|
| Creature hunts and kills nearby vermin.

|}

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

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

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

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

|-
| ITEMCORPSE
|
* {{L|item token}}:subtype
* {{L|material token}}
| Determines if the creature leaves behind a non-standard corpse (i.e. wood, statue, bars, ash from ghost etc).

|-
| 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, WILDERNESS_LOCATION, 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
|
* {{L|item token}}
* {{L|material token}}
| Creature lays a particular item instead of regular eggs.

|-
| LIGAMENTS
|
* {{L|material token}}
*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

|-
| MAGICAL
|
| Unknown.

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

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

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

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

|-
| MATERIAL_BREATH_ATTACK
|
* {{L|material token}}
* breath attack type (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.

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

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

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

|-
| MEGABEAST
|
| Appears on fortress territory in Fortress Mode occasionally. Can also 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 to prevent rust entirely.

|-
| MILKABLE
|
* {{L|material token}}
* frequency
| 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."

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

|-
| 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. Requires CAN_LEARN or INTELLIGENT to function.

|-
| 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_GENDER
|
| Creature has no gender.

|-
| 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
|
| Creatures doesn't require an organ with the [THOUGHT] tag to survive; generally used on creatures that don't have brains.

|-
| 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. Creatures with this tag never wake up from sleep in Fortress Mode and stay drowsy. If this creature must eat and drink while playing, it WILL die.

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

|-
| PETVALUE_DIVISOR
| value
| Divides the creature's PETVALUE by the specified number. Used for bees to prevent a single hive from being worth a fortune.

|-
|PHYS_ATT_CAP_PERC
|
*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. Presumably used immediately after SET_BP_GROUP.

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

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

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

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

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

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

==R==
{| {{prettytable}}
|- bgcolor="#ddd"
! width="20%" | Token
! width="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
| singular:plural
| What creature's remains are called.

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

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

|-
| REMAINS_UNDETERMINED
|
| Unknown.

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

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

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

|}

<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
|
* {{L|material token}}
*Material State
*location secreted from (by_type, by_category, by_token)
*body part
*tissue layer
| creates a secreted material on given tissue on a given part of the body.

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

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

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

|-
| 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
| Begins a selection of body parts.

|-
| 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
|
* tissue modifier
* required value
| Tissue layer can be sheared for its component material. The specified modifier must be at least of the desired value for shearing to be possible (a llama's wool must have a LENGTH of 300 before it is shearable).

|-
| SKILL_LEARN_RATE
| {{L|skill_token}}:percentage
| The rate at which this creature learns this skill. Requires CAN_LEARN or INTELLIGENT to function.

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

|-
| SKILL_RATE
| {{L|skill_token}}:percentage:value:value:value
| As SKILL_RATES for individual skills. Requires CAN_LEARN or INTELLIGENT to function.

|-
| 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. Requires CAN_LEARN or INTELLIGENT to function.

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

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

|-
| SLOW_LEARNER
|
| 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 "remains" instead of a corpse.

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

|-
| SOUND
|
* Sound application (currently accepts ALERT or PEACEFUL_INTERMITTENT)
* Sound range (in tiles)
* Sound delay (lower values = sound is produced more often)
* VOCALIZATION or NONE (determines whether the sound requires breathing or not)
* First-person description
* Third-person description
* Description when out of sight
| Creature makes sounds periodically, which can be heard in Adventure mode.

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

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

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

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

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

|}

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

==T==
{| {{prettytable}}
|- bgcolor="#ddd"
! width="20%" | Token
! width="20%" | Arguments
! width="60%" | Description
|-
| TENDONS
|
* {{L|material token}}
*healing rate
| Defines the material and healing rate of tendons.

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

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

|-
| TITAN
|
| Found on {{L|titan}}s.

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

|-
| 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 generated {{L|demon}}s; causes the game to create a single named instance of the demon which will emerge from the underworld and take over civilizations during worldgen. Cannot be used for modder-defined creatures.

|-
| USE_CASTE
|
*new caste token
*old caste token
| Defines a new caste derived directly from a previous caste. The new caste inherits all properties of the old one. The effect of this tag is automatic if one has not yet defined any castes: "Any caste-level tag that occurs before castes are explicitly declared is saved up and placed on any caste that is declared later, unless the caste is explicitly derived from another caste."

|-
| USE_MATERIAL
|
*new material token
*old material id
| Defines a new local creature material and populates it with all properties defined in the specified material. Old material id accepts any valid material id, including INORGANIC:X, CREATURE_MAT:C:X, LOCAL_CREATURE_MAT:X, and others (where X is a material id from that set, and C is a valid creature id).{{verify}}

|-
| USE_MATERIAL_TEMPLATE
|
*new material token
*material template
| Defines a new local creature material and populates it with all properties defined in the specified template.

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

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

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

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

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

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

|-
| VERMIN_HATEABLE
|
| 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 in baited animal traps; however, a "catch live land animal" task may still be able to capture one if a dwarf finds one roaming around.

|-
| VERMIN_ROTTER
|
| 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
|
| Implies AT_PEACE_WITH_WILDLIFE, RETURNS_VERMIN_KILLS_TO_OWNER, HUNTS_VERMIN, and ADOPTS_OWNER.

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

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

<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
|
* {{L|material token}}
| Allows the creature to create webs, and defines what the webs are made of.

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

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

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

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

|-
| ATTACK_CONTACT_PERC
|
*% value
| amount of available tissue used in 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_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").

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

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

|-
| ATTACK_FLAG_EDGE
|
| attack type

|-
| SPECIALATTACK_INJECT_EXTRACT
|
* {{L|material token}}
*state (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.
|}

==Important Related Tokens==
These next groups of tokens include several tokens that are not technically classified as creature tokens in string dump, but bear mentioning in this as they are used frequently in creature raws. (Some regular creature tokens may also be reprinted for the sake of ease of navigation)

===Tissue Modification===
This next group of tokens deals setting and modifying tissue properties. (See also {{L|Tissue definition token}})

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

|-
| INSULATION
|
*value
| Tissue supplies the creature with heat insulation. Higher values result in more insulation.

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

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

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

|-
| 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_OVER
|
*BY_TYPE, BY_CATEGORY, BY_TOKEN
*TYPE,CATEGORY, or TOKEN
*TISSUE
*LOCATION
| Presumably a counterpart to TISSUE_LAYER_UNDER (see below).

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

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

|-
| TISSUE_LEAKS
|
| The selected tissue leaks out of the creature when the layers above it are pierced. As per an iron man's internal poison gas.

|-
| TISSUE_MATERIAL
|
*VALUE (material)
*MATERIAL (material subtype)
| Defines the tissue material. VALUE can be LOCAL_CREATURE_MAT, INORGANIC etc. MATERIAL is a subtype of the material, e.g. [TISSUE_MATERIAL:INORGANIC:BRONZE]

|-
| 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_CONNECTS
|
| Presumably gives the CONNECTS attribute to selected layers.

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

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

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

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

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

|}

==See Also==
*{{L|Body detail plan token}}
*{{L|Body token}}
*{{L|Material definition token}}
*{{L|Syndrome}}
*{{L|Tissue definition token}}

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

v0.31:Creature token

2011-05-14T16:17:42Z

3: /* B */

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

A full list of all known creature tokens.

__NOTOC__

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

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

|-
| ADOPTS_OWNER
|
| Tame creature cannot be made available for adoption, instead automatically adopting whoever it wants.

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

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

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

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

|-
| ATTACK_TRIGGER
| pop:exported wealth:created wealth
| Specifies when a {{L|megabeast}} will attack the fortress.

|}

<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
| Defines a new name for a creature in baby state at the caste level. For non-caste-specific baby names, see GENERAL_BABY_NAME.

|-
| BEACH_FREQUENCY
|
| {{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|elephant}}s), which will generally avoid dwarves, although they may chase and/or attack them if they get too close).

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

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

|-
| 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. Also prevents ghosts of that creature appearing.

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

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

|-
| CHILDNAME
| singular:plural
| Defines a new name for a creature in child state at the caste level. For non-caste-specific child names, see GENERAL_CHILD_NAME.

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

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

|-
| 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
|
| Found on generated {{L|demon}}s; sets the creature as potential {{L|hell}} spawn

|-
| 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
|
* {{L|material token}}
*state (SOLID, LIQUID, or GAS)
| Egg material. Egg-laying creatures will define this 3 times, using LOCAL_CREATURE_MAT:EGGSHELL, LOCAL_CREATURE_MAT:EGG_WHITE, and then LOCAL_CREATURE_MAT:EGG_YOLK. Eggs will be made out of eggshell. Edibility is determined by tags on whites or yolk, but they otherwise do not exist.

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

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

|-
| EXTRACT
|
* {{L|material token}}
| Defines a creature extract which can be obtained via {{L|small animal dissection}}.

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

|-
| FEATURE_BEAST
|
| Found on {{L|forgotten beast}}s.

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

|-
| 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]. Not to be confused with POP_RATIO
|}

<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 {{L|Forgotten beast}}s, (biome name) {{L|titan}}s, {{L|Demon}}s, and {{L|night creature}}s.

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

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

|-
| 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
|
| When using tags from an existing creature, inserts new tags at the end of the creature.

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

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

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

|-
| GRASSTRAMPLE
| value
| Determines the percentage chance (or possibly wait time until next trample) of trampling and killing grass when a creature steps on it. Delete the tag to make the creature never trample grass.

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

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

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

==H==
{| {{prettytable}}
|- bgcolor="#ddd"
! width="20%" | Token
! width="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, GIANT_NEST, 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.

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

|-
| HIVE_PRODUCT
|
*number
*{{L|time}}
*{{L|item token}}s
| What product is harvested from {{L|Beekeeping industry|beekeeping}}.

|-
| HOMEOTHERM
|
| Default 'NONE'. The creature's normal body {{L|temperature}}

|-
| HUNTS_VERMIN
|
| Creature hunts and kills nearby vermin.

|}

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

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

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

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

|-
| ITEMCORPSE
|
* {{L|item token}}:subtype
* {{L|material token}}
| Determines if the creature leaves behind a non-standard corpse (i.e. wood, statue, bars, ash from ghost etc).

|-
| 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, WILDERNESS_LOCATION, 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
|
* {{L|item token}}
* {{L|material token}}
| Creature lays a particular item instead of regular eggs.

|-
| LIGAMENTS
|
* {{L|material token}}
*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

|-
| MAGICAL
|
| Unknown.

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

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

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

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

|-
| MATERIAL_BREATH_ATTACK
|
* {{L|material token}}
* breath attack type (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.

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

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

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

|-
| MEGABEAST
|
| Appears on fortress territory in Fortress Mode occasionally. Can also 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 to prevent rust entirely.

|-
| MILKABLE
|
* {{L|material token}}
* frequency
| 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."

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

|-
| 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. Requires CAN_LEARN or INTELLIGENT to function.

|-
| 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_GENDER
|
| Creature has no gender.

|-
| 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
|
| Creatures doesn't require an organ with the [THOUGHT] tag to survive; generally used on creatures that don't have brains.

|-
| 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. Creatures with this tag never wake up from sleep in Fortress Mode and stay drowsy. If this creature must eat and drink while playing, it WILL die.

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

|-
| PETVALUE_DIVISOR
| value
| Divides the creature's PETVALUE by the specified number. Used for bees to prevent a single hive from being worth a fortune.

|-
|PHYS_ATT_CAP_PERC
|
*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. Presumably used immediately after SET_BP_GROUP.

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

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

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

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

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

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

==R==
{| {{prettytable}}
|- bgcolor="#ddd"
! width="20%" | Token
! width="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
| singular:plural
| What creature's remains are called.

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

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

|-
| REMAINS_UNDETERMINED
|
| Unknown.

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

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

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

|}

<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
|
* {{L|material token}}
*Material State
*location secreted from (by_type, by_category, by_token)
*body part
*tissue layer
| creates a secreted material on given tissue on a given part of the body.

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

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

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

|-
| 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
| Begins a selection of body parts.

|-
| 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
|
* tissue modifier
* required value
| Tissue layer can be sheared for its component material. The specified modifier must be at least of the desired value for shearing to be possible (a llama's wool must have a LENGTH of 300 before it is shearable).

|-
| SKILL_LEARN_RATE
| {{L|skill_token}}:percentage
| The rate at which this creature learns this skill. Requires CAN_LEARN or INTELLIGENT to function.

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

|-
| SKILL_RATE
| {{L|skill_token}}:percentage:value:value:value
| As SKILL_RATES for individual skills. Requires CAN_LEARN or INTELLIGENT to function.

|-
| 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. Requires CAN_LEARN or INTELLIGENT to function.

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

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

|-
| SLOW_LEARNER
|
| 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 "remains" instead of a corpse.

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

|-
| SOUND
|
* Sound application (currently accepts ALERT or PEACEFUL_INTERMITTENT)
* Sound range (in tiles)
* Sound delay (lower values = sound is produced more often)
* VOCALIZATION or NONE (determines whether the sound requires breathing or not)
* First-person description
* Third-person description
* Description when out of sight
| Creature makes sounds periodically, which can be heard in Adventure mode.

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

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

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

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

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

|}

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

==T==
{| {{prettytable}}
|- bgcolor="#ddd"
! width="20%" | Token
! width="20%" | Arguments
! width="60%" | Description
|-
| TENDONS
|
* {{L|material token}}
*healing rate
| Defines the material and healing rate of tendons.

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

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

|-
| TITAN
|
| Found on {{L|titan}}s.

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

|-
| 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 generated {{L|demon}}s; causes the game to create a single named instance of the demon which will emerge from the underworld and take over civilizations during worldgen. Cannot be used for modder-defined creatures.

|-
| USE_CASTE
|
*new caste token
*old caste token
| Defines a new caste derived directly from a previous caste. The new caste inherits all properties of the old one. The effect of this tag is automatic if one has not yet defined any castes: "Any caste-level tag that occurs before castes are explicitly declared is saved up and placed on any caste that is declared later, unless the caste is explicitly derived from another caste."

|-
| USE_MATERIAL
|
*new material token
*old material id
| Defines a new local creature material and populates it with all properties defined in the specified material. Old material id accepts any valid material id, including INORGANIC:X, CREATURE_MAT:C:X, LOCAL_CREATURE_MAT:X, and others (where X is a material id from that set, and C is a valid creature id).{{verify}}

|-
| USE_MATERIAL_TEMPLATE
|
*new material token
*material template
| Defines a new local creature material and populates it with all properties defined in the specified template.

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

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

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

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

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

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

|-
| VERMIN_HATEABLE
|
| 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 in baited animal traps; however, a "catch live land animal" task may still be able to capture one if a dwarf finds one roaming around.

|-
| VERMIN_ROTTER
|
| 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
|
| Implies AT_PEACE_WITH_WILDLIFE, RETURNS_VERMIN_KILLS_TO_OWNER, HUNTS_VERMIN, and ADOPTS_OWNER.

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

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

<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
|
* {{L|material token}}
| Allows the creature to create webs, and defines what the webs are made of.

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

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

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

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

|-
| ATTACK_CONTACT_PERC
|
*% value
| amount of available tissue used in 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_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").

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

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

|-
| ATTACK_FLAG_EDGE
|
| attack type

|-
| SPECIALATTACK_INJECT_EXTRACT
|
* {{L|material token}}
*state (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.
|}

==Important Related Tokens==
These next groups of tokens include several tokens that are not technically classified as creature tokens in string dump, but bear mentioning in this as they are used frequently in creature raws. (Some regular creature tokens may also be reprinted for the sake of ease of navigation)

===Tissue Modification===
This next group of tokens deals setting and modifying tissue properties. (See also {{L|Tissue definition token}})

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

|-
| INSULATION
|
*value
| Tissue supplies the creature with heat insulation. Higher values result in more insulation.

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

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

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

|-
| 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_OVER
|
*BY_TYPE, BY_CATEGORY, BY_TOKEN
*TYPE,CATEGORY, or TOKEN
*TISSUE
*LOCATION
| Presumably a counterpart to TISSUE_LAYER_UNDER (see below).

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

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

|-
| TISSUE_LEAKS
|
| The selected tissue leaks out of the creature when the layers above it are pierced. As per an iron man's internal poison gas.

|-
| TISSUE_MATERIAL
|
*VALUE (material)
*MATERIAL (material subtype)
| Defines the tissue material. VALUE can be LOCAL_CREATURE_MAT, INORGANIC etc. MATERIAL is a subtype of the material, e.g. [TISSUE_MATERIAL:INORGANIC:BRONZE]

|-
| 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_CONNECTS
|
| Presumably gives the CONNECTS attribute to selected layers.

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

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

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

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

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

|}

==See Also==
*{{L|Body detail plan token}}
*{{L|Body token}}
*{{L|Material definition token}}
*{{L|Syndrome}}
*{{L|Tissue definition token}}

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

v0.31:Creature token

2011-05-14T16:15:48Z

3: /* C */

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

A full list of all known creature tokens.

__NOTOC__

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

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

|-
| ADOPTS_OWNER
|
| Tame creature cannot be made available for adoption, instead automatically adopting whoever it wants.

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

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

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

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

|-
| ATTACK_TRIGGER
| pop:exported wealth:created wealth
| Specifies when a {{L|megabeast}} will attack the fortress.

|}

<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|elephant}}s), which will generally avoid dwarves, although they may chase and/or attack them if they get too close).

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

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

|-
| 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. Also prevents ghosts of that creature appearing.

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

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

|-
| CHILDNAME
| singular:plural
| Defines a new name for a creature in child state at the caste level. For non-caste-specific child names, see GENERAL_CHILD_NAME.

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

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

|-
| 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
|
| Found on generated {{L|demon}}s; sets the creature as potential {{L|hell}} spawn

|-
| 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
|
* {{L|material token}}
*state (SOLID, LIQUID, or GAS)
| Egg material. Egg-laying creatures will define this 3 times, using LOCAL_CREATURE_MAT:EGGSHELL, LOCAL_CREATURE_MAT:EGG_WHITE, and then LOCAL_CREATURE_MAT:EGG_YOLK. Eggs will be made out of eggshell. Edibility is determined by tags on whites or yolk, but they otherwise do not exist.

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

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

|-
| EXTRACT
|
* {{L|material token}}
| Defines a creature extract which can be obtained via {{L|small animal dissection}}.

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

|-
| FEATURE_BEAST
|
| Found on {{L|forgotten beast}}s.

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

|-
| 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]. Not to be confused with POP_RATIO
|}

<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 {{L|Forgotten beast}}s, (biome name) {{L|titan}}s, {{L|Demon}}s, and {{L|night creature}}s.

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

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

|-
| 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
|
| When using tags from an existing creature, inserts new tags at the end of the creature.

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

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

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

|-
| GRASSTRAMPLE
| value
| Determines the percentage chance (or possibly wait time until next trample) of trampling and killing grass when a creature steps on it. Delete the tag to make the creature never trample grass.

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

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

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

==H==
{| {{prettytable}}
|- bgcolor="#ddd"
! width="20%" | Token
! width="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, GIANT_NEST, 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.

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

|-
| HIVE_PRODUCT
|
*number
*{{L|time}}
*{{L|item token}}s
| What product is harvested from {{L|Beekeeping industry|beekeeping}}.

|-
| HOMEOTHERM
|
| Default 'NONE'. The creature's normal body {{L|temperature}}

|-
| HUNTS_VERMIN
|
| Creature hunts and kills nearby vermin.

|}

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

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

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

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

|-
| ITEMCORPSE
|
* {{L|item token}}:subtype
* {{L|material token}}
| Determines if the creature leaves behind a non-standard corpse (i.e. wood, statue, bars, ash from ghost etc).

|-
| 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, WILDERNESS_LOCATION, 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
|
* {{L|item token}}
* {{L|material token}}
| Creature lays a particular item instead of regular eggs.

|-
| LIGAMENTS
|
* {{L|material token}}
*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

|-
| MAGICAL
|
| Unknown.

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

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

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

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

|-
| MATERIAL_BREATH_ATTACK
|
* {{L|material token}}
* breath attack type (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.

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

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

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

|-
| MEGABEAST
|
| Appears on fortress territory in Fortress Mode occasionally. Can also 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 to prevent rust entirely.

|-
| MILKABLE
|
* {{L|material token}}
* frequency
| 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."

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

|-
| 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. Requires CAN_LEARN or INTELLIGENT to function.

|-
| 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_GENDER
|
| Creature has no gender.

|-
| 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
|
| Creatures doesn't require an organ with the [THOUGHT] tag to survive; generally used on creatures that don't have brains.

|-
| 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. Creatures with this tag never wake up from sleep in Fortress Mode and stay drowsy. If this creature must eat and drink while playing, it WILL die.

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

|-
| PETVALUE_DIVISOR
| value
| Divides the creature's PETVALUE by the specified number. Used for bees to prevent a single hive from being worth a fortune.

|-
|PHYS_ATT_CAP_PERC
|
*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. Presumably used immediately after SET_BP_GROUP.

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

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

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

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

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

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

==R==
{| {{prettytable}}
|- bgcolor="#ddd"
! width="20%" | Token
! width="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
| singular:plural
| What creature's remains are called.

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

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

|-
| REMAINS_UNDETERMINED
|
| Unknown.

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

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

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

|}

<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
|
* {{L|material token}}
*Material State
*location secreted from (by_type, by_category, by_token)
*body part
*tissue layer
| creates a secreted material on given tissue on a given part of the body.

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

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

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

|-
| 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
| Begins a selection of body parts.

|-
| 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
|
* tissue modifier
* required value
| Tissue layer can be sheared for its component material. The specified modifier must be at least of the desired value for shearing to be possible (a llama's wool must have a LENGTH of 300 before it is shearable).

|-
| SKILL_LEARN_RATE
| {{L|skill_token}}:percentage
| The rate at which this creature learns this skill. Requires CAN_LEARN or INTELLIGENT to function.

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

|-
| SKILL_RATE
| {{L|skill_token}}:percentage:value:value:value
| As SKILL_RATES for individual skills. Requires CAN_LEARN or INTELLIGENT to function.

|-
| 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. Requires CAN_LEARN or INTELLIGENT to function.

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

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

|-
| SLOW_LEARNER
|
| 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 "remains" instead of a corpse.

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

|-
| SOUND
|
* Sound application (currently accepts ALERT or PEACEFUL_INTERMITTENT)
* Sound range (in tiles)
* Sound delay (lower values = sound is produced more often)
* VOCALIZATION or NONE (determines whether the sound requires breathing or not)
* First-person description
* Third-person description
* Description when out of sight
| Creature makes sounds periodically, which can be heard in Adventure mode.

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

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

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

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

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

|}

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

==T==
{| {{prettytable}}
|- bgcolor="#ddd"
! width="20%" | Token
! width="20%" | Arguments
! width="60%" | Description
|-
| TENDONS
|
* {{L|material token}}
*healing rate
| Defines the material and healing rate of tendons.

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

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

|-
| TITAN
|
| Found on {{L|titan}}s.

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

|-
| 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 generated {{L|demon}}s; causes the game to create a single named instance of the demon which will emerge from the underworld and take over civilizations during worldgen. Cannot be used for modder-defined creatures.

|-
| USE_CASTE
|
*new caste token
*old caste token
| Defines a new caste derived directly from a previous caste. The new caste inherits all properties of the old one. The effect of this tag is automatic if one has not yet defined any castes: "Any caste-level tag that occurs before castes are explicitly declared is saved up and placed on any caste that is declared later, unless the caste is explicitly derived from another caste."

|-
| USE_MATERIAL
|
*new material token
*old material id
| Defines a new local creature material and populates it with all properties defined in the specified material. Old material id accepts any valid material id, including INORGANIC:X, CREATURE_MAT:C:X, LOCAL_CREATURE_MAT:X, and others (where X is a material id from that set, and C is a valid creature id).{{verify}}

|-
| USE_MATERIAL_TEMPLATE
|
*new material token
*material template
| Defines a new local creature material and populates it with all properties defined in the specified template.

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

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

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

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

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

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

|-
| VERMIN_HATEABLE
|
| 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 in baited animal traps; however, a "catch live land animal" task may still be able to capture one if a dwarf finds one roaming around.

|-
| VERMIN_ROTTER
|
| 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
|
| Implies AT_PEACE_WITH_WILDLIFE, RETURNS_VERMIN_KILLS_TO_OWNER, HUNTS_VERMIN, and ADOPTS_OWNER.

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

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

<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
|
* {{L|material token}}
| Allows the creature to create webs, and defines what the webs are made of.

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

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

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

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

|-
| ATTACK_CONTACT_PERC
|
*% value
| amount of available tissue used in 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_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").

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

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

|-
| ATTACK_FLAG_EDGE
|
| attack type

|-
| SPECIALATTACK_INJECT_EXTRACT
|
* {{L|material token}}
*state (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.
|}

==Important Related Tokens==
These next groups of tokens include several tokens that are not technically classified as creature tokens in string dump, but bear mentioning in this as they are used frequently in creature raws. (Some regular creature tokens may also be reprinted for the sake of ease of navigation)

===Tissue Modification===
This next group of tokens deals setting and modifying tissue properties. (See also {{L|Tissue definition token}})

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

|-
| INSULATION
|
*value
| Tissue supplies the creature with heat insulation. Higher values result in more insulation.

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

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

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

|-
| 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_OVER
|
*BY_TYPE, BY_CATEGORY, BY_TOKEN
*TYPE,CATEGORY, or TOKEN
*TISSUE
*LOCATION
| Presumably a counterpart to TISSUE_LAYER_UNDER (see below).

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

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

|-
| TISSUE_LEAKS
|
| The selected tissue leaks out of the creature when the layers above it are pierced. As per an iron man's internal poison gas.

|-
| TISSUE_MATERIAL
|
*VALUE (material)
*MATERIAL (material subtype)
| Defines the tissue material. VALUE can be LOCAL_CREATURE_MAT, INORGANIC etc. MATERIAL is a subtype of the material, e.g. [TISSUE_MATERIAL:INORGANIC:BRONZE]

|-
| 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_CONNECTS
|
| Presumably gives the CONNECTS attribute to selected layers.

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

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

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

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

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

|}

==See Also==
*{{L|Body detail plan token}}
*{{L|Body token}}
*{{L|Material definition token}}
*{{L|Syndrome}}
*{{L|Tissue definition token}}

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

v0.31:Creature token

2011-05-14T16:07:03Z

3: /* S */ Shearing, sounds

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

A full list of all known creature tokens.

__NOTOC__

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

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

|-
| ADOPTS_OWNER
|
| Tame creature cannot be made available for adoption, instead automatically adopting whoever it wants.

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

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

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

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

|-
| ATTACK_TRIGGER
| pop:exported wealth:created wealth
| Specifies when a {{L|megabeast}} will attack the fortress.

|}

<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|elephant}}s), which will generally avoid dwarves, although they may chase and/or attack them if they get too close).

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

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

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

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

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

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

|-
| 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
|
| Found on generated {{L|demon}}s; sets the creature as potential {{L|hell}} spawn

|-
| 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
|
* {{L|material token}}
*state (SOLID, LIQUID, or GAS)
| Egg material. Egg-laying creatures will define this 3 times, using LOCAL_CREATURE_MAT:EGGSHELL, LOCAL_CREATURE_MAT:EGG_WHITE, and then LOCAL_CREATURE_MAT:EGG_YOLK. Eggs will be made out of eggshell. Edibility is determined by tags on whites or yolk, but they otherwise do not exist.

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

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

|-
| EXTRACT
|
* {{L|material token}}
| Defines a creature extract which can be obtained via {{L|small animal dissection}}.

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

|-
| FEATURE_BEAST
|
| Found on {{L|forgotten beast}}s.

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

|-
| 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]. Not to be confused with POP_RATIO
|}

<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 {{L|Forgotten beast}}s, (biome name) {{L|titan}}s, {{L|Demon}}s, and {{L|night creature}}s.

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

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

|-
| 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
|
| When using tags from an existing creature, inserts new tags at the end of the creature.

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

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

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

|-
| GRASSTRAMPLE
| value
| Determines the percentage chance (or possibly wait time until next trample) of trampling and killing grass when a creature steps on it. Delete the tag to make the creature never trample grass.

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

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

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

==H==
{| {{prettytable}}
|- bgcolor="#ddd"
! width="20%" | Token
! width="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, GIANT_NEST, 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.

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

|-
| HIVE_PRODUCT
|
*number
*{{L|time}}
*{{L|item token}}s
| What product is harvested from {{L|Beekeeping industry|beekeeping}}.

|-
| HOMEOTHERM
|
| Default 'NONE'. The creature's normal body {{L|temperature}}

|-
| HUNTS_VERMIN
|
| Creature hunts and kills nearby vermin.

|}

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

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

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

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

|-
| ITEMCORPSE
|
* {{L|item token}}:subtype
* {{L|material token}}
| Determines if the creature leaves behind a non-standard corpse (i.e. wood, statue, bars, ash from ghost etc).

|-
| 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, WILDERNESS_LOCATION, 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
|
* {{L|item token}}
* {{L|material token}}
| Creature lays a particular item instead of regular eggs.

|-
| LIGAMENTS
|
* {{L|material token}}
*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

|-
| MAGICAL
|
| Unknown.

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

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

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

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

|-
| MATERIAL_BREATH_ATTACK
|
* {{L|material token}}
* breath attack type (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.

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

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

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

|-
| MEGABEAST
|
| Appears on fortress territory in Fortress Mode occasionally. Can also 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 to prevent rust entirely.

|-
| MILKABLE
|
* {{L|material token}}
* frequency
| 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."

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

|-
| 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. Requires CAN_LEARN or INTELLIGENT to function.

|-
| 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_GENDER
|
| Creature has no gender.

|-
| 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
|
| Creatures doesn't require an organ with the [THOUGHT] tag to survive; generally used on creatures that don't have brains.

|-
| 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. Creatures with this tag never wake up from sleep in Fortress Mode and stay drowsy. If this creature must eat and drink while playing, it WILL die.

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

|-
| PETVALUE_DIVISOR
| value
| Divides the creature's PETVALUE by the specified number. Used for bees to prevent a single hive from being worth a fortune.

|-
|PHYS_ATT_CAP_PERC
|
*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. Presumably used immediately after SET_BP_GROUP.

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

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

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

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

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

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

==R==
{| {{prettytable}}
|- bgcolor="#ddd"
! width="20%" | Token
! width="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
| singular:plural
| What creature's remains are called.

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

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

|-
| REMAINS_UNDETERMINED
|
| Unknown.

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

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

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

|}

<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
|
* {{L|material token}}
*Material State
*location secreted from (by_type, by_category, by_token)
*body part
*tissue layer
| creates a secreted material on given tissue on a given part of the body.

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

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

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

|-
| 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
| Begins a selection of body parts.

|-
| 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
|
* tissue modifier
* required value
| Tissue layer can be sheared for its component material. The specified modifier must be at least of the desired value for shearing to be possible (a llama's wool must have a LENGTH of 300 before it is shearable).

|-
| SKILL_LEARN_RATE
| {{L|skill_token}}:percentage
| The rate at which this creature learns this skill. Requires CAN_LEARN or INTELLIGENT to function.

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

|-
| SKILL_RATE
| {{L|skill_token}}:percentage:value:value:value
| As SKILL_RATES for individual skills. Requires CAN_LEARN or INTELLIGENT to function.

|-
| 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. Requires CAN_LEARN or INTELLIGENT to function.

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

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

|-
| SLOW_LEARNER
|
| 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 "remains" instead of a corpse.

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

|-
| SOUND
|
* Sound application (currently accepts ALERT or PEACEFUL_INTERMITTENT)
* Sound range (in tiles)
* Sound delay (lower values = sound is produced more often)
* VOCALIZATION or NONE (determines whether the sound requires breathing or not)
* First-person description
* Third-person description
* Description when out of sight
| Creature makes sounds periodically, which can be heard in Adventure mode.

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

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

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

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

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

|}

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

==T==
{| {{prettytable}}
|- bgcolor="#ddd"
! width="20%" | Token
! width="20%" | Arguments
! width="60%" | Description
|-
| TENDONS
|
* {{L|material token}}
*healing rate
| Defines the material and healing rate of tendons.

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

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

|-
| TITAN
|
| Found on {{L|titan}}s.

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

|-
| 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 generated {{L|demon}}s; causes the game to create a single named instance of the demon which will emerge from the underworld and take over civilizations during worldgen. Cannot be used for modder-defined creatures.

|-
| USE_CASTE
|
*new caste token
*old caste token
| Defines a new caste derived directly from a previous caste. The new caste inherits all properties of the old one. The effect of this tag is automatic if one has not yet defined any castes: "Any caste-level tag that occurs before castes are explicitly declared is saved up and placed on any caste that is declared later, unless the caste is explicitly derived from another caste."

|-
| USE_MATERIAL
|
*new material token
*old material id
| Defines a new local creature material and populates it with all properties defined in the specified material. Old material id accepts any valid material id, including INORGANIC:X, CREATURE_MAT:C:X, LOCAL_CREATURE_MAT:X, and others (where X is a material id from that set, and C is a valid creature id).{{verify}}

|-
| USE_MATERIAL_TEMPLATE
|
*new material token
*material template
| Defines a new local creature material and populates it with all properties defined in the specified template.

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

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

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

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

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

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

|-
| VERMIN_HATEABLE
|
| 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 in baited animal traps; however, a "catch live land animal" task may still be able to capture one if a dwarf finds one roaming around.

|-
| VERMIN_ROTTER
|
| 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
|
| Implies AT_PEACE_WITH_WILDLIFE, RETURNS_VERMIN_KILLS_TO_OWNER, HUNTS_VERMIN, and ADOPTS_OWNER.

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

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

<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
|
* {{L|material token}}
| Allows the creature to create webs, and defines what the webs are made of.

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

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

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

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

|-
| ATTACK_CONTACT_PERC
|
*% value
| amount of available tissue used in 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_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").

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

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

|-
| ATTACK_FLAG_EDGE
|
| attack type

|-
| SPECIALATTACK_INJECT_EXTRACT
|
* {{L|material token}}
*state (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.
|}

==Important Related Tokens==
These next groups of tokens include several tokens that are not technically classified as creature tokens in string dump, but bear mentioning in this as they are used frequently in creature raws. (Some regular creature tokens may also be reprinted for the sake of ease of navigation)

===Tissue Modification===
This next group of tokens deals setting and modifying tissue properties. (See also {{L|Tissue definition token}})

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

|-
| INSULATION
|
*value
| Tissue supplies the creature with heat insulation. Higher values result in more insulation.

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

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

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

|-
| 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_OVER
|
*BY_TYPE, BY_CATEGORY, BY_TOKEN
*TYPE,CATEGORY, or TOKEN
*TISSUE
*LOCATION
| Presumably a counterpart to TISSUE_LAYER_UNDER (see below).

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

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

|-
| TISSUE_LEAKS
|
| The selected tissue leaks out of the creature when the layers above it are pierced. As per an iron man's internal poison gas.

|-
| TISSUE_MATERIAL
|
*VALUE (material)
*MATERIAL (material subtype)
| Defines the tissue material. VALUE can be LOCAL_CREATURE_MAT, INORGANIC etc. MATERIAL is a subtype of the material, e.g. [TISSUE_MATERIAL:INORGANIC:BRONZE]

|-
| 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_CONNECTS
|
| Presumably gives the CONNECTS attribute to selected layers.

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

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

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

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

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

|}

==See Also==
*{{L|Body detail plan token}}
*{{L|Body token}}
*{{L|Material definition token}}
*{{L|Syndrome}}
*{{L|Tissue definition token}}

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

v0.31:Creature token

2011-05-14T15:55:48Z

3: /* V */ Vermin stuff

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

A full list of all known creature tokens.

__NOTOC__

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

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

|-
| ADOPTS_OWNER
|
| Tame creature cannot be made available for adoption, instead automatically adopting whoever it wants.

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

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

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

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

|-
| ATTACK_TRIGGER
| pop:exported wealth:created wealth
| Specifies when a {{L|megabeast}} will attack the fortress.

|}

<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|elephant}}s), which will generally avoid dwarves, although they may chase and/or attack them if they get too close).

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

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

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

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

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

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

|-
| 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
|
| Found on generated {{L|demon}}s; sets the creature as potential {{L|hell}} spawn

|-
| 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
|
* {{L|material token}}
*state (SOLID, LIQUID, or GAS)
| Egg material. Egg-laying creatures will define this 3 times, using LOCAL_CREATURE_MAT:EGGSHELL, LOCAL_CREATURE_MAT:EGG_WHITE, and then LOCAL_CREATURE_MAT:EGG_YOLK. Eggs will be made out of eggshell. Edibility is determined by tags on whites or yolk, but they otherwise do not exist.

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

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

|-
| EXTRACT
|
* {{L|material token}}
| Defines a creature extract which can be obtained via {{L|small animal dissection}}.

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

|-
| FEATURE_BEAST
|
| Found on {{L|forgotten beast}}s.

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

|-
| 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]. Not to be confused with POP_RATIO
|}

<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 {{L|Forgotten beast}}s, (biome name) {{L|titan}}s, {{L|Demon}}s, and {{L|night creature}}s.

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

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

|-
| 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
|
| When using tags from an existing creature, inserts new tags at the end of the creature.

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

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

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

|-
| GRASSTRAMPLE
| value
| Determines the percentage chance (or possibly wait time until next trample) of trampling and killing grass when a creature steps on it. Delete the tag to make the creature never trample grass.

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

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

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

==H==
{| {{prettytable}}
|- bgcolor="#ddd"
! width="20%" | Token
! width="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, GIANT_NEST, 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.

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

|-
| HIVE_PRODUCT
|
*number
*{{L|time}}
*{{L|item token}}s
| What product is harvested from {{L|Beekeeping industry|beekeeping}}.

|-
| HOMEOTHERM
|
| Default 'NONE'. The creature's normal body {{L|temperature}}

|-
| HUNTS_VERMIN
|
| Creature hunts and kills nearby vermin.

|}

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

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

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

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

|-
| ITEMCORPSE
|
* {{L|item token}}:subtype
* {{L|material token}}
| Determines if the creature leaves behind a non-standard corpse (i.e. wood, statue, bars, ash from ghost etc).

|-
| 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, WILDERNESS_LOCATION, 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
|
* {{L|item token}}
* {{L|material token}}
| Creature lays a particular item instead of regular eggs.

|-
| LIGAMENTS
|
* {{L|material token}}
*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

|-
| MAGICAL
|
| Unknown.

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

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

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

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

|-
| MATERIAL_BREATH_ATTACK
|
* {{L|material token}}
* breath attack type (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.

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

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

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

|-
| MEGABEAST
|
| Appears on fortress territory in Fortress Mode occasionally. Can also 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 to prevent rust entirely.

|-
| MILKABLE
|
* {{L|material token}}
* frequency
| 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."

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

|-
| 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. Requires CAN_LEARN or INTELLIGENT to function.

|-
| 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_GENDER
|
| Creature has no gender.

|-
| 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
|
| Creatures doesn't require an organ with the [THOUGHT] tag to survive; generally used on creatures that don't have brains.

|-
| 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. Creatures with this tag never wake up from sleep in Fortress Mode and stay drowsy. If this creature must eat and drink while playing, it WILL die.

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

|-
| PETVALUE_DIVISOR
| value
| Divides the creature's PETVALUE by the specified number. Used for bees to prevent a single hive from being worth a fortune.

|-
|PHYS_ATT_CAP_PERC
|
*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. Presumably used immediately after SET_BP_GROUP.

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

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

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

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

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

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

==R==
{| {{prettytable}}
|- bgcolor="#ddd"
! width="20%" | Token
! width="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
| singular:plural
| What creature's remains are called.

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

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

|-
| REMAINS_UNDETERMINED
|
| Unknown.

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

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

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

|}

<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
|
* {{L|material token}}
*Material State
*location secreted from (by_type, by_category, by_token)
*body part
*tissue layer
| creates a secreted material on given tissue on a given part of the body.

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

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

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

|-
| 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
| Begins a selection of body parts.

|-
| 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
|
* property
* growth rate?
| Tissue layer can be sheared for its component material. Tissue layer must have certain modifiers, with LENGTH being the only one known to work.

|-
| SKILL_LEARN_RATE
| {{L|skill_token}}:percentage
| The rate at which this creature learns this skill. Requires CAN_LEARN or INTELLIGENT to function.

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

|-
| SKILL_RATE
| {{L|skill_token}}:percentage:value:value:value
| As SKILL_RATES for individual skills. Requires CAN_LEARN or INTELLIGENT to function.

|-
| 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. Requires CAN_LEARN or INTELLIGENT to function.

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

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

|-
| SLOW_LEARNER
|
| 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 "remains" instead of a corpse.

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

|-
| SOUND
|
| Creature makes sounds.

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

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

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

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

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

|}

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

==T==
{| {{prettytable}}
|- bgcolor="#ddd"
! width="20%" | Token
! width="20%" | Arguments
! width="60%" | Description
|-
| TENDONS
|
* {{L|material token}}
*healing rate
| Defines the material and healing rate of tendons.

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

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

|-
| TITAN
|
| Found on {{L|titan}}s.

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

|-
| 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 generated {{L|demon}}s; causes the game to create a single named instance of the demon which will emerge from the underworld and take over civilizations during worldgen. Cannot be used for modder-defined creatures.

|-
| USE_CASTE
|
*new caste token
*old caste token
| Defines a new caste derived directly from a previous caste. The new caste inherits all properties of the old one. The effect of this tag is automatic if one has not yet defined any castes: "Any caste-level tag that occurs before castes are explicitly declared is saved up and placed on any caste that is declared later, unless the caste is explicitly derived from another caste."

|-
| USE_MATERIAL
|
*new material token
*old material id
| Defines a new local creature material and populates it with all properties defined in the specified material. Old material id accepts any valid material id, including INORGANIC:X, CREATURE_MAT:C:X, LOCAL_CREATURE_MAT:X, and others (where X is a material id from that set, and C is a valid creature id).{{verify}}

|-
| USE_MATERIAL_TEMPLATE
|
*new material token
*material template
| Defines a new local creature material and populates it with all properties defined in the specified template.

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

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

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

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

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

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

|-
| VERMIN_HATEABLE
|
| 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 in baited animal traps; however, a "catch live land animal" task may still be able to capture one if a dwarf finds one roaming around.

|-
| VERMIN_ROTTER
|
| 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
|
| Implies AT_PEACE_WITH_WILDLIFE, RETURNS_VERMIN_KILLS_TO_OWNER, HUNTS_VERMIN, and ADOPTS_OWNER.

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

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

<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
|
* {{L|material token}}
| Allows the creature to create webs, and defines what the webs are made of.

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

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

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

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

|-
| ATTACK_CONTACT_PERC
|
*% value
| amount of available tissue used in 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_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").

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

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

|-
| ATTACK_FLAG_EDGE
|
| attack type

|-
| SPECIALATTACK_INJECT_EXTRACT
|
* {{L|material token}}
*state (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.
|}

==Important Related Tokens==
These next groups of tokens include several tokens that are not technically classified as creature tokens in string dump, but bear mentioning in this as they are used frequently in creature raws. (Some regular creature tokens may also be reprinted for the sake of ease of navigation)

===Tissue Modification===
This next group of tokens deals setting and modifying tissue properties. (See also {{L|Tissue definition token}})

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

|-
| INSULATION
|
*value
| Tissue supplies the creature with heat insulation. Higher values result in more insulation.

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

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

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

|-
| 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_OVER
|
*BY_TYPE, BY_CATEGORY, BY_TOKEN
*TYPE,CATEGORY, or TOKEN
*TISSUE
*LOCATION
| Presumably a counterpart to TISSUE_LAYER_UNDER (see below).

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

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

|-
| TISSUE_LEAKS
|
| The selected tissue leaks out of the creature when the layers above it are pierced. As per an iron man's internal poison gas.

|-
| TISSUE_MATERIAL
|
*VALUE (material)
*MATERIAL (material subtype)
| Defines the tissue material. VALUE can be LOCAL_CREATURE_MAT, INORGANIC etc. MATERIAL is a subtype of the material, e.g. [TISSUE_MATERIAL:INORGANIC:BRONZE]

|-
| 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_CONNECTS
|
| Presumably gives the CONNECTS attribute to selected layers.

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

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

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

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

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

|}

==See Also==
*{{L|Body detail plan token}}
*{{L|Body token}}
*{{L|Material definition token}}
*{{L|Syndrome}}
*{{L|Tissue definition token}}

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

v0.31:Creature token

2011-05-14T15:47:27Z

3: /* U */ USE_CASTE, typo

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

A full list of all known creature tokens.

__NOTOC__

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

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

|-
| ADOPTS_OWNER
|
| Tame creature cannot be made available for adoption, instead automatically adopting whoever it wants.

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

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

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

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

|-
| ATTACK_TRIGGER
| pop:exported wealth:created wealth
| Specifies when a {{L|megabeast}} will attack the fortress.

|}

<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|elephant}}s), which will generally avoid dwarves, although they may chase and/or attack them if they get too close).

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

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

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

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

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

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

|-
| 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
|
| Found on generated {{L|demon}}s; sets the creature as potential {{L|hell}} spawn

|-
| 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
|
* {{L|material token}}
*state (SOLID, LIQUID, or GAS)
| Egg material. Egg-laying creatures will define this 3 times, using LOCAL_CREATURE_MAT:EGGSHELL, LOCAL_CREATURE_MAT:EGG_WHITE, and then LOCAL_CREATURE_MAT:EGG_YOLK. Eggs will be made out of eggshell. Edibility is determined by tags on whites or yolk, but they otherwise do not exist.

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

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

|-
| EXTRACT
|
* {{L|material token}}
| Defines a creature extract which can be obtained via {{L|small animal dissection}}.

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

|-
| FEATURE_BEAST
|
| Found on {{L|forgotten beast}}s.

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

|-
| 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]. Not to be confused with POP_RATIO
|}

<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 {{L|Forgotten beast}}s, (biome name) {{L|titan}}s, {{L|Demon}}s, and {{L|night creature}}s.

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

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

|-
| 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
|
| When using tags from an existing creature, inserts new tags at the end of the creature.

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

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

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

|-
| GRASSTRAMPLE
| value
| Determines the percentage chance (or possibly wait time until next trample) of trampling and killing grass when a creature steps on it. Delete the tag to make the creature never trample grass.

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

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

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

==H==
{| {{prettytable}}
|- bgcolor="#ddd"
! width="20%" | Token
! width="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, GIANT_NEST, 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.

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

|-
| HIVE_PRODUCT
|
*number
*{{L|time}}
*{{L|item token}}s
| What product is harvested from {{L|Beekeeping industry|beekeeping}}.

|-
| HOMEOTHERM
|
| Default 'NONE'. The creature's normal body {{L|temperature}}

|-
| HUNTS_VERMIN
|
| Creature hunts and kills nearby vermin.

|}

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

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

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

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

|-
| ITEMCORPSE
|
* {{L|item token}}:subtype
* {{L|material token}}
| Determines if the creature leaves behind a non-standard corpse (i.e. wood, statue, bars, ash from ghost etc).

|-
| 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, WILDERNESS_LOCATION, 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
|
* {{L|item token}}
* {{L|material token}}
| Creature lays a particular item instead of regular eggs.

|-
| LIGAMENTS
|
* {{L|material token}}
*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

|-
| MAGICAL
|
| Unknown.

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

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

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

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

|-
| MATERIAL_BREATH_ATTACK
|
* {{L|material token}}
* breath attack type (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.

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

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

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

|-
| MEGABEAST
|
| Appears on fortress territory in Fortress Mode occasionally. Can also 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 to prevent rust entirely.

|-
| MILKABLE
|
* {{L|material token}}
* frequency
| 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."

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

|-
| 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. Requires CAN_LEARN or INTELLIGENT to function.

|-
| 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_GENDER
|
| Creature has no gender.

|-
| 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
|
| Creatures doesn't require an organ with the [THOUGHT] tag to survive; generally used on creatures that don't have brains.

|-
| 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. Creatures with this tag never wake up from sleep in Fortress Mode and stay drowsy. If this creature must eat and drink while playing, it WILL die.

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

|-
| PETVALUE_DIVISOR
| value
| Divides the creature's PETVALUE by the specified number. Used for bees to prevent a single hive from being worth a fortune.

|-
|PHYS_ATT_CAP_PERC
|
*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. Presumably used immediately after SET_BP_GROUP.

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

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

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

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

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

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

==R==
{| {{prettytable}}
|- bgcolor="#ddd"
! width="20%" | Token
! width="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
| singular:plural
| What creature's remains are called.

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

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

|-
| REMAINS_UNDETERMINED
|
| Unknown.

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

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

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

|}

<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
|
* {{L|material token}}
*Material State
*location secreted from (by_type, by_category, by_token)
*body part
*tissue layer
| creates a secreted material on given tissue on a given part of the body.

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

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

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

|-
| 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
| Begins a selection of body parts.

|-
| 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
|
* property
* growth rate?
| Tissue layer can be sheared for its component material. Tissue layer must have certain modifiers, with LENGTH being the only one known to work.

|-
| SKILL_LEARN_RATE
| {{L|skill_token}}:percentage
| The rate at which this creature learns this skill. Requires CAN_LEARN or INTELLIGENT to function.

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

|-
| SKILL_RATE
| {{L|skill_token}}:percentage:value:value:value
| As SKILL_RATES for individual skills. Requires CAN_LEARN or INTELLIGENT to function.

|-
| 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. Requires CAN_LEARN or INTELLIGENT to function.

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

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

|-
| SLOW_LEARNER
|
| 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 "remains" instead of a corpse.

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

|-
| SOUND
|
| Creature makes sounds.

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

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

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

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

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

|}

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

==T==
{| {{prettytable}}
|- bgcolor="#ddd"
! width="20%" | Token
! width="20%" | Arguments
! width="60%" | Description
|-
| TENDONS
|
* {{L|material token}}
*healing rate
| Defines the material and healing rate of tendons.

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

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

|-
| TITAN
|
| Found on {{L|titan}}s.

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

|-
| 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 generated {{L|demon}}s; causes the game to create a single named instance of the demon which will emerge from the underworld and take over civilizations during worldgen. Cannot be used for modder-defined creatures.

|-
| USE_CASTE
|
*new caste token
*old caste token
| Defines a new caste derived directly from a previous caste. The new caste inherits all properties of the old one. The effect of this tag is automatic if one has not yet defined any castes: "Any caste-level tag that occurs before castes are explicitly declared is saved up and placed on any caste that is declared later, unless the caste is explicitly derived from another caste."

|-
| USE_MATERIAL
|
*new material token
*old material id
| Defines a new local creature material and populates it with all properties defined in the specified material. Old material id accepts any valid material id, including INORGANIC:X, CREATURE_MAT:C:X, LOCAL_CREATURE_MAT:X, and others (where X is a material id from that set, and C is a valid creature id).{{verify}}

|-
| USE_MATERIAL_TEMPLATE
|
*new material token
*material template
| Defines a new local creature material and populates it with all properties defined in the specified template.

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

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

|-
| VERMIN_BITE
|
*amount
*verb (bitten, stung)
* {{L|material token}}
| 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 in baited animal traps; however, a "catch live land animal" task may still be able to capture one if a dwarf finds one roaming around.

|-
| VERMIN_ROTTER
|
| 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
|
| Implies AT_PEACE_WITH_WILDLIFE, RETURNS_VERMIN_KILLS_TO_OWNER, HUNTS_VERMIN, and ADOPTS_OWNER.

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

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

<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
|
* {{L|material token}}
| Allows the creature to create webs, and defines what the webs are made of.

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

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

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

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

|-
| ATTACK_CONTACT_PERC
|
*% value
| amount of available tissue used in 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_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").

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

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

|-
| ATTACK_FLAG_EDGE
|
| attack type

|-
| SPECIALATTACK_INJECT_EXTRACT
|
* {{L|material token}}
*state (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.
|}

==Important Related Tokens==
These next groups of tokens include several tokens that are not technically classified as creature tokens in string dump, but bear mentioning in this as they are used frequently in creature raws. (Some regular creature tokens may also be reprinted for the sake of ease of navigation)

===Tissue Modification===
This next group of tokens deals setting and modifying tissue properties. (See also {{L|Tissue definition token}})

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

|-
| INSULATION
|
*value
| Tissue supplies the creature with heat insulation. Higher values result in more insulation.

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

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

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

|-
| 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_OVER
|
*BY_TYPE, BY_CATEGORY, BY_TOKEN
*TYPE,CATEGORY, or TOKEN
*TISSUE
*LOCATION
| Presumably a counterpart to TISSUE_LAYER_UNDER (see below).

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

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

|-
| TISSUE_LEAKS
|
| The selected tissue leaks out of the creature when the layers above it are pierced. As per an iron man's internal poison gas.

|-
| TISSUE_MATERIAL
|
*VALUE (material)
*MATERIAL (material subtype)
| Defines the tissue material. VALUE can be LOCAL_CREATURE_MAT, INORGANIC etc. MATERIAL is a subtype of the material, e.g. [TISSUE_MATERIAL:INORGANIC:BRONZE]

|-
| 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_CONNECTS
|
| Presumably gives the CONNECTS attribute to selected layers.

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

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

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

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

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

|}

==See Also==
*{{L|Body detail plan token}}
*{{L|Body token}}
*{{L|Material definition token}}
*{{L|Syndrome}}
*{{L|Tissue definition token}}

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

v0.31:Creature token

2011-05-14T15:41:51Z

3: /* U */ Verfied usage of USE_TISSUE, gave it a proper description

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

A full list of all known creature tokens.

__NOTOC__

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

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

|-
| ADOPTS_OWNER
|
| Tame creature cannot be made available for adoption, instead automatically adopting whoever it wants.

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

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

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

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

|-
| ATTACK_TRIGGER
| pop:exported wealth:created wealth
| Specifies when a {{L|megabeast}} will attack the fortress.

|}

<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|elephant}}s), which will generally avoid dwarves, although they may chase and/or attack them if they get too close).

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

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

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

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

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

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

|-
| 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
|
| Found on generated {{L|demon}}s; sets the creature as potential {{L|hell}} spawn

|-
| 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
|
* {{L|material token}}
*state (SOLID, LIQUID, or GAS)
| Egg material. Egg-laying creatures will define this 3 times, using LOCAL_CREATURE_MAT:EGGSHELL, LOCAL_CREATURE_MAT:EGG_WHITE, and then LOCAL_CREATURE_MAT:EGG_YOLK. Eggs will be made out of eggshell. Edibility is determined by tags on whites or yolk, but they otherwise do not exist.

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

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

|-
| EXTRACT
|
* {{L|material token}}
| Defines a creature extract which can be obtained via {{L|small animal dissection}}.

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

|-
| FEATURE_BEAST
|
| Found on {{L|forgotten beast}}s.

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

|-
| 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]. Not to be confused with POP_RATIO
|}

<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 {{L|Forgotten beast}}s, (biome name) {{L|titan}}s, {{L|Demon}}s, and {{L|night creature}}s.

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

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

|-
| 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
|
| When using tags from an existing creature, inserts new tags at the end of the creature.

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

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

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

|-
| GRASSTRAMPLE
| value
| Determines the percentage chance (or possibly wait time until next trample) of trampling and killing grass when a creature steps on it. Delete the tag to make the creature never trample grass.

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

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

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

==H==
{| {{prettytable}}
|- bgcolor="#ddd"
! width="20%" | Token
! width="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, GIANT_NEST, 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.

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

|-
| HIVE_PRODUCT
|
*number
*{{L|time}}
*{{L|item token}}s
| What product is harvested from {{L|Beekeeping industry|beekeeping}}.

|-
| HOMEOTHERM
|
| Default 'NONE'. The creature's normal body {{L|temperature}}

|-
| HUNTS_VERMIN
|
| Creature hunts and kills nearby vermin.

|}

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

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

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

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

|-
| ITEMCORPSE
|
* {{L|item token}}:subtype
* {{L|material token}}
| Determines if the creature leaves behind a non-standard corpse (i.e. wood, statue, bars, ash from ghost etc).

|-
| 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, WILDERNESS_LOCATION, 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
|
* {{L|item token}}
* {{L|material token}}
| Creature lays a particular item instead of regular eggs.

|-
| LIGAMENTS
|
* {{L|material token}}
*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

|-
| MAGICAL
|
| Unknown.

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

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

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

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

|-
| MATERIAL_BREATH_ATTACK
|
* {{L|material token}}
* breath attack type (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.

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

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

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

|-
| MEGABEAST
|
| Appears on fortress territory in Fortress Mode occasionally. Can also 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 to prevent rust entirely.

|-
| MILKABLE
|
* {{L|material token}}
* frequency
| 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."

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

|-
| 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. Requires CAN_LEARN or INTELLIGENT to function.

|-
| 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_GENDER
|
| Creature has no gender.

|-
| 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
|
| Creatures doesn't require an organ with the [THOUGHT] tag to survive; generally used on creatures that don't have brains.

|-
| 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. Creatures with this tag never wake up from sleep in Fortress Mode and stay drowsy. If this creature must eat and drink while playing, it WILL die.

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

|-
| PETVALUE_DIVISOR
| value
| Divides the creature's PETVALUE by the specified number. Used for bees to prevent a single hive from being worth a fortune.

|-
|PHYS_ATT_CAP_PERC
|
*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. Presumably used immediately after SET_BP_GROUP.

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

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

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

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

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

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

==R==
{| {{prettytable}}
|- bgcolor="#ddd"
! width="20%" | Token
! width="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
| singular:plural
| What creature's remains are called.

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

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

|-
| REMAINS_UNDETERMINED
|
| Unknown.

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

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

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

|}

<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
|
* {{L|material token}}
*Material State
*location secreted from (by_type, by_category, by_token)
*body part
*tissue layer
| creates a secreted material on given tissue on a given part of the body.

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

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

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

|-
| 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
| Begins a selection of body parts.

|-
| 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
|
* property
* growth rate?
| Tissue layer can be sheared for its component material. Tissue layer must have certain modifiers, with LENGTH being the only one known to work.

|-
| SKILL_LEARN_RATE
| {{L|skill_token}}:percentage
| The rate at which this creature learns this skill. Requires CAN_LEARN or INTELLIGENT to function.

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

|-
| SKILL_RATE
| {{L|skill_token}}:percentage:value:value:value
| As SKILL_RATES for individual skills. Requires CAN_LEARN or INTELLIGENT to function.

|-
| 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. Requires CAN_LEARN or INTELLIGENT to function.

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

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

|-
| SLOW_LEARNER
|
| 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 "remains" instead of a corpse.

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

|-
| SOUND
|
| Creature makes sounds.

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

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

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

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

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

|}

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

==T==
{| {{prettytable}}
|- bgcolor="#ddd"
! width="20%" | Token
! width="20%" | Arguments
! width="60%" | Description
|-
| TENDONS
|
* {{L|material token}}
*healing rate
| Defines the material and healing rate of tendons.

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

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

|-
| TITAN
|
| Found on {{L|titan}}s.

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

|-
| 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 generated {{L|demon}}s; causes the game to create a single named instance of the demon which will emerge from the underworld and take over civilizations during worldgen. Cannot be used for modder-defined creatures.

|-
| USE_CASTE
|
*caste token
|

|-
| USE_MATERIAL
|
*new material token
*old material id
| Definew a new local creature material and populates it with all properties defined in the specified material. Old material id accepts any valid material id, including INORGANIC:X, CREATURE_MAT:C:X, LOCAL_CREATURE_MAT:X, and others (where X is a material id from that set, and C is a valid creature id).{{verify}}

|-
| USE_MATERIAL_TEMPLATE
|
*new material token
*material template
| Defines a new local creature material and populates it with all properties defined in the specified template.

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

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

|-
| VERMIN_BITE
|
*amount
*verb (bitten, stung)
* {{L|material token}}
| 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 in baited animal traps; however, a "catch live land animal" task may still be able to capture one if a dwarf finds one roaming around.

|-
| VERMIN_ROTTER
|
| 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
|
| Implies AT_PEACE_WITH_WILDLIFE, RETURNS_VERMIN_KILLS_TO_OWNER, HUNTS_VERMIN, and ADOPTS_OWNER.

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

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

<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
|
* {{L|material token}}
| Allows the creature to create webs, and defines what the webs are made of.

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

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

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

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

|-
| ATTACK_CONTACT_PERC
|
*% value
| amount of available tissue used in 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_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").

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

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

|-
| ATTACK_FLAG_EDGE
|
| attack type

|-
| SPECIALATTACK_INJECT_EXTRACT
|
* {{L|material token}}
*state (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.
|}

==Important Related Tokens==
These next groups of tokens include several tokens that are not technically classified as creature tokens in string dump, but bear mentioning in this as they are used frequently in creature raws. (Some regular creature tokens may also be reprinted for the sake of ease of navigation)

===Tissue Modification===
This next group of tokens deals setting and modifying tissue properties. (See also {{L|Tissue definition token}})

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

|-
| INSULATION
|
*value
| Tissue supplies the creature with heat insulation. Higher values result in more insulation.

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

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

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

|-
| 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_OVER
|
*BY_TYPE, BY_CATEGORY, BY_TOKEN
*TYPE,CATEGORY, or TOKEN
*TISSUE
*LOCATION
| Presumably a counterpart to TISSUE_LAYER_UNDER (see below).

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

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

|-
| TISSUE_LEAKS
|
| The selected tissue leaks out of the creature when the layers above it are pierced. As per an iron man's internal poison gas.

|-
| TISSUE_MATERIAL
|
*VALUE (material)
*MATERIAL (material subtype)
| Defines the tissue material. VALUE can be LOCAL_CREATURE_MAT, INORGANIC etc. MATERIAL is a subtype of the material, e.g. [TISSUE_MATERIAL:INORGANIC:BRONZE]

|-
| 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_CONNECTS
|
| Presumably gives the CONNECTS attribute to selected layers.

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

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

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

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

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

|}

==See Also==
*{{L|Body detail plan token}}
*{{L|Body token}}
*{{L|Material definition token}}
*{{L|Syndrome}}
*{{L|Tissue definition token}}

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

v0.31:Body detail plan token

2011-02-23T04:55:55Z

3: Added categories

{{av}}

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

|-
| ADD_MATERIAL
|
* identifier
* material template
| Adds a new material to the creature based on the specified template and assigned to the specified identifier.

|-
| ADD_TISSUE
|
* identifier
* tissue template
| Adds a new tissue to the creature based on the specified template and assigned to the specified identifier.

|-
| BODY_DETAIL_PLAN
|
| Begins defining a body detail plan for use in creature raws

|-
| BP_LAYERS
|
*BY_CATEGORY or BY_TYPE or BY_TOKEN
*body part
*tissue name or tissue ARG# for innermost tissue
*tissue thickness
*tissue name or tissue ARG# for second innermost tissue
*tissue thickness
*tissue name or tissue ARG# for second innermost tissue
*tissue thickness
etc...
| Defines a series of tissue layers. Alternatively to specifying a tissue, variable arguments can be entered (numbered arbitrarily) to be filled with tissues when the plan is called in the creature entry. Note that this token allows for the specification of tissue thickness, which otherwise cannot be done without adjusting the base tissue template or defining a tissue from scratch.{{verify}}

|-
| BP_LAYERS_OVER
|
| Works like BP_LAYERS, but defines layers over existing layers?

|-
| BP_LAYERS_UNDER
|
| Works like BP_LAYERS, but defines layers under existing layers?

|-
| BP_POSITION
|
*BY_CATEGORY or BY_TYPE or BY_TOKEN
*body part
*position token
| Defines a position for the specified body part (the nose is assigned the position FRONT, as it's on the front of the face). This has some effects on combat, attacks and the like. Valid position tokens are FRONT, BACK, SIDES, TOP and BOTTOM.

|-
| BP_RELATION
|
*BY_CATEGORY or BY_TYPE or BY_TOKEN
*body part to be affected
*relation token
*BY_CATEGORY or BY_TYPE or BY_TOKEN
*parent body part
*coverage
| Defines a positional relationship between one body part and another (the right eyelid is AROUND the right eye with coverage 50, as it only partially covers the eye). This has some effects on combat, attacks and the like. Valid relation tokens are AROUND, SURROUNDED_BY, ABOVE, BELOW, IN_FRONT, BEHIND, CLEANS, and CLEANED_BY. The lattermost two tokens are used when specifying parts that clean each other (such as eyelids to eyes).

|-
| BP_RELSIZE
|
*BY_CATEGORY (or, presumably, BY_TYPE or BY_TOKEN)
*body part
*relsize
| Defines a relsize for the selected body part for the current body detail plan

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

v0.31:Body detail plan token

2011-02-23T03:47:12Z

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

|-
| ADD_MATERIAL
|
* identifier
* material template
| Adds a new material to the creature based on the specified template and assigned to the specified identifier.

|-
| ADD_TISSUE
|
* identifier
* tissue template
| Adds a new tissue to the creature based on the specified template and assigned to the specified identifier.

|-
| BODY_DETAIL_PLAN
|
| Begins defining a body detail plan for use in creature raws

|-
| BP_LAYERS
|
*BY_CATEGORY or BY_TYPE or BY_TOKEN
*body part
*tissue name or tissue ARG# for innermost tissue
*tissue thickness
*tissue name or tissue ARG# for second innermost tissue
*tissue thickness
*tissue name or tissue ARG# for second innermost tissue
*tissue thickness
etc...
| Defines a series of tissue layers. Alternatively to specifying a tissue, variable arguments can be entered (numbered arbitrarily) to be filled with tissues when the plan is called in the creature entry. Note that this token allows for the specification of tissue thickness, which otherwise cannot be done without adjusting the base tissue template or defining a tissue from scratch.{{verify}}

|-
| BP_LAYERS_OVER
|
| Works like BP_LAYERS, but defines layers over existing layers?

|-
| BP_LAYERS_UNDER
|
| Works like BP_LAYERS, but defines layers under existing layers?

|-
| BP_POSITION
|
*BY_CATEGORY or BY_TYPE or BY_TOKEN
*body part
*position token
| Defines a position for the specified body part (the nose is assigned the position FRONT, as it's on the front of the face). This has some effects on combat, attacks and the like. Valid position tokens are FRONT, BACK, SIDES, TOP and BOTTOM.

|-
| BP_RELATION
|
*BY_CATEGORY or BY_TYPE or BY_TOKEN
*body part to be affected
*relation token
*BY_CATEGORY or BY_TYPE or BY_TOKEN
*parent body part
*coverage
| Defines a positional relationship between one body part and another (the right eyelid is AROUND the right eye with coverage 50, as it only partially covers the eye). This has some effects on combat, attacks and the like. Valid relation tokens are AROUND, SURROUNDED_BY, ABOVE, BELOW, IN_FRONT, BEHIND, CLEANS, and CLEANED_BY. The lattermost two tokens are used when specifying parts that clean each other (such as eyelids to eyes).

|-
| BP_RELSIZE
|
*BY_CATEGORY (or, presumably, BY_TYPE or BY_TOKEN)
*body part
*relsize
| Defines a relsize for the selected body part for the current body detail plan

v0.31:Body detail plan token

2011-02-23T03:42:20Z

3: Elaborated on several things

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

|-
| ADD_MATERIAL
|
* identifier
* material template
| Adds a new material to the creature based on the specified template and assigned to the specified identifier.

|-
| ADD_TISSUE
|
* identifier
* tissue template
| Adds a new tissue to the creature based on the specified template and assigned to the specified identifier.

|-
| BODY_DETAIL_PLAN
|
| Begins defining a body detail plan for use in creature raws

|-
| BP_LAYERS
|
*BY_CATEGORY or BY_TYPE or BY_TOKEN
*body part
*tissue name or tissue ARG# for innermost tissue
*tissue thickness
*tissue name or tissue ARG# for second innermost tissue
*tissue thickness
*tissue name or tissue ARG# for second innermost tissue
*tissue thickness
etc...
| Defines a series of tissue layers. Alternatively to specifying a tissue, variable arguments can be entered (numbered arbitrarily) to be filled with tissues when the plan is called in the creature entry. Note that this token allows for the specification of tissue thickness, which otherwise cannot be done without adjusting the base tissue template or defining a tissue from scratch.{{verify}}

|-
| BP_LAYERS_OVER
|
|

|-
| BP_LAYERS_UNDER
|
|

|-
| BP_POSITION
|
*BY_CATEGORY or BY_TYPE or BY_TOKEN
*body part
*position token
| Defines a position for the specified body part (the nose is assigned the position FRONT, as it's on the front of the face). This has some effects on combat, attacks and the like. Valid position tokens are FRONT, BACK, SIDES, TOP and BOTTOM.

|-
| BP_RELATION
|
*BY_CATEGORY or BY_TYPE or BY_TOKEN
*body part to be affected
*relation token
*BY_CATEGORY or BY_TYPE or BY_TOKEN
*parent body part
*coverage
| Defines a positional relationship between one body part and another (the right eyelid is AROUND the right eye with coverage 50, as it only partially covers the eye). This has some effects on combat, attacks and the like. Valid relation tokens are AROUND, SURROUNDED_BY, ABOVE, BELOW, IN_FRONT, BEHIND, CLEANS, and CLEANED_BY. The lattermost two tokens are used when specifying parts that clean each other (such as eyelids).

|-
| BP_RELSIZE
|
*BY_CATEGORY (or, presumably, BY_TYPE or BY_TOKEN)
*body part
*relsize
| Defines a relsize for the selected body part for the current body detail plan

v0.31:Tissue definition token

2011-02-21T20:16:33Z

{{quality|Tattered|08:00, 22 May 2010 (UTC)}}{{av}}

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

|-
| TISSUE_NAME
|
*name
*value
|name = name.
value = plural name, NP (No Plural) or STP (Standard Plural, adds an 's' on the end).

|-
| SCARS
| N/A
| Simply whether or not the tissue will be scarred once healed.

|-
| TISSUE_MATERIAL
|
*VALUE (material)
*MATERIAL (material subtype)
| Defines the tissue material. VALUE can be LOCAL_CREATURE_MAT, INORGANIC etc. MATERIAL is a subtype of the material, e.g. [TISSUE_MATERIAL:INORGANIC:BRONZE]

|-
| RELATIVE_THICKNESS
|
*value
| The thickness of the tissue. A higher thickness is harder to penetrate.

|-
| HEALING_RATE
|
*value
| Lower is faster. Omitting the token will result in a tissue that never heals.

|-
| VASCULAR
|
*value
| Related to how much said tissue bleeds. Higher = More bleeding
(Which is why the heart has the highest value.)

|-
| PAIN_RECEPTORS
|
*value
| Related to how much pain your character will suffer when said tissue is damaged. Higher = More pain when damaged
(Which is why the bone tissue has a much higher value than other tissues. A broken bone hurts a lot more than a cut.)

|-
| CONNECTS
|
|

|-
| TISSUE_SHAPE
|
*value
| Value can be LAYER, STRANDS or FEATHERS.

|-
| THICKENS_ON_ENERGY_STORAGE
| N/A
| Thickness of said tissue increases when the character eats?

|-
| THICKENS_ON_STRENGTH
| N/A
| The thickness of the tissue increases when character strength increases.

|-
| ARTERIES
| N/A
| The tissue contains arteries

|-
| MUSCULAR
| N/A
|

|-
| STRUCTURAL
| N/A
|

|-
| CONNECTIVE_TISSUE_ANCHOR
| N/A
|

|-
| SETTABLE
| N/A
| The tissue can be set if broken.

|-
| SPLINTABLE
| N/A
| The tissue can be wrapped in a splint if broken.

|-
| SUBORDINATE_TO_TISSUE
|
*value
|

|-
| COSMETIC
|
|

|-
| STYLEABLE
| N/A
| The tissue can be styled as per a tissue style (defined in an {{L|Entity_token|entity}} entry)

|-
| FUNCTIONAL
|
|

|-
| INSULATION
|
*value
| Tissue supplies the creature with heat insulation. Higher values result in more insulation.

|}

Default values (as of 0.31.14)
{| {{prettytable}} style="margin: 1em 1em 1em 0; background: #f9f9f9; border: 1px #aaa solid; border-collapse: collapse; font-size: 70%;"
|- bgcolor="#999999"
! style="font-size: 150%;"| TISSUE_TEMPLATE !! TISSUE_NAME !! TISSUE_MATERIAL !! TISSUE_MAT_STATE !! RELATIVE_THICKNESS !! HEALING_RATE !! VASCULAR !! PAIN_RECEPTORS !! SUBORDINATE_TO_TISSUE !! INSULATION !! TISSUE_SHAPE
|-
| SKIN_TEMPLATE || skin:NP || LOCAL_CREATURE_MAT:SKIN || || 1 || 100 || 1 || 5 || || || LAYER
|-
| FAT_TEMPLATE || fat:NP || LOCAL_CREATURE_MAT:FAT || || 1 || 100 || 3 || 5 || || 100 || LAYER
|-
| MUSCLE_TEMPLATE || muscle:muscles || LOCAL_CREATURE_MAT:MUSCLE || || 3 || 100 || 5 || 5 || || || LAYER
|-
| BONE_TEMPLATE || bone:NP || LOCAL_CREATURE_MAT:BONE || || 2 || 1000 || 3 || 50 || || || LAYER
|-
| SHELL_TEMPLATE || shell:NP || LOCAL_CREATURE_MAT:SHELL || || 2 || 1000 || || || || || LAYER
|-
| HORN_TEMPLATE || horn:NP || LOCAL_CREATURE_MAT:HORN || || 2 || || || || || || LAYER
|-
| HOOF_TEMPLATE || hoof:NP || LOCAL_CREATURE_MAT:HOOF || || 2 || || || || || || LAYER
|-
| CARTILAGE_TEMPLATE || cartilage:NP || LOCAL_CREATURE_MAT:CARTILAGE || || 2 || || || || || || LAYER
|-
| HAIR_TEMPLATE || hair:NP || LOCAL_CREATURE_MAT:HAIR || || 1 || || || || SKIN || 100 || STRANDS
|-
| CHEEK_WHISKERS_TEMPLATE || cheek whisker:STP || LOCAL_CREATURE_MAT:HAIR || || 2 || || || || SKIN || || STRANDS
|-
| CHIN_WHISKERS_TEMPLATE || chin whisker:STP || LOCAL_CREATURE_MAT:HAIR || || 2 || || || || SKIN || || STRANDS
|-
| MOUSTACHE_TEMPLATE || moustache:NP || LOCAL_CREATURE_MAT:HAIR || || 2 || || || || SKIN || || STRANDS
|-
| SIDEBURNS_TEMPLATE || sideburns:NP || LOCAL_CREATURE_MAT:HAIR || || 2 || || || || SKIN || || STRANDS
|-
| EYEBROW_TEMPLATE || eyebrow:NP || LOCAL_CREATURE_MAT:HAIR || || 2 || || || || SKIN || || STRANDS
|-
| EYELASH_TEMPLATE || eyelash:eyelashes || LOCAL_CREATURE_MAT:HAIR || || 2 || || || || SKIN || || STRANDS
|-
| FEATHER_TEMPLATE || feather:STP || LOCAL_CREATURE_MAT:FEATHER || || 2 || || || || SKIN || 100 || FEATHERS
|-
| SCALE_TEMPLATE || scale:STP || LOCAL_CREATURE_MAT:SCALE || || 1 || 100 || 1 || 5 || || || SCALES
|-
| NAIL_TEMPLATE || nail:NP || LOCAL_CREATURE_MAT:NAIL || || 2 || || || || || || LAYER
|-
| CLAW_TEMPLATE || claw:NP || LOCAL_CREATURE_MAT:CLAW || || 2 || || || || || || LAYER
|-
| TALON_TEMPLATE || talon:NP || LOCAL_CREATURE_MAT:TALON || || 2 || || || || || || LAYER
|-
| TOOTH_TEMPLATE || tooth:NP || LOCAL_CREATURE_MAT:TOOTH || || 2 || || || || || || LAYER
|-
| IVORY_TEMPLATE || ivory:NP || LOCAL_CREATURE_MAT:IVORY || || 2 || || || || || || LAYER
|-
| EYE_TEMPLATE || eye tissue:NP || LOCAL_CREATURE_MAT:EYE || || 1 || 100 || 3 || 5 || || || LAYER
|-
| NERVE_TEMPLATE || nervous tissue:NP || LOCAL_CREATURE_MAT:NERVE || || 1 || || 3 || || || || LAYER
|-
| BRAIN_TEMPLATE || brain tissue:NP || LOCAL_CREATURE_MAT:BRAIN || || 1 || || 3 || || || || LAYER
|-
| LUNG_TEMPLATE || lung tissue:NP || LOCAL_CREATURE_MAT:LUNG || || 1 || 100 || 8 || 5 || || || LAYER
|-
| HEART_TEMPLATE || heart tissue:NP || LOCAL_CREATURE_MAT:HEART || || 1 || 100 || 10 || 5 || || || LAYER
|-
| LIVER_TEMPLATE || liver tissue:NP || LOCAL_CREATURE_MAT:LIVER || || 1 || 100 || 8 || 5 || || || LAYER
|-
| GUT_TEMPLATE || gut:NP || LOCAL_CREATURE_MAT:GUT || || 1 || 100 || 3 || 5 || || || LAYER
|-
| STOMACH_TEMPLATE || stomach tissue:NP || LOCAL_CREATURE_MAT:STOMACH || || 1 || 100 || 3 || 5 || || || LAYER
|-
| PANCREAS_TEMPLATE || pancreatic tissue:NP || LOCAL_CREATURE_MAT:PANCREAS || || 1 || 100 || 3 || 5 || || || LAYER
|-
| SPLEEN_TEMPLATE || spleen tissue:NP || LOCAL_CREATURE_MAT:SPLEEN || || 1 || 100 || 5 || 5 || || || LAYER
|-
| KIDNEY_TEMPLATE || kidney tissue:NP || LOCAL_CREATURE_MAT:KIDNEY || || 1 || 100 || 8 || 5 || || || LAYER
|-
| FLAME_TEMPLATE || flames:NP || LOCAL_CREATURE_MAT:FLAME || GAS || 1 || || || || || || LAYER
|-
| CHITIN_TEMPLATE || chitin:NP || LOCAL_CREATURE_MAT:CHITIN || || 1 || 100 || 1 || 5 || || || LAYER
|- bgcolor="#999999"
! style="font-size: 150%;"| TISSUE_TEMPLATE !! TISSUE_NAME !! TISSUE_MATERIAL !! TISSUE_MAT_STATE !! RELATIVE_THICKNESS !! HEALING_RATE !! VASCULAR !! PAIN_RECEPTORS !! SUBORDINATE_TO_TISSUE !! INSULATION !! TISSUE_SHAPE
|}

Default flags (as of 0.31.14)
{| {{prettytable}}
|- bgcolor="#999999" style="font-size: 70%;"
! style="font-size: 150%;"| TISSUE_TEMPLATE !! THICKENS_ON_ENERGY_STORAGE !! THICKENS_ON_STRENGTH !! ARTERIES !! SCARS !! MUSCULAR !! FUNCTIONAL !! STRUCTURAL !! CONNECTIVE_TISSUE_ANCHOR !! CONNECTS !! SETTABLE !! SPLINTABLE !! COSMETIC !! STYLEABLE
|-
| SKIN_TEMPLATE || || || || X || || || || || X || || || ||
|-
| FAT_TEMPLATE || X || || || X || || || || || X || || || ||
|-
| MUSCLE_TEMPLATE || || X || X || X || X || || || || X || || ||
|-
| BONE_TEMPLATE || || || || || || || X || X || X || X || X || ||
|-
| SHELL_TEMPLATE || || || || || || || X || || X || X || X || ||
|-
| HORN_TEMPLATE || || || || || || || X || || X || || ||
|-
| HOOF_TEMPLATE || || || || || || || X || || X || || ||
|-
| CARTILAGE_TEMPLATE || || || || || || || X || || X || || ||
|-
| HAIR_TEMPLATE || || || || || || || || || || || || X || X
|-
| CHEEK_WHISKERS_TEMPLATE || || || || || || || || || || || || X || X
|-
| CHIN_WHISKERS_TEMPLATE || || || || || || || || || || || || X || X
|-
| MOUSTACHE_TEMPLATE || || || || || || || || || || || || X || X
|-
| SIDEBURNS_TEMPLATE || || || || || || || || || || || || X || X
|-
| EYEBROW_TEMPLATE || || || || || || || || || || || || X || X
|-
| EYELASH_TEMPLATE || || || || || || || || || || || || X || X
|-
| FEATHER_TEMPLATE || || || || || || || || || || || ||
|-
| SCALE_TEMPLATE || || || || X || || || || || X || || || ||
|-
| NAIL_TEMPLATE || || || || || || || X || || X || || || ||
|-
| CLAW_TEMPLATE || || || || || || || X || || X || || || ||
|-
| TALON_TEMPLATE || || || || || || || X || || X || || || ||
|-
| TOOTH_TEMPLATE || || || || || || || X || || X || || || ||
|-
| IVORY_TEMPLATE || || || || || || || X || || X || || || ||
|-
| EYE_TEMPLATE || || || || X || X || X || X || || || || ||
|-
| NERVE_TEMPLATE || || || || X || || X || X || || || || ||
|-
| BRAIN_TEMPLATE || || || || X || X || X || X || || || || ||
|-
| LUNG_TEMPLATE || || || || X || X || X || X || || || || ||
|-
| HEART_TEMPLATE || || || || X || X || X || X || || || || ||
|-
| LIVER_TEMPLATE || || || || X || X || X || X || || || || ||
|-
| GUT_TEMPLATE || || || || X || X || X || X || || || || ||
|-
| STOMACH_TEMPLATE || || || || X || X || X || X || || || || ||
|-
| PANCREAS_TEMPLATE || || || || X || X || X || X || || || || ||
|-
| SPLEEN_TEMPLATE || || || || X || X || X || X || || || || ||
|-
| KIDNEY_TEMPLATE || || || || X || X || X || X || || || || ||
|-
| FLAME_TEMPLATE || || || || || X || X || X || || X || || ||
|-
| CHITIN_TEMPLATE || || || || X || || || X || X || X || X || X || ||

|- bgcolor="#999999" style="font-size: 70%;"
! style="font-size: 150%;"| TISSUE_TEMPLATE !! THICKENS_ON_ENERGY_STORAGE !! THICKENS_ON_STRENGTH !! ARTERIES !! SCARS !! MUSCULAR !! FUNCTIONAL !! STRUCTURAL !! CONNECTIVE_TISSUE_ANCHOR !! CONNECTS !! SETTABLE !! SPLINTABLE !! COSMETIC !! STYLEABLE
|}

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

Tissue template token

2011-02-21T20:05:15Z

3: Fixing redirect

#REDIRECT [[cv:Tissue definition token]]

v0.31:Tissue template token

2011-02-21T20:02:06Z

3: moved DF2010:Tissue template token to DF2010:Tissue definition token: Misleading page title - tissues can be defined in-creature as well as in templates (see bronze colossus etc).

#REDIRECT [[DF2010:Tissue definition token]]

v0.31:Tissue definition token

2011-02-21T20:02:06Z

3: moved DF2010:Tissue template token to DF2010:Tissue definition token: Misleading page title - tissues can be defined in-creature as well as in templates (see bronze colossus etc).

{{quality|Tattered|08:00, 22 May 2010 (UTC)}}{{av}}

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

|-
| TISSUE_NAME
|
*name
*value
|name = name.
value = plural name, NP (No Plural) or STP (Standard Plural, adds an 's' on the end).

|-
| SCARS
| N/A
| Simply whether or not the tissue will be scarred once healed.

|-
| TISSUE_MATERIAL
|
*VALUE (material)
*MATERIAL (material subtype)
| Defines the tissue material. VALUE can be LOCAL_CREATURE_MAT, INORGANIC etc. MATERIAL is a subtype of the material, e.g. [TISSUE_MATERIAL:INORGANIC:BRONZE]

|-
| RELATIVE_THICKNESS
|
*value
|The thickness of the tissue. A higher thickness is harder to penetrate.

|-
| HEALING_RATE
|
*value
| Lower is faster.

|-
| VASCULAR
|
*value
| Seems be related to how much said tissue bleeds. Higher = More bleeding
(Which is why the heart has the highest value.)

|-
| PAIN_RECEPTORS
|
*value
| Related to how much pain your character will suffer when said tissue is damaged. Higher = More pain when damaged
(Which is why the bone tissue has a much higher value than other tissues. A broken bone hurts a lot more than a cut.)

|-
| CONNECTS
|
|

|-
| TISSUE_SHAPE
|
*value
|value can be LAYER, STRANDS or FEATHERS.

|-
| THICKENS_ON_ENERGY_STORAGE
| N/A
| Thickness of said tissue increases when the character eats?

|-
| THICKENS_ON_STRENGTH
| N/A
| The thickness of the tissue increases when character strength increases.

|-
| ARTERIES
| N/A
| The tissue contains arteries

|-
| MUSCULAR
| N/A
|

|-
| STRUCTURAL
| N/A
|

|-
| CONNECTIVE_TISSUE_ANCHOR
| N/A
|

|-
| SETTABLE
| N/A
| The tissue can be set if broken.

|-
| SPLINTABLE
| N/A
| The tissue can be wrapped in a splint if broken.

|-
| SUBORDINATE_TO_TISSUE
|
*value
|

|-
| COSMETIC
|
|

|-
| STYLEABLE
|
|

|-
| FUNCTIONAL
|
|

|-
| INSULATION
|
*value
|

|}

Default values (as of 0.31.14)
{| {{prettytable}} style="margin: 1em 1em 1em 0; background: #f9f9f9; border: 1px #aaa solid; border-collapse: collapse; font-size: 70%;"
|- bgcolor="#999999"
! style="font-size: 150%;"| TISSUE_TEMPLATE !! TISSUE_NAME !! TISSUE_MATERIAL !! TISSUE_MAT_STATE !! RELATIVE_THICKNESS !! HEALING_RATE !! VASCULAR !! PAIN_RECEPTORS !! SUBORDINATE_TO_TISSUE !! INSULATION !! TISSUE_SHAPE
|-
| SKIN_TEMPLATE || skin:NP || LOCAL_CREATURE_MAT:SKIN || || 1 || 100 || 1 || 5 || || || LAYER
|-
| FAT_TEMPLATE || fat:NP || LOCAL_CREATURE_MAT:FAT || || 1 || 100 || 3 || 5 || || 100 || LAYER
|-
| MUSCLE_TEMPLATE || muscle:muscles || LOCAL_CREATURE_MAT:MUSCLE || || 3 || 100 || 5 || 5 || || || LAYER
|-
| BONE_TEMPLATE || bone:NP || LOCAL_CREATURE_MAT:BONE || || 2 || 1000 || 3 || 50 || || || LAYER
|-
| SHELL_TEMPLATE || shell:NP || LOCAL_CREATURE_MAT:SHELL || || 2 || 1000 || || || || || LAYER
|-
| HORN_TEMPLATE || horn:NP || LOCAL_CREATURE_MAT:HORN || || 2 || || || || || || LAYER
|-
| HOOF_TEMPLATE || hoof:NP || LOCAL_CREATURE_MAT:HOOF || || 2 || || || || || || LAYER
|-
| CARTILAGE_TEMPLATE || cartilage:NP || LOCAL_CREATURE_MAT:CARTILAGE || || 2 || || || || || || LAYER
|-
| HAIR_TEMPLATE || hair:NP || LOCAL_CREATURE_MAT:HAIR || || 1 || || || || SKIN || 100 || STRANDS
|-
| CHEEK_WHISKERS_TEMPLATE || cheek whisker:STP || LOCAL_CREATURE_MAT:HAIR || || 2 || || || || SKIN || || STRANDS
|-
| CHIN_WHISKERS_TEMPLATE || chin whisker:STP || LOCAL_CREATURE_MAT:HAIR || || 2 || || || || SKIN || || STRANDS
|-
| MOUSTACHE_TEMPLATE || moustache:NP || LOCAL_CREATURE_MAT:HAIR || || 2 || || || || SKIN || || STRANDS
|-
| SIDEBURNS_TEMPLATE || sideburns:NP || LOCAL_CREATURE_MAT:HAIR || || 2 || || || || SKIN || || STRANDS
|-
| EYEBROW_TEMPLATE || eyebrow:NP || LOCAL_CREATURE_MAT:HAIR || || 2 || || || || SKIN || || STRANDS
|-
| EYELASH_TEMPLATE || eyelash:eyelashes || LOCAL_CREATURE_MAT:HAIR || || 2 || || || || SKIN || || STRANDS
|-
| FEATHER_TEMPLATE || feather:STP || LOCAL_CREATURE_MAT:FEATHER || || 2 || || || || SKIN || 100 || FEATHERS
|-
| SCALE_TEMPLATE || scale:STP || LOCAL_CREATURE_MAT:SCALE || || 1 || 100 || 1 || 5 || || || SCALES
|-
| NAIL_TEMPLATE || nail:NP || LOCAL_CREATURE_MAT:NAIL || || 2 || || || || || || LAYER
|-
| CLAW_TEMPLATE || claw:NP || LOCAL_CREATURE_MAT:CLAW || || 2 || || || || || || LAYER
|-
| TALON_TEMPLATE || talon:NP || LOCAL_CREATURE_MAT:TALON || || 2 || || || || || || LAYER
|-
| TOOTH_TEMPLATE || tooth:NP || LOCAL_CREATURE_MAT:TOOTH || || 2 || || || || || || LAYER
|-
| IVORY_TEMPLATE || ivory:NP || LOCAL_CREATURE_MAT:IVORY || || 2 || || || || || || LAYER
|-
| EYE_TEMPLATE || eye tissue:NP || LOCAL_CREATURE_MAT:EYE || || 1 || 100 || 3 || 5 || || || LAYER
|-
| NERVE_TEMPLATE || nervous tissue:NP || LOCAL_CREATURE_MAT:NERVE || || 1 || || 3 || || || || LAYER
|-
| BRAIN_TEMPLATE || brain tissue:NP || LOCAL_CREATURE_MAT:BRAIN || || 1 || || 3 || || || || LAYER
|-
| LUNG_TEMPLATE || lung tissue:NP || LOCAL_CREATURE_MAT:LUNG || || 1 || 100 || 8 || 5 || || || LAYER
|-
| HEART_TEMPLATE || heart tissue:NP || LOCAL_CREATURE_MAT:HEART || || 1 || 100 || 10 || 5 || || || LAYER
|-
| LIVER_TEMPLATE || liver tissue:NP || LOCAL_CREATURE_MAT:LIVER || || 1 || 100 || 8 || 5 || || || LAYER
|-
| GUT_TEMPLATE || gut:NP || LOCAL_CREATURE_MAT:GUT || || 1 || 100 || 3 || 5 || || || LAYER
|-
| STOMACH_TEMPLATE || stomach tissue:NP || LOCAL_CREATURE_MAT:STOMACH || || 1 || 100 || 3 || 5 || || || LAYER
|-
| PANCREAS_TEMPLATE || pancreatic tissue:NP || LOCAL_CREATURE_MAT:PANCREAS || || 1 || 100 || 3 || 5 || || || LAYER
|-
| SPLEEN_TEMPLATE || spleen tissue:NP || LOCAL_CREATURE_MAT:SPLEEN || || 1 || 100 || 5 || 5 || || || LAYER
|-
| KIDNEY_TEMPLATE || kidney tissue:NP || LOCAL_CREATURE_MAT:KIDNEY || || 1 || 100 || 8 || 5 || || || LAYER
|-
| FLAME_TEMPLATE || flames:NP || LOCAL_CREATURE_MAT:FLAME || GAS || 1 || || || || || || LAYER
|-
| CHITIN_TEMPLATE || chitin:NP || LOCAL_CREATURE_MAT:CHITIN || || 1 || 100 || 1 || 5 || || || LAYER
|- bgcolor="#999999"
! style="font-size: 150%;"| TISSUE_TEMPLATE !! TISSUE_NAME !! TISSUE_MATERIAL !! TISSUE_MAT_STATE !! RELATIVE_THICKNESS !! HEALING_RATE !! VASCULAR !! PAIN_RECEPTORS !! SUBORDINATE_TO_TISSUE !! INSULATION !! TISSUE_SHAPE
|}

Default flags (as of 0.31.14)
{| {{prettytable}}
|- bgcolor="#999999" style="font-size: 70%;"
! style="font-size: 150%;"| TISSUE_TEMPLATE !! THICKENS_ON_ENERGY_STORAGE !! THICKENS_ON_STRENGTH !! ARTERIES !! SCARS !! MUSCULAR !! FUNCTIONAL !! STRUCTURAL !! CONNECTIVE_TISSUE_ANCHOR !! CONNECTS !! SETTABLE !! SPLINTABLE !! COSMETIC !! STYLEABLE
|-
| SKIN_TEMPLATE || || || || X || || || || || X || || || ||
|-
| FAT_TEMPLATE || X || || || X || || || || || X || || || ||
|-
| MUSCLE_TEMPLATE || || X || X || X || X || || || || X || || ||
|-
| BONE_TEMPLATE || || || || || || || X || X || X || X || X || ||
|-
| SHELL_TEMPLATE || || || || || || || X || || X || X || X || ||
|-
| HORN_TEMPLATE || || || || || || || X || || X || || ||
|-
| HOOF_TEMPLATE || || || || || || || X || || X || || ||
|-
| CARTILAGE_TEMPLATE || || || || || || || X || || X || || ||
|-
| HAIR_TEMPLATE || || || || || || || || || || || || X || X
|-
| CHEEK_WHISKERS_TEMPLATE || || || || || || || || || || || || X || X
|-
| CHIN_WHISKERS_TEMPLATE || || || || || || || || || || || || X || X
|-
| MOUSTACHE_TEMPLATE || || || || || || || || || || || || X || X
|-
| SIDEBURNS_TEMPLATE || || || || || || || || || || || || X || X
|-
| EYEBROW_TEMPLATE || || || || || || || || || || || || X || X
|-
| EYELASH_TEMPLATE || || || || || || || || || || || || X || X
|-
| FEATHER_TEMPLATE || || || || || || || || || || || ||
|-
| SCALE_TEMPLATE || || || || X || || || || || X || || || ||
|-
| NAIL_TEMPLATE || || || || || || || X || || X || || || ||
|-
| CLAW_TEMPLATE || || || || || || || X || || X || || || ||
|-
| TALON_TEMPLATE || || || || || || || X || || X || || || ||
|-
| TOOTH_TEMPLATE || || || || || || || X || || X || || || ||
|-
| IVORY_TEMPLATE || || || || || || || X || || X || || || ||
|-
| EYE_TEMPLATE || || || || X || X || X || X || || || || ||
|-
| NERVE_TEMPLATE || || || || X || || X || X || || || || ||
|-
| BRAIN_TEMPLATE || || || || X || X || X || X || || || || ||
|-
| LUNG_TEMPLATE || || || || X || X || X || X || || || || ||
|-
| HEART_TEMPLATE || || || || X || X || X || X || || || || ||
|-
| LIVER_TEMPLATE || || || || X || X || X || X || || || || ||
|-
| GUT_TEMPLATE || || || || X || X || X || X || || || || ||
|-
| STOMACH_TEMPLATE || || || || X || X || X || X || || || || ||
|-
| PANCREAS_TEMPLATE || || || || X || X || X || X || || || || ||
|-
| SPLEEN_TEMPLATE || || || || X || X || X || X || || || || ||
|-
| KIDNEY_TEMPLATE || || || || X || X || X || X || || || || ||
|-
| FLAME_TEMPLATE || || || || || X || X || X || || X || || ||
|-
| CHITIN_TEMPLATE || || || || X || || || X || X || X || X || X || ||

|- bgcolor="#999999" style="font-size: 70%;"
! style="font-size: 150%;"| TISSUE_TEMPLATE !! THICKENS_ON_ENERGY_STORAGE !! THICKENS_ON_STRENGTH !! ARTERIES !! SCARS !! MUSCULAR !! FUNCTIONAL !! STRUCTURAL !! CONNECTIVE_TISSUE_ANCHOR !! CONNECTS !! SETTABLE !! SPLINTABLE !! COSMETIC !! STYLEABLE
|}

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

v0.31:Raw file

2011-02-21T19:44:48Z

{{av}}
{{Quality|Fine}}
'''Raw files''' are text files found in the \raw\objects subfolder of Dwarf Fortress. These files can be looked through to discover various specifics of game items, materials, and creatures, and can be changed to alter how the game behaves. They are sometimes referred to by players as just "the raws".

The \raw\graphics subfolder of Dwarf Fortress is used to store user-customizable {{L|graphics sets|graphics sets}}.

Dwarf Fortress is not an open source program, so most {{L|modding|modding}} of the game is limited to altering the raws or doing {{L|memory hacking}}.

==Syntax of raw files==

filename

[OBJECT:TYPE]

[TYPE:ID]
<...contents...>

ID is an unique identificator for your type to use (i.e. [CREATURE:DOG], ID=DOG or [ITEM:ITEM_WEAPON_SWORD], ID=ITEM_WEAPON_SWORD).

===Types of content:===
*BODY - body parts and structures
*BODY_DETAIL_PLAN - similar to the following creature variation file type, but used for defining tokens related to body parts (specifically materials, tissues, the assignment thereof, and body part positions, relative sizes, etc.)
*BUILDING - custom workshops
*CREATURE - creatures
*CREATURE_VARIATION - variations that can be applied to creatures (eg, making them giants, or anthropomorphic). Technically a series of tokens that are added to or removed from the creature (essentially a set of templated changes)
*DESCRIPTOR_COLOR - named colours for use with DESCRIPTOR_PATTERN objects (other purposes unknown)
*DESCRIPTOR_PATTERN - patterns with colour combinations for use with creatures (other purposes unknown)
*DESCRIPTOR_SHAPE - shapes with descriptions and variations. Previous versions used this for engravings, but their use in the current version is unverified as of yet.
*ENTITY - civilization types, with assigned race, language, culture, ethics, and social structure.
*GRAPHICS - graphic tiles for creatures
*INORGANIC - inorganic material definitions.
*ITEM - items ranging from ammunition to food types, has secondary types for the purposes of [TYPE:ID]
**ITEM_AMMO - ammunition for ranged weapons
**ITEM_ARMOR - body clothing, including armour
**ITEM_FOOD - prepared food definitions
**ITEM_GLOVES - hand clothing, including armour
**ITEM_HELM - head clothing, including armour
**ITEM_INSTRUMENT - instrument definitions
**ITEM_PANTS - lower body clothing, including armour
**ITEM_SHIELD - shields (always armour?)
**ITEM_SHOES - foot clothing, including armour
**ITEM_SIEGEAMMO - ammunition for siege weapons (only ballista?)
**ITEM_TOY - toy definitions
**ITEM_TRAPCOMP - components that can be used in weapon traps (two special tags define trapcomps that can be used in other constructions: IS_SCREW and IS_SPIKE)
**ITEM_WEAPON - weapons that are used by soldiers, as well as digging tools
*LANGUAGE - word definitions for the languages used by ENTITY objects
**Entries beginning with [SYMBOL:ID] sort words into symbolic/poetic groups to be referenced by ENTITY preferences
**Entries beginning with [WORD:ID] define words and their alternate forms (in english)
*MATERIAL_TEMPLATE - definitions of information common to groups of materials (referenced all over the place)
*PLANT - definitions of plants, their materials, and their derivitives
*REACTION - reactions/custom workshop jobs (turn items into other items though dwarven effort)
*TISSUE_TEMPLATE - defines templated tissues for use with BODY_DETAIL_PLAN objects or in creatures

* usually the empty strings are used to divide different types of structures like the fine name
and [OBJECT:] or different entries, however everything which is not a token besides the 1st string
(which is the filename) is understood as comments and is not considered.

The tokens are enclosed in square brackets ([TOKEN:VALUES]).

When a world is generated, the raw files are moved from <game folder>/raw/ to <game folder>/data/save/REGION/raw/. It is currently unknown how much these can then be changed without breaking the save. Unlike [[40d:raw file|previous versions]] of the game, raw files are not "compiled" into the data/objects folder. Indeed, said folder does not exist.

A list of tokens can be seen at [[:Category:Tokens]].

[[Category:Files]]
{{Category|Modding}}

User talk:3

2011-01-23T06:53:59Z

==Butchering==
As a policy, we don't include butchering information if it's never actually possible to butcher the creature. --[[User:Quietust|Quietust]] 19:35, 22 January 2011 (UTC)

I thought as much. However, it might be useful to have that information on hand as it's common enough for people to enable sentient butchering (partially due to the never-decaying skeleton issue). --[[User:3|3]] 06:53, 23 January 2011 (UTC)

v0.31:Personality facet

2011-01-22T16:57:25Z

{{quality|Fine|14:52, 22 January 2011 (UTC)}}{{av}}

Dwarven personalities are determined by a set of traits. These traits are distinct from {{L|attributes}}.

Personality traits are shown in a dwarf's "thoughts and preferences" description page, which can be accessed by {{k|v}}iewing that dwarf then {{k|p}}, {{k|z}}, {{k|Enter}}, or from the {{k|u}}nit menu with {{k|v}}iew, {{k|Enter}}.

Each trait varies from 1 (lowest possible) to 100 (highest possible), but are categorised as below.

Traits are also influenced by species via the use of the PERSONALITY {{L|creature token}}. For example, dwarves are slightly more straightforward than average with a median of 55 in that trait, whereas goblins aren't likely to help others out - their altruism median is a mere 25, and is capped at 50.

Traits also have an effect on which social skills are learned in social interaction, and determine whether certain actions may give a good or bad {{L|thought}}. Traits may have other, more subtle effects on creature behaviour, which are currently not entirely understood.

{| {{prettytable}}
|- style="background:#ddd"
! Token
! Value
! Description
! Gameplay effects
|- style="border-top: 3px solid #aaa"
! rowspan=6 | ACHIEVEMENT_STRIVING
| 91 - 100
|Constantly strives for perfection.
|-
| 76 - 90
|Thinks it is incredibly important to strive for excellence.
|-
| 61 - 75
|Strives for excellence.
|-
| 25 - 39
|Doesn't go out of its/his/her way to do more work than necessary.
|-
| 10 - 24
|Very rarely does more work than necessary.
|-
| 0 - 9
|Does the bare minimum necessary to accomplish the task at hand.
|- style="border-top: 3px solid #aaa"
! rowspan=6 | ACTIVITY_LEVEL
| style="width:4em" | 91 - 100
| Is constantly active and energetic.
|-
| 76 - 90
| Is very energetic and active.
|-
| 61 - 75
| Is very active.
|-
| 25 - 39
| Is relaxed.
|-
| 10 - 24
| Lives life at a leisurely pace.
|-
| 0 - 9
| Can't be bothered with frantic, fast-paced living.
|- style="border-top: 3px solid #aaa"
! rowspan=6 | ADVENTUROUSNESS
| 91 - 100
| Is highly adventurous and loves fresh experiences.
|-
| 76 - 90
| Is eager for new experiences.
|-
| 61 - 75
| Likes to try new things.
|-
| 25 - 39
| Prefers familiar routines.
|-
| 10 - 24
| Is uncomfortable with change.
|-
| 0 - 9
| Is resistant to change.
|- style="border-top: 3px solid #aaa"
! rowspan=6 | ALTRUISM
| 91 - 100
| Is truly fulfilled by assisting those in need.
|-
| 76 - 90
| Finds helping others very rewarding.
|-
| 61 - 75
| Finds helping others rewarding.
|-
| 25 - 39
| Does not go out of its/his/her way to help others.
| rowspan=3 valign=top | Helping a {{L|wound|wounded}} dwarf<br>is a bad thought<br>at these levels.
|-
| 10 - 24
| colspan=1 | Dislikes helping others.
|-
| 0 - 9
| colspan=1 | Views helping others as an imposition on own needs to get along with others.
|- style="border-top: 3px solid #aaa"
! rowspan=6 | ANGER
| 91 - 100
| Is in a constant state of internal rage.
| rowspan=6 | Angry creatures will <br>become {{L|Status icon|enraged}} in<br>combat more commonly.<br>The very least angry<br>creatures will never<br>become enraged.
|-
| 76 - 90
| Is very quick to anger.
|-
| 61 - 75
| Is quick to anger.
|-
| 25 - 39
| Is slow to anger.
|-
| 10 - 24
| Is very slow to anger.
|-
| 0 - 9
| Never becomes angry.
|- style="border-top: 3px solid #aaa"
! rowspan=6 | ANXIETY
| 91 - 100
| Is a nervous wreck.
|-
| 76 - 90
| Is always tense and jittery.
|-
| 61 - 75
| Is often nervous.
|-
| 25 - 39
| Has a calm demeanor.
|-
| 10 - 24
| Has a very calm demeanor.
|-
| 0 - 9
| Has an incredibly calm demeanor.
|- style="border-top: 3px solid #aaa"
! rowspan=6 | ARTISTIC_INTEREST
| 91 - 100
| Can easily become absorbed in art and the beauty of the natural world.
|-
| 76 - 90
| Greatly appreciates art and natural beauty.
|-
| 61 - 75
| Appreciates art and natural beauty.
|-
| 25 - 39
| Does not have a great aesthetic sensitivity.
|-
| 10 - 24
| Is not interested in art.
|-
| 0 - 9
| Is completely uninterested in art.
|- style="border-top: 3px solid #aaa"
! rowspan=6 | ASSERTIVENESS
| 91 - 100
| Loves to take charge and direct activities.
|-
| 76 - 90
| Is very assertive.
|-
| 61 - 75
| Is assertive.
|-
| 25 - 39
| Is unassertive.
| rowspan=3 | An unassertive dwarf (under<br>40) never gains experience<br>in the {{L|Persuader}} skill.
|-
| 10 - 24
| Prefers that others handle the leadership roles.
|-
| 0 - 9
| Never speaks out or attempts to direct activities.
|- style="border-top: 3px solid #aaa"
! rowspan=6 | CAUTIOUSNESS
| 91 - 100
| Thinks through every alternatives and their consequences before acting.
|-
| 76 - 90
| Is extremely cautious.
|-
| 61 - 75
| Takes time when making decisions.
|-
| 25 - 39
| Often does the first thing that comes to mind.
|-
| 10 - 24
| Acts impulsively.
|-
| 0 - 9
| Always acts without considering alternatives or thinking through possibilities.
|- style="border-top: 3px solid #aaa"
! rowspan=6 | CHEERFULNESS
| 91 - 100
| Often feels filled with joy.
|-
| 76 - 90
| Can be very happy and optimistic.
|-
| 61 - 75
| Is often cheerful.
|-
| 25 - 39
| Is rarely happy or enthusiastic.
|-
| 10 - 24
| Is a pessimist.
|-
| 0 - 9
| Is never optimistic or enthusiastic about anything.
|- style="border-top: 3px solid #aaa"
! rowspan=6 | COOPERATION
| 91 - 100
| Sacrifices its/his/her own needs to get along with others.
| rowspan=3 | A cooperative dwarf (over 60)<br>never gains experience<br>in the {{L|Intimidator}} skill.
|-
| 76 - 90
| Dislikes confrontations.
|-
| 61 - 75
| Is willing to compromise with others.
|-
| 25 - 39
| Doesn't like to compromise with others.
| rowspan=3 | An uncooperative dwarf (under 40)<br>never gains experience<br>in the {{L|Pacifier}} skill.
|-
| 10 - 24
| Would rather intimidate others than compromise with them.
|-
| 0 - 9
| Would never deny its/his/her own needs just to compromise with somebody else.
|- style="border-top: 3px solid #aaa"
! rowspan=6 | DEPRESSION
| 91 - 100
| Is frequently depressed.
|-
| 76 - 90
| Is often sad and dejected.
|-
| 61 - 75
| Often feels discouraged.
|-
| 25 - 39
| Rarely feels discouraged.
|-
| 10 - 24
| Almost never feels discouraged.
|-
| 0 - 9
| Never feels discouraged.
|- style="border-top: 3px solid #aaa"
! rowspan=6 | DUTIFULNESS
| 91 - 100
| Has a profound sense of duty and obligation.
|-
| 76 - 90
| Has a strong sense of duty.
|-
| 61 - 75
| Has a sense of duty.
|-
| 25 - 39
| Finds rules confining.
|-
| 10 - 24
| Dislikes contracts and regulations.
|-
| 0 - 9
| Hates rules, contracts and other confining elements in its/his/her life.
|- style="border-top: 3px solid #aaa"
! rowspan=6 | EMOTIONALITY
| 91 - 100
| Has a profound understanding of its/his/her own emotions.
|-
| 76 - 90
| Has a great awareness of its/his/her own emotions.
|-
| 61 - 75
| Has a good awareness of its/his/her own emotions.
|-
| 25 - 39
| Tends not to openly express emotions.
|-
| 10 - 24
| Is mostly unaware of its/his/her own emotions and rarely expresses them.
|-
| 0 - 9
| Does not display its/his/her own emotions and has no awareness of them.
|- style="border-top: 3px solid #aaa"
! rowspan=6 | EXCITEMENT_SEEKING
| 91 - 100
|Lives for risk and excitement.
| rowspan=3 | Beings with this trait are <br>more likely to join you<br> in adventure mode.
|-
| 76 - 90
|Is a risk-taker and a thrill-seeker.
|-
| 61 - 75
|Loves a good thrill.
|-
| 25 - 39
|Is not a risk-taker.
|-
| 10 - 24
|Doesn't need thrills or risks in life.
|-
| 0 - 9
|Is entirely adverse to risk and excitement.
|- style="border-top: 3px solid #aaa"
! rowspan=6 | FRIENDLINESS
| 91 - 100
| Truly treasures the company of others.
|-
| 76 - 90
| Enjoys being in crowds.
|-
| 61 - 75
| Enjoys the company of others.
|-
| 25 - 39
| Tends to avoid crowds.
|-
| 10 - 24
| Prefers to be alone.
|-
| 0 - 9
| Considers spending time alone much more important than associating with others.
|- style="border-top: 3px solid #aaa"
! rowspan=6 | GREGARIOUSNESS
| 91 - 100
| Genuinely likes others and openly expresses positive feelings toward them.
|-
| 76 - 90
| Makes friends quickly.
|-
| 61 - 75
| Is very friendly.
|-
| 25 - 39
| Is somewhat reserved.
| rowspan=3 | A reserved dwarf (under 40)<br>never gains experience in<br>the {{L|Conversationalist}} skill.
|-
| 10 - 24
| Is very distant and reserved.
|-
| 0 - 9
| Does not actively seek friendships and is incredibly distant and reserved.
|- style="border-top: 3px solid #aaa"
! rowspan=6 | IMAGINATION
| 91 - 100
| Is bored by reality and has a wonderful imagination.
|-
| 76 - 90
| Is incredibly creative.
|-
| 61 - 75
| Has a fertile imagination.
|-
| 25 - 39
| Isn't given to flights of fancy.
|-
| 10 - 24
| Is grounded in reality.
|-
| 0 - 9
| Is interested only in facts and the real world.
|- style="border-top: 3px solid #aaa"
! rowspan=6 | IMMODERATION
| 91 - 100
| Is ruled by irresistible cravings and urges.
|-
| 76 - 90
| Feels strong urges and seeks short-term rewards.
|-
| 61 - 75
| Occassionally overindulges.
|-
| 25 - 39
| Doesn't often experience strong cravings or urges.
|-
| 10 - 24
| Only rarely feels strong cravings or urges.
|-
| 0 - 9
| Never feels tempted to overindulge in anything.
|- style="border-top: 3px solid #aaa"
! rowspan=6 | INTELLECTUAL_CURIOSITY
| 91 - 100
| Is entranced by riddles and puzzles and loves to debate issues and ideas.
|-
| 76 - 90
| Loves new and fresh ideas.
|-
| 61 - 75
| Is open-minded to new ideas.
|-
| 25 - 39
| Dislikes intellectual discussions.
|-
| 10 - 24
| Regards intellectual exercises as a waste of energy.
|-
| 0 - 9
| Is completely uninterested in ideas and debates over intellectual issues.
|- style="border-top: 3px solid #aaa"
! rowspan=6 | LIBERALISM
| 91 - 100
| Revels in chaos and disorder.
|-
| 76 - 90
| Loves to defy convention.
|-
| 61 - 75
| Is put off by authority and tradition.
|-
| 25 - 39
| Admires tradition.
|-
| 10 - 24
| Prefers stability and security to ambiguity and disorder.
|-
| 0 - 9
| Is an ardent believer in convention and traditional society.
|- style="border-top: 3px solid #aaa"
! rowspan=6 | MODESTY
| 91 - 100
| Would never claim to be better than somebody else.
|-
| 76 - 90
| Finds immodesty distasteful.
|-
| 61 - 75
| Is modest.
|-
| 25 - 39
| Is immodest.
|-
| 10 - 24
| Is very willing to compare itself/himself/herself favorably with others.
|-
| 0 - 9
| Would never shy away from an opportunity to say it/he/she is better than somebody else.
|- style="border-top: 3px solid #aaa"
! rowspan=6 | ORDERLINESS
| 91 - 100
| Loves to make lists and keep schedules.
|-
| 76 - 90
| Tries to live a well-organized life.
|-
| 61 - 75
| Is organized.
|-
| 25 - 39
| Is disorganized.
|-
| 10 - 24
| Is very disorganized.
|-
| 0 - 9
| Is completely disorganized.
|- style="border-top: 3px solid #aaa"
! rowspan=6 | SELF_CONSCIOUSNESS
| 91 - 100
| Is socially crippled by thoughts that everyone is watching and judging it/him/her.
| rowspan=2 valign=top | A very self-conscious dwarf (over 75)<br>never gains experience<br>in the {{L|Comedian}} skill.
|-
| 76 - 90
| Is concerned about rejection and ridicule.
|-
| 61 - 75
| Is self-conscious.
|-
| 25 - 39
| Is comfortable in social situations.
|-
| 10 - 24
| Is very comfortable in social situations.
|-
| 0 - 9
| Is absolutely unfazed by the opinions of others.
|- style="border-top: 3px solid #aaa"
! rowspan=6 | SELF_DISCIPLINE
| 91 - 100
| Will persist in the face of any difficulty until the task is complete.
| rowspan=6 | Self-discipline affects<br> how long the {{L|on break|breaks}} a<br> dwarf takes are.
|-
| 76 - 90
| Possesses great willpower.
|-
| 61 - 75
| Is self-disciplined.
|-
| 25 - 39
| Is occasionally given to procrastination.
|-
| 10 - 24
| Has very little self-discipline.
|-
| 0 - 9
| Rarely completes tasks and is often overcome by distractions.
|- style="border-top: 3px solid #aaa"
! rowspan=6 | SELF_EFFICACY
| 91 - 100
| Is incredibly confident.
|-
| 76 - 90
| Is very confident.
|-
| 61 - 75
| Is confident.
|-
| 25 - 39
| Lacks confidence.
|-
| 10 - 24
| Does not feel effective in life.
|-
| 0 - 9
| Feels as if it/he/she is not in control of its/his/her life.
|- style="border-top: 3px solid #aaa"
! rowspan=6 | STRAIGHTFORWARDNESS
| 91 - 100
| Is incredibly frank and candid in dealings with others.
| rowspan=3 | A straightforward dwarf (over 60)<br>never gains experience<br>in the {{L|Flatterer}} skill.
|-
| 76 - 90
| Is very straightforward with others.
|-
| 61 - 75
| Is candid and sincere in dealings with others.
|-
| 25 - 39
| Is guarded in {{L|relationship|relationships}} with others.
| rowspan=3 | Guarded dwarves (under 40) never<br>gain experience in the {{L|Consoler}} <br>skill, and are the only ones to<br>gain experience in the {{L|Liar}} skill.
|-
| 10 - 24
| Is not straightforward when dealing with others.
|-
| 0 - 9
| Believes that some deception is necessary in relationships with others.
|- style="border-top: 3px solid #aaa"
! rowspan=6 | SYMPATHY
| 91 - 100
| Is incredibly compassionate and feels the pain of others.
|-
| 76 - 90
| Is easily moved to pity.
|-
| 61 - 75
| Is compassionate.
|-
| 25 - 39
| Is not easily moved to pity.
|-
| 10 - 24
| Is not affected by the suffering of others.
|-
| 0 - 9
| Would never let an objective judgement be tempered by mercy or pity.
|- style="border-top: 3px solid #aaa"
! rowspan=6 | TRUST
| 91 - 100
| Is naturally trustful of everybody.
|-
| 76 - 90
| Is very trusting.
|-
| 61 - 75
| Is trusting.
|-
| 25 - 39
| Is slow to trust others.
|-
| 10 - 24
| Does not trust others.
|-
| 0 - 9
| Sees others as selfish and conniving.
|- style="border-top: 3px solid #aaa"
! rowspan=6 | VULNERABILITY
| 91 - 100
| Becomes completely helpless in stressful situations.
|-
| 76 - 90
| Cracks easily under pressure.
|-
| 61 - 75
| Doesn't handle stress well.
|-
| 25 - 39
| Can handle stress.
|-
| 10 - 24
| Is confident under pressure.
|-
| 0 - 9
| Is impervious to the effects of stress.
|}

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

v0.31:Cyclops

2011-01-22T16:24:24Z

3: Tentative butchery results, added a link

{{quality|Fine|05:09, 18 June 2010 (UTC)}}{{CreatureInfo v0.31
|name=Cyclops
|symbol=C
|color=4:0:1
|bone=~130
|meat=~240
|fat=~80
|lung=~24
|heart=~6
|intestine=~36
|liver=~12
|tripe=~12
|sweetbread=~6
|spleen=~6
|kidney=~12
|brain=~12
|skull=1
|tooth=~5
|eye=1
|skin=hide
|biome=
* Any land
|death=nobutcher
}}{{av}}

:''A giant humanoid monster with a single eye set in its forehead.''
As the description suggests, '''cyclopes''' are large single-eyed humanoids. They are usually found in {{l|cave}}s, and due to their sheer {{l|size}} and the fact that they're {{l|building destroyer}}s, they can make {{l|fun|quite a mess}} in your {{l|fortress}}. They are {{L|Megabeast|semi-megabeasts}} and are attracted by wealthy fortresses just like regular megabeasts and titans. You will get a warning message when they appear. When they do they seem to hang around for a while and then beeline for the nearest fortress entrance, probably into one of your cage traps.
Dispatch with caution.

<gallery>
File:Libr0328.jpg|The eye is the weakpoint.
</gallery>

{{gamedata}}
{{Creatures}}
{{Category|Semi-megabeasts}}
{{Category|Humanoids}}

v0.31:Antman

2011-01-22T15:58:08Z

3: Butchery, clarification on caste naming

{{quality|Exceptional|15:52, 30 September 2010 (UTC)}}
{{CreatureInfo v0.31
|name=Antman
|symbol=a|color=0:0:1
|meat=17-22
|fat=17-22
|heart=1
|intestine=1
|brain=1
|skin=chitin
|biome=
* {{L|cavern|Subterranean cavern}}<br />(Depth 1 - 3)
|wiki=no
|contrib=no
|death=nobutcher
}}

{{av}}

:''A humanoid with the head and body of an ant.''

'''Antmen''' are found in {{L|caverns|underground caverns}}. They can form crude civilizations and usually have a couple of piles of random items lying around.

Antmen form '''worker''', '''soldier''', '''drone''' and '''queen''' castes. Antmen workers are the most common Antmen. They are not very big and weigh about 20 kilograms. Drones are as big as workers and have the ability to fly. Soldiers can grow up to 50 kilograms and will defend their Queen at all costs. The Queen is the only breeding female among Antmen and her only task is producing new soldiers, workers and drones.

They are intelligent enough to use crude {{L|weapons}} such as blowguns. They can be deadly from their numbers and use of weapons, but a solid {{L|military}} effort can kill them off. Their blowguns can inflict mild poison effects on creatures, such as dizziness which causes them to be less effective in combat and slower at work like mining. Although they can not destroy buildings, they are able to open doors.

Compared to most humanoids, antmen have an extremely short lifespan, allowing a patient player to simply wait for them to die of old age rather than confront them.

{{gamedata}}
{{Creatures}}
{{Category|Humanoids}}
{{Category|Races}}

v0.31:Amphibian man

2011-01-22T15:41:55Z

3: Butchery

{{Quality|Exceptional|07:20, 22 July 2010 (UTC)}}
{{CreatureInfo v0.31
|name=Amphibian man
|symbol=a|color=6:0:0
|bone=16
|meat=18
|fat=16
|lung=2
|heart=1
|intestine=1
|liver=1
|tripe=1
|sweetbread=1
|spleen=1
|kidney=2
|brain=1
|skull=1
|skin=hide
|wiki=no
|contrib=no
|death=nobutcher
|biome=
* {{L|cavern|Subterranean cavern}}<br />(Depth 1 - 3)
|wiki=no
|contrib=no
}}
{{av}}

:''These evil creatures resemble walking frogs with arms and the intelligence to use them. They live in the waters far under the earth.''

'''Amphibian men''' are one of the many underworld tribal races, and can be found on any cavern level milling around piles of {{L|food|meat}} and {{L|leather|tanned hides}}. They are equivalent in size to {{L|kobold}}s, but are less agile.

Approach with caution, unless the tribe is friendly. If the tribe is friendly, feel free to take advantage of them in imperialistic tradition and steal all their resources without compensation. To check whether a tribe of amphibian men is friendly, press {{k|u}} to view the unit list. The amphibian men will be labeled as either hostile or friendly. Alternatively, press {{k|v}} to view one of their profiles.

Like many underground races, the danger of amphibian men is not to be found in their wooden weapons, but in the substances found smeared on them. Amphibian men use many {{L|syndrome|poisons}}, some of which can be deadly. They will launch group attacks on your fort, and have the ability to swim through your reservoirs and launch amphibious assaults on your {{L|fisherdwarf|fisherdwarves}}.

{{gamedata}}
{{Creatures}}
{{Category|Humanoids}}
{{Category|Races}}

v0.31:Dark gnome

2011-01-22T15:41:26Z

3: Forgot skin

{{quality|Exceptional|06:08, 27 December 2010 (UTC)}}
{{CreatureInfo v0.31
|name=Dark gnome
|symbol=g|color=3:0:0
|bone=10
|meat=13
|fat=13
|lung=2
|heart=1
|intestine=1
|liver=1
|tripe=1
|sweetbread=1
|spleen=1
|kidney=2
|brain=1
|skull=1
|skin=hide
|align=evil
|biome= * {{L|Mountain}}s
|wiki=no
|contrib=no
|death=nobutcher
}}
{{av}}

:''A tiny, foul-tempered humanoid creature that dwells in the evil mountains. They are known to enjoy drinking liquor and will take any unguarded supplies of booze.''

'''Dark gnomes''' are the evil cousins of {{L|mountain gnome}}s. They have a teal skin, yellow eyes and a wonderful variety of {{L|beard|beards}}. They are just as intelligent as their {{L|Mountain_gnome|fairer kin}}, and like them, lack a spoken language. There is no formal Dark Gnome {{L|civilization|society}}, but nevertheless, in Fortress Mode they will come for your {{L|Alcohol|booze}} in groups of 5 to ten and scare the {{L|carp}} out of any civilians they encounter. If they reach your alcohol they'll guzzle it with such efficient speed that your {{L|dwarves}} will soon be dying of thirst unless you have steady access to {{L|plants}} or {{L|water}}.

Despite their apparent malice, Dark Gnomes are not particularly violent and will run in terror when chased. They're able to equip {{L|weapon}}s and {{L|armor}} that are appropriately sized for them, but this is rarely seen. Any {{L|dwarf}} or {{L|dog}} can easily hurt them, but be wary of {{L|combat|fighting}} on {{L|mountain|mountainsides}}, where a dwarf may charge the gnome, miss, and {{L|gravity|fall a very long distance.}}

Lucky gnomes can live for up to 250 years, assuming they stay away from {{L|Gnomeblight}} and other hazards to their health.

{{gamedata}}
{{Creatures}}
{{Category|Humanoids}}

v0.31:Mountain gnome

2011-01-22T15:41:06Z

3: Forgot skin

{{quality|Exceptional|15:37, 22 January 2011 (UTC)}}
{{CreatureInfo v0.31
|name=Mountain gnome
|symbol=g |color=0:0:1
|bone=10
|meat=13
|fat=13
|lung=2
|heart=1
|intestine=1
|liver=1
|tripe=1
|sweetbread=1
|spleen=1
|kidney=2
|brain=1
|skull=1
|skin=hide
|align=good
|biome= * {{L|Mountain}}s
|death=nobutcher
|contrib=no
|wiki=no
}}
{{av}}

:''A tiny, jolly humanoid creature that dwells in the fair mountains. They are known to enjoy drinking liquor and don’t care whether it's theirs or not.''

'''Mountain gnomes''' are weak humanoid {{l|creatures}} that appear on good {{l|mountain}}ous maps. Their intelligence is on par with {{L|dwarf|dwarves}} and other sentient creatures, but they lack the ability to communicate verbally, which is one possible reason they haven't formed a {{L|civilization|civilized society}}.

If you leave {{l|alcohol|booze}} out in the open, they will steal it, leaving your dwarfs {{L|fun|dying}} of starvation and dehydration, but otherwise they are "harmless", will flee from your {{l|dwarf|dwarves}} if confronted (to the point of being pushed off a {{l|cliff}} if necessary). Given their small {{L|size}}, they pose no physical threat to any dwarf and can be easily killed by anyone who isn't {{L|unconscious}}.

Gnomes can be easily trapped by placing a single {{L|forbid|forbidden}} {{L|barrel}} of booze in a small {{L|stockpile}} and surrounding the barrel with {{L|cage trap|cage traps}}. Since gnomes often travel in groups, several layers of cages should be used so that the bait stays untouched.

{{l|Gnomeblight}} is extremely toxic to Mountain Gnomes. Unlike their {{L|dark_gnome|dark counterparts}}, Mountain Gnomes are diurnal creatures.

{{gamedata}}
{{Creatures}}
{{Category|Humanoids}}

v0.31:Mountain gnome

2011-01-22T15:37:31Z

3: Rated article "Exceptional" using the rating script

{{quality|Exceptional|15:37, 22 January 2011 (UTC)}}
{{CreatureInfo v0.31
|name=Mountain gnome
|symbol=g |color=0:0:1
|bone=10
|meat=13
|fat=13
|lung=2
|heart=1
|intestine=1
|liver=1
|tripe=1
|sweetbread=1
|spleen=1
|kidney=2
|brain=1
|skull=1
|align=good
|biome= * {{L|Mountain}}s
|death=nobutcher
|contrib=no
|wiki=no
}}
{{av}}

:''A tiny, jolly humanoid creature that dwells in the fair mountains. They are known to enjoy drinking liquor and don’t care whether it's theirs or not.''

'''Mountain gnomes''' are weak humanoid {{l|creatures}} that appear on good {{l|mountain}}ous maps. Their intelligence is on par with {{L|dwarf|dwarves}} and other sentient creatures, but they lack the ability to communicate verbally, which is one possible reason they haven't formed a {{L|civilization|civilized society}}.

If you leave {{l|alcohol|booze}} out in the open, they will steal it, leaving your dwarfs {{L|fun|dying}} of starvation and dehydration, but otherwise they are "harmless", will flee from your {{l|dwarf|dwarves}} if confronted (to the point of being pushed off a {{l|cliff}} if necessary). Given their small {{L|size}}, they pose no physical threat to any dwarf and can be easily killed by anyone who isn't {{L|unconscious}}.

Gnomes can be easily trapped by placing a single {{L|forbid|forbidden}} {{L|barrel}} of booze in a small {{L|stockpile}} and surrounding the barrel with {{L|cage trap|cage traps}}. Since gnomes often travel in groups, several layers of cages should be used so that the bait stays untouched.

{{l|Gnomeblight}} is extremely toxic to Mountain Gnomes. Unlike their {{L|dark_gnome|dark counterparts}}, Mountain Gnomes are diurnal creatures.

{{gamedata}}
{{Creatures}}
{{Category|Humanoids}}

v0.31:Dark gnome

2011-01-22T15:36:17Z

3: Butchery

{{quality|Exceptional|06:08, 27 December 2010 (UTC)}}
{{CreatureInfo v0.31
|name=Dark gnome
|symbol=g|color=3:0:0
|bone=10
|meat=13
|fat=13
|lung=2
|heart=1
|intestine=1
|liver=1
|tripe=1
|sweetbread=1
|spleen=1
|kidney=2
|brain=1
|skull=1
|align=evil
|biome= * {{L|Mountain}}s
|wiki=no
|contrib=no
|death=nobutcher
}}
{{av}}

:''A tiny, foul-tempered humanoid creature that dwells in the evil mountains. They are known to enjoy drinking liquor and will take any unguarded supplies of booze.''

'''Dark gnomes''' are the evil cousins of {{L|mountain gnome}}s. They have a teal skin, yellow eyes and a wonderful variety of {{L|beard|beards}}. They are just as intelligent as their {{L|Mountain_gnome|fairer kin}}, and like them, lack a spoken language. There is no formal Dark Gnome {{L|civilization|society}}, but nevertheless, in Fortress Mode they will come for your {{L|Alcohol|booze}} in groups of 5 to ten and scare the {{L|carp}} out of any civilians they encounter. If they reach your alcohol they'll guzzle it with such efficient speed that your {{L|dwarves}} will soon be dying of thirst unless you have steady access to {{L|plants}} or {{L|water}}.

Despite their apparent malice, Dark Gnomes are not particularly violent and will run in terror when chased. They're able to equip {{L|weapon}}s and {{L|armor}} that are appropriately sized for them, but this is rarely seen. Any {{L|dwarf}} or {{L|dog}} can easily hurt them, but be wary of {{L|combat|fighting}} on {{L|mountain|mountainsides}}, where a dwarf may charge the gnome, miss, and {{L|gravity|fall a very long distance.}}

Lucky gnomes can live for up to 250 years, assuming they stay away from {{L|Gnomeblight}} and other hazards to their health.

{{gamedata}}
{{Creatures}}
{{Category|Humanoids}}

v0.31:Mountain gnome

2011-01-22T15:32:11Z

3: Butchery results

{{Quality|Fine|07:33, 29 July 2010 (UTC)}}
{{CreatureInfo v0.31
|name=Mountain gnome
|symbol=g |color=0:0:1
|bone=10
|meat=13
|fat=13
|lung=2
|heart=1
|intestine=1
|liver=1
|tripe=1
|sweetbread=1
|spleen=1
|kidney=2
|brain=1
|skull=1
|align=good
|biome= * {{L|Mountain}}s
|death=nobutcher
|contrib=no
|wiki=no
}}
{{av}}

:''A tiny, jolly humanoid creature that dwells in the fair mountains. They are known to enjoy drinking liquor and don’t care whether it's theirs or not.''

'''Mountain gnomes''' are weak humanoid {{l|creatures}} that appear on good {{l|mountain}}ous maps. Their intelligence is on par with {{L|dwarf|dwarves}} and other sentient creatures, but they lack the ability to communicate verbally, which is one possible reason they haven't formed a {{L|civilization|civilized society}}.

If you leave {{l|alcohol|booze}} out in the open, they will steal it, leaving your dwarfs {{L|fun|dying}} of starvation and dehydration, but otherwise they are "harmless", will flee from your {{l|dwarf|dwarves}} if confronted (to the point of being pushed off a {{l|cliff}} if necessary). Given their small {{L|size}}, they pose no physical threat to any dwarf and can be easily killed by anyone who isn't {{L|unconscious}}.

Gnomes can be easily trapped by placing a single {{L|forbid|forbidden}} {{L|barrel}} of booze in a small {{L|stockpile}} and surrounding the barrel with {{L|cage trap|cage traps}}. Since gnomes often travel in groups, several layers of cages should be used so that the bait stays untouched.

{{l|Gnomeblight}} is extremely toxic to Mountain Gnomes. Unlike their {{L|dark_gnome|dark counterparts}}, Mountain Gnomes are diurnal creatures.

{{gamedata}}
{{Creatures}}
{{Category|Humanoids}}

v0.31:Satyr

2011-01-22T15:29:04Z

3: Insurance

{{quality|Fine|15:15, 22 January 2011 (UTC)}}
{{CreatureInfo v0.31
|name=Satyr
|symbol=s|color=6:0:0
|bone=~19
|meat=~19
|fat=15
|lung=2|
|heart=1
|intestine=1
|liver=1
|tripe=1
|sweetbread=1
|spleen=1
|kidney=2
|brain=1
|skull=1
|horn=2
|hoof=2
|skin=hide
|align=good
|biome=
* {{L|Forest|Temperate broadleaf forest}}
* {{L|Forest|Tropical coniferous forest}}
* {{L|Forest|Tropical dry broadleaf forest}}
|death=nobutcher
|contrib=yes
}}
{{av}}

:''A medium-sized humanoid with the horns and legs of a goat.''

{{gamedata}}
{{Creatures}}
{{Category|Humanoids}}

v0.31:Foul blendec

2011-01-22T15:28:44Z

3: Added butchery results, some info

{{quality|Fine|19:32, 11 October 2010 (UTC)}}
{{CreatureInfo v0.31
|name=Foul blendec
|symbol=b|color=0:0:1
|bone=~19
|meat=~19
|fat=15
|lung=2
|heart=1
|intestine=1
|liver=1
|tripe=1
|sweetbread=1
|spleen=1
|kidney=2
|brain=1
|skull=1
|horn=2
|hoof=2
|skin=hide
|align=evil
|biome=
* {{L|Forest|Temperate broadleaf forest}}s
* {{L|Forest|Tropical coniferous forest}}s
* {{L|Forest|Tropical dry broadleaf forest}}s
|death=nobutcher
|contrib=yes
|wiki=no
}}
{{av}}

:''A man-shaped creature with the legs of a goat and the empty-eyed skull of a goat.''

'''Foul Blendecs''' are the {{L|Surroundings#Evil|evil}} counterparts of {{L|Satyr|Satyrs}}. Blendecs can be dangerous if encountered by the unprepared - they travel in packs, actively attack nearby targets, and are the same {{L|size}} as a dwarf. Blendecs have a slight advantage over many other creatures by virtue of their eyelessness - they can see just fine, and it's impossible to take that away from them. Fortunately, they're relatively rare, and only show up in certain evil {{L|forest|forests}}.

{{gamedata}}
{{Creatures}}
{{Category|Humanoids}}

v0.31:Satyr

2011-01-22T15:15:49Z

3: Rated article "Fine" using the rating script

{{quality|Fine|15:15, 22 January 2011 (UTC)}}
{{CreatureInfo v0.31
|name=Satyr
|symbol=s|color=6:0:0
|bone=19
|meat=~19
|fat=15
|lung=2|
|heart=1
|intestine=1
|liver=1
|tripe=1
|sweetbread=1
|spleen=1
|kidney=2
|brain=1
|skull=1
|horn=2
|hoof=2
|skin=hide
|align=good
|biome=
* {{L|Forest|Temperate broadleaf forest}}
* {{L|Forest|Tropical coniferous forest}}
* {{L|Forest|Tropical dry broadleaf forest}}
|death=nobutcher
|contrib=yes
}}
{{av}}

:''A medium-sized humanoid with the horns and legs of a goat.''

{{gamedata}}
{{Creatures}}
{{Category|Humanoids}}

v0.31:Satyr

2011-01-22T15:14:59Z

3: Oops

{{quality|Tattered|02:42, 13 January 2011 (UTC)}}
{{CreatureInfo v0.31
|name=Satyr
|symbol=s|color=6:0:0
|bone=19
|meat=~19
|fat=15
|lung=2|
|heart=1
|intestine=1
|liver=1
|tripe=1
|sweetbread=1
|spleen=1
|kidney=2
|brain=1
|skull=1
|horn=2
|hoof=2
|skin=hide
|align=good
|biome=
* {{L|Forest|Temperate broadleaf forest}}
* {{L|Forest|Tropical coniferous forest}}
* {{L|Forest|Tropical dry broadleaf forest}}
|death=nobutcher
|contrib=yes
}}
{{av}}

:''A medium-sized humanoid with the horns and legs of a goat.''

{{gamedata}}
{{Creatures}}
{{Category|Humanoids}}

v0.31:Satyr

2011-01-22T15:13:44Z

3: Added butchery results, inappropriate as they may be

{{quality|Tattered|02:42, 13 January 2011 (UTC)}}
{{CreatureInfo v0.31
|name=Satyr
|symbol=s|color=6:0:0
|bone=19
|meat=~19
|fat=15
|lung=2|
|heart=1
|intestine=1
|liver=1
|tripe=1
|sweetbread=1
|spleen=1
|kidney=2
|brain=1
|skull=1
|horn=2
|skin=hide
|align=good
|biome=
* {{L|Forest|Temperate broadleaf forest}}
* {{L|Forest|Tropical coniferous forest}}
* {{L|Forest|Tropical dry broadleaf forest}}
|death=nobutcher
|contrib=yes
}}
{{av}}

:''A medium-sized humanoid with the horns and legs of a goat.''

{{gamedata}}
{{Creatures}}
{{Category|Humanoids}}

v0.31:Personality facet

2011-01-22T14:52:24Z

3: Rated article "Fine" using the rating script

{{quality|Fine|14:52, 22 January 2011 (UTC)}}{{av}}

Dwarven personalities are determined by a set of traits. These traits are distinct from {{L|attributes}}.

Personality traits are shown in a dwarf's "thoughts and preferences" description page, which can be accessed by {{k|v}}iewing that dwarf then {{k|p}}, {{k|z}}, {{k|Enter}}, or from the {{k|u}}nit menu with {{k|v}}iew, {{k|Enter}}.

Each trait varies from 1 (lowest possible) to 100 (highest possible), but are categorised as below.

Traits are also influenced by species via the use of the PERSONALITY {{L|creature token}}. For example, dwarves are slightly more straightforward than average with a median of 55 in that trait, whereas goblins aren't likely to help others out - their altruism median is a mere 25, and is capped at 50.

Traits also have an effect on which social skills are learned in social interaction, and determine whether certain actions may give a good or bad {{L|thought}}. Traits may have other, more subtle effects on creature behaviour, which are currently not entirely understood.

{| {{prettytable}}
|- style="background:#ddd"
! Token
! Value
! Description
! Gameplay effects
|- style="border-top: 3px solid #aaa"
! rowspan=6 | ACHIEVEMENT_STRIVING
| 91 - 100
|Constantly strives for perfection.
|-
| 76 - 90
|Thinks it is incredibly important to strive for excellence.
|-
| 61 - 75
|Strives for excellence.
|-
| 25 - 39
|Doesn't go out of its/his/her way to do more work than necessary.
|-
| 10 - 24
|Very rarely does more work than necessary.
|-
| 0 - 9
|Does the bare minimum necessary to accomplish the task at hand.
|- style="border-top: 3px solid #aaa"
! rowspan=6 | ACTIVITY_LEVEL
| style="width:4em" | 91 - 100
| Is constantly active and energetic.
|-
| 76 - 90
| Is very energetic and active.
|-
| 61 - 75
| Is very active.
|-
| 25 - 39
| Is relaxed.
|-
| 10 - 24
| Lives life at a leisurely pace.
|-
| 0 - 9
| Can't be bothered with frantic, fast-paced living.
|- style="border-top: 3px solid #aaa"
! rowspan=6 | ADVENTUROUSNESS
| 91 - 100
|Lives for risk and excitement.
|-
| 76 - 90
|Is a risk-taker and a thrill-seeker.
|-
| 61 - 75
|Loves a good thrill.
|-
| 25 - 39
|Is not a risk-taker.
|-
| 10 - 24
|Doesn't need thrills or risks in life.
|-
| 0 - 9
|Is entirely adverse to risk and excitement.
|- style="border-top: 3px solid #aaa"
! rowspan=6 | ALTRUISM
| 91 - 100
| Is truly fulfilled by assisting those in need.
|-
| 76 - 90
| Finds helping others very rewarding.
|-
| 61 - 75
| Finds helping others rewarding.
|-
| 25 - 39
| Does not go out of its/his/her way to help others.
| rowspan=3 valign=top | Helping a {{L|wound|wounded}} dwarf<br>is a bad thought<br>at these levels.
|-
| 10 - 24
| colspan=1 | Dislikes helping others.
|-
| 0 - 9
| colspan=1 | Views helping others as an imposition on own needs to get along with others.
|- style="border-top: 3px solid #aaa"
! rowspan=6 | ANGER
| 91 - 100
| Is in a constant state of internal rage.
| rowspan=6 | Angry creatures will <br>become {{L|Status icon|enraged}} in<br>combat more commonly.<br>The very least angry<br>creatures will never<br>become enraged.
|-
| 76 - 90
| Is very quick to anger.
|-
| 61 - 75
| Is quick to anger.
|-
| 25 - 39
| Is slow to anger.
|-
| 10 - 24
| Is very slow to anger.
|-
| 0 - 9
| Never becomes angry.
|- style="border-top: 3px solid #aaa"
! rowspan=6 | ANXIETY
| 91 - 100
| Is a nervous wreck.
|-
| 76 - 90
| Is always tense and jittery.
|-
| 61 - 75
| Is often nervous.
|-
| 25 - 39
| Has a calm demeanor.
|-
| 10 - 24
| Has a very calm demeanor.
|-
| 0 - 9
| Has an incredibly calm demeanor.
|- style="border-top: 3px solid #aaa"
! rowspan=6 | ARTISTIC_INTEREST
| 91 - 100
| Can easily become absorbed in art and the beauty of the natural world.
|-
| 76 - 90
| Greatly appreciates art and natural beauty.
|-
| 61 - 75
| Appreciates art and natural beauty.
|-
| 25 - 39
| Does not have a great aesthetic sensitivity.
|-
| 10 - 24
| Is not interested in art.
|-
| 0 - 9
| Is completely uninterested in art.
|- style="border-top: 3px solid #aaa"
! rowspan=6 | ASSERTIVENESS
| 91 - 100
| Loves to take charge and direct activities.
|-
| 76 - 90
| Is very assertive.
|-
| 61 - 75
| Is assertive.
|-
| 25 - 39
| Is unassertive.
| rowspan=3 | An unassertive dwarf (under<br>40) never gains experience<br>in the {{L|Persuader}} skill.
|-
| 10 - 24
| Prefers that others handle the leadership roles.
|-
| 0 - 9
| Never speaks out or attempts to direct activities.
|- style="border-top: 3px solid #aaa"
! rowspan=6 | CAUTIOUSNESS
| 91 - 100
| Thinks through every alternatives and their consequences before acting.
|-
| 76 - 90
| Is extremely cautious.
|-
| 61 - 75
| Takes time when making decisions.
|-
| 25 - 39
| Often does the first thing that comes to mind.
|-
| 10 - 24
| Acts impulsively.
|-
| 0 - 9
| Always acts without considering alternatives or thinking through possibilities.
|- style="border-top: 3px solid #aaa"
! rowspan=6 | CHEERFULNESS
| 91 - 100
| Often feels filled with joy.
|-
| 76 - 90
| Can be very happy and optimistic.
|-
| 61 - 75
| Is often cheerful.
|-
| 25 - 39
| Is rarely happy or enthusiastic.
|-
| 10 - 24
| Is a pessimist.
|-
| 0 - 9
| Is never optimistic or enthusiastic about anything.
|- style="border-top: 3px solid #aaa"
! rowspan=6 | COOPERATION
| 91 - 100
| Sacrifices its/his/her own needs to get along with others.
| rowspan=3 | A cooperative dwarf (over 60)<br>never gains experience<br>in the {{L|Intimidator}} skill.
|-
| 76 - 90
| Dislikes confrontations.
|-
| 61 - 75
| Is willing to compromise with others.
|-
| 25 - 39
| Doesn't like to compromise with others.
| rowspan=3 | An uncooperative dwarf (under 40)<br>never gains experience<br>in the {{L|Pacifier}} skill.
|-
| 10 - 24
| Would rather intimidate others than compromise with them.
|-
| 0 - 9
| Would never deny its/his/her own needs just to compromise with somebody else.
|- style="border-top: 3px solid #aaa"
! rowspan=6 | DEPRESSION
| 91 - 100
| Is frequently depressed.
|-
| 76 - 90
| Is often sad and dejected.
|-
| 61 - 75
| Often feels discouraged.
|-
| 25 - 39
| Rarely feels discouraged.
|-
| 10 - 24
| Almost never feels discouraged.
|-
| 0 - 9
| Never feels discouraged.
|- style="border-top: 3px solid #aaa"
! rowspan=6 | DUTIFULNESS
| 91 - 100
| Has a profound sense of duty and obligation.
|-
| 76 - 90
| Has a strong sense of duty.
|-
| 61 - 75
| Has a sense of duty.
|-
| 25 - 39
| Finds rules confining.
|-
| 10 - 24
| Dislikes contracts and regulations.
|-
| 0 - 9
| Hates rules, contracts and other confining elements in its/his/her life.
|- style="border-top: 3px solid #aaa"
! rowspan=6 | EMOTIONALITY
| 91 - 100
| Has a profound understanding of its/his/her own emotions.
|-
| 76 - 90
| Has a great awareness of its/his/her own emotions.
|-
| 61 - 75
| Has a good awareness of its/his/her own emotions.
|-
| 25 - 39
| Tends not to openly express emotions.
|-
| 10 - 24
| Is mostly unaware of its/his/her own emotions and rarely expresses them.
|-
| 0 - 9
| Does not display its/his/her own emotions and has no awareness of them.
|- style="border-top: 3px solid #aaa"
! rowspan=6 | EXCITEMENT_SEEKING
| 91 - 100
| Is highly adventurous and loves fresh experiences.
| rowspan=3 | Beings with this trait are <br>more likely to join you<br> in adventure mode.
|-
| 76 - 90
| Is eager for new experiences.
|-
| 61 - 75
| Likes to try new things.
|-
| 25 - 39
| Prefers familiar routines.
|-
| 10 - 24
| Is uncomfortable with change.
|-
| 0 - 9
| Is resistant to change.
|- style="border-top: 3px solid #aaa"
! rowspan=6 | FRIENDLINESS
| 91 - 100
| Truly treasures the company of others.
|-
| 76 - 90
| Enjoys being in crowds.
|-
| 61 - 75
| Enjoys the company of others.
|-
| 25 - 39
| Tends to avoid crowds.
|-
| 10 - 24
| Prefers to be alone.
|-
| 0 - 9
| Considers spending time alone much more important than associating with others.
|- style="border-top: 3px solid #aaa"
! rowspan=6 | GREGARIOUSNESS
| 91 - 100
| Genuinely likes others and openly expresses positive feelings toward them.
|-
| 76 - 90
| Makes friends quickly.
|-
| 61 - 75
| Is very friendly.
|-
| 25 - 39
| Is somewhat reserved.
| rowspan=3 | A reserved dwarf (under 40)<br>never gains experience in<br>the {{L|Conversationalist}} skill.
|-
| 10 - 24
| Is very distant and reserved.
|-
| 0 - 9
| Does not actively seek friendships and is incredibly distant and reserved.
|- style="border-top: 3px solid #aaa"
! rowspan=6 | IMAGINATION
| 91 - 100
| Is bored by reality and has a wonderful imagination.
|-
| 76 - 90
| Is incredibly creative.
|-
| 61 - 75
| Has a fertile imagination.
|-
| 25 - 39
| Isn't given to flights of fancy.
|-
| 10 - 24
| Is grounded in reality.
|-
| 0 - 9
| Is interested only in facts and the real world.
|- style="border-top: 3px solid #aaa"
! rowspan=6 | IMMODERATION
| 91 - 100
| Is ruled by irresistible cravings and urges.
|-
| 76 - 90
| Feels strong urges and seeks short-term rewards.
|-
| 61 - 75
| Occassionally overindulges.
|-
| 25 - 39
| Doesn't often experience strong cravings or urges.
|-
| 10 - 24
| Only rarely feels strong cravings or urges.
|-
| 0 - 9
| Never feels tempted to overindulge in anything.
|- style="border-top: 3px solid #aaa"
! rowspan=6 | INTELLECTUAL_CURIOSITY
| 91 - 100
| Is entranced by riddles and puzzles and loves to debate issues and ideas.
|-
| 76 - 90
| Loves new and fresh ideas.
|-
| 61 - 75
| Is open-minded to new ideas.
|-
| 25 - 39
| Dislikes intellectual discussions.
|-
| 10 - 24
| Regards intellectual exercises as a waste of energy.
|-
| 0 - 9
| Is completely uninterested in ideas and debates over intellectual issues.
|- style="border-top: 3px solid #aaa"
! rowspan=6 | LIBERALISM
| 91 - 100
| Revels in chaos and disorder.
|-
| 76 - 90
| Loves to defy convention.
|-
| 61 - 75
| Is put off by authority and tradition.
|-
| 25 - 39
| Admires tradition.
|-
| 10 - 24
| Prefers stability and security to ambiguity and disorder.
|-
| 0 - 9
| Is an ardent believer in convention and traditional society.
|- style="border-top: 3px solid #aaa"
! rowspan=6 | MODESTY
| 91 - 100
| Would never claim to be better than somebody else.
|-
| 76 - 90
| Finds immodesty distasteful.
|-
| 61 - 75
| Is modest.
|-
| 25 - 39
| Is immodest.
|-
| 10 - 24
| Is very willing to compare itself/himself/herself favorably with others.
|-
| 0 - 9
| Would never shy away from an opportunity to say it/he/she is better than somebody else.
|- style="border-top: 3px solid #aaa"
! rowspan=6 | ORDERLINESS
| 91 - 100
| Loves to make lists and keep schedules.
|-
| 76 - 90
| Tries to live a well-organized life.
|-
| 61 - 75
| Is organized.
|-
| 25 - 39
| Is disorganized.
|-
| 10 - 24
| Is very disorganized.
|-
| 0 - 9
| Is completely disorganized.
|- style="border-top: 3px solid #aaa"
! rowspan=6 | SELF_CONSCIOUSNESS
| 91 - 100
| Is socially crippled by thoughts that everyone is watching and judging it/him/her.
| rowspan=2 valign=top | A very self-conscious dwarf (over 75)<br>never gains experience<br>in the {{L|Comedian}} skill.
|-
| 76 - 90
| Is concerned about rejection and ridicule.
|-
| 61 - 75
| Is self-conscious.
|-
| 25 - 39
| Is comfortable in social situations.
|-
| 10 - 24
| Is very comfortable in social situations.
|-
| 0 - 9
| Is absolutely unfazed by the opinions of others.
|- style="border-top: 3px solid #aaa"
! rowspan=6 | SELF_DISCIPLINE
| 91 - 100
| Will persist in the face of any difficulty until the task is complete.
| rowspan=6 | Self-discipline affects<br> how long the {{L|on break|breaks}} a<br> dwarf takes are.
|-
| 76 - 90
| Possesses great willpower.
|-
| 61 - 75
| Is self-disciplined.
|-
| 25 - 39
| Is occasionally given to procrastination.
|-
| 10 - 24
| Has very little self-discipline.
|-
| 0 - 9
| Rarely completes tasks and is often overcome by distractions.
|- style="border-top: 3px solid #aaa"
! rowspan=6 | SELF_EFFICACY
| 91 - 100
| Is incredibly confident.
|-
| 76 - 90
| Is very confident.
|-
| 61 - 75
| Is confident.
|-
| 25 - 39
| Lacks confidence.
|-
| 10 - 24
| Does not feel effective in life.
|-
| 0 - 9
| Feels as if it/he/she is not in control of its/his/her life.
|- style="border-top: 3px solid #aaa"
! rowspan=6 | STRAIGHTFORWARDNESS
| 91 - 100
| Is incredibly frank and candid in dealings with others.
| rowspan=3 | A straightforward dwarf (over 60)<br>never gains experience<br>in the {{L|Flatterer}} skill.
|-
| 76 - 90
| Is very straightforward with others.
|-
| 61 - 75
| Is candid and sincere in dealings with others.
|-
| 25 - 39
| Is guarded in {{L|relationship|relationships}} with others.
| rowspan=3 | Guarded dwarves (under 40) never<br>gain experience in the {{L|Consoler}} <br>skill, and are the only ones to<br>gain experience in the {{L|Liar}} skill.
|-
| 10 - 24
| Is not straightforward when dealing with others.
|-
| 0 - 9
| Believes that some deception is necessary in relationships with others.
|- style="border-top: 3px solid #aaa"
! rowspan=6 | SYMPATHY
| 91 - 100
| Is incredibly compassionate and feels the pain of others.
|-
| 76 - 90
| Is easily moved to pity.
|-
| 61 - 75
| Is compassionate.
|-
| 25 - 39
| Is not easily moved to pity.
|-
| 10 - 24
| Is not affected by the suffering of others.
|-
| 0 - 9
| Would never let an objective judgement be tempered by mercy or pity.
|- style="border-top: 3px solid #aaa"
! rowspan=6 | TRUST
| 91 - 100
| Is naturally trustful of everybody.
|-
| 76 - 90
| Is very trusting.
|-
| 61 - 75
| Is trusting.
|-
| 25 - 39
| Is slow to trust others.
|-
| 10 - 24
| Does not trust others.
|-
| 0 - 9
| Sees others as selfish and conniving.
|- style="border-top: 3px solid #aaa"
! rowspan=6 | VULNERABILITY
| 91 - 100
| Becomes completely helpless in stressful situations.
|-
| 76 - 90
| Cracks easily under pressure.
|-
| 61 - 75
| Doesn't handle stress well.
|-
| 25 - 39
| Can handle stress.
|-
| 10 - 24
| Is confident under pressure.
|-
| 0 - 9
| Is impervious to the effects of stress.
|}

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

v0.31:Personality facet

2011-01-22T14:51:51Z

3: Added categories

{{quality|Tattered|~~}}{{av}}

Dwarven personalities are determined by a set of traits. These traits are distinct from {{L|attributes}}.

Personality traits are shown in a dwarf's "thoughts and preferences" description page, which can be accessed by {{k|v}}iewing that dwarf then {{k|p}}, {{k|z}}, {{k|Enter}}, or from the {{k|u}}nit menu with {{k|v}}iew, {{k|Enter}}.

Each trait varies from 1 (lowest possible) to 100 (highest possible), but are categorised as below.

Traits are also influenced by species via the use of the PERSONALITY {{L|creature token}}. For example, dwarves are slightly more straightforward than average with a median of 55 in that trait, whereas goblins aren't likely to help others out - their altruism median is a mere 25, and is capped at 50.

Traits also have an effect on which social skills are learned in social interaction, and determine whether certain actions may give a good or bad {{L|thought}}. Traits may have other, more subtle effects on creature behaviour, which are currently not entirely understood.

{| {{prettytable}}
|- style="background:#ddd"
! Token
! Value
! Description
! Gameplay effects
|- style="border-top: 3px solid #aaa"
! rowspan=6 | ACHIEVEMENT_STRIVING
| 91 - 100
|Constantly strives for perfection.
|-
| 76 - 90
|Thinks it is incredibly important to strive for excellence.
|-
| 61 - 75
|Strives for excellence.
|-
| 25 - 39
|Doesn't go out of its/his/her way to do more work than necessary.
|-
| 10 - 24
|Very rarely does more work than necessary.
|-
| 0 - 9
|Does the bare minimum necessary to accomplish the task at hand.
|- style="border-top: 3px solid #aaa"
! rowspan=6 | ACTIVITY_LEVEL
| style="width:4em" | 91 - 100
| Is constantly active and energetic.
|-
| 76 - 90
| Is very energetic and active.
|-
| 61 - 75
| Is very active.
|-
| 25 - 39
| Is relaxed.
|-
| 10 - 24
| Lives life at a leisurely pace.
|-
| 0 - 9
| Can't be bothered with frantic, fast-paced living.
|- style="border-top: 3px solid #aaa"
! rowspan=6 | ADVENTUROUSNESS
| 91 - 100
|Lives for risk and excitement.
|-
| 76 - 90
|Is a risk-taker and a thrill-seeker.
|-
| 61 - 75
|Loves a good thrill.
|-
| 25 - 39
|Is not a risk-taker.
|-
| 10 - 24
|Doesn't need thrills or risks in life.
|-
| 0 - 9
|Is entirely adverse to risk and excitement.
|- style="border-top: 3px solid #aaa"
! rowspan=6 | ALTRUISM
| 91 - 100
| Is truly fulfilled by assisting those in need.
|-
| 76 - 90
| Finds helping others very rewarding.
|-
| 61 - 75
| Finds helping others rewarding.
|-
| 25 - 39
| Does not go out of its/his/her way to help others.
| rowspan=3 valign=top | Helping a {{L|wound|wounded}} dwarf<br>is a bad thought<br>at these levels.
|-
| 10 - 24
| colspan=1 | Dislikes helping others.
|-
| 0 - 9
| colspan=1 | Views helping others as an imposition on own needs to get along with others.
|- style="border-top: 3px solid #aaa"
! rowspan=6 | ANGER
| 91 - 100
| Is in a constant state of internal rage.
| rowspan=6 | Angry creatures will <br>become {{L|Status icon|enraged}} in<br>combat more commonly.<br>The very least angry<br>creatures will never<br>become enraged.
|-
| 76 - 90
| Is very quick to anger.
|-
| 61 - 75
| Is quick to anger.
|-
| 25 - 39
| Is slow to anger.
|-
| 10 - 24
| Is very slow to anger.
|-
| 0 - 9
| Never becomes angry.
|- style="border-top: 3px solid #aaa"
! rowspan=6 | ANXIETY
| 91 - 100
| Is a nervous wreck.
|-
| 76 - 90
| Is always tense and jittery.
|-
| 61 - 75
| Is often nervous.
|-
| 25 - 39
| Has a calm demeanor.
|-
| 10 - 24
| Has a very calm demeanor.
|-
| 0 - 9
| Has an incredibly calm demeanor.
|- style="border-top: 3px solid #aaa"
! rowspan=6 | ARTISTIC_INTEREST
| 91 - 100
| Can easily become absorbed in art and the beauty of the natural world.
|-
| 76 - 90
| Greatly appreciates art and natural beauty.
|-
| 61 - 75
| Appreciates art and natural beauty.
|-
| 25 - 39
| Does not have a great aesthetic sensitivity.
|-
| 10 - 24
| Is not interested in art.
|-
| 0 - 9
| Is completely uninterested in art.
|- style="border-top: 3px solid #aaa"
! rowspan=6 | ASSERTIVENESS
| 91 - 100
| Loves to take charge and direct activities.
|-
| 76 - 90
| Is very assertive.
|-
| 61 - 75
| Is assertive.
|-
| 25 - 39
| Is unassertive.
| rowspan=3 | An unassertive dwarf (under<br>40) never gains experience<br>in the {{L|Persuader}} skill.
|-
| 10 - 24
| Prefers that others handle the leadership roles.
|-
| 0 - 9
| Never speaks out or attempts to direct activities.
|- style="border-top: 3px solid #aaa"
! rowspan=6 | CAUTIOUSNESS
| 91 - 100
| Thinks through every alternatives and their consequences before acting.
|-
| 76 - 90
| Is extremely cautious.
|-
| 61 - 75
| Takes time when making decisions.
|-
| 25 - 39
| Often does the first thing that comes to mind.
|-
| 10 - 24
| Acts impulsively.
|-
| 0 - 9
| Always acts without considering alternatives or thinking through possibilities.
|- style="border-top: 3px solid #aaa"
! rowspan=6 | CHEERFULNESS
| 91 - 100
| Often feels filled with joy.
|-
| 76 - 90
| Can be very happy and optimistic.
|-
| 61 - 75
| Is often cheerful.
|-
| 25 - 39
| Is rarely happy or enthusiastic.
|-
| 10 - 24
| Is a pessimist.
|-
| 0 - 9
| Is never optimistic or enthusiastic about anything.
|- style="border-top: 3px solid #aaa"
! rowspan=6 | COOPERATION
| 91 - 100
| Sacrifices its/his/her own needs to get along with others.
| rowspan=3 | A cooperative dwarf (over 60)<br>never gains experience<br>in the {{L|Intimidator}} skill.
|-
| 76 - 90
| Dislikes confrontations.
|-
| 61 - 75
| Is willing to compromise with others.
|-
| 25 - 39
| Doesn't like to compromise with others.
| rowspan=3 | An uncooperative dwarf (under 40)<br>never gains experience<br>in the {{L|Pacifier}} skill.
|-
| 10 - 24
| Would rather intimidate others than compromise with them.
|-
| 0 - 9
| Would never deny its/his/her own needs just to compromise with somebody else.
|- style="border-top: 3px solid #aaa"
! rowspan=6 | DEPRESSION
| 91 - 100
| Is frequently depressed.
|-
| 76 - 90
| Is often sad and dejected.
|-
| 61 - 75
| Often feels discouraged.
|-
| 25 - 39
| Rarely feels discouraged.
|-
| 10 - 24
| Almost never feels discouraged.
|-
| 0 - 9
| Never feels discouraged.
|- style="border-top: 3px solid #aaa"
! rowspan=6 | DUTIFULNESS
| 91 - 100
| Has a profound sense of duty and obligation.
|-
| 76 - 90
| Has a strong sense of duty.
|-
| 61 - 75
| Has a sense of duty.
|-
| 25 - 39
| Finds rules confining.
|-
| 10 - 24
| Dislikes contracts and regulations.
|-
| 0 - 9
| Hates rules, contracts and other confining elements in its/his/her life.
|- style="border-top: 3px solid #aaa"
! rowspan=6 | EMOTIONALITY
| 91 - 100
| Has a profound understanding of its/his/her own emotions.
|-
| 76 - 90
| Has a great awareness of its/his/her own emotions.
|-
| 61 - 75
| Has a good awareness of its/his/her own emotions.
|-
| 25 - 39
| Tends not to openly express emotions.
|-
| 10 - 24
| Is mostly unaware of its/his/her own emotions and rarely expresses them.
|-
| 0 - 9
| Does not display its/his/her own emotions and has no awareness of them.
|- style="border-top: 3px solid #aaa"
! rowspan=6 | EXCITEMENT_SEEKING
| 91 - 100
| Is highly adventurous and loves fresh experiences.
| rowspan=3 | Beings with this trait are <br>more likely to join you<br> in adventure mode.
|-
| 76 - 90
| Is eager for new experiences.
|-
| 61 - 75
| Likes to try new things.
|-
| 25 - 39
| Prefers familiar routines.
|-
| 10 - 24
| Is uncomfortable with change.
|-
| 0 - 9
| Is resistant to change.
|- style="border-top: 3px solid #aaa"
! rowspan=6 | FRIENDLINESS
| 91 - 100
| Truly treasures the company of others.
|-
| 76 - 90
| Enjoys being in crowds.
|-
| 61 - 75
| Enjoys the company of others.
|-
| 25 - 39
| Tends to avoid crowds.
|-
| 10 - 24
| Prefers to be alone.
|-
| 0 - 9
| Considers spending time alone much more important than associating with others.
|- style="border-top: 3px solid #aaa"
! rowspan=6 | GREGARIOUSNESS
| 91 - 100
| Genuinely likes others and openly expresses positive feelings toward them.
|-
| 76 - 90
| Makes friends quickly.
|-
| 61 - 75
| Is very friendly.
|-
| 25 - 39
| Is somewhat reserved.
| rowspan=3 | A reserved dwarf (under 40)<br>never gains experience in<br>the {{L|Conversationalist}} skill.
|-
| 10 - 24
| Is very distant and reserved.
|-
| 0 - 9
| Does not actively seek friendships and is incredibly distant and reserved.
|- style="border-top: 3px solid #aaa"
! rowspan=6 | IMAGINATION
| 91 - 100
| Is bored by reality and has a wonderful imagination.
|-
| 76 - 90
| Is incredibly creative.
|-
| 61 - 75
| Has a fertile imagination.
|-
| 25 - 39
| Isn't given to flights of fancy.
|-
| 10 - 24
| Is grounded in reality.
|-
| 0 - 9
| Is interested only in facts and the real world.
|- style="border-top: 3px solid #aaa"
! rowspan=6 | IMMODERATION
| 91 - 100
| Is ruled by irresistible cravings and urges.
|-
| 76 - 90
| Feels strong urges and seeks short-term rewards.
|-
| 61 - 75
| Occassionally overindulges.
|-
| 25 - 39
| Doesn't often experience strong cravings or urges.
|-
| 10 - 24
| Only rarely feels strong cravings or urges.
|-
| 0 - 9
| Never feels tempted to overindulge in anything.
|- style="border-top: 3px solid #aaa"
! rowspan=6 | INTELLECTUAL_CURIOSITY
| 91 - 100
| Is entranced by riddles and puzzles and loves to debate issues and ideas.
|-
| 76 - 90
| Loves new and fresh ideas.
|-
| 61 - 75
| Is open-minded to new ideas.
|-
| 25 - 39
| Dislikes intellectual discussions.
|-
| 10 - 24
| Regards intellectual exercises as a waste of energy.
|-
| 0 - 9
| Is completely uninterested in ideas and debates over intellectual issues.
|- style="border-top: 3px solid #aaa"
! rowspan=6 | LIBERALISM
| 91 - 100
| Revels in chaos and disorder.
|-
| 76 - 90
| Loves to defy convention.
|-
| 61 - 75
| Is put off by authority and tradition.
|-
| 25 - 39
| Admires tradition.
|-
| 10 - 24
| Prefers stability and security to ambiguity and disorder.
|-
| 0 - 9
| Is an ardent believer in convention and traditional society.
|- style="border-top: 3px solid #aaa"
! rowspan=6 | MODESTY
| 91 - 100
| Would never claim to be better than somebody else.
|-
| 76 - 90
| Finds immodesty distasteful.
|-
| 61 - 75
| Is modest.
|-
| 25 - 39
| Is immodest.
|-
| 10 - 24
| Is very willing to compare itself/himself/herself favorably with others.
|-
| 0 - 9
| Would never shy away from an opportunity to say it/he/she is better than somebody else.
|- style="border-top: 3px solid #aaa"
! rowspan=6 | ORDERLINESS
| 91 - 100
| Loves to make lists and keep schedules.
|-
| 76 - 90
| Tries to live a well-organized life.
|-
| 61 - 75
| Is organized.
|-
| 25 - 39
| Is disorganized.
|-
| 10 - 24
| Is very disorganized.
|-
| 0 - 9
| Is completely disorganized.
|- style="border-top: 3px solid #aaa"
! rowspan=6 | SELF_CONSCIOUSNESS
| 91 - 100
| Is socially crippled by thoughts that everyone is watching and judging it/him/her.
| rowspan=2 valign=top | A very self-conscious dwarf (over 75)<br>never gains experience<br>in the {{L|Comedian}} skill.
|-
| 76 - 90
| Is concerned about rejection and ridicule.
|-
| 61 - 75
| Is self-conscious.
|-
| 25 - 39
| Is comfortable in social situations.
|-
| 10 - 24
| Is very comfortable in social situations.
|-
| 0 - 9
| Is absolutely unfazed by the opinions of others.
|- style="border-top: 3px solid #aaa"
! rowspan=6 | SELF_DISCIPLINE
| 91 - 100
| Will persist in the face of any difficulty until the task is complete.
| rowspan=6 | Self-discipline affects<br> how long the {{L|on break|breaks}} a<br> dwarf takes are.
|-
| 76 - 90
| Possesses great willpower.
|-
| 61 - 75
| Is self-disciplined.
|-
| 25 - 39
| Is occasionally given to procrastination.
|-
| 10 - 24
| Has very little self-discipline.
|-
| 0 - 9
| Rarely completes tasks and is often overcome by distractions.
|- style="border-top: 3px solid #aaa"
! rowspan=6 | SELF_EFFICACY
| 91 - 100
| Is incredibly confident.
|-
| 76 - 90
| Is very confident.
|-
| 61 - 75
| Is confident.
|-
| 25 - 39
| Lacks confidence.
|-
| 10 - 24
| Does not feel effective in life.
|-
| 0 - 9
| Feels as if it/he/she is not in control of its/his/her life.
|- style="border-top: 3px solid #aaa"
! rowspan=6 | STRAIGHTFORWARDNESS
| 91 - 100
| Is incredibly frank and candid in dealings with others.
| rowspan=3 | A straightforward dwarf (over 60)<br>never gains experience<br>in the {{L|Flatterer}} skill.
|-
| 76 - 90
| Is very straightforward with others.
|-
| 61 - 75
| Is candid and sincere in dealings with others.
|-
| 25 - 39
| Is guarded in {{L|relationship|relationships}} with others.
| rowspan=3 | Guarded dwarves (under 40) never<br>gain experience in the {{L|Consoler}} <br>skill, and are the only ones to<br>gain experience in the {{L|Liar}} skill.
|-
| 10 - 24
| Is not straightforward when dealing with others.
|-
| 0 - 9
| Believes that some deception is necessary in relationships with others.
|- style="border-top: 3px solid #aaa"
! rowspan=6 | SYMPATHY
| 91 - 100
| Is incredibly compassionate and feels the pain of others.
|-
| 76 - 90
| Is easily moved to pity.
|-
| 61 - 75
| Is compassionate.
|-
| 25 - 39
| Is not easily moved to pity.
|-
| 10 - 24
| Is not affected by the suffering of others.
|-
| 0 - 9
| Would never let an objective judgement be tempered by mercy or pity.
|- style="border-top: 3px solid #aaa"
! rowspan=6 | TRUST
| 91 - 100
| Is naturally trustful of everybody.
|-
| 76 - 90
| Is very trusting.
|-
| 61 - 75
| Is trusting.
|-
| 25 - 39
| Is slow to trust others.
|-
| 10 - 24
| Does not trust others.
|-
| 0 - 9
| Sees others as selfish and conniving.
|- style="border-top: 3px solid #aaa"
! rowspan=6 | VULNERABILITY
| 91 - 100
| Becomes completely helpless in stressful situations.
|-
| 76 - 90
| Cracks easily under pressure.
|-
| 61 - 75
| Doesn't handle stress well.
|-
| 25 - 39
| Can handle stress.
|-
| 10 - 24
| Is confident under pressure.
|-
| 0 - 9
| Is impervious to the effects of stress.
|}

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

v0.31:Personality facet

2011-01-21T08:30:42Z

3: More info

v0.31:Personality facet

2011-01-21T08:07:15Z

3: Fixed a link

{{quality|Tattered|~~}}{{av}}

Dwarven personalities are determined by a set of traits. These traits are distinct from {{L|attributes}}.

Personality traits are shown in a dwarf's "thoughts and preferences" description page, which can be accessed by {{k|v}}iewing that dwarf then {{k|p}}, {{k|z}}, {{k|Enter}}, or from the {{k|u}}nit menu with {{k|v}}iew, {{k|Enter}}.

Each trait varies from 1 (lowest possible) to 100 (highest possible), but are categorised as below.

Traits are also influenced by species via the use of the PERSONALITY {{L|creature token}}. For example, dwarves are slightly more straightforward than average with a median of 55 in that trait, whereas goblins aren't likely to help others out - their altruism median is a mere 25, and is capped at 50.

Traits also have an effect on which social skills are learned in social interaction, and determine whether certain actions may give a good or bad {{L|thought}}. Traits may have other, more subtle effects on creature behaviour, which are currently not entirely understood.

{| {{prettytable}}
|- style="background:#ddd"
! Token
! Value
! Description
! Gameplay effects
|- style="border-top: 3px solid #aaa"
! rowspan=6 | ACHIEVEMENT_STRIVING
| 91 - 100
|Constantly strives for perfection.
|-
| 76 - 90
|Thinks it is incredibly important to strive for excellence.
|-
| 61 - 75
|Strives for excellence.
|-
| 25 - 39
|Doesn't go out of its/his/her way to do more work than necessary.
|-
| 10 - 24
|Very rarely does more work than necessary.
|-
| 0 - 9
|Does the bare minimum necessary to accomplish the task at hand.
|- style="border-top: 3px solid #aaa"
! rowspan=6 | ACTIVITY_LEVEL
| style="width:4em" | 91 - 100
| Is constantly active and energetic.
|-
| 76 - 90
| Is very energetic and active.
|-
| 61 - 75
| Is very active.
|-
| 25 - 39
| Is relaxed.
|-
| 10 - 24
| Lives life at a leisurely pace.
|-
| 0 - 9
| Can't be bothered with frantic, fast-paced living.
|- style="border-top: 3px solid #aaa"
! rowspan=6 | ADVENTUROUSNESS
| 91 - 100
|Lives for risk and excitement.
|-
| 76 - 90
|Is a risk-taker and a thrill-seeker.
|-
| 61 - 75
|Loves a good thrill.
|-
| 25 - 39
|Is not a risk-taker.
|-
| 10 - 24
|Doesn't need thrills or risks in life.
|-
| 0 - 9
|Is entirely adverse to risk and excitement.
|- style="border-top: 3px solid #aaa"
! rowspan=6 | ALTRUISM
| 91 - 100
| Is truly fulfilled by assisting those in need.
|-
| 76 - 90
| Finds helping others very rewarding.
|-
| 61 - 75
| Finds helping others rewarding.
|-
| 25 - 39
| Does not go out of its/his/her way to help others.
|-
| 10 - 24
| colspan=1 | Dislikes helping others.
|-
| 0 - 9
| colspan=1 | Views helping others as an imposition on own needs to get along with others.
|- style="border-top: 3px solid #aaa"
! rowspan=6 | ANGER
| 91 - 100
| Is in a constant state of internal rage.
| rowspan=6 | Angry creatures will <br>become {{L|Status icon|enraged}} in<br>combat more commonly.<br>The very least angry<br>creatures will never<br>become enraged.
|-
| 76 - 90
| Is very quick to anger.
|-
| 61 - 75
| Is quick to anger.
|-
| 25 - 39
| Is slow to anger.
|-
| 10 - 24
| Is very slow to anger.
|-
| 0 - 9
| Never becomes angry.
|- style="border-top: 3px solid #aaa"
! rowspan=6 | ANXIETY
| 91 - 100
| Is a nervous wreck.
|-
| 76 - 90
| Is always tense and jittery.
|-
| 61 - 75
| Is often nervous.
|-
| 25 - 39
| Has a calm demeanor.
|-
| 10 - 24
| Has a very calm demeanor.
|-
| 0 - 9
| Has an incredibly calm demeanor.
|- style="border-top: 3px solid #aaa"
! rowspan=6 | ARTISTIC_INTEREST
| 91 - 100
| Can easily become absorbed in art and the beauty of the natural world.
|-
| 76 - 90
| Greatly appreciates art and natural beauty.
|-
| 61 - 75
| Appreciates art and natural beauty.
|-
| 25 - 39
| Does not have a great aesthetic sensitivity.
|-
| 10 - 24
| Is not interested in art.
|-
| 0 - 9
| Is completely uninterested in art.
|- style="border-top: 3px solid #aaa"
! rowspan=6 | ASSERTIVENESS
| 91 - 100
| Loves to take charge and direct activities.
|-
| 76 - 90
| Is very assertive.
|-
| 61 - 75
| Is assertive.
|-
| 25 - 39
| Is unassertive.
|-
| 10 - 24
| Prefers that others handle the leadership roles.
|-
| 0 - 9
| Never speaks out or attempts to direct activities.
|- style="border-top: 3px solid #aaa"
! rowspan=6 | CAUTIOUSNESS
| 91 - 100
| Thinks through every alternatives and their consequences before acting.
|-
| 76 - 90
| Is extremely cautious.
|-
| 61 - 75
| Takes time when making decisions.
|-
| 25 - 39
| Often does the first thing that comes to mind.
|-
| 10 - 24
| Acts impulsively.
|-
| 0 - 9
| Always acts without considering alternatives or thinking through possibilities.
|- style="border-top: 3px solid #aaa"
! rowspan=6 | CHEERFULNESS
| 91 - 100
| Often feels filled with joy.
|-
| 76 - 90
| Can be very happy and optimistic.
|-
| 61 - 75
| Is often cheerful.
|-
| 25 - 39
| Is rarely happy or enthusiastic.
|-
| 10 - 24
| Is a pessimist.
|-
| 0 - 9
| Is never optimistic or enthusiastic about anything.
|- style="border-top: 3px solid #aaa"
! rowspan=6 | COOPERATION
| 91 - 100
| Sacrifices its/his/her own needs to get along with others.
|-
| 76 - 90
| Dislikes confrontations.
|-
| 61 - 75
| Is willing to compromise with others.
|-
| 25 - 39
| Doesn't like to compromise with others.
|-
| 10 - 24
| Would rather intimidate others than compromise with them.
|-
| 0 - 9
| Would never deny its/his/her own needs just to compromise with somebody else.
|- style="border-top: 3px solid #aaa"
! rowspan=6 | DEPRESSION
| 91 - 100
| Is frequently depressed.
|-
| 76 - 90
| Is often sad and dejected.
|-
| 61 - 75
| Often feels discouraged.
|-
| 25 - 39
| Rarely feels discouraged.
|-
| 10 - 24
| Almost never feels discouraged.
|-
| 0 - 9
| Never feels discouraged.
|- style="border-top: 3px solid #aaa"
! rowspan=6 | DUTIFULNESS
| 91 - 100
| Has a profound sense of duty and obligation.
|-
| 76 - 90
| Has a strong sense of duty.
|-
| 61 - 75
| Has a sense of duty.
|-
| 25 - 39
| Finds rules confining.
|-
| 10 - 24
| Dislikes contracts and regulations.
|-
| 0 - 9
| Hates rules, contracts and other confining elements in its/his/her life.
|- style="border-top: 3px solid #aaa"
! rowspan=6 | EMOTIONALITY
| 91 - 100
| Has a profound understanding of its/his/her own emotions.
|-
| 76 - 90
| Has a great awareness of its/his/her own emotions.
|-
| 61 - 75
| Has a good awareness of its/his/her own emotions.
|-
| 25 - 39
| Tends not to openly express emotions.
|-
| 10 - 24
| Is mostly unaware of its/his/her own emotions and rarely expresses them.
|-
| 0 - 9
| Does not display its/his/her own emotions and has no awareness of them.
|- style="border-top: 3px solid #aaa"
! rowspan=6 | EXCITEMENT_SEEKING
| 91 - 100
| Is highly adventurous and loves fresh experiences.
| rowspan=3 | Beings with this trait are <br>more likely to join you<br> in adventure mode.
|-
| 76 - 90
| Is eager for new experiences.
|-
| 61 - 75
| Likes to try new things.
|-
| 25 - 39
| Prefers familiar routines.
|-
| 10 - 24
| Is uncomfortable with change.
|-
| 0 - 9
| Is resistant to change.
|- style="border-top: 3px solid #aaa"
! rowspan=6 | FRIENDLINESS
| 91 - 100
| Truly treasures the company of others.
|-
| 76 - 90
| Enjoys being in crowds.
|-
| 61 - 75
| Enjoys the company of others.
|-
| 25 - 39
| Tends to avoid crowds.
|-
| 10 - 24
| Prefers to be alone.
|-
| 0 - 9
| Considers spending time alone much more important than associating with others.
|- style="border-top: 3px solid #aaa"
! rowspan=6 | GREGARIOUSNESS
| 91 - 100
| Genuinely likes others and openly expresses positive feelings toward them.
|-
| 76 - 90
| Makes friends quickly.
|-
| 61 - 75
| Is very friendly.
|-
| 25 - 39
| Is somewhat reserved.
|-
| 10 - 24
| Is very distant and reserved.
|-
| 0 - 9
| Does not actively seek friendships and is incredibly distant and reserved.
|- style="border-top: 3px solid #aaa"
! rowspan=6 | IMAGINATION
| 91 - 100
| Is bored by reality and has a wonderful imagination.
|-
| 76 - 90
| Is incredibly creative.
|-
| 61 - 75
| Has a fertile imagination.
|-
| 25 - 39
| Isn't given to flights of fancy.
|-
| 10 - 24
| Is grounded in reality.
|-
| 0 - 9
| Is interested only in facts and the real world.
|- style="border-top: 3px solid #aaa"
! rowspan=6 | IMMODERATION
| 91 - 100
| Is ruled by irresistible cravings and urges.
|-
| 76 - 90
| Feels strong urges and seeks short-term rewards.
|-
| 61 - 75
| Occassionally overindulges.
|-
| 25 - 39
| Doesn't often experience strong cravings or urges.
|-
| 10 - 24
| Only rarely feels strong cravings or urges.
|-
| 0 - 9
| Never feels tempted to overindulge in anything.
|- style="border-top: 3px solid #aaa"
! rowspan=6 | INTELLECTUAL_CURIOSITY
| 91 - 100
| Is entranced by riddles and puzzles and loves to debate issues and ideas.
|-
| 76 - 90
| Loves new and fresh ideas.
|-
| 61 - 75
| Is open-minded to new ideas.
|-
| 25 - 39
| Dislikes intellectual discussions.
|-
| 10 - 24
| Regards intellectual exercises as a waste of energy.
|-
| 0 - 9
| Is completely uninterested in ideas and debates over intellectual issues.
|- style="border-top: 3px solid #aaa"
! rowspan=6 | LIBERALISM
| 91 - 100
| Revels in chaos and disorder.
|-
| 76 - 90
| Loves to defy convention.
|-
| 61 - 75
| Is put off by authority and tradition.
|-
| 25 - 39
| Admires tradition.
|-
| 10 - 24
| Prefers stability and security to ambiguity and disorder.
|-
| 0 - 9
| Is an ardent believer in convention and traditional society.
|- style="border-top: 3px solid #aaa"
! rowspan=6 | MODESTY
| 91 - 100
| Would never claim to be better than somebody else.
|-
| 76 - 90
| Finds immodesty distasteful.
|-
| 61 - 75
| Is modest.
|-
| 25 - 39
| Is immodest.
|-
| 10 - 24
| Is very willing to compare itself/himself/herself favorably with others.
|-
| 0 - 9
| Would never shy away from an opportunity to say it/he/she is better than somebody else.
|- style="border-top: 3px solid #aaa"
! rowspan=6 | ORDERLINESS
| 91 - 100
| Loves to make lists and keep schedules.
|-
| 76 - 90
| Tries to live a well-organized life.
|-
| 61 - 75
| Is organized.
|-
| 25 - 39
| Is disorganized.
|-
| 10 - 24
| Is very disorganized.
|-
| 0 - 9
| Is completely disorganized.
|- style="border-top: 3px solid #aaa"
! rowspan=6 | SELF_CONSCIOUSNESS
| 91 - 100
| Is socially crippled by thoughts that everyone is watching and judging it/him/her.
|-
| 76 - 90
| Is concerned about rejection and ridicule.
|-
| 61 - 75
| Is self-conscious.
|-
| 25 - 39
| Is comfortable in social situations.
|-
| 10 - 24
| Is very comfortable in social situations.
|-
| 0 - 9
| Is absolutely unfazed by the opinions of others.
|- style="border-top: 3px solid #aaa"
! rowspan=6 | SELF_DISCIPLINE
| 91 - 100
| Will persist in the face of any difficulty until the task is complete.
|-
| 76 - 90
| Possesses great willpower.
|-
| 61 - 75
| Is self-disciplined.
|-
| 25 - 39
| Is occasionally given to procrastination.
|-
| 10 - 24
| Has very little self-discipline.
|-
| 0 - 9
| Rarely completes tasks and is often overcome by distractions.
|- style="border-top: 3px solid #aaa"
! rowspan=6 | SELF_EFFICACY
| 91 - 100
| Is incredibly confident.
|-
| 76 - 90
| Is very confident.
|-
| 61 - 75
| Is confident.
|-
| 25 - 39
| Lacks confidence.
|-
| 10 - 24
| Does not feel effective in life.
|-
| 0 - 9
| Feels as if it/he/she is not in control of its/his/her life.
|- style="border-top: 3px solid #aaa"
! rowspan=6 | STRAIGHTFORWARDNESS
| 91 - 100
| Is incredibly frank and candid in dealings with others.
|-
| 76 - 90
| Is very straightforward with others.
|-
| 61 - 75
| Is candid and sincere in dealings with others.
|-
| 25 - 39
| Is guarded in {{L|relationship|relationships}} with others.
|-
| 10 - 24
| Is not straightforward when dealing with others.
|-
| 0 - 9
| Believes that some deception is necessary in relationships with others.
|- style="border-top: 3px solid #aaa"
! rowspan=6 | SYMPATHY
| 91 - 100
| Is incredibly compassionate and feels the pain of others.
|-
| 76 - 90
| Is easily moved to pity.
|-
| 61 - 75
| Is compassionate.
|-
| 25 - 39
| Is not easily moved to pity.
|-
| 10 - 24
| Is not affected by the suffering of others.
|-
| 0 - 9
| Would never let an objective judgement be tempered by mercy or pity.
|- style="border-top: 3px solid #aaa"
! rowspan=6 | TRUST
| 91 - 100
| Is naturally trustful of everybody.
|-
| 76 - 90
| Is very trusting.
|-
| 61 - 75
| Is trusting.
|-
| 25 - 39
| Is slow to trust others.
|-
| 10 - 24
| Does not trust others.
|-
| 0 - 9
| Sees others as selfish and conniving.
|- style="border-top: 3px solid #aaa"
! rowspan=6 | VULNERABILITY
| 91 - 100
| Becomes completely helpless in stressful situations.
|-
| 76 - 90
| Cracks easily under pressure.
|-
| 61 - 75
| Doesn't handle stress well.
|-
| 25 - 39
| Can handle stress.
|-
| 10 - 24
| Is confident under pressure.
|-
| 0 - 9
| Is impervious to the effects of stress.
|}

v0.31:Personality facet

2011-01-21T07:49:54Z

3: Copied some things across from 40d page, cleaned up the table, added confirmed info on ANGER effects

{{quality|Tattered|~~}}{{av}}

Dwarven personalities are determined by a set of traits. These traits are distinct from {{L|attributes}}.

Personality traits are shown in a dwarf's "thoughts and preferences" description page, which can be accessed by {{k|v}}iewing that dwarf then {{k|p}}, {{k|z}}, {{k|Enter}}, or from the {{k|u}}nit menu with {{k|v}}iew, {{k|Enter}}.

Each trait varies from 1 (lowest possible) to 100 (highest possible), but are categorised as below.

Traits are also influenced by species via the use of the PERSONALITY {{L|creature token}}. For example, dwarves are slightly more straightforward than average with a median of 55 in that trait, whereas goblins aren't likely to help others out - their altruism median is a mere 25, and is capped at 50.

Traits also have an effect on which social skills are learned in social interaction, and determine whether certain actions may give a good or bad {{L|thought}}. Traits may have other, more subtle effects on creature behaviour, which are currently not entirely understood.

{| {{prettytable}}
|- style="background:#ddd"
! Token
! Value
! Description
! Gameplay effects
|- style="border-top: 3px solid #aaa"
! rowspan=6 | ACHIEVEMENT_STRIVING
| 91 - 100
|Constantly strives for perfection.
|-
| 76 - 90
|Thinks it is incredibly important to strive for excellence.
|-
| 61 - 75
|Strives for excellence.
|-
| 25 - 39
|Doesn't go out of its/his/her way to do more work than necessary.
|-
| 10 - 24
|Very rarely does more work than necessary.
|-
| 0 - 9
|Does the bare minimum necessary to accomplish the task at hand.
|- style="border-top: 3px solid #aaa"
! rowspan=6 | ACTIVITY_LEVEL
| style="width:4em" | 91 - 100
| Is constantly active and energetic.
|-
| 76 - 90
| Is very energetic and active.
|-
| 61 - 75
| Is very active.
|-
| 25 - 39
| Is relaxed.
|-
| 10 - 24
| Lives life at a leisurely pace.
|-
| 0 - 9
| Can't be bothered with frantic, fast-paced living.
|- style="border-top: 3px solid #aaa"
! rowspan=6 | ADVENTUROUSNESS
| 91 - 100
|Lives for risk and excitement.
|-
| 76 - 90
|Is a risk-taker and a thrill-seeker.
|-
| 61 - 75
|Loves a good thrill.
|-
| 25 - 39
|Is not a risk-taker.
|-
| 10 - 24
|Doesn't need thrills or risks in life.
|-
| 0 - 9
|Is entirely adverse to risk and excitement.
|- style="border-top: 3px solid #aaa"
! rowspan=6 | ALTRUISM
| 91 - 100
| Is truly fulfilled by assisting those in need.
|-
| 76 - 90
| Finds helping others very rewarding.
|-
| 61 - 75
| Finds helping others rewarding.
|-
| 25 - 39
| Does not go out of its/his/her way to help others.
|-
| 10 - 24
| colspan=1 | Dislikes helping others.
|-
| 0 - 9
| colspan=1 | Views helping others as an imposition on own needs to get along with others.
|- style="border-top: 3px solid #aaa"
! rowspan=6 | ANGER
| 91 - 100
| Is in a constant state of internal rage.
| rowspan=6 | Angry creatures will <br>become {{L|Status icon|enraged}} in<br>combat more commonly.<br>The very least angry<br>creatures will never<br>become enraged.
|-
| 76 - 90
| Is very quick to anger.
|-
| 61 - 75
| Is quick to anger.
|-
| 25 - 39
| Is slow to anger.
|-
| 10 - 24
| Is very slow to anger.
|-
| 0 - 9
| Never becomes angry.
|- style="border-top: 3px solid #aaa"
! rowspan=6 | ANXIETY
| 91 - 100
| Is a nervous wreck.
|-
| 76 - 90
| Is always tense and jittery.
|-
| 61 - 75
| Is often nervous.
|-
| 25 - 39
| Has a calm demeanor.
|-
| 10 - 24
| Has a very calm demeanor.
|-
| 0 - 9
| Has an incredibly calm demeanor.
|- style="border-top: 3px solid #aaa"
! rowspan=6 | ARTISTIC_INTEREST
| 91 - 100
| Can easily become absorbed in art and the beauty of the natural world.
|-
| 76 - 90
| Greatly appreciates art and natural beauty.
|-
| 61 - 75
| Appreciates art and natural beauty.
|-
| 25 - 39
| Does not have a great aesthetic sensitivity.
|-
| 10 - 24
| Is not interested in art.
|-
| 0 - 9
| Is completely uninterested in art.
|- style="border-top: 3px solid #aaa"
! rowspan=6 | ASSERTIVENESS
| 91 - 100
| Loves to take charge and direct activities.
|-
| 76 - 90
| Is very assertive.
|-
| 61 - 75
| Is assertive.
|-
| 25 - 39
| Is unassertive.
|-
| 10 - 24
| Prefers that others handle the leadership roles.
|-
| 0 - 9
| Never speaks out or attempts to direct activities.
|- style="border-top: 3px solid #aaa"
! rowspan=6 | CAUTIOUSNESS
| 91 - 100
| Thinks through every alternatives and their consequences before acting.
|-
| 76 - 90
| Is extremely cautious.
|-
| 61 - 75
| Takes time when making decisions.
|-
| 25 - 39
| Often does the first thing that comes to mind.
|-
| 10 - 24
| Acts impulsively.
|-
| 0 - 9
| Always acts without considering alternatives or thinking through possibilities.
|- style="border-top: 3px solid #aaa"
! rowspan=6 | CHEERFULNESS
| 91 - 100
| Often feels filled with joy.
|-
| 76 - 90
| Can be very happy and optimistic.
|-
| 61 - 75
| Is often cheerful.
|-
| 25 - 39
| Is rarely happy or enthusiastic.
|-
| 10 - 24
| Is a pessimist.
|-
| 0 - 9
| Is never optimistic or enthusiastic about anything.
|- style="border-top: 3px solid #aaa"
! rowspan=6 | COOPERATION
| 91 - 100
| Sacrifices its/his/her own needs to get along with others.
|-
| 76 - 90
| Dislikes confrontations.
|-
| 61 - 75
| Is willing to compromise with others.
|-
| 25 - 39
| Doesn't like to compromise with others.
|-
| 10 - 24
| Would rather intimidate others than compromise with them.
|-
| 0 - 9
| Would never deny its/his/her own needs just to compromise with somebody else.
|- style="border-top: 3px solid #aaa"
! rowspan=6 | DEPRESSION
| 91 - 100
| Is frequently depressed.
|-
| 76 - 90
| Is often sad and dejected.
|-
| 61 - 75
| Often feels discouraged.
|-
| 25 - 39
| Rarely feels discouraged.
|-
| 10 - 24
| Almost never feels discouraged.
|-
| 0 - 9
| Never feels discouraged.
|- style="border-top: 3px solid #aaa"
! rowspan=6 | DUTIFULNESS
| 91 - 100
| Has a profound sense of duty and obligation.
|-
| 76 - 90
| Has a strong sense of duty.
|-
| 61 - 75
| Has a sense of duty.
|-
| 25 - 39
| Finds rules confining.
|-
| 10 - 24
| Dislikes contracts and regulations.
|-
| 0 - 9
| Hates rules, contracts and other confining elements in its/his/her life.
|- style="border-top: 3px solid #aaa"
! rowspan=6 | EMOTIONALITY
| 91 - 100
| Has a profound understanding of its/his/her own emotions.
|-
| 76 - 90
| Has a great awareness of its/his/her own emotions.
|-
| 61 - 75
| Has a good awareness of its/his/her own emotions.
|-
| 25 - 39
| Tends not to openly express emotions.
|-
| 10 - 24
| Is mostly unaware of its/his/her own emotions and rarely expresses them.
|-
| 0 - 9
| Does not display its/his/her own emotions and has no awareness of them.
|- style="border-top: 3px solid #aaa"
! rowspan=6 | EXCITEMENT_SEEKING
| 91 - 100
| Is highly adventurous and loves fresh experiences.
| rowspan=3 | Beings with this trait are <br>more likely to join you<br> in adventure mode.
|-
| 76 - 90
| Is eager for new experiences.
|-
| 61 - 75
| Likes to try new things.
|-
| 25 - 39
| Prefers familiar routines.
|-
| 10 - 24
| Is uncomfortable with change.
|-
| 0 - 9
| Is resistant to change.
|- style="border-top: 3px solid #aaa"
! rowspan=6 | FRIENDLINESS
| 91 - 100
| Truly treasures the company of others.
|-
| 76 - 90
| Enjoys being in crowds.
|-
| 61 - 75
| Enjoys the company of others.
|-
| 25 - 39
| Tends to avoid crowds.
|-
| 10 - 24
| Prefers to be alone.
|-
| 0 - 9
| Considers spending time alone much more important than associating with others.
|- style="border-top: 3px solid #aaa"
! rowspan=6 | GREGARIOUSNESS
| 91 - 100
| Genuinely likes others and openly expresses positive feelings toward them.
|-
| 76 - 90
| Makes friends quickly.
|-
| 61 - 75
| Is very friendly.
|-
| 25 - 39
| Is somewhat reserved.
|-
| 10 - 24
| Is very distant and reserved.
|-
| 0 - 9
| Does not actively seek friendships and is incredibly distant and reserved.
|- style="border-top: 3px solid #aaa"
! rowspan=6 | IMAGINATION
| 91 - 100
| Is bored by reality and has a wonderful imagination.
|-
| 76 - 90
| Is incredibly creative.
|-
| 61 - 75
| Has a fertile imagination.
|-
| 25 - 39
| Isn't given to flights of fancy.
|-
| 10 - 24
| Is grounded in reality.
|-
| 0 - 9
| Is interested only in facts and the real world.
|- style="border-top: 3px solid #aaa"
! rowspan=6 | IMMODERATION
| 91 - 100
| Is ruled by irresistible cravings and urges.
|-
| 76 - 90
| Feels strong urges and seeks short-term rewards.
|-
| 61 - 75
| Occassionally overindulges.
|-
| 25 - 39
| Doesn't often experience strong cravings or urges.
|-
| 10 - 24
| Only rarely feels strong cravings or urges.
|-
| 0 - 9
| Never feels tempted to overindulge in anything.
|- style="border-top: 3px solid #aaa"
! rowspan=6 | INTELLECTUAL_CURIOSITY
| 91 - 100
| Is entranced by riddles and puzzles and loves to debate issues and ideas.
|-
| 76 - 90
| Loves new and fresh ideas.
|-
| 61 - 75
| Is open-minded to new ideas.
|-
| 25 - 39
| Dislikes intellectual discussions.
|-
| 10 - 24
| Regards intellectual exercises as a waste of energy.
|-
| 0 - 9
| Is completely uninterested in ideas and debates over intellectual issues.
|- style="border-top: 3px solid #aaa"
! rowspan=6 | LIBERALISM
| 91 - 100
| Revels in chaos and disorder.
|-
| 76 - 90
| Loves to defy convention.
|-
| 61 - 75
| Is put off by authority and tradition.
|-
| 25 - 39
| Admires tradition.
|-
| 10 - 24
| Prefers stability and security to ambiguity and disorder.
|-
| 0 - 9
| Is an ardent believer in convention and traditional society.
|- style="border-top: 3px solid #aaa"
! rowspan=6 | MODESTY
| 91 - 100
| Would never claim to be better than somebody else.
|-
| 76 - 90
| Finds immodesty distasteful.
|-
| 61 - 75
| Is modest.
|-
| 25 - 39
| Is immodest.
|-
| 10 - 24
| Is very willing to compare itself/himself/herself favorably with others.
|-
| 0 - 9
| Would never shy away from an opportunity to say it/he/she is better than somebody else.
|- style="border-top: 3px solid #aaa"
! rowspan=6 | ORDERLINESS
| 91 - 100
| Loves to make lists and keep schedules.
|-
| 76 - 90
| Tries to live a well-organized life.
|-
| 61 - 75
| Is organized.
|-
| 25 - 39
| Is disorganized.
|-
| 10 - 24
| Is very disorganized.
|-
| 0 - 9
| Is completely disorganized.
|- style="border-top: 3px solid #aaa"
! rowspan=6 | SELF_CONSCIOUSNESS
| 91 - 100
| Is socially crippled by thoughts that everyone is watching and judging it/him/her.
|-
| 76 - 90
| Is concerned about rejection and ridicule.
|-
| 61 - 75
| Is self-conscious.
|-
| 25 - 39
| Is comfortable in social situations.
|-
| 10 - 24
| Is very comfortable in social situations.
|-
| 0 - 9
| Is absolutely unfazed by the opinions of others.
|- style="border-top: 3px solid #aaa"
! rowspan=6 | SELF_DISCIPLINE
| 91 - 100
| Will persist in the face of any difficulty until the task is complete.
|-
| 76 - 90
| Possesses great willpower.
|-
| 61 - 75
| Is self-disciplined.
|-
| 25 - 39
| Is occasionally given to procrastination.
|-
| 10 - 24
| Has very little self-discipline.
|-
| 0 - 9
| Rarely completes tasks and is often overcome by distractions.
|- style="border-top: 3px solid #aaa"
! rowspan=6 | SELF_EFFICACY
| 91 - 100
| Is incredibly confident.
|-
| 76 - 90
| Is very confident.
|-
| 61 - 75
| Is confident.
|-
| 25 - 39
| Lacks confidence.
|-
| 10 - 24
| Does not feel effective in life.
|-
| 0 - 9
| Feels as if it/he/she is not in control of its/his/her life.
|- style="border-top: 3px solid #aaa"
! rowspan=6 | STRAIGHTFORWARDNESS
| 91 - 100
| Is incredibly frank and candid in dealings with others.
|-
| 76 - 90
| Is very straightforward with others.
|-
| 61 - 75
| Is candid and sincere in dealings with others.
|-
| 25 - 39
| Is guarded in {{L|relationships}} with others.
|-
| 10 - 24
| Is not straightforward when dealing with others.
|-
| 0 - 9
| Believes that some deception is necessary in relationships with others.
|- style="border-top: 3px solid #aaa"
! rowspan=6 | SYMPATHY
| 91 - 100
| Is incredibly compassionate and feels the pain of others.
|-
| 76 - 90
| Is easily moved to pity.
|-
| 61 - 75
| Is compassionate.
|-
| 25 - 39
| Is not easily moved to pity.
|-
| 10 - 24
| Is not affected by the suffering of others.
|-
| 0 - 9
| Would never let an objective judgement be tempered by mercy or pity.
|- style="border-top: 3px solid #aaa"
! rowspan=6 | TRUST
| 91 - 100
| Is naturally trustful of everybody.
|-
| 76 - 90
| Is very trusting.
|-
| 61 - 75
| Is trusting.
|-
| 25 - 39
| Is slow to trust others.
|-
| 10 - 24
| Does not trust others.
|-
| 0 - 9
| Sees others as selfish and conniving.
|- style="border-top: 3px solid #aaa"
! rowspan=6 | VULNERABILITY
| 91 - 100
| Becomes completely helpless in stressful situations.
|-
| 76 - 90
| Cracks easily under pressure.
|-
| 61 - 75
| Doesn't handle stress well.
|-
| 25 - 39
| Can handle stress.
|-
| 10 - 24
| Is confident under pressure.
|-
| 0 - 9
| Is impervious to the effects of stress.
|}

v0.31 Talk:Modding guide

2010-12-06T04:37:31Z

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

v0.31:Modding guide

2010-12-02T22:47:02Z

3: Added info on caste system, plants, linked to utilities forum thread

{{av}}{{Quality|Masterwork}}

This is intended to be a guide to inform those new to DF modding on what elements of the game can be modified, and how. After reading through this guide, a user should be capable of both editing creatures, entities, materials et al, and creating their own.

Generally breaking stuff is fine - nothing that can be changed will affect the DF executable, and new additions can be easily removed.

This guide is based on a guide originally created for version 0.27.176.39c (originally put to type by one Teldin; page found [[40d:Modding guide|here]]) and has later been rewritten for 0.31.xx.xx by (a) different author(s).

'''See also:''' [[:Category:DF2010:Modding]]

= Modding Guide =

== Basics of DF modding ==

All the base data that can be edited by prospective modders can be found in the \raw\ folder. This folder contains two subfolders: "graphics" (where you insert {{L|Graphics set repository|graphics sets}}), and "objects", which contains all the data for generally everything in the game that is not hardcoded (randomly created creatures aside).

Within the \raw\objects folder are a large number of text files - these are the {{L|raw file|raw files}}, and editing them is quite easy - you can also create your own if you wish. For now, take a look at one of the existing files. It should look something like this:

creature_standard

[OBJECT:CREATURE]

[CREATURE:DWARF]
[DESCRIPTION:A short, sturdy creature fond of drink and industry.]
[NAME:dwarf:dwarves:dwarven]
[CASTE_NAME:dwarf:dwarves:dwarven]
[CREATURE_TILE:1][COLOR:3:0:0]
[CREATURE_SOLDIER_TILE:2]
...

As you can see, each file is comprised of a header string stating the file name, a second header stating the type of object data it contains, followed by the contents of the file itself. These are all necessary elements of the file, and without them, the file won't be parsed correctly by the game. You may have also noticed the file naming scheme - this is also important; files containing creatures have names starting with "creature_", entity file names must begin with "entity_", etc..

Below the headers, there begins a list of entries. Each entry is made up of its own header (in this case, "[CREATURE:DWARF]"), again stating the type of object, and then the object's unique identifier - if an indentifier isn't unique, the game will mess up and you'll get some serious, and potentially very trippy, errors. Below that, we have the body of the entry, which determines the entry's specific properties.

The body of an entry is made up of a series of "tokens", which are essentially flags that can be added or removed to affect the entry's attributes. Most of these effects are hardcoded: for example, it's possible to make a creature only eat meat with the [CARNIVOUROUS] token, but it's impossible to create your own token detailing a specific diet for the creature.

Before we continue, a few key things to remember when modding the raw files:

* Personally speaking, I don't recommend modifying the existing raw files, but if you want to edit an already-exiting creature, always back up the files you plan on editing to a different location. If you want to create backup files directly within the objects folder itself, take heed: the game doesn't distinguish between file extensions. It'll read a .bak file just as well as it'll read a .txt file, and (as mentioned previously) duplicate entries are a very bad thing.
* When a new world is generated, all the raw files get copied into a \raw\ folder within the applicable save folder. If you want to change something within a game that's already running, you'll have to edit those files, not the ones in ~DF\raw\objects.
* There's nothing stopping you from just copying an existing creature/entity/whatever, changing the identifier, and modifying it. This can save you a lot of time, especially when it comes to entities... which are coincidentally what we'll be talking about next.

== Modding civilisations (entities) ==

Entities - the objects that determine how civilisations work - are stored in entity_default.txt. They follow the same format as any other raw file:

entity_default

[OBJECT:ENTITY]

[ENTITY:ENTITYNAME]
[CREATURE:CREATURETYPE]
[TRANSLATION:LANGUAGETYPE]
[BIOME_SUPPORT:BIOMETOKEN:FREQENCY]
...[OTHER TAGS]...

Most of the time, it doesn't matter which order these tokens are in or where they're placed so long as they're below the "ENTITY:" identifier, but there are some important exceptions in the case of other files, especially creatures, which can contain a lot of "nested" tokens.

"[CREATURE:]" links the civilization with a specific creature defined in a creature file. This is the creature that'll be making up the entity's population, and will therefore be the creature you'll be playing as in fortress or adventure mode if the entity is a playable one. For example, if you wanted to do something silly, you could switch the "CREATURE:DWARF" entry in entity_default.txt with "CREATURE:ELF" and you would be marching elves around in fortress mode, although they would still use dwarven technology and language and names and so forth.

Oh, and before you get any funny ideas - it ''is'' possible to define more than one creature for a civ, but that won't work in quite the way you probably expect: later on, in the creature section, you'll learn about castes, which will provide a much more viable alternative, so try to bear with me until then.

"[TRANSLATION:]" defines the language file that the entity will be using, which will determine what their untranslated words are for things. This doesn't determine which words they use for naming things, only the way those words are spelt. The default language files are HUMAN, DWARF, ELF, and GOBLIN.

"[BIOME_SUPPORT:]" defines the biomes that civs will attempt to settle in. The "FREQUENCY" value determines the likelyhood of them building there, but also raises an important point: most of the values you'll be setting for things are relative to each other. If I was to type:

[BIOME_SUPPORT:ANY_FOREST:1]
[BIOME_SUPPORT:SAVANNA:2]

This would have very much the same effect as:

[BIOME_SUPPORT:ANY_FOREST:5]
[BIOME_SUPPORT:SAVANNA:10]

This holds true for a lot of values throughout the files, excluding when it simply doesn't make sense, such as in materials.

You can find many details about the rest of the civilization tokens {{L|entity token|here}}. Besides those mentioned, some fundamental ones are the CIV_CONTROLLABLE token, which lets you control the civ in fortress mode, the INDIV_CONTROLLABLE token, which allows you to play the civ in adventure mode as an outsider, and the ADVENTURE_TIER token, which allows you to play a civ native (non-outsider) in adventure mode. Other tokens that you should pay attention to are START_BIOME and the ones regarding sites, but in general, you can just run through the aformentioned list and add or remove what you want.

If you have more than one civ with the CIV_CONTROLLABLE token, all the available civs from those entities will appear in the group selection section on the embark screen. It may not be immediately obvious from which species each civ may be - while this can be determined from legends mode, the topmost species in the "neighbors" display in the embark screen is always the same as the currently selected species; if your group is dwarven, dwarves will be topmost, whilst (say) elves will be topmost if your chosen group is elven. By default, the game seems to choose a civ (and therefore a species if there is more than one) at random.

You can also attempt to discern the civ yourself by the names it uses - this is the realm of "symbols", collections of words centered around a specific concept. The civ will use the words comprising whatever symbols are applicable to it for various things. This association might be a little obfuscating at first, so I'll run through it. Let's refer to the DWARF entity:

[SELECT_SYMBOL:WAR:NAME_WAR]
[SUBSELECT_SYMBOL:WAR:VIOLENT]
[SELECT_SYMBOL:BATTLE:NAME_BATTLE]
[SUBSELECT_SYMBOL:BATTLE:VIOLENT]
[SELECT_SYMBOL:SIEGE:NAME_SIEGE]
[SUBSELECT_SYMBOL:SIEGE:VIOLENT]

Here we can see that dwarves will generally name their wars first after words in the "NAME_WAR" symbol group, and then after words in the "VIOLENT" symbol group. This might, for example, result in a war being named "The War of Carnage". The symbols used for the other types of conflict are arrayed in a similar fashion. It would be trivial to replace the instances of VIOLENT with, say, PEACE and end up with a battle called "The Clash of Calm" or something.

[SELECT_SYMBOL:ROAD:NAME_ROAD]
[SELECT_SYMBOL:TUNNEL:NAME_TUNNEL]
[SELECT_SYMBOL:BRIDGE:NAME_BRIDGE]
[SELECT_SYMBOL:WALL:NAME_WALL]

The above applies here. Dwarves are fond of naming their roads and tunnels after roads and tunnels.

[SELECT_SYMBOL:REMAINING:ARTIFICE]
[SELECT_SYMBOL:REMAINING:EARTH]
[CULL_SYMBOL:ALL:DOMESTIC]
[CULL_SYMBOL:ALL:SUBORDINATE]
[CULL_SYMBOL:ALL:EVIL]
[CULL_SYMBOL:ALL:UNTOWARD]
[CULL_SYMBOL:ALL:FLOWERY]
[CULL_SYMBOL:ALL:NEGATIVE]
[CULL_SYMBOL:ALL:UGLY]
[CULL_SYMBOL:ALL:NEGATOR]

This section deals with everything else. The things that haven't already been dealt with (hence the "REMAINING") - such as site names, kingdom names, the names of individuals, and such - will have names from the ARTIFICE and EARTH symbol groups. After that the dwarf entity is told to cull all innapropriate symbols - this applies to everything (hence the "ALL") so if the game happens to choose a symbol associated with, say, EVIL for one of the battles, it'll scrap that name and try again. This sort of thing adds a lot of flavour to DF's entities and can account for a lot of a civ's percieved personality.

Another basic thing to note: any entity token that's dealing with weapons, armor, clothing, etc., will state the items that the civ can build natively, not necessarily the ones they can wear or use. For example, you could create a species with no clothes specified, but then rob a clothes shop in adventurer mode and wear everything you want, or give them weapons that are too large to wield and they could sell them, but not use them.

An easy method of creating a civilization is just to copy-paste a similar one to the bottom of the entity_default.txt file and edit things to your liking. Remember to always change the civ's "ENTITY:" identifier! This can be anything so long as it's not already existing.

At the end of some of the default entries you'll find a list of positions, both ones that'll directly affect you in fort mode (such as nobles) and ones that'll primarily affect worldgen and adventure mode. A list of the tokens applicable to positions can be found {{L|position token|here}}; they don't require a great deal of explaination.

== Modding the creatures ==

Creature modding is great fun. You can change nearly any aspect of a creature or make your own completely from scratch.

Modding creatures is very similar to modding civs: it's just a matter of editing, adding, or removing tokens, enclosed in square brackets underneath the creature's [CREATURE:] header. The creature entries contain all of the information about each and every non-random creature in the game, from animals to dwarves to goblins to even caravan wagons. A lot of the creature tokens are fairly self-explanatory; you can find a list of such tokens {{L|creature token|here}}. But before you start creating your own creatures, you'll want to learn how the tissues system works.

=== Creature materials and tissues ===

In the most basic sense, a creature is a series of bodyparts. These parts are defined in their own file, and we'll talk about them later. As a specific aspect of how creatures work which throws off a lot of prospective modders is the relationship between bodyparts, tissues, and materials, I'm going to show you part of the creature entry for a bronze colossus (bear with me):

...
[BODY:HUMANOID:2EYES:2EARS:NOSE:HUMANOID_JOINTS:5FINGERS:5TOES]
[NO_THOUGHT_CENTER_FOR_MOVEMENT]
[TISSUE:BRONZE]
[TISSUE_NAME:bronze:bronze]
[TISSUE_MATERIAL:INORGANIC:BRONZE]
[MUSCULAR]
[FUNCTIONAL]
[STRUCTURAL]
[RELATIVE_THICKNESS:1]
[CONNECTS]
[TISSUE_SHAPE:LAYER]
[TISSUE_LAYER:BY_CATEGORY:ALL:BRONZE]
...

At the top, we can see the "BODY:" token, followed by a list of bodyparts. As you've probably guessed, these parts make up the physical form of the colossus. But the colossus has to be made out of something - it has to have tissues. And those tissues also have to be made out of something - in this case, bronze.

Below the BODY token you'll see a TISSUE token, followed by an identifier, much like the others we've seen. The TISSUE block is determining how the tissue works, and which purposes it'll serve. As the colossus is just going to be made out of this one tissue, this tissue needs to act like bone, muscle, and everything else combined, hence the MUSCULAR, FUNCTIONAL and STRUCTURAL tokens. The tissue also references a material - INORGANIC:BRONZE - the properties of which are declared in the inorganic materials file, and the tissue is subsequently made out of this material. With me so far?

Below the tissue definition is the TISSUE_LAYER line. TISSUE_LAYER allows you to control where each tissue is applied. Its first argument defines if it's to search by bodypart category (BY_CATEGORY), bodypart type (BY_TYPE), or look for a specific part (BY_TOKEN). That's followed by the parts argument itself, which is in this case ALL (so the game's looking for parts in all categories, which is to say, every bodypart). This is followed by the tissue to be applied, BRONZE. So the TISSUE_LAYER token is telling the game to select all bodyparts in every category and make them out of the tissue "BRONZE". The colossus is now made of bronze.

By now you're probably thinking "Wow, if this was for a creature made out of however many tissues, this would be amazingly longwinded". And you're right. Luckily, there are two methods by which we can speed things up a lot.

Firstly, there are material and tissue templates. Let's say you were going to make a lot of creatures out of bronze, and you didn't want to have to copy and paste the bronze tissue all over the place. Instead, you create a tissue template. This goes, as you've probably guessed, in a tissue template file.

[TISSUE_TEMPLATE:BRONZE_TEMPLATE]
[TISSUE_NAME:bronze:bronze]
[TISSUE_MATERIAL:INORGANIC:BRONZE]
[MUSCULAR]
[FUNCTIONAL]
[STRUCTURAL]
[RELATIVE_THICKNESS:1]
[CONNECTS]
[TISSUE_SHAPE:LAYER]

Now, instead of applying the tissue to each and every bronze creature you're making, you can just refer to the template:

...
[BODY:HUMANOID:2EYES:2EARS:NOSE:HUMANOID_JOINTS:5FINGERS:5TOES]
[NO_THOUGHT_CENTER_FOR_MOVEMENT]
[USE_TISSUE_TEMPLATE:BRONZE:BRONZE_TEMPLATE]
[TISSUE_LAYER:BY_CATEGORY:ALL:BRONZE]
...

Material templates work in the same way, but refer to materials instead of tissues.

However, if we're looking at something like a dwarf, even with the templates, editing can get very slow indeed:

...
[USE_MATERIAL_TEMPLATE:SKIN:SKIN_TEMPLATE]
[USE_MATERIAL_TEMPLATE:FAT:FAT_TEMPLATE]
[USE_MATERIAL_TEMPLATE:MUSCLE:MUSCLE_TEMPLATE]
[USE_MATERIAL_TEMPLATE:BONE:BONE_TEMPLATE]
[USE_MATERIAL_TEMPLATE:CARTILAGE:CARTILAGE_TEMPLATE]
[USE_MATERIAL_TEMPLATE:HAIR:HAIR_TEMPLATE]
[USE_MATERIAL_TEMPLATE:TOOTH:TOOTH_TEMPLATE]
[USE_MATERIAL_TEMPLATE:EYE:EYE_TEMPLATE]
[USE_MATERIAL_TEMPLATE:NERVE:NERVE_TEMPLATE]
[USE_MATERIAL_TEMPLATE:BRAIN:BRAIN_TEMPLATE]
[USE_MATERIAL_TEMPLATE:LUNG:LUNG_TEMPLATE]
[USE_MATERIAL_TEMPLATE:HEART:HEART_TEMPLATE]
[USE_MATERIAL_TEMPLATE:LIVER:LIVER_TEMPLATE]
[USE_MATERIAL_TEMPLATE:GUT:GUT_TEMPLATE]
[USE_MATERIAL_TEMPLATE:STOMACH:STOMACH_TEMPLATE]
[USE_MATERIAL_TEMPLATE:PANCREAS:PANCREAS_TEMPLATE]
[USE_MATERIAL_TEMPLATE:SPLEEN:SPLEEN_TEMPLATE]
[USE_MATERIAL_TEMPLATE:KIDNEY:KIDNEY_TEMPLATE]
[USE_TISSUE_TEMPLATE:SKIN:SKIN_TEMPLATE]
[USE_TISSUE_TEMPLATE:FAT:FAT_TEMPLATE]
[USE_TISSUE_TEMPLATE:MUSCLE:MUSCLE_TEMPLATE]
...

This is where body detail plans come in. Detail plans, of course, have their own file, and they are designed to help automate some of the more common processes in creature creation. The first entry in b_detail_plan_default.txt does exactly what we've been trying to do above: it takes all the common materials and shoves them into one plan, which can be referenced with a single token.

...
[BODY_DETAIL_PLAN:STANDARD_MATERIALS]
...

Much easier. But what about the TISSUE_LAYER tokens? Will we have to type out all of those manually?

Nope, detail plans have that covered as well. It's possible to place variable arguments into a detail plan. For example:

[BODY_DETAIL_PLAN:VERTEBRATE_TISSUE_LAYERS]
[BP_LAYERS:BY_CATEGORY:BODY:ARG3:50:ARG2:5:ARG1:1]
[BP_LAYERS:BY_CATEGORY:BODY_UPPER:ARG3:50:ARG2:5:ARG1:1]
[BP_LAYERS:BY_CATEGORY:BODY_LOWER:ARG3:50:ARG2:5:ARG1:1]
[BP_LAYERS:BY_CATEGORY:ARM:ARG4:25:ARG3:25:ARG2:5:ARG1:1]
[BP_LAYERS:BY_CATEGORY:ARM_UPPER:ARG4:25:ARG3:25:ARG2:5:ARG1:1]
...
[BP_LAYERS:BY_CATEGORY:NOSE:ARG5:4:ARG1:1]
...

First an argument is placed in the plan (ARG1, ARG2 etc.), followed by the thickness of the tissue that will be inserted in place of the argument. So when we reference the VERTEBRATE_TISSUE_LAYERS plan, we'll be able to do something like this:

[BODY_DETAIL_PLAN:VERTEBRATE_TISSUE_LAYERS:SKIN:FAT:MUSCLE:BONE:CARTILAGE]

ARG1 in the detail plan is replaced by SKIN, the first tissue we entered. ARG2 is replaced by FAT, ARG3 by muscle, ARG4 by bone, and ARG5 by CARTILAGE. Hence, our creature's bodypart designated as BODY is made up of SKIN with thickness 1, FAT with thickness 5, and MUSCLE with thickness 50. Its nose is made up of SKIN (thickness 1) and CARTILAGE (thickness 4).

Things left out of the body plans aside, our dwarf's entire body, material, tissue and tissue layer tokens have been boiled down to this:

...
[BODY:HUMANOID:2EYES:2EARS:NOSE:2LUNGS:HEART:GUTS:ORGANS:HUMANOID_JOINTS:
THROAT:NECK:SPINE:BRAIN:SKULL:5FINGERS:5TOES:MOUTH:FACIAL_FEATURES:TEETH:RIBCAGE]
[BODY_DETAIL_PLAN:STANDARD_MATERIALS]
[BODY_DETAIL_PLAN:STANDARD_TISSUES]
[BODY_DETAIL_PLAN:VERTEBRATE_TISSUE_LAYERS:SKIN:FAT:MUSCLE:BONE:CARTILAGE]
...

This can save you a lot of time and space if you're making lots of changes common to many creatures. In general, if you're making a creature that's fleshy or chitinous, there's detail plans already included in the game to help you out. You should only have to resort to declaring tissues individually (like our bronze colossus) if you're doing something really out-of-the-ordinary.

Another great thing about templates (and so, detail plans) is that they can be modified after being declared. Let's say I wanted my dwarves to be perpetually on fire (don't ask). We declare the body stuff normally:

...
[BODY:HUMANOID:2EYES:2EARS:NOSE:2LUNGS:HEART:GUTS:ORGANS:HUMANOID_JOINTS:
THROAT:NECK:SPINE:BRAIN:SKULL:5FINGERS:5TOES:MOUTH:FACIAL_FEATURES:TEETH:RIBCAGE]
[BODY_DETAIL_PLAN:STANDARD_MATERIALS]
[BODY_DETAIL_PLAN:STANDARD_TISSUES]
[BODY_DETAIL_PLAN:VERTEBRATE_TISSUE_LAYERS:SKIN:FAT:MUSCLE:BONE:CARTILAGE]
...

We then select the appropriate material:

...
[BODY:HUMANOID:2EYES:2EARS:NOSE:2LUNGS:HEART:GUTS:ORGANS:HUMANOID_JOINTS:
THROAT:NECK:SPINE:BRAIN:SKULL:5FINGERS:5TOES:MOUTH:FACIAL_FEATURES:TEETH:RIBCAGE]
[BODY_DETAIL_PLAN:STANDARD_MATERIALS]
[BODY_DETAIL_PLAN:STANDARD_TISSUES]
[BODY_DETAIL_PLAN:VERTEBRATE_TISSUE_LAYERS:SKIN:FAT:MUSCLE:BONE:CARTILAGE]
[SELECT_MATERIAL:SKIN]
[MAT_FIXED_TEMP:10600]
...

We don't want them burning to death, so we'll need to stop that from happening:

...
[BODY:HUMANOID:2EYES:2EARS:NOSE:2LUNGS:HEART:GUTS:ORGANS:HUMANOID_JOINTS:
THROAT:NECK:SPINE:BRAIN:SKULL:5FINGERS:5TOES:MOUTH:FACIAL_FEATURES:TEETH:RIBCAGE]
[BODY_DETAIL_PLAN:STANDARD_MATERIALS]
[BODY_DETAIL_PLAN:STANDARD_TISSUES]
[BODY_DETAIL_PLAN:VERTEBRATE_TISSUE_LAYERS:SKIN:FAT:MUSCLE:BONE:CARTILAGE]
[SELECT_MATERIAL:SKIN]
[MAT_FIXED_TEMP:10600]
[SELECT_MATERIAL:ALL]
[HEATDAM_POINT:NONE]
...

Note that this makes use of DF's built-in temperature scale. You can read more about that {{L|temperature scale|on this page}}. I'm also referencing material tokens, which we haven't gone over yet - I'll talk about making your own materials later.

=== Creature castes ===

Another potentially extremely powerful part of the creature raws is the caste system. The caste system handles both true biological castes and lesser variations, such as sexes.

To understand the true potential of the caste system, we only need to take a look at the raws for antmen, found in creature_subterrenean.txt:

...
[CASTE:WORKER]
[CASTE_NAME:worker ant woman:worker ant women:worker ant woman]
Female, but non-breeding.
[POP_RATIO:10000]
[CASTE:SOLDIER]
[CASTE_NAME:soldier ant woman:soldier ant women:soldier ant woman]
Female, but non-breeding.
[POP_RATIO:1000]
[CASTE:DRONE]
[MALE]
[CASTE_NAME:drone ant man:drone ant men:drone ant man]
[POP_RATIO:5]
[CASTE:QUEEN]
[FEMALE]
[CASTE_NAME:queen ant woman:queen ant women:queen ant woman]
[POP_RATIO:1]
[SELECT_CASTE:WORKER]
[SELECT_ADDITIONAL_CASTE:SOLDIER]
[SELECT_ADDITIONAL_CASTE:QUEEN]
[BODY:HUMANOID_4ARMS:2EYES:HEART:GUTS:BRAIN:MOUTH]
[BODYGLOSS:INSECT_UPPERBODY:INSECT_LOWERBODY]
[SELECT_CASTE:DRONE]
[BODY:HUMANOID_4ARMS:2EYES:HEART:GUTS:BRAIN:MOUTH:2WINGS]
[BODYGLOSS:INSECT_UPPERBODY:INSECT_LOWERBODY]
[FLIER]
[SELECT_CASTE:ALL]
[BODY_DETAIL_PLAN:CHITIN_MATERIALS]
[BODY_DETAIL_PLAN:CHITIN_TISSUES]
[BODY_DETAIL_PLAN:EXOSKELETON_TISSUE_LAYERS:CHITIN:FAT:MUSCLE]
[BODY_DETAIL_PLAN:STANDARD_HEAD_POSITIONS]
[ATTACK:PUNCH:BODYPART:BY_TYPE:GRASP]
[ATTACK_SKILL:GRASP_STRIKE]
[ATTACK_VERB:punch:punches]
...

It's evident that the process of creating and editing castes is comparable to the modifications we were making to tissues and materials earlier: A caste is declared, and modifications to the base creature are made. Declared castes can be selected and subsequently modified, again, just like tissues and materials.

In this case, each caste is declared, given its own name, and a POP_RATIO, which determines how commonly a birth results in that caste - for every 10000 workers born, there'll be an average of 1000 soldiers, 5 drones and one queen. You've probably also noticed that the DRONE and QUEEN castes have the MALE and FEMALE tokens respectively - these tokens determine how breeding works. A creature without both a MALE caste and a FEMALE caste will be unable to breed (no asexual creatures yet, unfortunately). As they lack FEMALE, the workers and soldiers are unable to breed with the male drones.

After this, there are some modifications to bodyparts. In this case, the drones have wings and the FLIER token, which the other castes lack. It's entirely possible for creatures of different castes to have completely different body stuctures, even to the extent that they don't resemble each other at all. If you read the section of this guide that dealt with entities, you may remember a passing mention of multi-creature civilisations and how they don't quite work as you may think they would. The castes system is your workaround. You could create a caste that is, for all intents and purposes, a human, and another caste of the same creature that acts exactly like a giant cave spider, put the creature in a civ, and get a human-spider civ. The only flaw in this approach is that the castes will interbreed.

That's the most complex components of creature creation out of the way. You should find the rest trivial by comparison.

== Modding items ==

Items are fairly simple to deal with. By default, each item type is contained in its own file; this may help make browsing for a specific item easier, but from a purely technical point of view, it's possible to throw all items into one file. Unfortunately, item tokens don't seem to be especially well-documented (at least as not as well as the other object types), but you should be able to figure out most things by way of my explainations and your assumptions.

Let's look at the entry for, of course, the thong:

[ITEM_PANTS:ITEM_PANTS_THONG]
[NAME:thong:thongs]
[LAYER:UNDER]
[COVERAGE:25]
[LAYER_SIZE:10]
[LAYER_PERMIT:30]
[MATERIAL_SIZE:1]
[SOFT]
[LEATHER]
[STRUCTURAL_ELASTICITY_WOVEN_THREAD]

Most of these are pretty obvious if one compares them to the other entries in the file. There's a layer for the item, determining where it's worn; a coverage value to determine how well it protects you from cold and other things; a size token to determine how much it counts for when it's under something else; a layer permit token to determine how much can be worn under it; and a material size token to determine how much raw material it takes to make it.

Now, if you wanted to mod these to turn them into metal thongs (ouch!), you would simply have to add [METAL] to it somewhere, and probably [HARD] instead of [SOFT]. Simple! These tokens work by tying into material properties - some materials are designated as suitable for making hard items, some for soft, etc..

Weapons involve a little more detail:

[ITEM_WEAPON:ITEM_WEAPON_SWORD_2H]
[NAME:two-handed sword:two-handed swords]
[SIZE:900]
[SKILL:SWORD]
[TWO_HANDED:67500]
[MINIMUM_SIZE:62500]
[MATERIAL_SIZE:5]
[ATTACK:EDGE:100000:8000:slash:slashes:NO_SUB:1250]
[ATTACK:EDGE:50:4000:stab:stabs:NO_SUB:1000]
[ATTACK:BLUNT:100000:8000:slap:slaps:flat:1250]
[ATTACK:BLUNT:100:1000:strike:strikes:pommel:1000]

SIZE determines how heavy the weapon is. This has a substantial effect on weapon effectiveness. SKILL determines which skill is used in using the weapon; a list of skills can be found {{L|skill token|on this page}}. MINIMUM_SIZE determines the minimum size a creature must be before the weapon can be wielded, while TWO_HANDED determines how large a creature must be in order to wield the weapon with one hand.

Attacks take a little more explaination. The first value determines the contact area of the weapon's attack; this should be high for slashing or bludgeoning weapons, and low for piercing and poking ones. The second value determines how deep the weapon penetrates - for BLUNT attacks this value is ignored as they're not supposed to penetrate anyway, but in the case of EDGE attacks it should generally be lower for slashing attacks and higher for stabbing attacks.

Following these are the adjectives used; they should be self-explanatory. Finally, we have the velocity modifier, which has a multiplying effect on the weapon's size for the purposes of determining how powerful it is in combat.

Other, more miscellaneous items are generally simple and shouldn't require any further explaination.

Once you've made an item, you just add it to the civ entry so a civilization can actually craft it, and it's done.

== Modding language files ==

Coming later

== Modding body parts ==

Imagine you have this fantastic idea for a multi-tentacled winged spider-monster. Sounds great! But in order to make this a reality you may need to create a new set of body parts for it. That's no problem! Making body parts is easy, though it may look complicated at first.

All of the default body definitions are located in body_default.txt and then linked to a creature in the creature's entry. We've talked about how bodyparts make up creatures earlier, in the creature section. You can mix and match them in the creature entry and it makes no difference, as long as they're there: each bodypart will link itself to the appropriate connection automatically when the creature is first created.

Body parts work by sections: you can add as many sections as you want to a bodypart definition, but generally you should keep it fairly low for ease of use. Each body section entry is in the, very simple, format:

[BODY:BODYNAME]
[BP:TOKENID:name][TOKENSGOHERE][DEFAULT_RELSIZE:][CATEGORY:WHATEVER]

The most important tokens are "CONTYPE" and "CON": CONTYPE means the bodypart in question is connected to a certain ''type'' of bodypart, while CON means it's connected to a ''specific'' one. TOKENID is yet another identifier, which should be unique, as it's referenced every time something uses CON or BY_TOKEN. DEFAULT_RELSIZE defines, of course, what the bodypart's size is in relation to the other parts. CATEGORY defines a category for the part, which can be unique or shared with other parts. This is referenced whenever BY_CATEGORY is used.

A list of bodypart tokens can be found {{L|body token|here}}.

Let's take a simple example, a head:

[BODY:BASIC_HEAD]
[BP:HD:head:STP][CONTYPE:UPPERBODY][HEAD][CATEGORY:HEAD]
[DEFAULT_RELSIZE:300]

It connects directly to an upper body.

[BODY:2EYES]
[BP:REYE:right eye:STP][CONTYPE:HEAD][SIGHT][EMBEDDED][SMALL][RIGHT][CATEGORY:EYE]
[DEFAULT_RELSIZE:5]
[BP:LEYE:left eye:STP][CONTYPE:HEAD][SIGHT][EMBEDDED][SMALL][LEFT][CATEGORY:EYE]
[DEFAULT_RELSIZE:5]

These are a pair of eyes, connecting to the head.

[BODY:HUMANOID]
[BP:UB:upper body:upper bodies][UPPERBODY][CATEGORY:BODY_UPPER]
[DEFAULT_RELSIZE:1000]
[BP:LB:lower body:lower bodies][CON:UB][LOWERBODY][CATEGORY:BODY_LOWER]
[DEFAULT_RELSIZE:1000]
[BP:HD:head:STP][CON:UB][HEAD][CATEGORY:HEAD]
[DEFAULT_RELSIZE:300]
[BP:RUA:right upper arm:STP][CON:UB][LIMB][RIGHT][CATEGORY:ARM_UPPER]
[DEFAULT_RELSIZE:200]
[BP:LUA:left upper arm:STP][CON:UB][LIMB][LEFT][CATEGORY:ARM_UPPER]
[DEFAULT_RELSIZE:200]
[BP:RLA:right lower arm:STP][CON:RUA][LIMB][RIGHT][CATEGORY:ARM_LOWER]
[DEFAULT_RELSIZE:200]
[BP:LLA:left lower arm:STP][CON:LUA][LIMB][LEFT][CATEGORY:ARM_LOWER]
[DEFAULT_RELSIZE:200]
[BP:RH:right hand:STP][CON:RLA][GRASP][RIGHT][CATEGORY:HAND]
[DEFAULT_RELSIZE:80]
[BP:LH:left hand:STP][CON:LLA][GRASP][LEFT][CATEGORY:HAND]
[DEFAULT_RELSIZE:80]
[BP:RUL:right upper leg:STP][CON:LB][LIMB][RIGHT][CATEGORY:LEG_UPPER]
[DEFAULT_RELSIZE:500]
[BP:LUL:left upper leg:STP][CON:LB][LIMB][LEFT][CATEGORY:LEG_UPPER]
[DEFAULT_RELSIZE:500]
[BP:RLL:right lower leg:STP][CON:RUL][LIMB][RIGHT][CATEGORY:LEG_LOWER]
[DEFAULT_RELSIZE:400]
[BP:LLL:left lower leg:STP][CON:LUL][LIMB][LEFT][CATEGORY:LEG_LOWER]
[DEFAULT_RELSIZE:400]
[BP:RF:right foot:right feet][CON:RLL][STANCE][RIGHT][CATEGORY:FOOT]
[DEFAULT_RELSIZE:120]
[BP:LF:left foot:left feet][CON:LLL][STANCE][LEFT][CATEGORY:FOOT]
[DEFAULT_RELSIZE:120]

An entire humanoid body. The foot bone's connected to the ankle bone...

"BODYGLOSS" entries, which you can sometimes find applied to creature entries, are simply replacement words for specific part names in a creature. For example, you'll find the bodygloss [BODYGLOSS:CLAW_HAND:hand:claw] in body_default.txt; you can then use this in a creature via "[BODYGLOSS:CLAW_HAND]" and it'll replace all instances of "hand" with "claw" in that creature. For all intents and purposes the body part will still function as the proper part, though.

== Plants ==

Plants are, again, not unlike creatures. With what you've learned so far in regard to tokens and the materials system, running through the notes included in plant_standard.txt should explain most things. {{L|Plant token|Here's the list of plant-specific tokens}}.

== Workshops ==

Coming later

== Materials ==

As we've seen when talking about creatures, materials are vital. Materials show up in two forms: material templates, which generally show up in creatures, and specific materials (designated as "inorganic"), which are (by default, at least) consigned purely to metal and stone types.

Let's take a look at METAL_TEMPLATE in material_template_default.txt. It's evident that most of the basic properties of metals are already defined in the template - it goes red and melts at a high enough temperature, it's heavy, and (as noted by the very bottom token) is a metal. We already know just how useful templates can be to creatures, and the same applies to other materials.

Now let's take a look at inorganic_metal.txt. You can see that the metals here refer to the templates, and, just like we did with creatures, then modify the properties of that template and expand upon it.

Finally, let's look at inorganic_stone_mineral.txt. Here we can see that in addition to the changes made to the template, there are also ENVIONMENT tokens - these tell the game where to place these minerals during worldgen.

{{L|material definition token|Here's a list of material tokens}}. It should also help you out with any modifications you want to make regarding those creature modifications we were making a while back. See, it all ties together in the end. The beauty of the current materials system is that there's actually very little difference between, say, leather and iron - they're fundamentally the same thing, just with different properties, which is how things really should be.

== Examples ==

Coming later

= Modding utilities =

[http://www.bay12forums.com/smf/index.php?topic=28829.0 A list of many mods and community-developed utilities]

[[Category:DF2010:Modding]]
[[Category:DF2010:Guides]]

v0.31:Modding guide

2010-12-01T22:57:01Z

3: Minor corrections

{{av}}{{Quality|Masterwork}}

This is intended to be a guide to inform those new to DF modding on what elements of the game can be modified, and how. After reading through this guide, a user should be capable of both editing creatures, entities, materials et al, and creating their own.

Generally breaking stuff is fine - nothing that can be changed will affect the DF executable, and new additions can be easily removed.

This guide is based on a guide originally created for version 0.27.176.39c (originally put to type by one Teldin; page found [[40d:Modding guide|here]]) and has later been rewritten for 0.31.xx.xx by (a) different author(s).

'''See also:''' [[:Category:DF2010:Modding]]

= Modding Guide =

== Basics of DF modding ==

All the base data that can be edited by prospective modders can be found in the \raw\ folder. This folder contains two subfolders: "graphics" (where you insert {{L|Graphics set repository|graphics sets}}), and "objects", which contains all the data for generally everything in the game that is not hardcoded (randomly created creatures aside).

Within the \raw\objects folder are a large number of text files - these are the {{L|raw file|raw files}}, and editing them is quite easy - you can also create your own if you wish. For now, take a look at one of the existing files. It should look something like this:

creature_standard

[OBJECT:CREATURE]

[CREATURE:DWARF]
[DESCRIPTION:A short, sturdy creature fond of drink and industry.]
[NAME:dwarf:dwarves:dwarven]
[CASTE_NAME:dwarf:dwarves:dwarven]
[CREATURE_TILE:1][COLOR:3:0:0]
[CREATURE_SOLDIER_TILE:2]
...

As you can see, each file is comprised of a header string stating the file name, a second header stating the type of object data it contains, followed by the contents of the file itself. These are all necessary elements of the file, and without them, the file won't be parsed correctly by the game. You may have also noticed the file naming scheme - this is also important; files containing creatures have names starting with "creature_", entity file names must begin with "entity_", etc..

Below the headers, there begins a list of entries. Each entry is made up of its own header (in this case, "[CREATURE:DWARF]"), again stating the type of object, and then the object's unique identifier - if an indentifier isn't unique, the game will mess up and you'll get some serious, and potentially very trippy, errors. Below that, we have the body of the entry, which determines the entry's specific properties.

The body of an entry is made up of a series of "tokens", which are essentially flags that can be added or removed to affect the entry's attributes. Most of these effects are hardcoded: for example, it's possible to make a creature only eat meat with the [CARNIVOUROUS] token, but it's impossible to create your own token detailing a specific diet for the creature.

Before we continue, a few key things to remember when modding the raw files:

* Personally speaking, I don't recommend modifying the existing raw files, but if you want to edit an already-exiting creature, always back up the files you plan on editing to a different location. If you want to create backup files directly within the objects folder itself, take heed: the game doesn't distinguish between file extensions. It'll read a .bak file just as well as it'll read a .txt file, and (as mentioned previously) duplicate entries are a very bad thing.
* When a new world is generated, all the raw files get copied into a \raw\ folder within the applicable save folder. If you want to change something within a game that's already running, you'll have to edit those files, not the ones in ~DF\raw\objects.
* There's nothing stopping you from just copying an existing creature/entity/whatever, changing the identifier, and modifying it. This can save you a lot of time, especially when it comes to entities... which are coincidentally what we'll be talking about next.

== Modding civilisations (entities) ==

Entities - the objects that determine how civilisations work - are stored in entity_default.txt. They follow the same format as any other raw file:

entity_default

[OBJECT:ENTITY]

[ENTITY:ENTITYNAME]
[CREATURE:CREATURETYPE]
[TRANSLATION:LANGUAGETYPE]
[BIOME_SUPPORT:BIOMETOKEN:FREQENCY]
...[OTHER TAGS]...

Most of the time, it doesn't matter which order these tokens are in or where they're placed so long as they're below the "ENTITY:" identifier, but there are some important exceptions in the case of other files, especially creatures, which can contain a lot of "nested" tokens.

"[CREATURE:]" links the civilization with a specific creature defined in a creature file. This is the creature that'll be making up the entity's population, and will therefore be the creature you'll be playing as in fortress or adventure mode if the entity is a playable one. For example, if you wanted to do something silly, you could switch the "CREATURE:DWARF" entry in entity_default.txt with "CREATURE:ELF" and you would be marching elves around in fortress mode, although they would still use dwarven technology and language and names and so forth.

Oh, and before you get any funny ideas - it ''is'' possible to define more than one creature for a civ, but that won't work in quite the way you probably expect: later on, in the creature section, you'll learn about castes, which will provide a much more viable alternative, so try to bear with me until then.

"[TRANSLATION:]" defines the language file that the entity will be using, which will determine what their untranslated words are for things. This doesn't determine which words they use for naming things, only the way those words are spelt. The default language files are HUMAN, DWARF, ELF, and GOBLIN.

"[BIOME_SUPPORT:]" defines the biomes that civs will attempt to settle in. The "FREQUENCY" value determines the likelyhood of them building there, but also raises an important point: most of the values you'll be setting for things are relative to each other. If I was to type:

[BIOME_SUPPORT:ANY_FOREST:1]
[BIOME_SUPPORT:SAVANNA:2]

This would have very much the same effect as:

[BIOME_SUPPORT:ANY_FOREST:5]
[BIOME_SUPPORT:SAVANNA:10]

This holds true for a lot of values throughout the files, excluding when it simply doesn't make sense, such as in materials.

You can find many details about the rest of the civilization tokens {{L|entity token|here}}. Besides those mentioned, some fundamental ones are the CIV_CONTROLLABLE token, which lets you control the civ in fortress mode, the INDIV_CONTROLLABLE token, which allows you to play the civ in adventure mode as an outsider, and the ADVENTURE_TIER token, which allows you to play a civ native (non-outsider) in adventure mode. Other tokens that you should pay attention to are START_BIOME and the ones regarding sites, but in general, you can just run through the aformentioned list and add or remove what you want.

If you have more than one civ with the CIV_CONTROLLABLE token, all the available civs from those entities will appear in the group selection section on the embark screen. It may not be immediately obvious from which species each civ may be - while this can be determined from legends mode, the topmost species in the "neighbors" display in the embark screen is always the same as the currently selected species; if your group is dwarven, dwarves will be topmost, whilst (say) elves will be topmost if your chosen group is elven. By default, the game seems to choose a civ (and therefore a species if there is more than one) at random.

You can also attempt to discern the civ yourself by the names it uses - this is the realm of "symbols", collections of words centered around a specific concept. The civ will use the words comprising whatever symbols are applicable to it for various things. This association might be a little obfuscating at first, so I'll run through it. Let's refer to the DWARF entity:

[SELECT_SYMBOL:WAR:NAME_WAR]
[SUBSELECT_SYMBOL:WAR:VIOLENT]
[SELECT_SYMBOL:BATTLE:NAME_BATTLE]
[SUBSELECT_SYMBOL:BATTLE:VIOLENT]
[SELECT_SYMBOL:SIEGE:NAME_SIEGE]
[SUBSELECT_SYMBOL:SIEGE:VIOLENT]

Here we can see that dwarves will generally name their wars first after words in the "NAME_WAR" symbol group, and then after words in the "VIOLENT" symbol group. This might, for example, result in a war being named "The War of Carnage". The symbols used for the other types of conflict are arrayed in a similar fashion. It would be trivial to replace the instances of VIOLENT with, say, PEACE and end up with a battle called "The Clash of Calm" or something.

[SELECT_SYMBOL:ROAD:NAME_ROAD]
[SELECT_SYMBOL:TUNNEL:NAME_TUNNEL]
[SELECT_SYMBOL:BRIDGE:NAME_BRIDGE]
[SELECT_SYMBOL:WALL:NAME_WALL]

The above applies here. Dwarves are fond of naming their roads and tunnels after roads and tunnels.

[SELECT_SYMBOL:REMAINING:ARTIFICE]
[SELECT_SYMBOL:REMAINING:EARTH]
[CULL_SYMBOL:ALL:DOMESTIC]
[CULL_SYMBOL:ALL:SUBORDINATE]
[CULL_SYMBOL:ALL:EVIL]
[CULL_SYMBOL:ALL:UNTOWARD]
[CULL_SYMBOL:ALL:FLOWERY]
[CULL_SYMBOL:ALL:NEGATIVE]
[CULL_SYMBOL:ALL:UGLY]
[CULL_SYMBOL:ALL:NEGATOR]

This section deals with everything else. The things that haven't already been dealt with (hence the "REMAINING") - such as site names, kingdom names, the names of individuals, and such - will have names from the ARTIFICE and EARTH symbol groups. After that the dwarf entity is told to cull all innapropriate symbols - this applies to everything (hence the "ALL") so if the game happens to choose a symbol associated with, say, EVIL for one of the battles, it'll scrap that name and try again. This sort of thing adds a lot of flavour to DF's entities and can account for a lot of a civ's percieved personality.

Another basic thing to note: any entity token that's dealing with weapons, armor, clothing, etc., will state the items that the civ can build natively, not necessarily the ones they can wear or use. For example, you could create a species with no clothes specified, but then rob a clothes shop in adventurer mode and wear everything you want, or give them weapons that are too large to wield and they could sell them, but not use them.

An easy method of creating a civilization is just to copy-paste a similar one to the bottom of the entity_default.txt file and edit things to your liking. Remember to always change the civ's "ENTITY:" identifier! This can be anything so long as it's not already existing.

At the end of some of the default entries you'll find a list of positions, both ones that'll directly affect you in fort mode (such as nobles) and ones that'll primarily affect worldgen and adventure mode. A list of the tokens applicable to positions can be found {{L|position token|here}}; they don't require a great deal of explaination.

== Modding the creatures ==

Creature modding is great fun. You can change nearly any aspect of a creature or make your own completely from scratch.

Modding creatures is very similar to modding civs: it's just a matter of editing, adding, or removing tokens, enclosed in square brackets underneath the creature's [CREATURE:] header. The creature entries contain all of the information about each and every non-random creature in the game, from animals to dwarves to goblins to even caravan wagons. A lot of the creature tokens are fairly self-explanatory; you can find a list of such tokens {{L|creature token|here}}.

In the most basic sense, a creature is a series of bodyparts. These parts are defined in their own file. As a specific aspect of how creatures work which throws off a lot of prospective modders is the relationship between creatures, tissues, and materials, I'm going to show you part of the creature entry for a bronze colossus (bear with me):

...
[BODY:HUMANOID:2EYES:2EARS:NOSE:HUMANOID_JOINTS:5FINGERS:5TOES]
[NO_THOUGHT_CENTER_FOR_MOVEMENT]
[TISSUE:BRONZE]
[TISSUE_NAME:bronze:bronze]
[TISSUE_MATERIAL:INORGANIC:BRONZE]
[MUSCULAR]
[FUNCTIONAL]
[STRUCTURAL]
[RELATIVE_THICKNESS:1]
[CONNECTS]
[TISSUE_SHAPE:LAYER]
[TISSUE_LAYER:BY_CATEGORY:ALL:BRONZE]
...

At the top, we can see the "BODY:" token, followed by a list of bodyparts. As you've probably guessed, these parts make up the physical form of the colossus. But the colossus has to be made out of something - it has to have tissues. And those tissues also have to be made out of something - in this case, bronze.

Below the BODY token you'll see a TISSUE token, followed by an identifier, much like the others we've seen. The TISSUE block is determining how the tissue works, and which purposes it'll serve. As the colossus is just going to be made out of this one tissue, this tissue needs to act like bone, muscle, and everything else combined, hence the MUSCULAR, FUNCTIONAL and STRUCTURAL tokens. The tissue also references a material - INORGANIC:BRONZE - the properties of which are declared in the inorganic materials file, and the tissue is subsequently made out of this material. With me so far?

Below the tissue definition is the TISSUE_LAYER line. TISSUE_LAYER allows you to control where each tissue is applied. Its first argument defines if it's to search by bodypart category (BY_CATEGORY), bodypart type (BY_TYPE), or look for a specific part (BY_TOKEN). That's followed by the parts argument itself, which is in this case ALL (so the game's looking for parts in all categories, which is to say, every bodypart). This is followed by the tissue to be applied, BRONZE. So the TISSUE_LAYER token is telling the game to select all bodyparts in every category and make them out of the tissue "BRONZE". The colossus is now made of bronze.

By now you're probably thinking "Wow, if this was for a creature made out of however many tissues, this would be amazingly longwinded". And you're right. Luckily, there are two methods by which we can speed things up a lot.

Firstly, there are material and tissue templates. Let's say you were going to make a lot of creatures out of bronze, and you didn't want to have to copy and paste the bronze tissue all over the place. Instead, you create a tissue template. This goes, as you've probably guessed, in a tissue template file.

[TISSUE_TEMPLATE:BRONZE_TEMPLATE]
[TISSUE_NAME:bronze:bronze]
[TISSUE_MATERIAL:INORGANIC:BRONZE]
[MUSCULAR]
[FUNCTIONAL]
[STRUCTURAL]
[RELATIVE_THICKNESS:1]
[CONNECTS]
[TISSUE_SHAPE:LAYER]

Now, instead of applying the tissue to each and every bronze creature you're making, you can just refer to the template:

...
[BODY:HUMANOID:2EYES:2EARS:NOSE:HUMANOID_JOINTS:5FINGERS:5TOES]
[NO_THOUGHT_CENTER_FOR_MOVEMENT]
[USE_TISSUE_TEMPLATE:BRONZE:BRONZE_TEMPLATE]
[TISSUE_LAYER:BY_CATEGORY:ALL:BRONZE]
...

Material templates work in the same way, but refer to materials instead of tissues.

However, if we're looking at something like a dwarf, even with the templates, editing can get very slow indeed:

...
[USE_MATERIAL_TEMPLATE:SKIN:SKIN_TEMPLATE]
[USE_MATERIAL_TEMPLATE:FAT:FAT_TEMPLATE]
[USE_MATERIAL_TEMPLATE:MUSCLE:MUSCLE_TEMPLATE]
[USE_MATERIAL_TEMPLATE:BONE:BONE_TEMPLATE]
[USE_MATERIAL_TEMPLATE:CARTILAGE:CARTILAGE_TEMPLATE]
[USE_MATERIAL_TEMPLATE:HAIR:HAIR_TEMPLATE]
[USE_MATERIAL_TEMPLATE:TOOTH:TOOTH_TEMPLATE]
[USE_MATERIAL_TEMPLATE:EYE:EYE_TEMPLATE]
[USE_MATERIAL_TEMPLATE:NERVE:NERVE_TEMPLATE]
[USE_MATERIAL_TEMPLATE:BRAIN:BRAIN_TEMPLATE]
[USE_MATERIAL_TEMPLATE:LUNG:LUNG_TEMPLATE]
[USE_MATERIAL_TEMPLATE:HEART:HEART_TEMPLATE]
[USE_MATERIAL_TEMPLATE:LIVER:LIVER_TEMPLATE]
[USE_MATERIAL_TEMPLATE:GUT:GUT_TEMPLATE]
[USE_MATERIAL_TEMPLATE:STOMACH:STOMACH_TEMPLATE]
[USE_MATERIAL_TEMPLATE:PANCREAS:PANCREAS_TEMPLATE]
[USE_MATERIAL_TEMPLATE:SPLEEN:SPLEEN_TEMPLATE]
[USE_MATERIAL_TEMPLATE:KIDNEY:KIDNEY_TEMPLATE]
[USE_TISSUE_TEMPLATE:SKIN:SKIN_TEMPLATE]
[USE_TISSUE_TEMPLATE:FAT:FAT_TEMPLATE]
[USE_TISSUE_TEMPLATE:MUSCLE:MUSCLE_TEMPLATE]
...

This is where body detail plans come in. Detail plans, of course, have their own file, and they are designed to help automate some of the more common processes in creature creation. The first entry in b_detail_plan_default.txt does exactly what we've been trying to do above: it takes all the common materials and shoves them into one plan, which can be referenced with a single token.

...
[BODY_DETAIL_PLAN:STANDARD_MATERIALS]
...

Much easier. But what about the TISSUE_LAYER tokens? Will we have to type out all of those manually?

Nope, detail plans have that covered as well. It's possible to place variable arguments into a detail plan. For example:

[BODY_DETAIL_PLAN:VERTEBRATE_TISSUE_LAYERS]
[BP_LAYERS:BY_CATEGORY:BODY:ARG3:50:ARG2:5:ARG1:1]
[BP_LAYERS:BY_CATEGORY:BODY_UPPER:ARG3:50:ARG2:5:ARG1:1]
[BP_LAYERS:BY_CATEGORY:BODY_LOWER:ARG3:50:ARG2:5:ARG1:1]
[BP_LAYERS:BY_CATEGORY:ARM:ARG4:25:ARG3:25:ARG2:5:ARG1:1]
[BP_LAYERS:BY_CATEGORY:ARM_UPPER:ARG4:25:ARG3:25:ARG2:5:ARG1:1]
...
[BP_LAYERS:BY_CATEGORY:NOSE:ARG5:4:ARG1:1]
...

First an argument is placed in the plan (ARG1, ARG2 etc.), followed by the thickness of the tissue that will be inserted in place of the argument. So when we reference the VERTEBRATE_TISSUE_LAYERS plan, we'll be able to do something like this:

[BODY_DETAIL_PLAN:VERTEBRATE_TISSUE_LAYERS:SKIN:FAT:MUSCLE:BONE:CARTILAGE]

ARG1 in the detail plan is replaced by SKIN, the first tissue we entered. ARG2 is replaced by FAT, ARG3 by muscle, ARG4 by bone, and ARG5 by CARTILAGE. Hence, our creature's bodypart designated as BODY is made up of SKIN with thickness 1, FAT with thickness 5, and MUSCLE with thickness 50. Its nose is made up of SKIN (thickness 1) and CARTILAGE (thickness 4).

Things left out of the body plans aside, our dwarf's entire body, material, tissue and tissue layer tokens have been boiled down to this:

...
[BODY:HUMANOID:2EYES:2EARS:NOSE:2LUNGS:HEART:GUTS:ORGANS:HUMANOID_JOINTS:
THROAT:NECK:SPINE:BRAIN:SKULL:5FINGERS:5TOES:MOUTH:FACIAL_FEATURES:TEETH:RIBCAGE]
[BODY_DETAIL_PLAN:STANDARD_MATERIALS]
[BODY_DETAIL_PLAN:STANDARD_TISSUES]
[BODY_DETAIL_PLAN:VERTEBRATE_TISSUE_LAYERS:SKIN:FAT:MUSCLE:BONE:CARTILAGE]
...

This can save you a lot of time and space if you're making lots of changes common to many creatures. In general, if you're making a creature that's fleshy or chitinous, there's detail plans already included in the game to help you out. You should only have to resort to declaring tissues individually (like our bronze colossus) if you're doing something really out-of-the-ordinary.

Another great thing about templates (and so, detail plans) is that they can be modified after being declared. Let's say I wanted my dwarves to be perpetually on fire (don't ask). We declare the body stuff normally:

...
[BODY:HUMANOID:2EYES:2EARS:NOSE:2LUNGS:HEART:GUTS:ORGANS:HUMANOID_JOINTS:
THROAT:NECK:SPINE:BRAIN:SKULL:5FINGERS:5TOES:MOUTH:FACIAL_FEATURES:TEETH:RIBCAGE]
[BODY_DETAIL_PLAN:STANDARD_MATERIALS]
[BODY_DETAIL_PLAN:STANDARD_TISSUES]
[BODY_DETAIL_PLAN:VERTEBRATE_TISSUE_LAYERS:SKIN:FAT:MUSCLE:BONE:CARTILAGE]
...

We then select the appropriate material:

...
[BODY:HUMANOID:2EYES:2EARS:NOSE:2LUNGS:HEART:GUTS:ORGANS:HUMANOID_JOINTS:
THROAT:NECK:SPINE:BRAIN:SKULL:5FINGERS:5TOES:MOUTH:FACIAL_FEATURES:TEETH:RIBCAGE]
[BODY_DETAIL_PLAN:STANDARD_MATERIALS]
[BODY_DETAIL_PLAN:STANDARD_TISSUES]
[BODY_DETAIL_PLAN:VERTEBRATE_TISSUE_LAYERS:SKIN:FAT:MUSCLE:BONE:CARTILAGE]
[SELECT_MATERIAL:SKIN]
[MAT_FIXED_TEMP:10600]
...

We don't want them burning to death, so we'll need to stop that from happening:

...
[BODY:HUMANOID:2EYES:2EARS:NOSE:2LUNGS:HEART:GUTS:ORGANS:HUMANOID_JOINTS:
THROAT:NECK:SPINE:BRAIN:SKULL:5FINGERS:5TOES:MOUTH:FACIAL_FEATURES:TEETH:RIBCAGE]
[BODY_DETAIL_PLAN:STANDARD_MATERIALS]
[BODY_DETAIL_PLAN:STANDARD_TISSUES]
[BODY_DETAIL_PLAN:VERTEBRATE_TISSUE_LAYERS:SKIN:FAT:MUSCLE:BONE:CARTILAGE]
[SELECT_MATERIAL:SKIN]
[MAT_FIXED_TEMP:10600]
[SELECT_MATERIAL:ALL]
[HEATDAM_POINT:NONE]
...

Note that this makes use of DF's built-in temperature scale. You can read more about that {{L|temperature scale|on this page}}. I'm also referencing material tokens, which we haven't gone over yet - I'll talk about making your own materials later.

That's the most complex component of creature creation out of the way. You should find the rest trivial by comparison.

== Modding items ==

Items are fairly simple to deal with. By default, each item type is contained in its own file; this may help make browsing for a specific item easier, but from a purely technical point of view, it's possible to throw all items into one file. Unfortunately, item tokens don't seem to be especially well-documented (at least as not as well as the other object types), but you should be able to figure out most things by way of my explainations and your assumptions.

Let's look at the entry for, of course, the thong:

[ITEM_PANTS:ITEM_PANTS_THONG]
[NAME:thong:thongs]
[LAYER:UNDER]
[COVERAGE:25]
[LAYER_SIZE:10]
[LAYER_PERMIT:30]
[MATERIAL_SIZE:1]
[SOFT]
[LEATHER]
[STRUCTURAL_ELASTICITY_WOVEN_THREAD]

Most of these are pretty obvious if one compares them to the other entries in the file. There's a layer for the item, determining where it's worn; a coverage value to determine how well it protects you from cold and other things; a size token to determine how much it counts for when it's under something else; a layer permit token to determine how much can be worn under it; and a material size token to determine how much raw material it takes to make it.

Now, if you wanted to mod these to turn them into metal thongs (ouch!), you would simply have to add [METAL] to it somewhere, and probably [HARD] instead of [SOFT]. Simple! These tokens work by tying into material properties - some materials are designated as suitable for making hard items, some for soft, etc..

Weapons involve a little more detail:

[ITEM_WEAPON:ITEM_WEAPON_SWORD_2H]
[NAME:two-handed sword:two-handed swords]
[SIZE:900]
[SKILL:SWORD]
[TWO_HANDED:67500]
[MINIMUM_SIZE:62500]
[MATERIAL_SIZE:5]
[ATTACK:EDGE:100000:8000:slash:slashes:NO_SUB:1250]
[ATTACK:EDGE:50:4000:stab:stabs:NO_SUB:1000]
[ATTACK:BLUNT:100000:8000:slap:slaps:flat:1250]
[ATTACK:BLUNT:100:1000:strike:strikes:pommel:1000]

SIZE determines how heavy the weapon is. This has a substantial effect on weapon effectiveness. SKILL determines which skill is used in using the weapon; a list of skills can be found {{L|skill token|on this page}}. MINIMUM_SIZE determines the minimum size a creature must be before the weapon can be wielded, while TWO_HANDED determines how large a creature must be in order to wield the weapon with one hand.

Attacks take a little more explaination. The first value determines the contact area of the weapon's attack; this should be high for slashing or bludgeoning weapons, and low for piercing and poking ones. The second value determines how deep the weapon penetrates - for BLUNT attacks this value is ignored as they're not supposed to penetrate anyway, but in the case of EDGE attacks it should generally be lower for slashing attacks and higher for stabbing attacks.

Following these are the adjectives used; they should be self-explanatory. Finally, we have the velocity modifier, which has a multiplying effect on the weapon's size for the purposes of determining how powerful it is in combat.

Other, more miscellaneous items are generally simple and shouldn't require any further explaination.

Once you've made an item, you just add it to the civ entry so a civilization can actually craft it, and it's done.

== Modding language files ==

Coming later

== Modding body parts ==

Imagine you have this fantastic idea for a multi-tentacled winged spider-monster. Sounds great! But in order to make this a reality you may need to create a new set of body parts for it. That's no problem! Making body parts is easy, though it may look complicated at first.

All of the default body definitions are located in body_default.txt and then linked to a creature in the creature's entry. We've talked about how bodyparts make up creatures earlier, in the creature section. You can mix and match them in the creature entry and it makes no difference, as long as they're there: each bodypart will link itself to the appropriate connection automatically when the creature is first created.

Body parts work by sections: you can add as many sections as you want to a bodypart definition, but generally you should keep it fairly low for ease of use. Each body section entry is in the, very simple, format:

[BODY:BODYNAME]
[BP:TOKENID:name][TOKENSGOHERE][DEFAULT_RELSIZE:][CATEGORY:WHATEVER]

The most important tokens are "CONTYPE" and "CON": CONTYPE means the bodypart in question is connected to a certain ''type'' of bodypart, while CON means it's connected to a ''specific'' one. TOKENID is yet another identifier, which should be unique, as it's referenced every time something uses CON or BY_TOKEN. DEFAULT_RELSIZE defines, of course, what the bodypart's size is in relation to the other parts. CATEGORY defines a category for the part, which can be unique or shared with other parts. This is referenced whenever BY_CATEGORY is used.

A list of bodypart tokens can be found {{L|body token|here}}.

Let's take a simple example, a head:

[BODY:BASIC_HEAD]
[BP:HD:head:STP][CONTYPE:UPPERBODY][HEAD][CATEGORY:HEAD]
[DEFAULT_RELSIZE:300]

It connects directly to an upper body.

[BODY:2EYES]
[BP:REYE:right eye:STP][CONTYPE:HEAD][SIGHT][EMBEDDED][SMALL][RIGHT][CATEGORY:EYE]
[DEFAULT_RELSIZE:5]
[BP:LEYE:left eye:STP][CONTYPE:HEAD][SIGHT][EMBEDDED][SMALL][LEFT][CATEGORY:EYE]
[DEFAULT_RELSIZE:5]

These are a pair of eyes, connecting to the head.

[BODY:HUMANOID]
[BP:UB:upper body:upper bodies][UPPERBODY][CATEGORY:BODY_UPPER]
[DEFAULT_RELSIZE:1000]
[BP:LB:lower body:lower bodies][CON:UB][LOWERBODY][CATEGORY:BODY_LOWER]
[DEFAULT_RELSIZE:1000]
[BP:HD:head:STP][CON:UB][HEAD][CATEGORY:HEAD]
[DEFAULT_RELSIZE:300]
[BP:RUA:right upper arm:STP][CON:UB][LIMB][RIGHT][CATEGORY:ARM_UPPER]
[DEFAULT_RELSIZE:200]
[BP:LUA:left upper arm:STP][CON:UB][LIMB][LEFT][CATEGORY:ARM_UPPER]
[DEFAULT_RELSIZE:200]
[BP:RLA:right lower arm:STP][CON:RUA][LIMB][RIGHT][CATEGORY:ARM_LOWER]
[DEFAULT_RELSIZE:200]
[BP:LLA:left lower arm:STP][CON:LUA][LIMB][LEFT][CATEGORY:ARM_LOWER]
[DEFAULT_RELSIZE:200]
[BP:RH:right hand:STP][CON:RLA][GRASP][RIGHT][CATEGORY:HAND]
[DEFAULT_RELSIZE:80]
[BP:LH:left hand:STP][CON:LLA][GRASP][LEFT][CATEGORY:HAND]
[DEFAULT_RELSIZE:80]
[BP:RUL:right upper leg:STP][CON:LB][LIMB][RIGHT][CATEGORY:LEG_UPPER]
[DEFAULT_RELSIZE:500]
[BP:LUL:left upper leg:STP][CON:LB][LIMB][LEFT][CATEGORY:LEG_UPPER]
[DEFAULT_RELSIZE:500]
[BP:RLL:right lower leg:STP][CON:RUL][LIMB][RIGHT][CATEGORY:LEG_LOWER]
[DEFAULT_RELSIZE:400]
[BP:LLL:left lower leg:STP][CON:LUL][LIMB][LEFT][CATEGORY:LEG_LOWER]
[DEFAULT_RELSIZE:400]
[BP:RF:right foot:right feet][CON:RLL][STANCE][RIGHT][CATEGORY:FOOT]
[DEFAULT_RELSIZE:120]
[BP:LF:left foot:left feet][CON:LLL][STANCE][LEFT][CATEGORY:FOOT]
[DEFAULT_RELSIZE:120]

An entire humanoid body. The foot bone's connected to the ankle bone...

"BODYGLOSS" entries, which you can sometimes find applied to creature entries, are simply replacement words for specific part names in a creature. For example, you'll find the bodygloss [BODYGLOSS:CLAW_HAND:hand:claw] in body_default.txt; you can then use this in a creature via "[BODYGLOSS:CLAW_HAND]" and it'll replace all instances of "hand" with "claw" in that creature. For all intents and purposes the body part will still function as the proper part, though.

== Plants ==

Coming later

== Workshops ==

Coming later

== Materials ==

As we've seen when talking about creatures, materials are vital. Materials show up in two forms: material templates, which generally show up in creatures, and specific materials (designated as "inorganic"), which are (by default, at least) consigned purely to metal and stone types.

Let's take a look at METAL_TEMPLATE in material_template_default.txt. It's evident that most of the basic properties of metals are already defined in the template - it goes red and melts at a high enough temperature, it's heavy, and (as noted by the very bottom token) is a metal. We already know just how useful templates can be to creatures, and the same applies to other materials.

Now let's take a look at inorganic_metal.txt. You can see that the metals here refer to the templates, and, just like we did with creatures, then modify the properties of that template and expand upon it.

Finally, let's look at inorganic_stone_mineral.txt. Here we can see that in addition to the changes made to the template, there are also ENVIONMENT tokens - these tell the game where to place these minerals during worldgen.

{{L|material definition token|Here's a list of material tokens}}. It should also help you out with any modifications you want to make regarding those creature modifications we were making a while back. See, it all ties together in the end. The beauty of the current materials system is that there's actually very little difference between, say, leather and iron - they're fundamentally the same thing, just with different properties, which is how things really should be.

== Examples ==

Coming later

= Modding utilities =

Section needs updating

[[Category:DF2010:Modding]]
[[Category:DF2010:Guides]]

v0.31:Modding guide

2010-11-30T06:16:36Z

{{av}}{{Quality|Masterwork}}

This is intended to be a guide to inform those new to DF modding on what elements of the game can be modified, and how. After reading through this guide, a user should be capable of both editing creatures, entities, materials et al, and creating their own.

Generally breaking stuff is fine - nothing that can be changed will affect the DF executable, and new additions can be easily removed.

This guide is based on a guide originally created for version 0.27.176.39c (originally put to type by one Teldin; page found [[40d:Modding guide|here]]) and has later been rewritten for 0.31.xx.xx by (a) different author(s).

'''See also:''' [[:Category:DF2010:Modding]]

= Modding Guide =

== Basics of DF modding ==

All the base data that can be edited by prospective modders can be found in the \raw\ folder. This folder contains two subfolders: "graphics" (where you insert {{L|Graphics set repository|graphics sets}}), and "objects", which contains all the data for generally everything in the game that is not hardcoded (randomly created creatures aside).

Within the \raw\objects folder are a large number of text files - these are the {{L|raw file|raw files}}, and editing them is quite easy - you can also create your own if you wish. For now, take a look at one of the existing files. It should look something like this:

creature_standard

[OBJECT:CREATURE]

[CREATURE:DWARF]
[DESCRIPTION:A short, sturdy creature fond of drink and industry.]
[NAME:dwarf:dwarves:dwarven]
[CASTE_NAME:dwarf:dwarves:dwarven]
[CREATURE_TILE:1][COLOR:3:0:0]
[CREATURE_SOLDIER_TILE:2]
...

As you can see, each file is comprised of a header string stating the file name, a second header stating the type of object data it contains, followed by the contents of the file itself. These are all necessary elements of the file, and without them, the file won't be parsed correctly by the game. You may have also noticed the file naming scheme - this is also important; files containing creatures have names starting with "creature_", entity file names must begin with "entity_", etc..

Below the headers, there begins a list of entries. Each entry is made up of its own header (in this case, "[CREATURE:DWARF]"), again stating the type of object, and then the object's unique identifier - if an indentifier isn't unique, the game will mess up and you'll get some serious, and potentially very trippy, errors. Below that, we have the body of the entry, which determines the entry's specific properties.

The body of an entry is made up of a series of "tokens", which are essentially flags that can be added or removed to affect the entry's attributes. Most of these effects are hardcoded: for example, it's possible to make a creature only eat meat with the [CARNIVOUROUS] token, but it's impossible to create your own token detailing a specific diet for the creature.

Before we continue, a few key things to remember when modding the raw files:

* Personally speaking, I don't recommend modifying the existing raw files, but if you want to edit an already-exiting creature, always back up the files you plan on editing to a different location. If you want to create backup files directly within the objects folder itself, take heed: the game doesn't distinguish between file extensions. It'll read a .bak file just as well as it'll read a .txt file, and (as mentioned previously) duplicate entries are a very bad thing.
* When a new world is generated, all the raw files get copied into a \raw\ folder within the applicable save folder. If you want to change something within a game that's already running, you'll have to edit those files, not the ones in ~DF\raw\objects.
* There's nothing stopping you from just copying an existing creature/entity/whatever, changing the identifier, and modifying it. This can save you a lot of time, especially when it comes to entities... which are coincidentally what we'll be talking about next.

== Modding civilisations (entities) ==

Entities - the objects that determine how civilisations work - are stored in entity_default.txt. They follow the same format as any other raw file:

entity_default

[OBJECT:ENTITY]

[ENTITY:ENTITYNAME]
[CREATURE:CREATURETYPE]
[TRANSLATION:LANGUAGETYPE]
[BIOME_SUPPORT:BIOMETOKEN:FREQENCY]
...[OTHER TAGS]...

Most of the time, it doesn't matter which order these tokens are in or where they're placed so long as they're below the "ENTITY:" identifier, but there are some important exceptions in the case of other files, especially creatures, which can contain a lot of "nested" tokens.

"[CREATURE:]" links the civilization with a specific creature defined in a creature file. This is the creature that'll be making up the entity's population, and will therefore be the creature you'll be playing as in fortress or adventure mode if the entity is a playable one. For example, if you wanted to do something silly, you could switch the "CREATURE:DWARF" entry in entity_default.txt with "CREATURE:ELF" and you would be marching elves around in fortress mode, although they would still use dwarven technology and language and names and so forth.

Oh, and before you get any funny ideas - it ''is'' possible to define more than one creature for a civ, but that won't work in quite the way you probably expect: later on, in the creature section, you'll learn about castes, which will provide a much more viable alternative, so try to bear with me until then.

"[TRANSLATION:]" defines the language file that the entity will be using, which will determine what their untranslated words are for things. This doesn't determine which words they use for naming things, only the way those words are spelt. The default language files are HUMAN, DWARF, ELF, and GOBLIN.

"[BIOME_SUPPORT:]" defines the biomes that civs will attempt to settle in. The "FREQUENCY" value determines the likelyhood of them building there, but also raises an important point: most of the values you'll be setting for things are relative to each other. If I was to type:

[BIOME_SUPPORT:ANY_FOREST:1]
[BIOME_SUPPORT:SAVANNA:2]

This would have very much the same effect as:

[BIOME_SUPPORT:ANY_FOREST:10]
[BIOME_SUPPORT:SAVANNA:5]

This holds true for a lot of values throughout the files, excluding when it simply doesn't make sense, such as in materials.

You can find many details about the rest of the civilization tokens {{L|entity token|here}}. Besides those mentioned, some fundamental ones are the CIV_CONTROLLABLE token, which lets you control the civ in fortress mode, the INDIV_CONTROLLABLE token, which allows you to play the civ in adventure mode as an outsider, and the ADVENTURE_TIER token, which allows you to play a civ native (non-outsider) in adventure mode. Other tokens that you should pay attention to are START_BIOME and the ones regarding sites, but in general, you can just run through the aformentioned list and add or remove what you want.

If you have more than one civ with the CIV_CONTROLLABLE token, all the available civs from those entities will appear in the group selection section on the embark screen. It may not be immediately obvious from which species each civ may be - while this can be determined from legends mode, the topmost species in the "neighbors" display in the embark screen is always the same as the currently selected species; if your group is dwarven, dwarves will be topmost, whilst (say) elves will be topmost if your chosen group is elven. By default, the game seems to choose a civ (and therefore a species if there is more than one) at random.

You can also attempt to discern the civ yourself by the names it uses - this is the realm of "symbols", collections of words centered around a specific concept. The civ will use the words comprising whatever symbols are applicable to it for various things. This association might be a little obfuscating at first, so I'll run through it. Let's refer to the DWARF entity:

[SELECT_SYMBOL:WAR:NAME_WAR]
[SUBSELECT_SYMBOL:WAR:VIOLENT]
[SELECT_SYMBOL:BATTLE:NAME_BATTLE]
[SUBSELECT_SYMBOL:BATTLE:VIOLENT]
[SELECT_SYMBOL:SIEGE:NAME_SIEGE]
[SUBSELECT_SYMBOL:SIEGE:VIOLENT]

Here we can see that dwarves will generally name their wars first after words in the "NAME_WAR" symbol group, and then after words in the "VIOLENT" symbol group. This might, for example, result in a war being named "The War of Carnage". The symbols used for the other types of conflict are arrayed in a similar fashion. It would be trivial to replace the instances of VIOLENT with, say, PEACE and end up with a battle called "The Clash of Calm" or something.

[SELECT_SYMBOL:ROAD:NAME_ROAD]
[SELECT_SYMBOL:TUNNEL:NAME_TUNNEL]
[SELECT_SYMBOL:BRIDGE:NAME_BRIDGE]
[SELECT_SYMBOL:WALL:NAME_WALL]

The above applies here. Dwarves are fond of naming their roads and tunnels after roads and tunnels.

[SELECT_SYMBOL:REMAINING:ARTIFICE]
[SELECT_SYMBOL:REMAINING:EARTH]
[CULL_SYMBOL:ALL:DOMESTIC]
[CULL_SYMBOL:ALL:SUBORDINATE]
[CULL_SYMBOL:ALL:EVIL]
[CULL_SYMBOL:ALL:UNTOWARD]
[CULL_SYMBOL:ALL:FLOWERY]
[CULL_SYMBOL:ALL:NEGATIVE]
[CULL_SYMBOL:ALL:UGLY]
[CULL_SYMBOL:ALL:NEGATOR]

This section deals with everything else. The sections that haven't already been dealt with (hence the "REMAINING") will have names from the ARTIFICE and EARTH symbol groups. After that the dwarf entity is told to cull all innapropriate symbols - this applies to everything (hence the "ALL") so if the game happens to choose a symbol associated with, say, EVIL for one of the battles, it'll scrap that name and try again. This sort of thing adds a lot of flavour to DF's entities and can account for a lot of a civ's percieved personality.

Another basic thing to note: any entity token that's dealing with weapons, armor, clothing, etc., will state the items that the civ can build natively, not necessarily the ones they can wear or use. For example, you could create a species with no clothes specified, but then rob a clothes shop in adventurer mode and wear everything you want, or give them weapons that are too large to wield and they could sell them, but not use them.

An easy method of creating a civilization is just to copy-paste a similar one to the bottom of the entity_default.txt file and edit things to your liking. Remember to always change the civ's "ENTITY:" identifier! This can be anything so long as it's not already existing.

At the end of some of the default entries you'll find a list of positions, both ones that'll directly affect you in fort mode (such as nobles) and ones that'll primarily affect worldgen and adventure mode. A list of the tokens applicable to positions can be found {{L|position token|here}}; they don't require a great deal of explaination.

== Modding the creatures ==

Creature modding is great fun. You can change nearly any aspect of a creature or make your own completely from scratch.

Modding creatures is very similar to modding civs: it's just a matter of editing, adding, or removing tokens, enclosed in square brackets underneath the creature's [CREATURE:] header. The creature entries contain all of the information about each and every non-random creature in the game, from animals to dwarves to goblins to even caravan wagons. A lot of the creature tokens are fairly self-explanatory; you can find a list of such tokens {{L|creature token|here}}.

In the most basic sense, a creature is a series of bodyparts. These parts are defined in their own file. As a specific aspect of how creatures work which throws off a lot of prospective modders is the relationship between creatures, tissues, and materials, I'm going to show you part of the creature entry for a bronze colossus (bear with me):

...
[BODY:HUMANOID:2EYES:2EARS:NOSE:HUMANOID_JOINTS:5FINGERS:5TOES]
[NO_THOUGHT_CENTER_FOR_MOVEMENT]
[TISSUE:BRONZE]
[TISSUE_NAME:bronze:bronze]
[TISSUE_MATERIAL:INORGANIC:BRONZE]
[MUSCULAR]
[FUNCTIONAL]
[STRUCTURAL]
[RELATIVE_THICKNESS:1]
[CONNECTS]
[TISSUE_SHAPE:LAYER]
[TISSUE_LAYER:BY_CATEGORY:ALL:BRONZE]
...

At the top, we can see the "BODY:" token, followed by a list of bodyparts. As you've probably guessed, these parts make up the physical form of the colossus. But the colossus has to be made out of something - it has to have tissues. And those tissues also have to be made out of something - in this case, bronze.

Below the BODY token you'll see a TISSUE token, followed by an identifier, much like the others we've seen. The TISSUE block is determining how the tissue works, and which purposes it'll serve. As the colossus is just going to be made out of this one tissue, this tissue needs to act like bone, muscle, and everything else combined, hence the MUSCULAR, FUNCTIONAL and STRUCTURAL tokens. The tissue also references a material - INORGANIC:BRONZE - the properties of which are declared in the inorganic materials file, and the tissue is subsequently made out of this material. With me so far?

Below the tissue definition is the TISSUE_LAYER line. TISSUE_LAYER allows you to control where each tissue is applied. Its first argument defines if it's to search by bodypart category (BY_CATEGORY), bodypart type (BY_PART), or look for a specific part (BY_TOKEN). That's followed by the parts argument itself, which is in this case ALL (so the game's looking for parts in all categories, which is to say, every bodypart). This is followed by the tissue to be applied, BRONZE. So the TISSUE_LAYER token is telling the game to select all bodyparts in every category and make them out of the tissue "BRONZE". The colossus is now made of bronze.

By now you're probably thinking "Wow, if this was for a creature made out of however many tissues, this would be amazingly longwinded". And you're right. Luckily, there are two methods by which we can speed things up a lot.

Firstly, there are material and tissue templates. Let's say you were going to make a lot of creatures out of bronze, and you didn't want to have to copy and paste the bronze tissue all over the place. Instead, you create a tissue template. This goes, as you've probably guessed, in a tissue template file.

[TISSUE_TEMPLATE:BRONZE_TEMPLATE]
[TISSUE_NAME:bronze:bronze]
[TISSUE_MATERIAL:INORGANIC:BRONZE]
[MUSCULAR]
[FUNCTIONAL]
[STRUCTURAL]
[RELATIVE_THICKNESS:1]
[CONNECTS]
[TISSUE_SHAPE:LAYER]

Now, instead of applying the tissue to each and every bronze creature you're making, you can just refer to the template:

...
[BODY:HUMANOID:2EYES:2EARS:NOSE:HUMANOID_JOINTS:5FINGERS:5TOES]
[NO_THOUGHT_CENTER_FOR_MOVEMENT]
[USE_TISSUE_TEMPLATE:BRONZE:BRONZE_TEMPLATE]
[TISSUE_LAYER:BY_CATEGORY:ALL:BRONZE]
...

Material templates work in the same way, but refer to materials instead of tissues.

However, if we're looking at something like a dwarf, even with the templates, editing can get very slow indeed:

...
[USE_MATERIAL_TEMPLATE:SKIN:SKIN_TEMPLATE]
[USE_MATERIAL_TEMPLATE:FAT:FAT_TEMPLATE]
[USE_MATERIAL_TEMPLATE:MUSCLE:MUSCLE_TEMPLATE]
[USE_MATERIAL_TEMPLATE:BONE:BONE_TEMPLATE]
[USE_MATERIAL_TEMPLATE:CARTILAGE:CARTILAGE_TEMPLATE]
[USE_MATERIAL_TEMPLATE:HAIR:HAIR_TEMPLATE]
[USE_MATERIAL_TEMPLATE:TOOTH:TOOTH_TEMPLATE]
[USE_MATERIAL_TEMPLATE:EYE:EYE_TEMPLATE]
[USE_MATERIAL_TEMPLATE:NERVE:NERVE_TEMPLATE]
[USE_MATERIAL_TEMPLATE:BRAIN:BRAIN_TEMPLATE]
[USE_MATERIAL_TEMPLATE:LUNG:LUNG_TEMPLATE]
[USE_MATERIAL_TEMPLATE:HEART:HEART_TEMPLATE]
[USE_MATERIAL_TEMPLATE:LIVER:LIVER_TEMPLATE]
[USE_MATERIAL_TEMPLATE:GUT:GUT_TEMPLATE]
[USE_MATERIAL_TEMPLATE:STOMACH:STOMACH_TEMPLATE]
[USE_MATERIAL_TEMPLATE:PANCREAS:PANCREAS_TEMPLATE]
[USE_MATERIAL_TEMPLATE:SPLEEN:SPLEEN_TEMPLATE]
[USE_MATERIAL_TEMPLATE:KIDNEY:KIDNEY_TEMPLATE]
[USE_TISSUE_TEMPLATE:SKIN:SKIN_TEMPLATE]
[USE_TISSUE_TEMPLATE:FAT:FAT_TEMPLATE]
[USE_TISSUE_TEMPLATE:MUSCLE:MUSCLE_TEMPLATE]
...

This is where body detail plans come in. Detail plans, of course, have their own file, and they are designed to help automate some of the more common processes in creature creation. The first entry in b_detail_plan_default.txt does exactly what we've been trying to do above: it takes all the common materials and shoves them into one plan, which can be referenced with a single token.

...
[BODY_DETAIL_PLAN:STANDARD_MATERIALS]
...

Much easier. But what about the TISSUE_LAYER tokens? Will we have to type out all of those manually?

Nope, detail plans have that covered as well. It's possible to place variable arguments into a detail plan. For example:

[BODY_DETAIL_PLAN:VERTEBRATE_TISSUE_LAYERS]
[BP_LAYERS:BY_CATEGORY:BODY:ARG3:50:ARG2:5:ARG1:1]
[BP_LAYERS:BY_CATEGORY:BODY_UPPER:ARG3:50:ARG2:5:ARG1:1]
[BP_LAYERS:BY_CATEGORY:BODY_LOWER:ARG3:50:ARG2:5:ARG1:1]
[BP_LAYERS:BY_CATEGORY:ARM:ARG4:25:ARG3:25:ARG2:5:ARG1:1]
[BP_LAYERS:BY_CATEGORY:ARM_UPPER:ARG4:25:ARG3:25:ARG2:5:ARG1:1]
...
[BP_LAYERS:BY_CATEGORY:NOSE:ARG5:4:ARG1:1]
...

First an argument is placed in the plan (ARG1, ARG2 etc.), followed by the thickness of the tissue that will be inserted in place of the argument. So when we reference the VERTEBRATE_TISSUE_LAYERS plan, we'll be able to do something like this:

[BODY_DETAIL_PLAN:VERTEBRATE_TISSUE_LAYERS:SKIN:FAT:MUSCLE:BONE:CARTILAGE]

ARG1 in the detail plan is replaced by SKIN, the first tissue we entered. ARG2 is replaced by FAT, ARG3 by muscle, ARG4 by bone, and ARG5 by CARTILAGE. Hence, our creature's bodypart designated as BODY is made up of SKIN with thickness 1, FAT with thickness 5, and MUSCLE with thickness 50. Its nose is made up of SKIN (thickness 1) and CARTILAGE (thickness 4).

Things left out of the body plans aside, our dwarf's entire body, material, tissue and tissue layer tokens have been boiled down to this:

...
[BODY:HUMANOID:2EYES:2EARS:NOSE:2LUNGS:HEART:GUTS:ORGANS:HUMANOID_JOINTS:
THROAT:NECK:SPINE:BRAIN:SKULL:5FINGERS:5TOES:MOUTH:FACIAL_FEATURES:TEETH:RIBCAGE]
[BODY_DETAIL_PLAN:STANDARD_MATERIALS]
[BODY_DETAIL_PLAN:STANDARD_TISSUES]
[BODY_DETAIL_PLAN:VERTEBRATE_TISSUE_LAYERS:SKIN:FAT:MUSCLE:BONE:CARTILAGE]
...

This can save you a lot of time and space if you're making lots of changes common to many creatures. In general, if you're making a creature that's fleshy or chitinous, there's detail plans already included in the game to help you out. You should only have to resort to declaring tissues individually (like our bronze colossus) if you're doing something really out-of-the-ordinary.

Another great thing about templates (and so, detail plans) is that they can be modified after being declared. Let's say I wanted my dwarves to be perpetually on fire (don't ask). We declare the body stuff normally:

...
[BODY:HUMANOID:2EYES:2EARS:NOSE:2LUNGS:HEART:GUTS:ORGANS:HUMANOID_JOINTS:
THROAT:NECK:SPINE:BRAIN:SKULL:5FINGERS:5TOES:MOUTH:FACIAL_FEATURES:TEETH:RIBCAGE]
[BODY_DETAIL_PLAN:STANDARD_MATERIALS]
[BODY_DETAIL_PLAN:STANDARD_TISSUES]
[BODY_DETAIL_PLAN:VERTEBRATE_TISSUE_LAYERS:SKIN:FAT:MUSCLE:BONE:CARTILAGE]
...

We then select the appropriate material:

...
[BODY:HUMANOID:2EYES:2EARS:NOSE:2LUNGS:HEART:GUTS:ORGANS:HUMANOID_JOINTS:
THROAT:NECK:SPINE:BRAIN:SKULL:5FINGERS:5TOES:MOUTH:FACIAL_FEATURES:TEETH:RIBCAGE]
[BODY_DETAIL_PLAN:STANDARD_MATERIALS]
[BODY_DETAIL_PLAN:STANDARD_TISSUES]
[BODY_DETAIL_PLAN:VERTEBRATE_TISSUE_LAYERS:SKIN:FAT:MUSCLE:BONE:CARTILAGE]
[SELECT_MATERIAL:SKIN]
[MAT_FIXED_TEMP:10600]
...

We don't want them burning to death, so we'll need to stop that from happening:

...
[BODY:HUMANOID:2EYES:2EARS:NOSE:2LUNGS:HEART:GUTS:ORGANS:HUMANOID_JOINTS:
THROAT:NECK:SPINE:BRAIN:SKULL:5FINGERS:5TOES:MOUTH:FACIAL_FEATURES:TEETH:RIBCAGE]
[BODY_DETAIL_PLAN:STANDARD_MATERIALS]
[BODY_DETAIL_PLAN:STANDARD_TISSUES]
[BODY_DETAIL_PLAN:VERTEBRATE_TISSUE_LAYERS:SKIN:FAT:MUSCLE:BONE:CARTILAGE]
[SELECT_MATERIAL:SKIN]
[MAT_FIXED_TEMP:10600]
[SELECT_MATERIAL:ALL]
[HEATDAM_POINT:NONE]
...

Note that this makes use of DF's built-in temperature scale. You can read more about that {{L|temperature scale|on this page}}. I'm also referencing material tokens, which we haven't gone over yet - I'll talk about making your own materials later.

That's the most complex component of creature creation out of the way. You should find the rest trivial by comparison.

== Modding items ==

Items are fairly simple to deal with. By default, each item type is contained in its own file; this may help make browsing for a specific item easier, but from a purely technical point of view, it's possible to throw all items into one file. Unfortunately, item tokens don't seem to be especially well-documented (at least as not as well as the other object types), but you should be able to figure out most things by way of my explainations and your assumptions.

Let's look at the entry for, of course, the thong:

[ITEM_PANTS:ITEM_PANTS_THONG]
[NAME:thong:thongs]
[LAYER:UNDER]
[COVERAGE:25]
[LAYER_SIZE:10]
[LAYER_PERMIT:30]
[MATERIAL_SIZE:1]
[SOFT]
[LEATHER]
[STRUCTURAL_ELASTICITY_WOVEN_THREAD]

Most of these are pretty obvious if one compares them to the other entries in the file. There's a layer for the item, determining where it's worn; a coverage value to determine how well it protects you from cold and other things; a size token to determine how much it counts for when it's under something else; a layer permit token to determine how much can be worn under it; and a material size token to determine how much raw material it takes to make it.

Now, if you wanted to mod these to turn them into metal thongs (ouch!), you would simply have to add [METAL] to it somewhere, and probably [HARD] instead of [SOFT]. Simple! These tokens work by tying into material properties - some materials are designated as suitable for making hard items, some for soft, etc..

Weapons involve a little more detail:

[ITEM_WEAPON:ITEM_WEAPON_SWORD_2H]
[NAME:two-handed sword:two-handed swords]
[SIZE:900]
[SKILL:SWORD]
[TWO_HANDED:67500]
[MINIMUM_SIZE:62500]
[MATERIAL_SIZE:5]
[ATTACK:EDGE:100000:8000:slash:slashes:NO_SUB:1250]
[ATTACK:EDGE:50:4000:stab:stabs:NO_SUB:1000]
[ATTACK:BLUNT:100000:8000:slap:slaps:flat:1250]
[ATTACK:BLUNT:100:1000:strike:strikes:pommel:1000]

SIZE determines how heavy the weapon is. This has a substantial effect on weapon effectiveness. SKILL determines which skill is used in using the weapon; a list of skills can be found {{L|skill token|on this page}}. MINIMUM_SIZE determines the minimum size a creature must be before the weapon can be wielded, while TWO_HANDED determines how large a creature must be in order to wield the weapon with one hand.

Attacks take a little more explaination. The first value determines the contact area of the weapon's attack; this should be high for slashing or bludgeoning weapons, and low for piercing and poking ones. The second value determines how deep the weapon penetrates - for BLUNT attacks this value is ignored as they're not supposed to penetrate anyway, but in the case of EDGE attacks it should generally be lower for slashing attacks and higher for stabbing attacks.

Following these are the adjectives used; they should be self-explanatory. Finally, we have the velocity modifier, which has a multiplying effect on the weapon's size for the purposes of determining how powerful it is in combat.

Other, more miscellaneous items are generally simple and shouldn't require any further explaination.

Once you've made an item, you just add it to the civ entry so a civilization can actually craft it, and it's done.

== Modding language files ==

Coming later

== Modding body parts ==

Imagine you have this fantastic idea for a multi-tentacled winged spider-monster. Sounds great! But in order to make this a reality you may need to create a new set of body parts for it. That's no problem! Making body parts is easy, though it may look complicated at first.

All of the default body definitions are located in body_default.txt and then linked to a creature in the creature's entry. We've talked about how bodyparts make up creatures earlier, in the creature section. You can mix and match them in the creature entry and it makes no difference, as long as they're there: each bodypart will link itself to the appropriate connection automatically when the creature is first created.

Body parts work by sections: you can add as many sections as you want to a bodypart definition, but generally you should keep it fairly low for ease of use. Each body section entry is in the very simple format:

[BODY:BODYNAME]
[BP:TOKENID:name][TOKENSGOHERE][DEFAULT_RELSIZE:][CATEGORY:WHATEVER]

The most important tokens are "CONTYPE" and "CON": CONTYPE means the bodypart in question is connected to a certain *type* of bodypart, while CON means it's connected to a *specific* one. TOKENID is yet another identifier, which should be unique, as it's referenced every time something uses CON or BY_TOKEN. DEFAULT_RELSIZE defines, of course, what the bodypart's size is in relation to the other parts. CATEGORY defines a category for the part, which can be unique or shared with other parts. This is referenced whenever BY_CATEGORY is used.

A list of bodypart tokens can be found {{L|body token|here}}.

Let's take a simple example, a head:

[BODY:BASIC_HEAD]
[BP:HD:head:STP][CONTYPE:UPPERBODY][HEAD][CATEGORY:HEAD]
[DEFAULT_RELSIZE:300]

It connects directly to an upper body.

[BODY:2EYES]
[BP:REYE:right eye:STP][CONTYPE:HEAD][SIGHT][EMBEDDED][SMALL][RIGHT][CATEGORY:EYE]
[DEFAULT_RELSIZE:5]
[BP:LEYE:left eye:STP][CONTYPE:HEAD][SIGHT][EMBEDDED][SMALL][LEFT][CATEGORY:EYE]
[DEFAULT_RELSIZE:5]

These are a pair of eyes, connecting to the head.

[BODY:HUMANOID]
[BP:UB:upper body:upper bodies][UPPERBODY][CATEGORY:BODY_UPPER]
[DEFAULT_RELSIZE:1000]
[BP:LB:lower body:lower bodies][CON:UB][LOWERBODY][CATEGORY:BODY_LOWER]
[DEFAULT_RELSIZE:1000]
[BP:HD:head:STP][CON:UB][HEAD][CATEGORY:HEAD]
[DEFAULT_RELSIZE:300]
[BP:RUA:right upper arm:STP][CON:UB][LIMB][RIGHT][CATEGORY:ARM_UPPER]
[DEFAULT_RELSIZE:200]
[BP:LUA:left upper arm:STP][CON:UB][LIMB][LEFT][CATEGORY:ARM_UPPER]
[DEFAULT_RELSIZE:200]
[BP:RLA:right lower arm:STP][CON:RUA][LIMB][RIGHT][CATEGORY:ARM_LOWER]
[DEFAULT_RELSIZE:200]
[BP:LLA:left lower arm:STP][CON:LUA][LIMB][LEFT][CATEGORY:ARM_LOWER]
[DEFAULT_RELSIZE:200]
[BP:RH:right hand:STP][CON:RLA][GRASP][RIGHT][CATEGORY:HAND]
[DEFAULT_RELSIZE:80]
[BP:LH:left hand:STP][CON:LLA][GRASP][LEFT][CATEGORY:HAND]
[DEFAULT_RELSIZE:80]
[BP:RUL:right upper leg:STP][CON:LB][LIMB][RIGHT][CATEGORY:LEG_UPPER]
[DEFAULT_RELSIZE:500]
[BP:LUL:left upper leg:STP][CON:LB][LIMB][LEFT][CATEGORY:LEG_UPPER]
[DEFAULT_RELSIZE:500]
[BP:RLL:right lower leg:STP][CON:RUL][LIMB][RIGHT][CATEGORY:LEG_LOWER]
[DEFAULT_RELSIZE:400]
[BP:LLL:left lower leg:STP][CON:LUL][LIMB][LEFT][CATEGORY:LEG_LOWER]
[DEFAULT_RELSIZE:400]
[BP:RF:right foot:right feet][CON:RLL][STANCE][RIGHT][CATEGORY:FOOT]
[DEFAULT_RELSIZE:120]
[BP:LF:left foot:left feet][CON:LLL][STANCE][LEFT][CATEGORY:FOOT]
[DEFAULT_RELSIZE:120]

An entire humanoid body. The foot bone's connected to the ankle bone...

A 'BODYGLOSS', which you can sometimes find in the creature entries, are simply replacement words for specific part names in a creature. For example, you'll find the bodygloss [BODYGLOSS:CLAW_HAND:hand:claw] in body_default.txt; you can then use this in a creature via '[BODYGLOSS:CLAW_HAND]' and it will replace all instances of "hand" with "claw" in that creature. For all intents and purposes the body part will still function as the proper part, though.

== Plants ==

Coming later

== Workshops ==

Coming later

== Materials ==

As we've seen when talking about creatures, materials are vital. Materials show up in two forms: material templates, which generally show up in creatures, and specific materials (designated as "inorganic"), which are (by default, at least) consigned purely to metal and stone types.

Let's take a look at METAL_TEMPLATE in material_template_default.txt. It's evident that most of the basic properties of metals are already defined in the template - it goes red and melts at a high enough temperature, it's heavy, and (as noted by the very bottom token) is a metal. We already know just how useful templates can be to creatures, and the same applies to other materials.

Now let's take a look at inorganic_metal.txt. You can see that the metals here refer to the templates, and, just like we did with creatures, then modify the properties of that template and expand upon it.

Finally, let's look at inorganic_stone_mineral.txt. Here we can see that in addition to the changes made to the template, there are also ENVIONMENT tokens - these tell the game where to place these minerals during worldgen.

{{L|material definition token|Here's a list of material tokens}}. It should also help you out with any modifications you want to make regarding those creature modifications we were making a while back. See, it all ties together in the end. The beauty of the current materials system is that there's actually very little difference between, say, leather and iron - they're fundamentally the same thing, just with different properties, which is how things really should be.

== Examples ==

Coming later

= Modding utilities =

Section needs updating

[[Category:DF2010:Modding]]
[[Category:DF2010:Guides]]

v0.31:Modding guide

2010-11-30T06:08:54Z

3: Updated links

{{av}}{{Quality|Masterwork}}

This is intended to be a guide to inform those new to DF modding on what elements of the game can be modified, and how. After reading through this guide, a user should be capable of both editing creatures, entities, materials et al, and creating their own.

Generally breaking stuff is fine - nothing that can be changed will affect the DF executable, and new additions can be easily removed.

This guide is based on a guide originally created for version 0.27.176.39c (originally put to type by one Teldin; page found [[40d:Modding guide|here]]) and has later been rewritten for 0.31.xx.xx by (a) different author(s).

'''See also:''' [[Category:DF2010:Modding]]

= Modding Guide =

== Basics of DF modding ==

All the base data that can be edited by prospective modders can be found in the \raw\ folder. This folder contains two subfolders: "graphics" (where you insert {{L|Graphics set repository|graphics sets}}), and "objects", which contains all the data for generally everything in the game that is not hardcoded (randomly created creatures aside).

Within the \raw\objects folder are a large number of text files - these are the {{L|raw file|raw files}}, and editing them is quite easy - you can also create your own if you wish. For now, take a look at one of the existing files. It should look something like this:

creature_standard

[OBJECT:CREATURE]

[CREATURE:DWARF]
[DESCRIPTION:A short, sturdy creature fond of drink and industry.]
[NAME:dwarf:dwarves:dwarven]
[CASTE_NAME:dwarf:dwarves:dwarven]
[CREATURE_TILE:1][COLOR:3:0:0]
[CREATURE_SOLDIER_TILE:2]
...

As you can see, each file is comprised of a header string stating the file name, a second header stating the type of object data it contains, followed by the contents of the file itself. These are all necessary elements of the file, and without them, the file won't be parsed correctly by the game. You may have also noticed the file naming scheme - this is also important; files containing creatures have names starting with "creature_", entity file names must begin with "entity_", etc..

Below the headers, there begins a list of entries. Each entry is made up of its own header (in this case, "[CREATURE:DWARF]"), again stating the type of object, and then the object's unique identifier - if an indentifier isn't unique, the game will mess up and you'll get some serious, and potentially very trippy, errors. Below that, we have the body of the entry, which determines the entry's specific properties.

The body of an entry is made up of a series of "tokens", which are essentially flags that can be added or removed to affect the entry's attributes. Most of these effects are hardcoded: for example, it's possible to make a creature only eat meat with the [CARNIVOUROUS] token, but it's impossible to create your own token detailing a specific diet for the creature.

Before we continue, a few key things to remember when modding the raw files:

* Personally speaking, I don't recommend modifying the existing raw files, but if you want to edit an already-exiting creature, always back up the files you plan on editing to a different location. If you want to create backup files directly within the objects folder itself, take heed: the game doesn't distinguish between file extensions. It'll read a .bak file just as well as it'll read a .txt file, and (as mentioned previously) duplicate entries are a very bad thing.
* When a new world is generated, all the raw files get copied into a \raw\ folder within the applicable save folder. If you want to change something within a game that's already running, you'll have to edit those files, not the ones in ~DF\raw\objects.
* There's nothing stopping you from just copying an existing creature/entity/whatever, changing the identifier, and modifying it. This can save you a lot of time, especially when it comes to entities... which are coincidentally what we'll be talking about next.

== Modding civilisations (entities) ==

Entities - the objects that determine how civilisations work - are stored in entity_default.txt. They follow the same format as any other raw file:

entity_default

[OBJECT:ENTITY]

[ENTITY:ENTITYNAME]
[CREATURE:CREATURETYPE]
[TRANSLATION:LANGUAGETYPE]
[BIOME_SUPPORT:BIOMETOKEN:FREQENCY]
...[OTHER TAGS]...

Most of the time, it doesn't matter which order these tokens are in or where they're placed so long as they're below the "ENTITY:" identifier, but there are some important exceptions in the case of other files, especially creatures, which can contain a lot of "nested" tokens.

"[CREATURE:]" links the civilization with a specific creature defined in a creature file. This is the creature that'll be making up the entity's population, and will therefore be the creature you'll be playing as in fortress or adventure mode if the entity is a playable one. For example, if you wanted to do something silly, you could switch the "CREATURE:DWARF" entry in entity_default.txt with "CREATURE:ELF" and you would be marching elves around in fortress mode, although they would still use dwarven technology and language and names and so forth.

Oh, and before you get any funny ideas - it ''is'' possible to define more than one creature for a civ, but that won't work in quite the way you probably expect: later on, in the creature section, you'll learn about castes, which will provide a much more viable alternative, so try to bear with me until then.

"[TRANSLATION:]" defines the language file that the entity will be using, which will determine what their untranslated words are for things. This doesn't determine which words they use for naming things, only the way those words are spelt. The default language files are HUMAN, DWARF, ELF, and GOBLIN.

"[BIOME_SUPPORT:]" defines the biomes that civs will attempt to settle in. The "FREQUENCY" value determines the likelyhood of them building there, but also raises an important point: most of the values you'll be setting for things are relative to each other. If I was to type:

[BIOME_SUPPORT:ANY_FOREST:1]
[BIOME_SUPPORT:SAVANNA:2]

This would have very much the same effect as:

[BIOME_SUPPORT:ANY_FOREST:10]
[BIOME_SUPPORT:SAVANNA:5]

This holds true for a lot of values throughout the files, excluding when it simply doesn't make sense, such as in materials.

You can find many details about the rest of the civilization tokens {{L|entity token|here}}. Besides those mentioned, some fundamental ones are the CIV_CONTROLLABLE token, which lets you control the civ in fortress mode, the INDIV_CONTROLLABLE token, which allows you to play the civ in adventure mode as an outsider, and the ADVENTURE_TIER token, which allows you to play a civ native (non-outsider) in adventure mode. Other tokens that you should pay attention to are START_BIOME and the ones regarding sites, but in general, you can just run through the aformentioned list and add or remove what you want.

If you have more than one civ with the CIV_CONTROLLABLE token, all the available civs from those entities will appear in the group selection section on the embark screen. It may not be immediately obvious from which species each civ may be - while this can be determined from legends mode, the topmost species in the "neighbors" display in the embark screen is always the same as the currently selected species; if your group is dwarven, dwarves will be topmost, whilst (say) elves will be topmost if your chosen group is elven. By default, the game seems to choose a civ (and therefore a species if there is more than one) at random.

You can also attempt to discern the civ yourself by the names it uses - this is the realm of "symbols", collections of words centered around a specific concept. The civ will use the words comprising whatever symbols are applicable to it for various things. This association might be a little obfuscating at first, so I'll run through it. Let's refer to the DWARF entity:

[SELECT_SYMBOL:WAR:NAME_WAR]
[SUBSELECT_SYMBOL:WAR:VIOLENT]
[SELECT_SYMBOL:BATTLE:NAME_BATTLE]
[SUBSELECT_SYMBOL:BATTLE:VIOLENT]
[SELECT_SYMBOL:SIEGE:NAME_SIEGE]
[SUBSELECT_SYMBOL:SIEGE:VIOLENT]

Here we can see that dwarves will generally name their wars first after words in the "NAME_WAR" symbol group, and then after words in the "VIOLENT" symbol group. This might, for example, result in a war being named "The War of Carnage". The symbols used for the other types of conflict are arrayed in a similar fashion. It would be trivial to replace the instances of VIOLENT with, say, PEACE and end up with a battle called "The Clash of Calm" or something.

[SELECT_SYMBOL:ROAD:NAME_ROAD]
[SELECT_SYMBOL:TUNNEL:NAME_TUNNEL]
[SELECT_SYMBOL:BRIDGE:NAME_BRIDGE]
[SELECT_SYMBOL:WALL:NAME_WALL]

The above applies here. Dwarves are fond of naming their roads and tunnels after roads and tunnels.

[SELECT_SYMBOL:REMAINING:ARTIFICE]
[SELECT_SYMBOL:REMAINING:EARTH]
[CULL_SYMBOL:ALL:DOMESTIC]
[CULL_SYMBOL:ALL:SUBORDINATE]
[CULL_SYMBOL:ALL:EVIL]
[CULL_SYMBOL:ALL:UNTOWARD]
[CULL_SYMBOL:ALL:FLOWERY]
[CULL_SYMBOL:ALL:NEGATIVE]
[CULL_SYMBOL:ALL:UGLY]
[CULL_SYMBOL:ALL:NEGATOR]

This section deals with everything else. The sections that haven't already been dealt with (hence the "REMAINING") will have names from the ARTIFICE and EARTH symbol groups. After that the dwarf entity is told to cull all innapropriate symbols - this applies to everything (hence the "ALL") so if the game happens to choose a symbol associated with, say, EVIL for one of the battles, it'll scrap that name and try again. This sort of thing adds a lot of flavour to DF's entities and can account for a lot of a civ's percieved personality.

Another basic thing to note: any entity token that's dealing with weapons, armor, clothing, etc., will state the items that the civ can build natively, not necessarily the ones they can wear or use. For example, you could create a species with no clothes specified, but then rob a clothes shop in adventurer mode and wear everything you want, or give them weapons that are too large to wield and they could sell them, but not use them.

An easy method of creating a civilization is just to copy-paste a similar one to the bottom of the entity_default.txt file and edit things to your liking. Remember to always change the civ's "ENTITY:" identifier! This can be anything so long as it's not already existing.

At the end of some of the default entries you'll find a list of positions, both ones that'll directly affect you in fort mode (such as nobles) and ones that'll primarily affect worldgen and adventure mode. A list of the tokens applicable to positions can be found {{L|position token|here}}; they don't require a great deal of explaination.

== Modding the creatures ==

Creature modding is great fun. You can change nearly any aspect of a creature or make your own completely from scratch.

Modding creatures is very similar to modding civs: it's just a matter of editing, adding, or removing tokens, enclosed in square brackets underneath the creature's [CREATURE:] header. The creature entries contain all of the information about each and every non-random creature in the game, from animals to dwarves to goblins to even caravan wagons. A lot of the creature tokens are fairly self-explanatory; you can find a list of such tokens {{L|creature token|here}}.

In the most basic sense, a creature is a series of bodyparts. These parts are defined in their own file. As a specific aspect of how creatures work which throws off a lot of prospective modders is the relationship between creatures, tissues, and materials, I'm going to show you part of the creature entry for a bronze colossus (bear with me):

...
[BODY:HUMANOID:2EYES:2EARS:NOSE:HUMANOID_JOINTS:5FINGERS:5TOES]
[NO_THOUGHT_CENTER_FOR_MOVEMENT]
[TISSUE:BRONZE]
[TISSUE_NAME:bronze:bronze]
[TISSUE_MATERIAL:INORGANIC:BRONZE]
[MUSCULAR]
[FUNCTIONAL]
[STRUCTURAL]
[RELATIVE_THICKNESS:1]
[CONNECTS]
[TISSUE_SHAPE:LAYER]
[TISSUE_LAYER:BY_CATEGORY:ALL:BRONZE]
...

At the top, we can see the "BODY:" token, followed by a list of bodyparts. As you've probably guessed, these parts make up the physical form of the colossus. But the colossus has to be made out of something - it has to have tissues. And those tissues also have to be made out of something - in this case, bronze.

Below the BODY token you'll see a TISSUE token, followed by an identifier, much like the others we've seen. The TISSUE block is determining how the tissue works, and which purposes it'll serve. As the colossus is just going to be made out of this one tissue, this tissue needs to act like bone, muscle, and everything else combined, hence the MUSCULAR, FUNCTIONAL and STRUCTURAL tokens. The tissue also references a material - INORGANIC:BRONZE - the properties of which are declared in the inorganic materials file, and the tissue is subsequently made out of this material. With me so far?

Below the tissue definition is the TISSUE_LAYER line. TISSUE_LAYER allows you to control where each tissue is applied. Its first argument defines if it's to search by bodypart category (BY_CATEGORY), bodypart type (BY_PART), or look for a specific part (BY_TOKEN). That's followed by the parts argument itself, which is in this case ALL (so the game's looking for parts in all categories, which is to say, every bodypart). This is followed by the tissue to be applied, BRONZE. So the TISSUE_LAYER token is telling the game to select all bodyparts in every category and make them out of the tissue "BRONZE". The colossus is now made of bronze.

By now you're probably thinking "Wow, if this was for a creature made out of however many tissues, this would be amazingly longwinded". And you're right. Luckily, there are two methods by which we can speed things up a lot.

Firstly, there are material and tissue templates. Let's say you were going to make a lot of creatures out of bronze, and you didn't want to have to copy and paste the bronze tissue all over the place. Instead, you create a tissue template. This goes, as you've probably guessed, in a tissue template file.

[TISSUE_TEMPLATE:BRONZE_TEMPLATE]
[TISSUE_NAME:bronze:bronze]
[TISSUE_MATERIAL:INORGANIC:BRONZE]
[MUSCULAR]
[FUNCTIONAL]
[STRUCTURAL]
[RELATIVE_THICKNESS:1]
[CONNECTS]
[TISSUE_SHAPE:LAYER]

Now, instead of applying the tissue to each and every bronze creature you're making, you can just refer to the template:

...
[BODY:HUMANOID:2EYES:2EARS:NOSE:HUMANOID_JOINTS:5FINGERS:5TOES]
[NO_THOUGHT_CENTER_FOR_MOVEMENT]
[USE_TISSUE_TEMPLATE:BRONZE:BRONZE_TEMPLATE]
[TISSUE_LAYER:BY_CATEGORY:ALL:BRONZE]
...

Material templates work in the same way, but refer to materials instead of tissues.

However, if we're looking at something like a dwarf, even with the templates, editing can get very slow indeed:

...
[USE_MATERIAL_TEMPLATE:SKIN:SKIN_TEMPLATE]
[USE_MATERIAL_TEMPLATE:FAT:FAT_TEMPLATE]
[USE_MATERIAL_TEMPLATE:MUSCLE:MUSCLE_TEMPLATE]
[USE_MATERIAL_TEMPLATE:BONE:BONE_TEMPLATE]
[USE_MATERIAL_TEMPLATE:CARTILAGE:CARTILAGE_TEMPLATE]
[USE_MATERIAL_TEMPLATE:HAIR:HAIR_TEMPLATE]
[USE_MATERIAL_TEMPLATE:TOOTH:TOOTH_TEMPLATE]
[USE_MATERIAL_TEMPLATE:EYE:EYE_TEMPLATE]
[USE_MATERIAL_TEMPLATE:NERVE:NERVE_TEMPLATE]
[USE_MATERIAL_TEMPLATE:BRAIN:BRAIN_TEMPLATE]
[USE_MATERIAL_TEMPLATE:LUNG:LUNG_TEMPLATE]
[USE_MATERIAL_TEMPLATE:HEART:HEART_TEMPLATE]
[USE_MATERIAL_TEMPLATE:LIVER:LIVER_TEMPLATE]
[USE_MATERIAL_TEMPLATE:GUT:GUT_TEMPLATE]
[USE_MATERIAL_TEMPLATE:STOMACH:STOMACH_TEMPLATE]
[USE_MATERIAL_TEMPLATE:PANCREAS:PANCREAS_TEMPLATE]
[USE_MATERIAL_TEMPLATE:SPLEEN:SPLEEN_TEMPLATE]
[USE_MATERIAL_TEMPLATE:KIDNEY:KIDNEY_TEMPLATE]
[USE_TISSUE_TEMPLATE:SKIN:SKIN_TEMPLATE]
[USE_TISSUE_TEMPLATE:FAT:FAT_TEMPLATE]
[USE_TISSUE_TEMPLATE:MUSCLE:MUSCLE_TEMPLATE]
...

This is where body detail plans come in. Detail plans, of course, have their own file, and they are designed to help automate some of the more common processes in creature creation. The first entry in b_detail_plan_default.txt does exactly what we've been trying to do above: it takes all the common materials and shoves them into one plan, which can be referenced with a single token.

...
[BODY_DETAIL_PLAN:STANDARD_MATERIALS]
...

Much easier. But what about the TISSUE_LAYER tokens? Will we have to type out all of those manually?

Nope, detail plans have that covered as well. It's possible to place variable arguments into a detail plan. For example:

[BODY_DETAIL_PLAN:VERTEBRATE_TISSUE_LAYERS]
[BP_LAYERS:BY_CATEGORY:BODY:ARG3:50:ARG2:5:ARG1:1]
[BP_LAYERS:BY_CATEGORY:BODY_UPPER:ARG3:50:ARG2:5:ARG1:1]
[BP_LAYERS:BY_CATEGORY:BODY_LOWER:ARG3:50:ARG2:5:ARG1:1]
[BP_LAYERS:BY_CATEGORY:ARM:ARG4:25:ARG3:25:ARG2:5:ARG1:1]
[BP_LAYERS:BY_CATEGORY:ARM_UPPER:ARG4:25:ARG3:25:ARG2:5:ARG1:1]
...
[BP_LAYERS:BY_CATEGORY:NOSE:ARG5:4:ARG1:1]
...

First an argument is placed in the plan (ARG1, ARG2 etc.), followed by the thickness of the tissue that will be inserted in place of the argument. So when we reference the VERTEBRATE_TISSUE_LAYERS plan, we'll be able to do something like this:

[BODY_DETAIL_PLAN:VERTEBRATE_TISSUE_LAYERS:SKIN:FAT:MUSCLE:BONE:CARTILAGE]

ARG1 in the detail plan is replaced by SKIN, the first tissue we entered. ARG2 is replaced by FAT, ARG3 by muscle, ARG4 by bone, and ARG5 by CARTILAGE. Hence, our creature's bodypart designated as BODY is made up of SKIN with thickness 1, FAT with thickness 5, and MUSCLE with thickness 50. Its nose is made up of SKIN (thickness 1) and CARTILAGE (thickness 4).

Things left out of the body plans aside, our dwarf's entire body, material, tissue and tissue layer tokens have been boiled down to this:

...
[BODY:HUMANOID:2EYES:2EARS:NOSE:2LUNGS:HEART:GUTS:ORGANS:HUMANOID_JOINTS:
THROAT:NECK:SPINE:BRAIN:SKULL:5FINGERS:5TOES:MOUTH:FACIAL_FEATURES:TEETH:RIBCAGE]
[BODY_DETAIL_PLAN:STANDARD_MATERIALS]
[BODY_DETAIL_PLAN:STANDARD_TISSUES]
[BODY_DETAIL_PLAN:VERTEBRATE_TISSUE_LAYERS:SKIN:FAT:MUSCLE:BONE:CARTILAGE]
...

This can save you a lot of time and space if you're making lots of changes common to many creatures. In general, if you're making a creature that's fleshy or chitinous, there's detail plans already included in the game to help you out. You should only have to resort to declaring tissues individually (like our bronze colossus) if you're doing something really out-of-the-ordinary.

Another great thing about templates (and so, detail plans) is that they can be modified after being declared. Let's say I wanted my dwarves to be perpetually on fire (don't ask). We declare the body stuff normally:

...
[BODY:HUMANOID:2EYES:2EARS:NOSE:2LUNGS:HEART:GUTS:ORGANS:HUMANOID_JOINTS:
THROAT:NECK:SPINE:BRAIN:SKULL:5FINGERS:5TOES:MOUTH:FACIAL_FEATURES:TEETH:RIBCAGE]
[BODY_DETAIL_PLAN:STANDARD_MATERIALS]
[BODY_DETAIL_PLAN:STANDARD_TISSUES]
[BODY_DETAIL_PLAN:VERTEBRATE_TISSUE_LAYERS:SKIN:FAT:MUSCLE:BONE:CARTILAGE]
...

We then select the appropriate material:

...
[BODY:HUMANOID:2EYES:2EARS:NOSE:2LUNGS:HEART:GUTS:ORGANS:HUMANOID_JOINTS:
THROAT:NECK:SPINE:BRAIN:SKULL:5FINGERS:5TOES:MOUTH:FACIAL_FEATURES:TEETH:RIBCAGE]
[BODY_DETAIL_PLAN:STANDARD_MATERIALS]
[BODY_DETAIL_PLAN:STANDARD_TISSUES]
[BODY_DETAIL_PLAN:VERTEBRATE_TISSUE_LAYERS:SKIN:FAT:MUSCLE:BONE:CARTILAGE]
[SELECT_MATERIAL:SKIN]
[MAT_FIXED_TEMP:10600]
...

We don't want them burning to death, so we'll need to stop that from happening:

...
[BODY:HUMANOID:2EYES:2EARS:NOSE:2LUNGS:HEART:GUTS:ORGANS:HUMANOID_JOINTS:
THROAT:NECK:SPINE:BRAIN:SKULL:5FINGERS:5TOES:MOUTH:FACIAL_FEATURES:TEETH:RIBCAGE]
[BODY_DETAIL_PLAN:STANDARD_MATERIALS]
[BODY_DETAIL_PLAN:STANDARD_TISSUES]
[BODY_DETAIL_PLAN:VERTEBRATE_TISSUE_LAYERS:SKIN:FAT:MUSCLE:BONE:CARTILAGE]
[SELECT_MATERIAL:SKIN]
[MAT_FIXED_TEMP:10600]
[SELECT_MATERIAL:ALL]
[HEATDAM_POINT:NONE]
...

Note that this makes use of DF's built-in temperature scale. You can read more about that {{L|temperature scale|on this page}}. I'm also referencing material tokens, which we haven't gone over yet - I'll talk about making your own materials later.

That's the most complex component of creature creation out of the way. You should find the rest trivial by comparison.

== Modding items ==

Items are fairly simple to deal with. By default, each item type is contained in its own file; this may help make browsing for a specific item easier, but from a purely technical point of view, it's possible to throw all items into one file. Unfortunately, item tokens don't seem to be especially well-documented (at least as not as well as the other object types), but you should be able to figure out most things by way of my explainations and your assumptions.

Let's look at the entry for, of course, the thong:

[ITEM_PANTS:ITEM_PANTS_THONG]
[NAME:thong:thongs]
[LAYER:UNDER]
[COVERAGE:25]
[LAYER_SIZE:10]
[LAYER_PERMIT:30]
[MATERIAL_SIZE:1]
[SOFT]
[LEATHER]
[STRUCTURAL_ELASTICITY_WOVEN_THREAD]

Most of these are pretty obvious if one compares them to the other entries in the file. There's a layer for the item, determining where it's worn; a coverage value to determine how well it protects you from cold and other things; a size token to determine how much it counts for when it's under something else; a layer permit token to determine how much can be worn under it; and a material size token to determine how much raw material it takes to make it.

Now, if you wanted to mod these to turn them into metal thongs (ouch!), you would simply have to add [METAL] to it somewhere, and probably [HARD] instead of [SOFT]. Simple! These tokens work by tying into material properties - some materials are designated as suitable for making hard items, some for soft, etc..

Weapons involve a little more detail:

[ITEM_WEAPON:ITEM_WEAPON_SWORD_2H]
[NAME:two-handed sword:two-handed swords]
[SIZE:900]
[SKILL:SWORD]
[TWO_HANDED:67500]
[MINIMUM_SIZE:62500]
[MATERIAL_SIZE:5]
[ATTACK:EDGE:100000:8000:slash:slashes:NO_SUB:1250]
[ATTACK:EDGE:50:4000:stab:stabs:NO_SUB:1000]
[ATTACK:BLUNT:100000:8000:slap:slaps:flat:1250]
[ATTACK:BLUNT:100:1000:strike:strikes:pommel:1000]

SIZE determines how heavy the weapon is. This has a substantial effect on weapon effectiveness. SKILL determines which skill is used in using the weapon; a list of skills can be found {{L|skill token|on this page}}. MINIMUM_SIZE determines the minimum size a creature must be before the weapon can be wielded, while TWO_HANDED determines how large a creature must be in order to wield the weapon with one hand.

Attacks take a little more explaination. The first value determines the contact area of the weapon's attack; this should be high for slashing or bludgeoning weapons, and low for piercing and poking ones. The second value determines how deep the weapon penetrates - for BLUNT attacks this value is ignored as they're not supposed to penetrate anyway, but in the case of EDGE attacks it should generally be lower for slashing attacks and higher for stabbing attacks.

Following these are the adjectives used; they should be self-explanatory. Finally, we have the velocity modifier, which has a multiplying effect on the weapon's size for the purposes of determining how powerful it is in combat.

Other, more miscellaneous items are generally simple and shouldn't require any further explaination.

Once you've made an item, you just add it to the civ entry so a civilization can actually craft it, and it's done.

== Modding language files ==

Coming later

== Modding body parts ==

Imagine you have this fantastic idea for a multi-tentacled winged spider-monster. Sounds great! But in order to make this a reality you may need to create a new set of body parts for it. That's no problem! Making body parts is easy, though it may look complicated at first.

All of the default body definitions are located in body_default.txt and then linked to a creature in the creature's entry. We've talked about how bodyparts make up creatures earlier, in the creature section. You can mix and match them in the creature entry and it makes no difference, as long as they're there: each bodypart will link itself to the appropriate connection automatically when the creature is first created.

Body parts work by sections: you can add as many sections as you want to a bodypart definition, but generally you should keep it fairly low for ease of use. Each body section entry is in the very simple format:

[BODY:BODYNAME]
[BP:TOKENID:name][TOKENSGOHERE][DEFAULT_RELSIZE:][CATEGORY:WHATEVER]

The most important tokens are "CONTYPE" and "CON": CONTYPE means the bodypart in question is connected to a certain *type* of bodypart, while CON means it's connected to a *specific* one. TOKENID is yet another identifier, which should be unique, as it's referenced every time something uses CON or BY_TOKEN. DEFAULT_RELSIZE defines, of course, what the bodypart's size is in relation to the other parts. CATEGORY defines a category for the part, which can be unique or shared with other parts. This is referenced whenever BY_CATEGORY is used.

A list of bodypart tokens can be found {{L|body token|here}}.

Let's take a simple example, a head:

[BODY:BASIC_HEAD]
[BP:HD:head:STP][CONTYPE:UPPERBODY][HEAD][CATEGORY:HEAD]
[DEFAULT_RELSIZE:300]

It connects directly to an upper body.

[BODY:2EYES]
[BP:REYE:right eye:STP][CONTYPE:HEAD][SIGHT][EMBEDDED][SMALL][RIGHT][CATEGORY:EYE]
[DEFAULT_RELSIZE:5]
[BP:LEYE:left eye:STP][CONTYPE:HEAD][SIGHT][EMBEDDED][SMALL][LEFT][CATEGORY:EYE]
[DEFAULT_RELSIZE:5]

These are a pair of eyes, connecting to the head.

[BODY:HUMANOID]
[BP:UB:upper body:upper bodies][UPPERBODY][CATEGORY:BODY_UPPER]
[DEFAULT_RELSIZE:1000]
[BP:LB:lower body:lower bodies][CON:UB][LOWERBODY][CATEGORY:BODY_LOWER]
[DEFAULT_RELSIZE:1000]
[BP:HD:head:STP][CON:UB][HEAD][CATEGORY:HEAD]
[DEFAULT_RELSIZE:300]
[BP:RUA:right upper arm:STP][CON:UB][LIMB][RIGHT][CATEGORY:ARM_UPPER]
[DEFAULT_RELSIZE:200]
[BP:LUA:left upper arm:STP][CON:UB][LIMB][LEFT][CATEGORY:ARM_UPPER]
[DEFAULT_RELSIZE:200]
[BP:RLA:right lower arm:STP][CON:RUA][LIMB][RIGHT][CATEGORY:ARM_LOWER]
[DEFAULT_RELSIZE:200]
[BP:LLA:left lower arm:STP][CON:LUA][LIMB][LEFT][CATEGORY:ARM_LOWER]
[DEFAULT_RELSIZE:200]
[BP:RH:right hand:STP][CON:RLA][GRASP][RIGHT][CATEGORY:HAND]
[DEFAULT_RELSIZE:80]
[BP:LH:left hand:STP][CON:LLA][GRASP][LEFT][CATEGORY:HAND]
[DEFAULT_RELSIZE:80]
[BP:RUL:right upper leg:STP][CON:LB][LIMB][RIGHT][CATEGORY:LEG_UPPER]
[DEFAULT_RELSIZE:500]
[BP:LUL:left upper leg:STP][CON:LB][LIMB][LEFT][CATEGORY:LEG_UPPER]
[DEFAULT_RELSIZE:500]
[BP:RLL:right lower leg:STP][CON:RUL][LIMB][RIGHT][CATEGORY:LEG_LOWER]
[DEFAULT_RELSIZE:400]
[BP:LLL:left lower leg:STP][CON:LUL][LIMB][LEFT][CATEGORY:LEG_LOWER]
[DEFAULT_RELSIZE:400]
[BP:RF:right foot:right feet][CON:RLL][STANCE][RIGHT][CATEGORY:FOOT]
[DEFAULT_RELSIZE:120]
[BP:LF:left foot:left feet][CON:LLL][STANCE][LEFT][CATEGORY:FOOT]
[DEFAULT_RELSIZE:120]

An entire humanoid body. The foot bone's connected to the ankle bone...

A 'BODYGLOSS', which you can sometimes find in the creature entries, are simply replacement words for specific part names in a creature. For example, you'll find the bodygloss [BODYGLOSS:CLAW_HAND:hand:claw] in body_default.txt; you can then use this in a creature via '[BODYGLOSS:CLAW_HAND]' and it will replace all instances of "hand" with "claw" in that creature. For all intents and purposes the body part will still function as the proper part, though.

== Plants ==

Coming later

== Workshops ==

Coming later

== Materials ==

As we've seen when talking about creatures, materials are vital. Materials show up in two forms: material templates, which generally show up in creatures, and specific materials (designated as "inorganic"), which are (by default, at least) consigned purely to metal and stone types.

Let's take a look at METAL_TEMPLATE in material_template_default.txt. It's evident that most of the basic properties of metals are already defined in the template - it goes red and melts at a high enough temperature, it's heavy, and (as noted by the very bottom token) is a metal. We already know just how useful templates can be to creatures, and the same applies to other materials.

Now let's take a look at inorganic_metal.txt. You can see that the metals here refer to the templates, and, just like we did with creatures, then modify the properties of that template and expand upon it.

Finally, let's look at inorganic_stone_mineral.txt. Here we can see that in addition to the changes made to the template, there are also ENVIONMENT tokens - these tell the game where to place these minerals during worldgen.

{{L|material definition token|Here's a list of material tokens}}. It should also help you out with any modifications you want to make regarding those creature modifications we were making a while back. See, it all ties together in the end. The beauty of the current materials system is that there's actually very little difference between, say, leather and iron - they're fundamentally the same thing, just with different properties, which is how things really should be.

== Examples ==

Coming later

= Modding utilities =

Section needs updating

[[Category:DF2010:Modding]]
[[Category:DF2010:Guides]]

v0.31:Modding guide

2010-11-30T05:21:20Z

3: Typos and such

{{av}}{{Quality|Masterwork}}

This is intended to be a guide to inform those new to DF modding on what elements of the game can be modified, and how. After reading through this guide, a user should be capable of both editing creatures, entities, materials et al, and creating their own.

Generally breaking stuff is fine - nothing that can be changed will affect the DF executable, and new additions can be easily removed.

This guide is based on a guide originally created for version 0.27.176.39c (originally put to type by one Teldin; page found [[40d:Modding guide|here]]) and has later been rewritten for 0.31.xx.xx by (a) different author(s).

'''See also:''' [[:Category:DF2010:Modding]]

= Modding Guide =

== Basics of DF modding ==

All the base data that can be edited by prospective modders can be found in the \raw\ folder. This folder contains two subfolders: "graphics" (where you insert [[DF2010:Graphics_set_respository|graphics sets]]), and "objects", which contains all the data for generally everything in the game that is not hardcoded (randomly created creatures aside).

Within the \raw\objects folder are a large number of text files - these are the [[Raw file|raw files]], and editing them is quite easy - you can also create your own if you wish. For now, take a look at one of the existing files. It should look something like this:

creature_standard

[OBJECT:CREATURE]

[CREATURE:DWARF]
[DESCRIPTION:A short, sturdy creature fond of drink and industry.]
[NAME:dwarf:dwarves:dwarven]
[CASTE_NAME:dwarf:dwarves:dwarven]
[CREATURE_TILE:1][COLOR:3:0:0]
[CREATURE_SOLDIER_TILE:2]
...

As you can see, each file is comprised of a header string stating the file name, a second header stating the type of object data it contains, followed by the contents of the file itself. These are all necessary elements of the file, and without them, the file won't be parsed correctly by the game. You may have also noticed the file naming scheme - this is also important; files containing creatures have names starting with "creature_", entity file names must begin with "entity_", etc..

Below the headers, there begins a list of entries. Each entry is made up of its own header (in this case, "[CREATURE:DWARF]"), again stating the type of object, and then the object's unique identifier - if an indentifier isn't unique, the game will mess up and you'll get some serious, and potentially very trippy, errors. Below that, we have the body of the entry, which determines the entry's specific properties.

The body of an entry is made up of a series of "tokens", which are essentially flags that can be added or removed to affect the entry's attributes. Most of these effects are hardcoded: for example, it's possible to make a creature only eat meat with the [CARNIVOUROUS] token, but it's impossible to create your own token detailing a specific diet for the creature.

Before we continue, a few key things to remember when modding the raw files:

* Personally speaking, I don't recommend modifying the existing raw files, but if you want to edit an already-exiting creature, always back up the files you plan on editing to a different location. If you want to create backup files directly within the objects folder itself, take heed: the game doesn't distinguish between file extensions. It'll read a .bak file just as well as it'll read a .txt file, and (as mentioned previously) duplicate entries are a very bad thing.
* When a new world is generated, all the raw files get copied into a \raw\ folder within the applicable save folder. If you want to change something within a game that's already running, you'll have to edit those files, not the ones in ~DF\raw\objects.
* There's nothing stopping you from just copying an existing creature/entity/whatever, changing the identifier, and modifying it. This can save you a lot of time, especially when it comes to entities... which are coincidentally what we'll be talking about next.

== Modding civilisations (entities) ==

Entities - the objects that determine how civilisations work - are stored in entity_default.txt. They follow the same format as any other raw file:

entity_default

[OBJECT:ENTITY]

[ENTITY:ENTITYNAME]
[CREATURE:CREATURETYPE]
[TRANSLATION:LANGUAGETYPE]
[BIOME_SUPPORT:BIOMETOKEN:FREQENCY]
...[OTHER TAGS]...

Most of the time, it doesn't matter which order these tokens are in or where they're placed so long as they're below the "ENTITY:" identifier, but there are some important exceptions in the case of other files, especially creatures, which can contain a lot of "nested" tokens.

"[CREATURE:]" links the civilization with a specific creature defined in a creature file. This is the creature that'll be making up the entity's population, and will therefore be the creature you'll be playing as in fortress or adventure mode if the entity is a playable one. For example, if you wanted to do something silly, you could switch the "CREATURE:DWARF" entry in entity_default.txt with "CREATURE:ELF" and you would be marching elves around in fortress mode, although they would still use dwarven technology and language and names and so forth.

Oh, and before you get any funny ideas - it ''is'' possible to define more than one creature for a civ, but that won't work in quite the way you probably expect: later on, in the creature section, you'll learn about castes, which will provide a much more viable alternative, so try to bear with me until then.

"[TRANSLATION:]" defines the language file that the entity will be using, which will determine what their untranslated words are for things. This doesn't determine which words they use for naming things, only the way those words are spelt. The default language files are HUMAN, DWARF, ELF, and GOBLIN.

"[BIOME_SUPPORT:]" defines the biomes that civs will attempt to settle in. The "FREQUENCY" value determines the likelyhood of them building there, but also raises an important point: most of the values you'll be setting for things are relative to each other. If I was to type:

[BIOME_SUPPORT:ANY_FOREST:1]
[BIOME_SUPPORT:SAVANNA:2]

This would have very much the same effect as:

[BIOME_SUPPORT:ANY_FOREST:10]
[BIOME_SUPPORT:SAVANNA:5]

This holds true for a lot of values throughout the files, excluding when it simply doesn't make sense, such as in materials.

You can find many details about the rest of the civilization tokens [[Entity token|here]]. Besides those mentioned, some fundamental ones are the CIV_CONTROLLABLE token, which lets you control the civ in fortress mode, the INDIV_CONTROLLABLE token, which allows you to play the civ in adventure mode as an outsider, and the ADVENTURE_TIER token, which allows you to play a civ native (non-outsider) in adventure mode. Other tokens that you should pay attention to are START_BIOME and the ones regarding sites, but in general, you can just run through the aformentioned list and add or remove what you want.

If you have more than one civ with the CIV_CONTROLLABLE token, all the available civs from those entities will appear in the group selection section on the embark screen. It may not be immediately obvious from which species each civ may be - while this can be determined from legends mode, the topmost species in the "neighbors" display in the embark screen is always the same as the currently selected species; if your group is dwarven, dwarves will be topmost, whilst (say) elves will be topmost if your chosen group is elven. By default, the game seems to choose a civ (and therefore a species if there is more than one) at random.

You can also attempt to discern the civ yourself by the names it uses - this is the realm of "symbols", collections of words centered around a specific concept. The civ will use the words comprising whatever symbols are applicable to it for various things. This association might be a little obfuscating at first, so I'll run through it. Let's refer to the DWARF entity:

[SELECT_SYMBOL:WAR:NAME_WAR]
[SUBSELECT_SYMBOL:WAR:VIOLENT]
[SELECT_SYMBOL:BATTLE:NAME_BATTLE]
[SUBSELECT_SYMBOL:BATTLE:VIOLENT]
[SELECT_SYMBOL:SIEGE:NAME_SIEGE]
[SUBSELECT_SYMBOL:SIEGE:VIOLENT]

Here we can see that dwarves will generally name their wars first after words in the "NAME_WAR" symbol group, and then after words in the "VIOLENT" symbol group. This might, for example, result in a war being named "The War of Carnage". The symbols used for the other types of conflict are arrayed in a similar fashion. It would be trivial to replace the instances of VIOLENT with, say, PEACE and end up with a battle called "The Clash of Calm" or something.

[SELECT_SYMBOL:ROAD:NAME_ROAD]
[SELECT_SYMBOL:TUNNEL:NAME_TUNNEL]
[SELECT_SYMBOL:BRIDGE:NAME_BRIDGE]
[SELECT_SYMBOL:WALL:NAME_WALL]

The above applies here. Dwarves are fond of naming their roads and tunnels after roads and tunnels.

[SELECT_SYMBOL:REMAINING:ARTIFICE]
[SELECT_SYMBOL:REMAINING:EARTH]
[CULL_SYMBOL:ALL:DOMESTIC]
[CULL_SYMBOL:ALL:SUBORDINATE]
[CULL_SYMBOL:ALL:EVIL]
[CULL_SYMBOL:ALL:UNTOWARD]
[CULL_SYMBOL:ALL:FLOWERY]
[CULL_SYMBOL:ALL:NEGATIVE]
[CULL_SYMBOL:ALL:UGLY]
[CULL_SYMBOL:ALL:NEGATOR]

This section deals with everything else. The sections that haven't already been dealt with (hence the "REMAINING") will have names from the ARTIFICE and EARTH symbol groups. After that the dwarf entity is told to cull all innapropriate symbols - this applies to everything (hence the "ALL") so if the game happens to choose a symbol associated with, say, EVIL for one of the battles, it'll scrap that name and try again. This sort of thing adds a lot of flavour to DF's entities and can account for a lot of a civ's percieved personality.

Another basic thing to note: any entity token that's dealing with weapons, armor, clothing, etc., will state the items that the civ can build natively, not necessarily the ones they can wear or use. For example, you could create a species with no clothes specified, but then rob a clothes shop in adventurer mode and wear everything you want, or give them weapons that are too large to wield and they could sell them, but not use them.

An easy method of creating a civilization is just to copy-paste a similar one to the bottom of the entity_default.txt file and edit things to your liking. Remember to always change the civ's "ENTITY:" identifier! This can be anything so long as it's not already existing.

At the end of some of the default entries you'll find a list of positions, both ones that'll directly affect you in fort mode (such as nobles) and ones that'll primarily affect worldgen and adventure mode. A list of the tokens applicable to positions can be found [[DF2010:position token|here]]; they don't require a great deal of explaination.

== Modding the creatures ==

Creature modding is great fun. You can change nearly any aspect of a creature or make your own completely from scratch.

Modding creatures is very similar to modding civs: it's just a matter of editing, adding, or removing tokens, enclosed in square brackets underneath the creature's [CREATURE:] header. The creature entries contain all of the information about each and every non-random creature in the game, from animals to dwarves to goblins to even caravan wagons. A lot of the creature tokens are fairly self-explanatory; you can find a list of such tokens [[Creature_Tokens|here]].

In the most basic sense, a creature is a series of bodyparts. These parts are defined in their own file. As a specific aspect of how creatures work which throws off a lot of prospective modders is the relationship between creatures, tissues, and materials, I'm going to show you part of the creature entry for a bronze colossus (bear with me):

...
[BODY:HUMANOID:2EYES:2EARS:NOSE:HUMANOID_JOINTS:5FINGERS:5TOES]
[NO_THOUGHT_CENTER_FOR_MOVEMENT]
[TISSUE:BRONZE]
[TISSUE_NAME:bronze:bronze]
[TISSUE_MATERIAL:INORGANIC:BRONZE]
[MUSCULAR]
[FUNCTIONAL]
[STRUCTURAL]
[RELATIVE_THICKNESS:1]
[CONNECTS]
[TISSUE_SHAPE:LAYER]
[TISSUE_LAYER:BY_CATEGORY:ALL:BRONZE]
...

At the top, we can see the "BODY:" token, followed by a list of bodyparts. As you've probably guessed, these parts make up the physical form of the colossus. But the colossus has to be made out of something - it has to have tissues. And those tissues also have to be made out of something - in this case, bronze.

Below the BODY token you'll see a TISSUE token, followed by an identifier, much like the others we've seen. The TISSUE block is determining how the tissue works, and which purposes it'll serve. As the colossus is just going to be made out of this one tissue, this tissue needs to act like bone, muscle, and everything else combined, hence the MUSCULAR, FUNCTIONAL and STRUCTURAL tokens. The tissue also references a material - INORGANIC:BRONZE - the properties of which are declared in the inorganic materials file, and the tissue is subsequently made out of this material. With me so far?

Below the tissue definition is the TISSUE_LAYER line. TISSUE_LAYER allows you to control where each tissue is applied. Its first argument defines if it's to search by bodypart category (BY_CATEGORY), bodypart type (BY_PART), or look for a specific part (BY_TOKEN). That's followed by the parts argument itself, which is in this case ALL (so the game's looking for parts in all categories, which is to say, every bodypart). This is followed by the tissue to be applied, BRONZE. So the TISSUE_LAYER token is telling the game to select all bodyparts in every category and make them out of the tissue "BRONZE". The colossus is now made of bronze.

By now you're probably thinking "Wow, if this was for a creature made out of however many tissues, this would be amazingly longwinded". And you're right. Luckily, there are two methods by which we can speed things up a lot.

Firstly, there are material and tissue templates. Let's say you were going to make a lot of creatures out of bronze, and you didn't want to have to copy and paste the bronze tissue all over the place. Instead, you create a tissue template. This goes, as you've probably guessed, in a tissue template file.

[TISSUE_TEMPLATE:BRONZE_TEMPLATE]
[TISSUE_NAME:bronze:bronze]
[TISSUE_MATERIAL:INORGANIC:BRONZE]
[MUSCULAR]
[FUNCTIONAL]
[STRUCTURAL]
[RELATIVE_THICKNESS:1]
[CONNECTS]
[TISSUE_SHAPE:LAYER]

Now, instead of applying the tissue to each and every bronze creature you're making, you can just refer to the template:

...
[BODY:HUMANOID:2EYES:2EARS:NOSE:HUMANOID_JOINTS:5FINGERS:5TOES]
[NO_THOUGHT_CENTER_FOR_MOVEMENT]
[USE_TISSUE_TEMPLATE:BRONZE:BRONZE_TEMPLATE]
[TISSUE_LAYER:BY_CATEGORY:ALL:BRONZE]
...

Material templates work in the same way, but refer to materials instead of tissues.

However, if we're looking at something like a dwarf, even with the templates, editing can get very slow indeed:

...
[USE_MATERIAL_TEMPLATE:SKIN:SKIN_TEMPLATE]
[USE_MATERIAL_TEMPLATE:FAT:FAT_TEMPLATE]
[USE_MATERIAL_TEMPLATE:MUSCLE:MUSCLE_TEMPLATE]
[USE_MATERIAL_TEMPLATE:BONE:BONE_TEMPLATE]
[USE_MATERIAL_TEMPLATE:CARTILAGE:CARTILAGE_TEMPLATE]
[USE_MATERIAL_TEMPLATE:HAIR:HAIR_TEMPLATE]
[USE_MATERIAL_TEMPLATE:TOOTH:TOOTH_TEMPLATE]
[USE_MATERIAL_TEMPLATE:EYE:EYE_TEMPLATE]
[USE_MATERIAL_TEMPLATE:NERVE:NERVE_TEMPLATE]
[USE_MATERIAL_TEMPLATE:BRAIN:BRAIN_TEMPLATE]
[USE_MATERIAL_TEMPLATE:LUNG:LUNG_TEMPLATE]
[USE_MATERIAL_TEMPLATE:HEART:HEART_TEMPLATE]
[USE_MATERIAL_TEMPLATE:LIVER:LIVER_TEMPLATE]
[USE_MATERIAL_TEMPLATE:GUT:GUT_TEMPLATE]
[USE_MATERIAL_TEMPLATE:STOMACH:STOMACH_TEMPLATE]
[USE_MATERIAL_TEMPLATE:PANCREAS:PANCREAS_TEMPLATE]
[USE_MATERIAL_TEMPLATE:SPLEEN:SPLEEN_TEMPLATE]
[USE_MATERIAL_TEMPLATE:KIDNEY:KIDNEY_TEMPLATE]
[USE_TISSUE_TEMPLATE:SKIN:SKIN_TEMPLATE]
[USE_TISSUE_TEMPLATE:FAT:FAT_TEMPLATE]
[USE_TISSUE_TEMPLATE:MUSCLE:MUSCLE_TEMPLATE]
...

This is where body detail plans come in. Detail plans, of course, have their own file, and they are designed to help automate some of the more common processes in creature creation. The first entry in b_detail_plan_default.txt does exactly what we've been trying to do above: it takes all the common materials and shoves them into one plan, which can be referenced with a single token.

...
[BODY_DETAIL_PLAN:STANDARD_MATERIALS]
...

Much easier. But what about the TISSUE_LAYER tokens? Will we have to type out all of those manually?

Nope, detail plans have that covered as well. It's possible to place variable arguments into a detail plan. For example:

[BODY_DETAIL_PLAN:VERTEBRATE_TISSUE_LAYERS]
[BP_LAYERS:BY_CATEGORY:BODY:ARG3:50:ARG2:5:ARG1:1]
[BP_LAYERS:BY_CATEGORY:BODY_UPPER:ARG3:50:ARG2:5:ARG1:1]
[BP_LAYERS:BY_CATEGORY:BODY_LOWER:ARG3:50:ARG2:5:ARG1:1]
[BP_LAYERS:BY_CATEGORY:ARM:ARG4:25:ARG3:25:ARG2:5:ARG1:1]
[BP_LAYERS:BY_CATEGORY:ARM_UPPER:ARG4:25:ARG3:25:ARG2:5:ARG1:1]
...
[BP_LAYERS:BY_CATEGORY:NOSE:ARG5:4:ARG1:1]
...

First an argument is placed in the plan (ARG1, ARG2 etc.), followed by the thickness of the tissue that will be inserted in place of the argument. So when we reference the VERTEBRATE_TISSUE_LAYERS plan, we'll be able to do something like this:

[BODY_DETAIL_PLAN:VERTEBRATE_TISSUE_LAYERS:SKIN:FAT:MUSCLE:BONE:CARTILAGE]

ARG1 in the detail plan is replaced by SKIN, the first tissue we entered. ARG2 is replaced by FAT, ARG3 by muscle, ARG4 by bone, and ARG5 by CARTILAGE. Hence, our creature's bodypart designated as BODY is made up of SKIN with thickness 1, FAT with thickness 5, and MUSCLE with thickness 50. Its nose is made up of SKIN (thickness 1) and CARTILAGE (thickness 4).

Things left out of the body plans aside, our dwarf's entire body, material, tissue and tissue layer tokens have been boiled down to this:

...
[BODY:HUMANOID:2EYES:2EARS:NOSE:2LUNGS:HEART:GUTS:ORGANS:HUMANOID_JOINTS:
THROAT:NECK:SPINE:BRAIN:SKULL:5FINGERS:5TOES:MOUTH:FACIAL_FEATURES:TEETH:RIBCAGE]
[BODY_DETAIL_PLAN:STANDARD_MATERIALS]
[BODY_DETAIL_PLAN:STANDARD_TISSUES]
[BODY_DETAIL_PLAN:VERTEBRATE_TISSUE_LAYERS:SKIN:FAT:MUSCLE:BONE:CARTILAGE]
...

This can save you a lot of time and space if you're making lots of changes common to many creatures. In general, if you're making a creature that's fleshy or chitinous, there's detail plans already included in the game to help you out. You should only have to resort to declaring tissues individually (like our bronze colossus) if you're doing something really out-of-the-ordinary.

Another great thing about templates (and so, detail plans) is that they can be modified after being declared. Let's say I wanted my dwarves to be perpetually on fire (don't ask). We declare the body stuff normally:

...
[BODY:HUMANOID:2EYES:2EARS:NOSE:2LUNGS:HEART:GUTS:ORGANS:HUMANOID_JOINTS:
THROAT:NECK:SPINE:BRAIN:SKULL:5FINGERS:5TOES:MOUTH:FACIAL_FEATURES:TEETH:RIBCAGE]
[BODY_DETAIL_PLAN:STANDARD_MATERIALS]
[BODY_DETAIL_PLAN:STANDARD_TISSUES]
[BODY_DETAIL_PLAN:VERTEBRATE_TISSUE_LAYERS:SKIN:FAT:MUSCLE:BONE:CARTILAGE]
...

We then select the appropriate material:

...
[BODY:HUMANOID:2EYES:2EARS:NOSE:2LUNGS:HEART:GUTS:ORGANS:HUMANOID_JOINTS:
THROAT:NECK:SPINE:BRAIN:SKULL:5FINGERS:5TOES:MOUTH:FACIAL_FEATURES:TEETH:RIBCAGE]
[BODY_DETAIL_PLAN:STANDARD_MATERIALS]
[BODY_DETAIL_PLAN:STANDARD_TISSUES]
[BODY_DETAIL_PLAN:VERTEBRATE_TISSUE_LAYERS:SKIN:FAT:MUSCLE:BONE:CARTILAGE]
[SELECT_MATERIAL:SKIN]
[MAT_FIXED_TEMP:10600]
...

We don't want them burning to death, so we'll need to stop that from happening:

...
[BODY:HUMANOID:2EYES:2EARS:NOSE:2LUNGS:HEART:GUTS:ORGANS:HUMANOID_JOINTS:
THROAT:NECK:SPINE:BRAIN:SKULL:5FINGERS:5TOES:MOUTH:FACIAL_FEATURES:TEETH:RIBCAGE]
[BODY_DETAIL_PLAN:STANDARD_MATERIALS]
[BODY_DETAIL_PLAN:STANDARD_TISSUES]
[BODY_DETAIL_PLAN:VERTEBRATE_TISSUE_LAYERS:SKIN:FAT:MUSCLE:BONE:CARTILAGE]
[SELECT_MATERIAL:SKIN]
[MAT_FIXED_TEMP:10600]
[SELECT_MATERIAL:ALL]
[HEATDAM_POINT:NONE]
...

Note that this makes use of DF's built-in temperature scale. You can read more about that [[Temperature scale|on this page]]. I'm also referencing material tokens, which we haven't gone over yet - I'll talk about making your own materials later.

That's the most complex component of creature creation out of the way. You should find the rest trivial by comparison.

== Modding items ==

Items are fairly simple to deal with. By default, each item type is contained in its own file; this may help make browsing for a specific item easier, but from a purely technical point of view, it's possible to throw all items into one file. Unfortunately, item tokens don't seem to be especially well-documented (at least as not as well as the other object types), but you should be able to figure out most things by way of my explainations and your assumptions.

Let's look at the entry for, of course, the thong:

[ITEM_PANTS:ITEM_PANTS_THONG]
[NAME:thong:thongs]
[LAYER:UNDER]
[COVERAGE:25]
[LAYER_SIZE:10]
[LAYER_PERMIT:30]
[MATERIAL_SIZE:1]
[SOFT]
[LEATHER]
[STRUCTURAL_ELASTICITY_WOVEN_THREAD]

Most of these are pretty obvious if one compares them to the other entries in the file. There's a layer for the item, determining where it's worn; a coverage value to determine how well it protects you from cold and other things; a size token to determine how much it counts for when it's under something else; a layer permit token to determine how much can be worn under it; and a material size token to determine how much raw material it takes to make it.

Now, if you wanted to mod these to turn them into metal thongs (ouch!), you would simply have to add [METAL] to it somewhere, and probably [HARD] instead of [SOFT]. Simple! These tokens work by tying into material properties - some materials are designated as suitable for making hard items, some for soft, etc..

Weapons involve a little more detail:

[ITEM_WEAPON:ITEM_WEAPON_SWORD_2H]
[NAME:two-handed sword:two-handed swords]
[SIZE:900]
[SKILL:SWORD]
[TWO_HANDED:67500]
[MINIMUM_SIZE:62500]
[MATERIAL_SIZE:5]
[ATTACK:EDGE:100000:8000:slash:slashes:NO_SUB:1250]
[ATTACK:EDGE:50:4000:stab:stabs:NO_SUB:1000]
[ATTACK:BLUNT:100000:8000:slap:slaps:flat:1250]
[ATTACK:BLUNT:100:1000:strike:strikes:pommel:1000]

SIZE determines how heavy the weapon is. This has a substantial effect on weapon effectiveness. SKILL determines which skill is used in using the weapon; a list of skills can be found [[DF2010:Skill token|on this page]]. MINIMUM_SIZE determines the minimum size a creature must be before the weapon can be wielded, while TWO_HANDED determines how large a creature must be in order to wield the weapon with one hand.

Attacks take a little more explaination. The first value determines the contact area of the weapon's attack; this should be high for slashing or bludgeoning weapons, and low for piercing and poking ones. The second value determines how deep the weapon penetrates - for BLUNT attacks this value is ignored as they're not supposed to penetrate anyway, but in the case of EDGE attacks it should generally be lower for slashing attacks and higher for stabbing attacks.

Following these are the adjectives used; they should be self-explanatory. Finally, we have the velocity modifier, which has a multiplying effect on the weapon's size for the purposes of determining how powerful it is in combat.

Other, more miscellaneous items are generally simple and shouldn't require any further explaination.

Once you've made an item, you just add it to the civ entry so a civilization can actually craft it, and it's done.

== Modding language files ==

Coming later

== Modding body parts ==

Imagine you have this fantastic idea for a multi-tentacled winged spider-monster. Sounds great! But in order to make this a reality you may need to create a new set of body parts for it. That's no problem! Making body parts is easy, though it may look complicated at first.

All of the default body definitions are located in body_default.txt and then linked to a creature in the creature's entry. We've talked about how bodyparts make up creatures earlier, in the creature section. You can mix and match them in the creature entry and it makes no difference, as long as they're there: each bodypart will link itself to the appropriate connection automatically when the creature is first created.

Body parts work by sections: you can add as many sections as you want to a bodypart definition, but generally you should keep it fairly low for ease of use. Each body section entry is in the very simple format:

[BODY:BODYNAME]
[BP:TOKENID:name][TOKENSGOHERE][DEFAULT_RELSIZE:][CATEGORY:WHATEVER]

The most important tokens are "CONTYPE" and "CON": CONTYPE means the bodypart in question is connected to a certain *type* of bodypart, while CON means it's connected to a *specific* one. TOKENID is yet another identifier, which should be unique, as it's referenced every time something uses CON or BY_TOKEN. DEFAULT_RELSIZE defines, of course, what the bodypart's size is in relation to the other parts. CATEGORY defines a category for the part, which can be unique or shared with other parts. This is referenced whenever BY_CATEGORY is used.

A list of bodypart tokens can be found [[DF2010:Body token|here]].

Let's take a simple example, a head:

[BODY:BASIC_HEAD]
[BP:HD:head:STP][CONTYPE:UPPERBODY][HEAD][CATEGORY:HEAD]
[DEFAULT_RELSIZE:300]

It connects directly to an upper body.

[BODY:2EYES]
[BP:REYE:right eye:STP][CONTYPE:HEAD][SIGHT][EMBEDDED][SMALL][RIGHT][CATEGORY:EYE]
[DEFAULT_RELSIZE:5]
[BP:LEYE:left eye:STP][CONTYPE:HEAD][SIGHT][EMBEDDED][SMALL][LEFT][CATEGORY:EYE]
[DEFAULT_RELSIZE:5]

These are a pair of eyes, connecting to the head.

[BODY:HUMANOID]
[BP:UB:upper body:upper bodies][UPPERBODY][CATEGORY:BODY_UPPER]
[DEFAULT_RELSIZE:1000]
[BP:LB:lower body:lower bodies][CON:UB][LOWERBODY][CATEGORY:BODY_LOWER]
[DEFAULT_RELSIZE:1000]
[BP:HD:head:STP][CON:UB][HEAD][CATEGORY:HEAD]
[DEFAULT_RELSIZE:300]
[BP:RUA:right upper arm:STP][CON:UB][LIMB][RIGHT][CATEGORY:ARM_UPPER]
[DEFAULT_RELSIZE:200]
[BP:LUA:left upper arm:STP][CON:UB][LIMB][LEFT][CATEGORY:ARM_UPPER]
[DEFAULT_RELSIZE:200]
[BP:RLA:right lower arm:STP][CON:RUA][LIMB][RIGHT][CATEGORY:ARM_LOWER]
[DEFAULT_RELSIZE:200]
[BP:LLA:left lower arm:STP][CON:LUA][LIMB][LEFT][CATEGORY:ARM_LOWER]
[DEFAULT_RELSIZE:200]
[BP:RH:right hand:STP][CON:RLA][GRASP][RIGHT][CATEGORY:HAND]
[DEFAULT_RELSIZE:80]
[BP:LH:left hand:STP][CON:LLA][GRASP][LEFT][CATEGORY:HAND]
[DEFAULT_RELSIZE:80]
[BP:RUL:right upper leg:STP][CON:LB][LIMB][RIGHT][CATEGORY:LEG_UPPER]
[DEFAULT_RELSIZE:500]
[BP:LUL:left upper leg:STP][CON:LB][LIMB][LEFT][CATEGORY:LEG_UPPER]
[DEFAULT_RELSIZE:500]
[BP:RLL:right lower leg:STP][CON:RUL][LIMB][RIGHT][CATEGORY:LEG_LOWER]
[DEFAULT_RELSIZE:400]
[BP:LLL:left lower leg:STP][CON:LUL][LIMB][LEFT][CATEGORY:LEG_LOWER]
[DEFAULT_RELSIZE:400]
[BP:RF:right foot:right feet][CON:RLL][STANCE][RIGHT][CATEGORY:FOOT]
[DEFAULT_RELSIZE:120]
[BP:LF:left foot:left feet][CON:LLL][STANCE][LEFT][CATEGORY:FOOT]
[DEFAULT_RELSIZE:120]

An entire humanoid body. The foot bone's connected to the ankle bone...

A 'BODYGLOSS', which you can sometimes find in the creature entries, are simply replacement words for specific part names in a creature. For example, you'll find the bodygloss [BODYGLOSS:CLAW_HAND:hand:claw] in body_default.txt; you can then use this in a creature via '[BODYGLOSS:CLAW_HAND]' and it will replace all instances of "hand" with "claw" in that creature. For all intents and purposes the body part will still function as the proper part, though.

== Plants ==

Coming later

== Workshops ==

Coming later

== Materials ==

As we've seen when talking about creatures, materials are vital. Materials show up in two forms: material templates, which generally show up in creatures, and specific materials (designated as "inorganic"), which are (by default, at least) consigned purely to metal and stone types.

Let's take a look at METAL_TEMPLATE in material_template_default.txt. It's evident that most of the basic properties of metals are already defined in the template - it goes red and melts at a high enough temperature, it's heavy, and (as noted by the very bottom token) is a metal. We already know just how useful templates can be to creatures, and the same applies to other materials.

Now let's take a look at inorganic_metal.txt. You can see that the metals here refer to the templates, and, just like we did with creatures, then modify the properties of that template and expand upon it.

Finally, let's look at inorganic_stone_mineral.txt. Here we can see that in addition to the changes made to the template, there are also ENVIONMENT tokens - these tell the game where to place these minerals during worldgen.

[[DF2010:Material_definition_token|Here's a list of material tokens]]. It should also help you out with any modifications you want to make regarding those creature modifications we were making a while back. See, it all ties together in the end. The beauty of the current materials system is that there's actually very little difference between, say, leather and iron - they're fundamentally the same thing, just with different properties, which is how things really should be.

== Examples ==

Coming later

= Modding utilities =

Section needs updating

[[Category:DF2010:Modding]]
[[Category:DF2010:Guides]]

v0.31:Modding guide

2010-11-30T04:07:50Z

3: /* Materials */ Linked to wrong page

{{av}}{{Quality|Masterwork}}

This is intended to be a guide to inform those new to DF modding on what elements of the game can be modified, and how. After reading through this guide, a user should be capable of both editing creatures, entities, materials et al, and creating their own.

Generally breaking stuff is fine - nothing that can be changed will affect the DF executable, and new additions can be easily removed.

This guide is based on a guide originally created for version 0.27.176.39c (originally put to type by one Teldin; page found [[40d:Modding guide|here]]) and has later been rewritten for 0.31.xx.xx by (a) different author(s).

'''See also:''' [[:Category:DF2010:Modding]]

= Modding Guide =

== Basics of DF modding ==

All the base data that can be edited by prospective modders can be found in the \raw\ folder. This folder contains two subfolders: "graphics" (where you insert [[DF2010:Graphics_set_respository|graphics sets]]), and "objects", which contains all the data for generally everything in the game that is not hardcoded (randomly created creatures aside).

Within the \raw\objects folder are a large number of text files - these are the [[Raw file|raw files]], and editing them is quite easy - you can also create your own if you wish. For now, take a look at one of the existing files. It should look something like this:

creature_standard

[OBJECT:CREATURE]

[CREATURE:DWARF]
[DESCRIPTION:A short, sturdy creature fond of drink and industry.]
[NAME:dwarf:dwarves:dwarven]
[CASTE_NAME:dwarf:dwarves:dwarven]
[CREATURE_TILE:1][COLOR:3:0:0]
[CREATURE_SOLDIER_TILE:2]
...

As you can see, each file is comprised of a header string stating the file name, a second header stating the type of object data it contains, followed by the contents of the file itself. These are all necessary elements of the file, and without them, the file won't be parsed correctly by the game. You may have also noticed the file naming scheme - this is also important; files containing creatures have names starting with "creature_", entity file names must begin with "entity_", etc..

Below the headers, there begins a list of entries. Each entry is made up of its own header (in this case, "[CREATURE:DWARF]"), again stating the type of object, and then the object's unique identifier - if an indentifier isn't unique, the game will mess up and you'll get some serious, and potentially very trippy, errors. Below that, we have the body of the entry, which determines the entry's specific properties.

The body of an entry is made up of a series of "tokens", which are essentially flags that can be added or removed to affect the entry's attributes. Most of these effects are hardcoded: for example, it's possible to make a creature only eat meat with the [CARNIVOUROUS] token, but it's impossible to create your own token detailing a specific diet for the creature.

Before we continue, a few key things to remember when modding the raw files:

* Personally speaking, I don't recommend modifying the existing raw files, but if you want to edit an already-exiting creature, always back up the files you plan on editing to a different location. If you want to create backup files directly within the objects folder itself, take heed: the game doesn't distinguish between file extensions. It'll read a .bak file just as well as it'll read a .txt file, and (as mentioned previously) duplicate entries are a very bad thing.
* When a new world is generated, all the raw files get copied into a \raw\ folder within the applicable save folder. If you want to change something within a game that's already running, you'll have to edit those files, not the ones in ~DF\raw\objects.
* There's nothing stopping you from just copying an existing creature/entity/whatever, changing the identifier, and modifying it. This can save you a lot of time, especially when it comes to entities... which are coincidentally what we'll be talking about next.

== Modding civilisations (entities) ==

Entities - the objects that determine how civilisations work - are stored in entity_default.txt. They follow the same format as any other raw file:

entity_default

[OBJECT:ENTITY]

[ENTITY:ENTITYNAME]
[CREATURE:CREATURETYPE]
[TRANSLATION:LANGUAGETYPE]
[BIOME_SUPPORT:BIOMETOKEN:FREQENCY]
...[OTHER TAGS]...

Most of the time, it doesn't matter which order these tokens are in or where they're placed so long as they're below the "ENTITY:" identifier, but there are some important exceptions in the case of other files, especially creatures, which can contain a lot of "nested" tokens.

"[CREATURE:]" links the civilization with a specific creature defined in a creature file. This is the creature that'll be making up the entity's population, and will therefore be the creature you'll be playing as in fortress or adventure mode if the entity is a playable one. For example, if you wanted to do something silly, you could switch the "CREATURE:DWARF" entry in entity_default.txt with "CREATURE:ELF" and you would be marching elves around in fortress mode, although they would still use dwarven technology and language and names and so forth.

Oh, and before you get any funny ideas - it ''is'' possible to define more than one creature for a civ, but that won't work in quite the way you probably expect: later on we'll be talking about creature castes, which will provide a much more viable alternative, so try to bear with me until then.

"[TRANSLATION:]" defines the language file that the entity will be using, which will determine what their untranslated words are for things. This doesn't determine which words they use for naming things, only the way those words are spelt. The default language files are HUMAN, DWARF, ELF, and GOBLIN.

"[BIOME_SUPPORT:]" defines the biomes that civs will attempt to settle in. The "FREQUENCY" value determines the likelyhood of them building there, but also raises an important point: most of the values you'll be setting for things are relative to each other. If I was to type:

[BIOME_SUPPORT:ANY_FOREST:1]
[BIOME_SUPPORT:SAVANNA:2]

This would have very much the same effect as:

[BIOME_SUPPORT:ANY_FOREST:10]
[BIOME_SUPPORT:SAVANNA:5]

This holds true for a lot of values throughout the files, excluding when it simply doesn't make sense, such as in materials.

You can find many details about the rest of the civilization tokens [[Entity token|here]]. Besides those mentioned, some fundamental ones are the CIV_CONTROLLABLE token, which lets you control the civ in fortress mode, the INDIV_CONTROLLABLE token, which allows you to play the civ in adventure mode as an outsider, and the ADVENTURE_TIER token, which allows you to play a civ native (non-outsider) in adventure mode. Other tokens that you should pay attention to are START_BIOME and the ones regarding sites, but in general, you can just run through the aformentioned list and add or remove what you want.

If you have more than one civ with the CIV_CONTROLLABLE token, all the available civs from those entities will appear in the group selection section on the embark screen. It may not be immediately obvious from which species each civ may be - while this can be determined from legends mode, the topmost species in the "neighbors" display in the embark screen is always the same as the currently selected species; if your group is dwarven, dwarves will be topmost, whilst (say) elves will be topmost if your chosen group is elven. By default, the game seems to choose a civ (and therefore a species if there is more than one) at random.

You can also attempt to discern the civ yourself by the names it uses - this is the realm of "symbols", collections of words centered around a specific concept. The civ will use the words comprising whatever symbols are applicable to it for various things. This association might be a little obfuscating at first, so I'll run through it. Let's refer to the DWARF entity:

[SELECT_SYMBOL:WAR:NAME_WAR]
[SUBSELECT_SYMBOL:WAR:VIOLENT]
[SELECT_SYMBOL:BATTLE:NAME_BATTLE]
[SUBSELECT_SYMBOL:BATTLE:VIOLENT]
[SELECT_SYMBOL:SIEGE:NAME_SIEGE]
[SUBSELECT_SYMBOL:SIEGE:VIOLENT]

Here we can see that dwarves will generally name their wars first after words in the "NAME_WAR" symbol group, and then after words in the "VIOLENT" symbol group. This might, for example, result in a war being named "The War of Carnage". The symbols used for the other types of conflict are arrayed in a similar fashion. It would be trivial to replace the instances of VIOLENT with, say, PEACE and end up with a battle called "The Clash of Calm" or something.

[SELECT_SYMBOL:ROAD:NAME_ROAD]
[SELECT_SYMBOL:TUNNEL:NAME_TUNNEL]
[SELECT_SYMBOL:BRIDGE:NAME_BRIDGE]
[SELECT_SYMBOL:WALL:NAME_WALL]

The above applies here. Dwarves are fond of naming their roads and tunnels after roads and tunnels.

[SELECT_SYMBOL:REMAINING:ARTIFICE]
[SELECT_SYMBOL:REMAINING:EARTH]
[CULL_SYMBOL:ALL:DOMESTIC]
[CULL_SYMBOL:ALL:SUBORDINATE]
[CULL_SYMBOL:ALL:EVIL]
[CULL_SYMBOL:ALL:UNTOWARD]
[CULL_SYMBOL:ALL:FLOWERY]
[CULL_SYMBOL:ALL:NEGATIVE]
[CULL_SYMBOL:ALL:UGLY]
[CULL_SYMBOL:ALL:NEGATOR]

This section deals with everything else. The sections that haven't already been dealt with (hence the "REMAINING") will have names from the ARTIFICE and EARTH symbol groups. After that the dwarf entity is told to cull all innapropriate symbols - this applies to everything (hence the "ALL") so if the game happens to choose a symbol associated with, say, EVIL for one of the battles, it'll scrap that name and try again. This sort of thing adds a lot of flavour to DF's entities and can account for a lot of a civ's percieved personality.

Another basic thing to note: any entity token that's dealing with weapons, armor, clothing, etc., will state the items that the civ can build natively, not necessarily the ones they can wear. For example, you could create a species with no clothes specified, but then rob a clothes shop in adventurer mode and wear everything you want, or give them weapons that are too large to wield and they could sell them, but not use them.

An easy method of creating a civilization is just to copy-paste a similar one to the bottom of the entity_default.txt file and edit things to your liking. Remember to always change the civ's "ENTITY:" identifier! This can be anything so long as it's not already existing.

At the end of some of the default entries you'll find a list of positions, both ones that'll directly affect you in fort mode (such as nobles) and ones that'll primarily affect worldgen and adventure mode. A list of the tokens applicable to positions can be found [[DF2010:position token|here]]; they don't require a great deal of explaination.

== Modding the creatures ==

Creature modding is great fun. You can change nearly any aspect of a creature or make your own completely from scratch.

Modding creatures is very similar to modding civs: it's just a matter of editing, adding, or removing tokens, enclosed in square brackets underneath the creature's [CREATURE:] header. The creature entries contain all of the information about each and every non-random creature in the game, from animals to dwarves to goblins to even caravan wagons. A lot of the creature tokens are fairly self-explanatory; you can find a list of such tokens [[Creature_Tokens|here]].

In the most basic sense, a creature is a series of bodyparts. These parts are defined in their own file. As a specific aspect of how creatures work which throws off a lot of prospective modders is the relationship between creatures, tissues, and materials, I'm going to show you part of the creature entry for a bronze colossus (bear with me):

...
[BODY:HUMANOID:2EYES:2EARS:NOSE:HUMANOID_JOINTS:5FINGERS:5TOES]
[NO_THOUGHT_CENTER_FOR_MOVEMENT]
[TISSUE:BRONZE]
[TISSUE_NAME:bronze:bronze]
[TISSUE_MATERIAL:INORGANIC:BRONZE]
[MUSCULAR]
[FUNCTIONAL]
[STRUCTURAL]
[RELATIVE_THICKNESS:1]
[CONNECTS]
[TISSUE_SHAPE:LAYER]
[TISSUE_LAYER:BY_CATEGORY:ALL:BRONZE]
...

At the top, we can see the "BODY:" token, followed by a list of bodyparts. As you've probably guessed, these parts make up the physical form of the colossus. But the colossus has to be made out of something - it has to have tissues. And those tissues also have to be made out of something - in this case, bronze.

Below the BODY token you'll see a TISSUE token, followed by an identifier, much like the others we've seen. The TISSUE block is determining how the tissue works, and which purposes it'll serve. As the colossus is just going to be made out of this one tissue, this tissue needs to act like bone, muscle, and everything else combined, hence the MUSCULAR, FUNCTIONAL and STRUCTURAL tokens. The tissue also references a material - INORGANIC:BRONZE - the properties of which are declared in the inorganic materials file, and the tissue is subsequently made out of this material. With me so far?

Below the tissue definition is the TISSUE_LAYER line. TISSUE_LAYER allows you to control where each tissue is applied. Its first argument if it's to search by bodypart category (BY_CATEGORY), bodypart type (BY_PART), or look for a specific part (BY_TOKEN). That's followed by the parts argument itself, which is in this case ALL (so the game's looking for parts in every category, which is to say, every bodypart). This is followed by the tissue to be applied, BRONZE. So the TISSUE_LAYER token is telling the game to select all bodyparts in every category and make them out of the tissue "BRONZE". The colossus is now made of bronze.

By now you're probably thinking "Wow, if this was for a creature made out of however many tissues, this would be amazingly longwinded". And you're right. Luckily, there are two methods by which we can speed things up a lot.

Firstly, there are material and tissue templates. Let's say you were going to make a lot of creatures out of bronze, and you didn't want to have to copy and paste the bronze tissue all over the place. Instead, you create a tissue template. This goes, as you've probably guessed, in a tissue template file.

[TISSUE_TEMPLATE:BRONZE_TEMPLATE]
[TISSUE_NAME:bronze:bronze]
[TISSUE_MATERIAL:INORGANIC:BRONZE]
[MUSCULAR]
[FUNCTIONAL]
[STRUCTURAL]
[RELATIVE_THICKNESS:1]
[CONNECTS]
[TISSUE_SHAPE:LAYER]

Now, instead of applying the tissue to each and every bronze creature you're making, you can just refer to the template:

...
[BODY:HUMANOID:2EYES:2EARS:NOSE:HUMANOID_JOINTS:5FINGERS:5TOES]
[NO_THOUGHT_CENTER_FOR_MOVEMENT]
[USE_TISSUE_TEMPLATE:BRONZE:BRONZE_TEMPLATE]
[TISSUE_LAYER:BY_CATEGORY:ALL:BRONZE]
...

Material templates work in the same way, but refer to materials instead of tissues.

However, if we're looking at something like a dwarf, even with the templates, editing can get very slow indeed:

...
[USE_MATERIAL_TEMPLATE:SKIN:SKIN_TEMPLATE]
[USE_MATERIAL_TEMPLATE:FAT:FAT_TEMPLATE]
[USE_MATERIAL_TEMPLATE:MUSCLE:MUSCLE_TEMPLATE]
[USE_MATERIAL_TEMPLATE:BONE:BONE_TEMPLATE]
[USE_MATERIAL_TEMPLATE:CARTILAGE:CARTILAGE_TEMPLATE]
[USE_MATERIAL_TEMPLATE:HAIR:HAIR_TEMPLATE]
[USE_MATERIAL_TEMPLATE:TOOTH:TOOTH_TEMPLATE]
[USE_MATERIAL_TEMPLATE:EYE:EYE_TEMPLATE]
[USE_MATERIAL_TEMPLATE:NERVE:NERVE_TEMPLATE]
[USE_MATERIAL_TEMPLATE:BRAIN:BRAIN_TEMPLATE]
[USE_MATERIAL_TEMPLATE:LUNG:LUNG_TEMPLATE]
[USE_MATERIAL_TEMPLATE:HEART:HEART_TEMPLATE]
[USE_MATERIAL_TEMPLATE:LIVER:LIVER_TEMPLATE]
[USE_MATERIAL_TEMPLATE:GUT:GUT_TEMPLATE]
[USE_MATERIAL_TEMPLATE:STOMACH:STOMACH_TEMPLATE]
[USE_MATERIAL_TEMPLATE:PANCREAS:PANCREAS_TEMPLATE]
[USE_MATERIAL_TEMPLATE:SPLEEN:SPLEEN_TEMPLATE]
[USE_MATERIAL_TEMPLATE:KIDNEY:KIDNEY_TEMPLATE]
[USE_TISSUE_TEMPLATE:SKIN:SKIN_TEMPLATE]
[USE_TISSUE_TEMPLATE:FAT:FAT_TEMPLATE]
[USE_TISSUE_TEMPLATE:MUSCLE:MUSCLE_TEMPLATE]
...

This is where body detail plans come in. Detail plans, of course, have their own file, and they are designed to help automate some of the more common processes in creature creation. The first entry in b_detail_plan_default.txt does exactly what we've been trying to do above: it takes all the common materials and shoves them into one plan, which can be referenced with a single token.

...
[BODY_DETAIL_PLAN:STANDARD_MATERIALS]
...

Much easier. But what about the TISSUE_LAYER tokens? Will we have to type out all of those manually?

Nope, detail plans have that covered as well. It's possible to place variable arguments into a detail plan. For example:

[BODY_DETAIL_PLAN:VERTEBRATE_TISSUE_LAYERS]
[BP_LAYERS:BY_CATEGORY:BODY:ARG3:50:ARG2:5:ARG1:1]
[BP_LAYERS:BY_CATEGORY:BODY_UPPER:ARG3:50:ARG2:5:ARG1:1]
[BP_LAYERS:BY_CATEGORY:BODY_LOWER:ARG3:50:ARG2:5:ARG1:1]
[BP_LAYERS:BY_CATEGORY:ARM:ARG4:25:ARG3:25:ARG2:5:ARG1:1]
[BP_LAYERS:BY_CATEGORY:ARM_UPPER:ARG4:25:ARG3:25:ARG2:5:ARG1:1]
...
[BP_LAYERS:BY_CATEGORY:NOSE:ARG5:4:ARG1:1]
...

First an argument is placed in the plan (ARG1, ARG2 etc.), followed by the thickness of the tissue that will be inserted in place of the argument. So when we refernce the VERTEBRATE_TISSUE_LAYERS plan, we'll be able to do something like this:

[BODY_DETAIL_PLAN:VERTEBRATE_TISSUE_LAYERS:SKIN:FAT:MUSCLE:BONE:CARTILAGE]

ARG1 in the detail plan is replaced by SKIN, the first tissue we entered. ARG2 is replaced by FAT, ARG3 by muscle, ARG4 by bone, and ARG5 by CARTILAGE. Hence, our creature's bodypart designated as BODY is made up of SKIN with thickness 1, FAT with thickness 5, and MUSCLE with thickness 50. Its nose is made up of SKIN (thickness 1) and CARTILAGE (thickness 4).

Things left out of the body plans aside, our dwarf's entire body, tissue and tissue layer tokens have been boiled down to this:

...
[BODY:HUMANOID:2EYES:2EARS:NOSE:2LUNGS:HEART:GUTS:ORGANS:HUMANOID_JOINTS:
THROAT:NECK:SPINE:BRAIN:SKULL:5FINGERS:5TOES:MOUTH:FACIAL_FEATURES:TEETH:RIBCAGE]
[BODY_DETAIL_PLAN:STANDARD_MATERIALS]
[BODY_DETAIL_PLAN:STANDARD_TISSUES]
[BODY_DETAIL_PLAN:VERTEBRATE_TISSUE_LAYERS:SKIN:FAT:MUSCLE:BONE:CARTILAGE]
...

This can save you a lot of time and space if you're making lots of changes common to many creatures. In general, if you're making a creature that's fleshy or chitinous, there's detail plans already included in the game to help you out. You should only have to resort to declaring tissues individually (like our bronze colossus) if you're doing something really out-of-the-ordinary.

Another great thing about templates (and so, detail plans) is that they can be modified after being declared. Let's say I wanted my dwarves to be perpetually on fire (don't ask). We declare the body stuff normally:

...
[BODY:HUMANOID:2EYES:2EARS:NOSE:2LUNGS:HEART:GUTS:ORGANS:HUMANOID_JOINTS:
THROAT:NECK:SPINE:BRAIN:SKULL:5FINGERS:5TOES:MOUTH:FACIAL_FEATURES:TEETH:RIBCAGE]
[BODY_DETAIL_PLAN:STANDARD_MATERIALS]
[BODY_DETAIL_PLAN:STANDARD_TISSUES]
[BODY_DETAIL_PLAN:VERTEBRATE_TISSUE_LAYERS:SKIN:FAT:MUSCLE:BONE:CARTILAGE]
...

We then select the appropriate material:

...
[BODY:HUMANOID:2EYES:2EARS:NOSE:2LUNGS:HEART:GUTS:ORGANS:HUMANOID_JOINTS:
THROAT:NECK:SPINE:BRAIN:SKULL:5FINGERS:5TOES:MOUTH:FACIAL_FEATURES:TEETH:RIBCAGE]
[BODY_DETAIL_PLAN:STANDARD_MATERIALS]
[BODY_DETAIL_PLAN:STANDARD_TISSUES]
[BODY_DETAIL_PLAN:VERTEBRATE_TISSUE_LAYERS:SKIN:FAT:MUSCLE:BONE:CARTILAGE]
[SELECT_MATERIAL:SKIN]
[MAT_FIXED_TEMP:10600]
...

We don't want them burning to death, so we'll need to stop that from happening:

...
[BODY:HUMANOID:2EYES:2EARS:NOSE:2LUNGS:HEART:GUTS:ORGANS:HUMANOID_JOINTS:
THROAT:NECK:SPINE:BRAIN:SKULL:5FINGERS:5TOES:MOUTH:FACIAL_FEATURES:TEETH:RIBCAGE]
[BODY_DETAIL_PLAN:STANDARD_MATERIALS]
[BODY_DETAIL_PLAN:STANDARD_TISSUES]
[BODY_DETAIL_PLAN:VERTEBRATE_TISSUE_LAYERS:SKIN:FAT:MUSCLE:BONE:CARTILAGE]
[SELECT_MATERIAL:SKIN]
[MAT_FIXED_TEMP:10600]
[SELECT_MATERIAL:ALL]
[HEATDAM_POINT:NONE]
...

Note that this makes use of DF's built-in temperature scale. You can read more about that [[Temperature scale|on this page]]. I'm also referencing material tokens, which we haven't gone over yet - I'll talk about making your own materials later.

That's the most complex component of creature creation out of the way. You should find the rest trivial by comparison.

== Modding items ==

Items are fairly simple to deal with. By default, each item type is contained in its own file; this may help make browsing for a specific item easier, but from a purely technical point of view, it's possible to throw all items into one file. Unfortunately, item tokens don't seem to be especially well-documented (at least as not as well as the other object types), but you should be able to figure out most things by way of my explainations and your assumptions.

Let's look at the entry for, of course, the thong:

[ITEM_PANTS:ITEM_PANTS_THONG]
[NAME:thong:thongs]
[LAYER:UNDER]
[COVERAGE:25]
[LAYER_SIZE:10]
[LAYER_PERMIT:30]
[MATERIAL_SIZE:1]
[SOFT]
[LEATHER]
[STRUCTURAL_ELASTICITY_WOVEN_THREAD]

Most of these are pretty obvious if one compares them to the other entries in the file. There's a layer for the item, determining where it's worn; a coverage value to determine how well it protects you from cold and other things; a size token to determine how much it counts for when it's under something else; a layer permit token to determine how much can be worn under it; and a material size token to determine how much raw material it takes to make it.

Now, if you wanted to mod these to turn them into metal thongs (ouch!), you would simply have to add [METAL] to it somewhere, and probably [HARD] instead of [SOFT]. Simple! These tokens work by tying into material properties - some materials are designated as suitable for making hard items, some for soft, etc..

Weapons involve a little more detail:

[ITEM_WEAPON:ITEM_WEAPON_SWORD_2H]
[NAME:two-handed sword:two-handed swords]
[SIZE:900]
[SKILL:SWORD]
[TWO_HANDED:67500]
[MINIMUM_SIZE:62500]
[MATERIAL_SIZE:5]
[ATTACK:EDGE:100000:8000:slash:slashes:NO_SUB:1250]
[ATTACK:EDGE:50:4000:stab:stabs:NO_SUB:1000]
[ATTACK:BLUNT:100000:8000:slap:slaps:flat:1250]
[ATTACK:BLUNT:100:1000:strike:strikes:pommel:1000]

SIZE determines how heavy the weapon is. This has a substantial effect on weapon effectiveness. SKILL determines which skill is used in using the weapon; a list of skills can be found [[DF2010:Skill token|on this page]]. MINIMUM_SIZE determines the minimum size a creature must be before the weapon can be wielded, while TWO_HANDED determines how large a creature must be in order to wield the weapon with one hand.

Attacks take a little more explaination. The first value determines the contact area of the weapon's attack; this should be high for slashing or bludgeoning weapons, and low for piercing and poking ones. The second value determines how deep the weapon penetrates - for BLUNT attacks this value is ignored as they're not supposed to penetrate anyway, but in the case of EDGE attacks it should generally be lower for slashing attacks and higher for stabbing attacks.

Following these are the adjectives used; they should be self-explanatory. Finally, we have the velocity modifier, which has a multiplying effect on the weapon's size for the purposes of determining how powerful it is in combat.

Other, more miscellaneous items are generally simple and shouldn't require any further explaination.

Once you've made an item, you just add it to the civ entry so a civilization can actually craft it, and it's done.

== Modding language files ==

Coming later

== Modding body parts ==

Imagine you have this fantastic idea for a multi-tentacled winged spider-monster. Sounds great! But in order to make this a reality you may need to create a new set of body parts for it. That's no problem! Making body parts is easy, though it may look complicated at first.

All of the default body definitions are located in body_default.txt and then linked to a creature in the creature's entry. We've talked about how bodyparts make up creatures earlier, in the creature section. You can mix and match them in the creature entry and it makes no difference, as long as they're there: each bodypart will link itself to the appropriate connection automatically when the creature is first created.

Body parts work by sections: you can add as many sections as you want to a bodypart definition, but generally you should keep it fairly low for ease of use. Each body section entry is in the very simple format:

[BODY:BODYNAME]
[BP:TOKENID:name][TOKENSGOHERE][DEFAULT_RELSIZE:][CATEGORY:WHATEVER]

The most important tokens are "CONTYPE" and "CON": CONTYPE means the bodypart in question is connected to a certain *type* of bodypart, while CON means it's connected to a *specific* one. TOKENID is yet another identifier, which should be unique, as it's referenced every time something uses CON or BY_TOKEN. DEFAULT_RELSIZE defines, of course, what the bodypart's size is in relation to the other parts. CATEGORY defines a category for the part, which can be unique or shared with other parts. This is referenced whenever BY_CATEGORY is used.

A list of bodypart tokens can be found [[DF2010:Body token|here]].

Let's take a simple example, a head:

[BODY:BASIC_HEAD]
[BP:HD:head:STP][CONTYPE:UPPERBODY][HEAD][CATEGORY:HEAD]
[DEFAULT_RELSIZE:300]

It connects directly to an upper body.

[BODY:2EYES]
[BP:REYE:right eye:STP][CONTYPE:HEAD][SIGHT][EMBEDDED][SMALL][RIGHT][CATEGORY:EYE]
[DEFAULT_RELSIZE:5]
[BP:LEYE:left eye:STP][CONTYPE:HEAD][SIGHT][EMBEDDED][SMALL][LEFT][CATEGORY:EYE]
[DEFAULT_RELSIZE:5]

These are a pair of eyes, connecting to the head.

[BODY:HUMANOID]
[BP:UB:upper body:upper bodies][UPPERBODY][CATEGORY:BODY_UPPER]
[DEFAULT_RELSIZE:1000]
[BP:LB:lower body:lower bodies][CON:UB][LOWERBODY][CATEGORY:BODY_LOWER]
[DEFAULT_RELSIZE:1000]
[BP:HD:head:STP][CON:UB][HEAD][CATEGORY:HEAD]
[DEFAULT_RELSIZE:300]
[BP:RUA:right upper arm:STP][CON:UB][LIMB][RIGHT][CATEGORY:ARM_UPPER]
[DEFAULT_RELSIZE:200]
[BP:LUA:left upper arm:STP][CON:UB][LIMB][LEFT][CATEGORY:ARM_UPPER]
[DEFAULT_RELSIZE:200]
[BP:RLA:right lower arm:STP][CON:RUA][LIMB][RIGHT][CATEGORY:ARM_LOWER]
[DEFAULT_RELSIZE:200]
[BP:LLA:left lower arm:STP][CON:LUA][LIMB][LEFT][CATEGORY:ARM_LOWER]
[DEFAULT_RELSIZE:200]
[BP:RH:right hand:STP][CON:RLA][GRASP][RIGHT][CATEGORY:HAND]
[DEFAULT_RELSIZE:80]
[BP:LH:left hand:STP][CON:LLA][GRASP][LEFT][CATEGORY:HAND]
[DEFAULT_RELSIZE:80]
[BP:RUL:right upper leg:STP][CON:LB][LIMB][RIGHT][CATEGORY:LEG_UPPER]
[DEFAULT_RELSIZE:500]
[BP:LUL:left upper leg:STP][CON:LB][LIMB][LEFT][CATEGORY:LEG_UPPER]
[DEFAULT_RELSIZE:500]
[BP:RLL:right lower leg:STP][CON:RUL][LIMB][RIGHT][CATEGORY:LEG_LOWER]
[DEFAULT_RELSIZE:400]
[BP:LLL:left lower leg:STP][CON:LUL][LIMB][LEFT][CATEGORY:LEG_LOWER]
[DEFAULT_RELSIZE:400]
[BP:RF:right foot:right feet][CON:RLL][STANCE][RIGHT][CATEGORY:FOOT]
[DEFAULT_RELSIZE:120]
[BP:LF:left foot:left feet][CON:LLL][STANCE][LEFT][CATEGORY:FOOT]
[DEFAULT_RELSIZE:120]

An entire humanoid body. The foot bone's connected to the ankle bone...

A 'BODYGLOSS', which you can sometimes find in the creature entries, are simply replacement words for certain defined words in a creature. For example, you'll find the bodygloss [BODYGLOSS:CLAW_HAND:hand:claw] in the body_default.txt, and then you can use this in a creature with '[BODYGLOSS:CLAW_HAND]' and it will replace all instances of "hand" with "claw" in that creature. For all intent and purpose the body part will still function as the proper part, though.

== Plants ==

Coming later

== Workshops ==

Coming later

== Materials ==

As we've seen when talking about creatures, materials are vital. Materials show up in two forms: material templates, which generally show up in creatures, and specific materials (designated as "inorganic", which are (by default, at least) consigned purely to metal and stone types.

Let's take a look at METAL_TEMPLATE in material_template_default.txt. It's evident that most of the basic properties of metals are already defined in the template - it goes red and melts at a high enough temperature, it's heavy, and (as noted by the very bottom token) is a metal. We already know just how useful templates can be to creatures, and the same applies to other materials.

Now let's take a look at inorganic_metal.txt. You can see that the metals here refer to the templates, and, just like we did with creatures, then modify the properties of that template and expand upon it.

Finally, let's look at inorganic_stone_mineral.txt. Here we can see that in additon to the changes made to the template, there are also ENVIONMENT tokens - these tell the game where to place these minerals during worldgen.

[[DF2010:Material_definition_token|Here's a list of material tokens]]. It should also help you out with any modifications you want to make regarding those creature modifications we were making a while back. See, it all ties together in the end. The beauty of the current materials system is that there's actually very little difference between, say, leather and iron - they're fundamentally the same thing, just with different properties, which is how things really should be.

== Examples ==

Coming later

= Modding utilities =

Section needs updating

[[Category:DF2010:Modding]]
[[Category:DF2010:Guides]]

v0.31:Modding guide

2010-11-30T03:57:46Z

3: Self-reminder. Hm, seems I timed out while making the edits. Oh well.

{{av}}{{Quality|Masterwork}}

This is intended to be a guide to inform those new to DF modding on what elements of the game can be modified, and how. After reading through this guide, a user should be capable of both editing creatures, entities, materials et al, and creating their own.

Generally breaking stuff is fine - nothing that can be changed will affect the DF executable, and new additions can be easily removed.

This guide is based on a guide originally created for version 0.27.176.39c (originally put to type by one Teldin; page found [[40d:Modding guide|here]]) and has later been rewritten for 0.31.xx.xx by (a) different author(s).

'''See also:''' [[:Category:DF2010:Modding]]

= Modding Guide =

== Basics of DF modding ==

All the base data that can be edited by prospective modders can be found in the \raw\ folder. This folder contains two subfolders: "graphics" (where you insert [[DF2010:Graphics_set_respository|graphics sets]]), and "objects", which contains all the data for generally everything in the game that is not hardcoded (randomly created creatures aside).

Within the \raw\objects folder are a large number of text files - these are the [[Raw file|raw files]], and editing them is quite easy - you can also create your own if you wish. For now, take a look at one of the existing files. It should look something like this:

creature_standard

[OBJECT:CREATURE]

[CREATURE:DWARF]
[DESCRIPTION:A short, sturdy creature fond of drink and industry.]
[NAME:dwarf:dwarves:dwarven]
[CASTE_NAME:dwarf:dwarves:dwarven]
[CREATURE_TILE:1][COLOR:3:0:0]
[CREATURE_SOLDIER_TILE:2]
...

As you can see, each file is comprised of a header string stating the file name, a second header stating the type of object data it contains, followed by the contents of the file itself. These are all necessary elements of the file, and without them, the file won't be parsed correctly by the game. You may have also noticed the file naming scheme - this is also important; files containing creatures have names starting with "creature_", entity file names must begin with "entity_", etc..

Below the headers, there begins a list of entries. Each entry is made up of its own header (in this case, "[CREATURE:DWARF]"), again stating the type of object, and then the object's unique identifier - if an indentifier isn't unique, the game will mess up and you'll get some serious, and potentially very trippy, errors. Below that, we have the body of the entry, which determines the entry's specific properties.

The body of an entry is made up of a series of "tokens", which are essentially flags that can be added or removed to affect the entry's attributes. Most of these effects are hardcoded: for example, it's possible to make a creature only eat meat with the [CARNIVOUROUS] token, but it's impossible to create your own token detailing a specific diet for the creature.

Before we continue, a few key things to remember when modding the raw files:

* Personally speaking, I don't recommend modifying the existing raw files, but if you want to edit an already-exiting creature, always back up the files you plan on editing to a different location. If you want to create backup files directly within the objects folder itself, take heed: the game doesn't distinguish between file extensions. It'll read a .bak file just as well as it'll read a .txt file, and (as mentioned previously) duplicate entries are a very bad thing.
* When a new world is generated, all the raw files get copied into a \raw\ folder within the applicable save folder. If you want to change something within a game that's already running, you'll have to edit those files, not the ones in ~DF\raw\objects.
* There's nothing stopping you from just copying an existing creature/entity/whatever, changing the identifier, and modifying it. This can save you a lot of time, especially when it comes to entities... which are coincidentally what we'll be talking about next.

== Modding civilisations (entities) ==

Entities - the objects that determine how civilisations work - are stored in entity_default.txt. They follow the same format as any other raw file:

entity_default

[OBJECT:ENTITY]

[ENTITY:ENTITYNAME]
[CREATURE:CREATURETYPE]
[TRANSLATION:LANGUAGETYPE]
[BIOME_SUPPORT:BIOMETOKEN:FREQENCY]
...[OTHER TAGS]...

Most of the time, it doesn't matter which order these tokens are in or where they're placed so long as they're below the "ENTITY:" identifier, but there are some important exceptions in the case of other files, especially creatures, which can contain a lot of "nested" tokens.

"[CREATURE:]" links the civilization with a specific creature defined in a creature file. This is the creature that'll be making up the entity's population, and will therefore be the creature you'll be playing as in fortress or adventure mode if the entity is a playable one. For example, if you wanted to do something silly, you could switch the "CREATURE:DWARF" entry in entity_default.txt with "CREATURE:ELF" and you would be marching elves around in fortress mode, although they would still use dwarven technology and language and names and so forth.

Oh, and before you get any funny ideas - it ''is'' possible to define more than one creature for a civ, but that won't work in quite the way you probably expect: later on we'll be talking about creature castes, which will provide a much more viable alternative, so try to bear with me until then.

"[TRANSLATION:]" defines the language file that the entity will be using, which will determine what their untranslated words are for things. This doesn't determine which words they use for naming things, only the way those words are spelt. The default language files are HUMAN, DWARF, ELF, and GOBLIN.

"[BIOME_SUPPORT:]" defines the biomes that civs will attempt to settle in. The "FREQUENCY" value determines the likelyhood of them building there, but also raises an important point: most of the values you'll be setting for things are relative to each other. If I was to type:

[BIOME_SUPPORT:ANY_FOREST:1]
[BIOME_SUPPORT:SAVANNA:2]

This would have very much the same effect as:

[BIOME_SUPPORT:ANY_FOREST:10]
[BIOME_SUPPORT:SAVANNA:5]

This holds true for a lot of values throughout the files, excluding when it simply doesn't make sense, such as in materials.

You can find many details about the rest of the civilization tokens [[Entity token|here]]. Besides those mentioned, some fundamental ones are the CIV_CONTROLLABLE token, which lets you control the civ in fortress mode, the INDIV_CONTROLLABLE token, which allows you to play the civ in adventure mode as an outsider, and the ADVENTURE_TIER token, which allows you to play a civ native (non-outsider) in adventure mode. Other tokens that you should pay attention to are START_BIOME and the ones regarding sites, but in general, you can just run through the aformentioned list and add or remove what you want.

If you have more than one civ with the CIV_CONTROLLABLE token, all the available civs from those entities will appear in the group selection section on the embark screen. It may not be immediately obvious from which species each civ may be - while this can be determined from legends mode, the topmost species in the "neighbors" display in the embark screen is always the same as the currently selected species; if your group is dwarven, dwarves will be topmost, whilst (say) elves will be topmost if your chosen group is elven. By default, the game seems to choose a civ (and therefore a species if there is more than one) at random.

You can also attempt to discern the civ yourself by the names it uses - this is the realm of "symbols", collections of words centered around a specific concept. The civ will use the words comprising whatever symbols are applicable to it for various things. This association might be a little obfuscating at first, so I'll run through it. Let's refer to the DWARF entity:

[SELECT_SYMBOL:WAR:NAME_WAR]
[SUBSELECT_SYMBOL:WAR:VIOLENT]
[SELECT_SYMBOL:BATTLE:NAME_BATTLE]
[SUBSELECT_SYMBOL:BATTLE:VIOLENT]
[SELECT_SYMBOL:SIEGE:NAME_SIEGE]
[SUBSELECT_SYMBOL:SIEGE:VIOLENT]

Here we can see that dwarves will generally name their wars first after words in the "NAME_WAR" symbol group, and then after words in the "VIOLENT" symbol group. This might, for example, result in a war being named "The War of Carnage". The symbols used for the other types of conflict are arrayed in a similar fashion. It would be trivial to replace the instances of VIOLENT with, say, PEACE and end up with a battle called "The Clash of Calm" or something.

[SELECT_SYMBOL:ROAD:NAME_ROAD]
[SELECT_SYMBOL:TUNNEL:NAME_TUNNEL]
[SELECT_SYMBOL:BRIDGE:NAME_BRIDGE]
[SELECT_SYMBOL:WALL:NAME_WALL]

The above applies here. Dwarves are fond of naming their roads and tunnels after roads and tunnels.

[SELECT_SYMBOL:REMAINING:ARTIFICE]
[SELECT_SYMBOL:REMAINING:EARTH]
[CULL_SYMBOL:ALL:DOMESTIC]
[CULL_SYMBOL:ALL:SUBORDINATE]
[CULL_SYMBOL:ALL:EVIL]
[CULL_SYMBOL:ALL:UNTOWARD]
[CULL_SYMBOL:ALL:FLOWERY]
[CULL_SYMBOL:ALL:NEGATIVE]
[CULL_SYMBOL:ALL:UGLY]
[CULL_SYMBOL:ALL:NEGATOR]

This section deals with everything else. The sections that haven't already been dealt with (hence the "REMAINING") will have names from the ARTIFICE and EARTH symbol groups. After that the dwarf entity is told to cull all innapropriate symbols - this applies to everything (hence the "ALL") so if the game happens to choose a symbol associated with, say, EVIL for one of the battles, it'll scrap that name and try again. This sort of thing adds a lot of flavour to DF's entities and can account for a lot of a civ's percieved personality.

Another basic thing to note: any entity token that's dealing with weapons, armor, clothing, etc., will state the items that the civ can build natively, not necessarily the ones they can wear. For example, you could create a species with no clothes specified, but then rob a clothes shop in adventurer mode and wear everything you want, or give them weapons that are too large to wield and they could sell them, but not use them.

An easy method of creating a civilization is just to copy-paste a similar one to the bottom of the entity_default.txt file and edit things to your liking. Remember to always change the civ's "ENTITY:" identifier! This can be anything so long as it's not already existing.

At the end of some of the default entries you'll find a list of positions, both ones that'll directly affect you in fort mode (such as nobles) and ones that'll primarily affect worldgen and adventure mode. A list of the tokens applicable to positions can be found [[DF2010:position token|here]]; they don't require a great deal of explaination.

== Modding the creatures ==

Creature modding is great fun. You can change nearly any aspect of a creature or make your own completely from scratch.

Modding creatures is very similar to modding civs: it's just a matter of editing, adding, or removing tokens, enclosed in square brackets underneath the creature's [CREATURE:] header. The creature entries contain all of the information about each and every non-random creature in the game, from animals to dwarves to goblins to even caravan wagons. A lot of the creature tokens are fairly self-explanatory; you can find a list of such tokens [[Creature_Tokens|here]].

In the most basic sense, a creature is a series of bodyparts. These parts are defined in their own file. As a specific aspect of how creatures work which throws off a lot of prospective modders is the relationship between creatures, tissues, and materials, I'm going to show you part of the creature entry for a bronze colossus (bear with me):

...
[BODY:HUMANOID:2EYES:2EARS:NOSE:HUMANOID_JOINTS:5FINGERS:5TOES]
[NO_THOUGHT_CENTER_FOR_MOVEMENT]
[TISSUE:BRONZE]
[TISSUE_NAME:bronze:bronze]
[TISSUE_MATERIAL:INORGANIC:BRONZE]
[MUSCULAR]
[FUNCTIONAL]
[STRUCTURAL]
[RELATIVE_THICKNESS:1]
[CONNECTS]
[TISSUE_SHAPE:LAYER]
[TISSUE_LAYER:BY_CATEGORY:ALL:BRONZE]
...

At the top, we can see the "BODY:" token, followed by a list of bodyparts. As you've probably guessed, these parts make up the physical form of the colossus. But the colossus has to be made out of something - it has to have tissues. And those tissues also have to be made out of something - in this case, bronze.

Below the BODY token you'll see a TISSUE token, followed by an identifier, much like the others we've seen. The TISSUE block is determining how the tissue works, and which purposes it'll serve. As the colossus is just going to be made out of this one tissue, this tissue needs to act like bone, muscle, and everything else combined, hence the MUSCULAR, FUNCTIONAL and STRUCTURAL tokens. The tissue also references a material - INORGANIC:BRONZE - the properties of which are declared in the inorganic materials file, and the tissue is subsequently made out of this material. With me so far?

Below the tissue definition is the TISSUE_LAYER line. TISSUE_LAYER allows you to control where each tissue is applied. Its first argument if it's to search by bodypart category (BY_CATEGORY), bodypart type (BY_PART), or look for a specific part (BY_TOKEN). That's followed by the parts argument itself, which is in this case ALL (so the game's looking for parts in every category, which is to say, every bodypart). This is followed by the tissue to be applied, BRONZE. So the TISSUE_LAYER token is telling the game to select all bodyparts in every category and make them out of the tissue "BRONZE". The colossus is now made of bronze.

By now you're probably thinking "Wow, if this was for a creature made out of however many tissues, this would be amazingly longwinded". And you're right. Luckily, there are two methods by which we can speed things up a lot.

Firstly, there are material and tissue templates. Let's say you were going to make a lot of creatures out of bronze, and you didn't want to have to copy and paste the bronze tissue all over the place. Instead, you create a tissue template. This goes, as you've probably guessed, in a tissue template file.

[TISSUE_TEMPLATE:BRONZE_TEMPLATE]
[TISSUE_NAME:bronze:bronze]
[TISSUE_MATERIAL:INORGANIC:BRONZE]
[MUSCULAR]
[FUNCTIONAL]
[STRUCTURAL]
[RELATIVE_THICKNESS:1]
[CONNECTS]
[TISSUE_SHAPE:LAYER]

Now, instead of applying the tissue to each and every bronze creature you're making, you can just refer to the template:

...
[BODY:HUMANOID:2EYES:2EARS:NOSE:HUMANOID_JOINTS:5FINGERS:5TOES]
[NO_THOUGHT_CENTER_FOR_MOVEMENT]
[USE_TISSUE_TEMPLATE:BRONZE:BRONZE_TEMPLATE]
[TISSUE_LAYER:BY_CATEGORY:ALL:BRONZE]
...

Material templates work in the same way, but refer to materials instead of tissues.

However, if we're looking at something like a dwarf, even with the templates, editing can get very slow indeed:

...
[USE_MATERIAL_TEMPLATE:SKIN:SKIN_TEMPLATE]
[USE_MATERIAL_TEMPLATE:FAT:FAT_TEMPLATE]
[USE_MATERIAL_TEMPLATE:MUSCLE:MUSCLE_TEMPLATE]
[USE_MATERIAL_TEMPLATE:BONE:BONE_TEMPLATE]
[USE_MATERIAL_TEMPLATE:CARTILAGE:CARTILAGE_TEMPLATE]
[USE_MATERIAL_TEMPLATE:HAIR:HAIR_TEMPLATE]
[USE_MATERIAL_TEMPLATE:TOOTH:TOOTH_TEMPLATE]
[USE_MATERIAL_TEMPLATE:EYE:EYE_TEMPLATE]
[USE_MATERIAL_TEMPLATE:NERVE:NERVE_TEMPLATE]
[USE_MATERIAL_TEMPLATE:BRAIN:BRAIN_TEMPLATE]
[USE_MATERIAL_TEMPLATE:LUNG:LUNG_TEMPLATE]
[USE_MATERIAL_TEMPLATE:HEART:HEART_TEMPLATE]
[USE_MATERIAL_TEMPLATE:LIVER:LIVER_TEMPLATE]
[USE_MATERIAL_TEMPLATE:GUT:GUT_TEMPLATE]
[USE_MATERIAL_TEMPLATE:STOMACH:STOMACH_TEMPLATE]
[USE_MATERIAL_TEMPLATE:PANCREAS:PANCREAS_TEMPLATE]
[USE_MATERIAL_TEMPLATE:SPLEEN:SPLEEN_TEMPLATE]
[USE_MATERIAL_TEMPLATE:KIDNEY:KIDNEY_TEMPLATE]
[USE_TISSUE_TEMPLATE:SKIN:SKIN_TEMPLATE]
[USE_TISSUE_TEMPLATE:FAT:FAT_TEMPLATE]
[USE_TISSUE_TEMPLATE:MUSCLE:MUSCLE_TEMPLATE]
...

This is where body detail plans come in. Detail plans, of course, have their own file, and they are designed to help automate some of the more common processes in creature creation. The first entry in b_detail_plan_default.txt does exactly what we've been trying to do above: it takes all the common materials and shoves them into one plan, which can be referenced with a single token.

...
[BODY_DETAIL_PLAN:STANDARD_MATERIALS]
...

Much easier. But what about the TISSUE_LAYER tokens? Will we have to type out all of those manually?

Nope, detail plans have that covered as well. It's possible to place variable arguments into a detail plan. For example:

[BODY_DETAIL_PLAN:VERTEBRATE_TISSUE_LAYERS]
[BP_LAYERS:BY_CATEGORY:BODY:ARG3:50:ARG2:5:ARG1:1]
[BP_LAYERS:BY_CATEGORY:BODY_UPPER:ARG3:50:ARG2:5:ARG1:1]
[BP_LAYERS:BY_CATEGORY:BODY_LOWER:ARG3:50:ARG2:5:ARG1:1]
[BP_LAYERS:BY_CATEGORY:ARM:ARG4:25:ARG3:25:ARG2:5:ARG1:1]
[BP_LAYERS:BY_CATEGORY:ARM_UPPER:ARG4:25:ARG3:25:ARG2:5:ARG1:1]
...
[BP_LAYERS:BY_CATEGORY:NOSE:ARG5:4:ARG1:1]
...

First an argument is placed in the plan (ARG1, ARG2 etc.), followed by the thickness of the tissue that will be inserted in place of the argument. So when we refernce the VERTEBRATE_TISSUE_LAYERS plan, we'll be able to do something like this:

[BODY_DETAIL_PLAN:VERTEBRATE_TISSUE_LAYERS:SKIN:FAT:MUSCLE:BONE:CARTILAGE]

ARG1 in the detail plan is replaced by SKIN, the first tissue we entered. ARG2 is replaced by FAT, ARG3 by muscle, ARG4 by bone, and ARG5 by CARTILAGE. Hence, our creature's bodypart designated as BODY is made up of SKIN with thickness 1, FAT with thickness 5, and MUSCLE with thickness 50. Its nose is made up of SKIN (thickness 1) and CARTILAGE (thickness 4).

Things left out of the body plans aside, our dwarf's entire body, tissue and tissue layer tokens have been boiled down to this:

...
[BODY:HUMANOID:2EYES:2EARS:NOSE:2LUNGS:HEART:GUTS:ORGANS:HUMANOID_JOINTS:
THROAT:NECK:SPINE:BRAIN:SKULL:5FINGERS:5TOES:MOUTH:FACIAL_FEATURES:TEETH:RIBCAGE]
[BODY_DETAIL_PLAN:STANDARD_MATERIALS]
[BODY_DETAIL_PLAN:STANDARD_TISSUES]
[BODY_DETAIL_PLAN:VERTEBRATE_TISSUE_LAYERS:SKIN:FAT:MUSCLE:BONE:CARTILAGE]
...

This can save you a lot of time and space if you're making lots of changes common to many creatures. In general, if you're making a creature that's fleshy or chitinous, there's detail plans already included in the game to help you out. You should only have to resort to declaring tissues individually (like our bronze colossus) if you're doing something really out-of-the-ordinary.

Another great thing about templates (and so, detail plans) is that they can be modified after being declared. Let's say I wanted my dwarves to be perpetually on fire (don't ask). We declare the body stuff normally:

...
[BODY:HUMANOID:2EYES:2EARS:NOSE:2LUNGS:HEART:GUTS:ORGANS:HUMANOID_JOINTS:
THROAT:NECK:SPINE:BRAIN:SKULL:5FINGERS:5TOES:MOUTH:FACIAL_FEATURES:TEETH:RIBCAGE]
[BODY_DETAIL_PLAN:STANDARD_MATERIALS]
[BODY_DETAIL_PLAN:STANDARD_TISSUES]
[BODY_DETAIL_PLAN:VERTEBRATE_TISSUE_LAYERS:SKIN:FAT:MUSCLE:BONE:CARTILAGE]
...

We then select the appropriate material:

...
[BODY:HUMANOID:2EYES:2EARS:NOSE:2LUNGS:HEART:GUTS:ORGANS:HUMANOID_JOINTS:
THROAT:NECK:SPINE:BRAIN:SKULL:5FINGERS:5TOES:MOUTH:FACIAL_FEATURES:TEETH:RIBCAGE]
[BODY_DETAIL_PLAN:STANDARD_MATERIALS]
[BODY_DETAIL_PLAN:STANDARD_TISSUES]
[BODY_DETAIL_PLAN:VERTEBRATE_TISSUE_LAYERS:SKIN:FAT:MUSCLE:BONE:CARTILAGE]
[SELECT_MATERIAL:SKIN]
[MAT_FIXED_TEMP:10600]
...

We don't want them burning to death, so we'll need to stop that from happening:

...
[BODY:HUMANOID:2EYES:2EARS:NOSE:2LUNGS:HEART:GUTS:ORGANS:HUMANOID_JOINTS:
THROAT:NECK:SPINE:BRAIN:SKULL:5FINGERS:5TOES:MOUTH:FACIAL_FEATURES:TEETH:RIBCAGE]
[BODY_DETAIL_PLAN:STANDARD_MATERIALS]
[BODY_DETAIL_PLAN:STANDARD_TISSUES]
[BODY_DETAIL_PLAN:VERTEBRATE_TISSUE_LAYERS:SKIN:FAT:MUSCLE:BONE:CARTILAGE]
[SELECT_MATERIAL:SKIN]
[MAT_FIXED_TEMP:10600]
[SELECT_MATERIAL:ALL]
[HEATDAM_POINT:NONE]
...

Note that this makes use of DF's built-in temperature scale. You can read more about that [[Temperature scale|on this page]]. I'm also referencing material tokens, which we haven't gone over yet - I'll talk about making your own materials later.

That's the most complex component of creature creation out of the way. You should find the rest trivial by comparison.

== Modding items ==

Items are fairly simple to deal with. By default, each item type is contained in its own file; this may help make browsing for a specific item easier, but from a purely technical point of view, it's possible to throw all items into one file. Unfortunately, item tokens don't seem to be especially well-documented (at least as not as well as the other object types), but you should be able to figure out most things by way of my explainations and your assumptions.

Let's look at the entry for, of course, the thong:

[ITEM_PANTS:ITEM_PANTS_THONG]
[NAME:thong:thongs]
[LAYER:UNDER]
[COVERAGE:25]
[LAYER_SIZE:10]
[LAYER_PERMIT:30]
[MATERIAL_SIZE:1]
[SOFT]
[LEATHER]
[STRUCTURAL_ELASTICITY_WOVEN_THREAD]

Most of these are pretty obvious if one compares them to the other entries in the file. There's a layer for the item, determining where it's worn; a coverage value to determine how well it protects you from cold and other things; a size token to determine how much it counts for when it's under something else; a layer permit token to determine how much can be worn under it; and a material size token to determine how much raw material it takes to make it.

Now, if you wanted to mod these to turn them into metal thongs (ouch!), you would simply have to add [METAL] to it somewhere, and probably [HARD] instead of [SOFT]. Simple! These tokens work by tying into material properties - some materials are designated as suitable for making hard items, some for soft, etc..

Weapons involve a little more detail:

[ITEM_WEAPON:ITEM_WEAPON_SWORD_2H]
[NAME:two-handed sword:two-handed swords]
[SIZE:900]
[SKILL:SWORD]
[TWO_HANDED:67500]
[MINIMUM_SIZE:62500]
[MATERIAL_SIZE:5]
[ATTACK:EDGE:100000:8000:slash:slashes:NO_SUB:1250]
[ATTACK:EDGE:50:4000:stab:stabs:NO_SUB:1000]
[ATTACK:BLUNT:100000:8000:slap:slaps:flat:1250]
[ATTACK:BLUNT:100:1000:strike:strikes:pommel:1000]

SIZE determines how heavy the weapon is. This has a substantial effect on weapon effectiveness. SKILL determines which skill is used in using the weapon; a list of skills can be found [[DF2010:Skill token|on this page]]. MINIMUM_SIZE determines the minimum size a creature must be before the weapon can be wielded, while TWO_HANDED determines how large a creature must be in order to wield the weapon with one hand.

Attacks take a little more explaination. The first value determines the contact area of the weapon's attack; this should be high for slashing or bludgeoning weapons, and low for piercing and poking ones. The second value determines how deep the weapon penetrates - for BLUNT attacks this value is ignored as they're not supposed to penetrate anyway, but in the case of EDGE attacks it should generally be lower for slashing attacks and higher for stabbing attacks.

Following these are the adjectives used; they should be self-explanatory. Finally, we have the velocity modifier, which has a multiplying effect on the weapon's size for the purposes of determining how powerful it is in combat.

Other, more miscellaneous items are generally simple and shouldn't require any further explaination.

Once you've made an item, you just add it to the civ entry so a civilization can actually craft it, and it's done.

== Modding language files ==

Coming later

== Modding body parts ==

Imagine you have this fantastic idea for a multi-tentacled winged spider-monster. Sounds great! But in order to make this a reality you may need to create a new set of body parts for it. That's no problem! Making body parts is easy, though it may look complicated at first.

All of the default body definitions are located in body_default.txt and then linked to a creature in the creature's entry. We've talked about how bodyparts make up creatures earlier, in the creature section. You can mix and match them in the creature entry and it makes no difference, as long as they're there: each bodypart will link itself to the appropriate connection automatically when the creature is first created.

Body parts work by sections: you can add as many sections as you want to a bodypart definition, but generally you should keep it fairly low for ease of use. Each body section entry is in the very simple format:

[BODY:BODYNAME]
[BP:TOKENID:name][TOKENSGOHERE][DEFAULT_RELSIZE:][CATEGORY:WHATEVER]

The most important tokens are "CONTYPE" and "CON": CONTYPE means the bodypart in question is connected to a certain *type* of bodypart, while CON means it's connected to a *specific* one. TOKENID is yet another identifier, which should be unique, as it's referenced every time something uses CON or BY_TOKEN. DEFAULT_RELSIZE defines, of course, what the bodypart's size is in relation to the other parts. CATEGORY defines a category for the part, which can be unique or shared with other parts. This is referenced whenever BY_CATEGORY is used.

A list of bodypart tokens can be found [[DF2010:Body token|here]].

Let's take a simple example, a head:

[BODY:BASIC_HEAD]
[BP:HD:head:STP][CONTYPE:UPPERBODY][HEAD][CATEGORY:HEAD]
[DEFAULT_RELSIZE:300]

It connects directly to an upper body.

[BODY:2EYES]
[BP:REYE:right eye:STP][CONTYPE:HEAD][SIGHT][EMBEDDED][SMALL][RIGHT][CATEGORY:EYE]
[DEFAULT_RELSIZE:5]
[BP:LEYE:left eye:STP][CONTYPE:HEAD][SIGHT][EMBEDDED][SMALL][LEFT][CATEGORY:EYE]
[DEFAULT_RELSIZE:5]

These are a pair of eyes, connecting to the head.

[BODY:HUMANOID]
[BP:UB:upper body:upper bodies][UPPERBODY][CATEGORY:BODY_UPPER]
[DEFAULT_RELSIZE:1000]
[BP:LB:lower body:lower bodies][CON:UB][LOWERBODY][CATEGORY:BODY_LOWER]
[DEFAULT_RELSIZE:1000]
[BP:HD:head:STP][CON:UB][HEAD][CATEGORY:HEAD]
[DEFAULT_RELSIZE:300]
[BP:RUA:right upper arm:STP][CON:UB][LIMB][RIGHT][CATEGORY:ARM_UPPER]
[DEFAULT_RELSIZE:200]
[BP:LUA:left upper arm:STP][CON:UB][LIMB][LEFT][CATEGORY:ARM_UPPER]
[DEFAULT_RELSIZE:200]
[BP:RLA:right lower arm:STP][CON:RUA][LIMB][RIGHT][CATEGORY:ARM_LOWER]
[DEFAULT_RELSIZE:200]
[BP:LLA:left lower arm:STP][CON:LUA][LIMB][LEFT][CATEGORY:ARM_LOWER]
[DEFAULT_RELSIZE:200]
[BP:RH:right hand:STP][CON:RLA][GRASP][RIGHT][CATEGORY:HAND]
[DEFAULT_RELSIZE:80]
[BP:LH:left hand:STP][CON:LLA][GRASP][LEFT][CATEGORY:HAND]
[DEFAULT_RELSIZE:80]
[BP:RUL:right upper leg:STP][CON:LB][LIMB][RIGHT][CATEGORY:LEG_UPPER]
[DEFAULT_RELSIZE:500]
[BP:LUL:left upper leg:STP][CON:LB][LIMB][LEFT][CATEGORY:LEG_UPPER]
[DEFAULT_RELSIZE:500]
[BP:RLL:right lower leg:STP][CON:RUL][LIMB][RIGHT][CATEGORY:LEG_LOWER]
[DEFAULT_RELSIZE:400]
[BP:LLL:left lower leg:STP][CON:LUL][LIMB][LEFT][CATEGORY:LEG_LOWER]
[DEFAULT_RELSIZE:400]
[BP:RF:right foot:right feet][CON:RLL][STANCE][RIGHT][CATEGORY:FOOT]
[DEFAULT_RELSIZE:120]
[BP:LF:left foot:left feet][CON:LLL][STANCE][LEFT][CATEGORY:FOOT]
[DEFAULT_RELSIZE:120]

An entire humanoid body. The foot bone's connected to the ankle bone...

A 'BODYGLOSS', which you can sometimes find in the creature entries, are simply replacement words for certain defined words in a creature. For example, you'll find the bodygloss [BODYGLOSS:CLAW_HAND:hand:claw] in the body_default.txt, and then you can use this in a creature with '[BODYGLOSS:CLAW_HAND]' and it will replace all instances of "hand" with "claw" in that creature. For all intent and purpose the body part will still function as the proper part, though.

== Plants ==

Coming later

== Workshops ==

Coming later

== Materials ==

As we've seen when talking about creatures, materials are vital. Materials show up in two forms: material templates, which generally show up in creatures, and specific materials (designated as "inorganic", which are (by default, at least) consigned purely to metal and stone types.

Let's take a look at METAL_TEMPLATE in material_template_default.txt. It's evident that most of the basic properties of metals are already defined in the template - it goes red and melts at a high enough temperature, it's heavy, and (as noted by the very bottom token) is a metal. We already know just how useful templates can be to creatures, and the same applies to other materials.

Now let's take a look at inorganic_metal.txt. You can see that the metals here refer to the templates, and, just like we did with creatures, then modify the properties of that template and expand upon it.

Finally, let's look at inorganic_stone_mineral.txt. Here we can see that in additon to the changes made to the template, there are also ENVIONMENT tokens - these tell the game where to place these minerals during worldgen.

[[DF2010:Material_token|Here's a list of material tokens]]. It should also help you out with any modifications you want to make regarding those creature modifications we were making a while back. See, it all ties together in the end. The beauty of the current materials system is that there's actually very little difference between, say, leather and iron - they're fundamentally the same thing, just with different properties, which is how things really should be.

== Examples ==

Coming later

= Modding utilities =

Section needs updating

[[Category:DF2010:Modding]]
[[Category:DF2010:Guides]]

40d:Strange mood

2009-08-28T20:43:45Z

3: /* Demands */ - This seemingly no longer occurs

Periodically, individual dwarves are struck with an idea for a [[legendary artifact]] and enter a '''strange mood'''. Dwarves which enter a strange mood will stop whatever they are doing and pursue the construction of this artifact to the exclusion of all else. This will be based on a particular [[skill]] that creates a finished end product that can have a [[quality]], rather than intermediary material such as bars of metal or raw food. They will not stop to eat, drink, sleep, or even run away from dangerous creatures. If they do not manage to begin construction of the artifact within a handful of months, they will go [[Strange mood#Failure|insane]] and die soon afterward.

A dwarf will only be struck by a mood once in their lifetime. Upon completion of their artifact they will usually become [[legendary]] in that skill, and will then return to their normal life in the fortress with their newfound skill. A fortress will only have at most one dwarf in a strange mood at any one time.

==Overview==
The entire process can be summarized as follows:
# Strange moods can only occur when the below necessary [[#Conditions|conditions]] are met. [[Soldier]]s and [[baby|babies]] cannot enter moods, nor [[Noble#Immigrant_Nobles|immigrant nobles]], but any other dwarf can, including [[child]]ren.
# The game will pause, center on a dwarf, and announce that the dwarf has entered one of five different types of strange moods. The [[#Types|types of mood]] are listed below. While in a mood, a dwarf will display a blinking exclamation point (see [[status icons]]).
# The dwarf will claim a workshop related to the skill that the mood affects (not all skills are eligible), kick out any dwarf who was using it, and render it otherwise unusable until the mood has been resolved. If a moody dwarf does not claim a workshop, it is because the appropriate workshop does not exist. See [[#Skills and workshops|skills and workshops]] below to determine which workshop(s) might be required.
# After claiming a workshop, the dwarf will set about collecting the required materials for their artifact. If the dwarf remains idle inside the workshop, it's because they cannot find the right material. Reference the [[#Demands|demands]] section to determine what may be required.
# Once all materials have been gathered, the game will once again pause and center, and the moody dwarf will begin construction. Upon completion the dwarf will create a semi-random artifact related to the skill affected and gain [[legendary]] (or higher) status in that skill (unless the mood type is [[#Possessed|possessed]]). See the [[#Skills and workshops|skills and workshops]] for information on which skills can be gained, or the [[#Artifacts created|artifacts created]] section for more details on the artifacts themselves.

== Types of moods ==
For each of the following types of moods, the first message is how the mood is [[Announcement|announced]]; the second message appears in the dwarf's profile when he or she is viewed with the {{K|v}} key. All moody dwarves will have "Strange Mood" listed as their active task.

=== Fey ===
* ''Taken by a fey mood!''
* ''Has the aspect of one fey!''

This is the most basic strange mood. Fey dwarves will clearly state their demands when the workshop they are in is examined.

=== Secretive ===
* ''Withdraws from society...''
* ''Peculiarly secretive...''

Secretive moods are the same as fey moods, except a secretive dwarf will sketch pictures of their required materials instead of clearly stating their demands if they cannot find what they need. Descriptions of all these [[Mood#Demands|secretive requirements]] can be seen only by viewing the workshop that the moody dwarf has claimed, with {{k|q}}, and then only while the dwarf is waiting inside it. More than one "picture" is likely; these will cycle through the entire list automatically if any one is not available. (Since materials are gathered ''in order'', it's quite possible that only one of a long list is needed to allow the moody dwarf to continue on their project. If the dwarf has gathered some of the materials (seen as "tasked" when looking at the workshop with {{k|t}}), then the next in the list is what they are looking for.)

A secretive dwarf will have his happiness thought set to 'quite content' automatically.{{verify}}

=== Possessed ===
* ''Has been possessed!''
* ''Possessed by unknown forces!''

Possessed dwarves have cryptic material requests, and have the unfortunate distinction of not receiving any experience upon successful construction of an artifact. It is unknown if controllable circumstances lead to a possessed mood instead of one of the more desirable fey or secretive moods. Possessed dwarves will mutter the name of the artifact they are working on once they have all the materials they need.

A posessed dwarf will have his happiness thought set to 'quite content' automatically.

=== Fell ===
* ''Looses a roaring laughter, fell and terrible!''
* ''Has a horrible fell look!''

A dwarf that goes into a fell mood will always take over a [[butcher's shop]] or a [[tanner's shop]]. The dwarf will then ''murder'' the nearest dwarf, drag the corpse into the shop and make some sort of object out of dwarf [[leather]] or [[bone]]. Once the artifact is completed, the fell dwarf will become a legendary [[bone carver]] or [[leatherworker]]. Strangely, none of the other dwarves seem to mind the murder. Only unhappy dwarves may enter a fell mood.

Aside from the potential loss of an important dwarf in the wrong place at the wrong time, there doesn't seem to be any downside to a fell mood. The end result is always an artifact and a legendary craftsdwarf. Since the only ingredient used (a dwarf) is available in abundance, a fell mood will only fail if the fell dwarf is completely isolated from other dwarves, or if the proper workshop does not exist.

=== Macabre ===
* ''Begins to stalk and brood...''
* ''Brooding darkly...''

Macabre moods are similar to fell moods, but the dwarf will not murder a fellow dwarf. A macabre dwarf may require dwarf bones, skulls, and chunks/remains; if you do not happen to have any, you will have to "make" some, or let the moody dwarf go insane. Like fell moods, only unhappy dwarves can enter macabre moods.

{| style="margin: 0 10%; border-collapse: collapse; background: #fbfbfb; border: 1px solid #aaa; border-left: 10px solid #ff0000; width:80%; margin-bottom: 800px"
|-
| style="padding: 0.5em 0 0.5em 0.5em; text-align: center;" | [[Image:Spoiler_be3406.png]]
| style="padding: 0.25em 0.5em; width: 100%;" | This article contains '''massive spoilers'''. If you do not wish to have your game experience spoiled, press the Back button in your browser and do not scroll down!
|}<noinclude>

[[Category:Templates]][[Category:Warnings]]</noinclude>

== Demands ==
Once a workshop is claimed, the dwarf will begin collecting materials. Each artifact will require between one and ten materials to complete. If the moody dwarf remains idle, then the necessary materials are not available. [[Forbidden]] items must be reclaimed ({{K|d}} - {{K|b}} - {{K|c}}) before they may be used, but moody dwarves will ignore settings regarding [[economic stone]]. Press {{K|q}} and highlight the workshop to receive a series of clues about what the dwarf needs. Hints that stay active for longer than 2 seconds mean that multiple pieces of that material will be required; each single demand will be displayed for 2 seconds, so if it says "gems... shining" for 6 seconds, 3 gems are demanded. Materials will always be fetched ''in order'', so if at least one item has already been retrieved (the items will show up with "TSK" ("task") next to them when the workshop is viewed with the {{K|t}} context menu), it will usually be possible to tell what item is required next.

You can use this to your advantage to get your dwarf to pick specific types of items, even if the moody dwarf has already started storing materials in their workshop: if a fey weaponsmith starts piling up copper bars, forbid those bars and he'll go pick another bar instead. If you forbid all metals except say steel (the stocks screen makes this fairly convenient), then he'll skip all those other metals and make his artifact weapon out of strong, valuable steel instead of whatever random inferior metal he might have picked otherwise.

Once you have struck [[Adamantine]], all moods which use cloth or metal as a primary component will insist on using Adamantine cloth or wafers over all other materials; moody dwarves which happen to want metal for decorations will still choose bars based on distance or preference. Moods involving stone crafting or masonry will not prefer [[raw Adamantine]] over other stones.

The various demands are translated here:

:{| class="wikitable" style="text-align:left;width:90%;"
|-
! Material
! Fey
! Secretive
! Possessed
|-
|
| <dwarf> screams "I must have <demand>!"
| <dwarf> sketches pictures of <demand>.
| <dwarf> mutters "<artifact> needs <demand>..."
|-
| [[Stone]]
| rock
| a quarry
| stone... rock
|-
| Stone [[block]]
| rock blocks
| square blocks
| blocks... bricks
|-
| [[Wood]]
| wood logs
| a forest
| tree... life
|-
| Metal [[bar]]
| metal bars
| shining bars of metal
| bars... metal
|-
| [[Gem]]s (cut)
| cut gems
| cut gems
| gems... shining
|-
| [[Gem]]s (raw)
| rough gems
| rough gems
| rough... color
|-
| [[Glass]] (green)
| raw green glass
| glass
| raw... green
|-
| [[Glass]] (clear)
| clear glass{{verify}}
| glass and burning wood
| raw... clear
|-
| [[Glass]] (crystal)
| crystal glass{{verify}}
| rough gems and glass
| raw... crystal
|-
| [[Bone]]
| bones
| skeletons
| bones... yes
|-
| [[Shell]]
| shells
| a shell
| a shell...
|-
| [[Leather]]
| tanned hides
| stacked leather
| leather... skin
|-
| [[Cloth]] (plant)
| plant fiber cloth
| stacked cloth
| cloth... thread
|-
| [[Cloth]] (silk)
| silk cloth
| stacked cloth
| cloth... thread
|}

== The mechanics of moods ==

=== Frequency===
When a fortress is started, an internal counter is set to 1000. Around 11 or 12 times per day, this counter is decremented by 1. When the counter would ordinarily be decremented when it has already reached zero, there is a 1 in 500 chance that a strange mood will strike. This means there is approximately a 2.7% chance of a strange mood per day, and a 48.97% chance of a strange mood per month, when all conditions are met.

=== Conditions ===
In order for a dwarf to be struck with a strange mood, three conditions must be met:
:* There is no currently active strange mood,
:* The maximum number of artifacts is not met,
:* There are at least 20 eligible dwarves ''(see below)''.

If all three of these conditions are true, the game may trigger a strange mood according to the frequency.

==== Maximum number of artifacts ====
The maximum number of artifacts in any one fortress is limited by the lower of:
* The number of items created divided by 200. It is unknown whether mined-out rock counts as an "item created", or whether bolts and units of drink are counted individually.
* The number of revealed [[subterranean]] tiles divided by 2308 (this is an area equivalent to a 48x48 square). Using [[Exploratory mining|exploratory methods]] is a great way to increase your artifact limit.

==== Eligibility ====
The deciding factor for eligibility is a dwarf's actual [[profession]]. ''(Note that "[[Skill#Custom profession labels|custom professions]]" have no effect on this!)'' Thus, dwarves may enter strange moods regardless of what skills they have or don't have, so long as they are of an acceptable profession. Dwarves who have already created an artifact are not eligible to create another, and since every mood ends in either an artifact or death, every dwarf may enter at most one mood. Dwarves who have obtained one or more legendary skills without creating artifacts may enter strange moods.

Appointed [[nobles]] may enter moods as per their default profession, but [[Noble#Immigrant Nobles|immigrant nobles]] are '''not''' eligible for moods. That includes:
:Advisor, Baron/ess, Baron/ess Consort, Count/ess, Countess Consort, Duke/Duchess, Duke/Duchess Consort, Dungeon Master, Hammerer, King/Queen, King/Queen Consort, Philosopher, and Tax Collector.

Further, dwarfs with a [[Soldier#Soldier professions|military profession]] other than "Recruit" can '''not''' enter moods. Incidental military skills make no difference - eligibility (and weighting) depends purely on the actual ''[[profession]]'', as listed at the time. Military professions include:
:Axedwarf, Axe Lord, Champion, Crossbowdarf, Elite Crossbowdwarf, Hammerdwarf, Hammer Lord, Macedwarf, Mace Lord, Marksdwarf, Elite Marksdwarf, Speardwarf, Spearmaster, Swordsdwarf, Swordmaster, Wrestler, and Elite Wrestler.

Babies may '''not''' enter moods.

Any other profession is eligible to enter a mood, but not all have the same ''chance'' to enter a mood...

:''('''Note''' - Specifically, and to avoid previous misunderstandings, [[Strand extractor]], [[Clerk]], [[Administrator]], [[Trader]], [[Architect]], [[Alchemist]], [[Soldier#Recruits|Recruit]] and [[Child]] '''are''' moodable professions.)''

=== Chance ===
When determining who will have a strange mood, each eligible dwarf is put into a weighted lottery. The odds are assigned a higher or lower weight based on the dwarf's [[profession]]. The default weight is 6, but some professions are more likely to enter a strange mood than others. (This is like most dwarfs getting 6 tickets to the lottery, and others getting more.)

{| class="wikitable" cellspacing="0" border="2" cellpadding="5"
|-
! Weighting
! Professions

|-
| 21 ||Armorer, Blacksmith, Bone Carver, Clothier, Craftsdwarf, Jeweler, Gem Cutter, Gem Setter, Glassmaker, Leatherworker, Metalcrafter, Metalsmith, Stonecrafter, Weaponsmith, Weaver, Woodcrafter
|-
| 11 ||Bowyer, Carpenter, Stoneworker, Mason, Woodworker
|-
| 6 ||All other eligible professions

|}

:'''''Example:''' What this means is: if you had 21 dwarves, made up of 20 eligible farmers, furnace operators, woodcutters & etc (with 6 chances each), plus one Armorer (with 21 chances), that one Armorer would have a 21 in 141 chance <small>(20 dwarves x 6 chances each = 120, + 21 chances more = 141 total)</small> of the mood striking them. That's about 1 in 7, while the other 20 have a 6 in 141 chance each, or about 1 in 24. The odds are still against the armorer, but much better than for any other single dwarf.''

Note that not every profession is from a moodable skill. An Alchemist, Architect, Furnace Operator or Strand Extractor can be taken by a mood, but that will not make those skills legendary, nor will they create an artifact bar of soap, building, bar of metal or wafer of adamantine.

:NOTE: ''If your game was saved shortly before one of you dwarves acquired a mood, reloading that game will most likely cause the chances to be completely re-figured, resulting in a different mood at a different time for a different dwarf with different materials. This is true for most all random events and results in Dwarf Fortress.''

=== Skills and workshops ===

{| class="wikitable" cellpadding="4" style="border:1px solid black;border-collapse:collapse;text-align:left;float:right;margin:0 0 20px 30px;"
|-
! colspan="2" style="background-color:#eee;border-bottom:1px solid black;text-align:center;" | Artifact Skill Rewards
|-
! Highest skill
! Workshop used
|- style="border-top:1px solid #aaa;vertical-align:top;"
| [[Armorsmith]]
| [[Magma forge]] or [[Metalsmith's forge]]
|- style="border-top:1px solid #aaa;vertical-align:top;"
| [[Bonecarver]]
| [[Craftsdwarf's workshop]]
|- style="border-top:1px solid #aaa;vertical-align:top;"
| [[Bowyer]]
| [[Bowyer's workshop]]
|- style="border-top:1px solid #aaa;vertical-align:top;"
| [[Carpenter]]
| [[Carpenter's workshop]]
|- style="border-top:1px solid #aaa;vertical-align:top;"
| [[Clothier]]
| [[Clothier's shop]]
|- style="border-top:1px solid #aaa;vertical-align:top;"
| [[Engraver]]
| [[Craftsdwarf's workshop]] or [[Mason's workshop]]
|- style="border-top:1px solid #aaa;vertical-align:top;"
| [[Gem cutter]]
| [[Jeweler's workshop]]
|- style="border-top:1px solid #aaa;vertical-align:top;"
| [[Gem setter]]
| [[Jeweler's workshop]]
|- style="border-top:1px solid #aaa;vertical-align:top;"
| [[Glassmaker]]
| [[Glass furnace]] or [[Magma glass furnace]]
|- style="border-top:1px solid #aaa;vertical-align:top;"
| [[Leatherworker]]
| [[Leatherworks]]
|- style="border-top:1px solid #aaa;vertical-align:top;"
| [[Mason]]
| [[Mason's workshop]]
|- style="border-top:1px solid #aaa;vertical-align:top;"
| [[Mechanic]]
| [[Mechanic's workshop]]
|- style="border-top:1px solid #aaa;vertical-align:top;"
| [[Metal crafter]]
| [[Magma forge]] or [[Metalsmith's forge]]
|- style="border-top:1px solid #aaa;vertical-align:top;"
| [[Metalsmith]]
| [[Magma forge]] or [[Metalsmith's forge]]
|- style="border-top:1px solid #aaa;vertical-align:top;"
| [[Miner]]
| [[Craftsdwarf's workshop]] or [[Mason's workshop]]
|- style="border-top:1px solid #aaa;vertical-align:top;"
| [[Stone crafter]]
| [[Craftsdwarf's workshop]]
|- style="border-top:1px solid #aaa;vertical-align:top;"
| [[Tanner]]
| [[Tanner's shop]] or [[Leather works]]
|- style="border-top:1px solid #aaa;vertical-align:top;"
| [[Weaponsmith]]
| [[Magma forge]] or [[Metalsmith's forge]]
|- style="border-top:1px solid #aaa;vertical-align:top;"
| [[Weaver]]
| [[Clothier's shop]]
|- style="border-top:1px solid #aaa;vertical-align:top;"
| [[Wood crafter]]
| [[Craftsdwarf's workshop]]
|}

A dwarf will claim a workshop according to their highest applicable skill, and upon completion of the artifact, gain 20,000 [[experience]] in that skill (excepting possessed dwarves). This will give the dwarf a legendary-level [[skill]] (specifically, "legendary+1" or higher, depending on the dwarf's initial skill level) and a number of [[attribute]] gains. The table to the right describes all applicable skills and their potential workshop requirements - there are only 20 skills that determine the workshop and that can be affected by a mood (sometimes referred to as '''moodable''' skills.) If a dwarf does not possess at least one of the mooodable skills listed to the right, they will take over a [[craftsdwarf's workshop]] and gain one of [[bonecarver]], [[stone crafter]], or [[wood crafter]] skills, producing an artifact [[craft]].

If a dwarf has the same experience points in two skills (as opposed to same experience title), the first listed for that dwarf will be the one affected by the mood (the exact experience can only be made visible with 3rd party [[utilities]]).

When multiple workshops are listed, the dwarf may require one or the other, so ensure that ''both'' are available, if possible. If you have one, and the dwarf is not interested, then build the other, right away. (i.e. If you have only [[magma forge]]s, you may have to build a standard [[forge]] for the moody dwarf).

Below is a list of all ''non''-moodable skills; if all of a dwarfs skills are found on this list and none from the table to the right, then they have no moodable skills and will construct their artifact at a [[Craftsdwarf's workshop]], producing an appropriate craft as described above:

{|
|- style="vertical-align:top;"
| style="padding-right:30px;" |
* [[Ambusher]]
* [[Animal caretaker]]
* [[Animal dissector]]
* [[Animal trainer]]
* [[Appraiser]]
* [[Building designer|Architect]]
* [[Brewer]]
* [[Butcher]]
* [[Cheese maker]]
* [[Cook]]
* [[Dyer]]
* [[Fish cleaner]]
* [[Fish dissector]]
* [[Fisherdwarf]]
* [[Furnace operator]]
* [[Grower]]
* [[Herbalist]]
|
* [[Lye maker]]
* [[Milker]]
* [[Miller]]
* [[Potash maker]]
* [[Pump operator]]
* [[Record keeper]]
* [[Siege engineer]]
* [[Siege operator]]
* [[Soaper]]
* [[Strand extractor]]
* [[Thresher]]
* [[Trapper]]
* [[Wood cutter]]
* [[Wood burner]]
* All [[military]] skills
* All [[social skill]]s
|}

This fact can be utilized to maximize the possibility of getting a dwarf with the specific legendary skill you want: since ''non''-moodable skills are ignored, when ever possible make sure that each dwarf's highest ''moodable'' skill is one of those you want*. Have all your peasants, [[farmer]]s, non-professional military and other dwarves without any moodable skills do a tiny bit of work in the skill(s) you most want; if a "[[dabbling]]" skill is the highest moodable skill they have, that is the skill that will be used.

:''(* [[Armorsmith]], [[Weaponsmith]], [[Metal crafter|Metal Crafter]] and [[Metalsmith]] are possibly the most-desired legendary skills, but much depends on your fortress, your current mix of skills, and your play style.)''

:''(Note that [[Tanner]] is a moodable skill, the only [[Farmer]] category skill that is moodable.)''

== Artifacts created ==
The type of artifact created will depend on the dwarf's highest skill. Masons will always create some kind of stone object, usually furniture; bone Carvers, a bone or shell object; carpenters, a wood object, etc. Miners and engravers will usually turn out a stone craft or piece of furniture; metalworkers, metal crafts, weapons, or armor (depending on the type of metalworker); weavers, an article of clothing; tanners, a leather armor or object. If a dwarf has no moodable skills, they will take over a [[craftdwarf's workshop]] and create a bone, stone or wood craft of some type. The precise type of craft created is usually somewhat random but if a dwarf has a personality preference for a particular thing, such as gauntlets or floodgates or crowns, and that thing is an available choice given the dwarf's profession, he will generally create an object of that type.

The first object grabbed by the dwarf will be the "primary" substance; all other materials will be used to decorate the artifact. If a dwarf grabs onyx and makes a bed, for instance, it will be an "onyx bed", but an artifact can potentially be composed of bone, cloth, gems, leather, metal, shell, stone, and wood all at once. In some cases, glass makers will actually grab the nearest rough gem instead of a piece of raw glass, leading to such odd constructions as an [[obsidian]] [[bed]] or a [[ruby]] [[floodgate]].

Once created, most [[artifact]]s will be available for use just like a normal item of its type. Artifact furniture is useful for high value [[noble]] rooms. [[Weapon]]s and [[armor]] will only be used by heroes and champions. Artifact weapons in [[Trap#Weapon Trap|weapon traps]] can also boost a room's value considerably, as in the case of trap components weapons.

== Failure ==
If you can't provide the desired workshop and all the required component materials within a couple of months, the dwarf will go [[insane]], which cancels the mood and the artifact. As if that's not bad enough, any dwarf who goes insane will soon die, one way or another.

A dwarf who is [[melancholy]] or [[stark raving mad]] is harmless to others (until they die and start a [[tantrum]] spiral), but a [[berserk]] dwarf will attack other dwarfs and possibly pull levers at random. You may want to station a squad nearby or assign a few war dogs to the dwarf on the chance that they will lash out. If you build your workshops inside enclosed rooms with doors you can also lock the moody dwarf in the room until he or she starves. In extreme cases, building a wall around an open workshop is the best precaution.

Anything that would cause the dwarf to cancel the strange mood job (like being attacked or having the workshop destroyed, or unpowered after claiming) will cause insanity. Note that the insanity can happen even when the dwarf is not deadlocked on an item; there have been observed instances where a dwarf goes insane while in the process of carrying a required item back to the commandeered workshop. Notably, giving birth while in a strange mood does not interrupt the dwarf; the new mother will ignore the baby until her mood is resolved and it will happily wander off in the meantime.

----

'''See also'''
:*[[Insanity]]
:*[[Legendary artifact|Artifact]]
:*[[Profession]]
:*[[Legendary|Legendary Skill]]

40d Talk:Room

2009-08-14T21:43:38Z

3: /* Selecting the quality of furniture */

==Smoothing walls==
"Walls with ore or gems cannot be smoothed, much less detailed." Is this still true? I'd heard that smoothing/engraving of ore veins is now possible. And yet again, I can't test because I'm reading the wiki at work while waiting for a database query to finish... >_> --[[User:Alfador|Alfador]] 17:28, 31 October 2007 (EDT)

:I deleted the comment about not being able to smooth ore or gems, because you CAN in this version (they all count as different types of rocks). Boo whoever copy pasted the article without looking at it.

::what was the point in aechiving old wiki if people are going to copy and paste, please people if you are going to copy paste thourghly read the article to ensure all info is correct, i didnt read past this so there may be more but rooms are no longer diamonds, this is somehing really obvious and should have been picked up on by whoever copy pasted it otherwise we may as well stick with edditing old wiki. [[User:Thatguyyaknow|Thatguyyaknow]] 20:08, 31 October 2007 (EDT)

==room value==
Is there a way to check what price a room currently has without counting it yourself? Just wanted to know if I counted right. --[[User:Mizipzor|Mizipzor]] 15:33, 4 November 2007 (EST)

::if the economy has started you might be able to, past that though probably not :( --[[User:Frostedfire|Frostedfire]] 18:17, 8 November 2007 (EST)

My dwarves' thoughts have lately included reference to dining in a "legendary" dining room, but the best one I currently have is listed as "Fine" when I assign it to someone. Does this correspond directly to the value of the room (I intend to bring it up to Royal to find out) or is there something else at work there? [[User:Dolohov|Dolohov]] 10:55, 15 November 2007 (EST)

I have a proper closed bedroom in silty clay loam. There is a masterpiece bed in that room. The price of the bed is 120. The rental cost of the room is 99. Most (all?) other bedrooms also have their rental cost less then the sum of the furniture values. There could be 2 explanations:
1) rental cost is not exactly equal to the room value in this version.
2) the way room value is calculated is substantially different from the previous version.
--[[User:Another|Another]] 11:56, 1 December 2007 (EST)

Does anybody know of a more recent study than the Draxxalon one? It's really, really old, and even my limited testing has shown that it is very, very wrong. I'm hoping that there's something more recent that we can use to fix it before resorting to the gutting that it most likely would otherwise require --[[User:LegacyCWAL|LegacyCWAL]] 11:16, 20 February 2009 (EST)

: I just started looking at this in earnest yesterday. I built a dorm complex of several nearly-identical rooms and wanted to verify that there was at least some stratification so poorer dorfs could find a place to sleep. The algebra isn't hard to do, so I'm going to see if I can dig out some bedroom test chambers and get verification. My driving goal is to quantify the value of wall tiles, floor tiles, smoothing, and engraving; initial poking around seemed to imply that all furniture except for the bed contributes its sticker price to the room. --[[User:Jurph|Jurph]] 19:50, 13 April 2009 (UTC)

:: I'm also looking at this. Though, mostly in respect to royal quality rooms. I've built a room above-ground entirely out of obsidian blocks and masterful clear glass windows... assuming every obsidian tile is therefore worth 15 (164 ground tiles, 42 wall), and every window is worth 1500 (there are 16 of these), the room should be worth 27090, with no other objects. Added two giant spider silk bags to get the value to 30150, and it is still grand. I'll play around with this some more, as I'm baffled as to how this isn't yet royal quality. -[[User:Belathus|Belathus]] 17:26, 1 May 2009 (UTC)

=== Influences on room quality ===

:''As a bonus, a single chest, cabinet, armor stand, and weapon rack will count as three of each, for every noble in the room. (This works because most nobles have three rooms; if they see a chest in their bedroom, study, and dining room, they ''obviously'' have three chests, right? Nobody accused the nobles of being particularly bright.)

:<span style="color:#009900;">000173 ▪ (0.22.120.23a) [dwarf mode][nobles] if you have a noble claim the same item with three of their rooms, it'll count three times in their holdings number</span>

Am I reading the changelog right? It looks like this bug was fixed in 23a. --[[User:Jackard|Jackard]] 02:31, 26 November 2007 (EST)

In that same section, it states that the value of a shared room is quartered. I've seen several times on the forum that the value of a shared room is only halved. This should be checked as well. --[[User:Skanky|Skanky]] 03:14, 28 January 2008 (EST)

:I've only seen it as half, but I typically assign the two rooms to the same noble. It could be that it's quatered if you assign the two rooms to two different nobles (and same for more rooms to one noble vs more than one).--[[User:Draco18s|Draco18s]] 17:42, 3 March 2008 (EST)

Question regarding rent: does anybody know the time period that a bedroom's listed rent refers to? For instance, if a room's rent says 44☼, is that per month, or per season, or what? --[[User:LegacyCWAL|LegacyCWAL]] 13:45, 30 January 2009 (EST)
:Aaaaaand just saw another discussion that said that no, nobody knows. So nevermind then --[[User:LegacyCWAL|LegacyCWAL]] 11:16, 20 February 2009 (EST)

== Names ==

MANY of the names in the thing are wrong. My epic dining room is described as "Legendary" and the beds that share the room get "Like a personal palace"--[[User:Shadow archmagi|Shadow archmagi]] 17:48, 28 February 2008 (EST)
:Are you going by the {{key|r}}oom list or by dwarf thoughts? The article refers to the actual room grade rather than how impressed dwarves are by the room. [[User:VengefulDonut|VengefulDonut]] 19:42, 28 February 2008 (EST)
:: Oh dear. My mistake. Letsee... you're right. Bedrooms are Grand and the dining room is Royal. My mistake. --[[User:Shadow archmagi|Shadow archmagi]] 20:03, 28 February 2008 (EST)

== doors ==
It seems doors don't count anymore in 38c? Every room i checked where the door should move it to the next quality level, it doesn't. This also is true for my artifact door which before turned a room into royal; it's gone now. --[[User:Koltom|Koltom]] 08:10, 17 March 2008 (EDT)
: What if the door is set as internal? -- [[User:Zardus|Zardus]] 20:14, 18 April 2008 (EDT)
:: Then it is counted, but such can make room overlapping difficult. Does anyone know why it was removed? I am saddened by my Artifact door not working right. --[[User:Stalinbulldog|Stalinbulldog]] 21:57, 11 June 2008 (EDT)
: Doors seem to add to the room's value if the room (as in the blinking teal X's when you q-select the room's defining furniture) extends over the door. However, by default, a room will stop at an external door without actually including that tile. So this means that the easiest way to include a door in a room's value is to set it to internal. However, if you define a room in such a way as to include the door's tile (such as defining the room before you order the door built), you can then set up the door and it will still count towards the room's value. Note that the room's value won't necessarily change by the exact value of the door, due to the newly-added tile affecting the value as well. [[User:LegacyCWAL|LegacyCWAL]] 13:55, 13 October 2008 (EDT)

== engravings ==
How do you tell which side of the wall engravings are on? Do they still have a direction? [[User:QMarx|QMarx]] 01:36, 30 April 2008 (EDT)

:I think they're on both sides of the wall. At least, if i have two 5x3 rooms that share a wall, and I engrave all the walls for the two rooms, both rooms are of the same quality. I'd have to do some specific testing to see if one is worth more but not enough for a difference in quality level... --[[User:Squirrelloid|Squirrelloid]] 01:43, 30 April 2008 (EDT)

== Coffin, Red highlight and (S) ==

When viewing rooms using "r", what does a red highlight and (S) mean? Also, there isn't anything wrong with sticking their own coffin in their room right?--[[User:Seaneat|Seaneat]] 16:19, 4 July 2008 (EDT)

: I believe that red room names in the rooms panel mean that the room overlaps with another room and thus the value of both rooms is diminished. --[[User:Toloran|Toloran]] 20:52, 25 July 2008 (EDT)

== finding a dwarfes room(s) ==

Am i right that the {{k|r}}ooms screen is meant to let you jump straight to a specific dwarfs room when it is fully implemented?

In the meantime, other than by looking at every table/chair/bed/cage/coffin/statue, how do I find all the (X)rooms allocated to Domas Othsinlolar (or any of his fellows)?[[User:GarrieIrons|GarrieIrons]] 06:52, 8 July 2008 (EDT)
:press t after highlighting the room to view the item that makes it so.--[[User:Seaneat|Seaneat]] 13:40, 8 July 2008 (EDT)
::What I was getting at:
:::When my [[rock hauler]] gets elected [[Mayor]], how do I find his bedroom to free it, so I can allocate him a new one? Do I have to look at every bedroom using either {{k|q}} or {{k|t}}, or is there another way where I can "look up the dwarf" then see all the rooms allocated to him. I hope that is clearer.[[User:GarrieIrons|GarrieIrons]] 07:41, 1 August 2008 (EDT)
::::Workaround: you can allocate a new bedroom to your new mayor without bothering with his former bedroom, which will automatically be allocated to nobody. Your only problem now is that you have a crappy hauler bedroom somewhere, which is free. At some point that evasive free bedroom might be claimed by a homeless dwarf.--[[User:Aykavil|Aykavil]] 07:59, 1 August 2008 (EDT)
:::::This does not work. I just tried moving all my Metalsmiths to a new set of quarters, and they all ended up wit two bedrooms (vr 28_181_40d). Instead, I had to open the {{k|r}}room window, and locate the dwarf on the list, and use {{k|t}} to zoom to the listed entry in the main menu.
::::::I know it's a bit late for this, but: to be honest, I wouldn't bother. Your Mayor will probably get booted out of office sooner or later, at which point he'll need his hauler bedroom back, and for the effort of finding, deassigning, and reassigning that room you might as well just dig out one more than you need and have done with it. The redundancy doesn't really cost you anything. [[User:Aosher|Aosher]] 19:35, 14 April 2009 (UTC)

== Idea ==

Here's a hint.. In my current game I was having trouble getting my Count's rooms up to an acceptable level. I had a lever in his bedroom with artifact mechanisms that raised the bedroom to royal, but unfortunately I have no very good metalcrafters or masons to make good enough furniture for the other rooms. I did have a legendary weaponsmith though, so I made him construct some steel serrated discs and spiked balls. When masterful, these are worth 3600 each. Then I just constructed a weapon trap in the throne room and it became opulent right away. Too bad there's no way to place armor in a room in a similar way, a steel plate mail that requires the same amount of material is worth 15k even when just exceptional. -- [[User:D64|D64]] 07:58, 28 July 2008 (EDT)
:masons can now make native gold statues if you enable native gold for general use,--[[User:Eerr|Eerr]] 17:32, 13 August 2008 (EDT)

== Z levels? ==

I've got a question pertaining to Z levels. Can rooms span multiple Z levels? Does it require a floor hatch? This question is prompted by a floor hatch having the internal/external option. If they can, then I'm in luck, since my communal bedroom (entirely smoothed and engraved) is over a massive smoothed and engraved stockpile.

[[User:Erathoniel|Erathoniel]] 18:30, 12 October 2008 (EDT)

: Nope, same Z-level only. [[User:LegacyCWAL|LegacyCWAL]] 13:57, 13 October 2008 (EDT)

I've added a note about this in the main article and taken away the old-version warning. But it's sparked an interesting question. If you have an area which spans several z-levels, and you define the lowest level as a room, will the dwarves 'look up' and admire any engravings or such one z-level above their room? --[[User:Khimaera UK|JK]] 21:54, 12 January 2009 (EST)

== Metal Floor over Engraving? ==

I built metal floors over engraved stone in my King's old quarters to increase the room value. I don't know if it worked or not, but later, when I moved him to larger quarters and pried up the floor, the rock underneath had turned into cavern floor. I re-smoothed and re-engraved it. [[User:Lloyd C Griscom|Lloyd C Griscom]] 18:44, 13 April 2009 (UTC)

== Room Quality and Nobles ==

It should be noted that assigning a normal (legendary) dwarf to a high quality room can make nobles '''very''' unhappy that somebody else got a room as good as (or better than) they did. For example, when I temporarily assigned a Royal bedroom (containing several dozen bags) to one of my siege operators, my King and Queen were "utterly traumatized by a lesser's pretentious sleeping arrangements lately" and my Duchess was "enraged". --[[User:Quietust|Quietust]] 03:24, 10 August 2009 (UTC)

== Selecting the quality of furniture ==

Is it possible to select the exact quality of furniture that i place in a room? I want to place a certain bed (+larch bed+ or somthing), but whenever i say "place a bed" here, they always put a crappy bed there. Help ''please''. --[[User:Frandude|Frandude]] 20:42, 14 August 2009 (UTC)
:Any and all methods of doing such a thing require forbidding all the other beds of the given material (excluding the one you want to place, of course). You can detail the beds via encrusting them, and if you take note of the quality of the details on the bed you want to place, you should be able to pick it out from the others (objects of the same type but with different quality details show up as seperate on lists) - but to do that, you'll probably have to forbid all the other beds anyway. COnsidering that as long as you don't have a furniture stockpile the beds are only going to be stacked in one or two places anyway, forbidding them shouldn't be too hard (especially if you use hotkeys). If you don't know how to forbid items inside a building, use "t" to access them. --[[User:3|3]] 21:43, 14 August 2009 (UTC)

Current Events

2009-08-02T16:14:21Z

3: blah

#REDIRECT [[Dwarf Fortress Wiki:Current events]]

40d Talk:Waterfall

2009-08-01T19:45:03Z

3: /* quality */

"You can engineer an indoor waterfall to take advantage of the happiness it causes. You need three z-levels to do this. On the bottom is the reservoir of water. The middle layer is the screw pump and the meeting hall where your dwarves will gather to enjoy the mist. On top is a narrow corridor that connects the pump chamber to the hole though the ceiling of the meeting hall. Under this hole is a grate that connects to the reservoir."<br>
Wouldn't you need two [[screw pump]]s? --[[User:Gairabad|Gairabad]] 19:54, 28 November 2008 (EST)

:You do. Since there are a whole lot more ways to engineer an indoor waterfall, and since this wiki generally tries to avoid telling players what exactly to build, I'll rewrite that. --[[User:Savok|Savok]] 20:39, 28 November 2008 (EST)

Put the guide to making waterfalls back in, many people including myself are absolutely clueless and need something to work with.

==Engineering Methods==

I think this article is doing a disservice. The wiki certainly does mention engineering methods and tips in many places (such as the excellent screwpump article.) It might be warranted noting things like what causes the happiness, for example - do you need to engineer it so that they merely see it, or must they walk through the mist? If the latter, is there a risk of flooding your fortress by building rooms exposed to the interior of an outdoor waterfall, and so on. The article as written is a bit barren. [[User:Lastofthelight|Lastofthelight]] 04:12, 11 January 2009 (EST)
:I wondered the same thing, so I set one up. Dwarfs seeing a waterfall has no effect. They have to go through a tile with mist on it.--[[User:Kwieland|Kwieland]] 17:01, 16 February 2009 (EST)

==water splashing/spreading==

I just opened a floodgate to a river that drops the water through the ceiling of my dining hall and into a 1 z-level deep channel in the middle of the room, which then goes into a tunnel then a channel outside. the channel was 1x3 with ramps around it, but the water still appeared to splash out...I have 1/7 water over half the dining hall. Is the assertion about water falling straight down correct in the article? the channel is not full--I'm pretty sure it didn't hit 7/7 at all. The water is flowing very fast, so is it possible the water plummeting through my dining hall is spreading out because it is briefly 3/7 or something in mid air? --[[User:Freshyq314|Freshyq314]] 23:29, 4 February 2009 (EST)

Also, my "divert an infinite water source through my dining hall" really sounds like [[fun]]... I still don't know a good way for my channel to get the water off the map. I'd like to not flood the entire lowlands, where all my trees are. Right now my channel goes to within a square of the map edge, but can't dig out that last bit, and I can't put constructions nearer than ~10 squares to the edge, so no pumping it out. Any thoughts? --[[User:Freshyq314|Freshyq314]] 23:29, 4 February 2009 (EST)

:Tunnel out to the last tile, then smooth and carve fortifications in the last, I think. [[User:Decius|Decius]] 15:14, 7 July 2009 (UTC)

:I have observed the same as of 40d. Water falling 3 z levels can "land" over a 9x9 square. Nice to know after the fact when you've started flooding your fortress, eh!

::lead the water to the river tiles on the map's edge where its water disappears - these are magic tiles that let water disappear - if you dont feed in too much water it will work --[[User:Birthright|Birthright]] 23:08, 11 July 2009 (UTC)

==quality==
Do waterfalls have quality levels like wells? --[[User:Höhlenschreck|Höhlenschreck]] 18:46, 19 June 2009 (UTC)
:A waterfall is sort of a meta-construction. It isn't a single constructed object like a well. The individual parts of the waterfall can have quality levels (like the floor grates the water falls through.) I do not imagine that those quality levels impact the happiness imparted by the mist, but dwarves could certainly admire the nice grates as they walk by. --[[User:Masennus|Masennus]] 23:12, 6 July 2009 (UTC)
::I was thinking of smth like the height water drops before it causes mist improves quality, like supposedly applies to well shafts.. --[[User:Höhlenschreck|Höhlenschreck]] 19:33, 1 August 2009 (UTC)
:::I'm pretty sure there's just a single generic happy thought for being under a waterfall; ergo, no quality (see [[Thought]]). --[[User:3|3]] 19:45, 1 August 2009 (UTC)

==Waterfalls cannot Desalt saltwater==
Perhaps I'm just doing it wrong, but it seems that it is not possible to draw saltwater from an artificial waterfall and use that water to create purified water. See my map [http://mkv25.net/dfma/map-6541 Here] to see what I mean.

==.40D waterfalls==
Note: This example might not work any more due to water spilling being different in the
newest version.{{version|0.28.181.40d}}

the example image DOES work still in 40d. I have the video to prove it [http://mkv25.net/dfma/movie-1566-howtomakewaterfalls @DFMA][[User:Kenji 03|Kenji 03]] 11:03, 31 July 2009 (UTC)

:But that is exactly the point - you get a mess, well more to the point, '''flooding''' - a huge problem inside, where most waterfalls will be built, and it does not work without a constant water supply which is just the thing this example did not use to need. --[[User:Koltom|Koltom]] 21:00, 31 July 2009 (UTC)

40d Talk:Grudge

2009-08-01T19:13:00Z

I went ahead and added what I knew to this page.--[[User:CrazyMcfobo|CrazyMcfobo]] 01:25, 19 July 2009 (UTC)
:I'm pretty sure I know how grudges are formed now, if a dwarf is part of an organization and dislikes a different organization, and comes into contact with said Org. then they form a grudge.--[[User:CrazyMcfobo|CrazyMcfobo]] 19:40, 26 July 2009 (UTC)
::So what organizations would that be for example? --[[User:Koltom|Koltom]] 14:07, 27 July 2009 (UTC)
:::Alright, let me write down an example.

"Urist McArmokWorshipper belongs to the society of the plump helmets. He disliskes those in the sweetpod society. He comes across a dwarf in that society in the meeting area and begins to chat. They are now enemies. Now, whenever they chat, both of them get bad thoughts."

Sorry for my spelling errors, I just woke up.--[[User:CrazyMcfobo|CrazyMcfobo]] 15:00, 27 July 2009 (UTC)

:I have lots of grudges but no societies. So that can be only part of the truth. In my fortresses it looks more like being on opposing sides of a scale triggers it, like "constantly active" vrs. "lives life at a leisurely pace" "modest" vrs. "immodest", tradition loving vrs. hating it --[[User:Koltom|Koltom]] 07:26, 28 July 2009 (UTC)
::Alright so there are alot of factors, all we need to do now is find them all! I'm going to get a picture of a society for you real quick.
Edit; [[File:Citizen.jpg]]--[[User:CrazyMcfobo|CrazyMcfobo]] 15:58, 28 July 2009 (UTC)

:::That's not a "society". The latter name mentioned is the name of your settlement, and the former is the name of the dwarf's original civ. I've never heard of dwarfs disliking other dwarf civs - the closest I've seen to something along those lines is when a dwarf (or any other civver) becomes an enemy of a civ after killing enough of their citizens, but that's got nothing to do with the thought of individual dwarfs. --[[User:3|3]] 19:13, 1 August 2009 (UTC)

40d Talk:Vermin

2009-08-01T18:51:20Z

==List request==
Can someone put a list of all the vermin, and their uses if caught? And a picture? --[[User:DDouble|DDouble]] 21:55, 11 November 2007 (EST)
:What would be the use of the picture? --[[User:Eagle of Fire|Eagle of Fire]] 00:24, 12 November 2007 (EST)
::Just to clarify in case the first poster didn't know, vermin all use the same image. --[[User:Shades|Shades]] 09:13, 12 November 2007 (EST)

:::Not quite. Lungfish vermin, for instance, use a fish-like symbol, worms use a tilde, etc. However, most do use the simple "large dot" graphic. --[[User:JT|JT]] 16:30, 18 November 2007 (EST)

:I just listed them all, with most pertinent information. Hope you like. Now someone should go list all the extracts. --[[User:Turgid Bolk|Turgid Bolk]] 02:08, 26 November 2007 (EST)

== un tameable vermin ==

Fire snakes when caught in an animal trap had a value of 1. I was unable to tame them and the announcement "needs tameable small creature item" appeared. --[[User:Kingzilla|Kingzilla]] 14:18, 23 January 2008 (EST)

In addition to that, they keep disappearing from cages and small animal traps on me. --[[User:Squirrelloid|Squirrelloid]] 16:28, 12 December 2008 (EST)
: You need the [[Dungeon Master]] to tame as they are PET_EXOTIC. I also have the suspicion they are burning their way out of wooden traps every so often, but can't prove it. I think they burned a barrel once, leaving the contents behind. --[[User:Jellyfishgreen|Jellyfishgreen]] 08:01, 14 January 2009 (EST)

::Had Dungeon Master. I trapped one in an animal trap, then moved it into a cage with a lot of other animals. Saw that it was there. Did some other things and when I looked again it was no longer in the cage, but the cage was most definitely still there. (Cage was also metal, but its continued existence on its own sort of ruled out the possibility that it burned). They were making a mess of my metal bar bins by turning them to ash, which was why I was trapping them in the first place. --[[User:Squirrelloid|Squirrelloid]] 10:31, 14 January 2009 (EST)

:::If I had to guess, it's possible that a dwarf decided to eat it. I've caught my dwarves eating vermin out of my cages, sometimes, even if they aren't starving. Some dwarves just like to eat weird things, I suppose. It seems odd that a dwarf would eat something that can set things on fire, but I've never seen anything to indicate that they can't. --[[User:Xennith|Xennith]] 7:34, 27 February 2009 (PST)

== Creating vermin habitat ==

I know you can make vermin show up to your base (try a tundra biome with an aquifer - if the stuff belowground stays liquid you can have toads hopping around in the snow :S. Also, I dug out some open cliffside dwellings in a random jungle map, and 5 min later about 50 or so bats turn up singing Meatloaf, and causing miasma hell for my dwarves after they were (mostly) dispatched by my two cats :(. Can anyone else replicate these (or other) situations to confirm my hypothesis? --[[User:Frostedfire|Frostedfire]] 04:21, 19 February 2008 (EST)

:Apparently vermin (and everything else?) spawn by biome. So, if you dig into a cave biome, you'll get bats. I dug next to a chasm and suddenly cave spiders spawn in my tunnel. [[User:Anydwarf|Anydwarf]] 22:37, 6 May 2008 (EDT)

:I started a fortress in the freezing tundra, no life there except my dwarves, wild musk-oxen, wild elk and the inhabitants of the magma-pipe. But as soon as I pumped some water into a cave one level beneath the surface, turtles started to spawn near the self-made underground pool. So apparently even a self-made pool of water is sufficient for pool-vermin ([[toad|toads]] and [[turtle|turtles]]) to make them spawn. --[[User:Doub|Doub]] 16:02, 9 September 2008 (EDT)

== Tameable? ==

There should be a list of -- or mark on -- tameable vermin.

At the very least, there should be a mention that only some can be tamed.

Currently, I know rats can be tamed, while fire snakes and two-legged rhino lizards cannot.

I have a tame fire snake. I'm pretty sure all non-fish vermin creatures are tameable. [[User:Bouchart|Bouchart]] 19:36, 5 March 2008 (EST)

:fire snakes and rhino lizards can be tamed, they are just [PET_EXOTIC]. not all non-fish vermin can be tamed(flies cant for example), and some fish vermin can be(turtles). -[[User:Chariot|Chariot]] 20:22, 5 March 2008 (EST)

Is there a way to get my dwarves to stop eating the fluffy wamblers before I can tame them? Apparently they taste like meat and saltwater taffy had a baby. Or something. (Maybe I just have to be pretty quick on handing my DM the task) [[User:Anydwarf|Anydwarf]] 22:37, 6 May 2008 (EDT)

:Not without a lot of micro-management. Even being quick to assign the task isn't enough, the dwarves will just snatch it right out of his hand. However, if you follow your trapper around as he's searching, and immediately forbid the vermin when he catches it (note: the vermin, not the trap), that'll prevent your dwarves from eating it. This works because eating requires the vermin itself to be unforbidden, but taming only requires that the animal trap is available. --[[User:Morlark|Morlark]] 19:31, 21 June 2008 (EDT)

== Corpse patrol ==

alright I guess this is just a winge...

is there any order to set (or anything else I can do) to get my dwarves to clean up vermin corpses without me manually marking them for dumping?

I guess I'm looking for an order: Autodump vermin corpses or something.
I know if I {{k|k}}{{k|d}} each corpse then it gets dumped pretty quick, but especially once my population goes up I'd like to not worry so much about miasma in the dining room.[[User:GarrieIrons|GarrieIrons]] 08:23, 21 June 2008 (EDT)

: AFAIK dead vermin will be automatically placed in a refuse stockpile, so long as 'Dwarves gather refuse' is selected in the refuse options menu ({{k|o}}{{k|r}}) --[[User:Raumkraut|Raumkraut]] 19:15, 21 June 2008 (EDT)
:: This seems to be what is happening now that I actually have some peasants wandering around on cleaning/food hauling/refuse hauling only... so it sounds like vermin corpses are a lesser priority for picking up for refuse haulers then items marked for dumping are.[[User:GarrieIrons|GarrieIrons]] 07:27, 22 June 2008 (EDT)

== repopulation ==

The [[turtle]] article states:
:Like most fish, they can be harvested too aggressively, and become depleted until the next '''repopulating of vermin'''
I added the bold bit... when does repopulating of vermin occur? Randomly? At spring (on a date) or during thaw (if there is one?) or differently by biome?[[User:GarrieIrons|GarrieIrons]] 01:06, 9 July 2008 (EDT)

Vermin respawn on season changes, along with refuse erasure and limb-mending, if I remember correctly. May be wrong, though. [[User:Iituem|Iituem]] 21:37, 5 Aug 2008 (GMT)

== Flies... ==

Is there anyway to kill flies?

I second this question! :) Is there anyway to kill these things? [[User:Ehertlein|Ehertlein]] 16:34, 5 August 2008 (EDT)
:Cats can kill them. [[User:HeWhoIsPale|HeWhoIsPale]] 16:13, 9 September 2008 (EDT)

== Rats ==

According to my animal and vermin list when I access cages, I have a "Live Rat" somewhere in my fortress that I don't recall ever catching. I've tried to install it into a placed "vermin cage" but it never shows up. I've asked my Trainer to tame it, but the task cancels itself and the rat never surfaces. Has some dwarf been carrying around a rat in his pockets for the last three years and refuses to give it up? --[[User:FJH|FJH]] 15:49, 17 April 2009 (UTC)
:Maybe you walled it in? ;) --[[User:Höhlenschreck|Höhlenschreck]] 23:46, 27 May 2009 (UTC)
:Or, more likely, its already tame? Try assigning it to a built cage? --[[User:Höhlenschreck|Höhlenschreck]] 23:47, 27 May 2009 (UTC)

== Already tamed ==

I was checking my animal screen and I noticed I had a tamed lizard. I have not trained any animals or even built a kennel nor have I built any small animal traps. Does anybody know how that may have happened.--[[User:Cerol The Elf Hunter|Cerol The Elf Hunter]] 21:47, 25 May 2009 (UTC)
:The elves. It was the Elves.--[[User:Zchris13|Zchris13]] 00:06, 26 May 2009 (UTC)
::<small>isn't it always the elves? ;) --[[User:Höhlenschreck|Höhlenschreck]] 00:05, 28 May 2009 (UTC) </small>
:Specifically, you probably bought a cage from the [[Elf|Elves]], which looked empty, but had a vermin creature in it. During trading, if you {{key|v}}iew the cage, it will list the contents, including any vermin in it.<br/>—[[User:0x517A5D|0x517A5D]] 03:50, 26 May 2009 (UTC)
Your probably right I have seized and destroyed many elvin caravans lately --[[User:Cerol The Elf Hunter|Cerol The Elf Hunter]] 02:24, 28 May 2009 (UTC)

== On just that topic ==
There was a discussion on [[Talk:Gray_squirrel]] about just what/which vermin elves bring. This might be incorporated as a table on the respective vermin pages and/or here, but first we need more insight - is there smth in the raws or do we just make a list from experience? I say the second cos it means we have legitimate reason to take down as many elven caravans as we like ;) Ideas? --[[User:Höhlenschreck|Höhlenschreck]] 10:39, 28 May 2009 (UTC)
<br />
:The elves can probably either bring all creatures, or all creatures from their biomes. I recall a post in the forum mentioning the elves bringing some kind of demon. I don't know if that particular game was modded. I have never heard that they brought demon rats... --[[User:Nahno|Nahno]] 13:40, 28 May 2009 (UTC)

== Error message: '''Name''' (Cat) (Tame) Cancels Store Item in Stockpile: Too injured ==

Is this message worth mentioning in the article? It seems that just before killing Vermin, Cats are thinking about putting the vermin in some sort of stockpile.
V 0.28.181.40d if that matters.
<font face="FixedSys" color="#00FFFF">[[User:GarrieIrons|Gar]]</font>[[User Talk:GarrieIrons|rie]] 11:27, 5 July 2009 (UTC)

: [[Cat_cancels_Store_Item_in_Stockpile:_Too_injured]] --[[User:Koltom|Koltom]] 16:23, 27 July 2009 (UTC)

== Accosting vermin vs hateable vermin ==

Currently, the phrasing above the table suggests that only hateable vermin (vermin dwarves can have a negative [[preference]] for in their [[profile]]s) "accost" dwarves, giving them the bad thought. Is this true, or are only dwarves that have that negative preference affected by those specific vermin in this way? Do blood gnats and knuckle worms not accost? (And are they not hateable?) Trying to remember, and don't have time atm to do "vermin research" - the distinction should be made correct, either way.--[[User:Albedo|Albedo]] 20:46, 23 July 2009 (UTC)

only [VERMIN_HATEABLE] can be detested. Detested --> accosted. This applies only to dwarves who actually have that "preference". accosted -->unhappy thought. Blood gnats and knuckle worms do not accost. They may annoy, like flies do. --[[User:Koltom|Koltom]] 20:28, 27 July 2009 (UTC)

==Vermin and wagons==

Is it possible for "penetrating" vermin (ie, rhino lizards) to get at your food barrels while the food is still on the embark wagon (or, more accurately, in buildings in general)? It's probably worth adding something, either here or on the [[Wagon]] page, to clarify. --[[User:3|3]] 18:51, 1 August 2009 (UTC)