Dwarf Fortress Wiki - User contributions [en]

v0.34:Item definition token

2012-03-24T14:41:32Z

Darekun: Many of the subtypes are grouped under "armor".

{{quality|Exceptional|18:10, 28 April 2011 (UTC)}}{{av}}
'''Item definition tokens''' are used in item definitions in the raws.

Item types:
* ITEM_WEAPON - [[weapon token]]
* ITEM_TOY - see below
* ITEM_TOOL - [[tool token]]
* ITEM_INSTRUMENT - see below
* ITEM_TRAPCOMP - [[trap component token]]
* ITEM_ARMOR - [[Armor token|armor-type armor token]]
* ITEM_AMMO - [[ammo token]]
* ITEM_SIEGEAMMO - see below
* ITEM_GLOVES - [[Armor token|gloves-type armor token]]
* ITEM_SHOES - [[Armor token|shoes-type armor token]]
* ITEM_SHIELD - [[Armor token|shield-type armor token]]
* ITEM_HELM - [[Armor token|helm-type armor token]]
* ITEM_PANTS - [[Armor token|pants-type armor token]]
* ITEM_FOOD - see below

==Toy and Instrument Tokens==
{| {{prettytable}}
|- bgcolor="#ddd"
! Token
! Arguments
! Description

|-
| NAME
| singular:plural
| What this item will be called ingame.

|-
| HARD_MAT
|
| Presumably prevents the item from being made from cloth, silk, or leather, present on everything but puzzleboxes and drums. Appears to work backwards for [[strange mood]]s.

|}

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

|-
| NAME
| singular:plural
| What this item will be called ingame.

|-
| CLASS
|
| Specifies what type of siege engine uses this ammunition. Currently, only BALLISTA is permitted.

|}

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

|-
| NAME
| singular:plural
| What this item will be called ingame.

|-
| LEVEL
|
| Specifies the number of ingredients are used in this type of prepared meal - 2 for Easy, 3 for Fine, 4 for Lavish. Defaults to 2.

|}

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

v0.34:Broker

2012-03-04T17:13:30Z

Darekun: Fixed a couple redlinks.

{{quality|Exceptional|22:22, 10 November 2010 (UTC)}}{{av}}

{{Noble
| noble=Broker
| function=
* [[Trade]]
* Visibility of Item [[Value]]s
* Display of Fortress [[Wealth]] on {{k|z}}-[[Status]] Screen
|arrival=Appointed on the [[nobles screen]].
}}

The Broker is a useful [[noble]] with no [[Demand]]s or [[Noble#Needs|Requirements]]. They have several duties in the running of an organised fortress.

If the broker has the [[Appraiser]] skill, they will allow you to see the count of your fortresses [[Wealth]] in the [[Status]] screen ({{k|z}}). The exactness with which this can be seen is determined by the duties of the [[Bookkeeper]]. Your broker should also have the [[Judge of intent]] skill to see how traders [[Trade#Merchant_mood|react]] to trade offers.

At the [[trade depot]], you can specify that only the broker may [[Trade]] with visiting [[caravan]]s. The advantage of this is that the broker gains skill in appraisal as he trades, which both allows the display of fortress wealth and helps with getting the best deals in your trading efforts.

==Relevant skills==
Names in bold have known effect,
{|border="1"
| '''Judge of Intent'''
| Liar
| Conversationalist
| Intimidator
|-
| '''Appraiser'''
| Comedian
| Persuader
| Pacifier
|-
| Negotiator
| Flatterer
| Consoler
|}

{{gamedata|[POSITION:BROKER]
[NAME:broker:brokers]
[SITE]
[NUMBER:1]
[RESPONSIBILITY:TRADE]
[APPOINTED_BY:EXPEDITION_LEADER]
[APPOINTED_BY:MAYOR]
[PRECEDENCE:170]
[DO_NOT_CULL]
[COLOR:5:0:0]
[DUTY_BOUND]}}

{{Nobles}}
{{Category|Appointed Nobles}}

v0.34:Interaction token

2012-03-01T14:40:29Z

Darekun: Added [IE_GRIME_LEVEL].

{{av}}

The following tokens can be used to define and use interactions.

==Interaction Definitions==
{| {{prettytable}}
|- bgcolor="#C0C0C0"
! Token
! Context
! Arguments
! Description

|-
| I_SOURCE
| Global
| type
| Defines what things are capable of triggering this interaction. Can be specified multiple times. Valid values:
* REGION - The interaction takes place in particular types of regions in the world.
* UNDERGROUND_SPECIAL - The interaction takes place in [[Demonic fortress|curious underground structure]]s.
* SECRET - The interaction is a secret that can be learned by particular individuals.
* DISTURBANCE - The interaction is triggered when disturbing a [[tomb]].
* DEITY - The interaction is inflicted upon mortals by the gods.
* ATTACK - The interaction is triggered by an attack during combat.
* INGESTION - The interaction is triggered by eating or drinking something.
* CREATURE_ACTION - The interaction is triggered by an explicit action.

|-
| IS_HIST_STRING_1
| Within I_SOURCE
| text
| Describes what the interaction did to a historical figure. Displayed after the name of the historical figure that performed the interaction.

[IS_HIST_STRING_1: cursed ]

|-
| IS_HIST_STRING_2
| Within I_SOURCE
| text
| Describes what the interaction did to a historical figure. Displayed after the name of the historical figure that was targeted by the interaction.

[IS_HIST_STRING_2: to assume the form of a lizard-like monster every full moon]

|-
| IS_FREQUENCY
| Within I_SOURCE
| Number
| ?

|-
| IS_NAME
| Within I_SOURCE
| string
| Generally used with secrets, describes what the secret is about.

|-
| IS_REGION
| Within I_SOURCE:REGION
| Region type
| Indicates what types regions are capable of performing this interaction. Can be specified multiple times. Valid values:
* ANY
* ANY_TERRAIN
* NORMAL_ALLOWED
* EVIL_ALLOWED
* GOOD_ALLOWED
* SAVAGE_ALLOWED
* EVIL_ONLY
* GOOD_ONLY
* SAVAGE_ONLY
* Region type - SWAMP, DESERT, FOREST, MOUNTAINS, OCEAN, LAKE, GLACIER, TUNDRA, GRASSLAND, HILLS

|-
| IS_SPHERE
| Within I_SOURCE:SECRET
| [[Sphere]]
| Indicates the sphere to which this secret pertains.

|-
| IS_SECRET_GOAL
| Within I_SOURCE:SECRET
| Secret Goal token
| Indicates why somebody would want to learn the secret. Valid values:
* IMMORTALITY

|-
| IS_SECRET
| Within I_SOURCE:SECRET
| Secret Flag
| Indicates how the secret can be learned. Valid values:
* SUPERNATURAL_LEARNING_POSSIBLE - the secret can be learned by supernatural means
* MUNDANE_RESEARCH_POSSIBLE - the secret can be researched by mundane means
* MUNDANE_TEACHING_POSSIBLE - the secret can be taught to apprentices
* MUNDANE_RECORDING_POSSIBLE:objects/text/(book_title).txt:objects/text/(book_topic).txt - the secret can be written in books with the specified title.

|-
| IS_USAGE_HINT
| Within I_SOURCE:DEITY
| Usage Hint token
| Indicates why a deity would choose to perform this interaction. See CDI:USAGE_HINT below for valid values - in this content, MAJOR_CURSE is the only value that makes sense.

|-
| I_TARGET
| Global
| id, type
| Specifies what things this interaction acts upon. Can be specified multiple times. Valid values:
* CORPSE
* CREATURE
* MATERIAL
* LOCATION

|-
| IT_LOCATION
| Within I_TARGET
| Location
| Narrows down exactly what the interaction targets. Valid values:
* CONTEXT_REGION
* CONTEXT_CREATURE
* CONTEXT_ITEM
* CONTEXT_BP - Use body part from CDI:BP_REQUIRED token (below).
* CONTEXT_LOCATION

|-
| IT_MANUAL_INPUT
| Within I_TARGET
| text
| Tells the player what they should be selecting.

|-
| IT_AFFECTED_CREATURE
| Within I_TARGET:CORPSE or I_TARGET:CREATURE
| ?
| Specifies specific creatures the interaction can target.

|-
| IT_AFFECTED_CLASS
| Within I_TARGET:CORPSE or I_TARGET:CREATURE
| Creature class
| Specifies creature classes the interaction can target.

|-
| IT_IMMUNE_CREATURE
| Within I_TARGET:CORPSE or I_TARGET:CREATURE
| ?
| Specifies specific creatures the interaction cannot target.

|-
| IT_IMMUNE_CLASS
| Within I_TARGET:CORPSE or I_TARGET:CREATURE
| Creature class
| Specifies creature classes the interaction cannot target.

|-
| IT_REQUIRES
| Within I_TARGET:CORPSE or I_TARGET:CREATURE
| Creature token or property
| Indicates that the target must have the specified property. Valid values:
* FIT_FOR_ANIMATION
* FIT_FOR_RESURRECTION
* HAS_BLOOD
* MORTAL
* NO_AGING
* STERILE
* Creature token: BLOODSUCKER, CAN_LEARN, CAN_SPEAK, CRAZED, EXTRAVISION, LIKES_FIGHTING (or LIKESFIGHTING), MISCHIEVOUS (or MISCHIEVIOUS), NO_CONNECTIONS_FOR_MOVEMENT, NO_DIZZINESS, NO_DRINK, NO_EAT, NO_FEVERS, NO_PHYS_ATT_GAIN, NO_PHYS_ATT_RUST, NO_SLEEP, NO_THOUGHT_CENTER_FOR_MOVEMENT, NOBREATHE, NOEMOTION, NOEXERT, NOFEAR, NONAUSEA, NOPAIN, NOSTUN, NOT_LIVING, NOTHOUGHT, OPPOSED_TO_LIFE, PARALYZEIMMUNE, SUPERNATURAL, TRANCES, UTTERANCES

|-
| IT_FORBIDDEN
| Within I_TARGET:CORPSE or I_TARGET:CREATURE
| Creature token or property
| Indicates that the target must not have the specified property. Valid values are the same as for IT_REQUIRES.

|-
| IT_CANNOT_TARGET_IF_ALREADY_AFFECTED
| Within I_TARGET:CORPSE or I_TARGET:CREATURE
|
| Prevents the interaction from targeting a creature that's already under the effect of the same interaction.

|-
| IT_CANNOT_HAVE_SYNDROME_CLASS
| Within I_TARGET:CORPSE or I_TARGET:CREATURE
| [[Syndrome]] class
| Prevents the interaction from targeting a creature under the effects of a syndrome having the specified SYN_CLASS value.

|-
| IT_MATERIAL
| Within I_TARGET:MATERIAL
| Type
| Specifies the type of material the interaction targets. Valid values:
* FLOW:Breath attack token - Specifies an attack not made of any material.
* MATERIAL:[[Material token]]:Breath attack token - Specifies an attack made of a specific material.
* CONTEXT_MATERIAL - Use material from CDI:MATERIAL token (below).

|-
| I_EFFECT
| Global
| type
| Specifies what the interaction does to the targets. Can be specified multiple times. Valid values:
* ANIMATE
* RESURRECT
* ADD_SYNDROME
* CLEAN
* HIDE
* CONTACT
* MATERIAL_EMISSION

|-
| IE_TARGET
| Within I_EFFECT
| ID
| Specifies which I_TARGET this effect will be applied to

|-
| IE_INTERMITTENT
| Within I_EFFECT
| Frequency
| Indicates that the effect happens intermittently and specifies roughly how often. Valid values:
* WEEKLY

|-
| IE_IMMEDIATE
| Within I_EFFECT
|
| Indicates that the effect happens immediately.

|-
| IE_LOCATION
| Within I_EFFECT
| Location Hint
| Indicates where the effect can take place. Valid values:
* IN_WATER
* IN_MAGMA
* NO_WATER
* NO_MAGMA

|-
| IE_ARENA_NAME
| Within I_EFFECT
| text
| Allows the interaction to be applied to newly spawned creatures in Arena mode.

|-
| IE_GRIME_LEVEL
| Within I_EFFECT
| amount?
| [IE_GRIME_LEVEL:2] appears in the default cleaning interaction, and may indicate amount of grime cleaned.

|-
| GENERATED
| Global
|
| Indicates that this is a generated interaction. Cannot be specified in user-defined raws.

|}

==Interaction Usage==
In order to actually use an interaction, add the [[creature token]] [CAN_DO_INTERACTION:NAME] followed by a series of [CDI:...] tokens. Interactions can also be granted through [[syndrome]]s using the token [CE_CAN_DO_INTERACTION] (plus the same series of CDI tokens).

The following CDI tokens can be specified:
{| {{prettytable}}
|- bgcolor="#C0C0C0"
! Token
! Arguments
! Description

|-
| INTERACTION
| id
| Specifies which interaction can be performed. Only to be used with syndromes, since CE_CAN_DO_INTERACTION does not allow specifying the interaction ID directly.

|-
| TARGET
| target ID, target types
| Specifies how the creature chooses what to . Target ID refers to an I_TARGET defined in the interaction itself. Multiple target types can be specified. Valid target types:
* LINE_OF_SIGHT - the source needs to be able to see the target
* TOUCHABLE - the source needs to be able to touch the target
* DISTURBER_ONLY - the target must be whoever disturbed the source
* SELF_ALLOWED - the target can be the source
* SELF_ONLY - the target '''must''' be the source

|-
| TARGET_RANGE
| target ID, range
| Specifies how far away the target can be, in tiles.

|-
| LOCATION_HINT
| Location Hint (see avove)
| ?

|-
| USAGE_HINT
| Usage hint token
| Indicates how the interaction is to be used. Valid values:
* MAJOR_CURSE
* GREETING
* CLEAN_SELF
* CLEAN_FRIEND
* ATTACK
* FLEEING

|-
| ADV_NAME
| text
| Specifies the interaction's name when used in Adventurer mode.

|-
| MAX_TARGET_NUMBER
| ID, number
| Specifies the maximum number of things that can be selected for a particular I_TARGET.

|-
| WAIT_PERIOD
| number
| Controls how often the interaction can be used.

|-
| VERBAL
|
| When the creature performs the interaction, they will speak a line of text to their target.

|-
| VERBAL_SPEECH
| filename
| Specifies what the creature says when they perform the interaction. Filename path is relative to /data/speech.

|-
| CAN_BE_MUTUAL
|
| Presumably, allows two creatures with this same interaction to use it on each other simultaneously, for example cats cleaning each other.

|-
| FREE_ACTION
|
| Indicates that performing the interaction doesn't take any time.

|-
| VERB
| self:other:?
| When a creature uses the interaction, a message will display, describing the source as doing this.

|-
| VERB_REVERSE
| ?
| ?

|-
| TARGET_VERB
| plural:singular
| When a creature uses the interaction, a message will display, describing the target as doing this.

|-
| BP_REQUIRED
| Body part criteria
| Indicates that a particular body part must be present in order to perform the interaction. Criteria are BY_CATEGORY:category, BY_TYPE:type, or BY_TOKEN:token.

|-
| FLOW
| Breath attack token
| Causes the interaction to create an effect not made of any material. Only makes sense for FIREBALL, FIREJET, or DRAGONFIRE.

|-
| MATERIAL
| [[Material token]]:Breath attack token
| Causes the interaction to create an effect made of a specific material. Doesn't make sense for FIREBALL, FIREJET, or DRAGONFIRE.

|}

==See Also==
* [[Syndrome]]

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

v0.34:Item token

2012-03-01T14:22:10Z

Darekun: Linked to Item_definition_token, since not all definition token pages have "definition" in their name.

{{av}}{{Quality|Fine}}

Item tokens are the first part in defining the target item in reactions, containing the item type and subtype. They determine the most basic form of item, and made more specific by [[material token]]s. Most item tokens use NO_SUBTYPE or NONE for subtype.

Nearly all items are made of a [[Material token|material]], though several types expect a creature ID and caste ID (e.g. [[Ant|ANT:SOLDIER]]) instead. This currently does not work correctly{{bug|4973}}.

Actually defining an item in item raws is done with [[item definition token]]s.

==Standard Item Tokens==

{| {{prettytable}} class="sortable"
|- bgcolor="#ddd"
! # !! Token !! Subtype !! Description
|-
| 0 || BAR || NONE || [[Bar]]s, such as [[metal]], [[fuel]], or [[soap]].
|-
| 1 || SMALLGEM || NONE || Cut [[gem]]stones usable in [[jeweler's workshop]]
|-
| 2 || BLOCKS || NONE || [[Block]]s of any kind.
|-
| 3 || ROUGH || NONE || Rough [[gem]]stones or raw [[glass]].
|-
| 4 || BOULDER / STONE || NONE || Raw mined [[stone]].
|-
| 5 || WOOD || NONE || Wooden [[log]]s.
|-
| 6 || DOOR || NONE || [[Door]]s.
|-
| 7 || FLOODGATE || NONE || [[Floodgate]]s.
|-
| 8 || BED || NONE || [[Bed]]s.
|-
| 9 || CHAIR || NONE || [[Chair]]s and thrones.
|-
| 10 || CHAIN || NONE || [[Chain]]s and [[rope]]s.
|-
| 11 || FLASK || NONE || [[Flask]]s.
|-
| 12 || GOBLET || NONE || [[Goblet]]s.
|-
| 13 || INSTRUMENT || item_instrument.txt || Musical [[instrument]]s.
|-
| 14 || TOY || item_toy.txt || [[Toy]]s.
|-
| 15 || WINDOW || NONE || Glass [[window]]s.
|-
| 16 || CAGE || NONE || [[Cage]]s.
|-
| 17 || BARREL || NONE || [[Barrel]]s.
|-
| 18 || BUCKET || NONE || [[Bucket]]s.
|-
| 19 || ANIMALTRAP || NONE || [[Animal trap]]s.
|-
| 20 || TABLE || NONE || [[Table]]s.
|-
| 21 || COFFIN || NONE || [[Coffin]]s.
|-
| 22 || STATUE || NONE || [[Statue]]s.
|-
| 23 || CORPSE || NONE || [[Corpse]]s. Does not have a material.
|-
| 24 || WEAPON || item_weapon.txt || [[Weapon]]s.
|-
| 25 || ARMOR || item_armor.txt || [[Armor]] and clothing worn on the upper body.
|-
| 26 || SHOES || item_shoes.txt || Armor and clothing worn on the feet.
|-
| 27 || SHIELD || item_shield.txt || [[Shield]]s and bucklers.
|-
| 28 || HELM || item_helm.txt || Armor and clothing worn on the head.
|-
| 29 || GLOVES || item_gloves.txt || Armor and clothing worn on the hands.
|-
| 30 || BOX || NONE || [[Container|Chest]]s (wood), coffers (stone), boxes (glass), and bags (cloth or leather).
|-
| 31 || BIN || NONE || [[Bin]]s.
|-
| 32 || ARMORSTAND || NONE || [[Armor stand]]s.
|-
| 33 || WEAPONRACK || NONE || [[Weapon rack]]s.
|-
| 34 || CABINET || NONE || [[Cabinet]]s.
|-
| 35 || FIGURINE || NONE || [[Figurine]]s.
|-
| 36 || AMULET || NONE || [[Amulet]]s.
|-
| 37 || SCEPTER || NONE || [[Scepter]]s.
|-
| 38 || AMMO || item_ammo.txt || [[Ammunition]] for hand-held weapons.
|-
| 39 || CROWN || NONE || [[Crown]]s.
|-
| 40 || RING || NONE || [[Ring]]s.
|-
| 41 || EARRING || NONE || [[Earring]]s.
|-
| 42 || BRACELET || NONE || [[Bracelet]]s.
|-
| 43 || GEM || NONE || Large [[gem]]s.
|-
| 44 || ANVIL || NONE || [[Anvil]]s.
|-
| 45 || CORPSEPIECE || NONE || [[Body part]]s. Does not have a material.
|-
| 46 || REMAINS || NONE || Dead [[vermin]] bodies. Material is CREATURE_ID:CASTE.
|-
| 47 || MEAT || NONE || Butchered [[meat]].
|-
| 48 || FISH || NONE || Prepared [[fish]]. Material is CREATURE_ID:CASTE.
|-
| 49 || FISH_RAW || NONE || Unprepared [[fish]]. Material is CREATURE_ID:CASTE.
|-
| 50 || VERMIN || NONE || Live [[vermin]]. Material is CREATURE_ID:CASTE.
|-
| 51 || PET || NONE || Tame [[vermin]]. Material is CREATURE_ID:CASTE.
|-
| 52 || SEEDS || NONE || [[Seed]]s from plants.
|-
| 53 || PLANT || NONE || [[Plant]]s.
|-
| 54 || SKIN_TANNED || NONE || [[Leather]].
|-
| 55 || LEAVES || NONE || Leaves, usually from [[quarry bush]]es.
|-
| 56 || THREAD || NONE || [[Thread]] gathered from webs or made at the [[farmer's workshop]].
|-
| 57 || CLOTH || NONE || [[Cloth]] made at the [[loom]].
|-
| 58 || TOTEM || NONE || Skull [[totem]]s.
|-
| 59 || PANTS || item_pants.txt || Armor and clothing worn on the legs.
|-
| 60 || BACKPACK || NONE || [[Backpack]]s.
|-
| 61 || QUIVER || NONE || [[Quiver]]s.
|-
| 62 || CATAPULTPARTS || NONE || [[Catapult]] parts.
|-
| 63 || BALLISTAPARTS || NONE || [[Ballista]] parts.
|-
| 64 || SIEGEAMMO || item_siegeammo.txt || Siege engine ammunition.
|-
| 65 || BALLISTAARROWHEAD || NONE || Ballista arrow heads.
|-
| 66 || TRAPPARTS || NONE || [[Mechanism]]s.
|-
| 67 || TRAPCOMP || item_trapcomp.txt || [[Trap component]]s.
|-
| 68 || DRINK || NONE || [[Alcohol]]ic drinks.
|-
| 69 || POWDER_MISC || NONE || Powders such as [[flour]], [[gypsum plaster]], [[dye]], or [[sand]].
|-
| 70 || CHEESE || NONE || Pieces of [[cheese]].
|-
| 71 || FOOD || item_food.txt || [[Prepared meal]]s.
|-
| 72 || LIQUID_MISC || NONE || Liquids such as [[water]], [[lye]], and extracts.
|-
| 73 || COIN || NONE || [[Coin]]s.
|-
| 74 || GLOB || NONE || [[Fat]], [[tallow]], pastes/pressed objects, and small bits of molten rock/metal.
|-
| 75 || ROCK || NONE || Small rocks (usually [[Knapper|sharpened]] and/or [[Thrower|thrown]] in [[adventurer mode]]).
|-
| 76 || PIPE_SECTION || NONE || [[Pipe section]]s.
|-
| 77 || HATCH_COVER || NONE || [[Hatch cover]]s.
|-
| 78 || GRATE || NONE || [[Grate]]s.
|-
| 79 || QUERN || NONE || [[Quern]]s.
|-
| 80 || MILLSTONE || NONE || [[Millstone]]s.
|-
| 81 || SPLINT || NONE || [[Splint]]s.
|-
| 82 || CRUTCH || NONE || [[Crutch]]es.
|-
| 83 || TRACTION_BENCH || NONE || [[Traction bench]]es.
|-
| 84 || ORTHOPEDIC_CAST || NONE || [[Cast]]s.
|-
| 85 || TOOL || item_tool.txt || [[Tool]]s.
|-
| 86 || SLAB || NONE || [[Slab]]s.
|-
| 87 || EGG || NONE || [[Egg]]s. Material is CREATURE_ID:CASTE.
|}

==Limited/Special Use Item Tokens==

In several specific locations, the values below can be substituted for the item type and subtype (and be followed directly by the [[material token]]).

{| {{prettytable}}
|- style='background-color:#ddd'
! Token
! Subtype
! Valid Uses
! Description

|-
| ANY_CRAFT
| NONE
| [[Reaction]] [REAGENT]
| Matches FIGURINE, AMULET, SCEPTER, CROWN, RING, EARRING, or BRACELET.

|-
| ANY_RAW_MATERIAL
| NONE
| [[Reaction]] [REAGENT]
| Matches POWDER_MISC, BAR, BOULDER, or GLOB.

|-
| CRAFTS
| NONE
| [[Reaction]] [PRODUCT]
| Produces 1-3 items of type FIGURINE, AMULET, SCEPTER, CROWN, RING, EARRING, or BRACELET.

|}

==Related Tokens==

These tokens are not Item Tokens at all, but can take the place of them in some circumstances.

{| {{prettytable}}
|- style='background-color:#ddd'
! Token
! Subtype
! Valid Uses
! Description

|-
| METAL_ORE
| Metal
| [[Reaction]] [REAGENT]
| Matches a BOULDER item made of a material having [METAL_ORE:<Metal>:###].

|}

==See Also==
*[[Material token]]
*[[Reactions]]

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

v0.34:Interaction token

2012-02-24T08:43:55Z

Darekun: Presumed [CAN_BE_MUTUAL] from context.

{{av}}

The following tokens can be used to define and use interactions.

==Interaction Definitions==
{| {{prettytable}}
|- bgcolor="#C0C0C0"
! Token
! Context
! Arguments
! Description

|-
| I_SOURCE
| Global
| type
| Defines what things are capable of triggering this interaction. Can be specified multiple times. Valid values:
* REGION - The interaction takes place in particular types of regions in the world.
* UNDERGROUND_SPECIAL - The interaction takes place in [[Demonic fortress|curious underground structure]]s.
* SECRET - The interaction is a secret that can be learned by particular individuals.
* DISTURBANCE - The interaction is triggered when disturbing a [[tomb]].
* DEITY - The interaction is inflicted upon mortals by the gods.
* ATTACK - The interaction is triggered by an attack during combat.
* INGESTION - The interaction is triggered by eating or drinking something.
* CREATURE_ACTION - The interaction is triggered by an explicit action.

|-
| IS_HIST_STRING_1
| Within I_SOURCE
| text
| Describes what the interaction did to a historical figure. Displayed after the name of the historical figure that performed the interaction.

[IS_HIST_STRING_1: cursed ]

|-
| IS_HIST_STRING_2
| Within I_SOURCE
| text
| Describes what the interaction did to a historical figure. Displayed after the name of the historical figure that was targetted by the interaction.

[IS_HIST_STRING_2: to assume the form of a lizard-like monster every full moon]

|-
| IS_FREQUENCY
| Within I_SOURCE
| Number
| ?

|-
| IS_NAME
| Within I_SOURCE
| string
| Generally used with secrets, describes what the secret is about.

|-
| IS_REGION
| Within I_SOURCE:REGION
| Region type
| Indicates what types regions are capable of performing this interaction. Can be specified multiple times. Valid values:
* ANY
* ANY_TERRAIN
* NORMAL_ALLOWED
* EVIL_ALLOWED
* GOOD_ALLOWED
* SAVAGE_ALLOWED
* EVIL_ONLY
* GOOD_ONLY
* SAVAGE_ONLY
* Region type - SWAMP, DESERT, FOREST, MOUNTAINS, OCEAN, LAKE, GLACIER, TUNDRA, GRASSLAND, HILLS

|-
| IS_SPHERE
| Within I_SOURCE:SECRET
| [[Sphere]]
| Indicates the sphere to which this secret pertains.

|-
| IS_SECRET_GOAL
| Within I_SOURCE:SECRET
| Secret Goal token
| Indicates why somebody would want to learn the secret. Valid values:
* IMMORTALITY

|-
| IS_SECRET
| Within I_SOURCE:SECRET
| Secret Flag
| Indicates how the secret can be learned. Valid values:
* SUPERNATURAL_LEARNING_POSSIBLE - the secret can be learned by supernatural means
* MUNDANE_RESEARCH_POSSIBLE - the secret can be researched by mundane means
* MUNDANE_TEACHING_POSSIBLE - the secret can be taught to apprentices
* MUNDANE_RECORDING_POSSIBLE:objects/text/(book_title).txt:objects/text/(book_topic).txt - the secret can be written in books with the specified title.

|-
| IS_USAGE_HINT
| Within I_SOURCE:DEITY
| Usage Hint token
| Indicates why a deity would choose to perform this interaction. See CDI:USAGE_HINT below for valid values - in this content, MAJOR_CURSE is the only value that makes sense.

|-
| I_TARGET
| Global
| id, type
| Specifies what things this interaction acts upon. Can be specified multiple times. Valid values:
* CORPSE
* CREATURE
* MATERIAL
* LOCATION

|-
| IT_LOCATION
| Within I_TARGET
| Location
| Narrows down exactly what the interaction targets. Valid values:
* CONTEXT_REGION
* CONTEXT_CREATURE
* CONTEXT_ITEM
* CONTEXT_BP - Use body part from CDI:BP_REQUIRED token (below).
* CONTEXT_LOCATION

|-
| IT_MANUAL_INPUT
| Within I_TARGET
| text
| Tells the player what they should be selecting.

|-
| IT_AFFECTED_CREATURE
| Within I_TARGET:CORPSE or I_TARGET:CREATURE
| ?
| Specifies specific creatures the interaction can target.

|-
| IT_AFFECTED_CLASS
| Within I_TARGET:CORPSE or I_TARGET:CREATURE
| Creature class
| Specifies creature classes the interaction can target.

|-
| IT_IMMUNE_CREATURE
| Within I_TARGET:CORPSE or I_TARGET:CREATURE
| ?
| Specifies specific creatures the interaction cannot target.

|-
| IT_IMMUNE_CLASS
| Within I_TARGET:CORPSE or I_TARGET:CREATURE
| Creature class
| Specifies creature classes the interaction cannot target.

|-
| IT_REQUIRES
| Within I_TARGET:CORPSE or I_TARGET:CREATURE
| Creature token or property
| Indicates that the target must have the specified property. Valid values:
* FIT_FOR_ANIMATION
* FIT_FOR_RESURRECTION
* HAS_BLOOD
* MORTAL
* NO_AGING
* STERILE
* Creature token: BLOODSUCKER, CAN_LEARN, CAN_SPEAK, CRAZED, EXTRAVISION, LIKESFIGHTING, MISCHIEVIOUS / MISCHIEVOUS, NO_CONNECTIONS_FOR_MOVEMENT, NO_DIZZINESS, NO_DRINK, NO_EAT, NO_FEVERS, NO_PHYS_ATT_GAIN, NO_PHYS_ATT_RUST, NO_SLEEP, NO_THOUGHT_CENTER_FOR_MOVEMENT, NOBREATHE, NOEMOTION, NOEXERT, NOFEAR, NONAUSEA, NOPAIN, NOSTUN, NOT_LIVING, NOTHOUGHT, OPPOSED_TO_LIFE, PARALYZEIMMUNE, SUPERNATURAL, TRANCES, UTTERANCES

|-
| IT_FORBIDDEN
| Within I_TARGET:CORPSE or I_TARGET:CREATURE
| Creature token or property
| Indicates that the target must not have the specified property. Valid values are the same as for IT_REQUIRES.

|-
| IT_CANNOT_TARGET_IF_ALREADY_AFFECTED
| Within I_TARGET:CORPSE or I_TARGET:CREATURE
|
| Prevents the interaction from targetting a creature that's already under the effect of the same interaction.

|-
| IT_CANNOT_HAVE_SYNDROME_CLASS
| Within I_TARGET:CORPSE or I_TARGET:CREATURE
| [[Syndrome]] class
| Prevents the interaction from targetting a creature under the effects of a syndrome having the specified SYN_CLASS value.

|-
| IT_MATERIAL
| Within I_TARGET:MATERIAL
| Type
| Specifies the type of material the interaction targets. Valid values:
* FLOW:Breath attack token - Specifies an attack not made of any material.
* MATERIAL:[[Material token]]:Breath attack token - Specifies an attack made of a specific material.
* CONTEXT_MATERIAL - Use material from CDI:MATERIAL token (below).

|-
| I_EFFECT
| Global
| type
| Specifies what the interaction does to the targets. Can be specified multiple times. Valid values:
* ANIMATE
* RESURRECT
* ADD_SYNDROME
* CLEAN
* HIDE
* CONTACT
* MATERIAL_EMISSION

|-
| IE_TARGET
| Within I_EFFECT
| ID
| Specifies which I_TARGET this effect will be applied to

|-
| IE_INTERMITTENT
| Within I_EFFECT
| Frequency
| Indicates that the effect happens intermittently and specifies roughly how often. Valid values:
* WEEKLY

|-
| IE_IMMEDIATE
| Within I_EFFECT
|
| Indicates that the effect happens immediately.

|-
| IE_LOCATION
| Within I_EFFECT
| Location Hint
| Indicates where the effect can take place. Valid values:
* IN_WATER
* IN_MAGMA
* NO_WATER
* NO_MAGMA

|-
| IE_ARENA_NAME
| Within I_EFFECT
| text
| Allows the interaction to be applied to newly spawned creatures in Arena mode.

|-
| GENERATED
| Global
|
| Indicates that this is a generated interaction. Cannot be specified in user-defined raws.

|}

==Interaction Usage==
In order to actually use an interaction, add the [[creature token]] [CAN_DO_INTERACTION:NAME] followed by a series of [CDI:...] tokens. Interactions can also be granted through [[syndrome]]s using the token [CE_CAN_DO_INTERACTION] (plus the same series of CDI tokens).

The following CDI tokens can be specified:
{| {{prettytable}}
|- bgcolor="#C0C0C0"
! Token
! Arguments
! Description

|-
| INTERACTION
| id
| Specifies which interaction can be performed. Only to be used with syndromes, since CE_CAN_DO_INTERACTION does not allow specifying the interaction ID directly.

|-
| TARGET
| target ID, target types
| Specifies how the creature chooses what to . Target ID refers to an I_TARGET defined in the interaction itself. Multiple target types can be specified. Valid target types:
* LINE_OF_SIGHT - the source needs to be able to see the target
* TOUCHABLE - the source needs to be able to touch the target
* DISTURBER_ONLY - the target must be whoever disturbed the source
* SELF_ALLOWED - the target can be the source
* SELF_ONLY - the target '''must''' be the source

|-
| TARGET_RANGE
| target ID, range
| Specifies how far away the target can be, in tiles.

|-
| LOCATION_HINT
| Location Hint (see avove)
| ?

|-
| USAGE_HINT
| Usage hint token
| Indicates how the interaction is to be used. Valid values:
* MAJOR_CURSE
* GREETING
* CLEAN_SELF
* CLEAN_FRIEND
* ATTACK
* FLEEING

|-
| ADV_NAME
| text
| Specifies the interaction's name when used in Adventurer mode.

|-
| MAX_TARGET_NUMBER
| ID, number
| Specifies the maximum number of things that can be selected for a particular I_TARGET.

|-
| WAIT_PERIOD
| number
| Controls how often the interaction can be used.

|-
| VERBAL
|
| When the creature performs the interaction, they will speak a line of text to their target.

|-
| VERBAL_SPEECH
| filename
| Specifies what the creature says when they perform the interaction. Filename path is relative to /data/speech.

|-
| CAN_BE_MUTUAL
|
| Presumably, allows two creatures with this same interaction to use it on each other simultaneously, for example cats cleaning each other.

|-
| FREE_ACTION
|
| Indicates that performing the interaction doesn't take any time.

|-
| VERB
| self:other:?
| When a creature uses the interaction, a message will display, describing the source as doing this.

|-
| VERB_REVERSE
| ?
| ?

|-
| TARGET_VERB
| plural:singular
| When a creature uses the interaction, a message will display, describing the target as doing this.

|-
| BP_REQUIRED
| Body part criteria
| Indicates that a particular body part must be present in order to perform the interaction. Criteria are BY_CATEGORY:category, BY_TYPE:type, or BY_TOKEN:token.

|-
| FLOW
| Breath attack token
| Causes the interaction to create an effect not made of any material. Only makes sense for FIREBALL, FIREJET, or DRAGONFIRE.

|-
| MATERIAL
| [[Material token]]:Breath attack token
| Causes the interaction to create an effect made of a specific material. Doesn't make sense for FIREBALL, FIREJET, or DRAGONFIRE.

|}

==See Also==
* [[Syndrome]]

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

v0.34:Creature token

2012-02-24T07:13:23Z

Darekun: Clarified some biome tags. Pet tags need similar clarification, especially since they mix includes and excludes.

{{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="10%" | Type
! width="20%" | Arguments
! width="50%" | Description

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

|-
| ALCOHOL_DEPENDENT
| Caste
|
| Creature needs alcohol to get through the working day.

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

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

|-
| AMBUSHPREDATOR
| Caste
|
| Instead of charging relentlessly at prey, a creature with this tag will wait till the prey is within a few squares before charging.{{verify}}

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

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

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

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

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

|-
| APP_MOD_RATE
| Caste
|
*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
| Special
|
*CV TEMPLATE NAME
| Loads the Creature Variation Template specified.

|-
| APPLY_CURRENT_CREATURE_VARIATION
| Special
|
| Applies loaded Creature Variation

|-
| AQUATIC
| Caste
|
| Allows a creature to breathe underwater, but causes it to "drown" out of [[water]].

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

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

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

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

|-
| ATTACK_TRIGGER
| Caste
| pop:exported wealth:created wealth
| Specifies when a [[megabeast]] will attack the fortress.

|}

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

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

|-
| BABY
| Caste
| integer
| Age at which creature is considered a child. Default is zero. One can think of this as the duration of the baby stage.

|-
| BABYNAME
| Caste
| singular:plural
| Defines a new name for a creature in baby state at the caste level. For non-caste-specific baby names, see GENERAL_BABY_NAME.

|-
| BEACH_FREQUENCY
| Caste
|
| [[Whale]]s and [[Sea nettle jellyfish|jellyfish]] have this. Controls the beaching frequency of the creature.

|-
| BENIGN
| Caste
|
| The creature will only show up in "tame" biomes. Such creatures will generally avoid dwarves, although they may chase and/or attack them if they get too close, notably including [[elephant]]s.

|-
| BIOME
| Creature
|
* [[biome token]]
| Select a [[Biome]] the creature may appear in.

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

|-
| BLOODSUCKER
| Caste
|
| ?

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

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

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

|-
| BODY_SIZE
| Caste
| years:days:size
| sets up size at a given time. Size is in cubic centimeters (milliliters), and for normal body materials is roughly equal to the creature's average weight in grams.
'''Example:''' 
[BODY_SIZE:0:0:10000] 
[BODY_SIZE:1:168:50000] 
[BODY_SIZE:12:0:220000] 
This describes the size of a [[minotaur]]. His birth size would be 10000 (10000 mL, ~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
| Caste
| gloss
| Substitutes body part text with replacement text. Draws gloss information from OBJECT:BODY files (such as body_default.txt)

|-
| BONECARN
| Caste
|
| Creature 'eats' bones. Eating bones makes their happiness go up, but can cause death (suffocation){{verify}}. Implies CARNIVORE. Civilized creatures (ex. Kobolds) with this tag tend to die out during world generation.

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

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

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

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

|-
| CAN_DO_INTERACTION
| Caste
| interaction token
| The creature can perform an interaction. See [[interaction token]].

|-
| CAN_LEARN
| Caste
|
| 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
| Caste
|
| Can talk. Note that it is not necessary for a creature to gain social skills. If a member of a civilization (such as a pet) has this token, it'll need to eat and drink.{{verify}}

|-
| CANNOT_UNDEAD
| Caste
|
| Alias for NOT_LIVING

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

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

|-
| CASTE
| Creature
|
*name
| defines a caste

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

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

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

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

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

|-
| CASTE_PROFESSION_NAME
| Caste
|
*[[Unit type token]] (Profession)
*singular
*plural
| alters the name of the given profession, caste-specific

|-
| CASTE_SOLDIER_ALTTILE
| Caste
| '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
| Caste
| 'character' or tile number
| Creatures of this caste active in their civilization's military will use this tile instead.

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

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

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

|-
| CDI
| Caste
| Varies
| Specifies details for the preceding CAN_DO_INTERACTION token. See [[Inteaction token]].

|-
| CHANGE_BODY_SIZE_PERC
| Caste
|
|

|-
| CHILD
| Caste
| 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
| Caste
| singular:plural
| Defines a new name for a creature in child state at the caste level. For non-caste-specific child names, see GENERAL_CHILD_NAME.

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

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

|-
| COLONY_EXTERNAL
| Caste
|
| Caste hovers around colony.

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

|-
| COMMON_DOMESTIC
| Caste
|
| 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
| Caste
|
| Creatures of this caste's species with the SPOUSE_CONVERTER and NIGHT_CREATURE_HUNTER tokens will kidnap SPOUSE_CONVERSION_TARGETs of an appropriate sex and convert them into castes with CONVERTED_SPOUSE.

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

|-
| CRAZED
| Caste
| ?
| ?

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

|-
| CREATURE_CLASS
| Caste
|
*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
| Creature
| 'character' or tile number
| Creatures active in their civilization's military will use this tile instead.

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

|-
| CREPUSCULAR
| Caste
|
| Sets if the creature is active at twilight.

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

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

|-
| CURIOUSBEAST_ITEM
| Caste
|
| 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
| Special
|
*TAG NAME
| Adds a tag. Used in conjunction with creature variation templates.

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

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

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

|-
| DEMON
| Caste
|
| Found on generated [[demon]]s. Cannot be specified in user-defined raws.

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

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

|-
| DIFFICULTY
| Caste
| 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
| Caste
|
| Sets if the creature is active in day.

|-
| DIVE_HUNTS_VERMIN
| Caste
|
| Found on [[peregrine falcons]]. The creature hunts vermin by diving from the air. May be bugged due to fortress pets remaining earthbound.

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

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

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

|-
| EBO_ITEM
| Caste
| [[item token]]:[[material token]] (ANY_HARD_STONE can be used for the material)
| Defines the item that the creature drops upon being butchered. Used with EXTRA_BUTCHER_OBJECT.

|-
| EBO_SHAPE
| Caste
| gem shape
| The shape of the extra item of the creature upon butchering. Used with EXTRA_BUTCHER_OBJECT.

|-
| EGG_MATERIAL
| Caste
|
* [[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
| Caste
|
*size
| Determines how long it takes for eggs to hatch{{verify}}. The larger the number, the longer it takes.

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

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

|-
| EVIL
| Creature
|
| Creature is considered evil and will only show up in evil biomes. Has no effect on cavern creatures.

|-
| EXTRA_BUTCHER_OBJECT
| Caste
|
* BY_CATEGORY, BY_TYPE, BY_TOKEN
* TYPE, CATEGORY, or TOKEN
| The creature drops an additional object when butchered (typically a gizzard stone), defined by EBO_ITEM and EBO_SHAPE.

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

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

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

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

|-
| FANCIFUL
| Creature
|
| 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. Conflicts with [COMMON_DOMESTIC]

|-
| FEATURE_ATTACK_GROUP
| Caste
|
| Found on subterranean animalmen.

|-
| FEATURE_BEAST
| Caste
|
| Found on [[forgotten beast]]s. Cannot be specified in user-defined raws.

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

|-
| FIREIMMUNE
| Caste
|
| Renders a creature immune to being damaged by FIREBREATH's short range cone attack.

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

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

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

|-
| FLEEQUICK
| Caste
|
| Determines how soon a creature flees in a losing battle. Creatures with this tag will flee at the first sign of resistance.

|-
| FLIER
| Caste
|
| 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
| Creature
|
*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="10%" | Type
! width="20%" | Arguments
! width="50%" | Description

|-
| GENERAL_BABY_NAME
| Creature
| singular:plural
| name at creature level

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

|-
| GENERAL_MATERIAL_FORCE_MULTIPLIER
| Caste
| ?
| ?

|-
| GENERATED
| Creature
|
| Found on procedurally generated creatures like [[Forgotten beast]]s, (biome name) [[titan]]s, [[Demon]]s, and [[night creature]]s. Cannot be specified in user-defined raws.

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

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

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

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

|-
| GNAWER
| Caste
| verb
| The creature chews on food barrels and bags. The verb is past tense, for example [GNAWER:gnawed].

|-
| GOBBLE_VERMIN_CLASS
| Caste
| class
| The creature eats vermin of the specified caste.

|-
| GOBBLE_VERMIN_CREATURE
| Caste
| creature:caste
| The creature eats a specified vermin.

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

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

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

|-
| GOOD
| Creature
|
| Creature is considered good and will only show up in good biomes, for example [[unicorn]]s. Presumably has no effect on cavern creatures.

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

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

|-
| GRAZER
| Caste
|
*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="10%" | Type
! width="20%" | Arguments
! width="50%" | Description

|-
| HABIT
| Caste
| type:probability
| Defines certain behaviors for the creature. The habit types are COLLECT_TROPHIES, COOK_PEOPLE, COOK_VERMIN, GRIND_VERMIN, COOK_BLOOD, GRIND_BONE_MEAL, EAT_BONE_PORRIDGE, USE_ANY_MELEE_WEAPON, GIANT_NEST, and COLLECT_WEALTH. These may require the creature to have a lair to work properly.

|-
| HABIT_NUM
| Caste
| number or TEST_ALL
| "If you set HABIT_NUM to a number, it should give you that exact number of habits according to the weights.".[[http://www.bay12forums.com/smf/index.php?topic=60554.msg1719248#msg1719248 source post]] All lists of HABITs are preceded by [HABIT_NUM:TEST_ALL]

|-
| HAS_NERVES
| Caste
|
| 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
| Caste
|
| The creature has a shell. Seemingly no longer used - holdover from previous versions.

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

|-
| HOMEOTHERM
| Caste
|
| Default 'NONE'. The creature's normal body [[temperature]]

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

|}

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

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

|-
| IMMOBILE
| Caste
|
| The creature cannot move. Found on [[sponge]]s.

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

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

|-
| INTELLIGENT
| Caste
|
| Shortcut for [CAN_SPEAK] + [CAN_LEARN].

|-
| ITEMCORPSE
| Caste
|
* [[item token]]
* [[material token]]
| Determines if the creature leaves behind a non-standard corpse (i.e. wood, statue, bars, ash from ghost etc).

|-
| ITEMCORPSE_QUALITY
| Caste
|
| 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="10%" | Type
! width="20%" | Arguments
! width="50%" | Description

|-
| LAIR
| Caste
| 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
| Caste
| characteristic:probability
| Defines certain features of the creature's lair. The only valid characteristic is HAS_DOORS.

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

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

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

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

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

|-
| LAYS_UNUSUAL_EGGS
| Caste
|
* [[item token]]
* [[material token]]
| Creature lays a particular item instead of regular eggs.

|-
| LIGAMENTS
| Caste
|
* [[material token]]
*healing rate
| Defines the material and healing rate of ligaments.

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

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

|-
| LISP
| Caste
|
| Creature uses "sssssnake talk" (multiplies 'S' when talking - "My name isss Recisssiz.")

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

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

|-
| LOOSE_CLUSTERS
| Creature
|
| 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="10%" | Type
! width="20%" | Arguments
! width="50%" | Description

|-
| MAGICAL
| Caste
|
| Unknown.

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

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

|-
| MANNERISM_*
| Caste
|
*occasionally body part
| Adds a possible mannerism to the creature's profile.
Refer to [[Creature mannerism token]]s

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

|-
| MATERIAL_FORCE_MULTIPLIER
| Caste
| ?
| ?

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

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

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

|-
| MEGABEAST
| Caste
|
| Appears on fortress territory in Fortress Mode occasionally. Can also be worshipped.

|-
|MENT_ATT_CAP_PERC
| Caste
|
*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
| Caste
|
*ATTRIBUTE
*lowest:lower:low:median:high:higher:highest
| Sets up a mental attribute's range of values (0-5000). All mental attribute ranges default to 200:800:900:1000:1100:1300:2000.

|-
| MENT_ATT_RATES
| Caste
|
*ATTRIBUTE Token
*cost to improve
*unused counter rate
*rust counter rate
*demotion counter rate
| Mental attribute gain/decay rates. Defaults are 500:4:5:4.

|-
| MILKABLE
| Caste
|
* [[material token]]
* frequency
| Allows the creature to be milked.

|-
| MISCHIEVIOUS
| Caste
|
| Alias for MISCHIEVOUS

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

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

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

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

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

|-
| MUNDANE
| Creature
|
| Marks if the creature is an actual real-life creature. Only used for age-names at present, and determining whether a creature will attack creatures with the AT_PEACE_WITH_WILDLIFE token.
|}

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

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

|-
| NAME
| Creature
| singular:plural:adjective
| The generic name for any creature of this type - will be used when distinctions between caste are unimportant. For names for specific castes, use CASTE_NAME instead.

|-
| NATURAL
| Caste
|
| Alias for NATURAL_ANIMAL

|-
| NATURAL_ANIMAL
| Caste
|
| Animal is considered to be natural.

|-
| NATURAL_SKILL
| Caste
| 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 (changed in .25 or earlier that CAN_LEARN is no longer required).

|-
| NIGHT_CREATURE_BOGEYMAN
| Caste
|
| Found on bogeymen. Creatures with this tag will join other bogeymen in attacking adventurers at night, and will also adopt their other behaviors, such as vanishing in smoke upon being killed. Setting the number of night creatures to zero in the world gen parameters will remove only the randomly-generated bogeymen.

|-
| NIGHT_CREATURE_HUNTER
| Caste
|
| 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 <s>of the opposite sex</s>(seems to choose anyone of any sex of the caste/s that have the CONVERTED_SPOUSE tag), convert them, and then have children with them(if possible). NIGHT_CREATURE_HUNTERs without SPOUSE_CONVERTER will not be placed. Setting the number of night creatures to zero in the world gen parameters will remove only the randomly-generated night creatures.

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

|-
| NO_CONNECTIONS_FOR_MOVEMENT
| Caste
| ?
| ?

|-
| NO_DIZZINESS
| Caste
|
| Creature cannot become dizzy

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

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

|-
| NO_FEVERS
| Caste
|
| Creature cannot suffer fevers

|-
| NO_GENDER
| Caste
|
| Creature has no gender.

|-
| NO_PHYS_ATT_GAIN
| Caste
| ?
| ?

|-
| NO_PHYS_ATT_RUST
| Caste
| ?
| ?

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

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

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

|-
| NO_THOUGHT_CENTER_FOR_MOVEMENT
| Caste
|
| Creatures doesn't require an organ with the [THOUGHT] tag to survive; generally used on creatures that don't have brains.

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

|-
| NOBONES
| Caste
|
| Creature has no bones.

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

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

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

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

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

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

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

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

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

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

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

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

|-
| NOSTUN
| Caste
|
| 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
| Caste
|
| Cannot be butchered

|-
| NOT_LIVING
| Caste
|
| Cannot be raised from the dead. Also prevents ghosts of that creature appearing.

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

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

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

|-
| OPPOSED_TO_LIFE
| Caste
| ?
| ?

|}

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

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

|-
| PACK_ANIMAL
| Caste
|
| Allows the creature to be used as a pack animal. Currently only used by merchants. Also prevents creature from dropping hauled items on its own -- do not use for player-controllable creatures.

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

|-
| PATTERNFLIER
| Caste
|
|

|-
| PEARL
| Caste
|
| Creature will generate pearls.

|-
| PENETRATEPOWER
| Caste
| 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
| Caste
|
*ATTRIBUTE
*lowest:median:highest
| Determines the range and chance of personality traits. Standard is 0:50:100. See [[Personality trait]] for more info.

|-
| PET
| Caste
|
| Allows the creature to be tamed. Also allows all females of the species to breed regardless of marital status.

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

|-
| PETVALUE
| Caste
| 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
| Caste
| 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
| Caste
|
*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
| Caste
|
*ATTRIBUTE
*lowest:lower:low:median:high:higher:highest
| Sets up a physical attribute's range of values (0-5000). All physical attribute ranges default to 200:700:900:1000:1100:1300:2000.

|-
| PHYS_ATT_RATES
| Caste
|
*ATTRIBUTE Token
*cost to improve
*unused counter rate
*rust counter rate
*demotion counter rate
| Physical attribute gain/decay rates. Defaults for STRENGTH, AGILITY, TOUGHNESS, and ENDURANCE are 500:3:4:3, while RECUPERATION and DISEASE_RESISTANCE default to 500:NONE:NONE:NONE.

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

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

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

|-
| POPULATION_NUMBER
| Creature
| min:max
| old guess: "The minimum/maximum numbers of how many of these creatures can show up on a map per year." Toady: "Pop number is the number per square of the region, I think."

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

|-
| PREFSTRING
| Creature
| 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
| Creature
|
*[[Unit type token]] (Profession)
*singular
*plural
| The generic name for members of this profession, at the creature level. In order to give members of specific castes different names for professions, use CASTE_PROFESSION_NAME instead.

|-
| PRONE_TO_RAGE
| Caste
| 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
| Caste
|
* [[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="10%" | Type
! width="20%" | Arguments
! width="50%" | Description

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

|-
| REMAINS
| Caste
| singular:plural
| What creature's remains are called.

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

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

|-
| REMAINS_UNDETERMINED
| Caste
|
| Unknown.

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

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

|-
| RETRACT_INTO_BP
| Caste
|
*BY_TYPE, BY_CATEGORY or BY_TOKEN
*TYPE, CATEGORY or TOKEN
| The creature will retract a body part when threatened.

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

|-
| ROOT_AROUND
| Caste
| ?
| ?

|}

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

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

|-
| SAVAGE
| Creature
|
| The creature will only show up in "savage" biomes.

|-
| SECRETION
| Caste
|
* [[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
| Creature
|
*caste name
| adds an additional previously defined caste to the selection. Used immediately after SELECT_CASTE.

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

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

|-
| SEMIMEGABEAST
| Caste
|
| Appears as boss creature in quests. Makes history by rampaging around towns. Appears on fortress territory in Fortress Mode occasionally. Possibly inhabits non-mountain caves.

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

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

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

|-
| SKILL_LEARN_RATE
| Caste
| [[skill_token]]:percentage
| The rate at which this creature learns this skill. Requires CAN_LEARN or INTELLIGENT to function.

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

|-
| SKILL_RATE
| Caste
| [[skill_token]]:percentage:value:value:value
| As SKILL_RATES for individual skills. Requires CAN_LEARN or INTELLIGENT to function.

|-
| SKILL_RATES
| Caste
|
*% 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:16:16]. [SLOW_LEARNER] changes the 100 to a 50. Requires CAN_LEARN or INTELLIGENT to function.

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

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

|-
| SLOW_LEARNER
| Caste
|
| 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
| Caste
|
| If a creature has this token, it'll leave "remains" instead of a corpse.

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

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

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

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

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

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

|-
| SPEED
| Caste
| 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 [[Speed]] for more information.

|-
| SPHERE
| Creature
|
*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
| Caste
|
| This creature can be converted by a night creature with SPOUSE_CONVERTED.

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

|-
| SUPERNATURAL
| Caste
| ?
| ?

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

|-
| SWIMS_INNATE
| Caste
|
| 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
| Caste
|
| 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="10%" | Type
! width="20%" | Arguments
! width="50%" | Description

|-
| TENDONS
| Caste
|
* [[material token]]
*healing rate
| Defines the material and healing rate of tendons.

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

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

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

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

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

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

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

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

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

|-
| TRAINABLE
| Caste
|
| Shortcut for [TRAINABLE_HUNTING] + [TRAINABLE_WAR].

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

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

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

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

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

|-
| TSU_NOUN
| Caste
|
*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="10%" | Type
! width="20%" | Arguments
! width="50%" | Description

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

|-
| UNDERGROUND_DEPTH
| Creature
|
*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
| Caste
|
| Creature swims under the water and can't be seen. Currently appears to have no effect as of 31.25.

|-
| UNIQUE_DEMON
| Caste
|
| Typically found on generated [[demon]]s; causes the game to create a single named instance of the demon which will emerge from the underworld and take over civilizations during worldgen. Cannot be specified in user-defined raws.

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

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

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

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

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

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

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

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

|-
| VEGETATION
| Caste
|
| unknown

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

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

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

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

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

|-
| VERMIN_MICRO
| Caste
|
| 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
| Caste
|
| The creature cannot be caught by fishing.

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

|-
| VERMIN_NOTRAP
| Caste
|
| 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
| Creature
|
| 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
| Creature
|
| The creature randomly appears near dirt or mud.

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

|-
| VERMINHUNTER
| Caste
|
| Shortcut for [AT_PEACE_WITH_WILDLIFE] + [RETURNS_VERMIN_KILLS_TO_OWNER] + [HUNTS_VERMIN] + [ADOPTS_OWNER].

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

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

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

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

|-
| WAGON_PULLER
| Caste
|
| Allows the creature to pull caravan wagons.

|-
| WEBBER
| Caste
|
* [[material token]]
| Allows the creature to create webs, and defines what the webs are made of.

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

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

|-
| ATTACK_SKILL
| Caste
|
*skill used ([[Skill token]])
| defines the attack skill used

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

|-
| ATTACK_CONTACT_PERC
| Caste
|
*% value
| amount of available tissue used in attack, or possibly percent chance the attack makes contact

|-
| ATTACK_PENETRATION_PERC
| Caste
|
*% value
| probably amount of material that makes contact when penetration is done, or possibly percent chance the attack penetrates (as in sharp items. Default is 0, so it can be left out for blunt attacks, if this is what it does)

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

|-
| ATTACK_VELOCITY_MODIFIER
| Caste
| 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
| Caste
|
| 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
| Caste
|
| In adventure mode, displays the name of the body part used by an attack when announcing the attack.

|-
| ATTACK_FLAG_EDGE
| Caste
|
| attack type

|-
| SPECIALATTACK_INJECT_EXTRACT
| Caste
|
* [[material token]]
*state (SOLID, LIQUID, GAS)
*min:max
| attack type addition that injects a material into the victim.

|-
| SPECIALATTACK_INTERACTION
| Caste
| ?
| ?

|-
| SPECIALATTACK_SUCK_BLOOD
| Caste
| 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 [[Tissue definition token]])

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

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

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

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

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

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

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

|-
| TISSUE_LAYER_OVER
| Caste
|
*BY_TYPE, BY_CATEGORY, BY_TOKEN
*TYPE,CATEGORY, or TOKEN
*TISSUE
*LOCATION
| Presumably a counterpart to TISSUE_LAYER_UNDER (see below).

|-
| TISSUE_LAYER_UNDER
| Caste
|
*BY_TYPE, BY_CATEGORY, BY_TOKEN
*TYPE,CATEGORY, or TOKEN
*TISSUE
| Adds the tissue layer under a given part.
For example an Iron Man has a gaseous poison within and this tissue (GAS is its name) has the token [TISSUE_LEAKS] and its state is GAS so when you puncture the iron outside and damage this tissue it leaks gas (can have a syndrome by using a previous one in the creature sample.) [TISSUE_LAYER_UNDER:BY_CATEGORY:ALL:{tissue}] {tissue} is what will be under the TISSUE_LAYER here is an example Tissue from 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
| Caste
|
*QUALITY
*lowest:lower:low:median:high:higher:highest
| sets the range of qualities, including LENGTH, DENSE, HIGH_POSITION, CURLY, GREASY, WRINKLY

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

|-
| TL_CONNECTS
| Caste
|
| Presumably gives the CONNECTS attribute to selected layers.

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

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

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

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

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

|}

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

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

v0.34 Talk:Aquifer

2012-02-21T14:52:30Z

Darekun: Created page with "==Going Around An Aquifer In A Single Biome?== I noticed something odd in 0.34.01: I was trying to get aquifer and easy magma in one embark, and found a small volcanic mountain b..."

==Going Around An Aquifer In A Single Biome?==
I noticed something odd in 0.34.01: I was trying to get aquifer and easy magma in one embark, and found a small volcanic mountain by a forest that would work. If I centered on the volcano, with most of the embark being the single forest area, it showed no aquifer, but moving north a bit showed aquifer in the forest area. Are the biomes after embark smaller than the areas that flash on the embark screen? Once embarked it looked contiguous. (I didn't probe much before changing the raws enough to gen a new world.)
[[User:Darekun|Darekun]] 14:52, 21 February 2012 (UTC)

v0.31:Reactions

2010-05-25T17:50:14Z

Darekun: /* Reaction Makeup */ Fixed copy/paste error calling all parts reagent declarations.

{{av}}
{{Quality|Exceptional}}
'''Reactions''' are moddable crafting formulas. They can be tweaked and added onto to allow smelting of new metals, alloys, and many other products. They must be assigned to specific [[Entities]]; if not explicitly added to an entity's definition, they will not be able to produce that reaction. For examples of various forms of reaction, see {{l|Reaction Examples}}.

Currently, a reaction can only result in an object of base quality.

==Reaction Makeup==
[REACTION:<REACTION_IDENTIFIER>]
[NAME:<REACTION_NAME>]
<... [[#Buildings]] One or more building references ...>
<... [[#Reagents]] Zero or more reagent declarations ...>
<... [[#Products]] Zero or more product declarations ...>
<... [[#Reaction Modifiers]] Zero or more reaction modifiers ...>
<... [[#Skills]] Zero or more skill references ...>

'''<REACTION_IDENTIFIER>''' - Refers to a unique identifier for the reaction (Used in Entity Raws to allow an Entity to make use of the reaction.

'''<REACTION_NAME>''' - String displayed in the building for the reaction.

==Entity Use==
In order for an entity to use the reaction a [PERMITTED_REACTION:] tag must be added. It works by using the '''<REACTION_IDENTIFIER>''' after the colon.
[PERMITTED_REACTION:<REACTION_IDENTIFIER>]

==Buildings==
Each reaction requires a building to be declared for it to be used at.

[BUILDING:<BUILDING_IDENTIFIER>:<BUILDING_KEY>]

'''<BUILDING_IDENTIFIER''' - The building at which this reaction can be used. NOTE: SMELTER, KILN, KITCHEN and TANNER seem to be the only non-custom buildings allowed to be specified at this point.{{verify}}

'''<BUILDING_KEY>''' - The key that is pressed at the building (Such as 'b' for bed at a Carpenter or a block at a Mason's). If two reactions have the same key, then one of them will be assigned a different key, the first alphabetically available at the building.

==Reagents==
A reagent is some object that is required to produce whatever the intended object is. This is typically something like needing the ore of a metal to smelt bars of it.

===Reagent Types===
[REAGENT:<Identifier>:<Quantity>:<ITEM_TOKEN>:<ITEM_SUBTYPE>:<MATGLOSS_TOKEN>:<MATGLOSS_SUBTYPE>]
or
[REAGENT:<Identifier>:<Quantity>:<MATGLOSS_TOKEN>:<MATGLOSS_SUBTYPE>]

Type 1: Is used for reactions where a specific type of object is required, such as a BUCKET, SWORD, etc.

Type 2: Is used for when only a material type is needed, such as METAL_ORE for smelter reactions.

<Identifier> - Used to refer to this reagent in the reaction Product.

<Quantity> - Used to refer to the number of individual units of the reagent needed for the reaction. NOTE: If a bar, thread, or cloth is used as the <ITEM_TOKEN>, then this value refers to the PRODUCT_DENSITY of the object (150, 15000, 10000 respectively).

<ITEM_TOKEN> - Refers to the hard coded {{l|Item tokens|item token}} that the reagent must be.

<ITEM_SUBTYPE> - Refers to a specific item subtype, defined in the raws, of a specific ITEM_TOKEN, such as TOY:ITEM_TOY_MINIFORGE.

<MATGLOSS_TOKEN> - Refers to the hard coded material type {{l|Matgloss token| token}} of the reagent, such as PLANT_MAT, METAL_ORE, etc.

<MATGLOSS_SUBTYPE> - Refers to a specific item {{l|Matgloss subtypes|subtype}}, defined in the raws, of a specific MATGLOSS_TOKEN, such as INORGANIC:MICA. In the case of a plant type the syntax is slightly different, the MATGLOSS_SUBTYPE is actually <PLANT_NAME>:<PLANT_PART>.

''<PLANT_NAME>'' - Refers to the actual plant's name in the raw files.

''<PLANT_PART>'' - Refers to the plant 'part' you want, whether it's the PLANT, WOOD, LEAVES, SEED, etc.

===Reagent Modifier===
A reagent can be modified by attaching one, or more, of the following. The modification is used to narrow the available items that can be used for the reaction.

'''[PRESERVE_REAGENT]''' - Reagent is not destroyed, which is the normal effect, at the completion of the reaction. Typically used for containers.

'''[REACTION_CLASS:X]''' - Reagent's MATGLOSS_SUBTYPE must have a REACTION_CLASS of type X attached to it. Such as the various forms of Gypsum having [REACTION_CLASS:GYPSUM] in them. Reaction classes are not hard-coded and you may freely insert REACTION_CLASS tags with custom "X" types into object definitions that will be used as reagents.

'''[HAS_MATERIAL_REACTION_PRODUCT:X]''' - Reagent's MATGLOSS_SUBTYPE must have a MATERIAL_REACTION_PRODUCT tag. This is used primarily on items that come from a dead, or butchered, animal such as skins or fat for tanning and rendering.

'''[UNROTTEN]''' - Reagent must not be rotten, mainly for organic MATGLOSS types.

'''[BUILDMAT]''' - Reagent is able to be used to build structures (Stone, Wood, Blocks, Bars?).

'''[GLASS_MATERIAL]''' - Reagent has a one of the glass MATGLOSS types.

'''[WORTHLESS_STONE_ONLY]''' - Only use objects allowed in the Stone Menu.

'''[FIRE_BUILD_SAFE]''' - Reagent must be considered fire safe (INORGANIC, excluding COAL types).

'''[MAGMA_BUILD_SAFE]''' - Reagent must be considered magma safe (INORGANIC, with a melting point greater than the temperature of Magma.

'''[CAN_USE_ARTIFACT]''' - Reagent can be an Artifact.

'''[ANY_PLANT_MATERIAL]''' - Reagent MATGLOSS must be of a plant subtype.

'''[ANY_SILK_MATERIAL]''' - Reagent MATGLOSS must be of a silk type.

'''[ANY_SOAP_MATERIAL]''' - Reagent MATGLOSS must be of a soap type.

'''[ANY_LEATHER_MATERIAL]''' - Reagent MATGLOSS must be of a leather type.

'''[ANY_BONE_MATERIAL]''' - Reagent MATGLOSS must be of a bone type.

'''[ANY_SHELL_MATERIAL]''' - Reagent MATGLOSS must be of a shell type.

'''[ANY_TOOTH_MATERIAL]''' - Reagent MATGLOSS must be of a tooth type.

'''[ANY_HORN_MATERIAL]''' - Reagent MATGLOSS must be of a horn type.

'''[ANY_PEARL_MATERIAL]''' - Reagent MATGLOSS must be of a pearl type (Excretion from sea creatures?)

'''[USE_BODY_COMPONENT]''' - Reagent MATGLOSS must come off a creature's body.

'''[METAL_ORE]''' - Reagent MATGLOSS must be a metal ore.

'''[NOT_WEB]''' - States that the material cannot be web (For making only plant/adamantine thread?).

'''[WEB_ONLY]''' - States that the material has to be web (For making only silk thread?).

'''[POTASHABLE]''' - The reagent must be able to be turned into pot ash.

'''[EMPTY]''' - If the reagent is a container, it must be empty.

'''[CONTAINS_LYE]''' - If the reagent is a container, it must contain LYE.

'''[NOT_CONTAIN_BARREL_ITEM]''' - If the reagent is a Barrel, it must not contain an item that has to reside in a barrel (Such as alcohol?).

'''[BAG]''' - Reagent has to be a bag. Intended to be used with an item type of BOX, to prevent chests, coffers, and other containers from being used instead.

==Products==
These are the results of a given reaction. There may be any number of such results.

===Product Format===
[PRODUCT:<CHANCE>:<QUANTITY>:<ITEM_TOKEN>:<ITEM_SUBTYPE>:<MATGLOSS>:<MATGLOSS_SUBTYPE>]

'''<CHANCE>''' - This is the chance (As a percent) that the <QUANTITY> number of items will be created after this reaction completes.

'''<QUANTITY>''' - This is the number of the item to be created.

'''<ITEM_TOKEN>''' - This is the ITEM_TOKEN of the result.

'''<ITEM_SUBTYPE>''' - This is a ITEM_SUBTYPE listed in an actual Raw File.

'''<MATGLOSS>''' - This is the MATGLOSS of the item. If you want to use the MATGLOSS information of a Reagent, then this is GET_MATERIAL_FROM_REAGENT:IDENTIFIER, where IDENTIFIER is the reagent's identifier in the reaction.

'''<MATGLOSS_SUBTYPE>''' - Refers to a specific item subtype, defined in the raws, of a specific MATGLOSS_TOKEN, such as PLANT_MAT:MUSHROOM_HELMET_PLUMP. If GET_MATERIAL_FROM_REAGENT was used in the MATGLOSS, you can specify a type, or you can state NONE, to recieve the MATGLOSS_SUBTYPE of the reagent.

Note that vermin can be created by using code similar to: [PRODUCT:100:1:VERMIN:NO_SUBTYPE:ROACH_LARGE:ROACH_LARGE]

===Product Modifiers===
Each product may have a zero, or more, modifiers following its declaration.

'''[PRODUCT_TO_CONTAINER:<IDENTIFIER>]''' - This states that the product should be put into a specific container listed in as a reagent.

''<IDENTIFIER>'' - Refers back to a reagent identifier.

'''[PRODUCT_DIMENSIONS:<DIMENSION>]''' - Used to specify the dimensions of the object, primarily for use with bars, threads, and cloth.

''<DIMENSION>'' - The 'size' of the object, for use in reactions that require a certain amount of bars, threads and cloth. 'Normal' size is bars = 150, threads = 15000 and cloth = 10000.{{verify}}

==Reaction Modifiers==
Reactions can be further modified by the adding zero or more of the following.

'''[FUEL]''' - Which states that it must take some form of COAL (COKE or CHARCOAL) to fuel it. If the building requires magma, it's assumed that this tag is ignored.

'''[AUTOMATIC]''' - Meaning that if the reagents are present, this reaction is automatically added to the work list of the building, such as 'Butcher Animal' at a Butcher's or 'Gather Web' at a Loom.

==Skills==
Skills have to be associated with a reaction. This dictates what skill receives the experience and who can do the job. More than one skill can be associated with the reaction, but only the last SKILL on the list, that a dwarf can perform, receives experience.

[SKILL:<SKILL_TOKEN>]

'''<SKILL_TOKEN>''' - This is SKILL_TOKEN for the reaction.

{{Category|Modding}}

v0.31:Chimera

2010-05-24T00:12:07Z

Darekun: Fixed link to Category:Modding. (It was invoking the category as a template.)

{{av}}
{{CreatureInfo|name=Chimera|biome=None|symbol=C|color=2:0:1|butcher=no}}
{{Quality|Masterwork}}
A '''Chimera''' is a {{L|fanciful}} creature which is merely the stuff of {{L|legend}}s. They do not actually exist, appearing only in {{L|engravings}} as the fancy of artists.

Dwarf Fortress presently does not include a robust or finalized {{L|magic}} system, so they are in the game's [[:category:modding|raw object data]] only in order to allow them to appear in engravings.

{{Game_Data|[CREATURE:CHIMERA]
[NAME:chimera:chimeras:chimeric]
[CREATURE_TILE:'C'][COLOR:2:0:1]
[FANCIFUL]
[DOES_NOT_EXIST]
[PREFSTRING:terrifying features]
[ALL_ACTIVE] }}

{{Category|Creatures}}

40d:Stupid dwarf trick

2010-05-12T09:29:53Z

Darekun: /* Doberman Launcher */ Renamed section to "Doberman Bomb".

{{av}}
{{D for Dwarf}}

A '''stupid dwarf trick''' is any project that requires a large amount time and effort - often for little or no practical benefit. They exist only as a challenge for experienced players.

==Adventure Mode Fortress==

Build a fortress specifically for exploring in {{L|adventure mode}}. You can either make a nasty monster-filled challenge, or a Smörgåsbord of masterpiece steel weapons and armor. Possibly both. A {{L|chasm}}, underground {{L|river}}, or {{L|hidden fun stuff}} can ensure the fortress is occupied.

'''Difficulty:''' The sky's the limit.

'''Usefulness:''' Not applicable.

==Alarm Clock==
Are your soldiers all sound asleep while blood soaks the walls? No need to deconstruct their beds one by one, ''if'' you bought the Dwarf Wakey 3000! Simply a solitary floor tile balanced on a support, one or more can be toppled with the pull of a lever to produce an earth-shaking racket that'll have them leaping for their axes!

'''Difficulty:''' Low.

'''Usefulness:''' Low.

==Aqueduct Power==
If your river's a long way away from your fortress, building a trans-map axle may be less efficient than building an aqueduct and pump stack driven by waterwheels in the river. The pump stack raises it to the height of your fort, where it flows through the long, long aqueduct and drives waterwheels on the other end. Getting the water pressure just right so it powers your waterwheel without flooding the fort can be {{L|Fun}}. Diagonal channels make good pressure reducers.

'''Difficulty:''' High. Lots of stone, lots of engineering, lots of dangerous outdoor work, lots of trial-and-error for the receiving waterwheels.

'''Usefulness:''' High. As much water and power as you want, wherever you want, whenever you want.

==Watervator==
By creating a vertical "Hydraulic Elevation and Lowering Platform" chamber (A H.E.L.P. Chamber, so named for the cries of the passenger dwarf) with lever controlled water levels, you can move a dwarf up several z-levels without any stairs. All it takes is the dwarf's ability to swim up to the surface of the water to breathe.

'''Difficulty:''' Medium. Moderate possibility of Fun by way of flooding your fortress. Any dwarves that can't swim will instead experience Fun when using the Watervator. The actual construction time and resource usage is very low. Using the Watervator often leads to unhappy thoughts about drowning

'''Usefulness:''' Low to Medium. The Watervator requires manual micromanaging, while stairs do not. On the other hand, it can be used to create a pathway that most enemies will simply be unable to use. Those that can would still be doing so at great risk of drowning or falling to their death

==Aquifer Power==
Aquifers can be a resource of immense power. If you have two levels of aquifer, you can generate a continuous flow by draining one level of aquifer into another and plant waterwheels above it. One stream can power a lot of wheels.

'''Difficulty:''' High. Anything to do with draining aquifers is very {{L|Fun}}.

'''Usefulness:''' High. The lowly windmill pales in utility compared to a waterwheel.

==Artificial Waterfall==
To keep the waterfall going, you need a {{L|pump}} stack, preferably powered by a {{L|windmill}} or {{L|water wheel}}.

'''Difficulty:''' Moderate.

'''Usefulness:''' Dwarves love {{L|waterfall}}s. Putting a waterfall in your {{L|meeting hall}} will give your dwarves good {{L|thought}}s, although it can significantly lower framerate.

=={{L|Ballista}} Battery==
Overlap a few ballistas to completely cover a narrow corridor. There is an unavoidable risk of your operators wandering into the line of fire.

'''Difficulty:''' Low. If you insist on highly-trained operators with high-quality ballistas, it gets harder.

'''Usefulness:''' A complicated and dangerous way to defend a single corridor. Ultimately extremely effective. Sometimes.

==Bridge-a-pult==
A bridge that opens outwards, to fling enemies away. Ideally, they land in a very nasty place.

'''Difficulty:''' The hard part is the nasty place they get flung to.

'''Usefulness:''' There are a far more effective ways to defend a fortress, but few are as entertaining.

==Dam==
Build a wall across a riverbed to stop the flow of water. Floodgates optional.

Bonus: excavate a reservoir and a lower river valley 
Bonus: build a control center to control the water flow 
Bonus: draw your entire energy from a power station within

'''Difficulty:''' On a map that freezes in the winter, this is easy. Otherwise, very difficult. (See {{L|dam}}, or Moses effect, below. But with the bonuses it gets a bit harder.

'''Usefulness:''' Depends on how many bonuses you fullfill. The Power station is obvious, and with the control room you could build up a nice defense system.

==Day Care==
A room where you put all your dwarf children so they cannot be kidnapped by snatchers. Make a suicide booth setup that drops the child into a room with beds and tables and stuff. Remember to include a food chute to quantum stockpile a huge amount of food and alcohol on a 1x1 stockpile (so it doesn't rot) in the room. High quality food, furniture, and socializing should keep them happy. Note that the children will no longer be able to perform certain useful tasks like crop harvesting and deconstruction, and will not level up their skill in various professions like an otherwise kidnappable child, but this is a small tradeoff if they usually get kidnapped before maturing anyway.

'''Difficulty:''' Low but annoying. You may have to micromanage to get every child into the room, and it'll be a hassle to get the grown ones out without releasing all of them.

'''Usefulness:''' Low. Protecting the children may be more trouble than it's worth

==Doberman Bomb==
Whenever a dog or cat gives birth, stuff all the kittens and puppies in one cage in your entryway. Link this cage to a pressure plate beside it. Should your last lines of defense be breached, goblins will step on it and in the next instant be torn apart by dozens of goblin-seeking hostiles and distracted by dozens of surplus targets. The trap actually going off will probably be very bad for your framerate. Bonus: Train all dogs inside as wardogs when they mature. Super bonus: Make it a Bear Trap. MEGADWARF bonus: Combine with a drowning chamber and carp trap.

'''Difficulty:''' Low.

'''Usefulness:''' Medium, potentially fortress-saving

==Drowning Chamber==
'''Difficulty:''' Moderate.

'''Usefulness:''' You can kill prisoners, useless peasants, irate nobles, hammerers, untrainable animals, or anything else.

=={{L|Computing|Dwarfputer}} Complex==
A big mess of fluid and/or machine logic full of hatches, floodgates, gears, pumps, etc. and powered by waterwheels, windmills, or useless idle dwarves. Hook it up to doors, bridges, and traps.

'''Difficulty:''' Medium to high, depending on what you want to build. You'll want to build for very high water flow if you have more than a few fluid gates.

'''Usefulness:''' Your mechanics and architects will level up very fast. Manual pumps give something for your haulers to do and makes them stronger. Try and make a clock to trigger different mechanisms in different seasons. See if enemies actually blunder into your intricate traps. Watch all hell break loose as water freezes.

==Dwarven Apartment Complex==
Essentially, one of the many possible {{L|mega constructions}} dedicated to providing dwarves with rooms so high above the ground they get vertigo. Every floor must have plenty of rooms of at least 2x3 squares, with walls and a door surrounding this. Oh, and it has to go up as many Z-levels as possible. For extra credit, decide on what the top story will be (i.e. as many levels up as you deem possible, minus one so you can build a roof) and turn this into a Royal bedroom for a {{L|noble}}, complete with gem windows, artifact/masterwork components, and untold numbers of armour stands and weapon racks. And then build some shorter but wider apartment buildings nearby to turn your fortress into essentially a giant fist with extended middle finger. Extra points for adding extra useless things for luxury, such as a magma-based heating system, fireplaces in rooms, and a lock-down lever in case of goblin attack. (or a self-destruct lever connected to the main supports, in case your dwarfish tenants are unsatisfied with your 5-star service.

'''Difficulty:''' Low, although the walls around the rooms can be a bit fiddly due to the impossibility of building walls on constructed floors (yes, an extra credit challenge is to do this without using Remove Construction).

'''Usefulness:''' Limited, because you could just dig the things underground and save yourself the hassle. However it is much harder to flood a tower than a cave, in case you're prone to fun by water.

==Execution Tower==
Just a tall tower to chuck your captives to their deaths.

'''Difficulty:''' Easy.

'''Usefulness:''' Lets you dispose of prisoners, and claim expensive silk, meltable iron, and (eventually) useful bones. Also highly amusing.

==Flood the World==
'''Difficulty:''' High danger. Will kill your frame rate.

'''Usefulness:''' Will prevent any sieges, at least. Or anything else, save for the occasional invasion of sociopathic {{L|Carp}}.

==Gladiator Arena==
Station some soldiers at the bottom of a shallow {{L|Activity_zone#Pit/Pond|pit}} and dump your captives in. You can also use dangerous animals instead of soldiers. For extra points, put the prisoners in cages connected to ramps underneath the arena floor. One lever will open both the cage and a hatch above the ramp.

'''Difficulty:''' Moderate, but time consuming. Some danger depending on the relative skill of your soldiers and the danger of the captive.

'''Usefulness:''' The most difficult way to dispose of prisoners. It does give your soldiers a little bit of experience.

==Glass Ceiling==
Sick of having your dwarfs vomit all the time when they go out to retrieve loot or lumber? Despair no more! Build an almost-infinitely tall tower, and then put a glass floor on the highest level, spanning the entire map. For extra kicks, make a mechanism that will crash the entire thing upon the heads of the one goblin horde that manages to get through all your other deathtraps.

'''Difficulty:''' Medium. Very grueling.

'''Usefulness:''' Low, but potentially fortress-saving. (see above)

==Greenhouse==
A {{L|farming|greenhouse}} is just a farm with the the ceiling channeled out from above. This lets you grow outdoor plants without venturing above ground. For maximum style, build the greenhouse above ground and cover it with a glass roof to keep your farmers safe.

'''Difficulty:''' Low.

'''Usefulness:''' Surface plants can be grown at any time of the year, and some are more useful than those available underground - for example, {{L|sun berry|sun berries}} can be brewed into valuable {{L|Sunshine}}, and {{L|whip vine}}s can be milled into superior quality flour. Having greater food and booze diversity can also keep your dwarves happier.

==Hammer of {{L|Armok}}==
A gigantic hammer made out of pure steel and/or valuables looming over your fortress entrance ready to smite those foolish enough to lay a siege on you. Also, gives you a psychological advantage over the traders who unload their goods under it. Attach to a lever-linked support for quicksmiting, or any other single-tile collapse mechanism. BONUS: Cover it with blood.

'''Difficulty:''' Low. Depends on size, materials and magma's existence, though. Make it a gold hammer menacing with adamantine spikes, if you're going for high quality.

'''Usefulness:''' Low-medium. 10x10 size is minimum for practical effectiveness. 30x30 hammer extending handles length from your entrance actually works against sieges.

==Ice tower==

Building a huge tower is easy. To make things more {{L|fun}}, make one out of some exotic material, like {{L|glass}}, {{L|ice}}, {{L|gold}}, or {{L|soap}}.

'''Difficulty:''' Low. You need to be on a freezing map to pull off an ice tower.

'''Usefulness:''' None.

=="I dinna say we wurren't crazy!"==

Build a huge room with nothing in it except rock pillars, then dig channels on the levels above and below it until you have a ridiculously huge room ten Z-levels in height. Inspired by Irregular Webcomic.

'''Difficulty:''' Mainly in putting up with the incessant channelling, and avoiding dropping large chunks of ceiling onto the floor from five levels up.

'''Usefulness:''' Negative, due to the insane amounts of space it takes up.

==It's A TRAP!==
It seems that {{L|traps}} are buildable outside. This provides for numerous opportunities. The first that comes to mind is to trap the entire outside world of your embarkation point. This will make your sieges very amusing, as a hundred high-level goblins rush onto the field and are immediately shredded into ribbons by invisible traps before even seeing one dwarf.

'''Difficulty:''' High. Depending on the size of your embarkation point, this may involve placing thousands of traps. Depending on the type of trap, that may involve making tens of thousands of trap components.

'''Usefulness:''' High. Sieges will be instantaneous, and if you use cage traps, your {{L|arena}} will never want for combatants, including all those pesky wild animals you no longer need to hunt for.

==It's A CRAP!==
CRAP: Carp trap...wait, why are you laughing? Anyway, here what you do.

Capture some carp in terrarium cage trap. If you don't die instantly, tame them. Then dump them in your moat and breed them.
All the little goblins (or Orcs) coming toward you in a massive siege must be directed into your moat. When they fall in, they
become (goblin chunk). Laugh maniacally.

BONUS: Edit the raws to make carps eat their kills.

'''Difficulty''': Like going within two tiles of a carp infested river and surviving.
'''Usefulness''': Questionable

==Journey to the Center of the Earth==

Construct a sturdy vessel hanging over the top of a magma pipe or volcano, outfitted with everything your intrepid crew might need for their journey of exploration - food, booze, sleeping quarters and a bridge a must, but depending on the amount of effort it can include other items such as a recreation deck, water reservoir and trade depot for dealing with the natives. When all is ready, lock the explorers inside and send them on their way. Bonus points if you can detach it from inside so you can use it in Adventure mode later.

'''Difficulty:''' Moderate to High, depending on the size of the ship. For bonus points, carve the entire thing out of existing rock overhanging a magma pipe and engrave it with messages. The main problem is getting the whole crew inside at the same time - separate sleeping quarters help here.

'''Usefulness:''' Negative. For some reason, no explorers have returned. Of course, if you select only the {{L|Nobles |Best and Brightest}} for the ship's crew...

==Labyrinth==

A maze of twisty little passages, all alike. {{L|Trap}}s and dangerous animals are essential. You can have a retracting bridge drop invaders in, or just have a labyrinth as a back door.

'''Difficulty:''' It's a lot of mining. Having a bridge drop invaders inside is more difficult, but more useful.

'''Usefulness:''' It makes a nice element of fortress defense, and you can dump your prisoners inside it. Also makes a great place to explore in {{L|adventure mode}}.

*BONUS: Generate a world with large mountain {{L|cave}}s. Instead of using the labyrinth as your backdoor, use it as your fortress.

==Magma Chamber==
'''Difficulty:''' Dangerous as any magma project.

'''Usefulness:''' It's like a drowning chamber, but any non-iron items carried by the victim will be destroyed. Depending on your style of play, this may be a good thing.

==Magma Cannon==
[http://www.bay12games.com/forum/index.php?topic=33837.0 It can be done!] It uses a row of pumps to pressurize the magma in a chamber with only one exit. When the floodgate opens, the magma flies out a short distance.

'''Difficulty:''' Very high. You need {{L|metal}} (or {{L|glass}}) {{L|screw pump}}s to make it work, {{L|magma-safe}} floodgates and mechanisms, plus a big above-ground construction.

'''Usefulness:''' Marginal. But very cool.

==Magma Mausoleum==
This trick involves dripping water on to the middle of a magma pool until you have a column of obsidian, then channeling down into the obsidian ''more than'' one Z level, and putting a burial receptacle there. This probably won't work in magma tubes or Volcanos since the created obsidian would fall into the bottomless pit. The trick is getting the water to fall onto the magma in a controlled manner. Bonus points for each additional level down you manage to place the coffin.

'''Difficulty:''' High. Requires certain resources from the start, plus lots of setup. And your dwarves tend to erupt into dwarf steam occasionally.

'''Usefulness:''' None, since an obsidian lined room with the exact same furniture somewhere else will please your nobles just as much.

==Magma Pumping==
It's a lot like pumping water, only more dangerous, and requires the {{L|screw pump|pumps}} to use {{L|magma-proof}} pipes and screws in their construction.

'''Difficulty:''' The difficult part is making all those {{L|iron}} or {{L|steel}} pumps and {{L|bauxite}} {{L|floodgate}}s. Very high risk.

'''Usefulness:''' Magma is fun, but also {{L|Fun}}.

==Mega/Water Drowning Trap-Thing==
This is basically a channel above some pressurized water with a short tunnel leading to a door. The door needs to be connected to a lever somewhere in a safe part of the fortress. Position the door facing the main stairs into your fortress (for multiple stairs use multiple traps). When enemies come down the stairs, pull the lever and make them drown. (It helps to seal off the rooms).

'''Difficulty:''' Medium. Needs flowing water under pressure and levers.

'''Usefulness:''' Medium. Depends on the size of your fortress/defences/amount of attackers. Works well with fire demons to create a sauna.

==Monumental Statue==

'''Difficulty:''' Depends on how big you want the statue to be. If you are feeling really masochistic, cast it out of obsidian using magma and water.

'''Usefulness:''' None.

*BONUS:Make the statue hollow and have dwarves live inside it.

==Moses Effect==
With enough pumps, you can pull water out of a square faster than it flows in. This can create a reverse waterfall, or a dry spot in the middle of a flowing river. The effect is like Moses parting the Red Sea.

'''Difficulty:''' Surprisingly easy.

'''Usefulness:''' You can use this trick to create a waterfall or drowning chamber. It is also important if you want to pass through an {{L|Aquifer}}, although that is far more difficult.

=={{L|Obsidian}} factory==
You need one reservoir of water, and one of magma. Mix, cool, mine, and repeat as necessary.

'''Difficulty:''' Medium.

'''Usefulness:''' Obsidian is 50% more valuable than {{L|flux}} and 3 times as valuable as ordinary stone, making it ideal for your {{L|mason}}s and {{L|stone crafter}}s. Done properly, it can also serve as a magma chamber ''and'' a drowning chamber.

==Pit o' Doom==
Combine with an Execution Tower for maximum z-level executions! Spike traps are a must.

'''Difficulty:''' Low. You want it nice and deep though.

'''Usefulness:''' Dispose of prisoners, execute nobles, gruesome fatal injuries, laugh maniacally.

==Pressure Washer==
A huge tower with floodgates at the bottom on one side. When opened, the pressurized water fires out and pushes anything in the way of the flow away. Depending on size, can be surprisingly powerful. You can see an example tower [http://mkv25.net/dfma/map-7485-griffonwind here]

'''Difficulty:''' Medium, construction technique takes some consideration.

'''Usefulness:''' Medium-High. Tested with 50 recruits standing infront of it when the floodgates opened, killed 46 of them, including ones not pushed into the pit.

BONUS: Fill it with Magma instead (though Magma doesn't pressurize).

==Rehabilitation Centre==
Had any problems with dwarves charging brainlessly towards the enemy, getting slaughtered, and then starting a tantrum spiral that will destroy your fortress? Turn your prison into a luxurious room full of things that make dwarves happy. Add artifact furniture, beds, a booze stockpile, chains made of gold (or anything valuable,) a waterfall, creatures in cages, etc. Hopefully they will return to society as a happy, productive dwarf.

'''Difficulty:''' Low-Medium. Acquiring valuable items and setting up the waterfall can be annoying sometimes. Also you need guards to actually put them in jail. And it can be a real pain when those ungrateful sobs destroy the nice furniture you give them.

'''Usefulness:''' High. A tantrum spiral can quickly turn a productive fort of 200+ dwarves into a rioting fortress inhabited by a bunch of insane, miserable dwarves who spend their time punching people and breaking furniture. Don't let it happen to you.

==Road of the Damned==
Create a giant channel filled with spike traps, 10 tiles wide and going all the way from your fort to the map edge. Pave it over with crystal glass so traders can get that forboding feeling that'll make them seal the deal without bargaining too hard!

'''Difficulty:''' None, just looks nice.

'''Usefullness:'''Low. The same as a normal road.

BONUS: Spike a goblin on every trap!

==Self Destruct Lever==
A mechanism that, for example, could flood your fort with magma, or release a trapped megabeast. For bonus points, build the whole fort on a single {{L|support}}.

'''Difficulty:''' Very high. Extremely dangerous.

'''Usefulness:''' None, by definition, but highly amusing.

=={{L|Swimming}} pool==
It's a reservoir that fills to 4/7 exactly. Station soldiers inside, lock them in, and fill. This way they gain {{L|swimming}} skill.

'''Difficulty:''' Low. It's just a pair of reservoirs.

'''Usefulness:''' The swimming skill is only slightly useful. This is most useful if the entrance to your fort has narrow walkways/moats surrounded by water, and you station your soldiers there. It does help gain attributes though.

=={{L|Tower-cap}} Farm==
You absolutely need to break into an underground river or lake. Make some muddy floors over a big area and wait.

'''Difficulty:''' Moderate. More information on it can be found {{L|Tower-cap|here}}

'''Usefulness:''' Depends on size - bigger is better.

==Town Destroyer==
Start your fortress in an area with an existing settlement. Create a channel all the way around it, then dig out everything on the Z-level below and watch it obliterate itself (and probably your framerate).

'''Difficulty:''' Low to medium. It's not hard, just very time-consuming.

'''Usefulness:''' Very low.

==Underground Perpetual Motion Power Plant==
Combine with a use for the power and you either have an awesome setup, or a ticking time bomb.

'''Difficulty:''' High. Maintaining the correct water level is annoying difficult at times.

'''Usefulness:''' Depends on size of plant and what it's connected to. Also useful as a puzzle for adventurers.

==Underwater Statue room==
A simple room filled with statues that just also happens to be flooded. Simply dig a room near to a water soure smooth and engrave the walls and floors than fill with statues. Dig a tunnel to the water source and a separate escape route. seal both off with floodgates pull the levers in the right order and bam underwater statue room. For added effect make the meeting room a room directly above with a glass floor.

'''Difficulty:'''Low.

'''Usefulness:''' Absolutely positively none.

==U.R.I.S.T. Artificial Intelligence==
Basically, a dwarf in a bunker that controls your fortress. Being that there are no supercomputers in DF at the moment, we'll have to use the closest substitute, a dwarf. Seal your dwarf in a room full of levers that activate various floodgates, bridges, doors, hatch covers, traps, etc. Make sure this room has no exits or entrances, but it needs a luxurious bedroom and dining area, and you must include a chute for dropping in <s>food</s> biomass and <s>alcohol</s> coolant fluid. Profile the levers so that they can only be used by the A.I. dwarf.

It would be a good idea to make the system into two rooms. The food/drink/bed room and the lever room. Should you need to add more levers, you can lock the A.I. dwarf outside the lever room and have your mechanics set up more levers without interacting with or releasing the A.I.

You can make the lodging room suited for the particular dwarf by adding furniture made from their favorite materials, and smoothing and engraving everything. Use quantum stockpiling to give them 10+ years of food and drink. Make sure the A.I. is unable to communicate with other dwarves. His/her mood must not be affected by the deaths of the walking meat-bags who tried to befriended him/her.

You must also make a snazzy/lame acronym name for your AI, here are some examples:
<ul>
<li>U.R.I.S.T. - Underground Reasonably Intelligent Settlement Technologist</li>
<li>N.O.B.L.E. - Narcissistic Obnoxious Boastful Laughable Excrement </li>
<li>M.A.G.M.A. - Massively Alcoholic Gear-Machine Assembly</li>
<li>A.R.M.O.K. - All-Reaching Master Of Killing</li>
<li>A.S.S. - Almost-autonomous Systems Selector</li>
<li>D.I.E.D. - Dedicated Irrigation and Everything else Device</li>

</ul>

'''Difficulty:''' Medium. Setting up all the levers and lodgings can be a micromanagement hassle. Further research is required as to how well the A.I. will fit into a dwarven economy.

'''Usefulness:''' High. Having a dwarf dedicated to pulling levers will ensure that they are pulled on time. Additionally, you will have a constantly-ecstatic dwarf who is virtually invulnerable to all threats. Should your fortress be slaughtered by invaders or drowned by flooding or tantrum spiraled, your fortress will be preserved until more migrants arrive, or the AI runs out of food.

==Vomitorium==
Prevents {{L|cave adaption}}. It's like the greenhouse, only instead of a farm, it's {{L|meeting hall}} or {{L|barracks}}. Since you can't build {{L|table}}s or {{L|bed}}s outside, build the room and {{L|channel}} down to it, or build a {{L|bridge}} or two over the top.

'''Difficulty:''' Low.

'''Usefulness:''' Low. Make sure to wall the pit in or it will become very {{L|Fun}} once {{L|goblin}} archers become involved.

40d Talk:Cross-training

2010-03-18T08:29:22Z

Darekun: /* Forest Gulag */ Paved road for wagons?

=Segregation=
It is normaly a good idea to seperate your non-cross-trained from your cross-trained, otherwise you end up with flying limbs. --[[User:Derekiv|Derekiv]] 12:13 22 December 2009 (GMT-5)

=Pump operator notes=
Not sure the toughness note is really that important. The gym is just used for dwarven stat gains, so dwarves are beefy enough to excell at whatever you throw at them. It scarcely matters how well they pump, just so long as they get to Legendary to be reassigned to the military or something else. I've noticed gym graduates make fantastic hunters for example. --[[User:ThunderClaw|ThunderClaw]] 17:47, 3 November 2008 (EST)

:Well, it makes pump-training far more effective for dwarves that are already tough: they can hit legendary in a season or two, where other dwarves take about a year. So if you have a finite number of dwarves you can spare for training, choose tough ones. Strong ones can be put in plate and made to spar, or turned into siege operators.

:Currently I'm training all my haulers, in shifts. Ones that gain toughness get to keep pumping until they're ready for the military. Strong ones get stone hauling duty. Everyone else gets food, item, or refuse duty.--[[User:Maximus|Maximus]] 20:06, 3 November 2008 (EST)

:: I now give all my haulers the custom profession ''ROTC.'' --[[User:RomeoFalling|RomeoFalling]] 07:50, 8 November 2008 (EST)

::: I've been trying cross-training, and I'm not really seeing much point at the moment. The thing is, sparring practices three skills ''at the same time'': Armor user, the weapon you're using, and shield user. The gym's rate of stat gain is almost the same as regularly sparring dwarves. And military dwarves are useful for something. [[User:Greep|Greep]] 09:05, 23 June 2009 (UTC)

::::The "point" is several - 1) that some players don't want to put non-Attribute (or at least, non-Tough) dwarves directly into sparring; 2) that some players want military with more than "one-skill-worth" of training attributes under their belts; 3) that some players want to see what the attribute mix is on a dwarf ''before'' allocating to training (vs hauling/etc); and, 4) it's ''cross''-training. Military dwarves aren't useful for anything ''but'' military - that's the "cross" part. There are several suggestions other than pump operator - use them or not - your call. --[[User:Albedo|Albedo]] 18:39, 23 June 2009 (UTC)

:::::Alright, I guess gym training just isn't for me. But as for the one skill worth of attribute training, I thought attributes continued to rise even after legendary + 5. Like an uber miner would eventually gain 16 attributes? That's what the stat page seems to indicate [[User:Greep|Greep]] 06:16, 24 June 2009 (UTC)

If you make two pumps, one above the other (Y axis, not Z), facing apposing directions, dig 2 channels at each end, making a 2X8 space, you can not only increase toughness and pump operator skill, but get happy [[waterfall]] [[thoughts]]. --[[User:Drunken dwarf|Drunken dwarf]]

=Dwarf Powered Mill notes=
Actually, it is better not to cook seeds. As seeds have quantity cap at 200 seeds for each plant, milling will not produce seeds after you hit the cap. It saves a visible amount of food hauler's work. [[User:Denspb|Denspb]] 02:58, 25 February 2009 (EST)

== Managing ==

Assigning a dwarf to manager may be even better than clerking. I had two useless dwarves. Assigned one to clerk, another to manager+broker. Disabled hauling jobs for the manager. I then went to the manager screen and queued up a full screen of "Make Soap x30." I chose soap because I don't even have an alchemist's workshop and I didn't want any jobs assigned to existing workshops and disrupting work flow. I lost track of how many times I had to go back in and cancel/re-issue the soap orders. The manager reached legendary while the clerk was still a pathetic high master. I didn't measure steps, but their offices and bedrooms were all very close together, should be around 5-10 steps difference for each dwarf to go get food/drink.

Other factors:
 -Clerk has a husband (no kids), manager is single
 -Clerk went on break at least once
 -Hauling was still enabled for the clerk, not sure if she did any jobs though
 -At the beginning, Clerk had no skills, Manager had Normal Skill Wood Carving (not much good on my treeless map)
 -Manager met with human diplomat and traded at depot during training

--[[User:Mjo625|Mjo625]] 17:18, 2 March 2009 (EST)

== Chit-chatting ==

Having no meeting halls (well rooms, statue gardens etc) at all, and just having a single 1x1 meeting area REALLY boosted my haulers stats. I might not be the most efficient assigner of work orders, but some of the time most of my haulers were out of work and just spent their time at the meeting area chatting. I had a lot of proficient-or-higher in EVERY social skill within a couple of years. This might be an exploit. Thoughts? [[User:Tardface|Tardface]] 22:53, 3 April 2009 (UTC)

: Yes and no. Chatting dwarfs make friends... and if some dies... Well, you'll have a nice domino effect. Dwarf don't like to lose friends. --[[User:Karl|Karl]] 23:12, 3 April 2009 (UTC)

:: So, dwarves will actually be happier overall if you don't let them have any friends? :) [[User:Tardface|Tardface]] 23:15, 3 April 2009 (UTC)

:::In the long-run (which inevitably includes many random deaths) yes.. very much so. Rather few, are the fortresses that can survive a death among legendary haulers, and fewer still are those than can survive several. --[[User:N9103|Edward]] 21:06, 4 April 2009 (UTC)

::::Not really. Random deaths are not exactly inevitable unless you want them to be, and party forts are pretty resilient when it comes to a couple odd deaths: everyone is racking up "talked to a friend lately" thoughts like crazy, so even if a few deaths push them down to miserable they will bounce back up to ecstatic in about a minute. The danger is that if you have more than a couple of deaths at once, the immediate surge in unhappiness may cause spontaneous insanity, which will lead to more deaths... [[User:Rpb|Rpb]] 11:09, 5 April 2009 (UTC)
:::::Thoughts don't stack on themselves, so you can only get one "talked to a friend recently" thought at one time. The wisdom of having dwarves too busy to make friends is still the best, hands down. --[[User:ThunderClaw|ThunderClaw]] 16:53, 13 July 2009 (UTC)

I stumbled on a variant of this one by accident... I'd carve out a huge dining hall(max room size in one dimension, 4 tiles in the other), stuff it full of tables and chairs(in rows) to train stoneworkers, and set a few tables of different stones as room centers. It's easy to get "ate in a legendary dining room" before the first immigrants this way. I'd then get lots of immigrants, and not really have the attention to spare, so they'd stand around chitchatting. They'd all end up ridiculously happy - it'd take a string of close friends' deaths to get them down from ecstatic, and I've never had a tantrum spiral.

I also discovered (the hard way) that these high-social-skill dwarves can fight, at least well enough to quickly wipe out an early goblin siege, even with no military skills. I think it's the speed boost from Agility. [[User:Darekun|Darekun]] 08:12, 18 March 2010 (UTC)

== Swimming ==

Has anybody considered stationing dwarves in an area with 4/7 water, thus giving them skill in swimming? Beds could be constructed in this area prior, turned into a barracks and if a food/booze stockpile is placed there aswell, the dwaves could be locked in there and would then perform all the normal sparring activities while at the same time constantly gaining swimming skill. --[[User:Overspeculated|Overspeculated]] 00:13, 26 September 2009 (UTC)
:I successfully trained dwarfs in 7/7 water before. I filled a 5x5 space one z level down from a 15x15 statue garden with water and surrounded with ramps. Although the dwarfs frequently fell in, they were never far away from the sides and thus never drowned. (Although a cow managed to drown there and create quite a funk with the miasma since no one would wade in to dump the corpse--I'm still not sure how that happened since the dwarfs had no problem with it.) [[User:3lB33|3lB33]] 01:19, 26 September 2009 (UTC)
Yes, but would military dwarves still perform sparring activities if their barracks was 4/7 under water? (where they can wade or swim) eventually raising that level once they are good enough at swimming. I'm testing it out as soon as I get my flooding mechanism done (I'm still new to this game so that takes quite a while for me) --[[User:Overspeculated|Overspeculated]] 12:58, 26 September 2009 (UTC)

== Forest Gulag ==

I have set my fortress in an area with:
# volcano
# steep "low mountain" (entrance is on top of course)
# sand
# canyon (like "Grand Canyon")
# chasm (on the "wrong side" of the Grand Canyon thankfully)
# A forest covers my side of the "Grand Canyon"
# Elephants wander through periodically, and I have some tame ones now too.

What I want to know is, what is the best way to use the forest to build experience. I'm happy to clear-fell the forest then start again from the beginning, but the fact is I am having a hard time so far keeping the wagon pathway clear as it is. I NEED MORE AXES! (getting there.)

For my non-woodcutter dwarves: what should they do with the lumber to get the most experience without making junk all over the place?

Do I make a stack of asherys, to make potash, to make clear glass "later"?
[[User:GarrieIrons|Gar]][[User Talk:GarrieIrons|rie]] 11:04, 27 September 2009 (UTC)

:Given the lack of answers to date my best bet seems to be:
:#clear-fell forest
:#Construct carpenter workshop from wood. Assign workshop to not lower skilled carpenters.
:#Build wooden weapons usable for weapon traps
:#have other dwarves constructing mechanisms
:#construct weapon traps using wooden weapons
:[[User:GarrieIrons|Gar]][[User Talk:GarrieIrons|rie]] 10:35, 7 October 2009 (UTC)
::Alternatively, if you're planning on making lots of clear glass, you can make all of the ashes into lye - you can fit 100 units of lye in a single barrel, which saves lots of storage space. Plus, you can also use the lye for making soap, if you are inclined. --[[User:Quietust|Quietust]] 12:54, 7 October 2009 (UTC)
::You can't build wooden weapon. Only the elves have the secret to build them without hurting trees... Damn hippies. Yet you could build menacing wooden spikes or stuff like that... but... Wood only do half damage, so it's a waste of wood and your trap are not going to be really effective. You could instead do it with glass, a lot more step needed to have the same result, but it's way more fun, and you can build a lot of stuff from clear glass.
:: Since there's a limit to the number of tree you can fell, and since they don't grow fast enough (if you have 5-10 good woodcutters) you should had more step in the process to use a lot of dwarf, hence the clear glass production.
:: By the way, obsidian and wood make good rock sword, and it's as good as steel, if you have access to water, you could build an obsidian farm. --[[User:Karl|Karl]] 15:00, 7 October 2009 (UTC)

:::This is ideas for a forest gulag as such they don't have to be practical!
:::While wooden weapons are not very efficient, if you can make a stack of them out in the boonies then all you have to cart in from underground is 1 mechanism per trap. So your (gulag) treecutter cuts down 10 trees per trap, your (gulag) carpenter makes 10 wooden spikes per trap, and your mechanic (knowing my fortresses, my ONLY mechanic) makes traps once some other poor sot drages the mechnisms out there. With a nice little wooden fence to restrict pathing a few weapon traps even with wooden spikes should do SOMETHING shouldn't they?
:::My three treecutters aren't keeping the boundary of 1/2 of my map clear of trees, let alone clear felling the entire map. These guys are full-time treecutters! '''Waste of wood''' is relative to the map, it is better (safer, less hauling) to ask for wood and sell traders the clothes from the invaders to actually get wood into the fortress (1 silk shirt buys 200 or so logs!).
:::[[User:GarrieIrons|Gar]][[User Talk:GarrieIrons|rie]] 11:11, 16 October 2009 (UTC)
::::I have had very good results with spiked wooden balls. A trap containing 10 of them almost always kills a goblin in one hit. A bottleneck containing a few rows of such traps can easily cripple a goblin siege before it even gets near your fortress. --[[User:LaVacaMorada|LaVacaMorada]] 11:49, 16 October 2009 (UTC)
::::You can use the wood to pave a road for the wagons. That'll suck up material pretty good, and keep the wagon pathway clear, but train a carpenter. Personally, I can never get enough charcoal, but I'm metal-happy. [[User:Darekun|Darekun]] 08:29, 18 March 2010 (UTC)

40d Talk:Cross-training

2010-03-18T08:12:58Z

Darekun: /* Chit-chatting */ Do it in a huge dining hall for great happiness?

40d:Creature token

2009-10-04T22:30:08Z

Darekun: /* I */ Fixed link to Material tokens.

Everything here can be applied to all creature files, e.g. creature_domestic, creature_standard, even creature_equipment. This includes sentient creatures, but creature [[tokens]] should not be confused with [[Entity_tokens|entity tokens]].

Since the game is in the Alpha stage, consider everything '''tentative'''.

{| id="toc"
|
* Tokens
** [[#A|A]] [[#B|B]] [[#C|C]] [[#D|D]] [[#E|E]] [[#F|F]] [[#G|G]] [[#H|H]] [[#I|I]] [[#J|J]] [[#K|K]] [[#L|L]] [[#M|M]]
** [[#N|N]] [[#O|O]] [[#P|P]] [[#Q|Q]] [[#R|R]] [[#S|S]] [[#T|T]] [[#U|U]] [[#V|V]] [[#W|W]] [[#X|X]] [[#Y|Y]] [[#Z|Z]]
|}
__NOTOC__

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

|-
| ADD_VERSION
| version
| In which version of the game said creature was introduced. Not used anymore in the 3D version.
[ADD_VERSION:1069]

|-
| 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
| [[Character Table|CP437 ordinal]] or 'character'
| If set, the creature will blink between its [TILE] and its [ALTTILE].
[ALTTILE:157] or [ALTTILE:'&']

|-
| AMBUSHPREDATOR
|
| Makes the creature start out hidden. Used by giant cave spiders. May make webs hidden too?

|-
| AMPHIBIOUS
|
| Allows a creature to breathe with or without water.

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

|-
| ATTACK
|
| See the [[#Attacks|Attacks section]].

|}

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

|-
| BABY
| age
| Age at which a baby becomes a child. Without this tag, all creatures born will skip the baby stage and be children upon birth.
[BABY:1]

|-
| BEACH_FREQUENCY
| value
| Whales and jellyfish have this. Controls the beaching frequency of the creature.
[BEACH_FREQUENCY:10]

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

|-
| BIOME:*
|
| See [[Biome Tokens|biome tokens]].

|-
| BLOODTYPE
| type
| Sets the creatures' blood type (default red):
*R - Red blood
*G - Green blood
*B - Blue blood
*M - Magenta blood
*C - Cyan blood
*Y - Yellow pus
*W - White ichor
*0 - Black goo
*VOMIT
*SLIME
[BLOODTYPE:0]

|-
| [[Body_tokens|BODY]]
| parts[:...]
| Sets the body parts a creature has. Can supply as many as you want.
[BODY:HUMANOID:2EYES:2EARS]

|-
| [[Bodygloss|BODYGLOSS]]
| gloss
| A body_default.txt function. It replaces a part's description with another. e.g. feet with hooves.
[BODYGLOSS:HOOF]

|-
| BOILING_POINT
| temperature
| The temperature at which the creature boils into goo. [[Temperature scale|DF temperature scale]]

|-
| BONE_BOILING_POINT
| temperature
| The boiling point of the creature's bones.

|-
| BONE_COLDDAM_POINT
| temperature
| The low temperature at which the creature's bones start getting damaged.

|-
| BONE_FIXED_TEMP
| temperature
| The temperature that the creature's bones give off.

|-
| BONE_HEATDAM_POINT
| temperature
| The high temperature where the bones start taking damage.

|-
| BONE_IGNITE_POINT
| temperature
| The temperature at which point the creature's bones burst into flame.

|-
| BONE_MELTING_POINT
| temperature
| The temperature at which the creature's bones melt.

|-
| [[Creature_Tokens/SPEC_HEAT|BONE_SPEC_HEAT]]
| not a temperature
| Specific heat? (temperature difference required to change the temperature of the creature's bones?) {{verify}}

|-
| BONECARN
|
| Creature 'eats' bones. Eating bones makes their happiness go up, but can cause death (suffocation). This tag implies CARNIVORE.

|-
| BUILDINGDESTROYER
| value
| Allows a creature to destroy furniture and buildings. Value [1] targets mostly doors, hatches, furniture and the like. Value [2] targets anything not made with the {{k|b}} + {{k|C}} commands.
See [[Building destroyer]] for full discussion.

|-
| BUTCHERABLE_NONSTANDARD
|
| (old) If a creature has this tag, it may only be slaughtered (that is, the live creature is taken to the [[Butcher's Shop]] and slain). If it dies of any other cause, the corpse cannot be butchered.

|}

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

|-
| CAN_CIV
|
| Can create civilizations. This tag may activate hunger and thirst. {{verify}}

|-
| CAN_LEARN
|
| A creature with this tag can gain skill experience.

|-
| CAN_SPEAK
|
| Can talk.

|-
| CANNOT_UNDEAD
|
| Cannot become undead.

|-
| CARNIVORE
|
| Creature only eats meat.

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

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

|-
| CHEESE_BOILING_POINT
| temperature
| The temperature at which the creature's cheese (if any) boils away.

|-
| CHEESE_COLDDAM_POINT
| temperature
| The temperature at which the creature's cheese (if any) starts taking cold damage.

|-
| CHEESE_FIXED_TEMP
| temperature
| The temperature emitted by one unit of the creature's cheese (if any).

|-
| CHEESE_HEATDAM_POINT
| temperature
| The temperature at which the cheese made from the creature's milk starts taking heat damage.

|-
| CHEESE_IGNITE_POINT
| temperature
| The temperature at which the creature's cheese bursts into flame.

|-
| CHEESE_MELTING_POINT
| temperature
| The temperature at which the creature's cheese melts into goo.

|-
| [[Creature_Tokens/SPEC_HEAT|CHEESE_SPEC_HEAT]]
| not a temperature
| Specific heat? (temperature difference required to change the temperature of the creature's cheese?) {{verify}}

|-
| CHEESE_VALUE
| value
| The value per unit of cheese made from the creature's milk (if applicable). Note that only vermin as of current can be milked.

|-
| CHILD
| age
| Age at which a child becomes an adult.
[CHILD:12]

|-
| CHILDNAME
|
* singular
* plural
| Gives the child a special name, eg "hippo calf" instead of "hippo child".
[CHILDNAME:hippo calf:hippo calves]

|-
| CHITIN
|
| When the creature is butchered, it drops chitin, which functions as leather.

|-
| CRAFTSMAN_NAME
|
* singular
* plural
| Sets the name of the craftsman profession.
[CRAFTSMAN_NAME:craftsdwarf:craftsdwarves]

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

|-
| CLUSTER_NUMBER
|
* minimum
* maximum
| The minimum/maximum numbers of how many creatures per spawned cluster.
[CLUSTER_NUMBER:1:3]

|-
| COLOR
|
* fg (foreground)
* bg (background)
* br (brightness)
| [[Color]] of the creature's tile.
[COLOR:3:0:0]

|-
| COOKABLE_LIVE
|
| Set this to allow the creature to be cooked in meals without having to butcher it first.

|-
| CREATURE
| name
| What the game looks for when generating creatures.
[CREATURE:DWARF]

|-
| COLDDAM_POINT
| temperature
| The minimum temperature limit before the creature starts taking damage from freezing.

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

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

|-
| CURIOUSBEAST_ITEM
|
| Allows a creature to steal things (apparently the highest [[value]] it can find).

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

|}

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

|-
| DAMBLOCK
| value
| How much natural armor a creature has. Can be set to negative numbers, so the creature takes more damage than usual.
[DAMBLOCK:1]

|-
| DEFENDER
|
| Appears from the glowing pits in a group.

|-
| DIFFICULTY
| number
| [[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.
[DIFFICULTY:2]

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

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

|-
| DRINK_BOILING_POINT
| temperature
| The temperature at which a drink (milk?) produced from the creature will boil.

|-
| DRINK_COLDDAM_POINT
| temperature
| The temperature at which said drink will take cold damage.

|-
| DRINK_FIXED_TEMP
| temperature
| The temperature emitted by one unit of the creature's drink (if any).

|-
| DRINK_HEATDAM_POINT
| temperature
| The temperature at which aforementioned drink will take heat damage.

|-
| DRINK_IGNITE_POINT
| temperature
| The temperature at which the drink will set your fort ablaze.

|-
| DRINK_MELTING_POINT
| temperature
| [[User:GreyMario]] sez: "Isn't this, like, redundant? It's ''already'' liquid. Perhaps it controls at which point the drink solidifies?" {{verify}}

|-
| [[Creature_Tokens/SPEC_HEAT|DRINK_SPEC_HEAT]]
| not a temperature
| The difference in temperature required to modify the temperature of the drink? {{verify}}

|}

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

|-
| ENDING
|
| Will show up as a leader (only one of them) in a group from the glowing pits.

|-
| EQUIPMENT_WAGON
|
| Implies two unknown flags, NOSTUN, NONAUSEA, NOBLEED, NOEMOTION, NOSTUCKINS, SEVERONBREAKS, NOSKULL, NOSKIN, NOBONES, NOMEAT, PARALYZEIMMUNE, NOFEAR, NOSMELLYROT, NOTHOUGHT, NO_GENDER.

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

|-
| EVIL
|
| Determines whether creature can show up on "evil" maps (see [[Region#Surroundings]]).

|-
| EXTRACT
|
* name
* fg (foreground color)
* bg (background color)
* br (color brightness)
| Determines that something can be extracted from the creature, what it's called, and what [[color]] it is. Note, it appears that the extraction process is hard-coded into the game, and can't be altered from objects/raw.
[EXTRACT:cow's milk:7:0:1]

|-
| EXTRACT_ANTIDOTE
|
* name
* fg (foreground color)
* bg (background color)
* br (color brightness)
* ? (always 50 or 100)
| [EXTRACT_ANTIDOTE:cave spider antivenin:7:0:0:50]

|-
| EXTRACT_BOILING_POINT
| temperature
| The temperature value at which a unit of the creature's extract boils away.

|-
| EXTRACT_CHEESE
|
* name
* fg (foreground color)
* bg (background color)
* br (color brightness)
| The extract gotten from the creature can be made into cheese.
[EXTRACT_CHEESE:cow cheese:6:0:1]

|-
| EXTRACT_COOKABLE
|
| Extract is cookable.

|-
| EXTRACT_COLDDAM_POINT
| temperature
| The low temperature value at which the creature's extract starts to take damage.

|-
| EXTRACT_FIXED_TEMP
| temperature
| The temperature that the creature's extract generates on its own.

|-
| EXTRACT_HEATDAM_POINT
| temperature
| The high temperature value at which the creature's extract starts to take damage.

|-
| EXTRACT_IGNITE_POINT
| temperature
| The temperature at which the creature's extract bursts into flame (NOT the container it's in).

|-
| EXTRACT_MELTING_POINT
| temperature
| The temperature at which the creature's extract melts into goo.

|-
| EXTRACT_PARALYZE
|
| (conjectural) Extract is poisonous, causing paralysis that lasts until the extract wears off. Can be delivered by SPECIALATTACK_INJECT_EXTRACT.

|-
| EXTRACT_PARALYZE_INTERMITTENT
|
| (conjectural) Extract is poisonous, causing paralysis on occasional intervals until the extract wears off. Can be delivered by SPECIALATTACK_INJECT_EXTRACT.

|-
| EXTRACT_PERMANENT
|
| (conjectural) The effects of the creature's extract are permanent once applied and do not wear off naturally.

|-
| EXTRACT_SIZE
| size
|
[EXTRACT_SIZE:10]

|-
| [[Creature_Tokens/SPEC_HEAT|EXTRACT_SPEC_HEAT]]
| not a temperature
| The difference in temperature required to modify the temperature of the creature's extract? {{verify}}

|-
| EXTRACT_STUN
|
| (conjectural) Extract is poisonous, causing a permanent stun effect until the extract wears off. Can be delivered by SPECIALATTACK_INJECT_EXTRACT.

|-
| EXTRACT_STUN_INTERMITTENT
|
| (verified) Extract is poisonous, causing temporary stuns on semi-occasional intervals. Can be delivered by SPECIALATTACK_INJECT_EXTRACT.

|-
| EXTRACT_VALUE
| value
| The value per unit of the creature's extract.
[EXTRACT_VALUE:20]

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

|}

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

|-
| FAT
| value
| How much fat a creature produces when it is butchered.
[FAT:3]

|-
| FEATURE_ATTACK_GROUP
|
| pretty worthless now. It was very important in the 2-dimensional DF.

|-
| FEMALE
|
| The creature is always female. Note that a civilization created using an all-female creature will have no population, as they don't have breeding couples.

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

|-
| FIREIMMUNE
|
| The creature is immune to all forms of fire, except DRAGONFIREBREATH.

|-
| FIREIMMUNE_SUPER
|
| The creature is immune to DRAGONFIREBREATH. AI acts as if FIREIMMUNE. Does NOT imply FIREIMMUNE.

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

|-
| FIXED_TEMP
| temperature
| The natural heat generated by the creature. [FIXED_TEMP:1-?]

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

|-
| FLIER
|
| Allows a creature to fly. Currently, an AI bug prevents this from being useful on PC races in fortress mode.

|-
| FREQUENCY
| time
| Determines the time between creature spawns in Fortress Mode. Higher is more occurrences per time unit{{verify}}. Creatures without a frequency statement appear to be on the map at all times. Almost all others have either [FREQUENCY:5] or [FREQUENCY:100]. "High frequency means you get more when the number is high, so 100 would be the most common. If you don't enter a number, it uses 50."
[FREQUENCY:42]

|}

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

|-
| GENPOWER
| rate?
| Not used anymore and can be removed safely. Was related to magic.
[GENPOWER:3]

|-
| GLOWCOLOR
|
* fg
* bg
* br
| The colour of the GLOWTILE of the creature (see below).

[GLOWCOLOR:4:0:1]

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

[GLOWTILE:'"']

|-
| GNAWER
|
| The creature chews on food storage containers.

|-
| GOOD
|
| Determines whether creature can show up on "good" maps (see [[Creatures#Threat Matrix|Threat Matrix]]).

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

|}

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

|-
| HAS_RACEGLOSS
| gloss
| Links a material glossary to the creature. It is hardcoded, and there is only 4 types of tag.
[HAS_RACEGLOSS:WOOD]
[HAS_RACEGLOSS:STONE]
[HAS_RACEGLOSS:METAL]
[HAS_RACEGLOSS:PLANT]

|-
| HASSHELL
|
| Creature will leave behind a shell when eaten.

|-
| HEATDAM_POINT
| temperature
| The maximum temperature limit before the creature will start recieving damage from heat. [[Temperature scale|DF temperature scale]]

|-
| HOMEOTHERM
| value
| Default 'NONE'. The creature's normal body temperature. Combined with LAYERING, sets the temperature range under which it can live. [[Temperature scale|DF temperature scale]]

|-
| HORN
|
| Creature drops a horn or horns when butchered, which presumably acts like bone. This tag is broken.

|}

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

|-
| IGNITE_POINT
| temperature
| The temperature at which the creature will burst into flames. [[Temperature scale|DF temperature scale]]

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

|-
| IMMOBILE_LAND
|
| The creature is immobile while on land

|-
| INTELLIGENT
|
| Implies CAN_CIV, CAN_SPEAK, CAN_LEARN.

|-
| ITEMCORPSE
|
* [[Item Tokens|item token]]
* subtype
NO_SUBTYPE
* [[Matgloss_tokens|matgloss token]]
* NO_RACEGLOSS
USE_RACEGLOSS
USE_SHARPSTONE
| Determines if the creature leaves behind a non-standard corpse (i.e. wood, statue, bars, etc). The first parameter determines the item type; the second parameter is the subtype indicated in the raw file (such as WEAPON_WHIP); the third indicates the material type if the item type takes a specific material (e.g. "IRON" if the corpse type is "STATUE"). USE_RACEGLOSS applies if the creature has a material glossary assigned by the "HAS_RACEGLOSS:" flag and will select neccesary adjectives and material from that glossary.
[ITEMCORPSE:[[Item Tokens|WOOD]]:NO_SUBTYPE:[[Material tokens|WOOD]]:USE_RACEGLOSS]

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

|-
| IVORY
|
| Creature will produce ivory when butchered. Currently doesn't work. May turn up with merchants as a trade good.

|}

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

|-
| LARGE_CAVERIVER
|
| In Fortress Mode, spawns from/near cave rivers.

|-
| LARGE_CHASM
|
| In Fortress Mode, spawns from/near chasms.

|-
| LARGE_LAVA
|
| In Fortress Mode, spawns from/near magma.

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

|-
| LAYERING
| value
| How well-protected the creature is from low temperatures. If this number is too high, it will confine a creature to only arctic areas. If it is even higher it will prevent the creature from spawning at all. Tropical animals have this at 100. Tundra creatures, 200 or 300; humans 10, dwarves 50.

|-
| LEATHER_BOILING_POINT
| temperature
| The temperature at which leather made from the creature's skins will boil away.

|-
| LEATHER_COLDDAM_POINT
| temperature
| The temperature at which leather made from the creature's skins will take damage.

|-
| LEATHER_FIXED_TEMP
| temperature
| The temperature that leather made from the creature's skins generates.

|-
| LEATHER_HEATDAM_POINT
| temperature
| The temperature at which leather made from the creature's skins will take damage.

|-
| LEATHER_IGNITE_POINT
| temperature
| The temperature at which leather made from the creature's skins will burst into flames.

|-
| LEATHER_MELTING_POINT
| temperature
| The temperature at which leather made from the creature's skins will melt away.

|-
| [[Creature_Tokens/SPEC_HEAT|LEATHER_SPEC_HEAT]]
| not a temperature
| The difference in temperature required to modify the temperature of the creature's leather? {{verify}}

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

|-
| LIKES_FIGHTING
|
|

|-
| 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. Implies [TRAPAVOID]

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

|}

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

|-
| MAGICAL
|
| Makes the creature attract local wildlife in large numbers. May have more effects when magic is implemented.

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

|-
| MALE
|
| The creature is always male. Note that a civilization created using an all-male creature will have no population, as they don't have breeding couples.

|-
| MATERIAL
|
* [[Matgloss_tokens|Matgloss token]]
* USE_RACEGLOSS
|

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

|-
| MAXAGE
|
* minimum
* maximum
| Sets the Min Max age for a creature. Used in world generating and Fortress Mode.
[MAXAGE:150:170]

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

|-
| MEGABEAST
|
| Appears on fortress territory in Fortress Mode occasionally. Implies SEMIMEGABEAST.

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

|-
| MILKABLE
| frequency?
| Allows the creature to be milked. Currently only works with vermin creatures.

|-
| MISCHIEVIOUS
|
| Will pull any levers it comes across (requires confirmation). "They go on little missions to mess with various fortress buildings, not just levers."

|-
| MODVALUE
| number
| Multiplies the value of items made from the creature by the number in the tag.
[MODVALUE:2]

|-
| MOUNT
|
| Allows the creature to be mounted. Currently only works with siegers. The same AI bug that causes issues with [FLIER] PC races in fortress mode causes worse issues with flying mounts, though when unmounted the creature will fly just fine. [SWIMS_INNATE] may or may not have similar issues on mounts.

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

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

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

|}

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

|-
| NAME
|
* singular noun
* plural noun
* adjective
| What the creature is actually called in game. Make sure there is no space around the ":".
[NAME:dwarf:dwarves:dwarven]

|-
| NARROW
|
| The creature can only wear things that have the narrow tag on it.

|-
| NATURAL
|
| Animal

|-
| NO_AUTUMN
|
| Will not show up during the Autumn season.

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

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

|-
| NO_GENDER
|
| No gender will be selected for the creature. Note that a civilization created using a genderless creature will have no population, as they don't have breeding couples.

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

|-
| NO_SPRING
|
| Will not show up during the Spring season.

|-
| NO_SUMMER
|
| Will not show up during the Summer season.

|-
| NO_WINTER
|
| Will not show up during the Winter season.

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

|-
| NOBLEED
|
| Creature doesn't bleed.

|-
| NOBONES
|
| Creature will not drop bones on butcher, rot, or decay of severed body parts.

|-
| 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
|
| Creatures' corpse does not create miasma.

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

|-
| NOSTUN
|
| Creature can't be stunned.

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

|-
| NOT_BUTCHERABLE
|
| Creature can't be butchered.

|}

==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
|
| Flies in a semi-predictable pattern? {{verify}}

|-
| 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 greater than the penetrate power, their contents escape for the time being. Other objects roll a 0-99.

|-
| PERSONALITY
|
* token
* lowest % chance
* median
* highest % chance
| Determines chance of personality traits. Standard is 0:50:100. See [[Personality traits]] for more info.
[PERSONALITY:IMAGINATION:0:55:100]

|-
| 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:42]

|-
| POPULATION_NUMBER
|
* minimum
* maximum
| The minimum/maximum numbers of how many of these creatures can show up on a map per year.
[POPULATION_NUMBER:42:42]

|-
| POWER
|
| Allows the creature to be worshiped by entities with the RELIGION:ANY_APPROPRIATE_POWER tag.

|-
| PREFSTRING
| object
| Sets what other creatures like about this creature. "Blarghh likes dwarves for their beards."
[PREFSTRING:beards]
Multiple entries will be chosen from at random.

|}

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

|-
| REMAINS
| <''singular''>:<''plural''>
| ??? Used by treants along with [REMAINS_UNDETERMINED], appears to change the name of a creatures remains.

|-
| REMAINS_COLOR
|
* fg
* bg
* br
| The color of the creature's remains. Used by treants.

[REMAINS_COLOR:6:0:0]
|-
| REMAINS_UNDETERMINED
|
|

|}

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

|-
| SEMIMEGABEAST
|
| Appears as boss creature in quests.

|-
| SESSILE_LAND
|
| Obsolete. Use [[#I|[IMMOBILE_LAND]]].

|-
| SEVERONBREAKS
|
| Limbs and body parts sever on breakage.

|-
| SILK_BOILING_POINT
| temperature
| Temperature at which silk made from this creature's webs boils away.

|-
| SILK_COLDDAM_POINT
| temperature
| Temperature at which silk made from this creature's webs takes damage.

|-
| SILK_FIXED_TEMP
| temperature
| Temperature generated by the creature's web silk.

|-
| SILK_HEATDAM_POINT
| temperature
| Temperature at which silk made from this creature's webs takes damage.

|-
| SILK_IGNITE_POINT
| temperature
| Temperature at which silk made from this creature's webs bursts into flame.

|-
| SILK_MELTING_POINT
| temperature
| Temperature at which silk made from this creature's webs melts away.

|-
| [[Creature_Tokens/SPEC_HEAT|SILK_SPEC_HEAT]]
| not a temperature
| The difference in temperature required to modify the temperature of the creature's silk? {{verify}}

|-
| SIZE
| value
| How big a creature is. 6 is for dwarf like creatures, 7 is for human like creatures. 16 is for giants. Larger creatures are far more dangerous in combat. Also equals the amount of Meat/Chunks/Bones you get from the beast. Creatures with a size larger than 10 will prevent [[bridge]]s from raising or retracting and will cause a [[Dwarven Atom Smasher]] to deconstruct.
[SIZE:6]

|-
| SLOW_LEARNER
|
| Presumably similar to [CAN_LEARN], but slower. Present in the entries for ogres and giants

|-
| SMALLAQUATIC_CAVERIVER
|
|

|-
| SMALLAQUATIC_OCEAN
|
|

|-
| SMALLAQUATIC_RIVER
|
|

|-
| SMALLAQUATIC_SWAMP
|
|

|-
| SMALL_REMAINS
|
| If a creature has this token, it'll leave a small corpse that only rots once, such as vermin.

|-
| SPECNAME
|
*token
*singular noun
*plural noun
*adjective
| Sets a special name for certain instances.
[SPECNAME:MALE:bull:bulls:bull]

|-
| [[Creature_Tokens/SPEC_HEAT|SPEC_HEAT]]
| not a temperature
| The specific heat of a creature? {{verify}}
[SPEC_HEAT:409]

|-
| SPEECH
| filename
| Sets what speech.txt to use when insulting the creature.
[SPEECH:dwarf.txt]

|-
| SPEECH_MALE
| filename
| Used in place of [SPEECH] for humans; perhaps sets the speech.txt to use for males only? Humans don't have a corresponding [SPEECH_FEMALE] token, though, which only occurs in the [[string dump]].
[SPEECH_MALE:human_male.txt]

|-
| 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 [[Speed]] for more information.
[SPEED:400]

|-
| SPHERE
| [[sphere]]
| Sets what religious spheres the creature is aligned to, for purposes of being worshipped via the [POWER] token. By default, only used by [[Demon|hidden fun stuff]].

|-
| STOUT
|
| Clothing width, similar to NARROW. If you have STOUT humans they will have "stout" inventory prefixes. Perhaps also: Creature has a resistance to being knocked over.

|-
| STANDARD_FLESH
|
|

|-
| 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 must learn to swim. Requires [CAN_LEARN], obviously.

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

|}

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

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

|-
| TILE
| CP437 ordinal or 'character'
| The graphical representation of the creature.
[TILE:157] or [TILE:'&']

|-
| TRADE_CAPACITY
| weight
| How much the creature can carry when used by merchants.
[TRADE_CAPACITY:2000]

|-
| TRAINABLE
|
| Allows a tame creature to be trained into a "War" or "Hunting" variation by way of [[Kennels]].

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

|-
| TRAPAVOID
|
| The creature is immune to traps.

|-
| TRIGGERABLE_GROUP
|
* minimum?
* maximum?
| [TRIGGERABLE_GROUP:5:50]

|}

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

|-
| UNDERSWIM
|
| Creature swims under the water and can't be seen.
|-
| UTTERANCES
|
| Changes the language of the creature into an unintelligible mess.

|}

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

|-
| VEGETATION
|
|

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

|-
| VERMIN_BITE
|
* amount injected or chance of injection?
* name
* effect (USE_EXTRACT)
| [VERMIN_BITE:10:bitten:USE_EXTRACT]
On very rare occasions, someone who remains in the same tile as this creature will be bitten by that creature, and the effect will be applied to the offender. Used by (tiny) cave spiders to inject their venom into the occasional dwarf.

|-
| VERMIN_EATER
|
| The creature can eat your food.

|-
| 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. – [[User:Peristarkawan|Peristarkawan]] 17:27, 24 May 2007 (EDT)

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

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

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

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

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

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

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

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

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

|-
| VIEWRANGE
| value
| How far the creature can see?

|}

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

|-
| WAGON_PULLER
|
| Allows the creature to pull caravan wagons.

|-
| WEBBER
|
| The creature will create webs. It also seems to make creatures flying. More testing is needed.

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

|}

=Attacks=
{| {{prettytable}}
|- bgcolor="#ddd"
!width="50"|Tag
!width="225"|What It Does

|-
|[ATTACK:MAIN:BYTYPE:GRASP:punch:punches:1:2:BLUDGEON][ATTACKFLAG_WITH]

''Format:''
[ATTACK:''priority'':(BYTYPE:''type'' || BYTOKEN:''bodypart''):''"verb"'':''"conjugate verb"'':''min dmg'':''max dmg'':''dmg type'']([(ATTACKFLAG_WITH || ATTACKFLAG_CANLATCH)])([SPECIALATTACK_INJECT_EXTRACT:''min'':''max''])
|Sets what natural attacks a creature has.

|-
|MAIN
SECOND
|''MAIN'': Sets the attack to act as the creatures' main attack.
''SECOND'': The creature will only use this attack if it can't use the MAIN attack(s).

|-
|BYTYPE:GRASP
BYTOKEN:TAIL_STINGER
|''BYTYPE'': Sets what body part type to use for the attack. Possible values for "type" are GRASP, MOUTH, STANCE, THOUGHT, BREATHE, and the like. See [[Body Tokens]].
''BYTOKEN'': Sets the explicit body part ID to use for the attack. The token must exist as part of the creature's [[Creature Tokens#B|BODY]] token.

|-
|punch:punches
|Sets the verb for the attack.

|-
|1:2
|Sets the Min Max for the damage.

|-
|BLUDGEON, PIERCE, SLASH, GORE, BURN, HEAT, COLD
|Sets the damage type for the attack.

|-
|[ATTACKFLAG_WITH]
|Attacks in combat inform which body part was used in the attack.
"Ratman punches Blargg with his right hand."

|-
|[ATTACKFLAG_CANLATCH]
|Allows the creature to latch on with the attack. "Crocodile latches on Blargg's head firmly."

|-
|[SPECIALATTACK_INJECT_EXTRACT:50:100]
|The creature injects an amount of its extract into a victim upon successfully using this attack. The significance of the amount is unknown (but probably determines duration before the extract wears off).

|-
|[SPECIALATTACK_SUCK_BLOOD:50:100]
|When blood is drained from a creature, it causes heavy bleeding (depending on the attacking creatures ability to suck blood). It's unknown if blood suckers feed or regain health while doing this. (Numbers affect amount of blood drawn? / Effectiveness?)
|}

[[Category:Modding]]
[[Category:Tokens]]

40d:Creature token

2009-10-04T22:01:36Z

Darekun: /* E */ Listed extract colors. (They were listed as value and two unknowns, despite the presence of value tokens.)

Everything here can be applied to all creature files, e.g. creature_domestic, creature_standard, even creature_equipment. This includes sentient creatures, but creature [[tokens]] should not be confused with [[Entity_tokens|entity tokens]].

Since the game is in the Alpha stage, consider everything '''tentative'''.

{| id="toc"
|
* Tokens
** [[#A|A]] [[#B|B]] [[#C|C]] [[#D|D]] [[#E|E]] [[#F|F]] [[#G|G]] [[#H|H]] [[#I|I]] [[#J|J]] [[#K|K]] [[#L|L]] [[#M|M]]
** [[#N|N]] [[#O|O]] [[#P|P]] [[#Q|Q]] [[#R|R]] [[#S|S]] [[#T|T]] [[#U|U]] [[#V|V]] [[#W|W]] [[#X|X]] [[#Y|Y]] [[#Z|Z]]
|}
__NOTOC__

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

|-
| ADD_VERSION
| version
| In which version of the game said creature was introduced. Not used anymore in the 3D version.
[ADD_VERSION:1069]

|-
| 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
| [[Character Table|CP437 ordinal]] or 'character'
| If set, the creature will blink between its [TILE] and its [ALTTILE].
[ALTTILE:157] or [ALTTILE:'&']

|-
| AMBUSHPREDATOR
|
| Makes the creature start out hidden. Used by giant cave spiders. May make webs hidden too?

|-
| AMPHIBIOUS
|
| Allows a creature to breathe with or without water.

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

|-
| ATTACK
|
| See the [[#Attacks|Attacks section]].

|}

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

|-
| BABY
| age
| Age at which a baby becomes a child. Without this tag, all creatures born will skip the baby stage and be children upon birth.
[BABY:1]

|-
| BEACH_FREQUENCY
| value
| Whales and jellyfish have this. Controls the beaching frequency of the creature.
[BEACH_FREQUENCY:10]

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

|-
| BIOME:*
|
| See [[Biome Tokens|biome tokens]].

|-
| BLOODTYPE
| type
| Sets the creatures' blood type (default red):
*R - Red blood
*G - Green blood
*B - Blue blood
*M - Magenta blood
*C - Cyan blood
*Y - Yellow pus
*W - White ichor
*0 - Black goo
*VOMIT
*SLIME
[BLOODTYPE:0]

|-
| [[Body_tokens|BODY]]
| parts[:...]
| Sets the body parts a creature has. Can supply as many as you want.
[BODY:HUMANOID:2EYES:2EARS]

|-
| [[Bodygloss|BODYGLOSS]]
| gloss
| A body_default.txt function. It replaces a part's description with another. e.g. feet with hooves.
[BODYGLOSS:HOOF]

|-
| BOILING_POINT
| temperature
| The temperature at which the creature boils into goo. [[Temperature scale|DF temperature scale]]

|-
| BONE_BOILING_POINT
| temperature
| The boiling point of the creature's bones.

|-
| BONE_COLDDAM_POINT
| temperature
| The low temperature at which the creature's bones start getting damaged.

|-
| BONE_FIXED_TEMP
| temperature
| The temperature that the creature's bones give off.

|-
| BONE_HEATDAM_POINT
| temperature
| The high temperature where the bones start taking damage.

|-
| BONE_IGNITE_POINT
| temperature
| The temperature at which point the creature's bones burst into flame.

|-
| BONE_MELTING_POINT
| temperature
| The temperature at which the creature's bones melt.

|-
| [[Creature_Tokens/SPEC_HEAT|BONE_SPEC_HEAT]]
| not a temperature
| Specific heat? (temperature difference required to change the temperature of the creature's bones?) {{verify}}

|-
| BONECARN
|
| Creature 'eats' bones. Eating bones makes their happiness go up, but can cause death (suffocation). This tag implies CARNIVORE.

|-
| BUILDINGDESTROYER
| value
| Allows a creature to destroy furniture and buildings. Value [1] targets mostly doors, hatches, furniture and the like. Value [2] targets anything not made with the {{k|b}} + {{k|C}} commands.
See [[Building destroyer]] for full discussion.

|-
| BUTCHERABLE_NONSTANDARD
|
| (old) If a creature has this tag, it may only be slaughtered (that is, the live creature is taken to the [[Butcher's Shop]] and slain). If it dies of any other cause, the corpse cannot be butchered.

|}

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

|-
| CAN_CIV
|
| Can create civilizations. This tag may activate hunger and thirst. {{verify}}

|-
| CAN_LEARN
|
| A creature with this tag can gain skill experience.

|-
| CAN_SPEAK
|
| Can talk.

|-
| CANNOT_UNDEAD
|
| Cannot become undead.

|-
| CARNIVORE
|
| Creature only eats meat.

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

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

|-
| CHEESE_BOILING_POINT
| temperature
| The temperature at which the creature's cheese (if any) boils away.

|-
| CHEESE_COLDDAM_POINT
| temperature
| The temperature at which the creature's cheese (if any) starts taking cold damage.

|-
| CHEESE_FIXED_TEMP
| temperature
| The temperature emitted by one unit of the creature's cheese (if any).

|-
| CHEESE_HEATDAM_POINT
| temperature
| The temperature at which the cheese made from the creature's milk starts taking heat damage.

|-
| CHEESE_IGNITE_POINT
| temperature
| The temperature at which the creature's cheese bursts into flame.

|-
| CHEESE_MELTING_POINT
| temperature
| The temperature at which the creature's cheese melts into goo.

|-
| [[Creature_Tokens/SPEC_HEAT|CHEESE_SPEC_HEAT]]
| not a temperature
| Specific heat? (temperature difference required to change the temperature of the creature's cheese?) {{verify}}

|-
| CHEESE_VALUE
| value
| The value per unit of cheese made from the creature's milk (if applicable). Note that only vermin as of current can be milked.

|-
| CHILD
| age
| Age at which a child becomes an adult.
[CHILD:12]

|-
| CHILDNAME
|
* singular
* plural
| Gives the child a special name, eg "hippo calf" instead of "hippo child".
[CHILDNAME:hippo calf:hippo calves]

|-
| CHITIN
|
| When the creature is butchered, it drops chitin, which functions as leather.

|-
| CRAFTSMAN_NAME
|
* singular
* plural
| Sets the name of the craftsman profession.
[CRAFTSMAN_NAME:craftsdwarf:craftsdwarves]

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

|-
| CLUSTER_NUMBER
|
* minimum
* maximum
| The minimum/maximum numbers of how many creatures per spawned cluster.
[CLUSTER_NUMBER:1:3]

|-
| COLOR
|
* fg (foreground)
* bg (background)
* br (brightness)
| [[Color]] of the creature's tile.
[COLOR:3:0:0]

|-
| COOKABLE_LIVE
|
| Set this to allow the creature to be cooked in meals without having to butcher it first.

|-
| CREATURE
| name
| What the game looks for when generating creatures.
[CREATURE:DWARF]

|-
| COLDDAM_POINT
| temperature
| The minimum temperature limit before the creature starts taking damage from freezing.

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

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

|-
| CURIOUSBEAST_ITEM
|
| Allows a creature to steal things (apparently the highest [[value]] it can find).

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

|}

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

|-
| DAMBLOCK
| value
| How much natural armor a creature has. Can be set to negative numbers, so the creature takes more damage than usual.
[DAMBLOCK:1]

|-
| DEFENDER
|
| Appears from the glowing pits in a group.

|-
| DIFFICULTY
| number
| [[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.
[DIFFICULTY:2]

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

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

|-
| DRINK_BOILING_POINT
| temperature
| The temperature at which a drink (milk?) produced from the creature will boil.

|-
| DRINK_COLDDAM_POINT
| temperature
| The temperature at which said drink will take cold damage.

|-
| DRINK_FIXED_TEMP
| temperature
| The temperature emitted by one unit of the creature's drink (if any).

|-
| DRINK_HEATDAM_POINT
| temperature
| The temperature at which aforementioned drink will take heat damage.

|-
| DRINK_IGNITE_POINT
| temperature
| The temperature at which the drink will set your fort ablaze.

|-
| DRINK_MELTING_POINT
| temperature
| [[User:GreyMario]] sez: "Isn't this, like, redundant? It's ''already'' liquid. Perhaps it controls at which point the drink solidifies?" {{verify}}

|-
| [[Creature_Tokens/SPEC_HEAT|DRINK_SPEC_HEAT]]
| not a temperature
| The difference in temperature required to modify the temperature of the drink? {{verify}}

|}

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

|-
| ENDING
|
| Will show up as a leader (only one of them) in a group from the glowing pits.

|-
| EQUIPMENT_WAGON
|
| Implies two unknown flags, NOSTUN, NONAUSEA, NOBLEED, NOEMOTION, NOSTUCKINS, SEVERONBREAKS, NOSKULL, NOSKIN, NOBONES, NOMEAT, PARALYZEIMMUNE, NOFEAR, NOSMELLYROT, NOTHOUGHT, NO_GENDER.

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

|-
| EVIL
|
| Determines whether creature can show up on "evil" maps (see [[Region#Surroundings]]).

|-
| EXTRACT
|
* name
* fg (foreground color)
* bg (background color)
* br (color brightness)
| Determines that something can be extracted from the creature, what it's called, and what [[color]] it is. Note, it appears that the extraction process is hard-coded into the game, and can't be altered from objects/raw.
[EXTRACT:cow's milk:7:0:1]

|-
| EXTRACT_ANTIDOTE
|
* name
* fg (foreground color)
* bg (background color)
* br (color brightness)
* ? (always 50 or 100)
| [EXTRACT_ANTIDOTE:cave spider antivenin:7:0:0:50]

|-
| EXTRACT_BOILING_POINT
| temperature
| The temperature value at which a unit of the creature's extract boils away.

|-
| EXTRACT_CHEESE
|
* name
* fg (foreground color)
* bg (background color)
* br (color brightness)
| The extract gotten from the creature can be made into cheese.
[EXTRACT_CHEESE:cow cheese:6:0:1]

|-
| EXTRACT_COOKABLE
|
| Extract is cookable.

|-
| EXTRACT_COLDDAM_POINT
| temperature
| The low temperature value at which the creature's extract starts to take damage.

|-
| EXTRACT_FIXED_TEMP
| temperature
| The temperature that the creature's extract generates on its own.

|-
| EXTRACT_HEATDAM_POINT
| temperature
| The high temperature value at which the creature's extract starts to take damage.

|-
| EXTRACT_IGNITE_POINT
| temperature
| The temperature at which the creature's extract bursts into flame (NOT the container it's in).

|-
| EXTRACT_MELTING_POINT
| temperature
| The temperature at which the creature's extract melts into goo.

|-
| EXTRACT_PARALYZE
|
| (conjectural) Extract is poisonous, causing paralysis that lasts until the extract wears off. Can be delivered by SPECIALATTACK_INJECT_EXTRACT.

|-
| EXTRACT_PARALYZE_INTERMITTENT
|
| (conjectural) Extract is poisonous, causing paralysis on occasional intervals until the extract wears off. Can be delivered by SPECIALATTACK_INJECT_EXTRACT.

|-
| EXTRACT_PERMANENT
|
| (conjectural) The effects of the creature's extract are permanent once applied and do not wear off naturally.

|-
| EXTRACT_SIZE
| size
|
[EXTRACT_SIZE:10]

|-
| [[Creature_Tokens/SPEC_HEAT|EXTRACT_SPEC_HEAT]]
| not a temperature
| The difference in temperature required to modify the temperature of the creature's extract? {{verify}}

|-
| EXTRACT_STUN
|
| (conjectural) Extract is poisonous, causing a permanent stun effect until the extract wears off. Can be delivered by SPECIALATTACK_INJECT_EXTRACT.

|-
| EXTRACT_STUN_INTERMITTENT
|
| (verified) Extract is poisonous, causing temporary stuns on semi-occasional intervals. Can be delivered by SPECIALATTACK_INJECT_EXTRACT.

|-
| EXTRACT_VALUE
| value
| The value per unit of the creature's extract.
[EXTRACT_VALUE:20]

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

|}

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

|-
| FAT
| value
| How much fat a creature produces when it is butchered.
[FAT:3]

|-
| FEATURE_ATTACK_GROUP
|
| pretty worthless now. It was very important in the 2-dimensional DF.

|-
| FEMALE
|
| The creature is always female. Note that a civilization created using an all-female creature will have no population, as they don't have breeding couples.

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

|-
| FIREIMMUNE
|
| The creature is immune to all forms of fire, except DRAGONFIREBREATH.

|-
| FIREIMMUNE_SUPER
|
| The creature is immune to DRAGONFIREBREATH. AI acts as if FIREIMMUNE. Does NOT imply FIREIMMUNE.

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

|-
| FIXED_TEMP
| temperature
| The natural heat generated by the creature. [FIXED_TEMP:1-?]

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

|-
| FLIER
|
| Allows a creature to fly. Currently, an AI bug prevents this from being useful on PC races in fortress mode.

|-
| FREQUENCY
| time
| Determines the time between creature spawns in Fortress Mode. Higher is more occurrences per time unit{{verify}}. Creatures without a frequency statement appear to be on the map at all times. Almost all others have either [FREQUENCY:5] or [FREQUENCY:100]. "High frequency means you get more when the number is high, so 100 would be the most common. If you don't enter a number, it uses 50."
[FREQUENCY:42]

|}

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

|-
| GENPOWER
| rate?
| Not used anymore and can be removed safely. Was related to magic.
[GENPOWER:3]

|-
| GLOWCOLOR
|
* fg
* bg
* br
| The colour of the GLOWTILE of the creature (see below).

[GLOWCOLOR:4:0:1]

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

[GLOWTILE:'"']

|-
| GNAWER
|
| The creature chews on food storage containers.

|-
| GOOD
|
| Determines whether creature can show up on "good" maps (see [[Creatures#Threat Matrix|Threat Matrix]]).

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

|}

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

|-
| HAS_RACEGLOSS
| gloss
| Links a material glossary to the creature. It is hardcoded, and there is only 4 types of tag.
[HAS_RACEGLOSS:WOOD]
[HAS_RACEGLOSS:STONE]
[HAS_RACEGLOSS:METAL]
[HAS_RACEGLOSS:PLANT]

|-
| HASSHELL
|
| Creature will leave behind a shell when eaten.

|-
| HEATDAM_POINT
| temperature
| The maximum temperature limit before the creature will start recieving damage from heat. [[Temperature scale|DF temperature scale]]

|-
| HOMEOTHERM
| value
| Default 'NONE'. The creature's normal body temperature. Combined with LAYERING, sets the temperature range under which it can live. [[Temperature scale|DF temperature scale]]

|-
| HORN
|
| Creature drops a horn or horns when butchered, which presumably acts like bone. This tag is broken.

|}

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

|-
| IGNITE_POINT
| temperature
| The temperature at which the creature will burst into flames. [[Temperature scale|DF temperature scale]]

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

|-
| IMMOBILE_LAND
|
| The creature is immobile while on land

|-
| INTELLIGENT
|
| Implies CAN_CIV, CAN_SPEAK, CAN_LEARN.

|-
| ITEMCORPSE
|
* [[Item Tokens|item token]]
* subtype
NO_SUBTYPE
* [[Matgloss_tokens|matgloss token]]
* NO_RACEGLOSS
USE_RACEGLOSS
USE_SHARPSTONE
| Determines if the creature leaves behind a non-standard corpse (i.e. wood, statue, bars, etc). The first parameter determines the item type; the second parameter is the subtype indicated in the raw file (such as WEAPON_WHIP); the third indicates the material type if the item type takes a specific material (e.g. "IRON" if the corpse type is "STATUE"). USE_RACEGLOSS applies if the creature has a material glossary assigned by the "HAS_RACEGLOSS:" flag and will select neccesary adjectives and material from that glossary.
[ITEMCORPSE:[[Item Tokens|WOOD]]:NO_SUBTYPE:[[Material Tokens|WOOD]]:USE_RACEGLOSS]

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

|-
| IVORY
|
| Creature will produce ivory when butchered. Currently doesn't work. May turn up with merchants as a trade good.

|}

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

|-
| LARGE_CAVERIVER
|
| In Fortress Mode, spawns from/near cave rivers.

|-
| LARGE_CHASM
|
| In Fortress Mode, spawns from/near chasms.

|-
| LARGE_LAVA
|
| In Fortress Mode, spawns from/near magma.

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

|-
| LAYERING
| value
| How well-protected the creature is from low temperatures. If this number is too high, it will confine a creature to only arctic areas. If it is even higher it will prevent the creature from spawning at all. Tropical animals have this at 100. Tundra creatures, 200 or 300; humans 10, dwarves 50.

|-
| LEATHER_BOILING_POINT
| temperature
| The temperature at which leather made from the creature's skins will boil away.

|-
| LEATHER_COLDDAM_POINT
| temperature
| The temperature at which leather made from the creature's skins will take damage.

|-
| LEATHER_FIXED_TEMP
| temperature
| The temperature that leather made from the creature's skins generates.

|-
| LEATHER_HEATDAM_POINT
| temperature
| The temperature at which leather made from the creature's skins will take damage.

|-
| LEATHER_IGNITE_POINT
| temperature
| The temperature at which leather made from the creature's skins will burst into flames.

|-
| LEATHER_MELTING_POINT
| temperature
| The temperature at which leather made from the creature's skins will melt away.

|-
| [[Creature_Tokens/SPEC_HEAT|LEATHER_SPEC_HEAT]]
| not a temperature
| The difference in temperature required to modify the temperature of the creature's leather? {{verify}}

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

|-
| LIKES_FIGHTING
|
|

|-
| 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. Implies [TRAPAVOID]

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

|}

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

|-
| MAGICAL
|
| Makes the creature attract local wildlife in large numbers. May have more effects when magic is implemented.

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

|-
| MALE
|
| The creature is always male. Note that a civilization created using an all-male creature will have no population, as they don't have breeding couples.

|-
| MATERIAL
|
* [[Matgloss_tokens|Matgloss token]]
* USE_RACEGLOSS
|

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

|-
| MAXAGE
|
* minimum
* maximum
| Sets the Min Max age for a creature. Used in world generating and Fortress Mode.
[MAXAGE:150:170]

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

|-
| MEGABEAST
|
| Appears on fortress territory in Fortress Mode occasionally. Implies SEMIMEGABEAST.

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

|-
| MILKABLE
| frequency?
| Allows the creature to be milked. Currently only works with vermin creatures.

|-
| MISCHIEVIOUS
|
| Will pull any levers it comes across (requires confirmation). "They go on little missions to mess with various fortress buildings, not just levers."

|-
| MODVALUE
| number
| Multiplies the value of items made from the creature by the number in the tag.
[MODVALUE:2]

|-
| MOUNT
|
| Allows the creature to be mounted. Currently only works with siegers. The same AI bug that causes issues with [FLIER] PC races in fortress mode causes worse issues with flying mounts, though when unmounted the creature will fly just fine. [SWIMS_INNATE] may or may not have similar issues on mounts.

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

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

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

|}

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

|-
| NAME
|
* singular noun
* plural noun
* adjective
| What the creature is actually called in game. Make sure there is no space around the ":".
[NAME:dwarf:dwarves:dwarven]

|-
| NARROW
|
| The creature can only wear things that have the narrow tag on it.

|-
| NATURAL
|
| Animal

|-
| NO_AUTUMN
|
| Will not show up during the Autumn season.

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

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

|-
| NO_GENDER
|
| No gender will be selected for the creature. Note that a civilization created using a genderless creature will have no population, as they don't have breeding couples.

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

|-
| NO_SPRING
|
| Will not show up during the Spring season.

|-
| NO_SUMMER
|
| Will not show up during the Summer season.

|-
| NO_WINTER
|
| Will not show up during the Winter season.

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

|-
| NOBLEED
|
| Creature doesn't bleed.

|-
| NOBONES
|
| Creature will not drop bones on butcher, rot, or decay of severed body parts.

|-
| 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
|
| Creatures' corpse does not create miasma.

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

|-
| NOSTUN
|
| Creature can't be stunned.

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

|-
| NOT_BUTCHERABLE
|
| Creature can't be butchered.

|}

==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
|
| Flies in a semi-predictable pattern? {{verify}}

|-
| 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 greater than the penetrate power, their contents escape for the time being. Other objects roll a 0-99.

|-
| PERSONALITY
|
* token
* lowest % chance
* median
* highest % chance
| Determines chance of personality traits. Standard is 0:50:100. See [[Personality traits]] for more info.
[PERSONALITY:IMAGINATION:0:55:100]

|-
| 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:42]

|-
| POPULATION_NUMBER
|
* minimum
* maximum
| The minimum/maximum numbers of how many of these creatures can show up on a map per year.
[POPULATION_NUMBER:42:42]

|-
| POWER
|
| Allows the creature to be worshiped by entities with the RELIGION:ANY_APPROPRIATE_POWER tag.

|-
| PREFSTRING
| object
| Sets what other creatures like about this creature. "Blarghh likes dwarves for their beards."
[PREFSTRING:beards]
Multiple entries will be chosen from at random.

|}

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

|-
| REMAINS
| <''singular''>:<''plural''>
| ??? Used by treants along with [REMAINS_UNDETERMINED], appears to change the name of a creatures remains.

|-
| REMAINS_COLOR
|
* fg
* bg
* br
| The color of the creature's remains. Used by treants.

[REMAINS_COLOR:6:0:0]
|-
| REMAINS_UNDETERMINED
|
|

|}

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

|-
| SEMIMEGABEAST
|
| Appears as boss creature in quests.

|-
| SESSILE_LAND
|
| Obsolete. Use [[#I|[IMMOBILE_LAND]]].

|-
| SEVERONBREAKS
|
| Limbs and body parts sever on breakage.

|-
| SILK_BOILING_POINT
| temperature
| Temperature at which silk made from this creature's webs boils away.

|-
| SILK_COLDDAM_POINT
| temperature
| Temperature at which silk made from this creature's webs takes damage.

|-
| SILK_FIXED_TEMP
| temperature
| Temperature generated by the creature's web silk.

|-
| SILK_HEATDAM_POINT
| temperature
| Temperature at which silk made from this creature's webs takes damage.

|-
| SILK_IGNITE_POINT
| temperature
| Temperature at which silk made from this creature's webs bursts into flame.

|-
| SILK_MELTING_POINT
| temperature
| Temperature at which silk made from this creature's webs melts away.

|-
| [[Creature_Tokens/SPEC_HEAT|SILK_SPEC_HEAT]]
| not a temperature
| The difference in temperature required to modify the temperature of the creature's silk? {{verify}}

|-
| SIZE
| value
| How big a creature is. 6 is for dwarf like creatures, 7 is for human like creatures. 16 is for giants. Larger creatures are far more dangerous in combat. Also equals the amount of Meat/Chunks/Bones you get from the beast. Creatures with a size larger than 10 will prevent [[bridge]]s from raising or retracting and will cause a [[Dwarven Atom Smasher]] to deconstruct.
[SIZE:6]

|-
| SLOW_LEARNER
|
| Presumably similar to [CAN_LEARN], but slower. Present in the entries for ogres and giants

|-
| SMALLAQUATIC_CAVERIVER
|
|

|-
| SMALLAQUATIC_OCEAN
|
|

|-
| SMALLAQUATIC_RIVER
|
|

|-
| SMALLAQUATIC_SWAMP
|
|

|-
| SMALL_REMAINS
|
| If a creature has this token, it'll leave a small corpse that only rots once, such as vermin.

|-
| SPECNAME
|
*token
*singular noun
*plural noun
*adjective
| Sets a special name for certain instances.
[SPECNAME:MALE:bull:bulls:bull]

|-
| [[Creature_Tokens/SPEC_HEAT|SPEC_HEAT]]
| not a temperature
| The specific heat of a creature? {{verify}}
[SPEC_HEAT:409]

|-
| SPEECH
| filename
| Sets what speech.txt to use when insulting the creature.
[SPEECH:dwarf.txt]

|-
| SPEECH_MALE
| filename
| Used in place of [SPEECH] for humans; perhaps sets the speech.txt to use for males only? Humans don't have a corresponding [SPEECH_FEMALE] token, though, which only occurs in the [[string dump]].
[SPEECH_MALE:human_male.txt]

|-
| 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 [[Speed]] for more information.
[SPEED:400]

|-
| SPHERE
| [[sphere]]
| Sets what religious spheres the creature is aligned to, for purposes of being worshipped via the [POWER] token. By default, only used by [[Demon|hidden fun stuff]].

|-
| STOUT
|
| Clothing width, similar to NARROW. If you have STOUT humans they will have "stout" inventory prefixes. Perhaps also: Creature has a resistance to being knocked over.

|-
| STANDARD_FLESH
|
|

|-
| 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 must learn to swim. Requires [CAN_LEARN], obviously.

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

|}

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

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

|-
| TILE
| CP437 ordinal or 'character'
| The graphical representation of the creature.
[TILE:157] or [TILE:'&']

|-
| TRADE_CAPACITY
| weight
| How much the creature can carry when used by merchants.
[TRADE_CAPACITY:2000]

|-
| TRAINABLE
|
| Allows a tame creature to be trained into a "War" or "Hunting" variation by way of [[Kennels]].

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

|-
| TRAPAVOID
|
| The creature is immune to traps.

|-
| TRIGGERABLE_GROUP
|
* minimum?
* maximum?
| [TRIGGERABLE_GROUP:5:50]

|}

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

|-
| UNDERSWIM
|
| Creature swims under the water and can't be seen.
|-
| UTTERANCES
|
| Changes the language of the creature into an unintelligible mess.

|}

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

|-
| VEGETATION
|
|

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

|-
| VERMIN_BITE
|
* amount injected or chance of injection?
* name
* effect (USE_EXTRACT)
| [VERMIN_BITE:10:bitten:USE_EXTRACT]
On very rare occasions, someone who remains in the same tile as this creature will be bitten by that creature, and the effect will be applied to the offender. Used by (tiny) cave spiders to inject their venom into the occasional dwarf.

|-
| VERMIN_EATER
|
| The creature can eat your food.

|-
| 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. – [[User:Peristarkawan|Peristarkawan]] 17:27, 24 May 2007 (EDT)

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

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

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

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

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

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

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

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

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

|-
| VIEWRANGE
| value
| How far the creature can see?

|}

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

|-
| WAGON_PULLER
|
| Allows the creature to pull caravan wagons.

|-
| WEBBER
|
| The creature will create webs. It also seems to make creatures flying. More testing is needed.

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

|}

=Attacks=
{| {{prettytable}}
|- bgcolor="#ddd"
!width="50"|Tag
!width="225"|What It Does

|-
|[ATTACK:MAIN:BYTYPE:GRASP:punch:punches:1:2:BLUDGEON][ATTACKFLAG_WITH]

''Format:''
[ATTACK:''priority'':(BYTYPE:''type'' || BYTOKEN:''bodypart''):''"verb"'':''"conjugate verb"'':''min dmg'':''max dmg'':''dmg type'']([(ATTACKFLAG_WITH || ATTACKFLAG_CANLATCH)])([SPECIALATTACK_INJECT_EXTRACT:''min'':''max''])
|Sets what natural attacks a creature has.

|-
|MAIN
SECOND
|''MAIN'': Sets the attack to act as the creatures' main attack.
''SECOND'': The creature will only use this attack if it can't use the MAIN attack(s).

|-
|BYTYPE:GRASP
BYTOKEN:TAIL_STINGER
|''BYTYPE'': Sets what body part type to use for the attack. Possible values for "type" are GRASP, MOUTH, STANCE, THOUGHT, BREATHE, and the like. See [[Body Tokens]].
''BYTOKEN'': Sets the explicit body part ID to use for the attack. The token must exist as part of the creature's [[Creature Tokens#B|BODY]] token.

|-
|punch:punches
|Sets the verb for the attack.

|-
|1:2
|Sets the Min Max for the damage.

|-
|BLUDGEON, PIERCE, SLASH, GORE, BURN, HEAT, COLD
|Sets the damage type for the attack.

|-
|[ATTACKFLAG_WITH]
|Attacks in combat inform which body part was used in the attack.
"Ratman punches Blargg with his right hand."

|-
|[ATTACKFLAG_CANLATCH]
|Allows the creature to latch on with the attack. "Crocodile latches on Blargg's head firmly."

|-
|[SPECIALATTACK_INJECT_EXTRACT:50:100]
|The creature injects an amount of its extract into a victim upon successfully using this attack. The significance of the amount is unknown (but probably determines duration before the extract wears off).

|-
|[SPECIALATTACK_SUCK_BLOOD:50:100]
|When blood is drained from a creature, it causes heavy bleeding (depending on the attacking creatures ability to suck blood). It's unknown if blood suckers feed or regain health while doing this. (Numbers affect amount of blood drawn? / Effectiveness?)
|}

[[Category:Modding]]
[[Category:Tokens]]

40d Talk:Eerie glowing pit

2009-09-24T09:47:46Z

Darekun:

{{spoiler}}

== The Demons ==

How powerful ARE the demons now? I gather that a pit chamber will release piles of them, but how many and how nasty are they all? Wonder if adamantine is really worth it... though if you've planned it out, I suppose it might be. Wonder how many demons a legendary dwarf warrior wielding masterwork adamantine weapons and armor could take out by himself!

:They're as nasty as they used to be. -- [[User:Zaratustra|Zaratustra]] 11:38, 20 November 2007 (EST)

:I had repulsed the initial wave of 1 Daemon and 7 Spirits of Fire by 5 marksdwarves and 4 axedwarves. 2 marksdwarves and 2 axedwarves were Elite in full steel chain/plate, others - on their way to it. Lost all axedwarves and 1 marksdwarf in the process. A few seasons later I thought that there weren't much more daemons and breached the pits in a new spot. By that time I had 3 Champion marksdwarves in Fortress Guard (not controllable at all :( ), ~20 wardogs, 4 other marksdwarves, 2 of which - Elite and 4 axedwarves/hammerdwarves at about 'competent' each. All the civilians (90 of them) were drafted into military with some extra weapons and no armor including ~10 miners from Legendary to novice with picks. The aftermath in the units screen is 16 dead Spirits of Fire including 7 from the initial attack, 10 live and happy Spirits of Fire with '''very''' long names, probably some more Spirits of Fire in ambush/invisible to me state and 5 recruits resting and dehydratated in remote corners of my bedroom area. There were immence lags when my stockpiles cathed fire and it were heavily lagging when I got there in adventure mode. --[[User:Another|Another]] 15:05, 20 November 2007 (EST)

:I just recently breached a pit, only to result in my entire fortress virtually being annihilated, 109 military dwarves were killed, including a Hammerlord with a legendary adamantine hammer, a mortally wounded Legendary Captain of the Guard, and the daemons lost only 50 total. --[[User:Naze|Naze]] 23:19, 12 December 2007

:I cleansed a demon pit that included exactly 30 fire spirits and a demon. I built a corridor to the chamber, filled it with spikes and chained them to a lever, with the pull lever/R action. It worked quite well despite the fact that my spikes were melt by the demons as they approached. They eventually had to go through a corridor where marksdwarves were stationned. They killed 5 marksdwarves, and some managed to enter my fortress undetected. I was VERY lucky because the fortress guard was useful! If you disable TEMPERATURE, they will be destroyed with no sweat. [[User:Bartavelle|Bartavelle]] 09:01, 11 January 2008 (EST)

:If you re-site your barracks to just outside the pits, then your fortress guard will find themselves joining the front line... [[User:YayTheDwarves|YayTheDwarves]] 09:58, 11 January 2008 (EST)

: from Lumpen on SomethingAwful: "Last night I cracked into the glowing pits and massacred the demons by filtering them through a massive maze of twisting fortifications through which my legendary siege operators unleashed a hail of over a hundred ballista arrows cranked out by 6 ballistae." So, that could work. --[[User:Jellyfishgreen|Jellyfishgreen]] 12:19, 29 September 2008 (EDT)

:I broke into the pitlast night, and beforeI could close it up, frog demons were across my cut of adamantine viens. I sent very little, but very strong people down there, as I only had about 39 dwarves :D. They killed them no sweat. They had abit trouble with a demon. There was only about 10 of the that came from the pit. I was quick to seal up where the whole where the demons came out of, yet my fortress still being able to get in.

== Magma mini-pipes/vents? ==

Are the magma bits considered unconnected, and thus will cool to obsidian, or are they in effect pipes/vents and will refill via the new code? --[[User:Nunix|Nunix]] 23:29, 26 February 2008 (EST)

:there is no such thing as disconnected magma solidifying. that was added for some reason by someone to the wiki a long time ago but is incorrect. magma that is not connected anything will stay magma forever. the only way to turn it into obsidian is by adding water -[[User:Chariot|Chariot]] 05:15, 27 February 2008 (EST)

::Although, to be fair, depth 1 magma will cool to, um... air or something. At any rate, if you let it get to depth 1 it evaporates, much like water. Except more frustrating, because it's very slow to begin with.--[[User:Doctorlucky|Doctorlucky]] 03:36, 20 March 2008 (EDT)

:::Twas cooling in 2D. And what about refilling?--[[User:Dorten|Dorten]] 02:20, 4 June 2008 (EDT)

::::What? Magma didn't ever cool in 2D, except for the special event that sometimes occurred on breaching the magma river.
::::ah, the magma river. The name brings back such memories...
::::--[[User:Savok|Savok]] 11:10, 4 June 2008 (EDT)

== Rewalling/Flooring ==

If you floor over the glowing pit rather as opposed to rewalling do the demons still spawn? [[User:Yvain|Yvain]] 18:18, 19 March 2008 (EDT)

:No, reflooring still can release demons. Tested the hard way. [[User:Yvain|Yvain]] 23:31, 19 March 2008 (EDT)

:Additionally, building walls over every glowing pit tile still releases demons. [[User:Yvain|Yvain]] 00:18, 20 March 2008 (EDT)

== First encounter ==

A creature I am developing, called the solen, was tested today using these. That is, demons. And the interesting thing is, fourteen have slaughtered--so far--about...

20 tentacle demons, 5 daemons.

Shall I upload pics of the room, its contents, and the glowing pit itself? Also I think this should be moved to ''Eerie Glowing Pit'', as that's what it really is. ~ [[User:Midna|Midna]] 17:21, 15 May 2008 (EDT)

:I like the move idea. --[[User:Savok|Savok]] 11:10, 4 June 2008 (EDT)

== Captives ==

what happens if you free the captives in a glowing pit after surviving the demon onslaught? --[[User:0todd0|0todd0]] 02:08, 4 June 2008 (EDT)

:dunno, think they just go around babbling or somesuch :\ --[[User:Frostedfire|Frostedfire]] 04:32, 4 June 2008 (EDT)

::They are all insane, mostly melancholy. If you unhook them, they just act like melancholy dwarves and wander around or throw themselves in the pit. Poor guys :( --[[User:Dadamh|Dadamh]] 13:28, 4 June 2008 (EDT)

== Unchained humanoids? ==

The article talks about caged/chained humanoids.

Well, I have so far breached two pits. One had a floor of caged humanoids. That was the most recent one, which I breached carefully (and with cheating).

The first one, I breached with stairs (which was dumb, because they couldn't be stopped at that point by rewalling). Inside the chamber there were at least 40 '''unchained''' melancholy/crazy humanoids. They immediately started trying to flee, along with the demons. The initial wave of "refugees" lagged my fortress to the pits and back. They were free to begin with.

has this happened to anyone else?
[[User:Logical2u|Logical2u]] 11:35, 16 June 2008 (EDT)

:: Well, I breached my first pit ever last night. Thing was 4 stories, connected by stairs all the way to the lowest Z-Axis level. 3 floors FULL of Elves and Humans caged/chained. My Fortress pretty much lagged up into infinity at that point. It's gotten a little better, but it's still pretty bad. I appreciate the asthetic value, but good lord I hope Toady changes some of this in the future. Either let SOME of the Humans and Elves vamoose back to wherever they initially came from (I bet it's a funny story how they ended up in a glowing pit being tortured by unimaginable horrors from the deep....), or make a good point out of them trying to get a 10/10 on their headfirst dive into magma. [[User:Archaeologist|Archaeologist]] 00:53, 28 September 2008 (EDT)
:::They've been driven to insanity and care about nothing anymore. --[[User:GreyMario|GreyMaria]] 01:28, 28 September 2008 (EDT)
:::: So how do we get rid of the little lag monsters? Wait, nevermind, the sudden wave of tentacle monsters killing EVERYTHING seems to have been more than adequate. [[User:Archaeologist|Archaeologist]] 02:43, 28 September 2008 (EDT)
::::: Well, my tentacle demons killed nothing (apart some marksdwarves), and I still got '''104''' (not kidding, there's more than 5 pages of them in the "u" menu) elves, dwarves and humans babbling around. How am I supposed to kill them all ? Most of them are still in the chamber, and because of the adamantine veins I can't force myself to flood it with magma, create a cave in or something like that. It will be fairly complicated to kill them with the dwarven atom smasher too... Do you have any ideas ? [[User:Timst|Timst]] 15:18, 13 April 2009 (UTC)

::::::[[Ballista]]e --[[User:LegacyCWAL|LegacyCWAL]] 15:34, 13 April 2009 (UTC)
::::::Time. Leave it a season and they'll all starve or die of thirst. [[User:Aosher|Aosher]] 09:11, 14 April 2009 (UTC)
:::::::Oh, they can do that ? Even if it's, err, NPC ? The merchants never die of thirst or starve, for instance. Anyway, it's "great". :) [[User:Timst|Timst]] 09:30, 14 April 2009 (UTC)
::::::::They can do that! Don't know about diplomats etc, but the chained humanoids - i.e. anything labelled "From the Deep" in the {{K|u}} menu - can definitely starve, as of 40d. [[User:Aosher|Aosher]] 19:31, 14 April 2009 (UTC)
::::::::Confirmed. Refugees are physically unharmed but all insane and wearing nothing but filth, blood, and stains. My refugees all died about two months later, all on the same week, except the caged ones. Evidently insanity means forgetting to drink when you're thirsty. The tortured dwarves were laid to rest with proper dwarf coffins by my citizens. The elves...were added to the bonepile. --[[User:Jellyfishgreen|Jellyfishgreen]] 20:25, 30 May 2009 (UTC)

== Water? ==

Anybody know if pumping the glowing pit full of water will affect the demons? I've started a fortress to try it out, but it's slow going(I'm really more of a modder as DF goes).

40d:Biome

2009-07-27T15:25:22Z

Darekun: /* Biomes at World Generation */ Added more-visual table for middle elevations.

A '''biome''' is a biotic area with homogeneous features, characterized by distinctive [[plant]]s, [[creatures|animal species]] and [[climate]]. A biome will also contain only one set of stone layers, though these usually expand beyond a single biome. Your [[dwarves]] will find different resources depending on which biomes they select when starting a fort.

== Selecting a biome ==

Biomes are important when choosing a fortress location in order to understand your [[surroundings]]. Individual biomes, which form at least one map-tile of your embark location, can be cycled with the {{Key|F#}}-keys; for example, an area with 3 biomes present can be cycled using {{Key|F1}}, {{Key|F2}} and {{Key|F3}}. The selected biome will be highlighted with flashing Xs on the Local Map, and the biome's information will be displayed on the right side of the screen. ''(See the [[Indecisive%27s_illustrated_fortress_mode_tutorial|illustrated guide]] for more detail).''

== Understanding Biomes ==
we should have more details on what these "resources" actually are, or more examples?

Selecting different Biomes gives you some abiltiy to influence the difficulty of your game. A wide variety of biomes may give you access to several unique resources provided by each, like the ability to gather and plant certain crops and make the game easier and more interesting. Generally it is advantageous to plot your embark [[location]] at the convergence of multiple different biomes, the more the better (within reason) - which is made easier if you enlarge your starting embarkation area).
* ''Note: Making the starting plot larger will slow your game down considerably; likewise, a small embark area can dramatically increase framerate.{{version|0.28.181.40d}}''

By making use of several biomes you can provide more resources for your fort. Making sure one of your biomes contains either a [[broadleaf]] or [[conifer]] [[forest]] will provide you with an ample supply of [[tree]]s, even if the rest of your plot extends into badlands and [[desert]].

[[Surroundings]] are not directly linked to biomes (i.e. a [[glacier]] could be [[haunted]], [[wilderness]] or [[mirthful]]), but the more biomes you have, the more likely it is to have several alignments, if so desired.

If your plot contains only [[ocean]], [[lake]] or [[mountain]] biomes you will not be able to embark. The dwarves would have difficulty parking their [[wagon]] on water, while mountains are too barren and remote to reach.

The exact process is unknown, but no relation has been found between biomes and the stone layers that lie deep beneath them in the same area block. They do seem to be influenced by the first, top layer - a top layer of sand seems to cause drier biomes, where swamps rarely (if ever?) appear on sand, and (obviously) plants and trees do not grow on a top layer of stone. (More research is needed.)

== Available Biomes ==

=== Arctic ===
*Arctic [[Ocean]]
*[[Badlands]]
*[[Glacier]]
*[[Mountain]]
*[[Rocky wasteland]]
*[[Sand desert]]
*[[Tundra]]
*[[Taiga]]

=== Temperate ===
*[[Temperate]] [[Broadleaf forest]]
*Temperate [[Conifer forest]]
*Temperate [[Grassland]]
*Temperate [[Lake|Freshwater lake]]
*Temperate [[Marsh|Freshwater marsh]]
*Temperate [[Swamp|Freshwater swamp]]
*Temperate [[Ocean]]
*Temperate [[Marsh|Saltwater marsh]]
*Temperate [[Swamp|Saltwater swamp]]
*Temperate [[Savanna]]
*Temperate [[Shrubland]]

=== Tropical ===
*[[Tropical]] Dry [[Broadleaf forest]]
*Tropical Wet [[Broadleaf forest]]
*Tropical [[Conifer forest]]
*Tropical [[Marsh|Freshwater marsh]]
*Tropical [[Grassland]]
*Tropical [[Ocean]]
*Tropical [[Savanna]]
*Tropical [[Shrubland]]

==Biomes at World Generation==

Biomes are created at [[world generation]] based on the elevation, rainfall, and drainage of the tile as follows:

{|{{prettytable}}
|-style="background:#dddddd"
!Biome !!Elevation !!Rainfall !!Drainage
|-
|Water ||0-99 ||Any ||Any
|-
|Sand Desert ||100-299 ||0-9 ||0-32
|-
|Rock Desert ||100-299 ||0-9 ||33-49
|-
|Desert Badlands A ||100-299 ||0-9 ||50-65
|-
|Desert Badlands B ||100-299 ||0-9 ||66-100
|-
|Grassland ||100-299 ||10-19 ||0-49
|-
|Savanna ||100-299 ||20-32 ||0-49
|-
|Marsh ||100-299 ||33-65 ||0-32
|-
|Shrubland ||100-299 ||33-65 ||33-49
|-
|Hills ||100-299 ||10-65 ||50-100
|-
|Swamp ||100-299 ||66-100 ||0-32
|-
|Forest ||100-299 ||66-100 ||33-100
|-
|Low Mountain ||300-332 ||Any ||Any
|-
|Mountain ||333-365 ||Any ||Any
|-
|High Mountain ||366-400 ||Any ||Any
|}

More visually, for just the middle elevations:
{|border="1" cellpadding="4" cellspacing="0" style="margin: 1em 1em 1em 0; background: #f9f9f9; border: 1px #aaa solid; border-collapse: collapse; text-align: center; "
|-
| rowspan=2 colspan=2 |
! colspan=5 |Rainfall
|-
!0-9 ||10-19 ||20-32 ||33-65 ||66-100
|-
! rowspan=4 |Drainage ||0-32
| Sand Desert
| rowspan=2 |Grassland
| rowspan=2 |Savanna ||Marsh ||Swamp
|-
!33-49
|Rock Desert ||Scrubland
| rowspan=3 |Forest
|-
!50-65
|Badlands A
| colspan=3 rowspan=2 |Hills
|-
!66-100
|Badlands B
|}

== See Also ==
*[[Regions]] for the possible values for Trees, Vegetation and Surroundings.
*[[Volcano]]es which are not a biome in Dwarf Fortress, but may provide important resources
*[[Climate]]

{{World}}

[[Category:Biomes]]
[[Category:World]]

40d Talk:Biome

2009-07-16T04:01:55Z

Darekun: /* Tropical */

How do the stuff you can search for (rainfall, drainage, etc) interact with what biomes form in a region? [[User:Random832|Random832]] 01:46, 21 November 2008 (EST)

:Very good question. I want lots and lots of forests in my worlds because I like elephants for their big droopy asses.--[[User:Maximus|Maximus]] 04:22, 21 November 2008 (EST)
::Apparently, every biome has some combintions of parameters valis. For example: low rainfall + high drainage = desert, and so on... But we need to gather complete list. Worldgen cookbook is a good place to search for info already known. and we can ask Toady--[[User:Dorten|Dorten]] 06:45, 21 November 2008 (EST)

== From the forums ==

Hello again.

Since it took me some time to figure these out, im posting them for everyone to save their time. Biome names are taken from wiki by comparing with map legend from here: http://www.dwarffortresswiki.net/index.php/Map_legend , although there seem to be some discrepancies.

Sav and Volc are irrelevant to biomes in world editor.

By elevation:

Water
Elevation: 1 - 99

Low Mountain
Elevation: 300 - 332

Mountain
Elevation: 333 - 365

High mountain
Elevation: 366 - 400

Everything else
Elevation: 100 - 299

By rain/drain:

Hill
Rain: 10 - 66
Drain: 50 - 100

Sand Desert
Rain: 0-9
Drain: 0-32

Rock Desert
Rain: 0-9
Drain: 33-49

Desert Badlands A
Rain: 0-9
Drain: 50 - 65

Desert Badlands B
Rain: 0-9
Drain: 66 - 100

Second Desert Badlands biome (per wiki), occupying higher drain areas

Grassland
Rain: 10-19
Drain: 0-49

Savanna
Rain: 20-32
Drain: 0-49

Marsh
Rain: 33-65
Drain: 0-32

The character is darker than marsh in wiki map legend and matches that of a swamp instead, but on wiki both marsh and savanna have the same characters, so im guessing this one actually is marsh.

Shrubland
Rain: 33-65
Drain: 33-49

Swamp
Rain: 66-100
Drain: 0-32

Forest
(conifer icon, probably means temperate)
Rain: 66-100
Drain: 33-100

Forest becomes Broadleaf in high temperatures, which makes it the only biome in world editor that is dependant on temperature. Im guessing that the character for Conifer actually serves for temperate conifer and broadleaf, and the broadleaf icon means tropical broadleaf forest, because thats what the rain/temp/drain stats suggest, and otherwise there would be no differentiation between temperate and tropical.

Forest
(broadleaf icon, probably means tropical)
Temperature: ~ 60-75 (varies a bit for different drain values) --[[User:Dorten|Dorten]] 07:34, 21 November 2008 (EST)

:I added this info to the page, but I notice there seem to be missing ranges; what happens if rainfall is 0-65 and drainage is 50-100? --[[User:FunkyWaltDogg|FunkyWaltDogg]] 22:07, 28 March 2009 (UTC)

::You missed the first rain/drain listing, Hill - I've added it. [[User:Darekun|Darekun]] 05:07, 27 June 2009 (UTC)

== Biomes and stone layers ==

Biomes have no relation to the [[stone]] [[layer]](s) that lie below them, beyond
the first (which is often a type of [[soil]].
:How sure are we about this? [[User:VengefulDonut|VengefulDonut]] 12:26, 3 June 2009 (UTC)
:: I haven't seen any correlation between rock layers and biomes. Other than granite which is often the base of mountains and is more common there. There are a few soil types that are found only in the ocean, but those are normally never encountered unless you extend your embarkation zone way out to sea.--[[User:Smjjames|Smjjames]] 14:10, 3 June 2009 (UTC)
:::No, VD is right - it's "apparent", it's intuitive, it's logical, it's that way in RL, but it's not conclusive nor is there any concrete supporting evidence (proving the absence of something - never easy). It was my post - I'll edit to reflect that.--[[User:Albedo|Albedo]] 17:40, 3 June 2009 (UTC)
::: Hmm, now that I think about it, diorite is often found in mountains, sometimes even as two layers on top of each other. According to Wiki ( http://en.wikipedia.org/wiki/Diorite ), it is associated with mountain building and volcanism. I also find it associated with other igneous rocks in biomes and I rarely see diorite outside of either mountains or volcanic areas. This is going to require quite a bit of observation and note taking.--[[User:Smjjames|Smjjames]] 18:42, 3 June 2009 (UTC)

== Tropical ==
So is there a way to influence worldgen so that it produces more tropical biomes? Cos i have a hard time finding ''any'' on my worlds :( Or search tips? --[[User:Confused|Confused]] 02:09, 23 June 2009 (UTC)
:Tropical is a temperature band, so increase the temperatures, especially the min. You may also want to reduce the X and Y variance of temperatures, to get a steady Tropical throughout.
:However, this kind of "uniformity tweak" often results in infinite map rejections - turn on map rejection logging, and if you get a bunch of rejections see what they are, and zero out the demands for the listed biomes or traits. The defaults don't seem to demand any glacier or tundra, so I don't ''think'' all-tropical will be a problem.
:Searching for High Temperature should find any tropical biomes that did gen. [[User:Darekun|Darekun]] 03:46, 27 June 2009 (UTC)
::Map rejections are most always easily dealt with simply by turning off the minimum/maximum of most of the "total # of x" options (only thing that I can't get around is having to make mountains for dwarven civs). As for tropical I'm honestly not sure if it's temperature dependent. It should be, but I'd need to test it. Edit: in fact, upon looking up "tropical" you can apparently have freezing tropical areas. [[User:Greep|Greep]] 08:18, 27 June 2009 (UTC)
:::Yeah, the minimum/maximum entries is what I meant by "demands".
:::To get around needing mountains for dwarves, change their [[Entity_tokens#Placement|[START_BIOME:]]] in the entity def.
:::If you keep looking, you'll find conflicting data on "tropical". I couldn't figure it out from the wiki, so I genned a world and looked around it; it seems to be tightly-bound to temperature, and not latitude or anything. [[User:Darekun|Darekun]] 04:01, 16 July 2009 (UTC)

40d:Biome

2009-06-27T05:08:50Z

Darekun: /* Biomes at World Generation */ Fixing typo.

A '''biome''' is a biotic area with homogeneous features, characterized by distinctive [[plant]]s, [[creatures|animal species]] and [[climate]]. A biome will also contain only one set of stone layers, though these usually expand beyond a single biome. Your [[dwarves]] will find different resources depending on which biomes they select when starting a fort.

== Selecting a biome ==

Biomes are important when choosing a fortress location in order to understand your [[surroundings]]. Individual biomes, which form at least one map-tile of your embark location, can be cycled with the {{Key|F#}}-keys; for example, an area with 3 biomes present can be cycled using {{Key|F1}}, {{Key|F2}} and {{Key|F3}}. The selected biome will be highlighted with flashing Xs on the Local Map, and the biome's information will be displayed on the right side of the screen. ''(See the [[Indecisive%27s_illustrated_fortress_mode_tutorial|illustrated guide]] for more detail).''

== Understanding Biomes ==
we should have more details on what these "resources" actually are, or more examples?

Selecting different Biomes gives you some abiltiy to influence the difficulty of your game. A wide variety of biomes may give you access to several unique resources provided by each, like the ability to gather and plant certain crops and make the game easier and more interesting. Generally it is advantageous to plot your embark [[location]] at the convergence of multiple different biomes, the more the better (within reason) - which is made easier if you enlarge your starting embarkation area).
* ''Note: Making the starting plot larger will slow your game down considerably; likewise, a small embark area can dramatically increase framerate.{{version|0.28.181.40d}}''

By making use of several biomes you can provide more resources for your fort. Making sure one of your biomes contains either a [[broadleaf]] or [[conifer]] [[forest]] will provide you with an ample supply of [[tree]]s, even if the rest of your plot extends into badlands and [[desert]].

[[Surroundings]] are not directly linked to biomes (i.e. a [[glacier]] could be [[haunted]], [[wilderness]] or [[mirthful]]), but the more biomes you have, the more likely it is to have several alignments, if so desired.

If your plot contains only [[ocean]], [[lake]] or [[mountain]] biomes you will not be able to embark. The dwarves would have difficulty parking their [[wagon]] on water, while mountains are too barren and remote to reach.

The exact process is unknown, but no relation has been found between biomes and the stone layers that lie deep beneath them in the same area block. They do seem to be influenced by the first, top layer - a top layer of sand seems to cause drier biomes, where swamps rarely (if ever?) appear on sand, and (obviously) plants and trees do not grow on a top layer of stone. (More research is needed.)

== Available Biomes ==

=== Arctic ===
*Arctic [[Ocean]]
*[[Badlands]]
*[[Glacier]]
*[[Mountain]]
*[[Rocky wasteland]]
*[[Sand desert]]
*[[Tundra]]
*[[Taiga]]

=== Temperate ===
*[[Temperate]] [[Broadleaf forest]]
*Temperate [[Conifer forest]]
*Temperate [[Grassland]]
*Temperate [[Lake|Freshwater lake]]
*Temperate [[Marsh|Freshwater marsh]]
*Temperate [[Swamp|Freshwater swamp]]
*Temperate [[Ocean]]
*Temperate [[Marsh|Saltwater marsh]]
*Temperate [[Swamp|Saltwater swamp]]
*Temperate [[Savanna]]
*Temperate [[Shrubland]]

=== Tropical ===
*[[Tropical]] Dry [[Broadleaf forest]]
*Tropical Wet [[Broadleaf forest]]
*Tropical [[Conifer forest]]
*Tropical [[Marsh|Freshwater marsh]]
*Tropical [[Grassland]]
*Tropical [[Ocean]]
*Tropical [[Savanna]]
*Tropical [[Shrubland]]

==Biomes at World Generation==

Biomes are created at [[world generation]] based on the elevation, rainfall, and drainage of the tile as follows:

{|{{prettytable}}
|-style="background:#dddddd"
!Biome !!Elevation !!Rainfall !!Drainage
|-
|Water ||0-99 ||Any ||Any
|-
|Sand Desert ||100-299 ||0-9 ||0-32
|-
|Rock Desert ||100-299 ||0-9 ||33-49
|-
|Desert Badlands A ||100-299 ||0-9 ||50-65
|-
|Desert Badlands B ||100-299 ||0-9 ||66-100
|-
|Grassland ||100-299 ||10-19 ||0-49
|-
|Savanna ||100-299 ||20-32 ||0-49
|-
|Marsh ||100-299 ||33-65 ||0-32
|-
|Shrubland ||100-299 ||33-65 ||33-49
|-
|Hills ||100-299 ||10-65 ||50-100
|-
|Swamp ||100-299 ||66-100 ||0-32
|-
|Forest ||100-299 ||66-100 ||33-100
|-
|Low Mountain ||300-332 ||Any ||Any
|-
|Mountain ||333-365 ||Any ||Any
|-
|High Mountain ||366-400 ||Any ||Any
|}

== See Also ==
*[[Regions]] for the possible values for Trees, Vegetation and Surroundings.
*[[Volcano]]es which are not a biome in Dwarf Fortress, but may provide important resources
*[[Climate]]

{{World}}

[[Category:Biomes]]
[[Category:World]]

40d Talk:Biome

2009-06-27T05:07:37Z

Darekun: /* From the forums */ The "missing" range is right there, Hills.

40d:Biome

2009-06-27T05:01:27Z

Darekun: /* Biomes at World Generation */ Added the missing "hills" biome, as originally noted by Dorten on the talk page.

A '''biome''' is a biotic area with homogeneous features, characterized by distinctive [[plant]]s, [[creatures|animal species]] and [[climate]]. A biome will also contain only one set of stone layers, though these usually expand beyond a single biome. Your [[dwarves]] will find different resources depending on which biomes they select when starting a fort.

== Selecting a biome ==

Biomes are important when choosing a fortress location in order to understand your [[surroundings]]. Individual biomes, which form at least one map-tile of your embark location, can be cycled with the {{Key|F#}}-keys; for example, an area with 3 biomes present can be cycled using {{Key|F1}}, {{Key|F2}} and {{Key|F3}}. The selected biome will be highlighted with flashing Xs on the Local Map, and the biome's information will be displayed on the right side of the screen. ''(See the [[Indecisive%27s_illustrated_fortress_mode_tutorial|illustrated guide]] for more detail).''

== Understanding Biomes ==
we should have more details on what these "resources" actually are, or more examples?

Selecting different Biomes gives you some abiltiy to influence the difficulty of your game. A wide variety of biomes may give you access to several unique resources provided by each, like the ability to gather and plant certain crops and make the game easier and more interesting. Generally it is advantageous to plot your embark [[location]] at the convergence of multiple different biomes, the more the better (within reason) - which is made easier if you enlarge your starting embarkation area).
* ''Note: Making the starting plot larger will slow your game down considerably; likewise, a small embark area can dramatically increase framerate.{{version|0.28.181.40d}}''

By making use of several biomes you can provide more resources for your fort. Making sure one of your biomes contains either a [[broadleaf]] or [[conifer]] [[forest]] will provide you with an ample supply of [[tree]]s, even if the rest of your plot extends into badlands and [[desert]].

[[Surroundings]] are not directly linked to biomes (i.e. a [[glacier]] could be [[haunted]], [[wilderness]] or [[mirthful]]), but the more biomes you have, the more likely it is to have several alignments, if so desired.

If your plot contains only [[ocean]], [[lake]] or [[mountain]] biomes you will not be able to embark. The dwarves would have difficulty parking their [[wagon]] on water, while mountains are too barren and remote to reach.

The exact process is unknown, but no relation has been found between biomes and the stone layers that lie deep beneath them in the same area block. They do seem to be influenced by the first, top layer - a top layer of sand seems to cause drier biomes, where swamps rarely (if ever?) appear on sand, and (obviously) plants and trees do not grow on a top layer of stone. (More research is needed.)

== Available Biomes ==

=== Arctic ===
*Arctic [[Ocean]]
*[[Badlands]]
*[[Glacier]]
*[[Mountain]]
*[[Rocky wasteland]]
*[[Sand desert]]
*[[Tundra]]
*[[Taiga]]

=== Temperate ===
*[[Temperate]] [[Broadleaf forest]]
*Temperate [[Conifer forest]]
*Temperate [[Grassland]]
*Temperate [[Lake|Freshwater lake]]
*Temperate [[Marsh|Freshwater marsh]]
*Temperate [[Swamp|Freshwater swamp]]
*Temperate [[Ocean]]
*Temperate [[Marsh|Saltwater marsh]]
*Temperate [[Swamp|Saltwater swamp]]
*Temperate [[Savanna]]
*Temperate [[Shrubland]]

=== Tropical ===
*[[Tropical]] Dry [[Broadleaf forest]]
*Tropical Wet [[Broadleaf forest]]
*Tropical [[Conifer forest]]
*Tropical [[Marsh|Freshwater marsh]]
*Tropical [[Grassland]]
*Tropical [[Ocean]]
*Tropical [[Savanna]]
*Tropical [[Shrubland]]

==Biomes at World Generation==

Biomes are created at [[world generation]] based on the elevation, rainfall, and drainage of the tile as follows:

{|{{prettytable}}
|-style="background:#dddddd"
!Biome !!Elevation !!Rainfall !!Drainage
|-
|Water ||0-99 ||Any ||Any
|-
|Sand Desert ||100-299 ||0-9 ||0-32
|-
|Rock Desert ||100-299 ||0-9 ||33-49
|-
|Desert Badlands A ||100-299 ||0-9 ||50-65
|-
|Desert Badlands B ||100-299 ||0-9 ||66-100
|-
|Grassland ||100-299 ||10-19 ||0-49
|-
|Savanna ||100-299 ||20-32 ||0-49
|-
|Marsh ||100-299 ||33-65 ||0-32
|-
|Shrubland ||100-299 ||33-65 ||33-49
|-
|Hills ||100-299 ||10-65 ||50-500
|-
|Swamp ||100-299 ||66-100 ||0-32
|-
|Forest ||100-299 ||66-100 ||33-100
|-
|Low Mountain ||300-332 ||Any ||Any
|-
|Mountain ||333-365 ||Any ||Any
|-
|High Mountain ||366-400 ||Any ||Any
|}

== See Also ==
*[[Regions]] for the possible values for Trees, Vegetation and Surroundings.
*[[Volcano]]es which are not a biome in Dwarf Fortress, but may provide important resources
*[[Climate]]

{{World}}

[[Category:Biomes]]
[[Category:World]]

40d:Biome

2009-06-27T03:51:36Z

Darekun: /* Available Biomes */ Corrected temperature band from "arid" to "arctic".

A '''biome''' is a biotic area with homogeneous features, characterized by distinctive [[plant]]s, [[creatures|animal species]] and [[climate]]. A biome will also contain only one set of stone layers, though these usually expand beyond a single biome. Your [[dwarves]] will find different resources depending on which biomes they select when starting a fort.

== Selecting a biome ==

Biomes are important when choosing a fortress location in order to understand your [[surroundings]]. Individual biomes, which form at least one map-tile of your embark location, can be cycled with the {{Key|F#}}-keys; for example, an area with 3 biomes present can be cycled using {{Key|F1}}, {{Key|F2}} and {{Key|F3}}. The selected biome will be highlighted with flashing Xs on the Local Map, and the biome's information will be displayed on the right side of the screen. ''(See the [[Indecisive%27s_illustrated_fortress_mode_tutorial|illustrated guide]] for more detail).''

== Understanding Biomes ==
we should have more details on what these "resources" actually are, or more examples?

Selecting different Biomes gives you some abiltiy to influence the difficulty of your game. A wide variety of biomes may give you access to several unique resources provided by each, like the ability to gather and plant certain crops and make the game easier and more interesting. Generally it is advantageous to plot your embark [[location]] at the convergence of multiple different biomes, the more the better (within reason) - which is made easier if you enlarge your starting embarkation area).
* ''Note: Making the starting plot larger will slow your game down considerably; likewise, a small embark area can dramatically increase framerate.{{version|0.28.181.40d}}''

By making use of several biomes you can provide more resources for your fort. Making sure one of your biomes contains either a [[broadleaf]] or [[conifer]] [[forest]] will provide you with an ample supply of [[tree]]s, even if the rest of your plot extends into badlands and [[desert]].

[[Surroundings]] are not directly linked to biomes (i.e. a [[glacier]] could be [[haunted]], [[wilderness]] or [[mirthful]]), but the more biomes you have, the more likely it is to have several alignments, if so desired.

If your plot contains only [[ocean]], [[lake]] or [[mountain]] biomes you will not be able to embark. The dwarves would have difficulty parking their [[wagon]] on water, while mountains are too barren and remote to reach.

The exact process is unknown, but no relation has been found between biomes and the stone layers that lie deep beneath them in the same area block. They do seem to be influenced by the first, top layer - a top layer of sand seems to cause drier biomes, where swamps rarely (if ever?) appear on sand, and (obviously) plants and trees do not grow on a top layer of stone. (More research is needed.)

== Available Biomes ==

=== Arctic ===
*Arctic [[Ocean]]
*[[Badlands]]
*[[Glacier]]
*[[Mountain]]
*[[Rocky wasteland]]
*[[Sand desert]]
*[[Tundra]]
*[[Taiga]]

=== Temperate ===
*[[Temperate]] [[Broadleaf forest]]
*Temperate [[Conifer forest]]
*Temperate [[Grassland]]
*Temperate [[Lake|Freshwater lake]]
*Temperate [[Marsh|Freshwater marsh]]
*Temperate [[Swamp|Freshwater swamp]]
*Temperate [[Ocean]]
*Temperate [[Marsh|Saltwater marsh]]
*Temperate [[Swamp|Saltwater swamp]]
*Temperate [[Savanna]]
*Temperate [[Shrubland]]

=== Tropical ===
*[[Tropical]] Dry [[Broadleaf forest]]
*Tropical Wet [[Broadleaf forest]]
*Tropical [[Conifer forest]]
*Tropical [[Marsh|Freshwater marsh]]
*Tropical [[Grassland]]
*Tropical [[Ocean]]
*Tropical [[Savanna]]
*Tropical [[Shrubland]]

==Biomes at World Generation==

Biomes are created at [[world generation]] based on the elevation, rainfall, and drainage of the tile as follows:

{|{{prettytable}}
|-style="background:#dddddd"
!Biome !!Elevation !!Rainfall !!Drainage
|-
|Water ||0-99 ||Any ||Any
|-
|Sand Desert ||100-299 ||0-9 ||0-32
|-
|Rock Desert ||100-299 ||0-9 ||33-49
|-
|Desert Badlands A ||100-299 ||0-9 ||50-65
|-
|Desert Badlands B ||100-299 ||0-9 ||66-100
|-
|Grassland ||100-299 ||10-19 ||0-49
|-
|Savanna ||100-299 ||20-32 ||0-49
|-
|Marsh ||100-299 ||33-65 ||0-32
|-
|Shrubland ||100-299 ||33-65 ||33-49
|-
|Swamp ||100-299 ||66-100 ||0-32
|-
|Forest ||100-299 ||66-100 ||33-100
|-
|Low Mountain ||300-332 ||Any ||Any
|-
|Mountain ||333-365 ||Any ||Any
|-
|High Mountain ||366-400 ||Any ||Any
|}

== See Also ==
*[[Regions]] for the possible values for Trees, Vegetation and Surroundings.
*[[Volcano]]es which are not a biome in Dwarf Fortress, but may provide important resources
*[[Climate]]

{{World}}

[[Category:Biomes]]
[[Category:World]]

40d Talk:Biome

2009-06-27T03:46:45Z

Darekun: /* Tropical */ It's high temperatures.

How do the stuff you can search for (rainfall, drainage, etc) interact with what biomes form in a region? [[User:Random832|Random832]] 01:46, 21 November 2008 (EST)

:Very good question. I want lots and lots of forests in my worlds because I like elephants for their big droopy asses.--[[User:Maximus|Maximus]] 04:22, 21 November 2008 (EST)
::Apparently, every biome has some combintions of parameters valis. For example: low rainfall + high drainage = desert, and so on... But we need to gather complete list. Worldgen cookbook is a good place to search for info already known. and we can ask Toady--[[User:Dorten|Dorten]] 06:45, 21 November 2008 (EST)

== From the forums ==

Hello again.

Since it took me some time to figure these out, im posting them for everyone to save their time. Biome names are taken from wiki by comparing with map legend from here: http://www.dwarffortresswiki.net/index.php/Map_legend , although there seem to be some discrepancies.

Sav and Volc are irrelevant to biomes in world editor.

By elevation:

Water
Elevation: 1 - 99

Low Mountain
Elevation: 300 - 332

Mountain
Elevation: 333 - 365

High mountain
Elevation: 366 - 400

Everything else
Elevation: 100 - 299

By rain/drain:

Hill
Rain: 10 - 66
Drain: 50 - 100

Sand Desert
Rain: 0-9
Drain: 0-32

Rock Desert
Rain: 0-9
Drain: 33-49

Desert Badlands A
Rain: 0-9
Drain: 50 - 65

Desert Badlands B
Rain: 0-9
Drain: 66 - 100

Second Desert Badlands biome (per wiki), occupying higher drain areas

Grassland
Rain: 10-19
Drain: 0-49

Savanna
Rain: 20-32
Drain: 0-49

Marsh
Rain: 33-65
Drain: 0-32

The character is darker than marsh in wiki map legend and matches that of a swamp instead, but on wiki both marsh and savanna have the same characters, so im guessing this one actually is marsh.

Shrubland
Rain: 33-65
Drain: 33-49

Swamp
Rain: 66-100
Drain: 0-32

Forest
(conifer icon, probably means temperate)
Rain: 66-100
Drain: 33-100

Forest becomes Broadleaf in high temperatures, which makes it the only biome in world editor that is dependant on temperature. Im guessing that the character for Conifer actually serves for temperate conifer and broadleaf, and the broadleaf icon means tropical broadleaf forest, because thats what the rain/temp/drain stats suggest, and otherwise there would be no differentiation between temperate and tropical.

Forest
(broadleaf icon, probably means tropical)
Temperature: ~ 60-75 (varies a bit for different drain values) --[[User:Dorten|Dorten]] 07:34, 21 November 2008 (EST)

:I added this info to the page, but I notice there seem to be missing ranges; what happens if rainfall is 0-65 and drainage is 50-100? --[[User:FunkyWaltDogg|FunkyWaltDogg]] 22:07, 28 March 2009 (UTC)

== Biomes and stone layers ==

Biomes have no relation to the [[stone]] [[layer]](s) that lie below them, beyond
the first (which is often a type of [[soil]].
:How sure are we about this? [[User:VengefulDonut|VengefulDonut]] 12:26, 3 June 2009 (UTC)
:: I haven't seen any correlation between rock layers and biomes. Other than granite which is often the base of mountains and is more common there. There are a few soil types that are found only in the ocean, but those are normally never encountered unless you extend your embarkation zone way out to sea.--[[User:Smjjames|Smjjames]] 14:10, 3 June 2009 (UTC)
:::No, VD is right - it's "apparent", it's intuitive, it's logical, it's that way in RL, but it's not conclusive nor is there any concrete supporting evidence (proving the absence of something - never easy). It was my post - I'll edit to reflect that.--[[User:Albedo|Albedo]] 17:40, 3 June 2009 (UTC)
::: Hmm, now that I think about it, diorite is often found in mountains, sometimes even as two layers on top of each other. According to Wiki ( http://en.wikipedia.org/wiki/Diorite ), it is associated with mountain building and volcanism. I also find it associated with other igneous rocks in biomes and I rarely see diorite outside of either mountains or volcanic areas. This is going to require quite a bit of observation and note taking.--[[User:Smjjames|Smjjames]] 18:42, 3 June 2009 (UTC)

== Tropical ==
So is there a way to influence worldgen so that it produces more tropical biomes? Cos i have a hard time finding ''any'' on my worlds :( Or search tips? --[[User:Confused|Confused]] 02:09, 23 June 2009 (UTC)
:Tropical is a temperature band, so increase the temperatures, especially the min. You may also want to reduce the X and Y variance of temperatures, to get a steady Tropical throughout.
:However, this kind of "uniformity tweak" often results in infinite map rejections - turn on map rejection logging, and if you get a bunch of rejections see what they are, and zero out the demands for the listed biomes or traits. The defaults don't seem to demand any glacier or tundra, so I don't ''think'' all-tropical will be a problem.
:Searching for High Temperature should find any tropical biomes that did gen. [[User:Darekun|Darekun]] 03:46, 27 June 2009 (UTC)

40d:Legendary artifact

2009-05-07T19:33:34Z

Darekun: Use includes for selling.

Dwarves in [[strange mood]]s will create '''legendary artifacts''': unique, "named" items which are of unsurpassable quality (and usually cost). An artifact is the ultimate expression of a [[dwarf]]'s desires, fears, memories and hopes in art form, and each dwarf will produce only one in their lives (or die trying). [[Dwarves]] that create an artifact are always granted the status of [[legendary]] unless they were [[Strange_mood#Possessed|possessed]].

Dwarves drop artifacts in the [[workshop]] or in an appropriate [[stockpile]] as soon as they are made. They can then be used just like other items, but not sold. However, be warned that when a dwarf equips an artifact item (as a weapon or armour) he will never drop it, and may even carry around several artifact weapons in each hand{{version|0.27.176.38c}}. Of course, you might not see a champion [[swordsdwarf]] wielding eight artifact [[adamantine]] scimitars at once as a bad thing.

Artifacts cannot be destroyed unless lost in a [[chasm]] or dropped to the [[magma]]. They ''can'' be stolen by marauding parties; an artifact lost to you will have a note to that effect in the Artifacts screen(press {{k|l}}).

==Construction==
Dwarves will use anywhere from one to ten items in their construction. If you view ({{k|q}}) the [[workshop]] a dwarf has seized while the dwarf is in it, you can see what materials he or she plans to use (see [[strange mood]]s for further details). Once the dwarf has started to construct the artifact, you can also use {{k|t}} to see exactly what materials they have claimed.

Workshops which normally require fuel ([[Forge]], [[Glass furnace]]) do not require and will not use fuel to make an artifact at that shop. Magma versions which lose power, however, will immediately cause the moody dwarves mood to end (with disastrous consequences).

==Usage==
Currently, some artifacts can be used just like all other items, except that it cannot be traded to [[caravan]]s. Artifacts of types which can be built ([[furniture]], [[animal trap]]s, [[chain]]s, etc...) can be built as normal. Often artifacts of this nature are used to meet noble room requirements or establish high-quality dinning halls as a single artifact is typically capable of bumping a room up to royal quality on its own, however a particularly poor artifact may turn it to at least grand. Object types which are used for storage in stockpiles ([[bin]]s, [[barrel]]s) will be used by your dwarves without regard to their status.

Object types which require a dwarf to wear or use the item will generally not be used by your dwarves, with the exception of artifact weapons and armor. Artifact weapons and armor can be used by elite and [[champion]] warriors, although these warriors will refuse to relinquish ownership of the item even if you instruct them to wield different weapons or wear different armor - only their death will free up the artifact for reassignment. This means that an artifact axe can be wielded by your elite or better axedwarf, but could not be used for woodcutting. Similarly, an artifact pick will never be used by your miners.

==Quality==
Artifact items have a [[quality|quality modifier]] of 120×. This is applied on top of the item's [[item value#Base values of items|base value]], its [[decoration]]s and the value of all [[item value#Material multipliers|material]]s used in its construction.

Artifacts will automatically have one "free" decoration of the same type as its base material. For instance, a "Perfect Ruby" might have "Images of mangrove trees in Ruby". This decoration doesn't consume additional materials: in the above example, only one ruby was used.

Item types which normally require multiple objects to create (such as Platemail) will cause the moody dwarf to acquire that number of objects, but each such object will also contribute a decoration - basically, the item receives multiple free decorations. For example, artifact gold platemail will use a minimum of 3 objects (3 bars of gold), and have 3 gold decorations.

Artifacts can range in value from 2,400☼ (all-stone furniture or finished good) to 7,200,000☼ (full-decorated adamantine Platemail). Since [[immigration]] totals are - among other factors - based on your fortress's "Created Wealth" (and held/worn items count double in the total), expensive artifacts are often the driving factor behind how many immigrants show up in the first years.

Artifact [[armour]] and [[weapons]] have a high damage/protection modifier, at least greater than a similar [[iron]] item of basic quality. Though even [[steel]] artifacts will not surpass basic quality adamantine items. Note that the material of a [[crossbow]], artifact or not, does not change its shooting abilities, only its viability in melee. However, higher quality crossbows shoot better. For example, a masterpiece crossbow will shoot better than a finely crafted one.{{verify}} Only dwarves with hero status{{verify}} will use artifact weapons or armor.

It is possible artifact makers may occasionally glitch in the number of goods needed, with a corresponding increase in value (eg, [http://www.bay12games.com/forum/index.php?topic=28232.0 this monstrosity]).
[[Category:Items]]
[[Category:Lore]]

40d Talk:Dwarven economy

2009-05-07T19:28:58Z

Darekun: /* Tips for living with economy? */ "Exploit" relative to the thing the game's trying to simulate.

1) Wages paid --- dwarves gain credit for tasks completed. Credit is either maintained or transferred into physical value when the dwarf in question claims coins.

2) Rent --- bedrooms have a rent assigned to them based on their room value. The rent schedule is unknown. How the dwarves physically pay the rent is unknown. If a dwarf cannot pay the rent an eviction notice is placed on the room. The specifics of eviction are unknown. Dwarves that cannot afford one of the available bedrooms will sleep in available barracks.

3) Shops --- Once the economy begins, shops may be constructed. There are several types of shops - clothing, general goods, exotic clothing and possibly others. A type of shop may not be specified; it seems to be selected randomly. Shops have an associated cost, which is assumed to be paid by the dwarf that takes control of the shop. Once a shop is owned, items will be moved to the shop corresponding to which type of shop it is. Dwarves then may buy items for the shop, presumably using the same credit system that may or may not correspond to actual physical coins.

4) Item cost - all physical items are given a cost, whether for sale or in a shop. It is unknown if dwarves pay a cost for an item picked up that was not for sale in a shop.

also - kids have combined wealth of their parents, which can lead to paris hilton-syndrome in DF - children with wealth of several thousand buying out the noble/admin rooms and owning shops filled with =giant cave spider silk dress= --[[User:Frostedfire|Frostedfire]] 04:07, 20 November 2007 (EST)

----

It seems that the dwarven economy is now triggered by the coming of a Baron /Baroness. I haven't seen it for myself but it's what I gather from the forums. There also seems to be a bug where all coins minted appear as the same coin type (e.g., copper, silver, and gold coins all appearing as silver) on the economy window. --[[User:Keizo|Keizo]]

Just got the dwarven economy started for the first time. The game is a bit tricky to play in wine. ^^;;. Anyway, since there isn't any page here yet, I'm sort of lost, so I've added what I already know so other folks will be at least a *little* less lost :-P

Typically a page will be expanded a lot more quickly if you actually already have some content on it,.Please expand! --[[User:Kim Bruning|Kim Bruning]] 19:48, 1 December 2007 (EST)

None of my legendary dwarves have an account in their status screen.
Does this mean that they are exempt from prices or something?--[[User:Pigbuster|Pigbuster]]
:They always have been.--[[User:Heliopios|Heliopios]] 01:05, 6 December 2007 (EST)

== Wages ==

What is the deal with "- haulage being a major exception - "? Last time I checked there were some wages for item hauling, furniture hauling, food hauling,... on the in-game {{key|j}}{{key|m}}{{key|w}} wages info page. Of course a dwarf can spend a month hauling a rock to a stockpile and get his 1* for it, but a job of taking food from a stockpile and relocating it to an adjacent stockpile can yield a dwarf dozens of * in quite small period of time. Place 10-20 medium sized stockpiles accepting all furniture in a line and set them to take from each other in chain so that the first small stockpile is the closest to your workshops and your last large main furniture stockpile is the closest to your currently furnishing rooms. Watch your haulers' bank accounts sky-rocket.--[[User:Another|Another]] 05:24, 10 January 2008 (EST)

Who and whern/how can change wages percentage on first "Wages" screen? It's always 100% for me--[[User:Dorten|Dorten]] 06:53, 14 February 2008 (EST)
:one of the nobles can, but rarely does so (bookkeeper?)

== Soldiers ==
Will the soldiers pay for getting armor or weapons?--[[User:Dorten|Dorten]] 05:10, 11 January 2008 (EST)
:No, they don't own them.--[[User:Maximus|Maximus]] 18:11, 11 January 2008 (EST)

== No Coin Economy==

How does an economy work without any coins? Do they use pretend money or something?
:Every dfwarf starts an account in DwarfEcoBanc, and is always carrying his/her credit card. But if you will be stupid enough to give them money (like I did last time), they would prefer to use money instead of card. In case you don't get it: you don't want them to use money, really.--[[User:Dorten|Dorten]] 23:59, 21 January 2008 (EST)

:It works just the same as in the Real Life. As opposed to the economy of the old, when coins were units of precious metals, with real actual value attached to them, currently all money is created as a credit from the central bank (which is paid by taking a new credit). Dwarves get credit from you for work they do, and you can pay it back by providing them with goods other dwarves produced (for another credit). For coins, you must mint actual metal. For going into infinite debt, you don't need anything, and you can never run out of it (gold bars go down to zero, debt goes to minus infinity). But without inflation, it doesn't really hurt in the long run like it does in the Real Life.

== How is this a feature? ==
I dig the realism and all, but the only effect the economy has had on my fortress is that my hard working dwarves now can't afford the rooms they've been sleeping in for the past ten years, while my nobles and champions (junta?) live in solid gold mansions. I went straight to the .ini and turned economy off. [[User:Ripheus|Ripheus]] 18:49, 6 March 2008 (EST)
:Yeah, well, the pricing of those rooms doesn't work by supply and demand for some reason, they have fixed cost. But still I kind of like the idea of an economy, and it seems a bit odd to "strongly recommend" that you shouldn't mint coins etc. I haven't even seen them hauling any of those coins. --[[User:Magirot|Magirot]] 09:18, 29 March 2008 (EDT)

It's ironic that without coins, the economy actives better. Kinda like using credit cards instead of coins (Maybe a hint to the government to stop making coins?!) --[[User:AlexFili|AlexFili]] 04:17, 9 June 2008 (EDT)

== Economy Trigger(s) ==
We know what triggers the economy, but what does having an active economy trigger? The most obvious is nobles, but there are a couple other things I've noticed. First, whether it's related to the economy or not, my only fortress that's ever been under siege has had an active economy, while my others that only get random goblin attacks did not. Likewise that fortress is my only fortress that has gotten megabeast attacks. It may or may not be related, as most of my fortresses before it didn't get as big as it is. (80 or so highest vs 110) --[[User:Eurytus|Eurytus]] 22:09, 21 April 2008 (EDT)
:Both of sieges in my current fortress (40c) were prior to the economy starting, so I don't think the economy is causal. I think it has to do with population and wealth. More dwarves attract more attention and the pickings are better with more wealth. -[[User:Fuzzy|Fuzzy]] 12:02, 8 September 2008 (EDT)
I don't believe its a trigger for anything. My current fortress has been besieged five times and attacked by a Dragon. All this happened before I unlocked the economy.--[[User:Max Dougwell|Max Dougwell]] 07:08, 3 December 2008 (EST)

::as soon as i got my economy up and running, i had my first siege, then my first (ever) megabeast attack straight after. similar to Eurytus, it's never happened in any of my other fortresses (only one siege prior to these two attacks, in a different fortress).
::however, i will add that in the year before, i was producing native platinum statues, increasing the fortress wealth considerably (native platinum = 120, native platinum statues = 3k), so what's the formula for it? is it:
Wealth = Attacks?
Economy = Attacks?
Wealth = Economy = Attacks? or maybe
Wealth = Attacks + Economy?

== Starving ==
"Dwarves will not starve because they cannot buy food; they just choose whatever's cheapest." - Is this true? It seems that dwarves whitout money die from either hunger or thirst. --[[User:Mizipzor|Mizipzor]] 14:16, 24 April 2008 (EDT)

:I do believe eg plump helmets are 1* per unit, they only need to move a couple rocks ;) --[[User:Frostedfire|Frostedfire]] 10:30, 20 June 2008 (EDT)

== Setting economy to NO (ini file) stop immigration ? ==

Hello, because I really dont like economy (I want to assign bed manually !), I've desactivated it in the .ini files... but now, I haven't receive any migrants for 2 years, and my population is slowly reducing 'cause of the accidentals death.
Anyone know if desactiving the economy (just before the arrival of the baron which trigger economy) also desactive immigration ?

Again, sorry for my imperfect english. [[User:Timst|Timst]] 08:59, 26 April 2008 (EDT)
:caravan reports summon migrants, large numbers of deaths or lack of wealth stop it

== Childrens' accounts ==

"Normal" children are really wealthy - they sleep in rooms for nobles, eat roasts and buy golden things. I heard that they have combined wealth of their both parents. It's pretty crazy.
On the other hand noble children... My baroness has a son, who has 3 (yes, 3) monies on his account...
Isn't it really strange? --[[User:Someone-else|Someone-else]] 06:52, 6 May 2008 (EDT)
:His parents has no money, really. So, he has only three pennies he got hardworking in the fields, harvesting...--[[User:Dorten|Dorten]] 05:04, 16 June 2008 (EDT)
It appears Legendary Dwarves still get paid, despite being able to take whatever they please. My child of two Legendary Dwarves has 256 in her account. Either that or she's doing odd jobs when I'm not watching.--[[User:Max Dougwell|Max Dougwell]] 07:13, 3 December 2008 (EST)

::That may be leftover from before the parents were legendary. I've seen children of two legendary dwarves maintain a constant or decreasing cash supply following the ascension of the second parent to legendary, despite abundant in-profession work for both parents which should rapidly provide a huge influx of cash. I can only conclude legendary dwarves no longer earn money. --[[User:Squirrelloid|Squirrelloid]] 05:47, 29 December 2008 (EST)

:::They don't need money, they're exempt from the economy. Also, the children of nobles NOT BEING NOBLES THEMSELVES can create the amusing situation of the baron's son dying of hunger, if you keep churning out *plump helmet roast*s.--[[User:Zipdog|Zipdog]] 06:16, 19 April 2009 (UTC)

== Necessary for nobles? ==

It's currently not very clear whether or not the economy needs to be enabled in order for nobles to continue arriving. For instance, the hammerer, barons, etc. Is there any confirmed knowledge of which nobles will or won't come depending on whether or not the economy is enabled in the init file? [[User:G-Flex|G-Flex]] 22:09, 6 June 2008 (EDT)

:All right, a friend of mine just confirmed through play that such nobles, even the tax collector, will still come even with the economy disabled. He's got a count (and consort), hammerer, tax collector, dungeon master, and philosopher (at least those are the ones I know of). [[User:G-Flex|G-Flex]] 04:25, 16 June 2008 (EDT)

== Effects of turning it off, once it's on? ==

Changing ECONOMY to NO in the init.txt file after the economy has kicked in doesn't seem to keep dwarves from spending already-earned credit at shops. (I haven't seen them paying for drink, so it may be that food and drink are now free; I'm not sure, though, because I haven't yet watched them pay for drinks while the economy is turned on, so I don't know when that happens.) --[[User:Sev|Sev]] 17:00, 28 August 2008 (EDT)

== Effect of turning it on, once it's off? ==

If you turn the economy off and get the tax collector, baron, etc... what happens when you turn it back on? Does the economy start back up, or do you only get one shot at it? I don't think I want the economy but if I miss the opportunity to ever turn it on, then it becomes a tough choice. --[[User:Sowelu|Sowelu]] 02:22, 27 November 2008 (EST)

== Tips for living with economy? ==

I just read a suggestion on the forum, and was going to add it to a list of economy-survival tips, but there doesn't seem to be one. [http://www.bay12games.com/forum/index.php?topic=29016.msg373478#msg373478 here's the forum post]. Shouldn't there be such a page? [[User:Solarshado|Solarshado]] 21:57, 25 December 2008 (EST)
:There's a couple tricks for this. The casino mentioned there, triangle stockpiles (3 stone stockpiles that are all taking from eachother, making constant hauling work), etc. However, everything like this is classifiable as an exploit since if you put it in the context of an actual economy it would cause gigantic economic inflation and currency devaluation almost overnight. Really that's all you're doing with techniques like this; you're devaluing what a single ☼ means until it's basically nothing, and taking advantage of the fact that the DF engine doesn't currently have a way to adjust for inflation.

:Really, living with economy in a legit, as-intended manner is just making sure there are enough meaningful jobs to do. Growing [[dimple cup]]s and starting a dyeing attachment to a fully blown clothing industry can employ dozens of dwarves around the clock using only the caravans as resources (for importing cloth and the appropriate volume). Skilled work like sewing clothes, dying cloth, sewing leather/cloth images, etc all give 20☼ or more for a single job. A dwarf can afford a very nice apartment and very nice food, with enough money left over to go shopping, if they have a skilled-labor job to do.

:Alternatively, you can just provide a way to become legendary easily. Screw pumps connected to nothing will make Pump Operators legendary pretty quickly, especially if other duties are minimized.

:Anyway, it might be worth adding this as a few notes, but I'm not sure there's enough to say to make a full section about it. --[[User:ThunderClaw|ThunderClaw]] 23:03, 25 December 2008 (EST)

::Its hard to talk about exploiting an economy which actually operates under an absolute theory of value rather than supply and demand. Once you assume an absolute theory of value as your model of economics, inflation simply cannot exist and the concept doesn't even make sense.

::Ie, meaningless hauling jobs -> inflation is only an exploit if the price of goods fluctuates because of supply and demand. Or you can just look at it as making dwarves do non-productive wage-paying jobs compensates for the unavoidable 'exploit' that is the stupidity of there being abundantly available rooms of quality X remaining at a stupidly high value instead of having their price become more affordable in the absence of sufficient demand for them at their current price.

::--[[User:Squirrelloid|Squirrelloid]] 05:44, 29 December 2008 (EST)
:::This is exactly what makes it an exploit. If the system took into account inflation and supply and demand, then this would not be an exploit. The fact that it does not count these things means that the infinite hauling jobs pay out pleanty of cash while achieving no net bennefit to the community, but are still not effecting the value of money. :P It is like turning your dwarven colony into a welfare state without the economic drawbacks! [[User:Burlingk|Burlingk]] 20:39, 11 February 2009 (EST)

::::No. Ok, lets be perfectly clear here, while there have been many theories about what creates value, the real economic model has always been supply and demand in the real world. You have just at various times had people pretending that other things were true (and generally not those whose business involved intimate interaction with said economy, who have always understood how supply effects price, if nothing else). So in the real world when you try to pretend something wrong is true there are horrible consequences.
::::Enter DF, which specifically institutes as a law of nature a theory of value totally at odds with supply and demand. Given the existence of that Truth of the DF world, nothing involving it can be an exploit because it does not and cannot behave like any real economy. Fact: DF posits a world with an absolute theory of value. Fact: given an absolute theory of value, pulling a lever really does have a set value even if pulling it accomplishes nothing - because the act of pulling that lever has been defined by the laws of nature as being worth a particular set amount. That action has an absolute value, just like every other action.
::::What it comes down to is the DF theory of value is *stupid*. However, all these exploits are actually such a thing working exactly as intended, its just the intention is stupid. But as such its not an exploit - an exploit requires something working differently than intended. The moment you assume an absolute theory of value, you necessarily intend for things like this to happen.
::::--[[User:Squirrelloid|Squirrelloid]] 04:25, 14 February 2009 (EST)
:::::It's an ALPHA. The entire game engine is just a placeholder. Nothing can be taken as cannon at this stage. --[[User:Zchris13|Zchris13]] 17:48, 25 February 2009 (EST)
::::::....I'm confused. Are you saying its an exploit because sometime later the design of the economy might change and lever pulling for cash would be an exploit of some presumed future system? That would make every use of the current economy an exploit. When the economic engine is fixed, if it is fixed, then doing the listed 'exploits' won't even be possible. Yes, my position is that an economic engine is impossible to exploit, because its rules are necessarily the rules its implemented to use.
::::::But there's no evidence that any change is coming. Not that i've read every feature goal and power goal, but i don't recall incorporating a supply-demand system is on Toadyone's list of priorities at all. And the fact that its an alpha just means he isn't done implementing what he considers basic features, according to his own design plan.
::::::--[[User:Squirrelloid|Squirrelloid]] 04:15, 26 February 2009 (EST)
:::::::The same "impossible to exploit" thing applies to all other imperfect simulations, though. By the same logic, you could say that a drawbridge deleting things isn't an exploit, because that's how drawbridges work in DF, or using one block of aquifer stone to produce unlimited water isn't an exploit, because that's how aquifers work in DF. Triangle stockpiles to generate unlimited money are just as much an exploit as running a waterfall from one block of aquifer stone through a water wheel to a drawbridge. It's not a matter of "some future version", it's a matter of "the thing the game's trying to simulate".
:::::::Notably, the lore doesn't include the dwarven economy operating on a labor theory of value, and the liaisons and guildmasters even use a demand/supply theory of value. So the absolute system is just an alpha-quality simulation of a demand/supply system, and taking advantage of that is an exploit.
:::::::Of course, this cuts both ways. For example, a proper economy uses mass action, similar to "the wiki magic"; but in DF as it stands, the player has to assign labors and order workshops built - a dwarf who sees a need can't just buy some space, some tools, and some materials, and start fulfilling it. So the economy also exploits you. But that doesn't make exploiting it back into any less of an exploit.
:::::::But hey, I've modded in some supermetals, and just by not taking the midnightsteel battleaxes I embark with loads of points for equipment, and I bring tetrahedrite and smelt it into billion. I just accept that I'm exploiting flaws and bugs in the game. [[User:Darekun|Darekun]] 19:28, 7 May 2009 (UTC)

== Are there any profits? ==
Is there any reason NOT to turn economy off, other than the extra challenge it creates (plus happy thoughts from shopping for those who can afford that)?
It looks that the original communism the Dwarves start with, serves them much better, especially that there seems to be little special profit from very happy dwarves, while there's a lot of trouble for the unhappy ones, and economy seems to create more of both extremes.
Also, slaughtering of the noble or the tax collector won't reverse to the no-economy, will it?
[[User:Sharp|Sharp]] 11:43, 26 January 2009 (EST)

:How can there be profit in a system of absolute values? What do you mean by 'profit'? The only profit in the game is the value added by labor, which isn't really profit but the value of the labor itself. Basically, the game operates under some rather strange economic assumptions (an unholy marriage of the labor theory of value and mercantilism). So no, there is absolutely no benefit to the dwarven economy, especially as its hardly worth the name economy. (Economics is about differential rarity and preferences, neither of which the game's economic engine takes into account). --[[User:Squirrelloid|Squirrelloid]] 01:17, 27 January 2009 (EST)
::I think you misunderstood me, I didn't mean "Profit" by economic meaning, I meant "changes in the mechanics of the game the player benefits from", "Profit" as opposed to "Trouble". [[User:Sharp|Sharp]] 13:05, 27 January 2009 (EST)
: You mean benefits? Extra complexity and [[fun|challenge]], of course! You get shops, coins with value, and an answer to the question, "My dwarves are all happy, what do I do now?" I have it disabled in the .ini, like any sane dwarfmaster. Oh wait, that's a contradiction in terms. But I still have my Baron->Count->Duchess and my Incoming King (pop limit 140). --[[User:Jellyfishgreen|Jellyfishgreen]] 06:12, 12 February 2009 (EST)

==Fake Deaths==

Toady should add a mechanic where a brewer pretends to kill himself in a pub fire to claim the insurance cos he can't afford a room.--[[User:Warlordzephyr|Warlordzephyr]] 16:29, 24 February 2009 (EST)

:Affordable life insurance couldn't possibly exist in a Dwarf Fortress. They die too easily. --[[User:FJH|FJH]] 17:11, 24 February 2009 (EST)
::Affordable life insurance. Classic. oh, this place cracks me up...--[[User:Zchris13|Zchris13]] 17:51, 25 February 2009 (EST)
:::In Dwarf Fortress, affordable life insurance is an [[artifact]] [[adamantium]] [[flail]]. --[[User:Jurph|Jurph]] 01:50, 17 April 2009 (UTC)
::::One word: Magma--[[User:Zipdog|Zipdog]] 06:29, 19 April 2009 (UTC)

40d:Miller

2009-05-04T07:30:06Z

Darekun: Verified "value is increased" note.

{{Skill
| color = rgb(128,128,0)
| skill = Miller
| speciality = Miller
| profession = [[Farmer]]
| job name = Milling
| tasks =
* [[Milling|Mill plants]] (uses a [[bag]])

| workshop =
* [[Millstone]]
* [[Quern]]
}}

A '''miller''' is a [[dwarf]] who mills [[crops|plants]] at either a [[quern]] or [[millstone]], placing the resulting goods into [[bag]]s. Milling produces one unit of [[dye]], [[flour]] or [[sugar]] per item milled. Milled items have no [[Item quality|extra quality]] associated with them.

A quern must be operated by the dwarf himself, while the millstone uses outside mechanical power (either a [[waterwheel]] or a [[windmill]]).

To mill a plant you need the plant to be milled and a [[bag]]. Milling does preserve plant seeds.

Milling plants is always done at 1:1 ratio; item number stays the same, but value is increased. All unmodded plants except whip vines mill to 10× plant value; whip vines are 25% better.

==List of millable plants==
===Plants that make powders (need to be [[cook]]ed)===
*[[Cave wheat]]
*:[[Dwarven wheat flour]]
*:Worth 20 ☼
*[[Sweet pod]]
*:[[Dwarven sugar]]
*:Worth 20 ☼
*[[Longland grass]]
*:[[Longland flour]]
*:Worth 20 ☼
*[[Whip vine]]
*:[[Whip vine flour]]
*:Worth 25 ☼

===Plants that make [[dye]]s===
*[[Dimple cup]]
*:[[Dimple dye]]
*:Dark blue
*:Worth 20 ☼
*[[Blade weed]]
*:[[Emerald dye]]
*:Green
*:Worth 20 ☼
*[[Hide root]]
*:[[Redroot dye]]
*:Red
*:Worth 10 ☼
*[[Sliver barb]]
*:[[Sliver dye]]
*:Black
*:Worth 20 ☼

== See also ==
*[[Crops]]
*[[The clothing industry]]

{{Skills}}
[[Category:Skills]]
[[Category:Jobs]]

40d:On break

2009-05-04T07:17:25Z

Darekun: /* How to stop breaks */ "Military culture" is still exploit.

Yes, [[dwarf|dwarves]] do have days off; sooner or later, all dwarves will go '''on break''' for some time. There is nothing you can do to stop it happening, but at least it's less annoying than [[parties]].

==How to stop breaks==
They will take more breaks if they are thirsty or have no access to [[alcohol]]. Give them lots of booze to keep them active.

You can cancel dwarves' breaks by [[draft]]ing them into the military and then immediately releasing them. This causes an unhappy [[thought]] if the dwarf has no military [[skill]]s at novice or better. Some players consider this an [[exploit]], while others think it is balanced by the unhappy thought. If all your dwarves have novice in even a single military skill, however, there will be no unhappy thought. You could rationalize this as having "military culture" at your fort if you wanted, but it's definitely an exploit.

[[Category:Thoughts]]

40d:Party

2009-05-04T07:10:22Z

Darekun: Added notes on party reduction & prevention, On Break jobs, and corrected multi-party notes(maybe a version difference?).

If you have a [[Meeting hall]] designated from a [[table]] ([[dining room]]), a [[cage]] ("[[zoo]]"), a [[well]], or a [[statue]] ([[Sculpture garden]]), dwarves will often throw parties there and many of your precious productive workers will now display the status '''Attending Party.''' This has benefits, in that dwarves will get happy thoughts from admiring fine or finely placed statues, cages and the animals in the cages, as well as from making [[friend]]s and talking to them. They will also slowly develop social skills. However, parties may slow down your fortress's work as your dwarves idly hang-out, sometimes for more than a [[season]].

Oddly, dwarves usually cancel party attendance to get a drink or some food. Despite their numerous desperate attempts they obviously know next to nothing about how to roll in style. Dwarves will also go [[On break|On Break]] from a party, even if that means hanging out in the same meeting hall, talking to the same people.

Parties can be canceled by "free"ing the room where they take place via {{k|q}} {{k|f}}. Even if you immediately recreate the room the party goers will disperse. Canceling the meeting hall status is not enough.

Each eligible room can have its own party going. With multiple overlapping rooms(like several tables in a dining room set to the same area), each can have its own party. If you free the room a particular party started in, the dwarves attending that party will stop partying, but those partying from other rooms (even in the same space) will keep going. If you're going to overlap rooms that can have parties, it may be best to make each room-designated construction from a different material, so you can free the correct party to get an important dwarf to go back to work.

==Party Reduction & Prevention==
Less-social dwarves seem to be less likely to throw parties, and less likely to make friends to invite them. Less-happy dwarves also seem to be less likely to throw parties. Thus antisocial and dour dwarves can be assigned important [[labor]]s without as much risk of stopping work to party.

Note that dwarves don't throw parties at meeting halls designated from [[zone]]s. If all your meeting halls are of this type, your dwarves won't party.

[[Category:Thoughts]]

40d Talk:Party

2009-05-04T07:04:02Z

Darekun: Oops, missed a signature.

nobody ever gets shown as "attend party" as their job except for the guy who initiated it.. for me anyway... but i have noticed that the host can still make friends with the people idling there seeing as they normally hold it in a meeting place, where everyone with no job goes... [[User:Twiggie|Twiggie]] 08:51, 5 December 2007 (EST)

: Yup - partygoers count as hanging out in the meeting hall, and therefore socialize. Including with people attending different parties. Also, it looks like inviting someone to a party counts as a social interaction, but attending a party only counts by dint of hanging out in the meeting hall. [[User:Darekun|Darekun]] 07:04, 4 May 2009 (UTC)

I'm reasonably sure that only dwarves who are idle for extended periods start parties - can anyone confirm or deny this? --[[User:TangoThree|TangoThree]] 14:30, 21 January 2008 (EST)

I vehemently deny. They dont start parties in the middle of a job, but apart from that they will still party when they know very well that a lot of work is waiting for them (38a). --[[User:Koltom|Koltom]] 11:29, 15 February 2008 (EST)

There is dispute then. Dwarves with jobs to do spend in parties only the time they would already spend on "On Break". Toady One already stated this sometime ago. I will make a search on the forums. From my experience, parties don't bring production to a halt, like the article says. It is a low priority "job".--[[User:ThVaz|ThVaz]] 08:48, 20 February 2008 (EST)

: So you are saying that time spent on parties reduces on break time? Hard to prove and does not contradict the fact that they will start and attend parties without being on "no job" or break some time before. It is definitely not a low priority task. I routinely cancel parties to free a worker i need and while a few sometimes turn (back?) to 'on break' then, most start to work. --[[User:Koltom|Koltom]] 06:03, 20 March 2008 (EDT)

:: Given that I often see dwarves going on break ''from partying'', and that usually half to two-thirds of my fortress is usually partying at a time while maybe 10% are on break, I'd say no, they don't use their break time. Also, canceling a party won't cancel a break, but will free up partygoers for work. Also, I've observed my broker joining a party shortly after a merchant caravan arrived, and still partying when I got the the "the merchants are about to leave" message(at which point I started canceling parties until the broker headed for the depot). Breaks don't last that long. [[User:Darekun|Darekun]] 06:47, 4 May 2009 (UTC)
==Party Prevention Planning==
Something I've noticed is that if you designate an area as a Dining Room from a table but as a Meeting Hall from the [i] Zones panel (instead of from the table itself), they'll gather around the tables (like a meeting area) and eat there (like a dining room), but will never throw parties, thus allowing idle dorfs to socialize, but keeping them free for tasks (instead of being locked into party mode). Can anyone confirm? -[[User:JeebusSez|JeebusSez]] 02:44, 19 May 2008 (EDT)

:Any meeting '''zone''' will always be party free. Where you place it doesn't matter, and infact I'd suggest placing it so that the dwarves using it are as close to your industrial center as possible without generating traffic that gets in the way of workers. Alternatively, place it near the front entrance and they will act as thief/snatcher spotters. Caged animals are better suited to this task however. Personally, I *never* designate statue gardens, zoos, or other meeting rooms, due to the frequent and typically perpetual parties. The happy thoughts aren't nearly worth the loss in productivity, particularly with all the masterpiece meals, drinks, and engravings around the place.

It also looks like dwarves need to be relatively happy already to throw a party, though they can invite unhappy dwarves. [[User:Darekun|Darekun]] 06:47, 4 May 2009 (UTC)

40d Talk:Party

2009-05-04T06:47:20Z

Darekun:

nobody ever gets shown as "attend party" as their job except for the guy who initiated it.. for me anyway... but i have noticed that the host can still make friends with the people idling there seeing as they normally hold it in a meeting place, where everyone with no job goes... [[User:Twiggie|Twiggie]] 08:51, 5 December 2007 (EST)

: Yup - partygoers count as hanging out in the meeting hall, and therefore socialize. Including with people attending different parties. Also, it looks like inviting someone to a party counts as a social interaction, but attending a party only counts by dint of hanging out in the meeting hall.

I'm reasonably sure that only dwarves who are idle for extended periods start parties - can anyone confirm or deny this? --[[User:TangoThree|TangoThree]] 14:30, 21 January 2008 (EST)

I vehemently deny. They dont start parties in the middle of a job, but apart from that they will still party when they know very well that a lot of work is waiting for them (38a). --[[User:Koltom|Koltom]] 11:29, 15 February 2008 (EST)

There is dispute then. Dwarves with jobs to do spend in parties only the time they would already spend on "On Break". Toady One already stated this sometime ago. I will make a search on the forums. From my experience, parties don't bring production to a halt, like the article says. It is a low priority "job".--[[User:ThVaz|ThVaz]] 08:48, 20 February 2008 (EST)

: So you are saying that time spent on parties reduces on break time? Hard to prove and does not contradict the fact that they will start and attend parties without being on "no job" or break some time before. It is definitely not a low priority task. I routinely cancel parties to free a worker i need and while a few sometimes turn (back?) to 'on break' then, most start to work. --[[User:Koltom|Koltom]] 06:03, 20 March 2008 (EDT)

:: Given that I often see dwarves going on break ''from partying'', and that usually half to two-thirds of my fortress is usually partying at a time while maybe 10% are on break, I'd say no, they don't use their break time. Also, canceling a party won't cancel a break, but will free up partygoers for work. Also, I've observed my broker joining a party shortly after a merchant caravan arrived, and still partying when I got the the "the merchants are about to leave" message(at which point I started canceling parties until the broker headed for the depot). Breaks don't last that long. [[User:Darekun|Darekun]] 06:47, 4 May 2009 (UTC)
==Party Prevention Planning==
Something I've noticed is that if you designate an area as a Dining Room from a table but as a Meeting Hall from the [i] Zones panel (instead of from the table itself), they'll gather around the tables (like a meeting area) and eat there (like a dining room), but will never throw parties, thus allowing idle dorfs to socialize, but keeping them free for tasks (instead of being locked into party mode). Can anyone confirm? -[[User:JeebusSez|JeebusSez]] 02:44, 19 May 2008 (EDT)

:Any meeting '''zone''' will always be party free. Where you place it doesn't matter, and infact I'd suggest placing it so that the dwarves using it are as close to your industrial center as possible without generating traffic that gets in the way of workers. Alternatively, place it near the front entrance and they will act as thief/snatcher spotters. Caged animals are better suited to this task however. Personally, I *never* designate statue gardens, zoos, or other meeting rooms, due to the frequent and typically perpetual parties. The happy thoughts aren't nearly worth the loss in productivity, particularly with all the masterpiece meals, drinks, and engravings around the place.

It also looks like dwarves need to be relatively happy already to throw a party, though they can invite unhappy dwarves. [[User:Darekun|Darekun]] 06:47, 4 May 2009 (UTC)

40d:Your first fortress

2009-04-23T10:05:34Z

Darekun: /* Skills */ Added note on Mining in combat, and rephrased Herbalist to complete the thought as it began.

This is a guide to help new players get started on their first [[fortress]] and teach them the basics of keeping their [[dwarf|dwarves]] alive. If you have unanswered questions or find given details confusing, please tell us so on the [[Talk:Your_first_fortress|discussion page]]! Above all else, always remember the [[Dwarf Fortress]] motto: "Losing is fun!"

We discuss generating a world, choosing a fortress location, buying [[skill]]s and items, and playing the first month or so. Setting game initialization options is covered in [[technical tricks]]. The advice here is biased for safety; with a little experience you'll do better with strategies customized for your play style and preferred start locations. For more extended treatment of particular subjects, consult the linked pages or the rest of the Dwarf Fortress Wiki.

== Generating a world ==

It all starts here. The first thing to do when starting Dwarf Fortress is to [[World generation |create a world]]. Later on, you may wish to tweak the parameters to suit your play style, but for now, the ''Create New World Now!'' option is an easy way to get into your first game.

The engine will start to create the world--watch it unfold! You might notice that worlds are rejected, sometimes even after the generator begins running rivers and lakes. This is normal, as the generator seeks a world which meets the criteria for optimum Dwarven Fun.

Generating a standard random world can take several minutes. You can speed things up by selecting ''Design New World with Parameters'' instead of ''Create New World Now!'' and setting a smaller world size. These worlds tend to be less interesting and replayable, but work well if you want to try new things.

Once you've generated a world you will return to the main screen and there will be a new option, <tt>Start Playing</tt>. Upon selecting that you can choose the game mode - [[Dwarf Fortress]], [[Adventurer]], or [[Legends]]. This article is written with respect to Fortress mode.

See the article on [[world generation]] for a complete guide to the world generation screen.

== Choosing a location ==

=== The interface ===

So long as you have at least one world without an active game, you will be able to choose "Start Playing" from the main menu. Select "Dwarf Fortress" and you'll find a four-section window:

[[Image:FortressLocation_fd2f10.png | caption | This picture is shown with the default tileset. Other [[tilesets]] are available]]

Going from left to right, these windows represent:
*The local map. The black box represents the area that your fortress will occupy if you decide to embark. The blue line is a stream, the green icons represent forests and swamps, and the gray triangles are mountain slopes.
*The regional map. This is like zooming out from the local map. The entire local map is represented by that yellow X. Most of the region is forest, with a mountain range in the bottom right. The two light blue lines are minor rivers.
*The world map. This is zooming out all the way. The yellow X represents the approximate position of the region.
*Information about the area that the black box is occupying. More on this below.

You can move around the region map with {{k|←}}{{k|↑}}{{k|→}}{{k|↓}}, or at 10x speed with {{k|Shift}}+{{k|←}}{{k|↑}}{{k|→}}{{k|↓}}. Note that using {{k|Shift}} can cause the key to get "stuck" - press it again to cancel.

You can move around the local map with these keys:
{{k|u}}
{{k|h}} {{k|k}}
{{k|m}}

You cannot directly move around the world map. Movement across the world map is shown relative to your movement on the region map. In world generated with the default settings, each square of the world map contains several squares of the region map.

Your next goal will be choosing the starting location for your fortress.

=== Your surroundings ===

You can discern a lot of information by scrolling through the various modes. The interface has five modes which you cycle through by pressing {{k|TAB}}. In turn, they display the ''biomes'', ''civilizations'', and ''geology'' of the local area.

====Biomes screen====
This display gives you an idea for the environment you'll be parachuting into. Click any of the blue links for more information on the subject. [[Biome]]s are determined by the type of life in the area. On the Biome screen, you'll see:
* '''[[Temperature]]''': How hot or cold it gets in the area. Can be ''Freezing'', ''Cold'', ''Temperate'', ''Warm'', ''Hot'', and ''Scorching''. In a nutshell, temperature extremes make it harder to get and keep a reliable source of [[water]] going. In Freezing and Scorching climates, you may have to do without water at all. Temperate and Warm are both good places to start your first fort. 
* '''Amount of [[tree]]s, and [[plant|other vegetation]]''': A general indication of the density of plant life in the area. For trees, this can be ''none'', ''scarce'', ''sparse'', ''woodland'', or ''heavily forested''. For other plants, you can see ''none'', ''scarce'', ''moderate'', and ''thick''. Trees are chopped down for [[wood]], which is a critical, if small, part of your fortress. You can import lots of it from [[caravan]]s, so don't worry too much about it. However, more trees never hurt anyone, and totally treeless maps are quite a bit more difficult in the early going, so aim for ''sparse'' or greater trees. Other plants basically means shrubs, bushes, and other vegetation that you can harvest food from with the [[plant gathering]] skill. Generally speaking, you will use this trick in the first year of your fortress, then never again. [[Plant]] density is not very important. 
* '''[[Surroundings]]''': This is a hint at how wild the wilderness is. The outskirts of a jungle might be fairly calm and safe, while the heart of that same jungle could be thick with vicious predators. In game terms, this will clue you in to the specific types of [[tree]]s and [[plant]]s you will find, in addition to indicating the [[animal]] types you'll run into. This also clues you in to the ''alignment'' of the surrounding area. So, the two things this word tells you is how ''good'' or ''evil'' an area is, and how ''calm'' or ''savage'' an area is. ''Good''-aligned areas, from calm to savage, are ''serene'', ''mirthful'', or ''joyous wilds''. ''Neutral''-aligned areas are, from calm to savage, ''calm'', ''wilderness'', or ''untamed wilds''. ''Evil''-aligned areas are, from calm to savage, ''sinister'', ''haunted'', or ''terrifying''. ''Good'' zones tend to have one of the most aggressive animals in the game, the [[unicorn]], and ''evil'' areas have a multitude of [[undead]] and some of the most vicious [[creature]]s in the game. For your first fortress, stick to a ''neutral'' alignment. 
* '''Major land forms''': A last field, which will not always be full, will mention things you should know about, like [[river]]s. Rivers provide an unlimited source of [[water]], but can be home to dangerous fish like the [[longnose gar]] and [[carp]]. Still, though, the benefits generally far outweigh the risks. [[Volcano]]es are also noted here, one of the only guaranteed ways to get [[magma]]. Magma makes a few things a lot easier, but it is dangerous to work with and must be handled very carefully because of the [[fire imp|horrible]] [[magma man|creature]]s that come out of it. Not critical, especially not for your first time out. 

Sometimes, you'll be looking at a place with more than one [[biome]] in the same selected square. You can press {{k|F1}} {{k|F2}} {{k|F3}} or {{k|F4}} to view the different types of biomes. In the picture above, we are looking at the mountain in the center, which is cold and has no trees or plants because it's too high up for those things to grow.

====Civilization screen====
These are nearby [[civilization]]s that are capable of interacting with you. Other settlements are shown with various symbols on the regional map. The possible entries here are ''dwarves'', ''humans'', ''elves'', ''goblins'', and ''kobolds''.
* '''[[dwarf|Dwarves]]''': You will want to be in contact with dwarves to get [[immigrant]]s and a dwarven trading caravan. However, dwarves are, sometimes seemingly magically, everywhere. It is impossible to settle anywhere without dwarves, assuming there is at least one surviving dwarven civilization. Depending on how remote the area is, though, you may not get some of the features of the game you would otherwise: being cut off from the world will prevent most [[noble]]s from coming to your fort, which will stop the [[dwarven economy]] from ever being activated. You will also not get a [[liason]] with your dwarven caravan, so you will be unable to request goods. 
* '''[[Humans]]''': Humans are almost always friendly, and love [[trade]]. They send [[liaison]]s to let you request goods and are generally a huge boon to any fortress. 
* '''[[Elves]]''': Elves are usually friendly and make fair trading partners, but have a [[Trade#Elves|particular ethos]] about trading. They do not send a trade [[liason]] and their goods are luxuries at best. They can be very annoying, but are generally not dangerous unless you provoke them. 
* '''[[Goblin]]s''': Goblins are your main enemies in Dwarf Fortress, and will produce most of the aggression against your fort. They periodically launch ambushes, consisting of five to ten goblin warriors, and will send [[siege]]s after your fort reaches 80 dwarves. [[Trap]]ped entrances, [[war dog]]s, and eventually a [[military]] will be needed to repel them. Just be sure not to start in the middle of a goblin citadel. 
* '''[[Kobold]]''': Kobolds are petty thieves that are little more than irritations in most situations. If you are careless and let their thieves get away with a lot of stuff, though, they may upgrade to raiding parties of archers.

====Elevation screen====
Relative [[Z-axis|elevation]]. This is a normal topographic map that you're used to from real-life maps. It just gives you an idea of the lay of the land.

====Slope screen====
[[Slope]] steepness. This shows you where large cliffs are. Try to avoid [[cliff]]s of 4 or more, as the taller maps take a lot more computer power to run. On the other hand, flat areas are boring - a good elevation map contains lots of low elevation changes ranging from 1 to 4. However, choosing areas with high elevation changes gives you much more stone, ore, and gems to work with and may even provide decent protection against invaders. It's your choice in the long run, particularly if you don't really care about performance.
====Embark alerts====
When you're satisfied with your area and hit {{k|e}} to embark, you may get some alerts about being in a very difficult area, or about an [[aquifer]]. Aquifers can make it frustrating to get started, so if you are alerted about an aquifer, seriously consider moving somewhere else for your first fortress. After you have the basics down, tackling an aquifer is much easier.
====Location recap====

For your first fortress, it's not entirely important. However, there are some general guidelines that can help you decide: 

* Try to get a temperate or warm climate, since extreme temperatures are more difficult.
* Trees and vegetation are good for producing lumber and food for your fortress, but you don't need tons of them.
* ''Neutral''-aligned [[surroundings]] are best for your first fortress, but ''good''-aligned surroundings are also OK. Avoid ''evil''-aligned surroundings, however.
* Running water ([[river]]s, streams, and [[brook]]s) are a permanent source of [[water]]. [[Lake]]s and [[pool]]s have a finite amount of water and may dry out. Not having enough water can be a big obstacle, so try to get some running water your first time out.
* [[Humans]] and [[elves]] are friendly, so an area they have access to is nice.
* [[Magma]] is cool (hah!), but not critical.
* Areas with [[aquifer]]s require some engineering to get to rock. You'll be warned if you chose an area with an aquifer. When in doubt, don't try it.
** If you insist on starting in an area with an aquifer, read up on the dangers of aquifers, and, if at all possible, choose an embark site that includes an aquifer-less [[biome]].
* Who cares? If you like what you see, go for it. You can always start over. And remember the DF motto: Losing is fun! 

For more information on specific game mechanics such as [[sand]], [[flux]], and how to find [[iron]], check [[How_to_correctly_start_fortress_mode|this page]].

==== Fortress size ====

Once you've decided on location, you need to decide the size of your fortress area. This is the size of the game field you're playing on. Advantages of requesting a large local area include more raw materials, greater diversity of [[rock]]s and special underground features, and the ability to include desired terrain (such as a river, a forest, or a magma vent). Disadvantages include slower game performance (larger areas require more CPU power), higher likelihood of merchants failing to reach your [[trade depot]] before they run out of time, and more risk of losing immigrants as they struggle to your front gate. (Note that you can [[mine]] many levels deep into the ground, and even a 3x3 area generally contains more raw materials than you're ever likely to need.)

You can adjust the size of your fort's area by using {{k|SHIFT}} + the {{k|u}} {{k|m}} {{k|k}} or {{k|h}} keys. 

=== Embark ===

When done, hit {{k|e}} to embark. A warning may appear if you've chosen a challenging site, or one with an [[aquifer]].

==Buying skills and items==
After you embark, you're given the option to either start immediately or prepare for the journey carefully. You should pretty much always prepare carefully if you enjoy staying alive.

Here, presumably, you are the dwarf determining who will go and what they will take. You have a total of 2060☼ to spend in two categories: Skilled dwarves and items. Some items have already been selected for you, but you probably won't want most of these.

There are as many possible ways to approach setting up as there are fortress locations. The [[starting builds]] page offers several examples for you to choose from. Here, we are only going to discuss some basics that help you understand enough to make your own decisions. The embark screen opens up on the ''skills'' screen, and can be changed to the ''items'' screen by pressing {{k|TAB}}.

===Skills===
In Dwarf Fortress, it's not what you have, it's who you have. Skilled dwarves are the cornerstone of everything, from domestics to security, so it's extremely important to embark with good people.

As you will see in this screen, you have 7 dwarves, all with 10 points to put toward starting skills. We will want to use all 10 of the points on all 7 of the dwarves. By default, you won't have enough ☼ to do this, so hit {{k|TAB}} to go to the items screen and hit {{k|-}} over the ''Steel battle axe'' line to give subtract one. This should give you enough ☼ to assign all your skills. You can only spend 5 of the 10 points in any one skill, making the maximum skill level upon embark ''proficient''. This makes a total of 14 ''proficient'' skills, or a larger number of lower skill levels.

In a fledgling fortress, the 4 indispensable jobs are [[mason]], [[miner]], [[grower]], and [[carpenter]]. A good beginning strategy is to embark with at least 1 dwarf being ''proficient'' in these 4 skills. Many people choose to double up on proficient miners and growers, since mining and farming are both pretty big jobs.

Other useful skills to consider:
* '''[[Cook]]:''' Cooks make [[prepared meal]]s in the [[kitchen]], which helps you manage your food stock space. Well-prepared meals are also valuable [[trade]] goods, and make dwarves happy when eaten. Highly skilled cooks make better meals, and prepare meals faster.

* '''[[Brewer]]:''' Brewers make [[booze]] in the [[still]]. Dwarves being dwarves, they need alcohol to operate at peak efficiency, and highly-skilled brewers make better tasting booze and finish brewing faster. Dwarves get happier when they drink good booze.

* '''[[Herbalist]]:''' Herbalists gather food and seeds from [[shrub]]s in the local area. Skilled herbalists pick faster and come away with far more food. Where an unskilled herbalist will come away with one [[wild strawberry]] or none at all, a proficient herbalist will often pick 3 or 4, and sometimes 5.

* '''[[Woodcutter]]:''' Woodcutters fell [[tree]]s for use by [[carpenter]]s. Highly skilled woodcutters fell trees much faster. However, since you don't need that much wood, you can get away with a normal (no tag) woodcutter just fine.

* '''[[Mechanic]]:''' Mechanics build and use [[mechanism]]s, which have myriad uses in [[trap]]s, [[lever]]s and some [[machine]]s. Highly skilled mechanics finish installing mechanisms much faster, and the mechanisms they build are of higher quality. However, the quality of the mechanism primarily matters to beginning players for its [[trade]] value, and in early fortresses the need for mechanisms is usually so small that any dwarf can pick it up and handle it well enough. Still, a solid choice, especially if you like [[trap]]s, which respond more quickly when made with higher-quality mechanisms.

* '''[[Armorsmith]], [[Weaponsmith]], and [[Siege engineer]]:''' These 3 skills are not useful at all in an early fortress, but become very important later on, and training an unskilled dwarf in these skills is hard and requires a lot of material, so if you're in it for the long haul, consider them.

* '''Military skills ([[Wrestler]], [[Axedwarf]], [[Hammerdwarf]], etc):''' Early on, it's unlikely that you'll need these, since there's generally very few things that will bother a band of dwarves who aren't hurting anyone, but certain places, such as those with a [[chasm]], will have hostile creatures around. In these areas, you may consider giving your woodcutter the Axedwarf skill so he can use his chopping axe as a weapon. A miner can "pinch-hit", since the [[Mining]] skill also covers wielding a pick in combat, but the dwarves don't understand this yet, so a drafted miner will get unhappy [[thought]]s.

* '''Social skills ([[Appraiser]], [[Judge of Intent]], [[Consoler]], etc):''' Putting these on one dwarf will make them a shoo-in for the Expedition Leader slot, and ranks in Appraiser and Judge of Intent will make interacting with the first caravan much easier. However, even if you don't train this at all, some persistence in trading with the first caravan will level your leader up enough to trade with the second caravan like a champion.

Once again, examples can be found in the [[starting builds]] page. What you bring is incredibly dependent on your play style, though. Some people think bringing Mechanics along is a total waste of time, others consider them indispensable. Some people like having skills that aren't even on this list, like [[Leatherworker]]. Read the starting builds, ask questions, and explore! Who cares if your first idea doesn't work out after playing an hour? Restarting is easy and ''losing is fun''.

===Items===
Now that we're done with assigning skills, hit {{k|TAB}} to go over to the item screen. Item worth is another extremely situational thing, and you'll find as many opinions as there are Dwarf Fortress players as to what is good to bring. Once more, it depends VERY heavily on your play style. Again, [[starting builds]] can provide some good example reading. This section will only cover the basics and give you enough information to make your own decisions.

====Tools====
You'll need a couple of finished tools to get yourself started.
* '''[[Battle axe]]s''': Every [[Woodcutter]] needs an axe. Steel battle axes are the only type you can purchase on this screen, and they're expensive. You might want to bring just one, unless you expect to need a lot of lumber and/or axedwarf muscle. 
* '''[[Pick]]s''': Likewise, [[Miner]]s need picks. All picks work equally well, their material only determines the damage they do in combat. Thus, copper picks are the budgeting dwarf's choice, at a paltry 20☼ each. 
* '''[[Anvil]]''': One of the big questions to ask yourself is whether to bring an anvil on embark. It's extremely expensive at 1000☼, but to start a [[metal]] industry, you will either have to start with one or request and purchase (or steal!) one from a [[caravan]] somewhere down the line.

Generally, if you are going to a very mountainous area where you're likely to see lots of ore and you want to be able to make use of it right from the get-go, bring an anvil. If you're going to spend a few years getting your fortress established before worrying about metal production, drop it and bring more raw commodities. 

One occasional problem is that axes and picks are absent entirely. If this is the case, you can bring the materials to build these things yourself.
* Purchase an anvil.
* Purchase 3 rocks that are not [[lignite]], [[bituminous coal]], or [[graphite]]. Any other rocks will work fine.
* Purchase fuel for the forge. You can purchase it outright as charcoal at 10☼ per unit, or refine it yourself for a big savings.
** To refine it yourself, purchase one unit of charcoal, and several (at least 5) units of [[bituminous coal]]. When you arrive on site, make sure someone has the [[furnace operating]] labor enabled ({{k|v}} to select a dwarf, then select {{k|p}}references and {{k|l}}abor to designate a dwarf's labor assignments), and build a [[smelter]] (hit {{k|b}}, then {{k|e}}, then {{k|s}}). Order the smelter to turn bituminous coal into [[coke]]. [[Coke]] is functionally the same as [[charcoal]], and bituminous coal produces 3 coke for each hunk of rock you bring. You need the first hunk of charcoal to start the string, but after that it feeds itself.
* Purchase metal to shape. You can buy bars directly to save time, or again, smelt it yourself. Take [[copper]] to start out with. It's cheap, and with any luck your initial tools aren't going to see heavy combat. You can take the materials for [[bronze]], [[iron]], or [[steel]] if you like, but this is more expensive. Still, if you're willing to go through the process, you can end up with 2 steel axes, likely of decent quality, for 82☼, instead of 600☼, with no quality modifiers at all.
** If you want to save points and smelt it yourself, take copper nuggets instead of copper bars, and use the smelter to convert them into copper bars.
** A good ore to bring along is [[tetrahedrite]] - it acts simultaneously as the ore for copper and [[silver]], a good crafting metal. (That is, with every piece of tetrahedrite, you will always get a copper bar, and will sometimes get a silver bar as well [about a 20 percent chance, or one in five].) This kills two birds with one stone (heh): you still have your copper, and if you get silver you can smelt metal crafts for use as [[trade]] goods. 
* Fuel and metal in hand, deconstruct the smelter (if needed; {{k|q}} to highlight, then {{k|x}} to deconstruct), and construct a [[metalsmith's forge]]. Make sure someone has [[weaponsmith]]ing on. After the forge is up, order it to make the axes and picks you need. Deconstruct the forge when you're done and enjoy your new tools, hopefully with [[quality]] modifiers!

====Raw materials====
As it was briefly covered above, sometimes it makes more sense to bring a lot of raw materials than some finished goods. Raw materials are a lot cheaper than finished goods, and so long as you invest heavily in your dwarves' skills (which you should!), you can probably make better quality stuff, anyway.
*'''[[Stone]]''': Only bring this if you're trying to build some of your tools on the spot, as noted above. Otherwise, you will get stone coming out of your ears once you start mining. 
*'''[[Metal]]''': Generally not recommended. However, if you're expecting trouble and you're bringing an anvil, bringing many bars of [[iron]] and [[charcoal]] in lieu of a [[battle axe]] can be a big boon. If your dwarves can get to a spot that gives them a breather, a proficient [[weaponsmith]] or [[armorsmith]] could stamp out high-quality goods to give your dwarves a better fighting chance. This is a pretty advanced trick to pull off, though, so don't try to pull it if you're not confident. 
*'''[[Wood]]''': Wood is a bargain at only 3☼ per log, and the 100 logs you can bring in exchange for a steel battle axe will last you a long time. This is a great technique for making [[Woodcutter]] unneeded in the early game, but you need to budget your wood use for the first year very carefully. When you're out, you're out! 

====Consumables====
Easily the most important part of your preparation is what you're going to eat, drink, and plant once you get on site. Without food and booze, you're not going much of anywhere.
*'''[[Food]]''': Most food comes at a mere 2☼ per unit, and 8 units will feed 1 dwarf for a year. Bringing a year of food will give you a good cushion to getting your farms working, so aim for about 60 food if you can. If you must cut back, though, 40 will be fine if you make your farms an early priority. The best food staple to bring along is [[turtle]]. Turtle produces [[shell]] and [[bones]] when eaten, which can be used as raw materials for other things you need, including armor, crossbows, and crossbow bolts. Further, shell is a common request for [[strange mood]]s and is a pain to produce, so getting some early could save yourself a failed mood and a dead dwarf. 
*'''[[Booze]]''': Dwarves drink twice as often as they eat, and they always want to down some alcohol if at all possible. They also like different kinds of alcohol. Bring twice as much booze as you bring food, and divide it evenly among the 4 types of alcohol you can take ([[dwarven wine]], [[dwarven beer]], [[dwarven ale]], [[dwarven rum]]). 
*'''[[Seeds]]''': Your farms have got to start somewhere. Definitely bring along [[plump helmet spawn]] (for food and booze) and [[pig tails]] (for cloth ropes and booze variety). How many you bring is dependent on how big you want your initial farms to be. 5 of each is plenty to feed your initial dwarves, and you will get more seeds any time the plants are consumed in any way ''except cooking''. You may want to use the [[kitchen]] menu to disallow cooking of plump helmets until you have a healthy supply of seeds. Or, alternatively, just don't make any prepared meals until you've got a healthy supply of seeds. The other seed types require a lot more labor to use properly, and should probably wait until you have more dwarves in the fortress. You can buy seeds from the dwarven caravan for almost nothing, but if you want a greater variety along, go for [[rock nuts]]. The [[quarry bush]] that sprouts from it produces the greatest space to yield ratio in the game. Eventually, though, you should be planting all 6 of the underground [[crop]]s at least. 
Food and booze are stored in [[barrel]]s, with each type in its own barrel. Since barrels have a 10-unit capacity, you can get a lot of free barrels by starting with many, many kinds of food in quantities which in end 1. Barrels are important, and usually need wood to make, so it's worth it to use this quirk while you can by starting with at least one unit of every type of food. 
Seeds are stored in [[bag]]s in multiples of 14, also by type. Bags are not as important as barrels, since making cloth bags is a good way to train up your [[clothier]], but you ''can'' do the math to figure out how to get an extra bag for the cost of a single seed, if you're so inclined: get a multiple of 14, plus 1.

====Animals====
Not only dwarves live in your fortress, after all.
*'''[[Dog]]s''': Dogs are dwarf's best friend. They can be trained into [[hunting dog]]s or [[war dog]]s, require no food or maintenance, and make good pets for your dwarves. Always bring at least 2. Genders alternate when picking them up, so 2 will give you a breeding pair that will have more puppies freely. They make fantastic security early and fantastic dwarfsaving distractions later on. Dogs will happily lay down their lives to protect their master, which is huge when it means one of your best legendary dwarves is running away from an angry [[goblin]]. 
*'''[[Cat]]s''': Cats provide a wonderful function in controlling [[vermin]] in the fort. Vermin can make your dwarves extremely unhappy, so some cats are more or less a requirement. The largest problem with cats, however, is that their population is very difficult to control. Cats will choose their own owners (without the dwarf in question's consent), and after they've done so, you cannot order them butchered to control their numbers. The resulting [[catsplosion|population explosion]] can clutter hallways and murder your framerate. The best thing to do is to put all stray cats and kittens in a [[cage]] (one will hold them all). You can then butcher them without running the risk of the cats adopting dwarves before the butcher gets around to them, and if vermin start to get out of hand, you can always release one or two to help. If you want vermin control from the start, bring just ONE cat so it cannot breed and cause a population problem early. However, immigrants will very commonly bring their pet cats to the fortress, so if you can live with vermin early, you'll likely get a cat for free within a year. 
*'''Beasts of burden ([[Horse]]s, [[muskox]]en, etc)''': You will probably get a breeding pair of these for free when you start the game (they pull your starting wagon), and they will breed just as fast as anything else, so don't bring any along, and don't be afraid to use that [[cage]] to contain their numbers. Unlike cats, dwarves must choose to adopt beasts of burden, which they won't do unless you let them to do so (in z->animals menu). That's fairly rare, so the vast majority of the beasts of burden in your fortress will stay strays. Many immigrants may bring useless animals with them though - as they are adopted already you can't butcher or cage them. All newborns belong to the fortress, so you can do what you want with them. 

Once again, check the [[starting builds]] page for more ideas, read the pages linked above, and experiment. The learning process is half the fun in Dwarf Fortress; enjoy it!

==Game on!==
We've chosen an area, selected our supplies, and we're ready to play. The game opens with your dwarves huddled around the wagon they used to get here.
==Gameplay overview==
This section will deal with the tasks you'll need to tackle in your first year of gameplay. These tasks are ''selecting a dig site'', ''building workshops'' (and ''marking stockpiles''), ''building lodging'', ''starting farms'', and ''trading''.
===Selecting a dig site===
You'll have to decide where you're going to dig in and start your fortress. You should consider the natural formations of the surrounding area when deciding where you want your main entrance. Ideally, there should be one way in and one way out. This one way should be fairly sizable, to pander to [[caravans]] and [[traffic]]. Proximity to a good [[water]] source so you can build a [[well]] more easily is also desirable. You can fix either of these things with extra digging and building later on, though, so don't sweat the decision too much.<r>

The most direct way to start is to find the side of a nearby mountain and dig into it, but if you're in a very flat area, you might have to dig downward instead. To start digging, hit {{k|d}}esignations, then {{k|d}}ig. Move your cursor using the arrow keys to where you want to dig, and hit {{k|ENTER}}, then move your cursor over to the place you want the digging to end. Mining designations are rectangular, so you can go both left and right and up and down as you're designating area. This tells your dwarves to cut into a wall and hollow it out, often leaving behind a [[stone]] if it is a rock wall. [[Soil]] walls become hollowed out, but never drop anything. These hollowed out areas are where you'll build the vast majority of everything you need. 

If you need to dig down instead of in, you need to use either a '''[[stairs|stairwell]]''' or a '''[[ramp]]'''. For a stairwell, use {{k|d}}esignations, and downward stairway ({{k|j}}). Note that this is only half of a stairwell. To build the other half, you must go down a z-level ({{k|>}}) and {{k|d}}esignate an {{k|u}}pward stairway to connect to it. You are then underground and can use {{k|m}}ining normally. For a ramp, you must go down a z-level ({{k|>}}) and {{k|d}}esignate a {{k|r}}amp on the area you want cut away. You do not need to build anything above it; your miners will figure it out. If you are building downward and want [[caravans]] to come down into your fortress, you will need to use [[ramp]]s, at least 3 right next to each other. Keep this in mind when deciding where you want to dig down. 

When designing your main entrance, be mindful that as many as 200 dwarves could be coming and going eventually, and that [[goblin]]s are going to want in at some point or another. A 3-wide entrance corridor is ideal. It is wide enough to accept a good amount of traffic and caravans, but narrow enough to use diabolical traps and designs to kill lots of goblins. Your main doors will have to be only 2-wide, though, as [[door]]s require a wall adjacent to them to build properly.

Once you've decided where you want your main entrance, it's time to move your supplies over there. We will have to set them outside for now, but we'll want to move them indoors as soon as we can. Press stock{{k|p}}iles, and designate areas for {{k|f}}ood, {{k|w}}ood, and {{k|r}}efuse. You can designate all sorts of stockpiles from this screen, so hit {{k|t}} and poke around in the custom stockpile settings for a little bit, figuring out what you can do. Do '''NOT''' designate a stone stockpile for now. It will eat up a lot of time unnecessarily. While we're organizing our supplies, deconstruct your wagon by pressing {{k|q}}uery, putting the cursor over your wagon, and pressing deconstruct ({{k|x}}). A dwarf with the [[carpentry]] labor enabled will come by and pull the wagon apart, turning it into 3 [[log]]s. The wagon is useless to you, so there's no reason to not do this. Some people prefer to wait until the wagon has been emptied before deconstructing it. In order to see the contents of a building, use the {{k|t}} command and scroll over the wagon.

Plan for your finished, 200-dwarf fortress right from the get-go. It's very easy to dig out new area. It's very HARD to go back and redo something the way it should've been from the start. 3-wide hallways is typically plenty for high-traffic areas.

===Building workshops===
Time to get some work done! Taking in raw materials and spitting out stuff that's useful: that's the name of the game for workshops. You should start putting down workshops as soon as you have raw materials. You'll need to get basic living provisions like [[bed]]s, [[table]]s, [[chair]]s, [[chest]]s, and the like down for not only your first 7 dwarves, but the [[immigrant]]s that could come at any time as soon as possible, so you can't waste any time. 

[[Stone]] will show up from your miners digging. Once you have an area with a decent amount of stone, you should get a [[mason's workshop]] built in the area. Check the [[workshop]] page for full details if you have problems building one. The keyboard command is:
* {{k|b}}uild order
* the {{k|w}}orkshops sub-menu
* {{k|m}}ason's workshop.

Once the workshop has been built by a dwarf with the [[masonry]] [[labor]], you can {{k|q}}uery the workshop to find out what it's current orders are, {{k|a}}dd or {{k|c}}ancel orders, set an existing order to {{k|r}}epeat, order the workshop dismantled, and other tasks.

Add orders for a {{k|d}}oor, a {{k|t}}able, and a {{k|c}}hair. Stone chairs will show up as ''thrones'' in the orders. They are exactly the same. Then set each order to repeat. This workshop will now make [[door]]s, [[table]]s, and [[chair]]s until you tell it to stop. You'll need a lot of these, so that's OK.

Also build a [[carpenter's workshop]] near the wood stockpile you designated earlier, and tell it to make {{k|b}}eds. Put this on {{k|r}}epeat, also. The wood you brought along, even after disassembling your wagon, won't last long. If you brought along a [[woodcutter]], now would be a good time to get him to chop down some trees. Hit {{k|d}}esignations, and then hit chop down {{k|t}}rees. Chopping designations work exactly like mining designations, but it will only highlight trees in the rectangle you give it. Don't worry about chopping a ton of wood right now; trees don't go anywhere fast, so you can always come back for more.

While making workshops anywhere the material happens to be works fine right now, you will want a more organized way of doing it later. Check out the [[Design_strategies#Workshop_Logistics|workshop logistics]] page for ideas on how to set it up. After you do get things set up, be sure to move your stockpiles underground; aboveground stockpiles are vulnerable to thieves and are usually a long way away. Don't be afraid to tear down workshops; they are built quickly and easily, and tearing them down does absolutely nothing harmful, even returning the materials used in it's construction. Be aware that workshops create [[noise]] when they are in use, which can disturb your dwarves' sleep, so don't build them close to any [[bed]]s.

===Building lodging===
With commodities coming out, it's time to set up places where they can be used. 

Tell your miners to dig out a large (5x5 minimum) room to become your [[barracks]]. The barracks is essentially a communal sleeping room where dwarves without their own apartment can come to crash. It is also the place where your [[military]] will come to [[sparring|spar]] once you start recruiting soldiers. Since your military hangs out in the barracks a lot, it's a good idea to put it near the main entrance of the fortress. If [[Thief|thieves]] stumble in, they are likely to meet a very grisly end as they bump into a pair of dwarves in the middle of combat training, and later, in case of a more major attack, they are more likely to be closer to where you need them. Note, however, that sparring dwarves can very seriously [[wound|hurt]] or kill eachother if their sparring area is too crowded, so keep beds stacked along one wall and the rest of the room clear and uncluttered. You do not need too many beds in the barracks right now. Beds in the barracks are public, and dwarves have their own schedules, so the entire fortress will not sleep at once.

After the barracks is dug, tell your dwarves to {{k|b}}uild a {{k|b}}ed. Your cursor will come up, turning red on an unacceptable location and green on an acceptable location. Unacceptable locations will give you a short reason as to why they're unacceptable. Again, just stack beds against one wall of the barracks; 5 beds will be fine to start out with. After indicating the placement of the beds, your dwarves will haul them over and install them. Once they are installed, {{k|q}}uery a bed, then make a {{k|r}}oom. Use the {{k|+}} and {{k|-}} keys to size the room that will be considered the barracks. All beds within the flashing square will be considered public, so there's no need to do this more than once. Fill up the whole 5x5 area ({{k|b}}uild {{k|d}}oors if you need to cordon off the area to make it a nice square) and hit {{k|ENTER}}. You've created your first [[room]]! A room status screen shows up. Be sure to hit {{k|b}} to confirm that it is a barracks. If you don't, the first dwarf that sleeps in this room will claim it as his or her apartment, which isn't what we want. 

The barracks will keep your dwarves from sleeping on the floor, which would make them [[thought|unhappy]]. As the game goes on, though, it is a very good idea to move dwarves into their own apartments. They get much [[thought|happier]] for it, it keeps traffic down, and provides you with some more diabolical options such as locking a troublemaker in his room by {{k|q}}uerying the door and {{k|l}}ocking (forbidding) it. See the [[bedroom design]] page for ideas on how to set up your apartments. 

With bedding handled, we need to set up a [[dining room]], which will double as our [[meeting area]]. Dwarves will eat in their apartment sometimes if you install a table and chair in it, but mostly, dwarves prefer to eat in a public [[dining room|dining hall]] with a table all to themselves. As the [[meeting area]], dwarves will also show up there whenever they have nothing better to do (have 'No Job') to socialize and kill time. It is a pretty high-traffic area, so be sure to use double-doors as the entrance and exit. It should again be fairly large (25 tiles minimum; this could be 5x5, 4x6, whatever suits your fancy). Once it's dug out, {{k|b}}uild {{k|t}}ables along the walls, and then {{k|b}}uild {{k|c}}hairs next to the tables, one per table. Once a table is laid out, {{k|q}}uery the table and make a {{k|r}}oom out of it. Fill up the dining hall area, and hit {{k|ENTER}}. Be sure to hit {{k|p}} to set it as a meeting area, and you're done here.

As with most kinds of furniture, dwarves can walk through tiles containing tables, chairs and beds. The most notable exception to this are [[statue]]s.

===Starting farms===
The basics of life are in place! Now it's just a matter of getting the farms in place to make sure life goes on. 

[[Farming]] is the most reliable source of food in the game, and the only way to be sure you're going to feed a large population. The catch is, we can only farm on [[mud]] or [[soil]]. Mud is only created through [[irrigation]], which is complicated and more trouble than it's worth if you have access to any serious quantity of soil. Avoid using irrigation if you can. The logistics of controlling enough water to make arable land on stone are extremely annoying.

On [[soil]], however, farming couldn't be easier. Simply mine out an area of soil (underground, since the seeds you can embark with will NOT grow aboveground), then {{k|b}}uild a farm {{k|p}}lot. Use {{k|u}}, {{k|m}}, {{k|k}}, and {{k|j}} to resize your plot to the size you want; 3x3 should be plenty to start out, and you will max out at roughly 30 to 40 total squares being used for food and booze production to support a full fortress. This changes some depending on the skill of your [[grower]]s, but it's a fair guideline. After placing the farmland, a dwarf with the Farming (Fields) labor enabled will come by and prepare it for use. After it's done, {{k|q}}uery the new field and decide on your crops for each season. The crop display will show every crop that can possibly be planted there - it does not nessecerally mean you have seeds to plant. [[Plump helmet]]s are best for your first field, since they can be brewed to [[booze]], eaten raw, and cooked. If you find some seasons have red letters, that is because the season has already passed and you cannot edit it again this year. You will have to pick it up in the spring of the following year. Be aware that Dwarf Fortress will '''NOT''' give you an error if you attempt to plant something you have no seeds of. It will give you an error if you '''run out''' of seeds after starting planting, but not if you simply have none to begin with. If you can't remember what kind of seeds you have, check around your wagon and your designated food stockpile using {{k|k}} for a seeds bag. Hit {{k|Enter}} when you find it to inspect the bag and see what kind of seeds it carries. Later on, you will be able to find it more easily using the {{k|z}} key and the "Stocks" menu, but right now your stocks will lack the precision to use the "zoom" key. See the [[bookkeeper]] article for more information on stockpile precision.

Eventually, you will want to be planting many, many different kinds of crops. [[Dimple cups]] are great later on, because they produce [[dimple dye]], which can be used to increase the value of the clothing your fortress produces. [[Cave wheat]] can be used to provide fodder for luxury prepared meals, and to make more brewing fodder. As your fortress grows and you need more and more luxuries to keep everyone happy, diversifying can only help you.

On a note about [[irrigation]] before wrapping this section up, mud behaves almost identically to soil. All below-ground crops can be grown equally well on either, and you build and place the plots exactly the same. There are a few differences, though. Mud can be [[Farming#Increasing_yield|fertilized]] with [[potash]], while dry soil cannot. Some above-ground crops can only be grown in mud, while others can only be planted in dry soil. Check the [[crops]] page for more details. Irrigation is a very advanced technique that provides only marginal benefits. Some "unlivable" areas can be turned around with skillful irrigation and fertilizer, but by and large they're not necessary. Just use soil whenever you can.

=== Trade ===
Now that you've given your dwarves a place to sleep and avoided the possibility of starvation, you can start thinking about the finer things in life.

First, we'll take care of a few organizational considerations, to make trading easier. Our carpenter will take care of this, since he's done making beds. Order up 2 or 3 [[bucket]]s. Buckets are used to carry water to injured, bedridden dwarves from water source [[zone]]s and are one of the requirements to building a [[well]]. Then, get to work stamping out some [[bin]]s. Bins are used to store a lot of non-perishable items in the same square; they work much the same as [[barrel]]s, but barrels are used on perishables like food and booze. You'll need a LOT of bins, but for the moment 5 or so will do. You will also need to make a lot of barrels, but since you brought a number of them with you, you can hold off a bit. Both of these can be made from [[metal]] as well, but producing them from wood is far more economical.

Since you have all this stone lying around, let's put it to use. Build a [[Craftsdwarf's workshop]], assign one of your dwarves to [[stonecrafting]]. Order this [[workshop]] to build rock {{k|c}}rafts of all sorts {{k|r}}epeatedly. Stone mugs are a good trade good - you get three mugs from one stone, adding up to 30☼ at the start. Since your stonecrafter will level up relatively quickly (and if you have several dwarves working on stonecrafts) this can quickly add up to several thousand monies worth of goods.

Now that you've got some goods to [[trade]], we'll need to {{k|b}}uild a trade {{k|D}}epot. Build this somewhere easily accessible from all edges of the map, but close to (or inside) your entrance. [[Trade depot]]s require [[architecture]] and a [[mason]], assuming you make it out of your copious quantities of stone. Many times you will not have an [[building designer]] on embark, so you will have to assign one to get the [[architecture]] phase of the depot done.

In the long term, you'll want your trade depot to be in a defensible spot. As it is 5x5 squares, and requires a 3-square wide path for the caravans to get in and out of it, you'll eventually want to spend some time thinking about its [[defense]]. Once the depot has been completed, you can check for depot access using the {{k|shift}}-{{k|D}} key.

The first caravan will come in your first autumn: the dwarven caravan from the mountainhome. When it comes, the game will pause, you'll be alerted, and the screen will center on the [[caravan]]. If you do not have a depot, or they can't get to it, they will wait on the edge of the map for you to build a depot they can get to, or to clear the obstructions. The two most common obstructions are [[tree]]s and [[boulder]]s. Trees can be chopped down, and boulders can be eliminated by {{k|d}}esignating them to be {{k|s}}moothed. This uses the [[stone detailing]] labor, so turn it on if you need.

After the caravan is on its way, you'll need to fill the depot with things to trade, and get a trader there to broker the negotiations. Hit {{k|q}}uery over the depot and press {{k|g}} to start moving supplies. Use the arrow keys to navigate the trade goods window. If you've been making stone crafts, you'll want the ''crafts'' heading to make the game filter out the bins you've been filling. Otherwise, you'll have to sift through every stone you've created while digging the fortress, which is a huge pain. Press {{k|ENTER}} on the bins to mark them for trading, and some dwarves will come along to haul the bins to the depot. Once that's take care of, {{k|q}}uery the depot and {{k|r}}equest a trader there. By default, only the broker will trade at the depot. This is generally what you want, since brokers with better [[appraisal]] skills can see the worth of all the commodities and tend to get away with giving the caravan boss a lower profit margin on the trade. Trading at the depot is a low-priority job, though, so you may have to turn off your broker's other labors temporarily to get him to respond to the request in a timely manner. Once your broker is at the depot, {{k|q}}uery the depot and start {{k|t}}rading.

On the screen that comes up, the left side shows the trader's goods, while the right side shows your own. Use the arrow keys to navigate and {{k|ENTER}} to mark something for trading. If your trader does not have at least Novice Appraiser in his skill set, you will not be able to see the values of everything, so you'll have to guess. The caravan boss will refuse to sell at a loss, and if you're close to making a deal, he'll give you a counteroffer that he'd accept. Being able to see the values of things is really helpful, but don't worry if you can't. It usually only takes one or two successful trades before your broker will hit Novice Appraiser and all will become known to you. One fun note is that raw materials cost the same from merchants as they do at the embark screen; so you already know that [[plump helmets]] are 4☼, most meat is 2☼, wooden logs are 3☼, and so on. It's difficult to know the value of your crafts, and some things must be bought as a package deal (you cannot buy seeds alone, you must also buy the bag they come in), though, so it can still be hard to trade without Appraiser.

On your first year, you're probably pretty light on things to trade with, so start small. Wood [[log]]s are very useful and cheap. Extra food can be useful if your farms are lagging behind. Maybe a barrel or two. Sell what goods you have and don't fret about it any longer.

Next year, after you get some immigrants you can think about exploring other kinds of industry as well, like the [[furniture industry]], [[meat industry]], or [[clothing industry]], but this is a great place to start.

The last element to trading is the [[liason]]. The dwarven liason will want to meet with your [[expedition leader]] to work out your requests for next year, and let you know what their requests are. By making a request of the caravan, you are essentially promising to pay more (up to double the normal price) for various things, which entices the traders to bring more of those things. Wood logs are always a great thing to request. Even at double the normal price, they're still very cheap, and merchants bring a lot of them. It's not unusual to get 50 logs from a single caravan. It saves you a massive amount of time and effort. [[Barrel]]s and [[bag]]s are also good to request, as are [[dog]]s. You can also request [[seed]]s to get your more diverse crops started. Look around, explore, and experiment. That's half the fun of the game.

The liason will also tell you what they want from you, with the same deal: they'll pay more for it if you build it. Unfortunately, they usually want stupid things that don't trade well (such as stone [[block]]s) or things you'd rather keep to yourself (such as [[booze]]). Many players simply ignore their liason's requests and build the same things they always build. Diplomatic relations will not suffer at all.

Your expedition leader must actually pick up the job ''conduct meeting'' to get this process done, and it ends up being a very low-priority job, so again, you may consider turning off your leader's other labors to make sure he gets to it. If you really want to force the liason to take the meeting, move him to the meeting spot by enlisting him in the [[Military]] and [[Military#Controlling your squads|stationing]] him at the meeting spot. Then [[Door#Door settings|forbid the door]] behind him and the liason, locking them in until the meeting is completed (when the Liason says "Goodbye" in a message).

=== The future ===

After this point, you'll be able to start exploring the other intricacies of the game. Here is a list of some other gameplay commands which have not been covered:

* [[labor]]
* [[noble]]s
* [[military]]

==Sample games==
These are sample games that others have played and recorded to provide good learning examples. They are not routinely updated, so some information may be out of date, but they still provide good hands-on tutorials of how to prepare for your fortress and play the game.

* [[Indecisive's illustrated fortress mode tutorial]]
* [[Savok's first fortress playthrough]]
* [[ThunderClaw's 0.28.181.40d graphical tileset playthrough]]
* [http://afteractionreporter.com/2009/02/09/the-complete-and-utter-newby-tutorial-for-dwarf-fortress-part-1-wtf/ The Complete and Utter Newbie Tutorial for Dwarf Fortress]

You can also look at the [http://mkv25.net/dfma/index.php Dwarf Fortress Map Archive] to see multi-layered snapshots of fortresses that others have built.

[[Category:Guides]]

{{Starting FAQ}}

40d:Creature token

2009-04-19T15:13:16Z

Darekun: /* P */ Added [PACK_ANIMAL].

Everything here can be applied to all creature files, e.g. creature_domestic, creature_standard, even creature_equipment.

Since the game is in the Alpha stage, consider everything '''tentative'''.

{| id="toc"
|
* Tokens
** [[#A|A]] [[#B|B]] [[#C|C]] [[#D|D]] [[#E|E]] [[#F|F]] [[#G|G]] [[#H|H]] [[#I|I]] [[#J|J]] [[#K|K]] [[#L|L]] [[#M|M]]
** [[#N|N]] [[#O|O]] [[#P|P]] [[#Q|Q]] [[#R|R]] [[#S|S]] [[#T|T]] [[#U|U]] [[#V|V]] [[#W|W]] [[#X|X]] [[#Y|Y]] [[#Z|Z]]
|}
__NOTOC__

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

|-
| ADD_VERSION
| version
| In which version of the game said creature was introduced. Not used anymore in the 3D version.
[ADD_VERSION:1069]

|-
| 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/MATUTINAL, rather than implying them.

|-
| ALTTILE
| [[Character Table|CP437 ordinal]] or 'character'
| If set, the creature will blink between its [TILE] and its [ALTTILE].
[ALTTILE:157] or [ALTTILE:'&']

|-
| AMBUSHPREDATOR
|
| Makes the creature start out hidden. Used by giant cave spiders. May make webs hidden too?

|-
| AMPHIBIOUS
|
| Allows a creature to breathe with or without water.

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

|-
| ATTACK
|
| See the [[#Attacks|Attacks section]].

|}

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

|-
| BABY
| age
| Age at which a baby becomes a child. Without this tag, all creatures born will skip the baby stage and be children upon birth.
[BABY:1]

|-
| BEACH_FREQUENCY
| value
| Whales and jellyfish have this. Controls the beaching frequency of the creature.
[BEACH_FREQUENCY:10]

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

|-
| BIOME:*
|
| See [[Biome Tokens|biome tokens]].

|-
| BLOODTYPE
| type
| Sets the creatures' blood type (default red):
*R - Red blood
*G - Green blood
*B - Blue blood
*M - Magenta blood
*C - Cyan blood
*Y - Yellow pus
*W - White ichor
*0 - Black goo
*VOMIT
*SLIME
[BLOODTYPE:0]

|-
| [[Body_tokens|BODY]]
| parts[:...]
| Sets the body parts a creature has. Can supply as many as you want.
[BODY:HUMANOID:2EYES:2EARS]

|-
| [[Bodygloss|BODYGLOSS]]
| gloss
| A body_default.txt function. It replaces a part's description with another. e.g. feet with hooves.
[BODYGLOSS:HOOF]

|-
| BOILING_POINT
| temperature
| The temperature at which the creature boils into goo. [[Temperature scale|DF temperature scale]]

|-
| BONE_BOILING_POINT
| temperature
| The boiling point of the creature's bones.

|-
| BONE_COLDDAM_POINT
| temperature
| The low temperature at which the creature's bones start getting damaged.

|-
| BONE_FIXED_TEMP
| temperature
| The temperature that the creature's bones give off.

|-
| BONE_HEATDAM_POINT
| temperature
| The high temperature where the bones start taking damage.

|-
| BONE_IGNITE_POINT
| temperature
| The temperature at which point the creature's bones burst into flame.

|-
| BONE_MELTING_POINT
| temperature
| The temperature at which the creature's bones melt.

|-
| [[Creature_Tokens/SPEC_HEAT|BONE_SPEC_HEAT]]
| not a temperature
| Specific heat? (temperature difference required to change the temperature of the creature's bones?) {{verify}}

|-
| BONECARN
|
| Creature 'eats' bones. Eating bones makes their happiness go up, but can cause death (suffocation). This tag implies CARNIVORE.

|-
| BUILDINGDESTROYER
| value
| Allows a creature to destroy furniture and buildings. Creatures with BUILDINGDESTROYER will actively seek out your constructions and destroy them. A creature can have this value at 1 or 2. When the value is 1, the creature will go after wooden hatches, wooden doors, supports, statues, windows and archery targets only. They can't destroy homes during world gen as (semi)megabeasts.
When the value is 2 the creature will actively seek out most (all?) constructions and destroy them. They can also destroy buildings during world-gen with this tag. Megabeasts rely on this token for their pathing when attacking your fort.
[BUILDINGDESTROYER:2]

|-
| BUTCHERABLE_NONSTANDARD
|
| (old) If a creature has this tag, it may only be slaughtered (that is, the live creature is taken to the [[Butcher's Shop]] and slain). If it dies of any other cause, the corpse cannot be butchered.

|}

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

|-
| CAN_CIV
|
| Can create civilizations. This tag may activate hunger and thirst. {{verify}}

|-
| CAN_LEARN
|
| A creature with this tag can gain skill experience.

|-
| CAN_SPEAK
|
| Can talk.

|-
| CANNOT_UNDEAD
|
| Cannot become undead.

|-
| CARNIVORE
|
| Creature only eats meat.

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

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

|-
| CHEESE_BOILING_POINT
| temperature
| The temperature at which the creature's cheese (if any) boils away.

|-
| CHEESE_COLDDAM_POINT
| temperature
| The temperature at which the creature's cheese (if any) starts taking cold damage.

|-
| CHEESE_FIXED_TEMP
| temperature
| The temperature emitted by one unit of the creature's cheese (if any).

|-
| CHEESE_HEATDAM_POINT
| temperature
| The temperature at which the cheese made from the creature's milk starts taking heat damage.

|-
| CHEESE_IGNITE_POINT
| temperature
| The temperature at which the creature's cheese bursts into flame.

|-
| CHEESE_MELTING_POINT
| temperature
| The temperature at which the creature's cheese melts into goo.

|-
| [[Creature_Tokens/SPEC_HEAT|CHEESE_SPEC_HEAT]]
| not a temperature
| Specific heat? (temperature difference required to change the temperature of the creature's cheese?) {{verify}}

|-
| CHEESE_VALUE
| value
| The value per unit of cheese made from the creature's milk (if applicable). Note that only vermin as of current can be milked.

|-
| CHILD
| age
| Age at which a child becomes an adult.
[CHILD:12]

|-
| CHILDNAME
|
* singular
* plural
| Gives the child a special name, eg "hippo calf" instead of "hippo child".
[CHILDNAME:hippo calf:hippo calves]

|-
| CHITIN
|
| When the creature is butchered, it drops chitin, which functions as leather.

|-
| CRAFTSMAN_NAME
|
* singular
* plural
| Sets the name of the craftsman profession.
[CRAFTSMAN_NAME:craftsdwarf:craftsdwarves]

|-
| CREPUSCULAR
|
| Sets if the creature is active in twilight.

|-
| CLUSTER_NUMBER
|
* minimum
* maximum
| The minimum/maximum numbers of how many creatures per spawned cluster.
[CLUSTER_NUMBER:1:3]

|-
| COLOR
|
* fg (foreground)
* bg (background)
* br (brightness)
| [[Color]] of the creature's tile.
[COLOR:3:0:0]

|-
| COOKABLE_LIVE
|
| Set this to allow the creature to be cooked in meals without having to butcher it first.

|-
| CREATURE
| name
| What the game looks for when generating creatures.
[CREATURE:DWARF]

|-
| COLDDAM_POINT
| temperature
| The minimum temperature limit before the creature starts taking damage from freezing.

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

|-
| CURIOUSBEAST_EATER
|
| Allows a creature to eat edible items that it finds? (may imply CURIOUSBEAST_ITEM?) {{verify}}

|-
| CURIOUSBEAST_ITEM
|
| Allows a creature to steal things (usually [[food]]?).

|-
| CURIOUSBEAST_GUZZLER
|
| Will steal [[alcohol]]? Implies CURIOUSBEAST.

|}

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

|-
| DAMBLOCK
| value
| How much natural armor a creature has. Can be set to negative numbers, so the creature takes more damage than usual.
[DAMBLOCK:1]

|-
| DEFENDER
|
| Appears from the glowing pits in a group.

|-
| DIFFICULTY
| number
| [[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.
[DIFFICULTY:2]

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

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

|-
| DRINK_BOILING_POINT
| temperature
| The temperature at which a drink (milk?) produced from the creature will boil.

|-
| DRINK_COLDDAM_POINT
| temperature
| The temperature at which said drink will take cold damage.

|-
| DRINK_FIXED_TEMP
| temperature
| The temperature emitted by one unit of the creature's drink (if any).

|-
| DRINK_HEATDAM_POINT
| temperature
| The temperature at which aforementioned drink will take heat damage.

|-
| DRINK_IGNITE_POINT
| temperature
| The temperature at which the drink will set your fort ablaze.

|-
| DRINK_MELTING_POINT
| temperature
| [[User:GreyMario]] sez: "Isn't this, like, redundant? It's ''already'' liquid. Perhaps it controls at which point the drink solidifies?" {{verify}}

|-
| [[Creature_Tokens/SPEC_HEAT|DRINK_SPEC_HEAT]]
| not a temperature
| The difference in temperature required to modify the temperature of the drink? {{verify}}

|}

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

|-
| ENDING
|
| Will show up as a leader (only one of them) in a group from the glowing pits.

|-
| EQUIPMENT_WAGON
|
| Implies two unknown flags, NOSTUN, NONAUSEA, NOBLEED, NOEMOTION, NOSTUCKINS, SEVERONBREAKS, NOSKULL, NOSKIN, NOBONES, NOMEAT, PARALYZEIMMUNE, NOFEAR, NOSMELLYROT, NOTHOUGHT, NO_GENDER.

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

|-
| EVIL
|
| Determines whether creature can show up on "evil" maps (see [[Creatures#Threat Matrix|Threat Matrix]]).

|-
| EXTRACT
|
* name
* value
* ? (always 0)
* ? (0 on venoms exception: giant desert scorpion venom)
| Determines what can be extracted from the creature, what it's called, how valuable it is, and what you can make from it. Note, it appears that the extraction process is hardcoded into the game, and can't be altered from objects/raw.
[EXTRACT:cow's milk:7:0:1]

|-
| EXTRACT_ANTIDOTE
|
* name
* value
* ? (always 0)
* ? (always 0)
* ? (always 50 or 100)
| [EXTRACT_ANTIDOTE:cave spider antivenin:7:0:0:50]

|-
| EXTRACT_BOILING_POINT
| temperature
| The temperature value at which a unit of the creature's extract boils away.

|-
| EXTRACT_CHEESE
|
* name
* value
* ?
* ?
| The extract gotten from the creature is a unit of cheese.
[EXTRACT_CHEESE:cow cheese:6:0:1]

|-
| EXTRACT_COOKABLE
|
| Extract is cookable.

|-
| EXTRACT_COLDDAM_POINT
| temperature
| The low temperature value at which the creature's extract starts to take damage.

|-
| EXTRACT_FIXED_TEMP
| temperature
| The temperature that the creature's extract generates on its own.

|-
| EXTRACT_HEATDAM_POINT
| temperature
| The high temperature value at which the creature's extract starts to take damage.

|-
| EXTRACT_IGNITE_POINT
| temperature
| The temperature at which the creature's extract bursts into flame (NOT the container it's in).

|-
| EXTRACT_MELTING_POINT
| temperature
| The temperature at which the creature's extract melts into goo.

|-
| EXTRACT_PARALYZE
|
| (conjectural) Extract is poisonous, causing paralysis that lasts until the extract wears off. Can be delivered by SPECIALATTACK_INJECT_EXTRACT.

|-
| EXTRACT_PARALYZE_INTERMITTENT
|
| (conjectural) Extract is poisonous, causing paralysis on occasional intervals until the extract wears off. Can be delivered by SPECIALATTACK_INJECT_EXTRACT.

|-
| EXTRACT_PERMANENT
|
| (conjectural) The effects of the creature's extract are permanent once applied and do not wear off naturally.

|-
| EXTRACT_SIZE
| size
|
[EXTRACT_SIZE:10]

|-
| [[Creature_Tokens/SPEC_HEAT|EXTRACT_SPEC_HEAT]]
| not a temperature
| The difference in temperature required to modify the temperature of the creature's extract? {{verify}}

|-
| EXTRACT_STUN
|
| (conjectural) Extract is poisonous, causing a permanent stun effect until the extract wears off. Can be delivered by SPECIALATTACK_INJECT_EXTRACT.

|-
| EXTRACT_STUN_INTERMITTENT
|
| (verified) Extract is poisonous, causing temporary stuns on semi-occasional intervals. Can be delivered by SPECIALATTACK_INJECT_EXTRACT.

|-
| EXTRACT_VALUE
| value
| The value per unit of the creature's extract.
[EXTRACT_VALUE:20]

|-
| EXTRAVISION
|
| Creature has enhanced vision (longer vision range, ie. at night).

|}

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

|-
| FAT
| value
| How much fat a creature produces when it is butchered.
[FAT:3]

|-
| FEMALE
|
| The creature is always female.

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

|-
| FIREIMMUNE
|
| The creature is immune to all forms of fire, except DRAGONFIREBREATH.

|-
| FIREIMMUNE_SUPER
|
| The creature is immune to DRAGONFIREBREATH. AI acts as if FIREIMMUNE. Does NOT imply FIREIMMUNE.

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

|-
| FIXED_TEMP
| temperature
| The natural heat generated by the creature. [FIXED_TEMP:1-?]

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

|-
| FLIER
|
| Allows a creature to fly. Currently, an AI bug prevents this from being useful on PC races in fortress mode.

|-
| FREQUENCY
| time
| Determines the time between creature spawns in Fortress Mode. Higher is more occurences per time unit{{verify}}. Creatures without a frequency statement appear to be on the map at all times. Almost all others have either [FREQUENCY:5] or [FREQUENCY:100].
[FREQUENCY:42]

|}

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

|-
| GENPOWER
| rate?
| Not used anymore and can be removed safely. Was related to magic.
[GENPOWER:3]

|-
| GLOWCOLOR
|
* fg
* bg
* br
| The colour of the GLOWTILE of the creature (see below).

[GLOWCOLOR:4:0:1]

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

[GLOWTILE:'"']

|-
| GNAWER
|
| The creature chews on food storage containers.

|-
| GOOD
|
| Determines whether creature can show up on "good" maps (see [[Creatures#Threat Matrix|Threat Matrix]]).

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

|}

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

|-
| HAS_RACEGLOSS
| gloss
| Links a material glossary to the creature. It is hardcoded, and there is only 4 types of tag.
[HAS_RACEGLOSS:WOOD]
[HAS_RACEGLOSS:STONE]
[HAS_RACEGLOSS:METAL]
[HAS_RACEGLOSS:PLANT]

|-
| HASSHELL
|
| Creature will leave behind a shell when eaten.

|-
| HEATDAM_POINT
| temperature
| The maximum temperature limit before the creature will start recieving damage from heat. [[Temperature scale|DF temperature scale]]

|-
| HOMEOTHERM
| value
| Default 'NONE'. The creature's normal body temperature. Combined with LAYERING, sets the temperature range under which it can live. [[Temperature scale|DF temperature scale]]

|-
| HORN
|
| Creature drops a horn or horns when butchered, which presumably acts like bone. This tag is broken.

|}

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

|-
| IGNITE_POINT
| temperature
| The temperature at which the creature will burst into flames. [[Temperature scale|DF temperature scale]]

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

|-
| IMMOBILE_LAND
|
| The creature is immobile while on land

|-
| INTELLIGENT
|
| Implies CAN_CIV, CAN_SPEAK, CAN_LEARN.

|-
| ITEMCORPSE
|
* [[Item Tokens|item token]]
* subtype
NO_SUBTYPE
* [[Matgloss_tokens|matgloss token]]
* NO_RACEGLOSS
USE_RACEGLOSS
USE_SHARPSTONE
| Determines if the creature leaves behind a non-standard corpse (i.e. wood, statue, bars, etc). The first parameter determines the item type; the second parameter is the subtype indicated in the raw file (such as WEAPON_WHIP); the third indicates the material type if the item type takes a specific material (e.g. "IRON" if the corpse type is "STATUE"). USE_RACEGLOSS applies if the creature has a material glossary assigned by the "HAS_RACEGLOSS:" flag and will select neccesary adjectives and material from that glossary.
[ITEMCORPSE:[[Item Tokens|WOOD]]:NO_SUBTYPE:[[Material Tokens|WOOD]]:USE_RACEGLOSS]

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

|-
| IVORY
|
| Creature will produce ivory when butchered. Currently doesn't work.

|}

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

|-
| LARGE_CAVERIVER
|
| In Fortress Mode, spawns from/near cave rivers.

|-
| LARGE_CHASM
|
| In Fortress Mode, spawns from/near chasms.

|-
| LARGE_LAVA
|
| In Fortress Mode, spawns from/near magma.

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

|-
| LAYERING
| value
| How well-protected the creature is from low temperatures. If this number is too high, it will confine a creature to only arctic areas. If it is even higher it will prevent the creature from spawning at all.

|-
| LEATHER_BOILING_POINT
| temperature
| The temperature at which leather made from the creature's skins will boil away.

|-
| LEATHER_COLDDAM_POINT
| temperature
| The temperature at which leather made from the creature's skins will take damage.

|-
| LEATHER_FIXED_TEMP
| temperature
| The temperature that leather made from the creature's skins generates.

|-
| LEATHER_HEATDAM_POINT
| temperature
| The temperature at which leather made from the creature's skins will take damage.

|-
| LEATHER_IGNITE_POINT
| temperature
| The temperature at which leather made from the creature's skins will burst into flames.

|-
| LEATHER_MELTING_POINT
| temperature
| The temperature at which leather made from the creature's skins will melt away.

|-
| [[Creature_Tokens/SPEC_HEAT|LEATHER_SPEC_HEAT]]
| not a temperature
| The difference in temperature required to modify the temperature of the creature's leather? {{verify}}

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

|-
| LIKES_FIGHTING
|
|

|-
| 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. Implies [TRAPAVOID]

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

|}

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

|-
| MAGICAL
|
| Allows a creature to use magic? However, magic isn't implemented yet.

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

|-
| MALE
|
| The creature is always male.

|-
| MATERIAL
|
* [[Matgloss_tokens|Matgloss token]]
* USE_RACEGLOSS
|

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

|-
| MAXAGE
|
* minimum
* maximum
| Sets the Min Max age for a creature. Used in world generating and Fortress Mode.
[MAXAGE:150:170]

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

|-
| MEGABEAST
|
| Appears on fortress territory in Fortress Mode occasionally. Implies SEMIMEGABEAST.

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

|-
| MILKABLE
| frequency?
| Allows the creature to be milked. Currently only works with vermin creatures.

|-
| MISCHIEVIOUS
|
| Will pull any levers it comes across. (requires confirmation)

|-
| MODVALUE
| number
| Multiplies the value of items made from the creature by the number in the tag.
[MODVALUE:2]

|-
| MOUNT
|
| Allows the creature to be mounted. Currently only works with siegers. The same AI bug that causes issues with [FLIER] PC races in fortress mode causes worse issues with flying mounts, though when unmounted the creature will fly just fine. [SWIMS_INNATE] may or may not have similar issues on mounts.

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

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

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

|}

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

|-
| NAME
|
* singular noun
* plural noun
* adjective
| What the creature is actually called in game. Make sure there is no space around the ":".
[NAME:dwarf:dwarves:dwarven]

|-
| NARROW
|
| The creature can only wear things that have the narrow tag on it.

|-
| NATURAL
|
| Animal

|-
| NO_AUTUMN
|
| Will not show up during the Autumn season.

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

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

|-
| NO_GENDER
|
| No gender will be selected for the creature.

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

|-
| NO_SPRING
|
| Will not show up during the Spring season.

|-
| NO_SUMMER
|
| Will not show up during the Summer season.

|-
| NO_WINTER
|
| Will not show up during the Winter season.

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

|-
| NOBLEED
|
| Creature doesn't bleed.

|-
| NOBONES
|
| Creature will not drop bones on butcher, rot, or decay of severed body parts.

|-
| 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
|
| Creatures' corpse does not create miasma.

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

|-
| NOSTUN
|
| Creature can't be stunned.

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

|-
| NOT_BUTCHERABLE
|
| Creature can't be butchered.

|}

==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
|
| Flies in a semi-predictable pattern? {{verify}}

|-
| 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 greater than the penetrate power, their contents escape for the time being. Other objects roll a 0-99.

|-
| PERSONALITY
|
* token
* lowest % chance
* median
* highest % chance
| Determines chance of personality traits. Standard is 0:50:100. See [[Personality traits]] for more info.
[PERSONALITY:IMAGINATION:0:55:100]

|-
| 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:42]

|-
| POPULATION_NUMBER
|
* minimum
* maximum
| The minimum/maximum numbers of how many of these creatures can show up on a map per year.
[POPULATION_NUMBER:42:42]

|-
| POWER
|
| Allows the creature to be worshiped by entities with the RELIGION:ANY_APPROPRIATE_POWER tag.

|-
| PREFSTRING
| object
| Sets what other creatures like about this creature. "Blarghh likes dwarves for their beards."
[PREFSTRING:beards]
Multiple entries will be chosen from at random.

|}

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

|-
| REMAINS
| <''singular''>:<''plural''>
| ??? Used by treants along with [REMAINS_UNDETERMINED], appears to change the name of a creatures remains.

|-
| REMAINS_COLOR
|
* fg
* bg
* br
| The color of the creature's remains. Used by treants.

[REMAINS_COLOR:6:0:0]
|-
| REMAINS_UNDETERMINED
|
|

|}

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

|-
| SAVAGE
|
| Determines whether creature can show up on "savage" maps.

|-
| SEMIMEGABEAST
|
| Appears as boss creature in quests.

|-
| SESSILE_LAND
|
| Obsolete. Use [[#I|[IMMOBILE_LAND]]].

|-
| SEVERONBREAKS
|
| Limbs and body parts sever on breakage.

|-
| SILK_BOILING_POINT
| temperature
| Temperature at which silk made from this creature's webs boils away.

|-
| SILK_COLDDAM_POINT
| temperature
| Temperature at which silk made from this creature's webs takes damage.

|-
| SILK_FIXED_TEMP
| temperature
| Temperature generated by the creature's web silk.

|-
| SILK_HEATDAM_POINT
| temperature
| Temperature at which silk made from this creature's webs takes damage.

|-
| SILK_IGNITE_POINT
| temperature
| Temperature at which silk made from this creature's webs bursts into flame.

|-
| SILK_MELTING_POINT
| temperature
| Temperature at which silk made from this creature's webs melts away.

|-
| [[Creature_Tokens/SPEC_HEAT|SILK_SPEC_HEAT]]
| not a temperature
| The difference in temperature required to modify the temperature of the creature's silk? {{verify}}

|-
| SIZE
| value
| How big a creature is. 6 is for dwarf like creatures, 7 is for human like creatures. 16 is for giants. Larger creatures are far more dangerous in combat. Also equals the amount of Meat/Chunks/Bones you get from the beast.
[SIZE:6]

|-
| SLOW_LEARNER
|
| Presumably similar to [CAN_LEARN], but slower. Present in the entries for ogres and giants

|-
| SMALLAQUATIC_CAVERIVER
|
|

|-
| SMALLAQUATIC_OCEAN
|
|

|-
| SMALLAQUATIC_RIVER
|
|

|-
| SMALLAQUATIC_SWAMP
|
|

|-
| SMALL_REMAINS
|
| If a creature has this token, it'll leave a small corpse that only rots once, such as vermin.

|-
| SPECNAME
|
*token
*singular noun
*plural noun
*adjective
| Sets a special name for certain instances.
[SPECNAME:MALE:bull:bulls:bull]

|-
| [[Creature_Tokens/SPEC_HEAT|SPEC_HEAT]]
| not a temperature
| The specific heat of a creature? {{verify}}
[SPEC_HEAT:409]

|-
| SPEECH
| filename
| Sets what speech.txt to use when insulting the creature.
[SPEECH:dwarf.txt]

|-
| SPEECH_MALE
| filename
| Used in place of [SPEECH] for humans; perhaps sets the speech.txt to use for males only? Humans don't have a corresponding [SPEECH_FEMALE] token, though, which only occurs in the [[string dump]].
[SPEECH_MALE:human_male.txt]

|-
| SPEED
| value
| Sets the creatures' movement and work speed, 1000/[100 + SPEED X] is the resulting effect on creatures movement and workrates from default. See [[Speed]] for more information.
[SPEED:400]

|-
| SPHERE
| [[sphere]]
| Sets what religious spheres the creature is aligned to, for purposes of being worshiped via the [POWER] token. By default, only used by [[Demon|hidden fun stuff]].

|-
| STOUT
|
| Creature has a resistance to being knocked over.

|-
| STANDARD_FLESH
|
|

|-
| 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 must learn to swim. Requires [CAN_LEARN], obviously.

|-
| SWIM_SPEED
| value
| How fast the creature swims.

|}

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

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

|-
| TILE
| CP437 ordinal or 'character'
| The graphical representation of the creature.
[TILE:157] or [TILE:'&']

|-
| TRADE_CAPACITY
| weight
| How much the creature can carry when used by merchants.
[TRADE_CAPACITY:2000]

|-
| TRAINABLE
|
| Allows a tame creature to be trained into a "War" or "Hunting" variation by way of [[Kennels]].

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

|-
| TRAPAVOID
|
| The creature is immune to traps.

|-
| TRIGGERABLE_GROUP
|
* minimum?
* maximum?
| [TRIGGERABLE_GROUP:5:50]

|}

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

|-
| UNDERSWIM
|
| Creature swims under the water and can't be seen.
|-
| UTTERANCES
|
| Changes the language of the creature into an unintelligible mess.

|}

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

|-
| VEGETATION
|
|

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

|-
| VERMIN_BITE
|
* amount injected or chance of injection?
* name
* effect (USE_EXTRACT)
| [VERMIN_BITE:10:bitten:USE_EXTRACT]
On very rare occasions, someone who remains in the same tile as this creature will be bitten by that creature, and the effect will be applied to the offender. Used by (tiny) cave spiders to inject their venom into the occasional dwarf.

|-
| VERMIN_EATER
|
| The creature can eat your food.

|-
| 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. – [[User:Peristarkawan|Peristarkawan]] 17:27, 24 May 2007 (EDT)

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

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

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

|-
| VERMIN_NOTRAP
|
| The creature cannot be caught by trappers or animal traps.

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

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

|-
| VIEWRANGE
| value
| How far the creature can see?

|}

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

|-
| WAGON_PULLER
|
| Allows the creature to pull caravan wagons.

|-
| WEBBER
|
| The creature will create webs. It also seems to make creatures flying. More testing is needed.

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

|}

=Attacks=
{| {{prettytable}}
|- bgcolor="#ddd"
!width="50"|Tag
!width="225"|What It Does

|-
|[ATTACK:MAIN:BYTYPE:GRASP:punch:punches:1:2:BLUDGEON][ATTACKFLAG_WITH]

''Format:''
[ATTACK:''priority'':(BYTYPE:''type'' || BYTOKEN:''bodypart''):''"verb"'':''"conjugate verb"'':''min dmg'':''max dmg'':''dmg type'']([(ATTACKFLAG_WITH || ATTACKFLAG_CANLATCH)])([SPECIALATTACK_INJECT_EXTRACT:''min'':''max''])
|Sets what natural attacks a creature has.

|-
|MAIN
SECOND
|''MAIN'': Sets the attack to act as the creatures' main attack.
''SECOND'': The creature will only use this attack if it can't use the MAIN attack(s).

|-
|BYTYPE:GRASP
BYTOKEN:TAIL_STINGER
|''BYTYPE'': Sets what body part type to use for the attack. Possible values for "type" are GRASP, MOUTH, STANCE, THOUGHT, BREATHE, and the like. See [[Body Tokens]].
''BYTOKEN'': Sets the explicit body part ID to use for the attack. The token must exist as part of the creature's [[Creature Tokens#B|BODY]] token.

|-
|punch:punches
|Sets the verb for the attack.

|-
|1:2
|Sets the Min Max for the damage.

|-
|BLUDGEON, PIERCE, SLASH, GORE, BURN, HEAT, COLD
|Sets the damage type for the attack.

|-
|[ATTACKFLAG_WITH]
|Attacks in combat inform which body part was used in the attack.
"Ratman punches Blargg with his right hand."

|-
|[ATTACKFLAG_CANLATCH]
|Allows the creature to latch on with the attack. "Crocodile latches on Blargg's head firmly."

|-
|[SPECIALATTACK_INJECT_EXTRACT:50:100]
|The creature injects an amount of its extract into a victim upon successfully using this attack. The significance of the amount is unknown (but probably determines duration before the extract wears off).

|-
|[SPECIALATTACK_SUCK_BLOOD:50:100]
|When blood is drained from a creature, it causes heavy bleeding (depending on the attacking creatures ability to suck blood). It's unknown if blood suckers feed or regain health while doing this. (Numbers affect amount of blood drawn?)
|}

[[Category:Modding]]
[[Category:Tokens]]

40d:Creature token

2009-04-19T15:07:31Z

Darekun: /* S */ Added the actual use for [SPEECH].

Everything here can be applied to all creature files, e.g. creature_domestic, creature_standard, even creature_equipment.

Since the game is in the Alpha stage, consider everything '''tentative'''.

{| id="toc"
|
* Tokens
** [[#A|A]] [[#B|B]] [[#C|C]] [[#D|D]] [[#E|E]] [[#F|F]] [[#G|G]] [[#H|H]] [[#I|I]] [[#J|J]] [[#K|K]] [[#L|L]] [[#M|M]]
** [[#N|N]] [[#O|O]] [[#P|P]] [[#Q|Q]] [[#R|R]] [[#S|S]] [[#T|T]] [[#U|U]] [[#V|V]] [[#W|W]] [[#X|X]] [[#Y|Y]] [[#Z|Z]]
|}
__NOTOC__

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

|-
| ADD_VERSION
| version
| In which version of the game said creature was introduced. Not used anymore in the 3D version.
[ADD_VERSION:1069]

|-
| 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/MATUTINAL, rather than implying them.

|-
| ALTTILE
| [[Character Table|CP437 ordinal]] or 'character'
| If set, the creature will blink between its [TILE] and its [ALTTILE].
[ALTTILE:157] or [ALTTILE:'&']

|-
| AMBUSHPREDATOR
|
| Makes the creature start out hidden. Used by giant cave spiders. May make webs hidden too?

|-
| AMPHIBIOUS
|
| Allows a creature to breathe with or without water.

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

|-
| ATTACK
|
| See the [[#Attacks|Attacks section]].

|}

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

|-
| BABY
| age
| Age at which a baby becomes a child. Without this tag, all creatures born will skip the baby stage and be children upon birth.
[BABY:1]

|-
| BEACH_FREQUENCY
| value
| Whales and jellyfish have this. Controls the beaching frequency of the creature.
[BEACH_FREQUENCY:10]

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

|-
| BIOME:*
|
| See [[Biome Tokens|biome tokens]].

|-
| BLOODTYPE
| type
| Sets the creatures' blood type (default red):
*R - Red blood
*G - Green blood
*B - Blue blood
*M - Magenta blood
*C - Cyan blood
*Y - Yellow pus
*W - White ichor
*0 - Black goo
*VOMIT
*SLIME
[BLOODTYPE:0]

|-
| [[Body_tokens|BODY]]
| parts[:...]
| Sets the body parts a creature has. Can supply as many as you want.
[BODY:HUMANOID:2EYES:2EARS]

|-
| [[Bodygloss|BODYGLOSS]]
| gloss
| A body_default.txt function. It replaces a part's description with another. e.g. feet with hooves.
[BODYGLOSS:HOOF]

|-
| BOILING_POINT
| temperature
| The temperature at which the creature boils into goo. [[Temperature scale|DF temperature scale]]

|-
| BONE_BOILING_POINT
| temperature
| The boiling point of the creature's bones.

|-
| BONE_COLDDAM_POINT
| temperature
| The low temperature at which the creature's bones start getting damaged.

|-
| BONE_FIXED_TEMP
| temperature
| The temperature that the creature's bones give off.

|-
| BONE_HEATDAM_POINT
| temperature
| The high temperature where the bones start taking damage.

|-
| BONE_IGNITE_POINT
| temperature
| The temperature at which point the creature's bones burst into flame.

|-
| BONE_MELTING_POINT
| temperature
| The temperature at which the creature's bones melt.

|-
| [[Creature_Tokens/SPEC_HEAT|BONE_SPEC_HEAT]]
| not a temperature
| Specific heat? (temperature difference required to change the temperature of the creature's bones?) {{verify}}

|-
| BONECARN
|
| Creature 'eats' bones. Eating bones makes their happiness go up, but can cause death (suffocation). This tag implies CARNIVORE.

|-
| BUILDINGDESTROYER
| value
| Allows a creature to destroy furniture and buildings. Creatures with BUILDINGDESTROYER will actively seek out your constructions and destroy them. A creature can have this value at 1 or 2. When the value is 1, the creature will go after wooden hatches, wooden doors, supports, statues, windows and archery targets only. They can't destroy homes during world gen as (semi)megabeasts.
When the value is 2 the creature will actively seek out most (all?) constructions and destroy them. They can also destroy buildings during world-gen with this tag. Megabeasts rely on this token for their pathing when attacking your fort.
[BUILDINGDESTROYER:2]

|-
| BUTCHERABLE_NONSTANDARD
|
| (old) If a creature has this tag, it may only be slaughtered (that is, the live creature is taken to the [[Butcher's Shop]] and slain). If it dies of any other cause, the corpse cannot be butchered.

|}

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

|-
| CAN_CIV
|
| Can create civilizations. This tag may activate hunger and thirst. {{verify}}

|-
| CAN_LEARN
|
| A creature with this tag can gain skill experience.

|-
| CAN_SPEAK
|
| Can talk.

|-
| CANNOT_UNDEAD
|
| Cannot become undead.

|-
| CARNIVORE
|
| Creature only eats meat.

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

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

|-
| CHEESE_BOILING_POINT
| temperature
| The temperature at which the creature's cheese (if any) boils away.

|-
| CHEESE_COLDDAM_POINT
| temperature
| The temperature at which the creature's cheese (if any) starts taking cold damage.

|-
| CHEESE_FIXED_TEMP
| temperature
| The temperature emitted by one unit of the creature's cheese (if any).

|-
| CHEESE_HEATDAM_POINT
| temperature
| The temperature at which the cheese made from the creature's milk starts taking heat damage.

|-
| CHEESE_IGNITE_POINT
| temperature
| The temperature at which the creature's cheese bursts into flame.

|-
| CHEESE_MELTING_POINT
| temperature
| The temperature at which the creature's cheese melts into goo.

|-
| [[Creature_Tokens/SPEC_HEAT|CHEESE_SPEC_HEAT]]
| not a temperature
| Specific heat? (temperature difference required to change the temperature of the creature's cheese?) {{verify}}

|-
| CHEESE_VALUE
| value
| The value per unit of cheese made from the creature's milk (if applicable). Note that only vermin as of current can be milked.

|-
| CHILD
| age
| Age at which a child becomes an adult.
[CHILD:12]

|-
| CHILDNAME
|
* singular
* plural
| Gives the child a special name, eg "hippo calf" instead of "hippo child".
[CHILDNAME:hippo calf:hippo calves]

|-
| CHITIN
|
| When the creature is butchered, it drops chitin, which functions as leather.

|-
| CRAFTSMAN_NAME
|
* singular
* plural
| Sets the name of the craftsman profession.
[CRAFTSMAN_NAME:craftsdwarf:craftsdwarves]

|-
| CREPUSCULAR
|
| Sets if the creature is active in twilight.

|-
| CLUSTER_NUMBER
|
* minimum
* maximum
| The minimum/maximum numbers of how many creatures per spawned cluster.
[CLUSTER_NUMBER:1:3]

|-
| COLOR
|
* fg (foreground)
* bg (background)
* br (brightness)
| [[Color]] of the creature's tile.
[COLOR:3:0:0]

|-
| COOKABLE_LIVE
|
| Set this to allow the creature to be cooked in meals without having to butcher it first.

|-
| CREATURE
| name
| What the game looks for when generating creatures.
[CREATURE:DWARF]

|-
| COLDDAM_POINT
| temperature
| The minimum temperature limit before the creature starts taking damage from freezing.

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

|-
| CURIOUSBEAST_EATER
|
| Allows a creature to eat edible items that it finds? (may imply CURIOUSBEAST_ITEM?) {{verify}}

|-
| CURIOUSBEAST_ITEM
|
| Allows a creature to steal things (usually [[food]]?).

|-
| CURIOUSBEAST_GUZZLER
|
| Will steal [[alcohol]]? Implies CURIOUSBEAST.

|}

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

|-
| DAMBLOCK
| value
| How much natural armor a creature has. Can be set to negative numbers, so the creature takes more damage than usual.
[DAMBLOCK:1]

|-
| DEFENDER
|
| Appears from the glowing pits in a group.

|-
| DIFFICULTY
| number
| [[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.
[DIFFICULTY:2]

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

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

|-
| DRINK_BOILING_POINT
| temperature
| The temperature at which a drink (milk?) produced from the creature will boil.

|-
| DRINK_COLDDAM_POINT
| temperature
| The temperature at which said drink will take cold damage.

|-
| DRINK_FIXED_TEMP
| temperature
| The temperature emitted by one unit of the creature's drink (if any).

|-
| DRINK_HEATDAM_POINT
| temperature
| The temperature at which aforementioned drink will take heat damage.

|-
| DRINK_IGNITE_POINT
| temperature
| The temperature at which the drink will set your fort ablaze.

|-
| DRINK_MELTING_POINT
| temperature
| [[User:GreyMario]] sez: "Isn't this, like, redundant? It's ''already'' liquid. Perhaps it controls at which point the drink solidifies?" {{verify}}

|-
| [[Creature_Tokens/SPEC_HEAT|DRINK_SPEC_HEAT]]
| not a temperature
| The difference in temperature required to modify the temperature of the drink? {{verify}}

|}

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

|-
| ENDING
|
| Will show up as a leader (only one of them) in a group from the glowing pits.

|-
| EQUIPMENT_WAGON
|
| Implies two unknown flags, NOSTUN, NONAUSEA, NOBLEED, NOEMOTION, NOSTUCKINS, SEVERONBREAKS, NOSKULL, NOSKIN, NOBONES, NOMEAT, PARALYZEIMMUNE, NOFEAR, NOSMELLYROT, NOTHOUGHT, NO_GENDER.

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

|-
| EVIL
|
| Determines whether creature can show up on "evil" maps (see [[Creatures#Threat Matrix|Threat Matrix]]).

|-
| EXTRACT
|
* name
* value
* ? (always 0)
* ? (0 on venoms exception: giant desert scorpion venom)
| Determines what can be extracted from the creature, what it's called, how valuable it is, and what you can make from it. Note, it appears that the extraction process is hardcoded into the game, and can't be altered from objects/raw.
[EXTRACT:cow's milk:7:0:1]

|-
| EXTRACT_ANTIDOTE
|
* name
* value
* ? (always 0)
* ? (always 0)
* ? (always 50 or 100)
| [EXTRACT_ANTIDOTE:cave spider antivenin:7:0:0:50]

|-
| EXTRACT_BOILING_POINT
| temperature
| The temperature value at which a unit of the creature's extract boils away.

|-
| EXTRACT_CHEESE
|
* name
* value
* ?
* ?
| The extract gotten from the creature is a unit of cheese.
[EXTRACT_CHEESE:cow cheese:6:0:1]

|-
| EXTRACT_COOKABLE
|
| Extract is cookable.

|-
| EXTRACT_COLDDAM_POINT
| temperature
| The low temperature value at which the creature's extract starts to take damage.

|-
| EXTRACT_FIXED_TEMP
| temperature
| The temperature that the creature's extract generates on its own.

|-
| EXTRACT_HEATDAM_POINT
| temperature
| The high temperature value at which the creature's extract starts to take damage.

|-
| EXTRACT_IGNITE_POINT
| temperature
| The temperature at which the creature's extract bursts into flame (NOT the container it's in).

|-
| EXTRACT_MELTING_POINT
| temperature
| The temperature at which the creature's extract melts into goo.

|-
| EXTRACT_PARALYZE
|
| (conjectural) Extract is poisonous, causing paralysis that lasts until the extract wears off. Can be delivered by SPECIALATTACK_INJECT_EXTRACT.

|-
| EXTRACT_PARALYZE_INTERMITTENT
|
| (conjectural) Extract is poisonous, causing paralysis on occasional intervals until the extract wears off. Can be delivered by SPECIALATTACK_INJECT_EXTRACT.

|-
| EXTRACT_PERMANENT
|
| (conjectural) The effects of the creature's extract are permanent once applied and do not wear off naturally.

|-
| EXTRACT_SIZE
| size
|
[EXTRACT_SIZE:10]

|-
| [[Creature_Tokens/SPEC_HEAT|EXTRACT_SPEC_HEAT]]
| not a temperature
| The difference in temperature required to modify the temperature of the creature's extract? {{verify}}

|-
| EXTRACT_STUN
|
| (conjectural) Extract is poisonous, causing a permanent stun effect until the extract wears off. Can be delivered by SPECIALATTACK_INJECT_EXTRACT.

|-
| EXTRACT_STUN_INTERMITTENT
|
| (verified) Extract is poisonous, causing temporary stuns on semi-occasional intervals. Can be delivered by SPECIALATTACK_INJECT_EXTRACT.

|-
| EXTRACT_VALUE
| value
| The value per unit of the creature's extract.
[EXTRACT_VALUE:20]

|-
| EXTRAVISION
|
| Creature has enhanced vision (longer vision range, ie. at night).

|}

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

|-
| FAT
| value
| How much fat a creature produces when it is butchered.
[FAT:3]

|-
| FEMALE
|
| The creature is always female.

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

|-
| FIREIMMUNE
|
| The creature is immune to all forms of fire, except DRAGONFIREBREATH.

|-
| FIREIMMUNE_SUPER
|
| The creature is immune to DRAGONFIREBREATH. AI acts as if FIREIMMUNE. Does NOT imply FIREIMMUNE.

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

|-
| FIXED_TEMP
| temperature
| The natural heat generated by the creature. [FIXED_TEMP:1-?]

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

|-
| FLIER
|
| Allows a creature to fly. Currently, an AI bug prevents this from being useful on PC races in fortress mode.

|-
| FREQUENCY
| time
| Determines the time between creature spawns in Fortress Mode. Higher is more occurences per time unit{{verify}}. Creatures without a frequency statement appear to be on the map at all times. Almost all others have either [FREQUENCY:5] or [FREQUENCY:100].
[FREQUENCY:42]

|}

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

|-
| GENPOWER
| rate?
| Not used anymore and can be removed safely. Was related to magic.
[GENPOWER:3]

|-
| GLOWCOLOR
|
* fg
* bg
* br
| The colour of the GLOWTILE of the creature (see below).

[GLOWCOLOR:4:0:1]

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

[GLOWTILE:'"']

|-
| GNAWER
|
| The creature chews on food storage containers.

|-
| GOOD
|
| Determines whether creature can show up on "good" maps (see [[Creatures#Threat Matrix|Threat Matrix]]).

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

|}

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

|-
| HAS_RACEGLOSS
| gloss
| Links a material glossary to the creature. It is hardcoded, and there is only 4 types of tag.
[HAS_RACEGLOSS:WOOD]
[HAS_RACEGLOSS:STONE]
[HAS_RACEGLOSS:METAL]
[HAS_RACEGLOSS:PLANT]

|-
| HASSHELL
|
| Creature will leave behind a shell when eaten.

|-
| HEATDAM_POINT
| temperature
| The maximum temperature limit before the creature will start recieving damage from heat. [[Temperature scale|DF temperature scale]]

|-
| HOMEOTHERM
| value
| Default 'NONE'. The creature's normal body temperature. Combined with LAYERING, sets the temperature range under which it can live. [[Temperature scale|DF temperature scale]]

|-
| HORN
|
| Creature drops a horn or horns when butchered, which presumably acts like bone. This tag is broken.

|}

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

|-
| IGNITE_POINT
| temperature
| The temperature at which the creature will burst into flames. [[Temperature scale|DF temperature scale]]

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

|-
| IMMOBILE_LAND
|
| The creature is immobile while on land

|-
| INTELLIGENT
|
| Implies CAN_CIV, CAN_SPEAK, CAN_LEARN.

|-
| ITEMCORPSE
|
* [[Item Tokens|item token]]
* subtype
NO_SUBTYPE
* [[Matgloss_tokens|matgloss token]]
* NO_RACEGLOSS
USE_RACEGLOSS
USE_SHARPSTONE
| Determines if the creature leaves behind a non-standard corpse (i.e. wood, statue, bars, etc). The first parameter determines the item type; the second parameter is the subtype indicated in the raw file (such as WEAPON_WHIP); the third indicates the material type if the item type takes a specific material (e.g. "IRON" if the corpse type is "STATUE"). USE_RACEGLOSS applies if the creature has a material glossary assigned by the "HAS_RACEGLOSS:" flag and will select neccesary adjectives and material from that glossary.
[ITEMCORPSE:[[Item Tokens|WOOD]]:NO_SUBTYPE:[[Material Tokens|WOOD]]:USE_RACEGLOSS]

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

|-
| IVORY
|
| Creature will produce ivory when butchered. Currently doesn't work.

|}

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

|-
| LARGE_CAVERIVER
|
| In Fortress Mode, spawns from/near cave rivers.

|-
| LARGE_CHASM
|
| In Fortress Mode, spawns from/near chasms.

|-
| LARGE_LAVA
|
| In Fortress Mode, spawns from/near magma.

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

|-
| LAYERING
| value
| How well-protected the creature is from low temperatures. If this number is too high, it will confine a creature to only arctic areas. If it is even higher it will prevent the creature from spawning at all.

|-
| LEATHER_BOILING_POINT
| temperature
| The temperature at which leather made from the creature's skins will boil away.

|-
| LEATHER_COLDDAM_POINT
| temperature
| The temperature at which leather made from the creature's skins will take damage.

|-
| LEATHER_FIXED_TEMP
| temperature
| The temperature that leather made from the creature's skins generates.

|-
| LEATHER_HEATDAM_POINT
| temperature
| The temperature at which leather made from the creature's skins will take damage.

|-
| LEATHER_IGNITE_POINT
| temperature
| The temperature at which leather made from the creature's skins will burst into flames.

|-
| LEATHER_MELTING_POINT
| temperature
| The temperature at which leather made from the creature's skins will melt away.

|-
| [[Creature_Tokens/SPEC_HEAT|LEATHER_SPEC_HEAT]]
| not a temperature
| The difference in temperature required to modify the temperature of the creature's leather? {{verify}}

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

|-
| LIKES_FIGHTING
|
|

|-
| 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. Implies [TRAPAVOID]

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

|}

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

|-
| MAGICAL
|
| Allows a creature to use magic? However, magic isn't implemented yet.

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

|-
| MALE
|
| The creature is always male.

|-
| MATERIAL
|
* [[Matgloss_tokens|Matgloss token]]
* USE_RACEGLOSS
|

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

|-
| MAXAGE
|
* minimum
* maximum
| Sets the Min Max age for a creature. Used in world generating and Fortress Mode.
[MAXAGE:150:170]

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

|-
| MEGABEAST
|
| Appears on fortress territory in Fortress Mode occasionally. Implies SEMIMEGABEAST.

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

|-
| MILKABLE
| frequency?
| Allows the creature to be milked. Currently only works with vermin creatures.

|-
| MISCHIEVIOUS
|
| Will pull any levers it comes across. (requires confirmation)

|-
| MODVALUE
| number
| Multiplies the value of items made from the creature by the number in the tag.
[MODVALUE:2]

|-
| MOUNT
|
| Allows the creature to be mounted. Currently only works with siegers. The same AI bug that causes issues with [FLIER] PC races in fortress mode causes worse issues with flying mounts, though when unmounted the creature will fly just fine. [SWIMS_INNATE] may or may not have similar issues on mounts.

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

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

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

|}

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

|-
| NAME
|
* singular noun
* plural noun
* adjective
| What the creature is actually called in game. Make sure there is no space around the ":".
[NAME:dwarf:dwarves:dwarven]

|-
| NARROW
|
| The creature can only wear things that have the narrow tag on it.

|-
| NATURAL
|
| Animal

|-
| NO_AUTUMN
|
| Will not show up during the Autumn season.

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

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

|-
| NO_GENDER
|
| No gender will be selected for the creature.

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

|-
| NO_SPRING
|
| Will not show up during the Spring season.

|-
| NO_SUMMER
|
| Will not show up during the Summer season.

|-
| NO_WINTER
|
| Will not show up during the Winter season.

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

|-
| NOBLEED
|
| Creature doesn't bleed.

|-
| NOBONES
|
| Creature will not drop bones on butcher, rot, or decay of severed body parts.

|-
| 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
|
| Creatures' corpse does not create miasma.

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

|-
| NOSTUN
|
| Creature can't be stunned.

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

|-
| NOT_BUTCHERABLE
|
| Creature can't be butchered.

|}

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

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

|-
| PATTERNFLIER
|
| Flies in a semi-predictable pattern? {{verify}}

|-
| 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 greater than the penetrate power, their contents escape for the time being. Other objects roll a 0-99.

|-
| PERSONALITY
|
* token
* lowest % chance
* median
* highest % chance
| Determines chance of personality traits. Standard is 0:50:100. See [[Personality traits]] for more info.
[PERSONALITY:IMAGINATION:0:55:100]

|-
| 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:42]

|-
| POPULATION_NUMBER
|
* minimum
* maximum
| The minimum/maximum numbers of how many of these creatures can show up on a map per year.
[POPULATION_NUMBER:42:42]

|-
| POWER
|
| Allows the creature to be worshiped by entities with the RELIGION:ANY_APPROPRIATE_POWER tag.

|-
| PREFSTRING
| object
| Sets what other creatures like about this creature. "Blarghh likes dwarves for their beards."
[PREFSTRING:beards]
Multiple entries will be chosen from at random.

|}

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

|-
| REMAINS
| <''singular''>:<''plural''>
| ??? Used by treants along with [REMAINS_UNDETERMINED], appears to change the name of a creatures remains.

|-
| REMAINS_COLOR
|
* fg
* bg
* br
| The color of the creature's remains. Used by treants.

[REMAINS_COLOR:6:0:0]
|-
| REMAINS_UNDETERMINED
|
|

|}

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

|-
| SAVAGE
|
| Determines whether creature can show up on "savage" maps.

|-
| SEMIMEGABEAST
|
| Appears as boss creature in quests.

|-
| SESSILE_LAND
|
| Obsolete. Use [[#I|[IMMOBILE_LAND]]].

|-
| SEVERONBREAKS
|
| Limbs and body parts sever on breakage.

|-
| SILK_BOILING_POINT
| temperature
| Temperature at which silk made from this creature's webs boils away.

|-
| SILK_COLDDAM_POINT
| temperature
| Temperature at which silk made from this creature's webs takes damage.

|-
| SILK_FIXED_TEMP
| temperature
| Temperature generated by the creature's web silk.

|-
| SILK_HEATDAM_POINT
| temperature
| Temperature at which silk made from this creature's webs takes damage.

|-
| SILK_IGNITE_POINT
| temperature
| Temperature at which silk made from this creature's webs bursts into flame.

|-
| SILK_MELTING_POINT
| temperature
| Temperature at which silk made from this creature's webs melts away.

|-
| [[Creature_Tokens/SPEC_HEAT|SILK_SPEC_HEAT]]
| not a temperature
| The difference in temperature required to modify the temperature of the creature's silk? {{verify}}

|-
| SIZE
| value
| How big a creature is. 6 is for dwarf like creatures, 7 is for human like creatures. 16 is for giants. Larger creatures are far more dangerous in combat. Also equals the amount of Meat/Chunks/Bones you get from the beast.
[SIZE:6]

|-
| SLOW_LEARNER
|
| Presumably similar to [CAN_LEARN], but slower. Present in the entries for ogres and giants

|-
| SMALLAQUATIC_CAVERIVER
|
|

|-
| SMALLAQUATIC_OCEAN
|
|

|-
| SMALLAQUATIC_RIVER
|
|

|-
| SMALLAQUATIC_SWAMP
|
|

|-
| SMALL_REMAINS
|
| If a creature has this token, it'll leave a small corpse that only rots once, such as vermin.

|-
| SPECNAME
|
*token
*singular noun
*plural noun
*adjective
| Sets a special name for certain instances.
[SPECNAME:MALE:bull:bulls:bull]

|-
| [[Creature_Tokens/SPEC_HEAT|SPEC_HEAT]]
| not a temperature
| The specific heat of a creature? {{verify}}
[SPEC_HEAT:409]

|-
| SPEECH
| filename
| Sets what speech.txt to use when insulting the creature.
[SPEECH:dwarf.txt]

|-
| SPEECH_MALE
| filename
| Used in place of [SPEECH] for humans; perhaps sets the speech.txt to use for males only? Humans don't have a corresponding [SPEECH_FEMALE] token, though, which only occurs in the [[string dump]].
[SPEECH_MALE:human_male.txt]

|-
| SPEED
| value
| Sets the creatures' movement and work speed, 1000/[100 + SPEED X] is the resulting effect on creatures movement and workrates from default. See [[Speed]] for more information.
[SPEED:400]

|-
| SPHERE
| [[sphere]]
| Sets what religious spheres the creature is aligned to, for purposes of being worshiped via the [POWER] token. By default, only used by [[Demon|hidden fun stuff]].

|-
| STOUT
|
| Creature has a resistance to being knocked over.

|-
| STANDARD_FLESH
|
|

|-
| 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 must learn to swim. Requires [CAN_LEARN], obviously.

|-
| SWIM_SPEED
| value
| How fast the creature swims.

|}

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

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

|-
| TILE
| CP437 ordinal or 'character'
| The graphical representation of the creature.
[TILE:157] or [TILE:'&']

|-
| TRADE_CAPACITY
| weight
| How much the creature can carry when used by merchants.
[TRADE_CAPACITY:2000]

|-
| TRAINABLE
|
| Allows a tame creature to be trained into a "War" or "Hunting" variation by way of [[Kennels]].

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

|-
| TRAPAVOID
|
| The creature is immune to traps.

|-
| TRIGGERABLE_GROUP
|
* minimum?
* maximum?
| [TRIGGERABLE_GROUP:5:50]

|}

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

|-
| UNDERSWIM
|
| Creature swims under the water and can't be seen.
|-
| UTTERANCES
|
| Changes the language of the creature into an unintelligible mess.

|}

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

|-
| VEGETATION
|
|

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

|-
| VERMIN_BITE
|
* amount injected or chance of injection?
* name
* effect (USE_EXTRACT)
| [VERMIN_BITE:10:bitten:USE_EXTRACT]
On very rare occasions, someone who remains in the same tile as this creature will be bitten by that creature, and the effect will be applied to the offender. Used by (tiny) cave spiders to inject their venom into the occasional dwarf.

|-
| VERMIN_EATER
|
| The creature can eat your food.

|-
| 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. – [[User:Peristarkawan|Peristarkawan]] 17:27, 24 May 2007 (EDT)

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

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

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

|-
| VERMIN_NOTRAP
|
| The creature cannot be caught by trappers or animal traps.

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

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

|-
| VIEWRANGE
| value
| How far the creature can see?

|}

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

|-
| WAGON_PULLER
|
| Allows the creature to pull caravan wagons.

|-
| WEBBER
|
| The creature will create webs. It also seems to make creatures flying. More testing is needed.

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

|}

=Attacks=
{| {{prettytable}}
|- bgcolor="#ddd"
!width="50"|Tag
!width="225"|What It Does

|-
|[ATTACK:MAIN:BYTYPE:GRASP:punch:punches:1:2:BLUDGEON][ATTACKFLAG_WITH]

''Format:''
[ATTACK:''priority'':(BYTYPE:''type'' || BYTOKEN:''bodypart''):''"verb"'':''"conjugate verb"'':''min dmg'':''max dmg'':''dmg type'']([(ATTACKFLAG_WITH || ATTACKFLAG_CANLATCH)])([SPECIALATTACK_INJECT_EXTRACT:''min'':''max''])
|Sets what natural attacks a creature has.

|-
|MAIN
SECOND
|''MAIN'': Sets the attack to act as the creatures' main attack.
''SECOND'': The creature will only use this attack if it can't use the MAIN attack(s).

|-
|BYTYPE:GRASP
BYTOKEN:TAIL_STINGER
|''BYTYPE'': Sets what body part type to use for the attack. Possible values for "type" are GRASP, MOUTH, STANCE, THOUGHT, BREATHE, and the like. See [[Body Tokens]].
''BYTOKEN'': Sets the explicit body part ID to use for the attack. The token must exist as part of the creature's [[Creature Tokens#B|BODY]] token.

|-
|punch:punches
|Sets the verb for the attack.

|-
|1:2
|Sets the Min Max for the damage.

|-
|BLUDGEON, PIERCE, SLASH, GORE, BURN, HEAT, COLD
|Sets the damage type for the attack.

|-
|[ATTACKFLAG_WITH]
|Attacks in combat inform which body part was used in the attack.
"Ratman punches Blargg with his right hand."

|-
|[ATTACKFLAG_CANLATCH]
|Allows the creature to latch on with the attack. "Crocodile latches on Blargg's head firmly."

|-
|[SPECIALATTACK_INJECT_EXTRACT:50:100]
|The creature injects an amount of its extract into a victim upon successfully using this attack. The significance of the amount is unknown (but probably determines duration before the extract wears off).

|-
|[SPECIALATTACK_SUCK_BLOOD:50:100]
|When blood is drained from a creature, it causes heavy bleeding (depending on the attacking creatures ability to suck blood). It's unknown if blood suckers feed or regain health while doing this. (Numbers affect amount of blood drawn?)
|}

[[Category:Modding]]
[[Category:Tokens]]

40d:Creature token

2009-04-19T05:10:48Z

Darekun: /* V */ Conjectural chance of injection on [VERMIN_BITE].

Everything here can be applied to all creature files, e.g. creature_domestic, creature_standard, even creature_equipment.

Since the game is in the Alpha stage, consider everything '''tentative'''.

{| id="toc"
|
* Tokens
** [[#A|A]] [[#B|B]] [[#C|C]] [[#D|D]] [[#E|E]] [[#F|F]] [[#G|G]] [[#H|H]] [[#I|I]] [[#J|J]] [[#K|K]] [[#L|L]] [[#M|M]]
** [[#N|N]] [[#O|O]] [[#P|P]] [[#Q|Q]] [[#R|R]] [[#S|S]] [[#T|T]] [[#U|U]] [[#V|V]] [[#W|W]] [[#X|X]] [[#Y|Y]] [[#Z|Z]]
|}
__NOTOC__

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

|-
| ADD_VERSION
| version
| In which version of the game said creature was introduced. Not used anymore in the 3D version.
[ADD_VERSION:1069]

|-
| 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/MATUTINAL, rather than implying them.

|-
| ALTTILE
| [[Character Table|CP437 ordinal]] or 'character'
| If set, the creature will blink between its [TILE] and its [ALTTILE].
[ALTTILE:157] or [ALTTILE:'&']

|-
| AMBUSHPREDATOR
|
| Makes the creature start out hidden. Used by giant cave spiders. May make webs hidden too?

|-
| AMPHIBIOUS
|
| Allows a creature to breathe with or without water.

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

|-
| ATTACK
|
| See the [[#Attacks|Attacks section]].

|}

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

|-
| BABY
| age
| Age at which a baby becomes a child. Without this tag, all creatures born will skip the baby stage and be children upon birth.
[BABY:1]

|-
| BEACH_FREQUENCY
| value
| Whales and jellyfish have this. Controls the beaching frequency of the creature.
[BEACH_FREQUENCY:10]

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

|-
| BIOME:*
|
| See [[Biome Tokens|biome tokens]].

|-
| BLOODTYPE
| type
| Sets the creatures' blood type (default red):
*R - Red blood
*G - Green blood
*B - Blue blood
*M - Magenta blood
*C - Cyan blood
*Y - Yellow pus
*W - White ichor
*0 - Black goo
*VOMIT
*SLIME
[BLOODTYPE:0]

|-
| [[Body_tokens|BODY]]
| parts[:...]
| Sets the body parts a creature has. Can supply as many as you want.
[BODY:HUMANOID:2EYES:2EARS]

|-
| [[Bodygloss|BODYGLOSS]]
| gloss
| A body_default.txt function. It replaces a part's description with another. e.g. feet with hooves.
[BODYGLOSS:HOOF]

|-
| BOILING_POINT
| temperature
| The temperature at which the creature boils into goo. [[Temperature scale|DF temperature scale]]

|-
| BONE_BOILING_POINT
| temperature
| The boiling point of the creature's bones.

|-
| BONE_COLDDAM_POINT
| temperature
| The low temperature at which the creature's bones start getting damaged.

|-
| BONE_FIXED_TEMP
| temperature
| The temperature that the creature's bones give off.

|-
| BONE_HEATDAM_POINT
| temperature
| The high temperature where the bones start taking damage.

|-
| BONE_IGNITE_POINT
| temperature
| The temperature at which point the creature's bones burst into flame.

|-
| BONE_MELTING_POINT
| temperature
| The temperature at which the creature's bones melt.

|-
| [[Creature_Tokens/SPEC_HEAT|BONE_SPEC_HEAT]]
| not a temperature
| Specific heat? (temperature difference required to change the temperature of the creature's bones?) {{verify}}

|-
| BONECARN
|
| Creature 'eats' bones. Eating bones makes their happiness go up, but can cause death (suffocation). This tag implies CARNIVORE.

|-
| BUILDINGDESTROYER
| value
| Allows a creature to destroy furniture and buildings. Creatures with BUILDINGDESTROYER will actively seek out your constructions and destroy them. A creature can have this value at 1 or 2. When the value is 1, the creature will go after wooden hatches, wooden doors, supports, statues, windows and archery targets only. They can't destroy homes during world gen as (semi)megabeasts.
When the value is 2 the creature will actively seek out most (all?) constructions and destroy them. They can also destroy buildings during world-gen with this tag. Megabeasts rely on this token for their pathing when attacking your fort.
[BUILDINGDESTROYER:2]

|-
| BUTCHERABLE_NONSTANDARD
|
| (old) If a creature has this tag, it may only be slaughtered (that is, the live creature is taken to the [[Butcher's Shop]] and slain). If it dies of any other cause, the corpse cannot be butchered.

|}

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

|-
| CAN_CIV
|
| Can create civilizations. This tag may activate hunger and thirst. {{verify}}

|-
| CAN_LEARN
|
| A creature with this tag can gain skill experience.

|-
| CAN_SPEAK
|
| Can talk.

|-
| CANNOT_UNDEAD
|
| Cannot become undead.

|-
| CARNIVORE
|
| Creature only eats meat.

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

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

|-
| CHEESE_BOILING_POINT
| temperature
| The temperature at which the creature's cheese (if any) boils away.

|-
| CHEESE_COLDDAM_POINT
| temperature
| The temperature at which the creature's cheese (if any) starts taking cold damage.

|-
| CHEESE_FIXED_TEMP
| temperature
| The temperature emitted by one unit of the creature's cheese (if any).

|-
| CHEESE_HEATDAM_POINT
| temperature
| The temperature at which the cheese made from the creature's milk starts taking heat damage.

|-
| CHEESE_IGNITE_POINT
| temperature
| The temperature at which the creature's cheese bursts into flame.

|-
| CHEESE_MELTING_POINT
| temperature
| The temperature at which the creature's cheese melts into goo.

|-
| [[Creature_Tokens/SPEC_HEAT|CHEESE_SPEC_HEAT]]
| not a temperature
| Specific heat? (temperature difference required to change the temperature of the creature's cheese?) {{verify}}

|-
| CHEESE_VALUE
| value
| The value per unit of cheese made from the creature's milk (if applicable). Note that only vermin as of current can be milked.

|-
| CHILD
| age
| Age at which a child becomes an adult.
[CHILD:12]

|-
| CHILDNAME
|
* singular
* plural
| Gives the child a special name, eg "hippo calf" instead of "hippo child".
[CHILDNAME:hippo calf:hippo calves]

|-
| CHITIN
|
| When the creature is butchered, it drops chitin, which functions as leather.

|-
| CRAFTSMAN_NAME
|
* singular
* plural
| Sets the name of the craftsman profession.
[CRAFTSMAN_NAME:craftsdwarf:craftsdwarves]

|-
| CREPUSCULAR
|
| Sets if the creature is active in twilight.

|-
| CLUSTER_NUMBER
|
* minimum
* maximum
| The minimum/maximum numbers of how many creatures per spawned cluster.
[CLUSTER_NUMBER:1:3]

|-
| COLOR
|
* fg (foreground)
* bg (background)
* br (brightness)
| [[Color]] of the creature's tile.
[COLOR:3:0:0]

|-
| COOKABLE_LIVE
|
| Set this to allow the creature to be cooked in meals without having to butcher it first.

|-
| CREATURE
| name
| What the game looks for when generating creatures.
[CREATURE:DWARF]

|-
| COLDDAM_POINT
| temperature
| The minimum temperature limit before the creature starts taking damage from freezing.

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

|-
| CURIOUSBEAST_EATER
|
| Allows a creature to eat edible items that it finds? (may imply CURIOUSBEAST_ITEM?) {{verify}}

|-
| CURIOUSBEAST_ITEM
|
| Allows a creature to steal things (usually [[food]]?).

|-
| CURIOUSBEAST_GUZZLER
|
| Will steal [[alcohol]]? Implies CURIOUSBEAST.

|}

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

|-
| DAMBLOCK
| value
| How much natural armor a creature has. Can be set to negative numbers, so the creature takes more damage than usual.
[DAMBLOCK:1]

|-
| DEFENDER
|
| Appears from the glowing pits in a group.

|-
| DIFFICULTY
| number
| [[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.
[DIFFICULTY:2]

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

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

|-
| DRINK_BOILING_POINT
| temperature
| The temperature at which a drink (milk?) produced from the creature will boil.

|-
| DRINK_COLDDAM_POINT
| temperature
| The temperature at which said drink will take cold damage.

|-
| DRINK_FIXED_TEMP
| temperature
| The temperature emitted by one unit of the creature's drink (if any).

|-
| DRINK_HEATDAM_POINT
| temperature
| The temperature at which aforementioned drink will take heat damage.

|-
| DRINK_IGNITE_POINT
| temperature
| The temperature at which the drink will set your fort ablaze.

|-
| DRINK_MELTING_POINT
| temperature
| [[User:GreyMario]] sez: "Isn't this, like, redundant? It's ''already'' liquid. Perhaps it controls at which point the drink solidifies?" {{verify}}

|-
| [[Creature_Tokens/SPEC_HEAT|DRINK_SPEC_HEAT]]
| not a temperature
| The difference in temperature required to modify the temperature of the drink? {{verify}}

|}

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

|-
| ENDING
|
| Will show up as a leader (only one of them) in a group from the glowing pits.

|-
| EQUIPMENT_WAGON
|
| Implies two unknown flags, NOSTUN, NONAUSEA, NOBLEED, NOEMOTION, NOSTUCKINS, SEVERONBREAKS, NOSKULL, NOSKIN, NOBONES, NOMEAT, PARALYZEIMMUNE, NOFEAR, NOSMELLYROT, NOTHOUGHT, NO_GENDER.

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

|-
| EVIL
|
| Determines whether creature can show up on "evil" maps (see [[Creatures#Threat Matrix|Threat Matrix]]).

|-
| EXTRACT
|
* name
* value
* ? (always 0)
* ? (0 on venoms exception: giant desert scorpion venom)
| Determines what can be extracted from the creature, what it's called, how valuable it is, and what you can make from it. Note, it appears that the extraction process is hardcoded into the game, and can't be altered from objects/raw.
[EXTRACT:cow's milk:7:0:1]

|-
| EXTRACT_ANTIDOTE
|
* name
* value
* ? (always 0)
* ? (always 0)
* ? (always 50 or 100)
| [EXTRACT_ANTIDOTE:cave spider antivenin:7:0:0:50]

|-
| EXTRACT_BOILING_POINT
| temperature
| The temperature value at which a unit of the creature's extract boils away.

|-
| EXTRACT_CHEESE
|
* name
* value
* ?
* ?
| The extract gotten from the creature is a unit of cheese.
[EXTRACT_CHEESE:cow cheese:6:0:1]

|-
| EXTRACT_COOKABLE
|
| Extract is cookable.

|-
| EXTRACT_COLDDAM_POINT
| temperature
| The low temperature value at which the creature's extract starts to take damage.

|-
| EXTRACT_FIXED_TEMP
| temperature
| The temperature that the creature's extract generates on its own.

|-
| EXTRACT_HEATDAM_POINT
| temperature
| The high temperature value at which the creature's extract starts to take damage.

|-
| EXTRACT_IGNITE_POINT
| temperature
| The temperature at which the creature's extract bursts into flame (NOT the container it's in).

|-
| EXTRACT_MELTING_POINT
| temperature
| The temperature at which the creature's extract melts into goo.

|-
| EXTRACT_PARALYZE
|
| (conjectural) Extract is poisonous, causing paralysis that lasts until the extract wears off. Can be delivered by SPECIALATTACK_INJECT_EXTRACT.

|-
| EXTRACT_PARALYZE_INTERMITTENT
|
| (conjectural) Extract is poisonous, causing paralysis on occasional intervals until the extract wears off. Can be delivered by SPECIALATTACK_INJECT_EXTRACT.

|-
| EXTRACT_PERMANENT
|
| (conjectural) The effects of the creature's extract are permanent once applied and do not wear off naturally.

|-
| EXTRACT_SIZE
| size
|
[EXTRACT_SIZE:10]

|-
| [[Creature_Tokens/SPEC_HEAT|EXTRACT_SPEC_HEAT]]
| not a temperature
| The difference in temperature required to modify the temperature of the creature's extract? {{verify}}

|-
| EXTRACT_STUN
|
| (conjectural) Extract is poisonous, causing a permanent stun effect until the extract wears off. Can be delivered by SPECIALATTACK_INJECT_EXTRACT.

|-
| EXTRACT_STUN_INTERMITTENT
|
| (verified) Extract is poisonous, causing temporary stuns on semi-occasional intervals. Can be delivered by SPECIALATTACK_INJECT_EXTRACT.

|-
| EXTRACT_VALUE
| value
| The value per unit of the creature's extract.
[EXTRACT_VALUE:20]

|-
| EXTRAVISION
|
| Creature has enhanced vision (longer vision range, ie. at night).

|}

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

|-
| FAT
| value
| How much fat a creature produces when it is butchered.
[FAT:3]

|-
| FEMALE
|
| The creature is always female.

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

|-
| FIREIMMUNE
|
| The creature is immune to all forms of fire, except DRAGONFIREBREATH.

|-
| FIREIMMUNE_SUPER
|
| The creature is immune to DRAGONFIREBREATH. AI acts as if FIREIMMUNE. Does NOT imply FIREIMMUNE.

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

|-
| FIXED_TEMP
| temperature
| The natural heat generated by the creature. [FIXED_TEMP:1-?]

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

|-
| FLIER
|
| Allows a creature to fly. Currently, an AI bug prevents this from being useful on PC races in fortress mode.

|-
| FREQUENCY
| time
| Determines the time between creature spawns in Fortress Mode. Higher is more occurences per time unit{{verify}}. Creatures without a frequency statement appear to be on the map at all times. Almost all others have either [FREQUENCY:5] or [FREQUENCY:100].
[FREQUENCY:42]

|}

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

|-
| GENPOWER
| rate?
| Not used anymore and can be removed safely. Was related to magic.
[GENPOWER:3]

|-
| GLOWCOLOR
|
* fg
* bg
* br
| The colour of the GLOWTILE of the creature (see below).

[GLOWCOLOR:4:0:1]

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

[GLOWTILE:'"']

|-
| GNAWER
|
| The creature chews on food storage containers.

|-
| GOOD
|
| Determines whether creature can show up on "good" maps (see [[Creatures#Threat Matrix|Threat Matrix]]).

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

|}

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

|-
| HAS_RACEGLOSS
| gloss
| Links a material glossary to the creature. It is hardcoded, and there is only 4 types of tag.
[HAS_RACEGLOSS:WOOD]
[HAS_RACEGLOSS:STONE]
[HAS_RACEGLOSS:METAL]
[HAS_RACEGLOSS:PLANT]

|-
| HASSHELL
|
| Creature will leave behind a shell when eaten.

|-
| HEATDAM_POINT
| temperature
| The maximum temperature limit before the creature will start recieving damage from heat. [[Temperature scale|DF temperature scale]]

|-
| HOMEOTHERM
| value
| Default 'NONE'. The creature's normal body temperature. Combined with LAYERING, sets the temperature range under which it can live. [[Temperature scale|DF temperature scale]]

|-
| HORN
|
| Creature drops a horn or horns when butchered, which presumably acts like bone. This tag is broken.

|}

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

|-
| IGNITE_POINT
| temperature
| The temperature at which the creature will burst into flames. [[Temperature scale|DF temperature scale]]

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

|-
| IMMOBILE_LAND
|
| The creature is immobile while on land

|-
| INTELLIGENT
|
| Implies CAN_CIV, CAN_SPEAK, CAN_LEARN.

|-
| ITEMCORPSE
|
* [[Item Tokens|item token]]
* subtype
NO_SUBTYPE
* [[Matgloss_tokens|matgloss token]]
* NO_RACEGLOSS
USE_RACEGLOSS
USE_SHARPSTONE
| Determines if the creature leaves behind a non-standard corpse (i.e. wood, statue, bars, etc). The first parameter determines the item type; the second parameter is the subtype indicated in the raw file (such as WEAPON_WHIP); the third indicates the material type if the item type takes a specific material (e.g. "IRON" if the corpse type is "STATUE"). USE_RACEGLOSS applies if the creature has a material glossary assigned by the "HAS_RACEGLOSS:" flag and will select neccesary adjectives and material from that glossary.
[ITEMCORPSE:[[Item Tokens|WOOD]]:NO_SUBTYPE:[[Material Tokens|WOOD]]:USE_RACEGLOSS]

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

|-
| IVORY
|
| Creature will produce ivory when butchered. Currently doesn't work.

|}

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

|-
| LARGE_CAVERIVER
|
| In Fortress Mode, spawns from/near cave rivers.

|-
| LARGE_CHASM
|
| In Fortress Mode, spawns from/near chasms.

|-
| LARGE_LAVA
|
| In Fortress Mode, spawns from/near magma.

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

|-
| LAYERING
| value
| How well-protected the creature is from low temperatures. If this number is too high, it will confine a creature to only arctic areas. If it is even higher it will prevent the creature from spawning at all.

|-
| LEATHER_BOILING_POINT
| temperature
| The temperature at which leather made from the creature's skins will boil away.

|-
| LEATHER_COLDDAM_POINT
| temperature
| The temperature at which leather made from the creature's skins will take damage.

|-
| LEATHER_FIXED_TEMP
| temperature
| The temperature that leather made from the creature's skins generates.

|-
| LEATHER_HEATDAM_POINT
| temperature
| The temperature at which leather made from the creature's skins will take damage.

|-
| LEATHER_IGNITE_POINT
| temperature
| The temperature at which leather made from the creature's skins will burst into flames.

|-
| LEATHER_MELTING_POINT
| temperature
| The temperature at which leather made from the creature's skins will melt away.

|-
| [[Creature_Tokens/SPEC_HEAT|LEATHER_SPEC_HEAT]]
| not a temperature
| The difference in temperature required to modify the temperature of the creature's leather? {{verify}}

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

|-
| LIKES_FIGHTING
|
|

|-
| 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. Implies [TRAPAVOID]

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

|}

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

|-
| MAGICAL
|
| Allows a creature to use magic? However, magic isn't implemented yet.

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

|-
| MALE
|
| The creature is always male.

|-
| MATERIAL
|
* [[Matgloss_tokens|Matgloss token]]
* USE_RACEGLOSS
|

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

|-
| MAXAGE
|
* minimum
* maximum
| Sets the Min Max age for a creature. Used in world generating and Fortress Mode.
[MAXAGE:150:170]

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

|-
| MEGABEAST
|
| Appears on fortress territory in Fortress Mode occasionally. Implies SEMIMEGABEAST.

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

|-
| MILKABLE
| frequency?
| Allows the creature to be milked. Currently only works with vermin creatures.

|-
| MISCHIEVIOUS
|
| Will pull any levers it comes across. (requires confirmation)

|-
| MODVALUE
| number
| Multiplies the value of items made from the creature by the number in the tag.
[MODVALUE:2]

|-
| MOUNT
|
| Allows the creature to be mounted. Currently only works with siegers. The same AI bug that causes issues with [FLIER] PC races in fortress mode causes worse issues with flying mounts, though when unmounted the creature will fly just fine. [SWIMS_INNATE] may or may not have similar issues on mounts.

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

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

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

|}

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

|-
| NAME
|
* singular noun
* plural noun
* adjective
| What the creature is actually called in game. Make sure there is no space around the ":".
[NAME:dwarf:dwarves:dwarven]

|-
| NARROW
|
| The creature can only wear things that have the narrow tag on it.

|-
| NATURAL
|
| Animal

|-
| NO_AUTUMN
|
| Will not show up during the Autumn season.

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

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

|-
| NO_GENDER
|
| No gender will be selected for the creature.

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

|-
| NO_SPRING
|
| Will not show up during the Spring season.

|-
| NO_SUMMER
|
| Will not show up during the Summer season.

|-
| NO_WINTER
|
| Will not show up during the Winter season.

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

|-
| NOBLEED
|
| Creature doesn't bleed.

|-
| NOBONES
|
| Creature will not drop bones on butcher, rot, or decay of severed body parts.

|-
| 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
|
| Creatures' corpse does not create miasma.

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

|-
| NOSTUN
|
| Creature can't be stunned.

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

|-
| NOT_BUTCHERABLE
|
| Creature can't be butchered.

|}

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

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

|-
| PATTERNFLIER
|
| Flies in a semi-predictable pattern? {{verify}}

|-
| 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 greater than the penetrate power, their contents escape for the time being. Other objects roll a 0-99.

|-
| PERSONALITY
|
* token
* lowest % chance
* median
* highest % chance
| Determines chance of personality traits. Standard is 0:50:100. See [[Personality traits]] for more info.
[PERSONALITY:IMAGINATION:0:55:100]

|-
| 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:42]

|-
| POPULATION_NUMBER
|
* minimum
* maximum
| The minimum/maximum numbers of how many of these creatures can show up on a map per year.
[POPULATION_NUMBER:42:42]

|-
| POWER
|
| Allows the creature to be worshiped by entities with the RELIGION:ANY_APPROPRIATE_POWER tag.

|-
| PREFSTRING
| object
| Sets what other creatures like about this creature. "Blarghh likes dwarves for their beards."
[PREFSTRING:beards]
Multiple entries will be chosen from at random.

|}

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

|-
| REMAINS
| <''singular''>:<''plural''>
| ??? Used by treants along with [REMAINS_UNDETERMINED], appears to change the name of a creatures remains.

|-
| REMAINS_COLOR
|
* fg
* bg
* br
| The color of the creature's remains. Used by treants.

[REMAINS_COLOR:6:0:0]
|-
| REMAINS_UNDETERMINED
|
|

|}

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

|-
| SAVAGE
|
| Determines whether creature can show up on "savage" maps.

|-
| SEMIMEGABEAST
|
| Appears as boss creature in quests.

|-
| SESSILE_LAND
|
| Obsolete. Use [[#I|[IMMOBILE_LAND]]].

|-
| SEVERONBREAKS
|
| Limbs and body parts sever on breakage.

|-
| SILK_BOILING_POINT
| temperature
| Temperature at which silk made from this creature's webs boils away.

|-
| SILK_COLDDAM_POINT
| temperature
| Temperature at which silk made from this creature's webs takes damage.

|-
| SILK_FIXED_TEMP
| temperature
| Temperature generated by the creature's web silk.

|-
| SILK_HEATDAM_POINT
| temperature
| Temperature at which silk made from this creature's webs takes damage.

|-
| SILK_IGNITE_POINT
| temperature
| Temperature at which silk made from this creature's webs bursts into flame.

|-
| SILK_MELTING_POINT
| temperature
| Temperature at which silk made from this creature's webs melts away.

|-
| [[Creature_Tokens/SPEC_HEAT|SILK_SPEC_HEAT]]
| not a temperature
| The difference in temperature required to modify the temperature of the creature's silk? {{verify}}

|-
| SIZE
| value
| How big a creature is. 6 is for dwarf like creatures, 7 is for human like creatures. 16 is for giants. Larger creatures are far more dangerous in combat. Also equals the amount of Meat/Chunks/Bones you get from the beast.
[SIZE:6]

|-
| SLOW_LEARNER
|
| Presumably similar to [CAN_LEARN], but slower. Present in the entries for ogres and giants

|-
| SMALLAQUATIC_CAVERIVER
|
|

|-
| SMALLAQUATIC_OCEAN
|
|

|-
| SMALLAQUATIC_RIVER
|
|

|-
| SMALLAQUATIC_SWAMP
|
|

|-
| SMALL_REMAINS
|
| If a creature has this token, it'll leave a small corpse that only rots once, such as vermin.

|-
| SPECNAME
|
*token
*singular noun
*plural noun
*adjective
| Sets a special name for certain instances.
[SPECNAME:MALE:bull:bulls:bull]

|-
| [[Creature_Tokens/SPEC_HEAT|SPEC_HEAT]]
| not a temperature
| The specific heat of a creature? {{verify}}
[SPEC_HEAT:409]

|-
| SPEECH
| filename
| Sets what speech.txt to use for the creature.
[SPEECH:dwarf.txt]

|-
| SPEECH_MALE
| filename
| Used in place of [SPEECH] for humans; perhaps sets the speech.txt to use for males only? Humans don't have a corresponding [SPEECH_FEMALE] token, though, which only occurs in the [[string dump]].
[SPEECH_MALE:human_male.txt]

|-
| SPEED
| value
| Sets the creatures' movement and work speed, 1000/[100 + SPEED X] is the resulting effect on creatures movement and workrates from default. See [[Speed]] for more information.
[SPEED:400]

|-
| SPHERE
| [[sphere]]
| Sets what religious spheres the creature is aligned to, for purposes of being worshiped via the [POWER] token. By default, only used by [[Demon|hidden fun stuff]].

|-
| STOUT
|
| Creature has a resistance to being knocked over.

|-
| STANDARD_FLESH
|
|

|-
| 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 must learn to swim. Requires [CAN_LEARN], obviously.

|-
| SWIM_SPEED
| value
| How fast the creature swims.

|}

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

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

|-
| TILE
| CP437 ordinal or 'character'
| The graphical representation of the creature.
[TILE:157] or [TILE:'&']

|-
| TRADE_CAPACITY
| weight
| How much the creature can carry when used by merchants.
[TRADE_CAPACITY:2000]

|-
| TRAINABLE
|
| Allows a tame creature to be trained into a "War" or "Hunting" variation by way of [[Kennels]].

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

|-
| TRAPAVOID
|
| The creature is immune to traps.

|-
| TRIGGERABLE_GROUP
|
* minimum?
* maximum?
| [TRIGGERABLE_GROUP:5:50]

|}

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

|-
| UNDERSWIM
|
| Creature swims under the water and can't be seen.
|-
| UTTERANCES
|
| Changes the language of the creature into an unintelligible mess.

|}

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

|-
| VEGETATION
|
|

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

|-
| VERMIN_BITE
|
* amount injected or chance of injection?
* name
* effect (USE_EXTRACT)
| [VERMIN_BITE:10:bitten:USE_EXTRACT]
On very rare occasions, someone who remains in the same tile as this creature will be bitten by that creature, and the effect will be applied to the offender. Used by (tiny) cave spiders to inject their venom into the occasional dwarf.

|-
| VERMIN_EATER
|
| The creature can eat your food.

|-
| 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. – [[User:Peristarkawan|Peristarkawan]] 17:27, 24 May 2007 (EDT)

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

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

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

|-
| VERMIN_NOTRAP
|
| The creature cannot be caught by trappers or animal traps.

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

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

|-
| VIEWRANGE
| value
| How far the creature can see?

|}

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

|-
| WAGON_PULLER
|
| Allows the creature to pull caravan wagons.

|-
| WEBBER
|
| The creature will create webs. It also seems to make creatures flying. More testing is needed.

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

|}

=Attacks=
{| {{prettytable}}
|- bgcolor="#ddd"
!width="50"|Tag
!width="225"|What It Does

|-
|[ATTACK:MAIN:BYTYPE:GRASP:punch:punches:1:2:BLUDGEON][ATTACKFLAG_WITH]

''Format:''
[ATTACK:''priority'':(BYTYPE:''type'' || BYTOKEN:''bodypart''):''"verb"'':''"conjugate verb"'':''min dmg'':''max dmg'':''dmg type'']([(ATTACKFLAG_WITH || ATTACKFLAG_CANLATCH)])([SPECIALATTACK_INJECT_EXTRACT:''min'':''max''])
|Sets what natural attacks a creature has.

|-
|MAIN
SECOND
|''MAIN'': Sets the attack to act as the creatures' main attack.
''SECOND'': The creature will only use this attack if it can't use the MAIN attack(s).

|-
|BYTYPE:GRASP
BYTOKEN:TAIL_STINGER
|''BYTYPE'': Sets what body part type to use for the attack. Possible values for "type" are GRASP, MOUTH, STANCE, THOUGHT, BREATHE, and the like. See [[Body Tokens]].
''BYTOKEN'': Sets the explicit body part ID to use for the attack. The token must exist as part of the creature's [[Creature Tokens#B|BODY]] token.

|-
|punch:punches
|Sets the verb for the attack.

|-
|1:2
|Sets the Min Max for the damage.

|-
|BLUDGEON, PIERCE, SLASH, GORE, BURN, HEAT, COLD
|Sets the damage type for the attack.

|-
|[ATTACKFLAG_WITH]
|Attacks in combat inform which body part was used in the attack.
"Ratman punches Blargg with his right hand."

|-
|[ATTACKFLAG_CANLATCH]
|Allows the creature to latch on with the attack. "Crocodile latches on Blargg's head firmly."

|-
|[SPECIALATTACK_INJECT_EXTRACT:50:100]
|The creature injects an amount of its extract into a victim upon successfully using this attack. The significance of the amount is unknown (but probably determines duration before the extract wears off).

|-
|[SPECIALATTACK_SUCK_BLOOD:50:100]
|When blood is drained from a creature, it causes heavy bleeding (depending on the attacking creatures ability to suck blood). It's unknown if blood suckers feed or regain health while doing this. (Numbers affect amount of blood drawn?)
|}

[[Category:Modding]]
[[Category:Tokens]]

40d:Creature token

2009-04-19T00:59:24Z

Darekun: /* M */ Documented the limited use of [MOUNT], and its interactions with the [FLIER] AI bug.

Everything here can be applied to all creature files, e.g. creature_domestic, creature_standard, even creature_equipment.

Since the game is in the Alpha stage, consider everything '''tentative'''.

{| id="toc"
|
* Tokens
** [[#A|A]] [[#B|B]] [[#C|C]] [[#D|D]] [[#E|E]] [[#F|F]] [[#G|G]] [[#H|H]] [[#I|I]] [[#J|J]] [[#K|K]] [[#L|L]] [[#M|M]]
** [[#N|N]] [[#O|O]] [[#P|P]] [[#Q|Q]] [[#R|R]] [[#S|S]] [[#T|T]] [[#U|U]] [[#V|V]] [[#W|W]] [[#X|X]] [[#Y|Y]] [[#Z|Z]]
|}
__NOTOC__

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

|-
| ADD_VERSION
| version
| In which version of the game said creature was introduced. Not used anymore in the 3D version.
[ADD_VERSION:1069]

|-
| 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/MATUTINAL, rather than implying them.

|-
| ALTTILE
| [[Character Table|CP437 ordinal]] or 'character'
| If set, the creature will blink between its [TILE] and its [ALTTILE].
[ALTTILE:157] or [ALTTILE:'&']

|-
| AMBUSHPREDATOR
|
| Makes the creature start out hidden. Used by giant cave spiders. May make webs hidden too?

|-
| AMPHIBIOUS
|
| Allows a creature to breathe with or without water.

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

|-
| ATTACK
|
| See the [[#Attacks|Attacks section]].

|}

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

|-
| BABY
| age
| Age at which a baby becomes a child. Without this tag, all creatures born will skip the baby stage and be children upon birth.
[BABY:1]

|-
| BEACH_FREQUENCY
| value
| Whales and jellyfish have this. Controls the beaching frequency of the creature.
[BEACH_FREQUENCY:10]

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

|-
| BIOME:*
|
| See [[Biome Tokens|biome tokens]].

|-
| BLOODTYPE
| type
| Sets the creatures' blood type (default red):
*R - Red blood
*G - Green blood
*B - Blue blood
*M - Magenta blood
*C - Cyan blood
*Y - Yellow pus
*W - White ichor
*0 - Black goo
*VOMIT
*SLIME
[BLOODTYPE:0]

|-
| [[Body_tokens|BODY]]
| parts[:...]
| Sets the body parts a creature has. Can supply as many as you want.
[BODY:HUMANOID:2EYES:2EARS]

|-
| [[Bodygloss|BODYGLOSS]]
| gloss
| A body_default.txt function. It replaces a part's description with another. e.g. feet with hooves.
[BODYGLOSS:HOOF]

|-
| BOILING_POINT
| temperature
| The temperature at which the creature boils into goo. [[Temperature scale|DF temperature scale]]

|-
| BONE_BOILING_POINT
| temperature
| The boiling point of the creature's bones.

|-
| BONE_COLDDAM_POINT
| temperature
| The low temperature at which the creature's bones start getting damaged.

|-
| BONE_FIXED_TEMP
| temperature
| The temperature that the creature's bones give off.

|-
| BONE_HEATDAM_POINT
| temperature
| The high temperature where the bones start taking damage.

|-
| BONE_IGNITE_POINT
| temperature
| The temperature at which point the creature's bones burst into flame.

|-
| BONE_MELTING_POINT
| temperature
| The temperature at which the creature's bones melt.

|-
| [[Creature_Tokens/SPEC_HEAT|BONE_SPEC_HEAT]]
| not a temperature
| Specific heat? (temperature difference required to change the temperature of the creature's bones?) {{verify}}

|-
| BONECARN
|
| Creature 'eats' bones. Eating bones makes their happiness go up, but can cause death (suffocation). This tag implies CARNIVORE.

|-
| BUILDINGDESTROYER
| value
| Allows a creature to destroy furniture and buildings. Creatures with BUILDINGDESTROYER will actively seek out your constructions and destroy them. A creature can have this value at 1 or 2. When the value is 1, the creature will go after wooden hatches, wooden doors, supports, statues, windows and archery targets only. They can't destroy homes during world gen as (semi)megabeasts.
When the value is 2 the creature will actively seek out most (all?) constructions and destroy them. They can also destroy buildings during world-gen with this tag. Megabeasts rely on this token for their pathing when attacking your fort.
[BUILDINGDESTROYER:2]

|-
| BUTCHERABLE_NONSTANDARD
|
| (old) If a creature has this tag, it may only be slaughtered (that is, the live creature is taken to the [[Butcher's Shop]] and slain). If it dies of any other cause, the corpse cannot be butchered.

|}

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

|-
| CAN_CIV
|
| Can create civilizations. This tag may activate hunger and thirst. {{verify}}

|-
| CAN_LEARN
|
| A creature with this tag can gain skill experience.

|-
| CAN_SPEAK
|
| Can talk.

|-
| CANNOT_UNDEAD
|
| Cannot become undead.

|-
| CARNIVORE
|
| Creature only eats meat.

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

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

|-
| CHEESE_BOILING_POINT
| temperature
| The temperature at which the creature's cheese (if any) boils away.

|-
| CHEESE_COLDDAM_POINT
| temperature
| The temperature at which the creature's cheese (if any) starts taking cold damage.

|-
| CHEESE_FIXED_TEMP
| temperature
| The temperature emitted by one unit of the creature's cheese (if any).

|-
| CHEESE_HEATDAM_POINT
| temperature
| The temperature at which the cheese made from the creature's milk starts taking heat damage.

|-
| CHEESE_IGNITE_POINT
| temperature
| The temperature at which the creature's cheese bursts into flame.

|-
| CHEESE_MELTING_POINT
| temperature
| The temperature at which the creature's cheese melts into goo.

|-
| [[Creature_Tokens/SPEC_HEAT|CHEESE_SPEC_HEAT]]
| not a temperature
| Specific heat? (temperature difference required to change the temperature of the creature's cheese?) {{verify}}

|-
| CHEESE_VALUE
| value
| The value per unit of cheese made from the creature's milk (if applicable). Note that only vermin as of current can be milked.

|-
| CHILD
| age
| Age at which a child becomes an adult.
[CHILD:12]

|-
| CHILDNAME
|
* singular
* plural
| Gives the child a special name, eg "hippo calf" instead of "hippo child".
[CHILDNAME:hippo calf:hippo calves]

|-
| CHITIN
|
| When the creature is butchered, it drops chitin, which functions as leather.

|-
| CRAFTSMAN_NAME
|
* singular
* plural
| Sets the name of the craftsman profession.
[CRAFTSMAN_NAME:craftsdwarf:craftsdwarves]

|-
| CREPUSCULAR
|
| Sets if the creature is active in twilight.

|-
| CLUSTER_NUMBER
|
* minimum
* maximum
| The minimum/maximum numbers of how many creatures per spawned cluster.
[CLUSTER_NUMBER:1:3]

|-
| COLOR
|
* fg (foreground)
* bg (background)
* br (brightness)
| [[Color]] of the creature's tile.
[COLOR:3:0:0]

|-
| COOKABLE_LIVE
|
| Set this to allow the creature to be cooked in meals without having to butcher it first.

|-
| CREATURE
| name
| What the game looks for when generating creatures.
[CREATURE:DWARF]

|-
| COLDDAM_POINT
| temperature
| The minimum temperature limit before the creature starts taking damage from freezing.

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

|-
| CURIOUSBEAST_EATER
|
| Allows a creature to eat edible items that it finds? (may imply CURIOUSBEAST_ITEM?) {{verify}}

|-
| CURIOUSBEAST_ITEM
|
| Allows a creature to steal things (usually [[food]]?).

|-
| CURIOUSBEAST_GUZZLER
|
| Will steal [[alcohol]]? Implies CURIOUSBEAST.

|}

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

|-
| DAMBLOCK
| value
| How much natural armor a creature has. Can be set to negative numbers, so the creature takes more damage than usual.
[DAMBLOCK:1]

|-
| DEFENDER
|
| Appears from the glowing pits in a group.

|-
| DIFFICULTY
| number
| [[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.
[DIFFICULTY:2]

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

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

|-
| DRINK_BOILING_POINT
| temperature
| The temperature at which a drink (milk?) produced from the creature will boil.

|-
| DRINK_COLDDAM_POINT
| temperature
| The temperature at which said drink will take cold damage.

|-
| DRINK_FIXED_TEMP
| temperature
| The temperature emitted by one unit of the creature's drink (if any).

|-
| DRINK_HEATDAM_POINT
| temperature
| The temperature at which aforementioned drink will take heat damage.

|-
| DRINK_IGNITE_POINT
| temperature
| The temperature at which the drink will set your fort ablaze.

|-
| DRINK_MELTING_POINT
| temperature
| [[User:GreyMario]] sez: "Isn't this, like, redundant? It's ''already'' liquid. Perhaps it controls at which point the drink solidifies?" {{verify}}

|-
| [[Creature_Tokens/SPEC_HEAT|DRINK_SPEC_HEAT]]
| not a temperature
| The difference in temperature required to modify the temperature of the drink? {{verify}}

|}

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

|-
| ENDING
|
| Will show up as a leader (only one of them) in a group from the glowing pits.

|-
| EQUIPMENT_WAGON
|
| Implies two unknown flags, NOSTUN, NONAUSEA, NOBLEED, NOEMOTION, NOSTUCKINS, SEVERONBREAKS, NOSKULL, NOSKIN, NOBONES, NOMEAT, PARALYZEIMMUNE, NOFEAR, NOSMELLYROT, NOTHOUGHT, NO_GENDER.

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

|-
| EVIL
|
| Determines whether creature can show up on "evil" maps (see [[Creatures#Threat Matrix|Threat Matrix]]).

|-
| EXTRACT
|
* name
* value
* ? (always 0)
* ? (0 on venoms exception: giant desert scorpion venom)
| Determines what can be extracted from the creature, what it's called, how valuable it is, and what you can make from it. Note, it appears that the extraction process is hardcoded into the game, and can't be altered from objects/raw.
[EXTRACT:cow's milk:7:0:1]

|-
| EXTRACT_ANTIDOTE
|
* name
* value
* ? (always 0)
* ? (always 0)
* ? (always 50 or 100)
| [EXTRACT_ANTIDOTE:cave spider antivenin:7:0:0:50]

|-
| EXTRACT_BOILING_POINT
| temperature
| The temperature value at which a unit of the creature's extract boils away.

|-
| EXTRACT_CHEESE
|
* name
* value
* ?
* ?
| The extract gotten from the creature is a unit of cheese.
[EXTRACT_CHEESE:cow cheese:6:0:1]

|-
| EXTRACT_COOKABLE
|
| Extract is cookable.

|-
| EXTRACT_COLDDAM_POINT
| temperature
| The low temperature value at which the creature's extract starts to take damage.

|-
| EXTRACT_FIXED_TEMP
| temperature
| The temperature that the creature's extract generates on its own.

|-
| EXTRACT_HEATDAM_POINT
| temperature
| The high temperature value at which the creature's extract starts to take damage.

|-
| EXTRACT_IGNITE_POINT
| temperature
| The temperature at which the creature's extract bursts into flame (NOT the container it's in).

|-
| EXTRACT_MELTING_POINT
| temperature
| The temperature at which the creature's extract melts into goo.

|-
| EXTRACT_PARALYZE
|
| (conjectural) Extract is poisonous, causing paralysis that lasts until the extract wears off. Can be delivered by SPECIALATTACK_INJECT_EXTRACT.

|-
| EXTRACT_PARALYZE_INTERMITTENT
|
| (conjectural) Extract is poisonous, causing paralysis on occasional intervals until the extract wears off. Can be delivered by SPECIALATTACK_INJECT_EXTRACT.

|-
| EXTRACT_PERMANENT
|
| (conjectural) The effects of the creature's extract are permanent once applied and do not wear off naturally.

|-
| EXTRACT_SIZE
| size
|
[EXTRACT_SIZE:10]

|-
| [[Creature_Tokens/SPEC_HEAT|EXTRACT_SPEC_HEAT]]
| not a temperature
| The difference in temperature required to modify the temperature of the creature's extract? {{verify}}

|-
| EXTRACT_STUN
|
| (conjectural) Extract is poisonous, causing a permanent stun effect until the extract wears off. Can be delivered by SPECIALATTACK_INJECT_EXTRACT.

|-
| EXTRACT_STUN_INTERMITTENT
|
| (verified) Extract is poisonous, causing temporary stuns on semi-occasional intervals. Can be delivered by SPECIALATTACK_INJECT_EXTRACT.

|-
| EXTRACT_VALUE
| value
| The value per unit of the creature's extract.
[EXTRACT_VALUE:20]

|-
| EXTRAVISION
|
| Creature has enhanced vision (longer vision range, ie. at night).

|}

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

|-
| FAT
| value
| How much fat a creature produces when it is butchered.
[FAT:3]

|-
| FEMALE
|
| The creature is always female.

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

|-
| FIREIMMUNE
|
| The creature is immune to all forms of fire, except DRAGONFIREBREATH.

|-
| FIREIMMUNE_SUPER
|
| The creature is immune to DRAGONFIREBREATH. AI acts as if FIREIMMUNE. Does NOT imply FIREIMMUNE.

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

|-
| FIXED_TEMP
| temperature
| The natural heat generated by the creature. [FIXED_TEMP:1-?]

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

|-
| FLIER
|
| Allows a creature to fly. Currently, an AI bug prevents this from being useful on PC races in fortress mode.

|-
| FREQUENCY
| time
| Determines the time between creature spawns in Fortress Mode. Higher is more occurences per time unit{{verify}}. Creatures without a frequency statement appear to be on the map at all times. Almost all others have either [FREQUENCY:5] or [FREQUENCY:100].
[FREQUENCY:42]

|}

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

|-
| GENPOWER
| rate?
| Not used anymore and can be removed safely. Was related to magic.
[GENPOWER:3]

|-
| GLOWCOLOR
|
* fg
* bg
* br
| The colour of the GLOWTILE of the creature (see below).

[GLOWCOLOR:4:0:1]

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

[GLOWTILE:'"']

|-
| GNAWER
|
| The creature chews on food storage containers.

|-
| GOOD
|
| Determines whether creature can show up on "good" maps (see [[Creatures#Threat Matrix|Threat Matrix]]).

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

|}

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

|-
| HAS_RACEGLOSS
| gloss
| Links a material glossary to the creature. It is hardcoded, and there is only 4 types of tag.
[HAS_RACEGLOSS:WOOD]
[HAS_RACEGLOSS:STONE]
[HAS_RACEGLOSS:METAL]
[HAS_RACEGLOSS:PLANT]

|-
| HASSHELL
|
| Creature will leave behind a shell when eaten.

|-
| HEATDAM_POINT
| temperature
| The maximum temperature limit before the creature will start recieving damage from heat. [[Temperature scale|DF temperature scale]]

|-
| HOMEOTHERM
| value
| Default 'NONE'. The creature's normal body temperature. Combined with LAYERING, sets the temperature range under which it can live. [[Temperature scale|DF temperature scale]]

|-
| HORN
|
| Creature drops a horn or horns when butchered, which presumably acts like bone. This tag is broken.

|}

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

|-
| IGNITE_POINT
| temperature
| The temperature at which the creature will burst into flames. [[Temperature scale|DF temperature scale]]

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

|-
| IMMOBILE_LAND
|
| The creature is immobile while on land

|-
| INTELLIGENT
|
| Implies CAN_CIV, CAN_SPEAK, CAN_LEARN.

|-
| ITEMCORPSE
|
* [[Item Tokens|item token]]
* subtype
NO_SUBTYPE
* [[Matgloss_tokens|matgloss token]]
* NO_RACEGLOSS
USE_RACEGLOSS
USE_SHARPSTONE
| Determines if the creature leaves behind a non-standard corpse (i.e. wood, statue, bars, etc). The first parameter determines the item type; the second parameter is the subtype indicated in the raw file (such as WEAPON_WHIP); the third indicates the material type if the item type takes a specific material (e.g. "IRON" if the corpse type is "STATUE"). USE_RACEGLOSS applies if the creature has a material glossary assigned by the "HAS_RACEGLOSS:" flag and will select neccesary adjectives and material from that glossary.
[ITEMCORPSE:[[Item Tokens|WOOD]]:NO_SUBTYPE:[[Material Tokens|WOOD]]:USE_RACEGLOSS]

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

|-
| IVORY
|
| Creature will produce ivory when butchered. Currently doesn't work.

|}

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

|-
| LARGE_CAVERIVER
|
| In Fortress Mode, spawns from/near cave rivers.

|-
| LARGE_CHASM
|
| In Fortress Mode, spawns from/near chasms.

|-
| LARGE_LAVA
|
| In Fortress Mode, spawns from/near magma.

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

|-
| LAYERING
| value
| How well-protected the creature is from low temperatures. If this number is too high, it will confine a creature to only arctic areas. If it is even higher it will prevent the creature from spawning at all.

|-
| LEATHER_BOILING_POINT
| temperature
| The temperature at which leather made from the creature's skins will boil away.

|-
| LEATHER_COLDDAM_POINT
| temperature
| The temperature at which leather made from the creature's skins will take damage.

|-
| LEATHER_FIXED_TEMP
| temperature
| The temperature that leather made from the creature's skins generates.

|-
| LEATHER_HEATDAM_POINT
| temperature
| The temperature at which leather made from the creature's skins will take damage.

|-
| LEATHER_IGNITE_POINT
| temperature
| The temperature at which leather made from the creature's skins will burst into flames.

|-
| LEATHER_MELTING_POINT
| temperature
| The temperature at which leather made from the creature's skins will melt away.

|-
| [[Creature_Tokens/SPEC_HEAT|LEATHER_SPEC_HEAT]]
| not a temperature
| The difference in temperature required to modify the temperature of the creature's leather? {{verify}}

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

|-
| LIKES_FIGHTING
|
|

|-
| 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. Implies [TRAPAVOID]

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

|}

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

|-
| MAGICAL
|
| Allows a creature to use magic? However, magic isn't implemented yet.

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

|-
| MALE
|
| The creature is always male.

|-
| MATERIAL
|
* [[Matgloss_tokens|Matgloss token]]
* USE_RACEGLOSS
|

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

|-
| MAXAGE
|
* minimum
* maximum
| Sets the Min Max age for a creature. Used in world generating and Fortress Mode.
[MAXAGE:150:170]

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

|-
| MEGABEAST
|
| Appears on fortress territory in Fortress Mode occasionally. Implies SEMIMEGABEAST.

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

|-
| MILKABLE
| frequency?
| Allows the creature to be milked. Currently only works with vermin creatures.

|-
| MISCHIEVIOUS
|
| Will pull any levers it comes across. (requires confirmation)

|-
| MODVALUE
| number
| Multiplies the value of items made from the creature by the number in the tag.
[MODVALUE:2]

|-
| MOUNT
|
| Allows the creature to be mounted. Currently only works with siegers. The same AI bug that causes issues with [FLIER] PC races in fortress mode causes worse issues with flying mounts, though when unmounted the creature will fly just fine. [SWIMS_INNATE] may or may not have similar issues on mounts.

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

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

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

|}

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

|-
| NAME
|
* singular noun
* plural noun
* adjective
| What the creature is actually called in game. Make sure there is no space around the ":".
[NAME:dwarf:dwarves:dwarven]

|-
| NARROW
|
| The creature can only wear things that have the narrow tag on it.

|-
| NATURAL
|
| Animal

|-
| NO_AUTUMN
|
| Will not show up during the Autumn season.

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

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

|-
| NO_GENDER
|
| No gender will be selected for the creature.

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

|-
| NO_SPRING
|
| Will not show up during the Spring season.

|-
| NO_SUMMER
|
| Will not show up during the Summer season.

|-
| NO_WINTER
|
| Will not show up during the Winter season.

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

|-
| NOBLEED
|
| Creature doesn't bleed.

|-
| NOBONES
|
| Creature will not drop bones on butcher, rot, or decay of severed body parts.

|-
| 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
|
| Creatures' corpse does not create miasma.

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

|-
| NOSTUN
|
| Creature can't be stunned.

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

|-
| NOT_BUTCHERABLE
|
| Creature can't be butchered.

|}

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

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

|-
| PATTERNFLIER
|
| Flies in a semi-predictable pattern? {{verify}}

|-
| 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 greater than the penetrate power, their contents escape for the time being. Other objects roll a 0-99.

|-
| PERSONALITY
|
* token
* lowest % chance
* median
* highest % chance
| Determines chance of personality traits. Standard is 0:50:100. See [[Personality traits]] for more info.
[PERSONALITY:IMAGINATION:0:55:100]

|-
| 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:42]

|-
| POPULATION_NUMBER
|
* minimum
* maximum
| The minimum/maximum numbers of how many of these creatures can show up on a map per year.
[POPULATION_NUMBER:42:42]

|-
| POWER
|
| Allows the creature to be worshiped by entities with the RELIGION:ANY_APPROPRIATE_POWER tag.

|-
| PREFSTRING
| object
| Sets what other creatures like about this creature. "Blarghh likes dwarves for their beards."
[PREFSTRING:beards]
Multiple entries will be chosen from at random.

|}

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

|-
| REMAINS
| <''singular''>:<''plural''>
| ??? Used by treants along with [REMAINS_UNDETERMINED], appears to change the name of a creatures remains.

|-
| REMAINS_COLOR
|
* fg
* bg
* br
| The color of the creature's remains. Used by treants.

[REMAINS_COLOR:6:0:0]
|-
| REMAINS_UNDETERMINED
|
|

|}

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

|-
| SAVAGE
|
| Determines whether creature can show up on "savage" maps.

|-
| SEMIMEGABEAST
|
| Appears as boss creature in quests.

|-
| SESSILE_LAND
|
| Obsolete. Use [[#I|[IMMOBILE_LAND]]].

|-
| SEVERONBREAKS
|
| Limbs and body parts sever on breakage.

|-
| SILK_BOILING_POINT
| temperature
| Temperature at which silk made from this creature's webs boils away.

|-
| SILK_COLDDAM_POINT
| temperature
| Temperature at which silk made from this creature's webs takes damage.

|-
| SILK_FIXED_TEMP
| temperature
| Temperature generated by the creature's web silk.

|-
| SILK_HEATDAM_POINT
| temperature
| Temperature at which silk made from this creature's webs takes damage.

|-
| SILK_IGNITE_POINT
| temperature
| Temperature at which silk made from this creature's webs bursts into flame.

|-
| SILK_MELTING_POINT
| temperature
| Temperature at which silk made from this creature's webs melts away.

|-
| [[Creature_Tokens/SPEC_HEAT|SILK_SPEC_HEAT]]
| not a temperature
| The difference in temperature required to modify the temperature of the creature's silk? {{verify}}

|-
| SIZE
| value
| How big a creature is. 6 is for dwarf like creatures, 7 is for human like creatures. 16 is for giants. Larger creatures are far more dangerous in combat. Also equals the amount of Meat/Chunks/Bones you get from the beast.
[SIZE:6]

|-
| SLOW_LEARNER
|
| Presumably similar to [CAN_LEARN], but slower. Present in the entries for ogres and giants

|-
| SMALLAQUATIC_CAVERIVER
|
|

|-
| SMALLAQUATIC_OCEAN
|
|

|-
| SMALLAQUATIC_RIVER
|
|

|-
| SMALLAQUATIC_SWAMP
|
|

|-
| SMALL_REMAINS
|
| If a creature has this token, it'll leave a small corpse that only rots once, such as vermin.

|-
| SPECNAME
|
*token
*singular noun
*plural noun
*adjective
| Sets a special name for certain instances.
[SPECNAME:MALE:bull:bulls:bull]

|-
| [[Creature_Tokens/SPEC_HEAT|SPEC_HEAT]]
| not a temperature
| The specific heat of a creature? {{verify}}
[SPEC_HEAT:409]

|-
| SPEECH
| filename
| Sets what speech.txt to use for the creature.
[SPEECH:dwarf.txt]

|-
| SPEECH_MALE
| filename
| Used in place of [SPEECH] for humans; perhaps sets the speech.txt to use for males only? Humans don't have a corresponding [SPEECH_FEMALE] token, though, which only occurs in the [[string dump]].
[SPEECH_MALE:human_male.txt]

|-
| SPEED
| value
| Sets the creatures' movement and work speed, 1000/[100 + SPEED X] is the resulting effect on creatures movement and workrates from default. See [[Speed]] for more information.
[SPEED:400]

|-
| SPHERE
| [[sphere]]
| Sets what religious spheres the creature is aligned to, for purposes of being worshiped via the [POWER] token. By default, only used by [[Demon|hidden fun stuff]].

|-
| STOUT
|
| Creature has a resistance to being knocked over.

|-
| STANDARD_FLESH
|
|

|-
| 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 must learn to swim. Requires [CAN_LEARN], obviously.

|-
| SWIM_SPEED
| value
| How fast the creature swims.

|}

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

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

|-
| TILE
| CP437 ordinal or 'character'
| The graphical representation of the creature.
[TILE:157] or [TILE:'&']

|-
| TRADE_CAPACITY
| weight
| How much the creature can carry when used by merchants.
[TRADE_CAPACITY:2000]

|-
| TRAINABLE
|
| Allows a tame creature to be trained into a "War" or "Hunting" variation by way of [[Kennels]].

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

|-
| TRAPAVOID
|
| The creature is immune to traps.

|-
| TRIGGERABLE_GROUP
|
* minimum?
* maximum?
| [TRIGGERABLE_GROUP:5:50]

|}

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

|-
| UNDERSWIM
|
| Creature swims under the water and can't be seen.
|-
| UTTERANCES
|
| Changes the language of the creature into an unintelligible mess.

|}

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

|-
| VEGETATION
|
|

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

|-
| VERMIN_BITE
|
* amount injected?
* name
* effect (USE_EXTRACT)
| [VERMIN_BITE:10:bitten:USE_EXTRACT]
On very rare occasions, someone who remains in the same tile as this creature will be bitten by that creature, and the effect will be applied to the offender. Used by (tiny) cave spiders to inject their venom into the occasional dwarf.

|-
| VERMIN_EATER
|
| The creature can eat your food.

|-
| 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. – [[User:Peristarkawan|Peristarkawan]] 17:27, 24 May 2007 (EDT)

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

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

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

|-
| VERMIN_NOTRAP
|
| The creature cannot be caught by trappers or animal traps.

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

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

|-
| VIEWRANGE
| value
| How far the creature can see?

|}

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

|-
| WAGON_PULLER
|
| Allows the creature to pull caravan wagons.

|-
| WEBBER
|
| The creature will create webs. It also seems to make creatures flying. More testing is needed.

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

|}

=Attacks=
{| {{prettytable}}
|- bgcolor="#ddd"
!width="50"|Tag
!width="225"|What It Does

|-
|[ATTACK:MAIN:BYTYPE:GRASP:punch:punches:1:2:BLUDGEON][ATTACKFLAG_WITH]

''Format:''
[ATTACK:''priority'':(BYTYPE:''type'' || BYTOKEN:''bodypart''):''"verb"'':''"conjugate verb"'':''min dmg'':''max dmg'':''dmg type'']([(ATTACKFLAG_WITH || ATTACKFLAG_CANLATCH)])([SPECIALATTACK_INJECT_EXTRACT:''min'':''max''])
|Sets what natural attacks a creature has.

|-
|MAIN
SECOND
|''MAIN'': Sets the attack to act as the creatures' main attack.
''SECOND'': The creature will only use this attack if it can't use the MAIN attack(s).

|-
|BYTYPE:GRASP
BYTOKEN:TAIL_STINGER
|''BYTYPE'': Sets what body part type to use for the attack. Possible values for "type" are GRASP, MOUTH, STANCE, THOUGHT, BREATHE, and the like. See [[Body Tokens]].
''BYTOKEN'': Sets the explicit body part ID to use for the attack. The token must exist as part of the creature's [[Creature Tokens#B|BODY]] token.

|-
|punch:punches
|Sets the verb for the attack.

|-
|1:2
|Sets the Min Max for the damage.

|-
|BLUDGEON, PIERCE, SLASH, GORE, BURN, HEAT, COLD
|Sets the damage type for the attack.

|-
|[ATTACKFLAG_WITH]
|Attacks in combat inform which body part was used in the attack.
"Ratman punches Blargg with his right hand."

|-
|[ATTACKFLAG_CANLATCH]
|Allows the creature to latch on with the attack. "Crocodile latches on Blargg's head firmly."

|-
|[SPECIALATTACK_INJECT_EXTRACT:50:100]
|The creature injects an amount of its extract into a victim upon successfully using this attack. The significance of the amount is unknown (but probably determines duration before the extract wears off).

|-
|[SPECIALATTACK_SUCK_BLOOD:50:100]
|When blood is drained from a creature, it causes heavy bleeding (depending on the attacking creatures ability to suck blood). It's unknown if blood suckers feed or regain health while doing this. (Numbers affect amount of blood drawn?)
|}

[[Category:Modding]]
[[Category:Tokens]]

40d:Material token

2009-04-19T00:58:50Z

Darekun: Added link to Matgloss tokens.

:''You may be looking for [[Matgloss tokens]].''
These tokens are types of materials, used to specify for example what material an item is made of.

{| {{prettytable}}
|- bgcolor="#ddd"
! #
! Token
! Information
|-
| 1 || WOOD || Subtypes come from MATGLOSS_WOOD; or USE_RACEGLOSS within creature raws (e.g. ITEMCORPSE)
|-
| 2 || STONE || Subtypes come from MATGLOSS_STONE; or USE_LAVA_STONE
|-
| 3 || METAL || Subtypes come from MATGLOSS_METAL
|-
| 4 || BONE || Subtypes come from CREATURE
|-
| 5 || IVORY || Subtypes come from CREATURE
|-
| 6 || HORN || Subtypes come from CREATURE
|-
| 7 || AMBER || ???
|-
| 8 || CORAL || Subtypes come from CREATURE
|-
| 9 || PEARL || Subtypes come from CREATURE
|-
| 10 || SHELL || Subtypes come from CREATURE
|-
| 11 || LEATHER || Subtypes come from CREATURE
|-
| 12 || SILK || Subtypes come from CREATURE
|-
| 13 || PLANT_ALCOHOL || Subtypes come from MATGLOSS_PLANT
|-
| 14 || GLASS_GREEN || No subtypes use NONE or NO_MATGLOSS
|-
| 15 || GLASS_CLEAR || No subtypes use NONE or NO_MATGLOSS
|-
| 16 || GLASS_CRYSTAL || No subtypes use NONE or NO_MATGLOSS
|-
| 17 || SAND || No subtypes use NONE or NO_MATGLOSS
|-
| 18 || COAL || Subtype is either COKE or CHARCOAL
|-
| 19 || POTASH || No subtypes use NONE or NO_MATGLOSS
|-
| 20 || ASH || No subtypes use NONE or NO_MATGLOSS
|-
| 21 || PEARLASH || No subtypes use NONE or NO_MATGLOSS
|-
| 22 || LYE || No subtypes use NONE or NO_MATGLOSS
|-
| 23 || RENDERED_FAT || Subtypes come from CREATURE
|-
| 24 || SOAP_ANIMAL || Subtypes come from CREATURE
|-
| 25 || FAT || Subtypes come from CREATURE
|-
| 26 || MUD || ???
|-
| 27 || VOMIT || ???
|-
| 28 || BLOOD_NONSPECIFIC || Subtypes are probably the same as BLOODTYPE{{verify}}
|-
| 29 || BLOOD_SPECIFIC || Subtypes come from CREATURE
|-
| 30 || SLIME || ???
|-
| 31 || SALT || ???
|-
| 32 || FILTH_B || ???
|-
| 33 || FILTH_Y || ???
|-
| 34 || UNKNOWN_SUBSTANCE || ???
|-
| 35 || GRIME || ???
|}

CREATURE does not appear here in the exe, but has been observed with EXTRACT and CHEESE. PLANT does not appear here, but has been observed with POWDER_MISC. Subtypes come from the appropriate matgloss.

When making reactions that use the PLANT or SEEDS Item Tokens, use the name of the appropriate plant from matgloss_plant.txt as the Material Token, and NO_MATGLOSS for Matgloss Subtype.{{version|0.28.181.40d}}

When making reactions that use the REMAINS Item Tokens, use the name of the appropriate creature from creature_xxx.txt as the Material Token, and NO_MATGLOSS for Matgloss Subtype.

[[Category:Modding]]
[[Category:Tokens]]

40d:Irrigation

2009-04-13T10:47:54Z

Darekun: Capped some headers, added note on sand to dryland section, revised pond section to a model more useful for cave crops(and more dragon-safe), and added outdoor and de- sections based on OR.

'''Irrigation''' is the process of making rocky ground suitable for [[farming]]. This is usually done by [[flood]]ing it with [[water]]. Inside [[cave]]s, [[rock]] cavern floor tiles that are covered with water instantly become muddy tiles, which you can then build [[farm plot]]s on. There are many possible methods for getting the farm area muddy.

Dwarf Fortress uses reasonably-realistic water dynamics, including measures of [[water depth]]. A depth of 7 is full, depths of 1 will evaporate, leaving the stone wet and thus suitable for farming. Your goal in irrigation is to get a section of ground to be 1/7s.

== Dryland Farming: farming without irrigation ==

Some locations have layers of [[soil]] a few z-levels thick. It is not necessary to irrigate soil in order to grow crops on it; it is possible to build a farm plot directly on any soil tiles, although the dwarven crops such as [[plump helmet]]s can only be grown in a [[subterranean]] plot. Likewise, a farm plot built on any tile marked [[Tile_attributes|Above Ground]] can be used to grow outdoor crops such as [[prickle berry|prickle berries]]. This method obviates the need for irrigation entirely, so is recommended for newbies.

NOTE: Sand is a type of soil in Dwarf Fortress, so you can build farm plots on sand.

== Easy Irrigation ==

# {{K|d}}ig from the [[farm plot]] to any source of water, but keep a single tile of [[wall]] between the newbuilt passage and the water.
# Dig a passage from the plot towards lower ground or a pit, to serve as a water drain ''(this stage is not 100% necessary, but means you don't have to worry about having too much water and so is recommended)''.
# Build a [[floodgate]], and three [[mechanism]]s. (If you're worried about delay, use [[door]]s instead of floodgates.
# Place the floodgate in the passage. The idea is that it'll block the water from coming through when it's closed.
# Build a [[lever]] and link it to the floodgate.
# If you are building a drain, follow steps 3-5 again and place the second floodgate at the entrance to the drainage channel, linked to the second lever.
# {{K|P}}ull the first lever so the gate opens.
# Send a miner to dig that last wall keeping the water from rushing in.
#: Alternatively, have the miner dig a [[channel]] ({{K|d}},{{K|h}}) on that last wall from the Z-level above. This is much safer, since the miner will dig out the wall without actually having to stand in the way of the water.
# Use the first lever to close the channel once you've got enough water to spread over the area. If you have a drain, you can now let any excess drain off using your second lever.
# The water should now cover (or have covered) 1/7 of each tile.
# Wait for the water to evaporate and/or drain off (Dwarves can built farm plots in 1/7 water, so you don't need to wait).
# Enjoy your newly irrigated land.

== Reservoir Irrigation ==

The reservoir method involves building a small reservoir between two [[floodgate|floodgates]] and a farming chamber about 7 times as large as the reservoir. A reservoir of 12 tiles, for instance, can water a 70 tile chamber effectively. Water is let into the reservoir by lowering, then raising one floodgate. The other floodgate then releases the water into the farming chamber. It spreads around, then evaporates after becoming 1 deep.

The reservoir may be built above the plot to be irrigated with a [[hatch]] or [[bridge]] in the floor, to one side using floodgates, or below and [[pump]]ed upwards. Note that [[Bridge|bridges]], in their default state, will block water from falling between levels. The large surface area you can get this way can make the water spread over your farm area much faster than by using floodgates.

It is possible to achieve the same result using a natural pond as the water reservoir. Doing so is easier in the short term but it is not advised if you want to keep replenishing your reservoir for other uses, such as [[well]](s), for natural ponds have a very finite amount of water available. On particular maps, natural ponds can replenish themselves at the beginning of each spring.

=== Worked Example ===

To create this irrigation system, you need: [[Image:Tree_farm.png|right]]   

* A large growing room.
:*The large room can be any size. (For this example, we will use a 24 by 24 size room.)
* An adjacent smaller filling room that will be filled with exactly the right amount of water.
:*To calculate the size of this room, see below.
* A water supply line such as a tube leading to a water source.
* Lever-controlled [[door]]s or floodgates connecting the large room to the smaller one, and the smaller one to the water supply. Doors are preferred as you don't need levers for your [[dwarf]] to pass. (However, if you're paranoid or your dwarves are particularly dumb, you might want to lever them anyways. The creator of this method ([[User:GreyMario|GreyMario]]) recommends using doors because they have no delay when triggered.)

'''Calculating Room Size'''

There are 576 (24²) floor tiles in the large room (L). The small room (S) must hold enough water to cover the large room, the small room, and the space occupied by the door(s) (D) in between with 1 unit of water. Each tile of the small room can hold 7 units of water, so:

S = (L + S + D) / 7

-or-

S = (L + D) / 6

577/6 = 96 1/6; rounding up, this gives 97. This is the number of floor tiles in the smaller room: a 9X10 room with 7 extra tiles. Be aware, however, that if you make your "large" room ''too'' large, some of the water from the "small" room will [[evaporate]] before reaching the other end, and you will not have enough [[water]] to coat the floor. This behavior was observed in a room of 42X35 tiles.

Now, get digging. The water supply connects to the smaller filling room by a 1-tile hole where a door or [[floodgate]] will go. The filling room connects to the growing room the same way, and the growing room needs a door too. Remember to have the [[door|doors]] in place before breaching the water source and flooding the water supply line!

When you do breach the water source, immediately forbid the first door your miner runs through (see, this is why we use doors), which should be the door closest to the water source. Don't bother forbidding the other two. Link all three doors to three separate [[lever|levers]] and test the system. Close the door between the filling chamber and main farm area and open the door that leads to the water source. When the filling chamber is full, close the door to the water source, close the door leading to the farm, and open the door between the [[farm]] and filling chamber. The water should spread out and coat the entire farm in a thin layer of water. At this time, plant your farms and begin the wait until they yield products.

== Pond Irrigation ==

Dig a ramp down from a tunnel, preferably near a well or other water source, and dig a farm room next to the ramp on the lower level. Create a [[zone]] above the ramp, and make it a pond. Your dwarves will attempt to fill it with water carried in buckets. As they dump water in, it will muddy the farm room floor. After it has been sufficiently muddied, disable or remove the pond zone until you need to irrigate it again. Dwarves can build farm plots in 1 unit deep water.

NOTE: Even though it works, this is probably the slowest way to irrigate a room since dwarves only carry 1 unit of water per trip. It's especially slow if you don't have more than one or two idle dwarves and buckets, or if the water source is far away. It also probably wouldn't work very well on larger farm areas. It works great with constructed staircases for creating outdoor farm plots where there's an occasional stone in the ground though.

NOTE: Digging a ramp or channel down from the surface will mark the tile below Outside. This means that cave plants will not grow there.

== Pump Irrigation ==

If you have access to [[wood]], [[stone]] floors can be irrigated conveniently from a water source on the level below, by use of a [[screw pump]]. Simply dig a channel to access the water on z-1, install a [[Screw Pump]] and set to Start Pump Manually ({{k|Enter}}). Any dwarf with the 'Pump Operating' duty active will quickly pump enough water to irrigate a large area (so rapidly that irrigating other rooms becomes a concern!). This can be improved by installing a second pump to draw water out of the room, allowing you to rapidly drain the room in the event of over-filling.

== Wave Irrigation ==

Although seawater is unfit for carrying to your farm in a bucket, areas muddied by seawater seem to be farmable. My favorite method of achieving this is building a farm room under a beach and making a hole in its roof, closable with a hatch, to let waves in. Also pumping water seems to desalinate it, so pumping it to your farming room seems to work fine.

== Outdoor Irrigation ==

As of v0.28.181.40d, outdoor irrigation doesn't quite work. You can turn outdoor rock into mud, and you can build a farm plot on it, but the resulting plot won't allow ''any'' seeds to be planted in it. The specific message is "No seeds available for this location". An "outdoor" plot can be built on indoor soil by opening up the ceiling, and optionally flooring it over again, but this won't work on indoor mud.

== De-Irrigation ==

On soil, building a wall and then removing it results in furrowed soil. However, on mud, the process results in rough but dry rock. This may be a bug in v0.28.181.40d, however.

=== Further Testing ===

The type of rock is changed(at least in v0.28.181.40d) - perhaps to that of the rock wall below? What if there is no rock wall below?

[[Category:Agriculture]]

40d:Advanced world generation

2009-04-09T04:13:13Z

Darekun: /* Maximum Natural Cave Size */ Explained based on experiment.

[[World generation]] allows advanced options for customizing worlds. These parameters are not all well understood, so please contribute here as you experiment. [http://www.bay12games.com/forum/index.php?topic=20512.0 This forum post] has additional information on the parameters.

= Advanced Parameters =

To access advanced parameters, press 'e' when at the screen for creating new worlds with parameters screen. This will bring you to an editable list of various guidelines the world-gen process will use when creating your new world.

Parameter sets are stored in ''world_gen.txt'' in the ''\data\init'' folder, using [[world tokens]]. You can copy and paste other player's sets of parameters into your ''world_gen.txt'' to use their parameter sets, and some are provided at [[Pregenerated worlds]]. Another place to find parameter sets is the [http://www.bay12games.com/forum/index.php?topic=20638.0 Worldgen cookbook] thread on the official forums.

== Seed Parameters ==

==== Use Seed ====
This determines the seed number that will be used by the random-number generator in determining the randomness factors that go into creating your world.

==== Use History Seed ====
Same as above but instead of determining terrain and world structure it handles historical figures and event outcomes. Some experimenting will need to be done to see if the same seed and a different World seed produce different events and figures.

==== Use Name Seed ====
Same as above but used to determine the randomly selected name used by the program.

== Terrain Parameters ==

==== Minimum Savagery/Maximum Savagery ====
Defines the minimum and maximum savagery per tile.
* 0 - 32: Benign
*33 - 65: Neutral
*66 - 100: Savage

Humans and Dwarves will not settle in savage areas.

==== Minimum Volcanism/Maximum Volcanism ====

From what I have found out so far I can say [[Igneous extrusive layer]] are only found in areas with a volcanism higher than 90. Volcanoes are only placed on tiles with a volcanism of 100.

==== Minimum Volcano Number ====

Places volcanoes on tiles with a volcanism of 100. If there are not enough viable tiles the world is rejected.

==== Minimum Mountain Peak Number ====

Places mountain peaks on tiles with an pre-erosion elevation of at least 380. If there are not enough viable tiles the world is rejected.

I'm not exactly sure what effect the peaks have but I suppose they withstand erosion better.

==== Erosion Cycle Count ====

Higher numbers make the mountains less steep and river canyons deeper.

== Historical Parameters ==

==== End Year ====

Used to determine when the program will cease its generation and allow for play. As of right now other factors prevent the generator from getting to this date and is often cut off long before reaching it.

==== Population Cap after Civ Creation ====

How many creatures can exist in the game once civilizations have been added into generation.

==== Percentage Beasts Dead for Stoppage ====

Determines how many megabeasts need to be dead before the world gen stops creating history. Is one likely cause for why the generator rarely reaches the entered End Date.

==== Year to Begin Checking Megabeast Percentage ====

Determines when the game begins checking for the above precentage to see when the game should stop generating the world.

==== Cull Unimportant Historical Figures ====

Instead of listing every event that happens, this option removes those events without related importance to the wider world, effectively reducing the number of events reviewable in the legends screen.

==== Reveal All Historical Events ====

Determines whether all events are open to review in the legends screen when you choose to begin a game. Setting this to no would require the usual exploration, talking, and engraving searching as before.

== Creature Parameters ==

==== Maximum Natural Cave Size ====

Determines the size and depth of caves formed by world-gen. A cave with a greater "size" will be deeper and more sprawling, and therefore have more and more dangerous creatures.

==== Number of Mountain Caves ====

Determines the number of caves to be placed in mountain regions.

==== Number of Non-Mountain Caves ====

Determines the number of caves to be placed in other regions.

==== Make Caves Visible ====

Makes caves visible on the world location selection screen.

==== Number of Civilizations ====

Determines how many civilizations will be seeded into the generated world. Five is the typical number to produce the usual Dwarves, Humans, Elves, Goblins, and Kobolds.

* Error Code: Not enough entity placement locations: Decrease the Number of Civilizations, edit the settings so proper biomes are generated or generate bigger map.

==== Playable Civilization Required ====

If set, all worlds where the no playable civilization has been placed at the beginning of history are rejected.

* Error Code: No controllable entity definitions available: Add some high (mountain) elevations to the map. Dwarf civ's will only appear on these tiles.

= Experimenting with Parameters =

To experiment with the parameters and to effectively see why rejections are coming back because of changes to the parameters, first you need to edit your init.txt and set
[LOG_MAP_REJECTS:NO] to YES. This will create a text document that will describe why each copy of the generated world is rejected.

By going back and forth between this document and the parameters, you can begin to get an idea as to why endless cycles of rejected worlds come up. As you experiment please share your findings under each heading.

== World Painter Parameters ==

When using the world painter tool the following parameters produce these regions: 
- low mountain - elevation > 299 {{Biome|∆|∆|#808080|#808080}}
- mountain - elevation > 332 {{Biome|▲|▲|#808080|#808080}}
- high mountain - elevation >365 {{Biome|▲|▲|#C0C0C0|#C0C0C0}}
- peak - elevation = 400 {{Raw Tile|^|#808080|#000000}} (verify?)

The rest of the regions can be obtained mostly through choice of rain and drainage values. 
For rain 0-9 and: 
drain 0-32 - sand desert {{Biome|~|≈|#FFFF00|#FFFF00}}
drain 33-49 - rock desert {{Biome|,|´|#808000|#808080}}
drain 50-65 - badlands {{Biome|n|∩|#808080|#808000}}
drain 66-100 - badlands {{Biome|V|√|#808000|#808000}}

For rain 10-19: 
drain 0-49 - grassland {{Biome|.|ⁿ|#00FF00|#00FF00}}
drain 50-100 - hills {{Biome|n|∩|#00FF00|#00FF00}}

For rain 20-32: 
drain 0-49 - savanna {{Biome|"|ⁿ|#00FF00|#00FF00}}
drain 50-100 - hills {{Biome|n|∩|#00FF00|#00FF00}}

For rain 33-65: 
drain 0-32 - marsh {{Biome|"|"|#008000|#008000}}
drain 33-49 - shrubland {{Biome|"|γ|#00FF00|#00FF00}}
drain 50-100 - hills {{Biome|n|∩|#00FF00|#00FF00}}

For rain 66-100: 
drain 0-32 - swamp {{Biome|⌠|⌠|#008000|#008000}}
drain 33-100 - forest {{Biome|↑|↨|#00FF00|#00FF00}}

The forest regions can be changed between conifer, to broadleaf types by varying the temperature (to around > 65, depending on rain value).

The magma value (at 100%) can produce volcanoes if painted on the same tile as a mountain.

[[Category:World]]
[[Category:Guides]]

40d:Creature token

2009-04-08T01:32:34Z

Darekun: /* S */ Added [SPHERE]'s parameter.

Everything here can be applied to all creature files, e.g. creature_domestic, creature_standard, even creature_equipment.

Since the game is in the Alpha stage, consider everything '''tentative'''.

{| id="toc"
|
* Tokens
** [[#A|A]] [[#B|B]] [[#C|C]] [[#D|D]] [[#E|E]] [[#F|F]] [[#G|G]] [[#H|H]] [[#I|I]] [[#J|J]] [[#K|K]] [[#L|L]] [[#M|M]]
** [[#N|N]] [[#O|O]] [[#P|P]] [[#Q|Q]] [[#R|R]] [[#S|S]] [[#T|T]] [[#U|U]] [[#V|V]] [[#W|W]] [[#X|X]] [[#Y|Y]] [[#Z|Z]]
|}
__NOTOC__

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

|-
| ADD_VERSION
| version
| In which version of the game said creature was introduced. Not used anymore in the 3D version.
[ADD_VERSION:1069]

|-
| 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/MATUTINAL, rather than implying them.

|-
| ALTTILE
| [[Character Table|CP437 ordinal]] or 'character'
| If set, the creature will blink between its [TILE] and its [ALTTILE].
[ALTTILE:157] or [ALTTILE:'&']

|-
| AMBUSHPREDATOR
|
| Makes the creature start out hidden. Used by giant cave spiders. May make webs hidden too?

|-
| AMPHIBIOUS
|
| Allows a creature to breathe with or without water.

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

|-
| ATTACK
|
| See the [[#Attacks|Attacks section]].

|}

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

|-
| BABY
| age
| Age at which a baby becomes a child. Without this tag, all creatures born will skip the baby stage and be children upon birth.
[BABY:1]

|-
| BEACH_FREQUENCY
| value
| Whales and jellyfish have this. Controls the beaching frequency of the creature.
[BEACH_FREQUENCY:10]

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

|-
| BIOME:*
|
| See [[Biome Tokens|biome tokens]].

|-
| BLOODTYPE
| type
| Sets the creatures' blood type (default red):
*R - Red blood
*G - Green blood
*B - Blue blood
*M - Magenta blood
*C - Cyan blood
*Y - Yellow pus
*W - White ichor
*0 - Black goo
*VOMIT
*SLIME
[BLOODTYPE:0]

|-
| [[Body_tokens|BODY]]
| parts[:...]
| Sets the body parts a creature has. Can supply as many as you want.
[BODY:HUMANOID:2EYES:2EARS]

|-
| [[Bodygloss|BODYGLOSS]]
| gloss
| A body_default.txt function. It replaces a part's description with another. e.g. feet with hooves.
[BODYGLOSS:HOOF]

|-
| BOILING_POINT
| temperature
| The temperature at which the creature boils into goo. [[Temperature scale|DF temperature scale]]

|-
| BONE_BOILING_POINT
| temperature
| The boiling point of the creature's bones.

|-
| BONE_COLDDAM_POINT
| temperature
| The low temperature at which the creature's bones start getting damaged.

|-
| BONE_FIXED_TEMP
| temperature
| The temperature that the creature's bones give off.

|-
| BONE_HEATDAM_POINT
| temperature
| The high temperature where the bones start taking damage.

|-
| BONE_IGNITE_POINT
| temperature
| The temperature at which point the creature's bones burst into flame.

|-
| BONE_MELTING_POINT
| temperature
| The temperature at which the creature's bones melt.

|-
| [[Creature_Tokens/SPEC_HEAT|BONE_SPEC_HEAT]]
| not a temperature
| Specific heat? (temperature difference required to change the temperature of the creature's bones?) {{verify}}

|-
| BONECARN
|
| Creature 'eats' bones. Eating bones makes their happiness go up, but can cause death (suffocation). This tag implies CARNIVORE.

|-
| BUILDINGDESTROYER
| value
| Allows a creature to destroy furniture and buildings. Creatures with BUILDINGDESTROYER will actively seek out your constructions and destroy them. A creature can have this value at 1 or 2. When the value is 1, the creature will go after wooden hatches, wooden doors, supports, statues, windows and archery targets only. They can't destroy homes during world gen as (semi)megabeasts.
When the value is 2 the creature will actively seek out most (all?) constructions and destroy them. They can also destroy buildings during world-gen with this tag. Megabeasts rely on this token for their pathing when attacking your fort.
[BUILDINGDESTROYER:2]

|-
| BUTCHERABLE_NONSTANDARD
|
| (old) If a creature has this tag, it may only be slaughtered (that is, the live creature is taken to the [[Butcher's Shop]] and slain). If it dies of any other cause, the corpse cannot be butchered.

|}

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

|-
| CAN_CIV
|
| Can create civilizations. This tag may activate hunger and thirst. {{verify}}

|-
| CAN_LEARN
|
| A creature with this tag can gain skill experience.

|-
| CAN_SPEAK
|
| Can talk.

|-
| CANNOT_UNDEAD
|
| Cannot become undead.

|-
| CARNIVORE
|
| Creature only eats meat.

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

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

|-
| CHEESE_BOILING_POINT
| temperature
| The temperature at which the creature's cheese (if any) boils away.

|-
| CHEESE_COLDDAM_POINT
| temperature
| The temperature at which the creature's cheese (if any) starts taking cold damage.

|-
| CHEESE_FIXED_TEMP
| temperature
| The temperature emitted by one unit of the creature's cheese (if any).

|-
| CHEESE_HEATDAM_POINT
| temperature
| The temperature at which the cheese made from the creature's milk starts taking heat damage.

|-
| CHEESE_IGNITE_POINT
| temperature
| The temperature at which the creature's cheese bursts into flame.

|-
| CHEESE_MELTING_POINT
| temperature
| The temperature at which the creature's cheese melts into goo.

|-
| [[Creature_Tokens/SPEC_HEAT|CHEESE_SPEC_HEAT]]
| not a temperature
| Specific heat? (temperature difference required to change the temperature of the creature's cheese?) {{verify}}

|-
| CHEESE_VALUE
| value
| The value per unit of cheese made from the creature's milk (if applicable). Note that only vermin as of current can be milked.

|-
| CHILD
| age
| Age at which a child becomes an adult.
[CHILD:12]

|-
| CHILDNAME
|
* singular
* plural
| Gives the child a special name, eg "hippo calf" instead of "hippo child".
[CHILDNAME:hippo calf:hippo calves]

|-
| CHITIN
|
| When the creature is butchered, it drops chitin, which functions as leather.

|-
| CRAFTSMAN_NAME
|
* singular
* plural
| Sets the name of the craftsman profession.
[CRAFTSMAN_NAME:craftsdwarf:craftsdwarves]

|-
| CREPUSCULAR
|
| Sets if the creature is active in twilight.

|-
| CLUSTER_NUMBER
|
* minimum
* maximum
| The minimum/maximum numbers of how many creatures per spawned cluster.
[CLUSTER_NUMBER:1:3]

|-
| COLOR
|
* fg (foreground)
* bg (background)
* br (brightness)
| [[Color]] of the creature's tile.
[COLOR:3:0:0]

|-
| COOKABLE_LIVE
|
| Set this to allow the creature to be cooked in meals without having to butcher it first.

|-
| CREATURE
| name
| What the game looks for when generating creatures.
[CREATURE:DWARF]

|-
| COLDDAM_POINT
| temperature
| The minimum temperature limit before the creature starts taking damage from freezing.

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

|-
| CURIOUSBEAST_EATER
|
| Allows a creature to eat edible items that it finds? (may imply CURIOUSBEAST_ITEM?) {{verify}}

|-
| CURIOUSBEAST_ITEM
|
| Allows a creature to steal things (usually [[food]]?).

|-
| CURIOUSBEAST_GUZZLER
|
| Will steal [[alcohol]]? Implies CURIOUSBEAST.

|}

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

|-
| DAMBLOCK
| value
| How much natural armor a creature has. Can be set to negative numbers, so the creature takes more damage than usual.
[DAMBLOCK:1]

|-
| DEFENDER
|
| Appears from the glowing pits in a group.

|-
| DIFFICULTY
| number
| [[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.
[DIFFICULTY:2]

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

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

|-
| DRINK_BOILING_POINT
| temperature
| The temperature at which a drink (milk?) produced from the creature will boil.

|-
| DRINK_COLDDAM_POINT
| temperature
| The temperature at which said drink will take cold damage.

|-
| DRINK_FIXED_TEMP
| temperature
| The temperature emitted by one unit of the creature's drink (if any).

|-
| DRINK_HEATDAM_POINT
| temperature
| The temperature at which aforementioned drink will take heat damage.

|-
| DRINK_IGNITE_POINT
| temperature
| The temperature at which the drink will set your fort ablaze.

|-
| DRINK_MELTING_POINT
| temperature
| [[User:GreyMario]] sez: "Isn't this, like, redundant? It's ''already'' liquid. Perhaps it controls at which point the drink solidifies?" {{verify}}

|-
| [[Creature_Tokens/SPEC_HEAT|DRINK_SPEC_HEAT]]
| not a temperature
| The difference in temperature required to modify the temperature of the drink? {{verify}}

|}

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

|-
| ENDING
|
| Will show up as a leader (only one of them) in a group from the glowing pits.

|-
| EQUIPMENT_WAGON
|
| Implies two unknown flags, NOSTUN, NONAUSEA, NOBLEED, NOEMOTION, NOSTUCKINS, SEVERONBREAKS, NOSKULL, NOSKIN, NOBONES, NOMEAT, PARALYZEIMMUNE, NOFEAR, NOSMELLYROT, NOTHOUGHT, NO_GENDER.

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

|-
| EVIL
|
| Determines whether creature can show up on "evil" maps (see [[Creatures#Threat Matrix|Threat Matrix]]).

|-
| EXTRACT
|
* name
* value
* ? (always 0)
* ? (0 on venoms exception: giant desert scorpion venom)
| Determines what can be extracted from the creature, what it's called, how valuable it is, and what you can make from it. Note, it appears that the extraction process is hardcoded into the game, and can't be altered from objects/raw.
[EXTRACT:cow's milk:7:0:1]

|-
| EXTRACT_ANTIDOTE
|
* name
* value
* ? (always 0)
* ? (always 0)
* ? (always 50 or 100)
| [EXTRACT_ANTIDOTE:cave spider antivenin:7:0:0:50]

|-
| EXTRACT_BOILING_POINT
| temperature
| The temperature value at which a unit of the creature's extract boils away.

|-
| EXTRACT_CHEESE
|
* name
* value
* ?
* ?
| The extract gotten from the creature is a unit of cheese.
[EXTRACT_CHEESE:cow cheese:6:0:1]

|-
| EXTRACT_COOKABLE
|
| Extract is cookable.

|-
| EXTRACT_COLDDAM_POINT
| temperature
| The low temperature value at which the creature's extract starts to take damage.

|-
| EXTRACT_FIXED_TEMP
| temperature
| The temperature that the creature's extract generates on its own.

|-
| EXTRACT_HEATDAM_POINT
| temperature
| The high temperature value at which the creature's extract starts to take damage.

|-
| EXTRACT_IGNITE_POINT
| temperature
| The temperature at which the creature's extract bursts into flame (NOT the container it's in).

|-
| EXTRACT_MELTING_POINT
| temperature
| The temperature at which the creature's extract melts into goo.

|-
| EXTRACT_PARALYZE
|
| (conjectural) Extract is poisonous, causing paralysis that lasts until the extract wears off. Can be delivered by SPECIALATTACK_INJECT_EXTRACT.

|-
| EXTRACT_PARALYZE_INTERMITTENT
|
| (conjectural) Extract is poisonous, causing paralysis on occasional intervals until the extract wears off. Can be delivered by SPECIALATTACK_INJECT_EXTRACT.

|-
| EXTRACT_PERMANENT
|
| (conjectural) The effects of the creature's extract are permanent once applied and do not wear off naturally.

|-
| EXTRACT_SIZE
| size
|
[EXTRACT_SIZE:10]

|-
| [[Creature_Tokens/SPEC_HEAT|EXTRACT_SPEC_HEAT]]
| not a temperature
| The difference in temperature required to modify the temperature of the creature's extract? {{verify}}

|-
| EXTRACT_STUN
|
| (conjectural) Extract is poisonous, causing a permanent stun effect until the extract wears off. Can be delivered by SPECIALATTACK_INJECT_EXTRACT.

|-
| EXTRACT_STUN_INTERMITTENT
|
| (verified) Extract is poisonous, causing temporary stuns on semi-occasional intervals. Can be delivered by SPECIALATTACK_INJECT_EXTRACT.

|-
| EXTRACT_VALUE
| value
| The value per unit of the creature's extract.
[EXTRACT_VALUE:20]

|-
| EXTRAVISION
|
| Creature has enhanced vision (longer vision range, ie. at night).

|}

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

|-
| FAT
| value
| How much fat a creature produces when it is butchered.
[FAT:3]

|-
| FEMALE
|
| The creature is always female.

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

|-
| FIREIMMUNE
|
| The creature is immune to all forms of fire, except DRAGONFIREBREATH.

|-
| FIREIMMUNE_SUPER
|
| The creature is immune to DRAGONFIREBREATH. AI acts as if FIREIMMUNE. Does NOT imply FIREIMMUNE.

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

|-
| FIXED_TEMP
| temperature
| The natural heat generated by the creature. [FIXED_TEMP:1-?]

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

|-
| FLIER
|
| Allows a creature to fly. Currently, an AI bug prevents this from being useful on PC races in fortress mode.

|-
| FREQUENCY
| time
| Determines the time between creature spawns in Fortress Mode. Higher is more occurences per time unit{{verify}}. Creatures without a frequency statement appear to be on the map at all times. Almost all others have either [FREQUENCY:5] or [FREQUENCY:100].
[FREQUENCY:42]

|}

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

|-
| GENPOWER
| rate?
| Not used anymore and can be removed safely. Was related to magic.
[GENPOWER:3]

|-
| GLOWCOLOR
|
* fg
* bg
* br
| The colour of the GLOWTILE of the creature (see below).

[GLOWCOLOR:4:0:1]

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

[GLOWTILE:'"']

|-
| GNAWER
|
| The creature chews on food storage containers.

|-
| GOOD
|
| Determines whether creature can show up on "good" maps (see [[Creatures#Threat Matrix|Threat Matrix]]).

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

|}

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

|-
| HAS_RACEGLOSS
| gloss
| Links a material glossary to the creature. It is hardcoded, and there is only 4 types of tag.
[HAS_RACEGLOSS:WOOD]
[HAS_RACEGLOSS:STONE]
[HAS_RACEGLOSS:METAL]
[HAS_RACEGLOSS:PLANT]

|-
| HASSHELL
|
| Creature will leave behind a shell when eaten.

|-
| HEATDAM_POINT
| temperature
| The maximum temperature limit before the creature will start recieving damage from heat. [[Temperature scale|DF temperature scale]]

|-
| HOMEOTHERM
| value
| Default 'NONE'. The creature's normal body temperature. Combined with LAYERING, sets the temperature range under which it can live. [[Temperature scale|DF temperature scale]]

|-
| HORN
|
| Creature drops a horn or horns when butchered, which presumably acts like bone. This tag is broken.

|}

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

|-
| IGNITE_POINT
| temperature
| The temperature at which the creature will burst into flames. [[Temperature scale|DF temperature scale]]

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

|-
| IMMOBILE_LAND
|
| The creature is immobile while on land

|-
| INTELLIGENT
|
| Implies CAN_CIV, CAN_SPEAK, CAN_LEARN.

|-
| ITEMCORPSE
|
* [[Item Tokens|item token]]
* subtype
NO_SUBTYPE
* [[Matgloss_tokens|matgloss token]]
* NO_RACEGLOSS
USE_RACEGLOSS
USE_SHARPSTONE
| Determines if the creature leaves behind a non-standard corpse (i.e. wood, statue, bars, etc). The first parameter determines the item type; the second parameter is the subtype indicated in the raw file (such as WEAPON_WHIP); the third indicates the material type if the item type takes a specific material (e.g. "IRON" if the corpse type is "STATUE"). USE_RACEGLOSS applies if the creature has a material glossary assigned by the "HAS_RACEGLOSS:" flag and will select neccesary adjectives and material from that glossary.
[ITEMCORPSE:[[Item Tokens|WOOD]]:NO_SUBTYPE:[[Material Tokens|WOOD]]:USE_RACEGLOSS]

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

|-
| IVORY
|
| Creature will produce ivory when butchered. Currently doesn't work.

|}

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

|-
| LARGE_CAVERIVER
|
| In Fortress Mode, spawns from/near cave rivers.

|-
| LARGE_CHASM
|
| In Fortress Mode, spawns from/near chasms.

|-
| LARGE_LAVA
|
| In Fortress Mode, spawns from/near magma.

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

|-
| LAYERING
| value
| How well-protected the creature is from low temperatures. If this number is too high, it will confine a creature to only arctic areas. If it is even higher it will prevent the creature from spawning at all.

|-
| LEATHER_BOILING_POINT
| temperature
| The temperature at which leather made from the creature's skins will boil away.

|-
| LEATHER_COLDDAM_POINT
| temperature
| The temperature at which leather made from the creature's skins will take damage.

|-
| LEATHER_FIXED_TEMP
| temperature
| The temperature that leather made from the creature's skins generates.

|-
| LEATHER_HEATDAM_POINT
| temperature
| The temperature at which leather made from the creature's skins will take damage.

|-
| LEATHER_IGNITE_POINT
| temperature
| The temperature at which leather made from the creature's skins will burst into flames.

|-
| LEATHER_MELTING_POINT
| temperature
| The temperature at which leather made from the creature's skins will melt away.

|-
| [[Creature_Tokens/SPEC_HEAT|LEATHER_SPEC_HEAT]]
| not a temperature
| The difference in temperature required to modify the temperature of the creature's leather? {{verify}}

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

|-
| LIKES_FIGHTING
|
|

|-
| 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. Implies [TRAPAVOID]

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

|}

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

|-
| MAGICAL
|
| Allows a creature to use magic? However, magic isn't implemented yet.

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

|-
| MALE
|
| The creature is always male.

|-
| MATERIAL
|
* [[Matgloss_tokens|Matgloss token]]
* USE_RACEGLOSS
|

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

|-
| MAXAGE
|
* minimum
* maximum
| Sets the Min Max age for a creature. Used in world generating and Fortress Mode.
[MAXAGE:150:170]

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

|-
| MEGABEAST
|
| Appears on fortress territory in Fortress Mode occasionally. Implies SEMIMEGABEAST.

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

|-
| MILKABLE
| frequency?
| Allows the creature to be milked. Currently only works with vermin creatures.

|-
| MISCHIEVIOUS
|
| Will pull any levers it comes across. (requires confirmation)

|-
| MODVALUE
| number
| Multiplies the value of items made from the creature by the number in the tag.
[MODVALUE:2]

|-
| MOUNT
|
| Allows the creature to be mounted.

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

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

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

|}

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

|-
| NAME
|
* singular noun
* plural noun
* adjective
| What the creature is actually called in game. Make sure there is no space around the ":".
[NAME:dwarf:dwarves:dwarven]

|-
| NARROW
|
| The creature can only wear things that have the narrow tag on it.

|-
| NATURAL
|
| Animal

|-
| NO_AUTUMN
|
| Will not show up during the Autumn season.

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

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

|-
| NO_GENDER
|
| No gender will be selected for the creature.

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

|-
| NO_SPRING
|
| Will not show up during the Spring season.

|-
| NO_SUMMER
|
| Will not show up during the Summer season.

|-
| NO_WINTER
|
| Will not show up during the Winter season.

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

|-
| NOBLEED
|
| Creature doesn't bleed.

|-
| NOBONES
|
| Creature will not drop bones on butcher, rot, or decay of severed body parts.

|-
| 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
|
| Creatures' corpse does not create miasma.

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

|-
| NOSTUN
|
| Creature can't be stunned.

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

|-
| NOT_BUTCHERABLE
|
| Creature can't be butchered.

|}

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

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

|-
| PATTERNFLIER
|
| Flies in a semi-predictable pattern? {{verify}}

|-
| 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 greater than the penetrate power, their contents escape for the time being. Other objects roll a 0-99.

|-
| PERSONALITY
|
* token
* lowest % chance
* median
* highest % chance
| Determines chance of personality traits. Standard is 0:50:100. See [[Personality traits]] for more info.
[PERSONALITY:IMAGINATION:0:55:100]

|-
| 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:42]

|-
| POPULATION_NUMBER
|
* minimum
* maximum
| The minimum/maximum numbers of how many of these creatures can show up on a map per year.
[POPULATION_NUMBER:42:42]

|-
| POWER
|
| Allows the creature to be worshiped by entities with the RELIGION:ANY_APPROPRIATE_POWER tag.

|-
| PREFSTRING
| object
| Sets what other creatures like about this creature. "Blarghh likes dwarves for their beards."
[PREFSTRING:beards]
Multiple entries will be chosen from at random.

|}

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

|-
| REMAINS
| <''singular''>:<''plural''>
| ??? Used by treants along with [REMAINS_UNDETERMINED], appears to change the name of a creatures remains.

|-
| REMAINS_COLOR
|
* fg
* bg
* br
| The color of the creature's remains. Used by treants.

[REMAINS_COLOR:6:0:0]
|-
| REMAINS_UNDETERMINED
|
|

|}

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

|-
| SAVAGE
|
| Determines whether creature can show up on "savage" maps.

|-
| SEMIMEGABEAST
|
| Appears as boss creature in quests.

|-
| SESSILE_LAND
|
| Obsolete. Use [[#I|[IMMOBILE_LAND]]].

|-
| SEVERONBREAKS
|
| Limbs and body parts sever on breakage.

|-
| SILK_BOILING_POINT
| temperature
| Temperature at which silk made from this creature's webs boils away.

|-
| SILK_COLDDAM_POINT
| temperature
| Temperature at which silk made from this creature's webs takes damage.

|-
| SILK_FIXED_TEMP
| temperature
| Temperature generated by the creature's web silk.

|-
| SILK_HEATDAM_POINT
| temperature
| Temperature at which silk made from this creature's webs takes damage.

|-
| SILK_IGNITE_POINT
| temperature
| Temperature at which silk made from this creature's webs bursts into flame.

|-
| SILK_MELTING_POINT
| temperature
| Temperature at which silk made from this creature's webs melts away.

|-
| [[Creature_Tokens/SPEC_HEAT|SILK_SPEC_HEAT]]
| not a temperature
| The difference in temperature required to modify the temperature of the creature's silk? {{verify}}

|-
| SIZE
| value
| How big a creature is. 6 is for dwarf like creatures, 7 is for human like creatures. 16 is for giants. Larger creatures are far more dangerous in combat. Also equals the amount of Meat/Chunks/Bones you get from the beast.
[SIZE:6]

|-
| SLOW_LEARNER
|
| Presumably similar to [CAN_LEARN], but slower. Present in the entries for ogres and giants

|-
| SMALLAQUATIC_CAVERIVER
|
|

|-
| SMALLAQUATIC_OCEAN
|
|

|-
| SMALLAQUATIC_RIVER
|
|

|-
| SMALLAQUATIC_SWAMP
|
|

|-
| SMALL_REMAINS
|
| If a creature has this token, it'll leave a small corpse that only rots once, such as vermin.

|-
| SPECNAME
|
*token
*singular noun
*plural noun
*adjective
| Sets a special name for certain instances.
[SPECNAME:MALE:bull:bulls:bull]

|-
| [[Creature_Tokens/SPEC_HEAT|SPEC_HEAT]]
| not a temperature
| The specific heat of a creature? {{verify}}
[SPEC_HEAT:409]

|-
| SPEECH
| filename
| Sets what speech.txt to use for the creature.
[SPEECH:dwarf.txt]

|-
| SPEECH_MALE
| filename
| Used in place of [SPEECH] for humans; perhaps sets the speech.txt to use for males only? Humans don't have a corresponding [SPEECH_FEMALE] token, though, which only occurs in the [[string dump]].
[SPEECH_MALE:human_male.txt]

|-
| SPEED
| value
| Sets the creatures' movement and work speed, 1000/[100 + SPEED X] is the resulting effect on creatures movement and workrates from default. See [[Speed]] for more information.
[SPEED:400]

|-
| SPHERE
| [[sphere]]
| Sets what religious spheres the creature is aligned to, for purposes of being worshiped via the [POWER] token. By default, only used by [[Demon|hidden fun stuff]].

|-
| STOUT
|
| Creature has a resistance to being knocked over.

|-
| STANDARD_FLESH
|
|

|-
| 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 must learn to swim. Requires [CAN_LEARN], obviously.

|-
| SWIM_SPEED
| value
| How fast the creature swims.

|}

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

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

|-
| TILE
| CP437 ordinal or 'character'
| The graphical representation of the creature.
[TILE:157] or [TILE:'&']

|-
| TRADE_CAPACITY
| weight
| How much the creature can carry when used by merchants.
[TRADE_CAPACITY:2000]

|-
| TRAINABLE
|
| Allows a tame creature to be trained into a "War" or "Hunting" variation by way of [[Kennels]].

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

|-
| TRAPAVOID
|
| The creature is immune to traps.

|-
| TRIGGERABLE_GROUP
|
* minimum?
* maximum?
| [TRIGGERABLE_GROUP:5:50]

|}

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

|-
| UNDERSWIM
|
| Creature swims under the water and can't be seen.
|-
| UTTERANCES
|
| Changes the language of the creature into an unintelligible mess.

|}

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

|-
| VEGETATION
|
|

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

|-
| VERMIN_BITE
|
* amount injected?
* name
* effect (USE_EXTRACT)
| [VERMIN_BITE:10:bitten:USE_EXTRACT]
On very rare occasions, someone who remains in the same tile as this creature will be bitten by that creature, and the effect will be applied to the offender. Used by (tiny) cave spiders to inject their venom into the occasional dwarf.

|-
| VERMIN_EATER
|
| The creature can eat your food.

|-
| 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. – [[User:Peristarkawan|Peristarkawan]] 17:27, 24 May 2007 (EDT)

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

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

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

|-
| VERMIN_NOTRAP
|
| The creature cannot be caught by trappers or animal traps.

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

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

|-
| VIEWRANGE
| value
| How far the creature can see?

|}

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

|-
| WAGON_PULLER
|
| Allows the creature to pull caravan wagons.

|-
| WEBBER
|
| The creature will create webs. It also seems to make creatures flying. More testing is needed.

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

|}

=Attacks=
{| {{prettytable}}
|- bgcolor="#ddd"
!width="50"|Tag
!width="225"|What It Does

|-
|[ATTACK:MAIN:BYTYPE:GRASP:punch:punches:1:2:BLUDGEON][ATTACKFLAG_WITH]

''Format:''
[ATTACK:''priority'':(BYTYPE:''type'' || BYTOKEN:''bodypart''):''"verb"'':''"conjugate verb"'':''min dmg'':''max dmg'':''dmg type'']([(ATTACKFLAG_WITH || ATTACKFLAG_CANLATCH)])([SPECIALATTACK_INJECT_EXTRACT:''min'':''max''])
|Sets what natural attacks a creature has.

|-
|MAIN
SECOND
|''MAIN'': Sets the attack to act as the creatures' main attack.
''SECOND'': The creature will only use this attack if it can't use the MAIN attack(s).

|-
|BYTYPE:GRASP
BYTOKEN:TAIL_STINGER
|''BYTYPE'': Sets what body part type to use for the attack. Possible values for "type" are GRASP, MOUTH, STANCE, THOUGHT, BREATHE, and the like. See [[Body Tokens]].
''BYTOKEN'': Sets the explicit body part ID to use for the attack. The token must exist as part of the creature's [[Creature Tokens#B|BODY]] token.

|-
|punch:punches
|Sets the verb for the attack.

|-
|1:2
|Sets the Min Max for the damage.

|-
|BLUDGEON, PIERCE, SLASH, GORE, BURN, HEAT, COLD
|Sets the damage type for the attack.

|-
|[ATTACKFLAG_WITH]
|Attacks in combat inform which body part was used in the attack.
"Ratman punches Blargg with his right hand."

|-
|[ATTACKFLAG_CANLATCH]
|Allows the creature to latch on with the attack. "Crocodile latches on Blargg's head firmly."

|-
|[SPECIALATTACK_INJECT_EXTRACT:50:100]
|The creature injects an amount of its extract into a victim upon successfully using this attack. The significance of the amount is unknown (but probably determines duration before the extract wears off).

|-
|[SPECIALATTACK_SUCK_BLOOD:50:100]
|When blood is drained from a creature, it causes heavy bleeding (depending on the attacking creatures ability to suck blood). It's unknown if blood suckers feed or regain health while doing this. (Numbers affect amount of blood drawn?)
|}

[[Category:Modding]]
[[Category:Tokens]]

40d:Creature token

2009-04-08T01:31:41Z

Darekun: /* F */ Corrected [FREQUENCY].

Everything here can be applied to all creature files, e.g. creature_domestic, creature_standard, even creature_equipment.

Since the game is in the Alpha stage, consider everything '''tentative'''.

{| id="toc"
|
* Tokens
** [[#A|A]] [[#B|B]] [[#C|C]] [[#D|D]] [[#E|E]] [[#F|F]] [[#G|G]] [[#H|H]] [[#I|I]] [[#J|J]] [[#K|K]] [[#L|L]] [[#M|M]]
** [[#N|N]] [[#O|O]] [[#P|P]] [[#Q|Q]] [[#R|R]] [[#S|S]] [[#T|T]] [[#U|U]] [[#V|V]] [[#W|W]] [[#X|X]] [[#Y|Y]] [[#Z|Z]]
|}
__NOTOC__

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

|-
| ADD_VERSION
| version
| In which version of the game said creature was introduced. Not used anymore in the 3D version.
[ADD_VERSION:1069]

|-
| 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/MATUTINAL, rather than implying them.

|-
| ALTTILE
| [[Character Table|CP437 ordinal]] or 'character'
| If set, the creature will blink between its [TILE] and its [ALTTILE].
[ALTTILE:157] or [ALTTILE:'&']

|-
| AMBUSHPREDATOR
|
| Makes the creature start out hidden. Used by giant cave spiders. May make webs hidden too?

|-
| AMPHIBIOUS
|
| Allows a creature to breathe with or without water.

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

|-
| ATTACK
|
| See the [[#Attacks|Attacks section]].

|}

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

|-
| BABY
| age
| Age at which a baby becomes a child. Without this tag, all creatures born will skip the baby stage and be children upon birth.
[BABY:1]

|-
| BEACH_FREQUENCY
| value
| Whales and jellyfish have this. Controls the beaching frequency of the creature.
[BEACH_FREQUENCY:10]

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

|-
| BIOME:*
|
| See [[Biome Tokens|biome tokens]].

|-
| BLOODTYPE
| type
| Sets the creatures' blood type (default red):
*R - Red blood
*G - Green blood
*B - Blue blood
*M - Magenta blood
*C - Cyan blood
*Y - Yellow pus
*W - White ichor
*0 - Black goo
*VOMIT
*SLIME
[BLOODTYPE:0]

|-
| [[Body_tokens|BODY]]
| parts[:...]
| Sets the body parts a creature has. Can supply as many as you want.
[BODY:HUMANOID:2EYES:2EARS]

|-
| [[Bodygloss|BODYGLOSS]]
| gloss
| A body_default.txt function. It replaces a part's description with another. e.g. feet with hooves.
[BODYGLOSS:HOOF]

|-
| BOILING_POINT
| temperature
| The temperature at which the creature boils into goo. [[Temperature scale|DF temperature scale]]

|-
| BONE_BOILING_POINT
| temperature
| The boiling point of the creature's bones.

|-
| BONE_COLDDAM_POINT
| temperature
| The low temperature at which the creature's bones start getting damaged.

|-
| BONE_FIXED_TEMP
| temperature
| The temperature that the creature's bones give off.

|-
| BONE_HEATDAM_POINT
| temperature
| The high temperature where the bones start taking damage.

|-
| BONE_IGNITE_POINT
| temperature
| The temperature at which point the creature's bones burst into flame.

|-
| BONE_MELTING_POINT
| temperature
| The temperature at which the creature's bones melt.

|-
| [[Creature_Tokens/SPEC_HEAT|BONE_SPEC_HEAT]]
| not a temperature
| Specific heat? (temperature difference required to change the temperature of the creature's bones?) {{verify}}

|-
| BONECARN
|
| Creature 'eats' bones. Eating bones makes their happiness go up, but can cause death (suffocation). This tag implies CARNIVORE.

|-
| BUILDINGDESTROYER
| value
| Allows a creature to destroy furniture and buildings. Creatures with BUILDINGDESTROYER will actively seek out your constructions and destroy them. A creature can have this value at 1 or 2. When the value is 1, the creature will go after wooden hatches, wooden doors, supports, statues, windows and archery targets only. They can't destroy homes during world gen as (semi)megabeasts.
When the value is 2 the creature will actively seek out most (all?) constructions and destroy them. They can also destroy buildings during world-gen with this tag. Megabeasts rely on this token for their pathing when attacking your fort.
[BUILDINGDESTROYER:2]

|-
| BUTCHERABLE_NONSTANDARD
|
| (old) If a creature has this tag, it may only be slaughtered (that is, the live creature is taken to the [[Butcher's Shop]] and slain). If it dies of any other cause, the corpse cannot be butchered.

|}

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

|-
| CAN_CIV
|
| Can create civilizations. This tag may activate hunger and thirst. {{verify}}

|-
| CAN_LEARN
|
| A creature with this tag can gain skill experience.

|-
| CAN_SPEAK
|
| Can talk.

|-
| CANNOT_UNDEAD
|
| Cannot become undead.

|-
| CARNIVORE
|
| Creature only eats meat.

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

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

|-
| CHEESE_BOILING_POINT
| temperature
| The temperature at which the creature's cheese (if any) boils away.

|-
| CHEESE_COLDDAM_POINT
| temperature
| The temperature at which the creature's cheese (if any) starts taking cold damage.

|-
| CHEESE_FIXED_TEMP
| temperature
| The temperature emitted by one unit of the creature's cheese (if any).

|-
| CHEESE_HEATDAM_POINT
| temperature
| The temperature at which the cheese made from the creature's milk starts taking heat damage.

|-
| CHEESE_IGNITE_POINT
| temperature
| The temperature at which the creature's cheese bursts into flame.

|-
| CHEESE_MELTING_POINT
| temperature
| The temperature at which the creature's cheese melts into goo.

|-
| [[Creature_Tokens/SPEC_HEAT|CHEESE_SPEC_HEAT]]
| not a temperature
| Specific heat? (temperature difference required to change the temperature of the creature's cheese?) {{verify}}

|-
| CHEESE_VALUE
| value
| The value per unit of cheese made from the creature's milk (if applicable). Note that only vermin as of current can be milked.

|-
| CHILD
| age
| Age at which a child becomes an adult.
[CHILD:12]

|-
| CHILDNAME
|
* singular
* plural
| Gives the child a special name, eg "hippo calf" instead of "hippo child".
[CHILDNAME:hippo calf:hippo calves]

|-
| CHITIN
|
| When the creature is butchered, it drops chitin, which functions as leather.

|-
| CRAFTSMAN_NAME
|
* singular
* plural
| Sets the name of the craftsman profession.
[CRAFTSMAN_NAME:craftsdwarf:craftsdwarves]

|-
| CREPUSCULAR
|
| Sets if the creature is active in twilight.

|-
| CLUSTER_NUMBER
|
* minimum
* maximum
| The minimum/maximum numbers of how many creatures per spawned cluster.
[CLUSTER_NUMBER:1:3]

|-
| COLOR
|
* fg (foreground)
* bg (background)
* br (brightness)
| [[Color]] of the creature's tile.
[COLOR:3:0:0]

|-
| COOKABLE_LIVE
|
| Set this to allow the creature to be cooked in meals without having to butcher it first.

|-
| CREATURE
| name
| What the game looks for when generating creatures.
[CREATURE:DWARF]

|-
| COLDDAM_POINT
| temperature
| The minimum temperature limit before the creature starts taking damage from freezing.

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

|-
| CURIOUSBEAST_EATER
|
| Allows a creature to eat edible items that it finds? (may imply CURIOUSBEAST_ITEM?) {{verify}}

|-
| CURIOUSBEAST_ITEM
|
| Allows a creature to steal things (usually [[food]]?).

|-
| CURIOUSBEAST_GUZZLER
|
| Will steal [[alcohol]]? Implies CURIOUSBEAST.

|}

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

|-
| DAMBLOCK
| value
| How much natural armor a creature has. Can be set to negative numbers, so the creature takes more damage than usual.
[DAMBLOCK:1]

|-
| DEFENDER
|
| Appears from the glowing pits in a group.

|-
| DIFFICULTY
| number
| [[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.
[DIFFICULTY:2]

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

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

|-
| DRINK_BOILING_POINT
| temperature
| The temperature at which a drink (milk?) produced from the creature will boil.

|-
| DRINK_COLDDAM_POINT
| temperature
| The temperature at which said drink will take cold damage.

|-
| DRINK_FIXED_TEMP
| temperature
| The temperature emitted by one unit of the creature's drink (if any).

|-
| DRINK_HEATDAM_POINT
| temperature
| The temperature at which aforementioned drink will take heat damage.

|-
| DRINK_IGNITE_POINT
| temperature
| The temperature at which the drink will set your fort ablaze.

|-
| DRINK_MELTING_POINT
| temperature
| [[User:GreyMario]] sez: "Isn't this, like, redundant? It's ''already'' liquid. Perhaps it controls at which point the drink solidifies?" {{verify}}

|-
| [[Creature_Tokens/SPEC_HEAT|DRINK_SPEC_HEAT]]
| not a temperature
| The difference in temperature required to modify the temperature of the drink? {{verify}}

|}

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

|-
| ENDING
|
| Will show up as a leader (only one of them) in a group from the glowing pits.

|-
| EQUIPMENT_WAGON
|
| Implies two unknown flags, NOSTUN, NONAUSEA, NOBLEED, NOEMOTION, NOSTUCKINS, SEVERONBREAKS, NOSKULL, NOSKIN, NOBONES, NOMEAT, PARALYZEIMMUNE, NOFEAR, NOSMELLYROT, NOTHOUGHT, NO_GENDER.

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

|-
| EVIL
|
| Determines whether creature can show up on "evil" maps (see [[Creatures#Threat Matrix|Threat Matrix]]).

|-
| EXTRACT
|
* name
* value
* ? (always 0)
* ? (0 on venoms exception: giant desert scorpion venom)
| Determines what can be extracted from the creature, what it's called, how valuable it is, and what you can make from it. Note, it appears that the extraction process is hardcoded into the game, and can't be altered from objects/raw.
[EXTRACT:cow's milk:7:0:1]

|-
| EXTRACT_ANTIDOTE
|
* name
* value
* ? (always 0)
* ? (always 0)
* ? (always 50 or 100)
| [EXTRACT_ANTIDOTE:cave spider antivenin:7:0:0:50]

|-
| EXTRACT_BOILING_POINT
| temperature
| The temperature value at which a unit of the creature's extract boils away.

|-
| EXTRACT_CHEESE
|
* name
* value
* ?
* ?
| The extract gotten from the creature is a unit of cheese.
[EXTRACT_CHEESE:cow cheese:6:0:1]

|-
| EXTRACT_COOKABLE
|
| Extract is cookable.

|-
| EXTRACT_COLDDAM_POINT
| temperature
| The low temperature value at which the creature's extract starts to take damage.

|-
| EXTRACT_FIXED_TEMP
| temperature
| The temperature that the creature's extract generates on its own.

|-
| EXTRACT_HEATDAM_POINT
| temperature
| The high temperature value at which the creature's extract starts to take damage.

|-
| EXTRACT_IGNITE_POINT
| temperature
| The temperature at which the creature's extract bursts into flame (NOT the container it's in).

|-
| EXTRACT_MELTING_POINT
| temperature
| The temperature at which the creature's extract melts into goo.

|-
| EXTRACT_PARALYZE
|
| (conjectural) Extract is poisonous, causing paralysis that lasts until the extract wears off. Can be delivered by SPECIALATTACK_INJECT_EXTRACT.

|-
| EXTRACT_PARALYZE_INTERMITTENT
|
| (conjectural) Extract is poisonous, causing paralysis on occasional intervals until the extract wears off. Can be delivered by SPECIALATTACK_INJECT_EXTRACT.

|-
| EXTRACT_PERMANENT
|
| (conjectural) The effects of the creature's extract are permanent once applied and do not wear off naturally.

|-
| EXTRACT_SIZE
| size
|
[EXTRACT_SIZE:10]

|-
| [[Creature_Tokens/SPEC_HEAT|EXTRACT_SPEC_HEAT]]
| not a temperature
| The difference in temperature required to modify the temperature of the creature's extract? {{verify}}

|-
| EXTRACT_STUN
|
| (conjectural) Extract is poisonous, causing a permanent stun effect until the extract wears off. Can be delivered by SPECIALATTACK_INJECT_EXTRACT.

|-
| EXTRACT_STUN_INTERMITTENT
|
| (verified) Extract is poisonous, causing temporary stuns on semi-occasional intervals. Can be delivered by SPECIALATTACK_INJECT_EXTRACT.

|-
| EXTRACT_VALUE
| value
| The value per unit of the creature's extract.
[EXTRACT_VALUE:20]

|-
| EXTRAVISION
|
| Creature has enhanced vision (longer vision range, ie. at night).

|}

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

|-
| FAT
| value
| How much fat a creature produces when it is butchered.
[FAT:3]

|-
| FEMALE
|
| The creature is always female.

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

|-
| FIREIMMUNE
|
| The creature is immune to all forms of fire, except DRAGONFIREBREATH.

|-
| FIREIMMUNE_SUPER
|
| The creature is immune to DRAGONFIREBREATH. AI acts as if FIREIMMUNE. Does NOT imply FIREIMMUNE.

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

|-
| FIXED_TEMP
| temperature
| The natural heat generated by the creature. [FIXED_TEMP:1-?]

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

|-
| FLIER
|
| Allows a creature to fly. Currently, an AI bug prevents this from being useful on PC races in fortress mode.

|-
| FREQUENCY
| time
| Determines the time between creature spawns in Fortress Mode. Higher is more occurences per time unit{{verify}}. Creatures without a frequency statement appear to be on the map at all times. Almost all others have either [FREQUENCY:5] or [FREQUENCY:100].
[FREQUENCY:42]

|}

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

|-
| GENPOWER
| rate?
| Not used anymore and can be removed safely. Was related to magic.
[GENPOWER:3]

|-
| GLOWCOLOR
|
* fg
* bg
* br
| The colour of the GLOWTILE of the creature (see below).

[GLOWCOLOR:4:0:1]

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

[GLOWTILE:'"']

|-
| GNAWER
|
| The creature chews on food storage containers.

|-
| GOOD
|
| Determines whether creature can show up on "good" maps (see [[Creatures#Threat Matrix|Threat Matrix]]).

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

|}

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

|-
| HAS_RACEGLOSS
| gloss
| Links a material glossary to the creature. It is hardcoded, and there is only 4 types of tag.
[HAS_RACEGLOSS:WOOD]
[HAS_RACEGLOSS:STONE]
[HAS_RACEGLOSS:METAL]
[HAS_RACEGLOSS:PLANT]

|-
| HASSHELL
|
| Creature will leave behind a shell when eaten.

|-
| HEATDAM_POINT
| temperature
| The maximum temperature limit before the creature will start recieving damage from heat. [[Temperature scale|DF temperature scale]]

|-
| HOMEOTHERM
| value
| Default 'NONE'. The creature's normal body temperature. Combined with LAYERING, sets the temperature range under which it can live. [[Temperature scale|DF temperature scale]]

|-
| HORN
|
| Creature drops a horn or horns when butchered, which presumably acts like bone. This tag is broken.

|}

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

|-
| IGNITE_POINT
| temperature
| The temperature at which the creature will burst into flames. [[Temperature scale|DF temperature scale]]

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

|-
| IMMOBILE_LAND
|
| The creature is immobile while on land

|-
| INTELLIGENT
|
| Implies CAN_CIV, CAN_SPEAK, CAN_LEARN.

|-
| ITEMCORPSE
|
* [[Item Tokens|item token]]
* subtype
NO_SUBTYPE
* [[Matgloss_tokens|matgloss token]]
* NO_RACEGLOSS
USE_RACEGLOSS
USE_SHARPSTONE
| Determines if the creature leaves behind a non-standard corpse (i.e. wood, statue, bars, etc). The first parameter determines the item type; the second parameter is the subtype indicated in the raw file (such as WEAPON_WHIP); the third indicates the material type if the item type takes a specific material (e.g. "IRON" if the corpse type is "STATUE"). USE_RACEGLOSS applies if the creature has a material glossary assigned by the "HAS_RACEGLOSS:" flag and will select neccesary adjectives and material from that glossary.
[ITEMCORPSE:[[Item Tokens|WOOD]]:NO_SUBTYPE:[[Material Tokens|WOOD]]:USE_RACEGLOSS]

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

|-
| IVORY
|
| Creature will produce ivory when butchered. Currently doesn't work.

|}

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

|-
| LARGE_CAVERIVER
|
| In Fortress Mode, spawns from/near cave rivers.

|-
| LARGE_CHASM
|
| In Fortress Mode, spawns from/near chasms.

|-
| LARGE_LAVA
|
| In Fortress Mode, spawns from/near magma.

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

|-
| LAYERING
| value
| How well-protected the creature is from low temperatures. If this number is too high, it will confine a creature to only arctic areas. If it is even higher it will prevent the creature from spawning at all.

|-
| LEATHER_BOILING_POINT
| temperature
| The temperature at which leather made from the creature's skins will boil away.

|-
| LEATHER_COLDDAM_POINT
| temperature
| The temperature at which leather made from the creature's skins will take damage.

|-
| LEATHER_FIXED_TEMP
| temperature
| The temperature that leather made from the creature's skins generates.

|-
| LEATHER_HEATDAM_POINT
| temperature
| The temperature at which leather made from the creature's skins will take damage.

|-
| LEATHER_IGNITE_POINT
| temperature
| The temperature at which leather made from the creature's skins will burst into flames.

|-
| LEATHER_MELTING_POINT
| temperature
| The temperature at which leather made from the creature's skins will melt away.

|-
| [[Creature_Tokens/SPEC_HEAT|LEATHER_SPEC_HEAT]]
| not a temperature
| The difference in temperature required to modify the temperature of the creature's leather? {{verify}}

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

|-
| LIKES_FIGHTING
|
|

|-
| 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. Implies [TRAPAVOID]

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

|}

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

|-
| MAGICAL
|
| Allows a creature to use magic? However, magic isn't implemented yet.

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

|-
| MALE
|
| The creature is always male.

|-
| MATERIAL
|
* [[Matgloss_tokens|Matgloss token]]
* USE_RACEGLOSS
|

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

|-
| MAXAGE
|
* minimum
* maximum
| Sets the Min Max age for a creature. Used in world generating and Fortress Mode.
[MAXAGE:150:170]

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

|-
| MEGABEAST
|
| Appears on fortress territory in Fortress Mode occasionally. Implies SEMIMEGABEAST.

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

|-
| MILKABLE
| frequency?
| Allows the creature to be milked. Currently only works with vermin creatures.

|-
| MISCHIEVIOUS
|
| Will pull any levers it comes across. (requires confirmation)

|-
| MODVALUE
| number
| Multiplies the value of items made from the creature by the number in the tag.
[MODVALUE:2]

|-
| MOUNT
|
| Allows the creature to be mounted.

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

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

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

|}

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

|-
| NAME
|
* singular noun
* plural noun
* adjective
| What the creature is actually called in game. Make sure there is no space around the ":".
[NAME:dwarf:dwarves:dwarven]

|-
| NARROW
|
| The creature can only wear things that have the narrow tag on it.

|-
| NATURAL
|
| Animal

|-
| NO_AUTUMN
|
| Will not show up during the Autumn season.

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

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

|-
| NO_GENDER
|
| No gender will be selected for the creature.

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

|-
| NO_SPRING
|
| Will not show up during the Spring season.

|-
| NO_SUMMER
|
| Will not show up during the Summer season.

|-
| NO_WINTER
|
| Will not show up during the Winter season.

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

|-
| NOBLEED
|
| Creature doesn't bleed.

|-
| NOBONES
|
| Creature will not drop bones on butcher, rot, or decay of severed body parts.

|-
| 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
|
| Creatures' corpse does not create miasma.

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

|-
| NOSTUN
|
| Creature can't be stunned.

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

|-
| NOT_BUTCHERABLE
|
| Creature can't be butchered.

|}

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

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

|-
| PATTERNFLIER
|
| Flies in a semi-predictable pattern? {{verify}}

|-
| 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 greater than the penetrate power, their contents escape for the time being. Other objects roll a 0-99.

|-
| PERSONALITY
|
* token
* lowest % chance
* median
* highest % chance
| Determines chance of personality traits. Standard is 0:50:100. See [[Personality traits]] for more info.
[PERSONALITY:IMAGINATION:0:55:100]

|-
| 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:42]

|-
| POPULATION_NUMBER
|
* minimum
* maximum
| The minimum/maximum numbers of how many of these creatures can show up on a map per year.
[POPULATION_NUMBER:42:42]

|-
| POWER
|
| Allows the creature to be worshiped by entities with the RELIGION:ANY_APPROPRIATE_POWER tag.

|-
| PREFSTRING
| object
| Sets what other creatures like about this creature. "Blarghh likes dwarves for their beards."
[PREFSTRING:beards]
Multiple entries will be chosen from at random.

|}

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

|-
| REMAINS
| <''singular''>:<''plural''>
| ??? Used by treants along with [REMAINS_UNDETERMINED], appears to change the name of a creatures remains.

|-
| REMAINS_COLOR
|
* fg
* bg
* br
| The color of the creature's remains. Used by treants.

[REMAINS_COLOR:6:0:0]
|-
| REMAINS_UNDETERMINED
|
|

|}

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

|-
| SAVAGE
|
| Determines whether creature can show up on "savage" maps.

|-
| SEMIMEGABEAST
|
| Appears as boss creature in quests.

|-
| SESSILE_LAND
|
| Obsolete. Use [[#I|[IMMOBILE_LAND]]].

|-
| SEVERONBREAKS
|
| Limbs and body parts sever on breakage.

|-
| SILK_BOILING_POINT
| temperature
| Temperature at which silk made from this creature's webs boils away.

|-
| SILK_COLDDAM_POINT
| temperature
| Temperature at which silk made from this creature's webs takes damage.

|-
| SILK_FIXED_TEMP
| temperature
| Temperature generated by the creature's web silk.

|-
| SILK_HEATDAM_POINT
| temperature
| Temperature at which silk made from this creature's webs takes damage.

|-
| SILK_IGNITE_POINT
| temperature
| Temperature at which silk made from this creature's webs bursts into flame.

|-
| SILK_MELTING_POINT
| temperature
| Temperature at which silk made from this creature's webs melts away.

|-
| [[Creature_Tokens/SPEC_HEAT|SILK_SPEC_HEAT]]
| not a temperature
| The difference in temperature required to modify the temperature of the creature's silk? {{verify}}

|-
| SIZE
| value
| How big a creature is. 6 is for dwarf like creatures, 7 is for human like creatures. 16 is for giants. Larger creatures are far more dangerous in combat. Also equals the amount of Meat/Chunks/Bones you get from the beast.
[SIZE:6]

|-
| SLOW_LEARNER
|
| Presumably similar to [CAN_LEARN], but slower. Present in the entries for ogres and giants

|-
| SMALLAQUATIC_CAVERIVER
|
|

|-
| SMALLAQUATIC_OCEAN
|
|

|-
| SMALLAQUATIC_RIVER
|
|

|-
| SMALLAQUATIC_SWAMP
|
|

|-
| SMALL_REMAINS
|
| If a creature has this token, it'll leave a small corpse that only rots once, such as vermin.

|-
| SPECNAME
|
*token
*singular noun
*plural noun
*adjective
| Sets a special name for certain instances.
[SPECNAME:MALE:bull:bulls:bull]

|-
| [[Creature_Tokens/SPEC_HEAT|SPEC_HEAT]]
| not a temperature
| The specific heat of a creature? {{verify}}
[SPEC_HEAT:409]

|-
| SPEECH
| filename
| Sets what speech.txt to use for the creature.
[SPEECH:dwarf.txt]

|-
| SPEECH_MALE
| filename
| Used in place of [SPEECH] for humans; perhaps sets the speech.txt to use for males only? Humans don't have a corresponding [SPEECH_FEMALE] token, though, which only occurs in the [[string dump]].
[SPEECH_MALE:human_male.txt]

|-
| SPEED
| value
| Sets the creatures' movement and work speed, 1000/[100 + SPEED X] is the resulting effect on creatures movement and workrates from default. See [[Speed]] for more information.
[SPEED:400]

|-
| SPHERE
|
| Sets what religious spheres the creature is aligned to, for purposes of being worshiped via the [POWER] token. By default, only used by [[Demon|hidden fun stuff]].

|-
| STOUT
|
| Creature has a resistance to being knocked over.

|-
| STANDARD_FLESH
|
|

|-
| 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 must learn to swim. Requires [CAN_LEARN], obviously.

|-
| SWIM_SPEED
| value
| How fast the creature swims.

|}

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

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

|-
| TILE
| CP437 ordinal or 'character'
| The graphical representation of the creature.
[TILE:157] or [TILE:'&']

|-
| TRADE_CAPACITY
| weight
| How much the creature can carry when used by merchants.
[TRADE_CAPACITY:2000]

|-
| TRAINABLE
|
| Allows a tame creature to be trained into a "War" or "Hunting" variation by way of [[Kennels]].

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

|-
| TRAPAVOID
|
| The creature is immune to traps.

|-
| TRIGGERABLE_GROUP
|
* minimum?
* maximum?
| [TRIGGERABLE_GROUP:5:50]

|}

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

|-
| UNDERSWIM
|
| Creature swims under the water and can't be seen.
|-
| UTTERANCES
|
| Changes the language of the creature into an unintelligible mess.

|}

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

|-
| VEGETATION
|
|

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

|-
| VERMIN_BITE
|
* amount injected?
* name
* effect (USE_EXTRACT)
| [VERMIN_BITE:10:bitten:USE_EXTRACT]
On very rare occasions, someone who remains in the same tile as this creature will be bitten by that creature, and the effect will be applied to the offender. Used by (tiny) cave spiders to inject their venom into the occasional dwarf.

|-
| VERMIN_EATER
|
| The creature can eat your food.

|-
| 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. – [[User:Peristarkawan|Peristarkawan]] 17:27, 24 May 2007 (EDT)

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

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

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

|-
| VERMIN_NOTRAP
|
| The creature cannot be caught by trappers or animal traps.

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

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

|-
| VIEWRANGE
| value
| How far the creature can see?

|}

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

|-
| WAGON_PULLER
|
| Allows the creature to pull caravan wagons.

|-
| WEBBER
|
| The creature will create webs. It also seems to make creatures flying. More testing is needed.

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

|}

=Attacks=
{| {{prettytable}}
|- bgcolor="#ddd"
!width="50"|Tag
!width="225"|What It Does

|-
|[ATTACK:MAIN:BYTYPE:GRASP:punch:punches:1:2:BLUDGEON][ATTACKFLAG_WITH]

''Format:''
[ATTACK:''priority'':(BYTYPE:''type'' || BYTOKEN:''bodypart''):''"verb"'':''"conjugate verb"'':''min dmg'':''max dmg'':''dmg type'']([(ATTACKFLAG_WITH || ATTACKFLAG_CANLATCH)])([SPECIALATTACK_INJECT_EXTRACT:''min'':''max''])
|Sets what natural attacks a creature has.

|-
|MAIN
SECOND
|''MAIN'': Sets the attack to act as the creatures' main attack.
''SECOND'': The creature will only use this attack if it can't use the MAIN attack(s).

|-
|BYTYPE:GRASP
BYTOKEN:TAIL_STINGER
|''BYTYPE'': Sets what body part type to use for the attack. Possible values for "type" are GRASP, MOUTH, STANCE, THOUGHT, BREATHE, and the like. See [[Body Tokens]].
''BYTOKEN'': Sets the explicit body part ID to use for the attack. The token must exist as part of the creature's [[Creature Tokens#B|BODY]] token.

|-
|punch:punches
|Sets the verb for the attack.

|-
|1:2
|Sets the Min Max for the damage.

|-
|BLUDGEON, PIERCE, SLASH, GORE, BURN, HEAT, COLD
|Sets the damage type for the attack.

|-
|[ATTACKFLAG_WITH]
|Attacks in combat inform which body part was used in the attack.
"Ratman punches Blargg with his right hand."

|-
|[ATTACKFLAG_CANLATCH]
|Allows the creature to latch on with the attack. "Crocodile latches on Blargg's head firmly."

|-
|[SPECIALATTACK_INJECT_EXTRACT:50:100]
|The creature injects an amount of its extract into a victim upon successfully using this attack. The significance of the amount is unknown (but probably determines duration before the extract wears off).

|-
|[SPECIALATTACK_SUCK_BLOOD:50:100]
|When blood is drained from a creature, it causes heavy bleeding (depending on the attacking creatures ability to suck blood). It's unknown if blood suckers feed or regain health while doing this. (Numbers affect amount of blood drawn?)
|}

[[Category:Modding]]
[[Category:Tokens]]

40d:Creature token

2009-04-08T01:23:43Z

Darekun: /* V */ Added [VERMIN_ROTTER].

Everything here can be applied to all creature files, e.g. creature_domestic, creature_standard, even creature_equipment.

Since the game is in the Alpha stage, consider everything '''tentative'''.

{| id="toc"
|
* Tokens
** [[#A|A]] [[#B|B]] [[#C|C]] [[#D|D]] [[#E|E]] [[#F|F]] [[#G|G]] [[#H|H]] [[#I|I]] [[#J|J]] [[#K|K]] [[#L|L]] [[#M|M]]
** [[#N|N]] [[#O|O]] [[#P|P]] [[#Q|Q]] [[#R|R]] [[#S|S]] [[#T|T]] [[#U|U]] [[#V|V]] [[#W|W]] [[#X|X]] [[#Y|Y]] [[#Z|Z]]
|}
__NOTOC__

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

|-
| ADD_VERSION
| version
| In which version of the game said creature was introduced. Not used anymore in the 3D version.
[ADD_VERSION:1069]

|-
| 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/MATUTINAL, rather than implying them.

|-
| ALTTILE
| [[Character Table|CP437 ordinal]] or 'character'
| If set, the creature will blink between its [TILE] and its [ALTTILE].
[ALTTILE:157] or [ALTTILE:'&']

|-
| AMBUSHPREDATOR
|
| Makes the creature start out hidden. Used by giant cave spiders. May make webs hidden too?

|-
| AMPHIBIOUS
|
| Allows a creature to breathe with or without water.

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

|-
| ATTACK
|
| See the [[#Attacks|Attacks section]].

|}

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

|-
| BABY
| age
| Age at which a baby becomes a child. Without this tag, all creatures born will skip the baby stage and be children upon birth.
[BABY:1]

|-
| BEACH_FREQUENCY
| value
| Whales and jellyfish have this. Controls the beaching frequency of the creature.
[BEACH_FREQUENCY:10]

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

|-
| BIOME:*
|
| See [[Biome Tokens|biome tokens]].

|-
| BLOODTYPE
| type
| Sets the creatures' blood type (default red):
*R - Red blood
*G - Green blood
*B - Blue blood
*M - Magenta blood
*C - Cyan blood
*Y - Yellow pus
*W - White ichor
*0 - Black goo
*VOMIT
*SLIME
[BLOODTYPE:0]

|-
| [[Body_tokens|BODY]]
| parts[:...]
| Sets the body parts a creature has. Can supply as many as you want.
[BODY:HUMANOID:2EYES:2EARS]

|-
| [[Bodygloss|BODYGLOSS]]
| gloss
| A body_default.txt function. It replaces a part's description with another. e.g. feet with hooves.
[BODYGLOSS:HOOF]

|-
| BOILING_POINT
| temperature
| The temperature at which the creature boils into goo. [[Temperature scale|DF temperature scale]]

|-
| BONE_BOILING_POINT
| temperature
| The boiling point of the creature's bones.

|-
| BONE_COLDDAM_POINT
| temperature
| The low temperature at which the creature's bones start getting damaged.

|-
| BONE_FIXED_TEMP
| temperature
| The temperature that the creature's bones give off.

|-
| BONE_HEATDAM_POINT
| temperature
| The high temperature where the bones start taking damage.

|-
| BONE_IGNITE_POINT
| temperature
| The temperature at which point the creature's bones burst into flame.

|-
| BONE_MELTING_POINT
| temperature
| The temperature at which the creature's bones melt.

|-
| [[Creature_Tokens/SPEC_HEAT|BONE_SPEC_HEAT]]
| not a temperature
| Specific heat? (temperature difference required to change the temperature of the creature's bones?) {{verify}}

|-
| BONECARN
|
| Creature 'eats' bones. Eating bones makes their happiness go up, but can cause death (suffocation). This tag implies CARNIVORE.

|-
| BUILDINGDESTROYER
| value
| Allows a creature to destroy furniture and buildings. Creatures with BUILDINGDESTROYER will actively seek out your constructions and destroy them. A creature can have this value at 1 or 2. When the value is 1, the creature will go after wooden hatches, wooden doors, supports, statues, windows and archery targets only. They can't destroy homes during world gen as (semi)megabeasts.
When the value is 2 the creature will actively seek out most (all?) constructions and destroy them. They can also destroy buildings during world-gen with this tag. Megabeasts rely on this token for their pathing when attacking your fort.
[BUILDINGDESTROYER:2]

|-
| BUTCHERABLE_NONSTANDARD
|
| (old) If a creature has this tag, it may only be slaughtered (that is, the live creature is taken to the [[Butcher's Shop]] and slain). If it dies of any other cause, the corpse cannot be butchered.

|}

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

|-
| CAN_CIV
|
| Can create civilizations. This tag may activate hunger and thirst. {{verify}}

|-
| CAN_LEARN
|
| A creature with this tag can gain skill experience.

|-
| CAN_SPEAK
|
| Can talk.

|-
| CANNOT_UNDEAD
|
| Cannot become undead.

|-
| CARNIVORE
|
| Creature only eats meat.

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

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

|-
| CHEESE_BOILING_POINT
| temperature
| The temperature at which the creature's cheese (if any) boils away.

|-
| CHEESE_COLDDAM_POINT
| temperature
| The temperature at which the creature's cheese (if any) starts taking cold damage.

|-
| CHEESE_FIXED_TEMP
| temperature
| The temperature emitted by one unit of the creature's cheese (if any).

|-
| CHEESE_HEATDAM_POINT
| temperature
| The temperature at which the cheese made from the creature's milk starts taking heat damage.

|-
| CHEESE_IGNITE_POINT
| temperature
| The temperature at which the creature's cheese bursts into flame.

|-
| CHEESE_MELTING_POINT
| temperature
| The temperature at which the creature's cheese melts into goo.

|-
| [[Creature_Tokens/SPEC_HEAT|CHEESE_SPEC_HEAT]]
| not a temperature
| Specific heat? (temperature difference required to change the temperature of the creature's cheese?) {{verify}}

|-
| CHEESE_VALUE
| value
| The value per unit of cheese made from the creature's milk (if applicable). Note that only vermin as of current can be milked.

|-
| CHILD
| age
| Age at which a child becomes an adult.
[CHILD:12]

|-
| CHILDNAME
|
* singular
* plural
| Gives the child a special name, eg "hippo calf" instead of "hippo child".
[CHILDNAME:hippo calf:hippo calves]

|-
| CHITIN
|
| When the creature is butchered, it drops chitin, which functions as leather.

|-
| CRAFTSMAN_NAME
|
* singular
* plural
| Sets the name of the craftsman profession.
[CRAFTSMAN_NAME:craftsdwarf:craftsdwarves]

|-
| CREPUSCULAR
|
| Sets if the creature is active in twilight.

|-
| CLUSTER_NUMBER
|
* minimum
* maximum
| The minimum/maximum numbers of how many creatures per spawned cluster.
[CLUSTER_NUMBER:1:3]

|-
| COLOR
|
* fg (foreground)
* bg (background)
* br (brightness)
| [[Color]] of the creature's tile.
[COLOR:3:0:0]

|-
| COOKABLE_LIVE
|
| Set this to allow the creature to be cooked in meals without having to butcher it first.

|-
| CREATURE
| name
| What the game looks for when generating creatures.
[CREATURE:DWARF]

|-
| COLDDAM_POINT
| temperature
| The minimum temperature limit before the creature starts taking damage from freezing.

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

|-
| CURIOUSBEAST_EATER
|
| Allows a creature to eat edible items that it finds? (may imply CURIOUSBEAST_ITEM?) {{verify}}

|-
| CURIOUSBEAST_ITEM
|
| Allows a creature to steal things (usually [[food]]?).

|-
| CURIOUSBEAST_GUZZLER
|
| Will steal [[alcohol]]? Implies CURIOUSBEAST.

|}

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

|-
| DAMBLOCK
| value
| How much natural armor a creature has. Can be set to negative numbers, so the creature takes more damage than usual.
[DAMBLOCK:1]

|-
| DEFENDER
|
| Appears from the glowing pits in a group.

|-
| DIFFICULTY
| number
| [[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.
[DIFFICULTY:2]

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

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

|-
| DRINK_BOILING_POINT
| temperature
| The temperature at which a drink (milk?) produced from the creature will boil.

|-
| DRINK_COLDDAM_POINT
| temperature
| The temperature at which said drink will take cold damage.

|-
| DRINK_FIXED_TEMP
| temperature
| The temperature emitted by one unit of the creature's drink (if any).

|-
| DRINK_HEATDAM_POINT
| temperature
| The temperature at which aforementioned drink will take heat damage.

|-
| DRINK_IGNITE_POINT
| temperature
| The temperature at which the drink will set your fort ablaze.

|-
| DRINK_MELTING_POINT
| temperature
| [[User:GreyMario]] sez: "Isn't this, like, redundant? It's ''already'' liquid. Perhaps it controls at which point the drink solidifies?" {{verify}}

|-
| [[Creature_Tokens/SPEC_HEAT|DRINK_SPEC_HEAT]]
| not a temperature
| The difference in temperature required to modify the temperature of the drink? {{verify}}

|}

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

|-
| ENDING
|
| Will show up as a leader (only one of them) in a group from the glowing pits.

|-
| EQUIPMENT_WAGON
|
| Implies two unknown flags, NOSTUN, NONAUSEA, NOBLEED, NOEMOTION, NOSTUCKINS, SEVERONBREAKS, NOSKULL, NOSKIN, NOBONES, NOMEAT, PARALYZEIMMUNE, NOFEAR, NOSMELLYROT, NOTHOUGHT, NO_GENDER.

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

|-
| EVIL
|
| Determines whether creature can show up on "evil" maps (see [[Creatures#Threat Matrix|Threat Matrix]]).

|-
| EXTRACT
|
* name
* value
* ? (always 0)
* ? (0 on venoms exception: giant desert scorpion venom)
| Determines what can be extracted from the creature, what it's called, how valuable it is, and what you can make from it. Note, it appears that the extraction process is hardcoded into the game, and can't be altered from objects/raw.
[EXTRACT:cow's milk:7:0:1]

|-
| EXTRACT_ANTIDOTE
|
* name
* value
* ? (always 0)
* ? (always 0)
* ? (always 50 or 100)
| [EXTRACT_ANTIDOTE:cave spider antivenin:7:0:0:50]

|-
| EXTRACT_BOILING_POINT
| temperature
| The temperature value at which a unit of the creature's extract boils away.

|-
| EXTRACT_CHEESE
|
* name
* value
* ?
* ?
| The extract gotten from the creature is a unit of cheese.
[EXTRACT_CHEESE:cow cheese:6:0:1]

|-
| EXTRACT_COOKABLE
|
| Extract is cookable.

|-
| EXTRACT_COLDDAM_POINT
| temperature
| The low temperature value at which the creature's extract starts to take damage.

|-
| EXTRACT_FIXED_TEMP
| temperature
| The temperature that the creature's extract generates on its own.

|-
| EXTRACT_HEATDAM_POINT
| temperature
| The high temperature value at which the creature's extract starts to take damage.

|-
| EXTRACT_IGNITE_POINT
| temperature
| The temperature at which the creature's extract bursts into flame (NOT the container it's in).

|-
| EXTRACT_MELTING_POINT
| temperature
| The temperature at which the creature's extract melts into goo.

|-
| EXTRACT_PARALYZE
|
| (conjectural) Extract is poisonous, causing paralysis that lasts until the extract wears off. Can be delivered by SPECIALATTACK_INJECT_EXTRACT.

|-
| EXTRACT_PARALYZE_INTERMITTENT
|
| (conjectural) Extract is poisonous, causing paralysis on occasional intervals until the extract wears off. Can be delivered by SPECIALATTACK_INJECT_EXTRACT.

|-
| EXTRACT_PERMANENT
|
| (conjectural) The effects of the creature's extract are permanent once applied and do not wear off naturally.

|-
| EXTRACT_SIZE
| size
|
[EXTRACT_SIZE:10]

|-
| [[Creature_Tokens/SPEC_HEAT|EXTRACT_SPEC_HEAT]]
| not a temperature
| The difference in temperature required to modify the temperature of the creature's extract? {{verify}}

|-
| EXTRACT_STUN
|
| (conjectural) Extract is poisonous, causing a permanent stun effect until the extract wears off. Can be delivered by SPECIALATTACK_INJECT_EXTRACT.

|-
| EXTRACT_STUN_INTERMITTENT
|
| (verified) Extract is poisonous, causing temporary stuns on semi-occasional intervals. Can be delivered by SPECIALATTACK_INJECT_EXTRACT.

|-
| EXTRACT_VALUE
| value
| The value per unit of the creature's extract.
[EXTRACT_VALUE:20]

|-
| EXTRAVISION
|
| Creature has enhanced vision (longer vision range, ie. at night).

|}

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

|-
| FAT
| value
| How much fat a creature produces when it is butchered.
[FAT:3]

|-
| FEMALE
|
| The creature is always female.

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

|-
| FIREIMMUNE
|
| The creature is immune to all forms of fire, except DRAGONFIREBREATH.

|-
| FIREIMMUNE_SUPER
|
| The creature is immune to DRAGONFIREBREATH. AI acts as if FIREIMMUNE. Does NOT imply FIREIMMUNE.

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

|-
| FIXED_TEMP
| temperature
| The natural heat generated by the creature. [FIXED_TEMP:1-?]

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

|-
| FLIER
|
| Allows a creature to fly. Currently, an AI bug prevents this from being useful on PC races in fortress mode.

|-
| FREQUENCY
| time
| Determines the time between creature spawns in Fortress Mode. Higher is more occurences per time unit{{verify}}. Creatures without a frequency statement appear to be on the map at all times. Almost all others have [FREQUENCY:5].
[FREQUENCY:42]

|}

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

|-
| GENPOWER
| rate?
| Not used anymore and can be removed safely. Was related to magic.
[GENPOWER:3]

|-
| GLOWCOLOR
|
* fg
* bg
* br
| The colour of the GLOWTILE of the creature (see below).

[GLOWCOLOR:4:0:1]

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

[GLOWTILE:'"']

|-
| GNAWER
|
| The creature chews on food storage containers.

|-
| GOOD
|
| Determines whether creature can show up on "good" maps (see [[Creatures#Threat Matrix|Threat Matrix]]).

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

|}

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

|-
| HAS_RACEGLOSS
| gloss
| Links a material glossary to the creature. It is hardcoded, and there is only 4 types of tag.
[HAS_RACEGLOSS:WOOD]
[HAS_RACEGLOSS:STONE]
[HAS_RACEGLOSS:METAL]
[HAS_RACEGLOSS:PLANT]

|-
| HASSHELL
|
| Creature will leave behind a shell when eaten.

|-
| HEATDAM_POINT
| temperature
| The maximum temperature limit before the creature will start recieving damage from heat. [[Temperature scale|DF temperature scale]]

|-
| HOMEOTHERM
| value
| Default 'NONE'. The creature's normal body temperature. Combined with LAYERING, sets the temperature range under which it can live. [[Temperature scale|DF temperature scale]]

|-
| HORN
|
| Creature drops a horn or horns when butchered, which presumably acts like bone. This tag is broken.

|}

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

|-
| IGNITE_POINT
| temperature
| The temperature at which the creature will burst into flames. [[Temperature scale|DF temperature scale]]

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

|-
| IMMOBILE_LAND
|
| The creature is immobile while on land

|-
| INTELLIGENT
|
| Implies CAN_CIV, CAN_SPEAK, CAN_LEARN.

|-
| ITEMCORPSE
|
* [[Item Tokens|item token]]
* subtype
NO_SUBTYPE
* [[Matgloss_tokens|matgloss token]]
* NO_RACEGLOSS
USE_RACEGLOSS
USE_SHARPSTONE
| Determines if the creature leaves behind a non-standard corpse (i.e. wood, statue, bars, etc). The first parameter determines the item type; the second parameter is the subtype indicated in the raw file (such as WEAPON_WHIP); the third indicates the material type if the item type takes a specific material (e.g. "IRON" if the corpse type is "STATUE"). USE_RACEGLOSS applies if the creature has a material glossary assigned by the "HAS_RACEGLOSS:" flag and will select neccesary adjectives and material from that glossary.
[ITEMCORPSE:[[Item Tokens|WOOD]]:NO_SUBTYPE:[[Material Tokens|WOOD]]:USE_RACEGLOSS]

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

|-
| IVORY
|
| Creature will produce ivory when butchered. Currently doesn't work.

|}

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

|-
| LARGE_CAVERIVER
|
| In Fortress Mode, spawns from/near cave rivers.

|-
| LARGE_CHASM
|
| In Fortress Mode, spawns from/near chasms.

|-
| LARGE_LAVA
|
| In Fortress Mode, spawns from/near magma.

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

|-
| LAYERING
| value
| How well-protected the creature is from low temperatures. If this number is too high, it will confine a creature to only arctic areas. If it is even higher it will prevent the creature from spawning at all.

|-
| LEATHER_BOILING_POINT
| temperature
| The temperature at which leather made from the creature's skins will boil away.

|-
| LEATHER_COLDDAM_POINT
| temperature
| The temperature at which leather made from the creature's skins will take damage.

|-
| LEATHER_FIXED_TEMP
| temperature
| The temperature that leather made from the creature's skins generates.

|-
| LEATHER_HEATDAM_POINT
| temperature
| The temperature at which leather made from the creature's skins will take damage.

|-
| LEATHER_IGNITE_POINT
| temperature
| The temperature at which leather made from the creature's skins will burst into flames.

|-
| LEATHER_MELTING_POINT
| temperature
| The temperature at which leather made from the creature's skins will melt away.

|-
| [[Creature_Tokens/SPEC_HEAT|LEATHER_SPEC_HEAT]]
| not a temperature
| The difference in temperature required to modify the temperature of the creature's leather? {{verify}}

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

|-
| LIKES_FIGHTING
|
|

|-
| 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. Implies [TRAPAVOID]

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

|}

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

|-
| MAGICAL
|
| Allows a creature to use magic? However, magic isn't implemented yet.

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

|-
| MALE
|
| The creature is always male.

|-
| MATERIAL
|
* [[Matgloss_tokens|Matgloss token]]
* USE_RACEGLOSS
|

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

|-
| MAXAGE
|
* minimum
* maximum
| Sets the Min Max age for a creature. Used in world generating and Fortress Mode.
[MAXAGE:150:170]

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

|-
| MEGABEAST
|
| Appears on fortress territory in Fortress Mode occasionally. Implies SEMIMEGABEAST.

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

|-
| MILKABLE
| frequency?
| Allows the creature to be milked. Currently only works with vermin creatures.

|-
| MISCHIEVIOUS
|
| Will pull any levers it comes across. (requires confirmation)

|-
| MODVALUE
| number
| Multiplies the value of items made from the creature by the number in the tag.
[MODVALUE:2]

|-
| MOUNT
|
| Allows the creature to be mounted.

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

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

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

|}

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

|-
| NAME
|
* singular noun
* plural noun
* adjective
| What the creature is actually called in game. Make sure there is no space around the ":".
[NAME:dwarf:dwarves:dwarven]

|-
| NARROW
|
| The creature can only wear things that have the narrow tag on it.

|-
| NATURAL
|
| Animal

|-
| NO_AUTUMN
|
| Will not show up during the Autumn season.

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

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

|-
| NO_GENDER
|
| No gender will be selected for the creature.

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

|-
| NO_SPRING
|
| Will not show up during the Spring season.

|-
| NO_SUMMER
|
| Will not show up during the Summer season.

|-
| NO_WINTER
|
| Will not show up during the Winter season.

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

|-
| NOBLEED
|
| Creature doesn't bleed.

|-
| NOBONES
|
| Creature will not drop bones on butcher, rot, or decay of severed body parts.

|-
| 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
|
| Creatures' corpse does not create miasma.

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

|-
| NOSTUN
|
| Creature can't be stunned.

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

|-
| NOT_BUTCHERABLE
|
| Creature can't be butchered.

|}

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

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

|-
| PATTERNFLIER
|
| Flies in a semi-predictable pattern? {{verify}}

|-
| 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 greater than the penetrate power, their contents escape for the time being. Other objects roll a 0-99.

|-
| PERSONALITY
|
* token
* lowest % chance
* median
* highest % chance
| Determines chance of personality traits. Standard is 0:50:100. See [[Personality traits]] for more info.
[PERSONALITY:IMAGINATION:0:55:100]

|-
| 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:42]

|-
| POPULATION_NUMBER
|
* minimum
* maximum
| The minimum/maximum numbers of how many of these creatures can show up on a map per year.
[POPULATION_NUMBER:42:42]

|-
| POWER
|
| Allows the creature to be worshiped by entities with the RELIGION:ANY_APPROPRIATE_POWER tag.

|-
| PREFSTRING
| object
| Sets what other creatures like about this creature. "Blarghh likes dwarves for their beards."
[PREFSTRING:beards]
Multiple entries will be chosen from at random.

|}

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

|-
| REMAINS
| <''singular''>:<''plural''>
| ??? Used by treants along with [REMAINS_UNDETERMINED], appears to change the name of a creatures remains.

|-
| REMAINS_COLOR
|
* fg
* bg
* br
| The color of the creature's remains. Used by treants.

[REMAINS_COLOR:6:0:0]
|-
| REMAINS_UNDETERMINED
|
|

|}

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

|-
| SAVAGE
|
| Determines whether creature can show up on "savage" maps.

|-
| SEMIMEGABEAST
|
| Appears as boss creature in quests.

|-
| SESSILE_LAND
|
| Obsolete. Use [[#I|[IMMOBILE_LAND]]].

|-
| SEVERONBREAKS
|
| Limbs and body parts sever on breakage.

|-
| SILK_BOILING_POINT
| temperature
| Temperature at which silk made from this creature's webs boils away.

|-
| SILK_COLDDAM_POINT
| temperature
| Temperature at which silk made from this creature's webs takes damage.

|-
| SILK_FIXED_TEMP
| temperature
| Temperature generated by the creature's web silk.

|-
| SILK_HEATDAM_POINT
| temperature
| Temperature at which silk made from this creature's webs takes damage.

|-
| SILK_IGNITE_POINT
| temperature
| Temperature at which silk made from this creature's webs bursts into flame.

|-
| SILK_MELTING_POINT
| temperature
| Temperature at which silk made from this creature's webs melts away.

|-
| [[Creature_Tokens/SPEC_HEAT|SILK_SPEC_HEAT]]
| not a temperature
| The difference in temperature required to modify the temperature of the creature's silk? {{verify}}

|-
| SIZE
| value
| How big a creature is. 6 is for dwarf like creatures, 7 is for human like creatures. 16 is for giants. Larger creatures are far more dangerous in combat. Also equals the amount of Meat/Chunks/Bones you get from the beast.
[SIZE:6]

|-
| SLOW_LEARNER
|
| Presumably similar to [CAN_LEARN], but slower. Present in the entries for ogres and giants

|-
| SMALLAQUATIC_CAVERIVER
|
|

|-
| SMALLAQUATIC_OCEAN
|
|

|-
| SMALLAQUATIC_RIVER
|
|

|-
| SMALLAQUATIC_SWAMP
|
|

|-
| SMALL_REMAINS
|
| If a creature has this token, it'll leave a small corpse that only rots once, such as vermin.

|-
| SPECNAME
|
*token
*singular noun
*plural noun
*adjective
| Sets a special name for certain instances.
[SPECNAME:MALE:bull:bulls:bull]

|-
| [[Creature_Tokens/SPEC_HEAT|SPEC_HEAT]]
| not a temperature
| The specific heat of a creature? {{verify}}
[SPEC_HEAT:409]

|-
| SPEECH
| filename
| Sets what speech.txt to use for the creature.
[SPEECH:dwarf.txt]

|-
| SPEECH_MALE
| filename
| Used in place of [SPEECH] for humans; perhaps sets the speech.txt to use for males only? Humans don't have a corresponding [SPEECH_FEMALE] token, though, which only occurs in the [[string dump]].
[SPEECH_MALE:human_male.txt]

|-
| SPEED
| value
| Sets the creatures' movement and work speed, 1000/[100 + SPEED X] is the resulting effect on creatures movement and workrates from default. See [[Speed]] for more information.
[SPEED:400]

|-
| SPHERE
|
| Sets what religious spheres the creature is aligned to, for purposes of being worshiped via the [POWER] token. By default, only used by [[Demon|hidden fun stuff]].

|-
| STOUT
|
| Creature has a resistance to being knocked over.

|-
| STANDARD_FLESH
|
|

|-
| 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 must learn to swim. Requires [CAN_LEARN], obviously.

|-
| SWIM_SPEED
| value
| How fast the creature swims.

|}

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

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

|-
| TILE
| CP437 ordinal or 'character'
| The graphical representation of the creature.
[TILE:157] or [TILE:'&']

|-
| TRADE_CAPACITY
| weight
| How much the creature can carry when used by merchants.
[TRADE_CAPACITY:2000]

|-
| TRAINABLE
|
| Allows a tame creature to be trained into a "War" or "Hunting" variation by way of [[Kennels]].

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

|-
| TRAPAVOID
|
| The creature is immune to traps.

|-
| TRIGGERABLE_GROUP
|
* minimum?
* maximum?
| [TRIGGERABLE_GROUP:5:50]

|}

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

|-
| UNDERSWIM
|
| Creature swims under the water and can't be seen.
|-
| UTTERANCES
|
| Changes the language of the creature into an unintelligible mess.

|}

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

|-
| VEGETATION
|
|

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

|-
| VERMIN_BITE
|
* amount injected?
* name
* effect (USE_EXTRACT)
| [VERMIN_BITE:10:bitten:USE_EXTRACT]
On very rare occasions, someone who remains in the same tile as this creature will be bitten by that creature, and the effect will be applied to the offender. Used by (tiny) cave spiders to inject their venom into the occasional dwarf.

|-
| VERMIN_EATER
|
| The creature can eat your food.

|-
| 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. – [[User:Peristarkawan|Peristarkawan]] 17:27, 24 May 2007 (EDT)

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

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

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

|-
| VERMIN_NOTRAP
|
| The creature cannot be caught by trappers or animal traps.

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

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

|-
| VIEWRANGE
| value
| How far the creature can see?

|}

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

|-
| WAGON_PULLER
|
| Allows the creature to pull caravan wagons.

|-
| WEBBER
|
| The creature will create webs. It also seems to make creatures flying. More testing is needed.

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

|}

=Attacks=
{| {{prettytable}}
|- bgcolor="#ddd"
!width="50"|Tag
!width="225"|What It Does

|-
|[ATTACK:MAIN:BYTYPE:GRASP:punch:punches:1:2:BLUDGEON][ATTACKFLAG_WITH]

''Format:''
[ATTACK:''priority'':(BYTYPE:''type'' || BYTOKEN:''bodypart''):''"verb"'':''"conjugate verb"'':''min dmg'':''max dmg'':''dmg type'']([(ATTACKFLAG_WITH || ATTACKFLAG_CANLATCH)])([SPECIALATTACK_INJECT_EXTRACT:''min'':''max''])
|Sets what natural attacks a creature has.

|-
|MAIN
SECOND
|''MAIN'': Sets the attack to act as the creatures' main attack.
''SECOND'': The creature will only use this attack if it can't use the MAIN attack(s).

|-
|BYTYPE:GRASP
BYTOKEN:TAIL_STINGER
|''BYTYPE'': Sets what body part type to use for the attack. Possible values for "type" are GRASP, MOUTH, STANCE, THOUGHT, BREATHE, and the like. See [[Body Tokens]].
''BYTOKEN'': Sets the explicit body part ID to use for the attack. The token must exist as part of the creature's [[Creature Tokens#B|BODY]] token.

|-
|punch:punches
|Sets the verb for the attack.

|-
|1:2
|Sets the Min Max for the damage.

|-
|BLUDGEON, PIERCE, SLASH, GORE, BURN, HEAT, COLD
|Sets the damage type for the attack.

|-
|[ATTACKFLAG_WITH]
|Attacks in combat inform which body part was used in the attack.
"Ratman punches Blargg with his right hand."

|-
|[ATTACKFLAG_CANLATCH]
|Allows the creature to latch on with the attack. "Crocodile latches on Blargg's head firmly."

|-
|[SPECIALATTACK_INJECT_EXTRACT:50:100]
|The creature injects an amount of its extract into a victim upon successfully using this attack. The significance of the amount is unknown (but probably determines duration before the extract wears off).

|-
|[SPECIALATTACK_SUCK_BLOOD:50:100]
|When blood is drained from a creature, it causes heavy bleeding (depending on the attacking creatures ability to suck blood). It's unknown if blood suckers feed or regain health while doing this. (Numbers affect amount of blood drawn?)
|}

[[Category:Modding]]
[[Category:Tokens]]

40d:Creature token

2009-04-08T01:10:52Z

Darekun: /* F */ Documented bug re [FLIER].

Everything here can be applied to all creature files, e.g. creature_domestic, creature_standard, even creature_equipment.

Since the game is in the Alpha stage, consider everything '''tentative'''.

{| id="toc"
|
* Tokens
** [[#A|A]] [[#B|B]] [[#C|C]] [[#D|D]] [[#E|E]] [[#F|F]] [[#G|G]] [[#H|H]] [[#I|I]] [[#J|J]] [[#K|K]] [[#L|L]] [[#M|M]]
** [[#N|N]] [[#O|O]] [[#P|P]] [[#Q|Q]] [[#R|R]] [[#S|S]] [[#T|T]] [[#U|U]] [[#V|V]] [[#W|W]] [[#X|X]] [[#Y|Y]] [[#Z|Z]]
|}
__NOTOC__

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

|-
| ADD_VERSION
| version
| In which version of the game said creature was introduced. Not used anymore in the 3D version.
[ADD_VERSION:1069]

|-
| 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/MATUTINAL, rather than implying them.

|-
| ALTTILE
| [[Character Table|CP437 ordinal]] or 'character'
| If set, the creature will blink between its [TILE] and its [ALTTILE].
[ALTTILE:157] or [ALTTILE:'&']

|-
| AMBUSHPREDATOR
|
| Makes the creature start out hidden. Used by giant cave spiders. May make webs hidden too?

|-
| AMPHIBIOUS
|
| Allows a creature to breathe with or without water.

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

|-
| ATTACK
|
| See the [[#Attacks|Attacks section]].

|}

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

|-
| BABY
| age
| Age at which a baby becomes a child. Without this tag, all creatures born will skip the baby stage and be children upon birth.
[BABY:1]

|-
| BEACH_FREQUENCY
| value
| Whales and jellyfish have this. Controls the beaching frequency of the creature.
[BEACH_FREQUENCY:10]

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

|-
| BIOME:*
|
| See [[Biome Tokens|biome tokens]].

|-
| BLOODTYPE
| type
| Sets the creatures' blood type (default red):
*R - Red blood
*G - Green blood
*B - Blue blood
*M - Magenta blood
*C - Cyan blood
*Y - Yellow pus
*W - White ichor
*0 - Black goo
*VOMIT
*SLIME
[BLOODTYPE:0]

|-
| [[Body_tokens|BODY]]
| parts[:...]
| Sets the body parts a creature has. Can supply as many as you want.
[BODY:HUMANOID:2EYES:2EARS]

|-
| [[Bodygloss|BODYGLOSS]]
| gloss
| A body_default.txt function. It replaces a part's description with another. e.g. feet with hooves.
[BODYGLOSS:HOOF]

|-
| BOILING_POINT
| temperature
| The temperature at which the creature boils into goo. [[Temperature scale|DF temperature scale]]

|-
| BONE_BOILING_POINT
| temperature
| The boiling point of the creature's bones.

|-
| BONE_COLDDAM_POINT
| temperature
| The low temperature at which the creature's bones start getting damaged.

|-
| BONE_FIXED_TEMP
| temperature
| The temperature that the creature's bones give off.

|-
| BONE_HEATDAM_POINT
| temperature
| The high temperature where the bones start taking damage.

|-
| BONE_IGNITE_POINT
| temperature
| The temperature at which point the creature's bones burst into flame.

|-
| BONE_MELTING_POINT
| temperature
| The temperature at which the creature's bones melt.

|-
| [[Creature_Tokens/SPEC_HEAT|BONE_SPEC_HEAT]]
| not a temperature
| Specific heat? (temperature difference required to change the temperature of the creature's bones?) {{verify}}

|-
| BONECARN
|
| Creature 'eats' bones. Eating bones makes their happiness go up, but can cause death (suffocation). This tag implies CARNIVORE.

|-
| BUILDINGDESTROYER
| value
| Allows a creature to destroy furniture and buildings. Creatures with BUILDINGDESTROYER will actively seek out your constructions and destroy them. A creature can have this value at 1 or 2. When the value is 1, the creature will go after wooden hatches, wooden doors, supports, statues, windows and archery targets only. They can't destroy homes during world gen as (semi)megabeasts.
When the value is 2 the creature will actively seek out most (all?) constructions and destroy them. They can also destroy buildings during world-gen with this tag. Megabeasts rely on this token for their pathing when attacking your fort.
[BUILDINGDESTROYER:2]

|-
| BUTCHERABLE_NONSTANDARD
|
| (old) If a creature has this tag, it may only be slaughtered (that is, the live creature is taken to the [[Butcher's Shop]] and slain). If it dies of any other cause, the corpse cannot be butchered.

|}

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

|-
| CAN_CIV
|
| Can create civilizations. This tag may activate hunger and thirst. {{verify}}

|-
| CAN_LEARN
|
| A creature with this tag can gain skill experience.

|-
| CAN_SPEAK
|
| Can talk.

|-
| CANNOT_UNDEAD
|
| Cannot become undead.

|-
| CARNIVORE
|
| Creature only eats meat.

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

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

|-
| CHEESE_BOILING_POINT
| temperature
| The temperature at which the creature's cheese (if any) boils away.

|-
| CHEESE_COLDDAM_POINT
| temperature
| The temperature at which the creature's cheese (if any) starts taking cold damage.

|-
| CHEESE_FIXED_TEMP
| temperature
| The temperature emitted by one unit of the creature's cheese (if any).

|-
| CHEESE_HEATDAM_POINT
| temperature
| The temperature at which the cheese made from the creature's milk starts taking heat damage.

|-
| CHEESE_IGNITE_POINT
| temperature
| The temperature at which the creature's cheese bursts into flame.

|-
| CHEESE_MELTING_POINT
| temperature
| The temperature at which the creature's cheese melts into goo.

|-
| [[Creature_Tokens/SPEC_HEAT|CHEESE_SPEC_HEAT]]
| not a temperature
| Specific heat? (temperature difference required to change the temperature of the creature's cheese?) {{verify}}

|-
| CHEESE_VALUE
| value
| The value per unit of cheese made from the creature's milk (if applicable). Note that only vermin as of current can be milked.

|-
| CHILD
| age
| Age at which a child becomes an adult.
[CHILD:12]

|-
| CHILDNAME
|
* singular
* plural
| Gives the child a special name, eg "hippo calf" instead of "hippo child".
[CHILDNAME:hippo calf:hippo calves]

|-
| CHITIN
|
| When the creature is butchered, it drops chitin, which functions as leather.

|-
| CRAFTSMAN_NAME
|
* singular
* plural
| Sets the name of the craftsman profession.
[CRAFTSMAN_NAME:craftsdwarf:craftsdwarves]

|-
| CREPUSCULAR
|
| Sets if the creature is active in twilight.

|-
| CLUSTER_NUMBER
|
* minimum
* maximum
| The minimum/maximum numbers of how many creatures per spawned cluster.
[CLUSTER_NUMBER:1:3]

|-
| COLOR
|
* fg (foreground)
* bg (background)
* br (brightness)
| [[Color]] of the creature's tile.
[COLOR:3:0:0]

|-
| COOKABLE_LIVE
|
| Set this to allow the creature to be cooked in meals without having to butcher it first.

|-
| CREATURE
| name
| What the game looks for when generating creatures.
[CREATURE:DWARF]

|-
| COLDDAM_POINT
| temperature
| The minimum temperature limit before the creature starts taking damage from freezing.

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

|-
| CURIOUSBEAST_EATER
|
| Allows a creature to eat edible items that it finds? (may imply CURIOUSBEAST_ITEM?) {{verify}}

|-
| CURIOUSBEAST_ITEM
|
| Allows a creature to steal things (usually [[food]]?).

|-
| CURIOUSBEAST_GUZZLER
|
| Will steal [[alcohol]]? Implies CURIOUSBEAST.

|}

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

|-
| DAMBLOCK
| value
| How much natural armor a creature has. Can be set to negative numbers, so the creature takes more damage than usual.
[DAMBLOCK:1]

|-
| DEFENDER
|
| Appears from the glowing pits in a group.

|-
| DIFFICULTY
| number
| [[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.
[DIFFICULTY:2]

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

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

|-
| DRINK_BOILING_POINT
| temperature
| The temperature at which a drink (milk?) produced from the creature will boil.

|-
| DRINK_COLDDAM_POINT
| temperature
| The temperature at which said drink will take cold damage.

|-
| DRINK_FIXED_TEMP
| temperature
| The temperature emitted by one unit of the creature's drink (if any).

|-
| DRINK_HEATDAM_POINT
| temperature
| The temperature at which aforementioned drink will take heat damage.

|-
| DRINK_IGNITE_POINT
| temperature
| The temperature at which the drink will set your fort ablaze.

|-
| DRINK_MELTING_POINT
| temperature
| [[User:GreyMario]] sez: "Isn't this, like, redundant? It's ''already'' liquid. Perhaps it controls at which point the drink solidifies?" {{verify}}

|-
| [[Creature_Tokens/SPEC_HEAT|DRINK_SPEC_HEAT]]
| not a temperature
| The difference in temperature required to modify the temperature of the drink? {{verify}}

|}

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

|-
| ENDING
|
| Will show up as a leader (only one of them) in a group from the glowing pits.

|-
| EQUIPMENT_WAGON
|
| Implies two unknown flags, NOSTUN, NONAUSEA, NOBLEED, NOEMOTION, NOSTUCKINS, SEVERONBREAKS, NOSKULL, NOSKIN, NOBONES, NOMEAT, PARALYZEIMMUNE, NOFEAR, NOSMELLYROT, NOTHOUGHT, NO_GENDER.

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

|-
| EVIL
|
| Determines whether creature can show up on "evil" maps (see [[Creatures#Threat Matrix|Threat Matrix]]).

|-
| EXTRACT
|
* name
* value
* ? (always 0)
* ? (0 on venoms exception: giant desert scorpion venom)
| Determines what can be extracted from the creature, what it's called, how valuable it is, and what you can make from it. Note, it appears that the extraction process is hardcoded into the game, and can't be altered from objects/raw.
[EXTRACT:cow's milk:7:0:1]

|-
| EXTRACT_ANTIDOTE
|
* name
* value
* ? (always 0)
* ? (always 0)
* ? (always 50 or 100)
| [EXTRACT_ANTIDOTE:cave spider antivenin:7:0:0:50]

|-
| EXTRACT_BOILING_POINT
| temperature
| The temperature value at which a unit of the creature's extract boils away.

|-
| EXTRACT_CHEESE
|
* name
* value
* ?
* ?
| The extract gotten from the creature is a unit of cheese.
[EXTRACT_CHEESE:cow cheese:6:0:1]

|-
| EXTRACT_COOKABLE
|
| Extract is cookable.

|-
| EXTRACT_COLDDAM_POINT
| temperature
| The low temperature value at which the creature's extract starts to take damage.

|-
| EXTRACT_FIXED_TEMP
| temperature
| The temperature that the creature's extract generates on its own.

|-
| EXTRACT_HEATDAM_POINT
| temperature
| The high temperature value at which the creature's extract starts to take damage.

|-
| EXTRACT_IGNITE_POINT
| temperature
| The temperature at which the creature's extract bursts into flame (NOT the container it's in).

|-
| EXTRACT_MELTING_POINT
| temperature
| The temperature at which the creature's extract melts into goo.

|-
| EXTRACT_PARALYZE
|
| (conjectural) Extract is poisonous, causing paralysis that lasts until the extract wears off. Can be delivered by SPECIALATTACK_INJECT_EXTRACT.

|-
| EXTRACT_PARALYZE_INTERMITTENT
|
| (conjectural) Extract is poisonous, causing paralysis on occasional intervals until the extract wears off. Can be delivered by SPECIALATTACK_INJECT_EXTRACT.

|-
| EXTRACT_PERMANENT
|
| (conjectural) The effects of the creature's extract are permanent once applied and do not wear off naturally.

|-
| EXTRACT_SIZE
| size
|
[EXTRACT_SIZE:10]

|-
| [[Creature_Tokens/SPEC_HEAT|EXTRACT_SPEC_HEAT]]
| not a temperature
| The difference in temperature required to modify the temperature of the creature's extract? {{verify}}

|-
| EXTRACT_STUN
|
| (conjectural) Extract is poisonous, causing a permanent stun effect until the extract wears off. Can be delivered by SPECIALATTACK_INJECT_EXTRACT.

|-
| EXTRACT_STUN_INTERMITTENT
|
| (verified) Extract is poisonous, causing temporary stuns on semi-occasional intervals. Can be delivered by SPECIALATTACK_INJECT_EXTRACT.

|-
| EXTRACT_VALUE
| value
| The value per unit of the creature's extract.
[EXTRACT_VALUE:20]

|-
| EXTRAVISION
|
| Creature has enhanced vision (longer vision range, ie. at night).

|}

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

|-
| FAT
| value
| How much fat a creature produces when it is butchered.
[FAT:3]

|-
| FEMALE
|
| The creature is always female.

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

|-
| FIREIMMUNE
|
| The creature is immune to all forms of fire, except DRAGONFIREBREATH.

|-
| FIREIMMUNE_SUPER
|
| The creature is immune to DRAGONFIREBREATH. AI acts as if FIREIMMUNE. Does NOT imply FIREIMMUNE.

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

|-
| FIXED_TEMP
| temperature
| The natural heat generated by the creature. [FIXED_TEMP:1-?]

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

|-
| FLIER
|
| Allows a creature to fly. Currently, an AI bug prevents this from being useful on PC races in fortress mode.

|-
| FREQUENCY
| time
| Determines the time between creature spawns in Fortress Mode. Higher is more occurences per time unit{{verify}}. Creatures without a frequency statement appear to be on the map at all times. Almost all others have [FREQUENCY:5].
[FREQUENCY:42]

|}

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

|-
| GENPOWER
| rate?
| Not used anymore and can be removed safely. Was related to magic.
[GENPOWER:3]

|-
| GLOWCOLOR
|
* fg
* bg
* br
| The colour of the GLOWTILE of the creature (see below).

[GLOWCOLOR:4:0:1]

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

[GLOWTILE:'"']

|-
| GNAWER
|
| The creature chews on food storage containers.

|-
| GOOD
|
| Determines whether creature can show up on "good" maps (see [[Creatures#Threat Matrix|Threat Matrix]]).

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

|}

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

|-
| HAS_RACEGLOSS
| gloss
| Links a material glossary to the creature. It is hardcoded, and there is only 4 types of tag.
[HAS_RACEGLOSS:WOOD]
[HAS_RACEGLOSS:STONE]
[HAS_RACEGLOSS:METAL]
[HAS_RACEGLOSS:PLANT]

|-
| HASSHELL
|
| Creature will leave behind a shell when eaten.

|-
| HEATDAM_POINT
| temperature
| The maximum temperature limit before the creature will start recieving damage from heat. [[Temperature scale|DF temperature scale]]

|-
| HOMEOTHERM
| value
| Default 'NONE'. The creature's normal body temperature. Combined with LAYERING, sets the temperature range under which it can live. [[Temperature scale|DF temperature scale]]

|-
| HORN
|
| Creature drops a horn or horns when butchered, which presumably acts like bone. This tag is broken.

|}

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

|-
| IGNITE_POINT
| temperature
| The temperature at which the creature will burst into flames. [[Temperature scale|DF temperature scale]]

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

|-
| IMMOBILE_LAND
|
| The creature is immobile while on land

|-
| INTELLIGENT
|
| Implies CAN_CIV, CAN_SPEAK, CAN_LEARN.

|-
| ITEMCORPSE
|
* [[Item Tokens|item token]]
* subtype
NO_SUBTYPE
* [[Matgloss_tokens|matgloss token]]
* NO_RACEGLOSS
USE_RACEGLOSS
USE_SHARPSTONE
| Determines if the creature leaves behind a non-standard corpse (i.e. wood, statue, bars, etc). The first parameter determines the item type; the second parameter is the subtype indicated in the raw file (such as WEAPON_WHIP); the third indicates the material type if the item type takes a specific material (e.g. "IRON" if the corpse type is "STATUE"). USE_RACEGLOSS applies if the creature has a material glossary assigned by the "HAS_RACEGLOSS:" flag and will select neccesary adjectives and material from that glossary.
[ITEMCORPSE:[[Item Tokens|WOOD]]:NO_SUBTYPE:[[Material Tokens|WOOD]]:USE_RACEGLOSS]

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

|-
| IVORY
|
| Creature will produce ivory when butchered. Currently doesn't work.

|}

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

|-
| LARGE_CAVERIVER
|
| In Fortress Mode, spawns from/near cave rivers.

|-
| LARGE_CHASM
|
| In Fortress Mode, spawns from/near chasms.

|-
| LARGE_LAVA
|
| In Fortress Mode, spawns from/near magma.

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

|-
| LAYERING
| value
| How well-protected the creature is from low temperatures. If this number is too high, it will confine a creature to only arctic areas. If it is even higher it will prevent the creature from spawning at all.

|-
| LEATHER_BOILING_POINT
| temperature
| The temperature at which leather made from the creature's skins will boil away.

|-
| LEATHER_COLDDAM_POINT
| temperature
| The temperature at which leather made from the creature's skins will take damage.

|-
| LEATHER_FIXED_TEMP
| temperature
| The temperature that leather made from the creature's skins generates.

|-
| LEATHER_HEATDAM_POINT
| temperature
| The temperature at which leather made from the creature's skins will take damage.

|-
| LEATHER_IGNITE_POINT
| temperature
| The temperature at which leather made from the creature's skins will burst into flames.

|-
| LEATHER_MELTING_POINT
| temperature
| The temperature at which leather made from the creature's skins will melt away.

|-
| [[Creature_Tokens/SPEC_HEAT|LEATHER_SPEC_HEAT]]
| not a temperature
| The difference in temperature required to modify the temperature of the creature's leather? {{verify}}

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

|-
| LIKES_FIGHTING
|
|

|-
| 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. Implies [TRAPAVOID]

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

|}

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

|-
| MAGICAL
|
| Allows a creature to use magic? However, magic isn't implemented yet.

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

|-
| MALE
|
| The creature is always male.

|-
| MATERIAL
|
* [[Matgloss_tokens|Matgloss token]]
* USE_RACEGLOSS
|

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

|-
| MAXAGE
|
* minimum
* maximum
| Sets the Min Max age for a creature. Used in world generating and Fortress Mode.
[MAXAGE:150:170]

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

|-
| MEGABEAST
|
| Appears on fortress territory in Fortress Mode occasionally. Implies SEMIMEGABEAST.

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

|-
| MILKABLE
| frequency?
| Allows the creature to be milked. Currently only works with vermin creatures.

|-
| MISCHIEVIOUS
|
| Will pull any levers it comes across. (requires confirmation)

|-
| MODVALUE
| number
| Multiplies the value of items made from the creature by the number in the tag.
[MODVALUE:2]

|-
| MOUNT
|
| Allows the creature to be mounted.

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

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

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

|}

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

|-
| NAME
|
* singular noun
* plural noun
* adjective
| What the creature is actually called in game. Make sure there is no space around the ":".
[NAME:dwarf:dwarves:dwarven]

|-
| NARROW
|
| The creature can only wear things that have the narrow tag on it.

|-
| NATURAL
|
| Animal

|-
| NO_AUTUMN
|
| Will not show up during the Autumn season.

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

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

|-
| NO_GENDER
|
| No gender will be selected for the creature.

|-
| NO_SLEEP
|
| Creature does not need to sleep.

|-
| NO_SPRING
|
| Will not show up during the Spring season.

|-
| NO_SUMMER
|
| Will not show up during the Summer season.

|-
| NO_WINTER
|
| Will not show up during the Winter season.

|-
| NOBREATHE
|
| Creature doesn't need to breathe or have [BREATHE] parts in body. Cannot drown or be strangled.

|-
| NOBLEED
|
| Creature doesn't bleed.

|-
| NOBONES
|
| Creature will not drop bones on butcher, rot, or decay of severed body parts.

|-
| 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
|
| Creatures' corpse does not create miasma.

|-
| NOSTUCKINS
|
| Weapons can't be stuck in creature.

|-
| NOSTUN
|
| Creature can't be stunned.

|-
| NOTHOUGHT
|
| Creature doesn't think, or doesn't require a [BRAIN] body part.

|-
| NOT_BUTCHERABLE
|
| Creature can't be butchered.

|}

==P==
{| {{prettytable}}
|- bgcolor="#ddd"
! width="20%" | Token
! width="20%" | Arguments
! width="60%" | Description

|-
| PARALYZEIMMUNE
|
| The creature is immune to all paralyzing special attacks.

|-
| PATTERNFLIER
|
| Flies in a semi-predictable pattern? {{verify}}

|-
| 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 greater than the penetrate power, their contents escape for the time being. Other objects roll a 0-99.

|-
| PERSONALITY
|
* token
* lowest % chance
* median
* highest % chance
| Determines chance of personality traits. Standard is 0:50:100. See [[Personality traits]] for more info.
[PERSONALITY:IMAGINATION:0:55:100]

|-
| 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:42]

|-
| POPULATION_NUMBER
|
* minimum
* maximum
| The minimum/maximum numbers of how many of these creatures can show up on a map per year.
[POPULATION_NUMBER:42:42]

|-
| POWER
|
| Allows the creature to be worshiped by entities with the RELIGION:ANY_APPROPRIATE_POWER tag.

|-
| PREFSTRING
| object
| Sets what other creatures like about this creature. "Blarghh likes dwarves for their beards."
[PREFSTRING:beards]
Multiple entries will be chosen from at random.

|}

==R==
{| {{prettytable}}
|- bgcolor="#ddd"
! width="20%" | Token
! width="20%" | Arguments
! width="60%" | Description

|-
| REMAINS
| <''singular''>:<''plural''>
| ??? Used by treants along with [REMAINS_UNDETERMINED], appears to change the name of a creatures remains.

|-
| REMAINS_COLOR
|
* fg
* bg
* br
| The color of the creature's remains. Used by treants.

[REMAINS_COLOR:6:0:0]
|-
| REMAINS_UNDETERMINED
|
|

|}

==S==
{| {{prettytable}}
|- bgcolor="#ddd"
! width="20%" | Token
! width="20%" | Arguments
! width="60%" | Description

|-
| SAVAGE
|
| Determines whether creature can show up on "savage" maps.

|-
| SEMIMEGABEAST
|
| Appears as boss creature in quests.

|-
| SESSILE_LAND
|
| Obsolete. Use [[#I|[IMMOBILE_LAND]]].

|-
| SEVERONBREAKS
|
| Limbs and body parts sever on breakage.

|-
| SILK_BOILING_POINT
| temperature
| Temperature at which silk made from this creature's webs boils away.

|-
| SILK_COLDDAM_POINT
| temperature
| Temperature at which silk made from this creature's webs takes damage.

|-
| SILK_FIXED_TEMP
| temperature
| Temperature generated by the creature's web silk.

|-
| SILK_HEATDAM_POINT
| temperature
| Temperature at which silk made from this creature's webs takes damage.

|-
| SILK_IGNITE_POINT
| temperature
| Temperature at which silk made from this creature's webs bursts into flame.

|-
| SILK_MELTING_POINT
| temperature
| Temperature at which silk made from this creature's webs melts away.

|-
| [[Creature_Tokens/SPEC_HEAT|SILK_SPEC_HEAT]]
| not a temperature
| The difference in temperature required to modify the temperature of the creature's silk? {{verify}}

|-
| SIZE
| value
| How big a creature is. 6 is for dwarf like creatures, 7 is for human like creatures. 16 is for giants. Larger creatures are far more dangerous in combat. Also equals the amount of Meat/Chunks/Bones you get from the beast.
[SIZE:6]

|-
| SLOW_LEARNER
|
| Presumably similar to [CAN_LEARN], but slower. Present in the entries for ogres and giants

|-
| SMALLAQUATIC_CAVERIVER
|
|

|-
| SMALLAQUATIC_OCEAN
|
|

|-
| SMALLAQUATIC_RIVER
|
|

|-
| SMALLAQUATIC_SWAMP
|
|

|-
| SMALL_REMAINS
|
| If a creature has this token, it'll leave a small corpse that only rots once, such as vermin.

|-
| SPECNAME
|
*token
*singular noun
*plural noun
*adjective
| Sets a special name for certain instances.
[SPECNAME:MALE:bull:bulls:bull]

|-
| [[Creature_Tokens/SPEC_HEAT|SPEC_HEAT]]
| not a temperature
| The specific heat of a creature? {{verify}}
[SPEC_HEAT:409]

|-
| SPEECH
| filename
| Sets what speech.txt to use for the creature.
[SPEECH:dwarf.txt]

|-
| SPEECH_MALE
| filename
| Used in place of [SPEECH] for humans; perhaps sets the speech.txt to use for males only? Humans don't have a corresponding [SPEECH_FEMALE] token, though, which only occurs in the [[string dump]].
[SPEECH_MALE:human_male.txt]

|-
| SPEED
| value
| Sets the creatures' movement and work speed, 1000/[100 + SPEED X] is the resulting effect on creatures movement and workrates from default. See [[Speed]] for more information.
[SPEED:400]

|-
| SPHERE
|
| Sets what religious spheres the creature is aligned to, for purposes of being worshiped via the [POWER] token. By default, only used by [[Demon|hidden fun stuff]].

|-
| STOUT
|
| Creature has a resistance to being knocked over.

|-
| STANDARD_FLESH
|
|

|-
| 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 must learn to swim. Requires [CAN_LEARN], obviously.

|-
| SWIM_SPEED
| value
| How fast the creature swims.

|}

==T==
{| {{prettytable}}
|- bgcolor="#ddd"
! width="20%" | Token
! width="20%" | Arguments
! width="60%" | Description

|-
| THICKWEB
|
| The creature's webs can catch larger creatures.

|-
| TILE
| CP437 ordinal or 'character'
| The graphical representation of the creature.
[TILE:157] or [TILE:'&']

|-
| TRADE_CAPACITY
| weight
| How much the creature can carry when used by merchants.
[TRADE_CAPACITY:2000]

|-
| TRAINABLE
|
| Allows a tame creature to be trained into a "War" or "Hunting" variation by way of [[Kennels]].

|-
| TRANCES
|
| Allows the creature to go into martial trances.

|-
| TRAPAVOID
|
| The creature is immune to traps.

|-
| TRIGGERABLE_GROUP
|
* minimum?
* maximum?
| [TRIGGERABLE_GROUP:5:50]

|}

==U==
{| {{prettytable}}
|- bgcolor="#ddd"
! width="20%" | Token
! width="20%" | Arguments
! width="60%" | Description

|-
| UNDERSWIM
|
| Creature swims under the water and can't be seen.
|-
| UTTERANCES
|
| Changes the language of the creature into an unintelligible mess.

|}

==V==
{| {{prettytable}}
|- bgcolor="#ddd"
! width="20%" | Token
! width="20%" | Arguments
! width="60%" | Description

|-
| VEGETATION
|
|

|-
| VERMINHUNTER
|
| A creature with this tag will hunt down vermin and kill them. Sometimes they will eat the vermin, but most of the time they will bring it to their owner. This tag also makes impossible to assign an owner to the animal. The animal chooses it's own owner instead (like a cat). If assigned to a playable race, members of that race will ONLY be able to eat vermin.

|-
| VERMIN_BITE
|
* amount injected?
* name
* effect (USE_EXTRACT)
| [VERMIN_BITE:10:bitten:USE_EXTRACT]
On very rare occasions, someone who remains in the same tile as this creature will be bitten by that creature, and the effect will be applied to the offender. Used by (tiny) cave spiders to inject their venom into the occasional dwarf.

|-
| VERMIN_EATER
|
| The creature can eat your food.

|-
| 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. – [[User:Peristarkawan|Peristarkawan]] 17:27, 24 May 2007 (EDT)

|-
| VERMIN_HATEABLE
|
| Some dwarves will hate the creature and get unhappy thoughts when around it.

|-
| VERMIN_NOFISH
|
| The creature cannot be caught by fishing.

|-
| VERMIN_NOROAM
|
| The creature will not be observed randomly roaming about the map.

|-
| VERMIN_NOTRAP
|
| The creature cannot be caught by trappers or animal traps.

|-
| 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.

|-
| VESPERTINE
|
| Sets if the creature is active in evening.

|-
| VIEWRANGE
| value
| How far the creature can see?

|}

==W==
{| {{prettytable}}
|- bgcolor="#ddd"
! width="20%" | Token
! width="20%" | Arguments
! width="60%" | Description

|-
| WAGON_PULLER
|
| Allows the creature to pull caravan wagons.

|-
| WEBBER
|
| The creature will create webs. It also seems to make creatures flying. More testing is needed.

|-
| WEBIMMUNE
|
| The creature will not get caught in webs.

|}

=Attacks=
{| {{prettytable}}
|- bgcolor="#ddd"
!width="50"|Tag
!width="225"|What It Does

|-
|[ATTACK:MAIN:BYTYPE:GRASP:punch:punches:1:2:BLUDGEON][ATTACKFLAG_WITH]

''Format:''
[ATTACK:''priority'':(BYTYPE:''type'' || BYTOKEN:''bodypart''):''"verb"'':''"conjugate verb"'':''min dmg'':''max dmg'':''dmg type'']([(ATTACKFLAG_WITH || ATTACKFLAG_CANLATCH)])([SPECIALATTACK_INJECT_EXTRACT:''min'':''max''])
|Sets what natural attacks a creature has.

|-
|MAIN
SECOND
|''MAIN'': Sets the attack to act as the creatures' main attack.
''SECOND'': The creature will only use this attack if it can't use the MAIN attack(s).

|-
|BYTYPE:GRASP
BYTOKEN:TAIL_STINGER
|''BYTYPE'': Sets what body part type to use for the attack. Possible values for "type" are GRASP, MOUTH, STANCE, THOUGHT, BREATHE, and the like. See [[Body Tokens]].
''BYTOKEN'': Sets the explicit body part ID to use for the attack. The token must exist as part of the creature's [[Creature Tokens#B|BODY]] token.

|-
|punch:punches
|Sets the verb for the attack.

|-
|1:2
|Sets the Min Max for the damage.

|-
|BLUDGEON, PIERCE, SLASH, GORE, BURN, HEAT, COLD
|Sets the damage type for the attack.

|-
|[ATTACKFLAG_WITH]
|Attacks in combat inform which body part was used in the attack.
"Ratman punches Blargg with his right hand."

|-
|[ATTACKFLAG_CANLATCH]
|Allows the creature to latch on with the attack. "Crocodile latches on Blargg's head firmly."

|-
|[SPECIALATTACK_INJECT_EXTRACT:50:100]
|The creature injects an amount of its extract into a victim upon successfully using this attack. The significance of the amount is unknown (but probably determines duration before the extract wears off).

|-
|[SPECIALATTACK_SUCK_BLOOD:50:100]
|When blood is drained from a creature, it causes heavy bleeding (depending on the attacking creatures ability to suck blood). It's unknown if blood suckers feed or regain health while doing this. (Numbers affect amount of blood drawn?)
|}

[[Category:Modding]]
[[Category:Tokens]]

40d:Creature token

2009-04-08T01:10:07Z

Darekun: /* S */ Added [SPEECH_MALE], documented bug re [SWIMS_INNATE], explained needs-ver on [SPHERE], and changed [SPEED] to match speed.

Everything here can be applied to all creature files, e.g. creature_domestic, creature_standard, even creature_equipment.

Since the game is in the Alpha stage, consider everything '''tentative'''.

{| id="toc"
|
* Tokens
** [[#A|A]] [[#B|B]] [[#C|C]] [[#D|D]] [[#E|E]] [[#F|F]] [[#G|G]] [[#H|H]] [[#I|I]] [[#J|J]] [[#K|K]] [[#L|L]] [[#M|M]]
** [[#N|N]] [[#O|O]] [[#P|P]] [[#Q|Q]] [[#R|R]] [[#S|S]] [[#T|T]] [[#U|U]] [[#V|V]] [[#W|W]] [[#X|X]] [[#Y|Y]] [[#Z|Z]]
|}
__NOTOC__

=Tokens=
==A==
{| {{prettytable}}
|- bgcolor="#ddd"
! width="20%" | Token
! width="20%" | Arguments
! width="60%" | Description

|-
| ADD_VERSION
| version
| In which version of the game said creature was introduced. Not used anymore in the 3D version.
[ADD_VERSION:1069]

|-
| 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/MATUTINAL, rather than implying them.

|-
| ALTTILE
| [[Character Table|CP437 ordinal]] or 'character'
| If set, the creature will blink between its [TILE] and its [ALTTILE].
[ALTTILE:157] or [ALTTILE:'&']

|-
| AMBUSHPREDATOR
|
| Makes the creature start out hidden. Used by giant cave spiders. May make webs hidden too?

|-
| AMPHIBIOUS
|
| Allows a creature to breathe with or without water.

|-
| AQUATIC
|
| Allows a creature to breathe underwater, but causes it to "drown" out of water.

|-
| ATTACK
|
| See the [[#Attacks|Attacks section]].

|}

==B==
{| {{prettytable}}
|- bgcolor="#ddd"
! width="20%" | Token
! width="20%" | Arguments
! width="60%" | Description

|-
| BABY
| age
| Age at which a baby becomes a child. Without this tag, all creatures born will skip the baby stage and be children upon birth.
[BABY:1]

|-
| BEACH_FREQUENCY
| value
| Whales and jellyfish have this. Controls the beaching frequency of the creature.
[BEACH_FREQUENCY:10]

|-
| BENIGN
|
| Determines whether creature can show up on "tame" maps (includes [[Elephants|elephants]]), which will generally avoid dwarves, although they may chase and/or attack them if they get too close).

|-
| BIOME:*
|
| See [[Biome Tokens|biome tokens]].

|-
| BLOODTYPE
| type
| Sets the creatures' blood type (default red):
*R - Red blood
*G - Green blood
*B - Blue blood
*M - Magenta blood
*C - Cyan blood
*Y - Yellow pus
*W - White ichor
*0 - Black goo
*VOMIT
*SLIME
[BLOODTYPE:0]

|-
| [[Body_tokens|BODY]]
| parts[:...]
| Sets the body parts a creature has. Can supply as many as you want.
[BODY:HUMANOID:2EYES:2EARS]

|-
| [[Bodygloss|BODYGLOSS]]
| gloss
| A body_default.txt function. It replaces a part's description with another. e.g. feet with hooves.
[BODYGLOSS:HOOF]

|-
| BOILING_POINT
| temperature
| The temperature at which the creature boils into goo. [[Temperature scale|DF temperature scale]]

|-
| BONE_BOILING_POINT
| temperature
| The boiling point of the creature's bones.

|-
| BONE_COLDDAM_POINT
| temperature
| The low temperature at which the creature's bones start getting damaged.

|-
| BONE_FIXED_TEMP
| temperature
| The temperature that the creature's bones give off.

|-
| BONE_HEATDAM_POINT
| temperature
| The high temperature where the bones start taking damage.

|-
| BONE_IGNITE_POINT
| temperature
| The temperature at which point the creature's bones burst into flame.

|-
| BONE_MELTING_POINT
| temperature
| The temperature at which the creature's bones melt.

|-
| [[Creature_Tokens/SPEC_HEAT|BONE_SPEC_HEAT]]
| not a temperature
| Specific heat? (temperature difference required to change the temperature of the creature's bones?) {{verify}}

|-
| BONECARN
|
| Creature 'eats' bones. Eating bones makes their happiness go up, but can cause death (suffocation). This tag implies CARNIVORE.

|-
| BUILDINGDESTROYER
| value
| Allows a creature to destroy furniture and buildings. Creatures with BUILDINGDESTROYER will actively seek out your constructions and destroy them. A creature can have this value at 1 or 2. When the value is 1, the creature will go after wooden hatches, wooden doors, supports, statues, windows and archery targets only. They can't destroy homes during world gen as (semi)megabeasts.
When the value is 2 the creature will actively seek out most (all?) constructions and destroy them. They can also destroy buildings during world-gen with this tag. Megabeasts rely on this token for their pathing when attacking your fort.
[BUILDINGDESTROYER:2]

|-
| BUTCHERABLE_NONSTANDARD
|
| (old) If a creature has this tag, it may only be slaughtered (that is, the live creature is taken to the [[Butcher's Shop]] and slain). If it dies of any other cause, the corpse cannot be butchered.

|}

==C==
{| {{prettytable}}
|- bgcolor="#ddd"
! width="20%" | Token
! width="20%" | Arguments
! width="60%" | Description

|-
| CAN_CIV
|
| Can create civilizations. This tag may activate hunger and thirst. {{verify}}

|-
| CAN_LEARN
|
| A creature with this tag can gain skill experience.

|-
| CAN_SPEAK
|
| Can talk.

|-
| CANNOT_UNDEAD
|
| Cannot become undead.

|-
| CARNIVORE
|
| Creature only eats meat.

|-
| CANOPENDOORS
|
| Allows the creature to open doors.

|-
| CAVE_ADAPT
|
| Gives the creature a bonus in caves. Also causes [[Cave adaptation]].

|-
| CHEESE_BOILING_POINT
| temperature
| The temperature at which the creature's cheese (if any) boils away.

|-
| CHEESE_COLDDAM_POINT
| temperature
| The temperature at which the creature's cheese (if any) starts taking cold damage.

|-
| CHEESE_FIXED_TEMP
| temperature
| The temperature emitted by one unit of the creature's cheese (if any).

|-
| CHEESE_HEATDAM_POINT
| temperature
| The temperature at which the cheese made from the creature's milk starts taking heat damage.

|-
| CHEESE_IGNITE_POINT
| temperature
| The temperature at which the creature's cheese bursts into flame.

|-
| CHEESE_MELTING_POINT
| temperature
| The temperature at which the creature's cheese melts into goo.

|-
| [[Creature_Tokens/SPEC_HEAT|CHEESE_SPEC_HEAT]]
| not a temperature
| Specific heat? (temperature difference required to change the temperature of the creature's cheese?) {{verify}}

|-
| CHEESE_VALUE
| value
| The value per unit of cheese made from the creature's milk (if applicable). Note that only vermin as of current can be milked.

|-
| CHILD
| age
| Age at which a child becomes an adult.
[CHILD:12]

|-
| CHILDNAME
|
* singular
* plural
| Gives the child a special name, eg "hippo calf" instead of "hippo child".
[CHILDNAME:hippo calf:hippo calves]

|-
| CHITIN
|
| When the creature is butchered, it drops chitin, which functions as leather.

|-
| CRAFTSMAN_NAME
|
* singular
* plural
| Sets the name of the craftsman profession.
[CRAFTSMAN_NAME:craftsdwarf:craftsdwarves]

|-
| CREPUSCULAR
|
| Sets if the creature is active in twilight.

|-
| CLUSTER_NUMBER
|
* minimum
* maximum
| The minimum/maximum numbers of how many creatures per spawned cluster.
[CLUSTER_NUMBER:1:3]

|-
| COLOR
|
* fg (foreground)
* bg (background)
* br (brightness)
| [[Color]] of the creature's tile.
[COLOR:3:0:0]

|-
| COOKABLE_LIVE
|
| Set this to allow the creature to be cooked in meals without having to butcher it first.

|-
| CREATURE
| name
| What the game looks for when generating creatures.
[CREATURE:DWARF]

|-
| COLDDAM_POINT
| temperature
| The minimum temperature limit before the creature starts taking damage from freezing.

|-
| 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

|-
| CURIOUSBEAST_EATER
|
| Allows a creature to eat edible items that it finds? (may imply CURIOUSBEAST_ITEM?) {{verify}}

|-
| CURIOUSBEAST_ITEM
|
| Allows a creature to steal things (usually [[food]]?).

|-
| CURIOUSBEAST_GUZZLER
|
| Will steal [[alcohol]]? Implies CURIOUSBEAST.

|}

==D==
{| {{prettytable}}
|- bgcolor="#ddd"
! width="20%" | Token
! width="20%" | Arguments
! width="60%" | Description

|-
| DAMBLOCK
| value
| How much natural armor a creature has. Can be set to negative numbers, so the creature takes more damage than usual.
[DAMBLOCK:1]

|-
| DEFENDER
|
| Appears from the glowing pits in a group.

|-
| DIFFICULTY
| number
| [[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.
[DIFFICULTY:2]

|-
| DIURNAL
|
| Sets if the creature is active in day.

|-
| DRAGONFIREBREATH
|
| Creature breathes fire in a cone.

|-
| DRINK_BOILING_POINT
| temperature
| The temperature at which a drink (milk?) produced from the creature will boil.

|-
| DRINK_COLDDAM_POINT
| temperature
| The temperature at which said drink will take cold damage.

|-
| DRINK_FIXED_TEMP
| temperature
| The temperature emitted by one unit of the creature's drink (if any).

|-
| DRINK_HEATDAM_POINT
| temperature
| The temperature at which aforementioned drink will take heat damage.

|-
| DRINK_IGNITE_POINT
| temperature
| The temperature at which the drink will set your fort ablaze.

|-
| DRINK_MELTING_POINT
| temperature
| [[User:GreyMario]] sez: "Isn't this, like, redundant? It's ''already'' liquid. Perhaps it controls at which point the drink solidifies?" {{verify}}

|-
| [[Creature_Tokens/SPEC_HEAT|DRINK_SPEC_HEAT]]
| not a temperature
| The difference in temperature required to modify the temperature of the drink? {{verify}}

|}

==E==
{| {{prettytable}}
|- bgcolor="#ddd"
! width="20%" | Token
! width="20%" | Arguments
! width="60%" | Description

|-
| ENDING
|
| Will show up as a leader (only one of them) in a group from the glowing pits.

|-
| EQUIPMENT_WAGON
|
| Implies two unknown flags, NOSTUN, NONAUSEA, NOBLEED, NOEMOTION, NOSTUCKINS, SEVERONBREAKS, NOSKULL, NOSKIN, NOBONES, NOMEAT, PARALYZEIMMUNE, NOFEAR, NOSMELLYROT, NOTHOUGHT, NO_GENDER.

|-
| EQUIPS
|
| Allows the creature to wear or wield items.

|-
| EVIL
|
| Determines whether creature can show up on "evil" maps (see [[Creatures#Threat Matrix|Threat Matrix]]).

|-
| EXTRACT
|
* name
* value
* ? (always 0)
* ? (0 on venoms exception: giant desert scorpion venom)
| Determines what can be extracted from the creature, what it's called, how valuable it is, and what you can make from it. Note, it appears that the extraction process is hardcoded into the game, and can't be altered from objects/raw.
[EXTRACT:cow's milk:7:0:1]

|-
| EXTRACT_ANTIDOTE
|
* name
* value
* ? (always 0)
* ? (always 0)
* ? (always 50 or 100)
| [EXTRACT_ANTIDOTE:cave spider antivenin:7:0:0:50]

|-
| EXTRACT_BOILING_POINT
| temperature
| The temperature value at which a unit of the creature's extract boils away.

|-
| EXTRACT_CHEESE
|
* name
* value
* ?
* ?
| The extract gotten from the creature is a unit of cheese.
[EXTRACT_CHEESE:cow cheese:6:0:1]

|-
| EXTRACT_COOKABLE
|
| Extract is cookable.

|-
| EXTRACT_COLDDAM_POINT
| temperature
| The low temperature value at which the creature's extract starts to take damage.

|-
| EXTRACT_FIXED_TEMP
| temperature
| The temperature that the creature's extract generates on its own.

|-
| EXTRACT_HEATDAM_POINT
| temperature
| The high temperature value at which the creature's extract starts to take damage.

|-
| EXTRACT_IGNITE_POINT
| temperature
| The temperature at which the creature's extract bursts into flame (NOT the container it's in).

|-
| EXTRACT_MELTING_POINT
| temperature
| The temperature at which the creature's extract melts into goo.

|-
| EXTRACT_PARALYZE
|
| (conjectural) Extract is poisonous, causing paralysis that lasts until the extract wears off. Can be delivered by SPECIALATTACK_INJECT_EXTRACT.

|-
| EXTRACT_PARALYZE_INTERMITTENT
|
| (conjectural) Extract is poisonous, causing paralysis on occasional intervals until the extract wears off. Can be delivered by SPECIALATTACK_INJECT_EXTRACT.

|-
| EXTRACT_PERMANENT
|
| (conjectural) The effects of the creature's extract are permanent once applied and do not wear off naturally.

|-
| EXTRACT_SIZE
| size
|
[EXTRACT_SIZE:10]

|-
| [[Creature_Tokens/SPEC_HEAT|EXTRACT_SPEC_HEAT]]
| not a temperature
| The difference in temperature required to modify the temperature of the creature's extract? {{verify}}

|-
| EXTRACT_STUN
|
| (conjectural) Extract is poisonous, causing a permanent stun effect until the extract wears off. Can be delivered by SPECIALATTACK_INJECT_EXTRACT.

|-
| EXTRACT_STUN_INTERMITTENT
|
| (verified) Extract is poisonous, causing temporary stuns on semi-occasional intervals. Can be delivered by SPECIALATTACK_INJECT_EXTRACT.

|-
| EXTRACT_VALUE
| value
| The value per unit of the creature's extract.
[EXTRACT_VALUE:20]

|-
| EXTRAVISION
|
| Creature has enhanced vision (longer vision range, ie. at night).

|}

==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.

|-
| FAT
| value
| How much fat a creature produces when it is butchered.
[FAT:3]

|-
| FEMALE
|
| The creature is always female.

|-
| FIREBREATH
|
| The creature breathes fire projectiles (as opposed to DRAGONFIREBREATH, which is in a cone).

|-
| FIREIMMUNE
|
| The creature is immune to all forms of fire, except DRAGONFIREBREATH.

|-
| FIREIMMUNE_SUPER
|
| The creature is immune to DRAGONFIREBREATH. AI acts as if FIREIMMUNE. Does NOT imply FIREIMMUNE.

|-
| FISHITEM
|
| Needs to be cleaned at a fishery.

|-
| FIXED_TEMP
| temperature
| The natural heat generated by the creature. [FIXED_TEMP:1-?]

|-
| FLEEQUICK
|
| Determines how soon a creature flees in a losing battle.

|-
| FLIER
|
| Allows a creature to fly.

|-
| FREQUENCY
| time
| Determines the time between creature spawns in Fortress Mode. Higher is more occurences per time unit{{verify}}. Creatures without a frequency statement appear to be on the map at all times. Almost all others have [FREQUENCY:5].
[FREQUENCY:42]

|}

==G==
{| {{prettytable}}
|- bgcolor="#ddd"
! width="20%" | Token
! width="20%" | Arguments
! width="60%" | Description

|-
| GENPOWER
| rate?
| Not used anymore and can be removed safely. Was related to magic.
[GENPOWER:3]

|-
| GLOWCOLOR
|
* fg
* bg
* br
| The colour of the GLOWTILE of the creature (see below).

[GLOWCOLOR:4:0:1]

|-
| 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.

[GLOWTILE:'"']

|-
| GNAWER
|
| The creature chews on food storage containers.

|-
| GOOD
|
| Determines whether creature can show up on "good" maps (see [[Creatures#Threat Matrix|Threat Matrix]]).

|-
| GRASSTRAMPLE
| amount
| Determines the percentage chance of trampling and killing grass when a creature steps on it. Set [GRASSTRAMPLE:0] to make grass never trampled by the creature.
[GRASSTRAMPLE:42]

|}

==H==
{| {{prettytable}}
|- bgcolor="#ddd"
! width="20%" | Token
! width="20%" | Arguments
! width="60%" | Description

|-
| HAS_RACEGLOSS
| gloss
| Links a material glossary to the creature. It is hardcoded, and there is only 4 types of tag.
[HAS_RACEGLOSS:WOOD]
[HAS_RACEGLOSS:STONE]
[HAS_RACEGLOSS:METAL]
[HAS_RACEGLOSS:PLANT]

|-
| HASSHELL
|
| Creature will leave behind a shell when eaten.

|-
| HEATDAM_POINT
| temperature
| The maximum temperature limit before the creature will start recieving damage from heat. [[Temperature scale|DF temperature scale]]

|-
| HOMEOTHERM
| value
| Default 'NONE'. The creature's normal body temperature. Combined with LAYERING, sets the temperature range under which it can live. [[Temperature scale|DF temperature scale]]

|-
| HORN
|
| Creature drops a horn or horns when butchered, which presumably acts like bone. This tag is broken.

|}

==I==
{| {{prettytable}}
|- bgcolor="#ddd"
! width="20%" | Token
! width="20%" | Arguments
! width="60%" | Description

|-
| IGNITE_POINT
| temperature
| The temperature at which the creature will burst into flames. [[Temperature scale|DF temperature scale]]

|-
| IMMOLATE
|
| Will ignite, and potentially completely destroy, items the creature is standing on. Keep booze away from critters with this tag.

|-
| IMMOBILE_LAND
|
| The creature is immobile while on land

|-
| INTELLIGENT
|
| Implies CAN_CIV, CAN_SPEAK, CAN_LEARN.

|-
| ITEMCORPSE
|
* [[Item Tokens|item token]]
* subtype
NO_SUBTYPE
* [[Matgloss_tokens|matgloss token]]
* NO_RACEGLOSS
USE_RACEGLOSS
USE_SHARPSTONE
| Determines if the creature leaves behind a non-standard corpse (i.e. wood, statue, bars, etc). The first parameter determines the item type; the second parameter is the subtype indicated in the raw file (such as WEAPON_WHIP); the third indicates the material type if the item type takes a specific material (e.g. "IRON" if the corpse type is "STATUE"). USE_RACEGLOSS applies if the creature has a material glossary assigned by the "HAS_RACEGLOSS:" flag and will select neccesary adjectives and material from that glossary.
[ITEMCORPSE:[[Item Tokens|WOOD]]:NO_SUBTYPE:[[Material Tokens|WOOD]]:USE_RACEGLOSS]

|-
| ITEMCORPSE_QUALITY
| quality
| The quality of an item-type corpse left behind; 5 is masterpiece-level.
[ITEMCORPSE_QUALITY:5]

|-
| IVORY
|
| Creature will produce ivory when butchered. Currently doesn't work.

|}

==L==
{| {{prettytable}}
|- bgcolor="#ddd"
! width="20%" | Token
! width="20%" | Arguments
! width="60%" | Description

|-
| LARGE_CAVERIVER
|
| In Fortress Mode, spawns from/near cave rivers.

|-
| LARGE_CHASM
|
| In Fortress Mode, spawns from/near chasms.

|-
| LARGE_LAVA
|
| In Fortress Mode, spawns from/near magma.

|-
| 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.

|-
| LAYERING
| value
| How well-protected the creature is from low temperatures. If this number is too high, it will confine a creature to only arctic areas. If it is even higher it will prevent the creature from spawning at all.

|-
| LEATHER_BOILING_POINT
| temperature
| The temperature at which leather made from the creature's skins will boil away.

|-
| LEATHER_COLDDAM_POINT
| temperature
| The temperature at which leather made from the creature's skins will take damage.

|-
| LEATHER_FIXED_TEMP
| temperature
| The temperature that leather made from the creature's skins generates.

|-
| LEATHER_HEATDAM_POINT
| temperature
| The temperature at which leather made from the creature's skins will take damage.

|-
| LEATHER_IGNITE_POINT
| temperature
| The temperature at which leather made from the creature's skins will burst into flames.

|-
| LEATHER_MELTING_POINT
| temperature
| The temperature at which leather made from the creature's skins will melt away.

|-
| [[Creature_Tokens/SPEC_HEAT|LEATHER_SPEC_HEAT]]
| not a temperature
| The difference in temperature required to modify the temperature of the creature's leather? {{verify}}

|-
| LIGHT_GEN
|
| The creature will generate light, such as in adventurer mode at night.

|-
| LIKES_FIGHTING
|
|

|-
| 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. Implies [TRAPAVOID]

|-
| LOOSE_CLUSTERS
|
| The creatures will scatter if they have this tag, or form tight packs if they don't.

|}

==M==
{| {{prettytable}}
|- bgcolor="#ddd"
! width="20%" | Token
! width="20%" | Arguments
! width="60%" | Description

|-
| MAGICAL
|
| Allows a creature to use magic? However, magic isn't implemented yet.

|-
| MAGMA_VISION
|
|Creature's able to see while covered in magma.

|-
| MALE
|
| The creature is always male.

|-
| MATERIAL
|
* [[Matgloss_tokens|Matgloss token]]
* USE_RACEGLOSS
|

|-
| MATUTINAL
|
| Sets if the creature is active in dawn.

|-
| MAXAGE
|
* minimum
* maximum
| Sets the Min Max age for a creature. Used in world generating and Fortress Mode.
[MAXAGE:150:170]

|-
| MEANDERER
|
| Gives a creature random movement.

|-
| MEGABEAST
|
| Appears on fortress territory in Fortress Mode occasionally. Implies SEMIMEGABEAST.

|-
| MELTING_POINT
| temperature
| The temperature at which the creature will melt into goo.

|-
| MILKABLE
| frequency?
| Allows the creature to be milked. Currently only works with vermin creatures.

|-
| MISCHIEVIOUS
|
| Will pull any levers it comes across. (requires confirmation)

|-
| MODVALUE
| number
| Multiplies the value of items made from the creature by the number in the tag.
[MODVALUE:2]

|-
| MOUNT
|
| Allows the creature to be mounted.

|-
| MOUNT_EXOTIC
|
| You need the [[Dungeon master]] noble to mount the creature.

|-
| MULTIPLE_LITTER_RARE
|
| Makes litters with more than one offspring rare.

|-
| MUNDANE
|
| Marks if the creature is an actual real-life creature. Only used for age-names at present.

|}

==N==
{| {{prettytable}}
|- bgcolor="#ddd"
! width="20%" | Token
! width="20%" | Arguments
! width="60%" | Description

|-
| NAME
|
* singular noun
* plural noun
* adjective
| What the creature is actually called in game. Make sure there is no space around the ":".
[NAME:dwarf:dwarves:dwarven]

|-
| NARROW
|
| The creature can only wear things that have the narrow tag on it.

|-
| NATURAL
|
| Animal

|-
| NO_AUTUMN
|
| Will not show up during the Autumn season.

|-
| NO_DRINK
|
| Creature does not need to drink.

|-
| NO_EAT
|
| Creature does not need to eat.

|-
| NO_GENDER
|
| No gender will be selected for the creature.

|-
| NO_SLEEP
|
| Creature does not need to sleep.

|-
| NO_SPRING
|
| Will not show up during the Spring season.

|-
| NO_SUMMER
|
| Will not show up during the Summer season.

|-
| NO_WINTER
|
| Will not show up during the Winter season.

|-
| NOBREATHE
|
| Creature doesn't need to breathe or have [BREATHE] parts in body. Cannot drown or be strangled.

|-
| NOBLEED
|
| Creature doesn't bleed.

|-
| NOBONES
|
| Creature will not drop bones on butcher, rot, or decay of severed body parts.

|-
| 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
|
| Creatures' corpse does not create miasma.

|-
| NOSTUCKINS
|
| Weapons can't be stuck in creature.

|-
| NOSTUN
|
| Creature can't be stunned.

|-
| NOTHOUGHT
|
| Creature doesn't think, or doesn't require a [BRAIN] body part.

|-
| NOT_BUTCHERABLE
|
| Creature can't be butchered.

|}

==P==
{| {{prettytable}}
|- bgcolor="#ddd"
! width="20%" | Token
! width="20%" | Arguments
! width="60%" | Description

|-
| PARALYZEIMMUNE
|
| The creature is immune to all paralyzing special attacks.

|-
| PATTERNFLIER
|
| Flies in a semi-predictable pattern? {{verify}}

|-
| 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 greater than the penetrate power, their contents escape for the time being. Other objects roll a 0-99.

|-
| PERSONALITY
|
* token
* lowest % chance
* median
* highest % chance
| Determines chance of personality traits. Standard is 0:50:100. See [[Personality traits]] for more info.
[PERSONALITY:IMAGINATION:0:55:100]

|-
| 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:42]

|-
| POPULATION_NUMBER
|
* minimum
* maximum
| The minimum/maximum numbers of how many of these creatures can show up on a map per year.
[POPULATION_NUMBER:42:42]

|-
| POWER
|
| Allows the creature to be worshiped by entities with the RELIGION:ANY_APPROPRIATE_POWER tag.

|-
| PREFSTRING
| object
| Sets what other creatures like about this creature. "Blarghh likes dwarves for their beards."
[PREFSTRING:beards]
Multiple entries will be chosen from at random.

|}

==R==
{| {{prettytable}}
|- bgcolor="#ddd"
! width="20%" | Token
! width="20%" | Arguments
! width="60%" | Description

|-
| REMAINS
| <''singular''>:<''plural''>
| ??? Used by treants along with [REMAINS_UNDETERMINED], appears to change the name of a creatures remains.

|-
| REMAINS_COLOR
|
* fg
* bg
* br
| The color of the creature's remains. Used by treants.

[REMAINS_COLOR:6:0:0]
|-
| REMAINS_UNDETERMINED
|
|

|}

==S==
{| {{prettytable}}
|- bgcolor="#ddd"
! width="20%" | Token
! width="20%" | Arguments
! width="60%" | Description

|-
| SAVAGE
|
| Determines whether creature can show up on "savage" maps.

|-
| SEMIMEGABEAST
|
| Appears as boss creature in quests.

|-
| SESSILE_LAND
|
| Obsolete. Use [[#I|[IMMOBILE_LAND]]].

|-
| SEVERONBREAKS
|
| Limbs and body parts sever on breakage.

|-
| SILK_BOILING_POINT
| temperature
| Temperature at which silk made from this creature's webs boils away.

|-
| SILK_COLDDAM_POINT
| temperature
| Temperature at which silk made from this creature's webs takes damage.

|-
| SILK_FIXED_TEMP
| temperature
| Temperature generated by the creature's web silk.

|-
| SILK_HEATDAM_POINT
| temperature
| Temperature at which silk made from this creature's webs takes damage.

|-
| SILK_IGNITE_POINT
| temperature
| Temperature at which silk made from this creature's webs bursts into flame.

|-
| SILK_MELTING_POINT
| temperature
| Temperature at which silk made from this creature's webs melts away.

|-
| [[Creature_Tokens/SPEC_HEAT|SILK_SPEC_HEAT]]
| not a temperature
| The difference in temperature required to modify the temperature of the creature's silk? {{verify}}

|-
| SIZE
| value
| How big a creature is. 6 is for dwarf like creatures, 7 is for human like creatures. 16 is for giants. Larger creatures are far more dangerous in combat. Also equals the amount of Meat/Chunks/Bones you get from the beast.
[SIZE:6]

|-
| SLOW_LEARNER
|
| Presumably similar to [CAN_LEARN], but slower. Present in the entries for ogres and giants

|-
| SMALLAQUATIC_CAVERIVER
|
|

|-
| SMALLAQUATIC_OCEAN
|
|

|-
| SMALLAQUATIC_RIVER
|
|

|-
| SMALLAQUATIC_SWAMP
|
|

|-
| SMALL_REMAINS
|
| If a creature has this token, it'll leave a small corpse that only rots once, such as vermin.

|-
| SPECNAME
|
*token
*singular noun
*plural noun
*adjective
| Sets a special name for certain instances.
[SPECNAME:MALE:bull:bulls:bull]

|-
| [[Creature_Tokens/SPEC_HEAT|SPEC_HEAT]]
| not a temperature
| The specific heat of a creature? {{verify}}
[SPEC_HEAT:409]

|-
| SPEECH
| filename
| Sets what speech.txt to use for the creature.
[SPEECH:dwarf.txt]

|-
| SPEECH_MALE
| filename
| Used in place of [SPEECH] for humans; perhaps sets the speech.txt to use for males only? Humans don't have a corresponding [SPEECH_FEMALE] token, though, which only occurs in the [[string dump]].
[SPEECH_MALE:human_male.txt]

|-
| SPEED
| value
| Sets the creatures' movement and work speed, 1000/[100 + SPEED X] is the resulting effect on creatures movement and workrates from default. See [[Speed]] for more information.
[SPEED:400]

|-
| SPHERE
|
| Sets what religious spheres the creature is aligned to, for purposes of being worshiped via the [POWER] token. By default, only used by [[Demon|hidden fun stuff]].

|-
| STOUT
|
| Creature has a resistance to being knocked over.

|-
| STANDARD_FLESH
|
|

|-
| 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 must learn to swim. Requires [CAN_LEARN], obviously.

|-
| SWIM_SPEED
| value
| How fast the creature swims.

|}

==T==
{| {{prettytable}}
|- bgcolor="#ddd"
! width="20%" | Token
! width="20%" | Arguments
! width="60%" | Description

|-
| THICKWEB
|
| The creature's webs can catch larger creatures.

|-
| TILE
| CP437 ordinal or 'character'
| The graphical representation of the creature.
[TILE:157] or [TILE:'&']

|-
| TRADE_CAPACITY
| weight
| How much the creature can carry when used by merchants.
[TRADE_CAPACITY:2000]

|-
| TRAINABLE
|
| Allows a tame creature to be trained into a "War" or "Hunting" variation by way of [[Kennels]].

|-
| TRANCES
|
| Allows the creature to go into martial trances.

|-
| TRAPAVOID
|
| The creature is immune to traps.

|-
| TRIGGERABLE_GROUP
|
* minimum?
* maximum?
| [TRIGGERABLE_GROUP:5:50]

|}

==U==
{| {{prettytable}}
|- bgcolor="#ddd"
! width="20%" | Token
! width="20%" | Arguments
! width="60%" | Description

|-
| UNDERSWIM
|
| Creature swims under the water and can't be seen.
|-
| UTTERANCES
|
| Changes the language of the creature into an unintelligible mess.

|}

==V==
{| {{prettytable}}
|- bgcolor="#ddd"
! width="20%" | Token
! width="20%" | Arguments
! width="60%" | Description

|-
| VEGETATION
|
|

|-
| VERMINHUNTER
|
| A creature with this tag will hunt down vermin and kill them. Sometimes they will eat the vermin, but most of the time they will bring it to their owner. This tag also makes impossible to assign an owner to the animal. The animal chooses it's own owner instead (like a cat). If assigned to a playable race, members of that race will ONLY be able to eat vermin.

|-
| VERMIN_BITE
|
* amount injected?
* name
* effect (USE_EXTRACT)
| [VERMIN_BITE:10:bitten:USE_EXTRACT]
On very rare occasions, someone who remains in the same tile as this creature will be bitten by that creature, and the effect will be applied to the offender. Used by (tiny) cave spiders to inject their venom into the occasional dwarf.

|-
| VERMIN_EATER
|
| The creature can eat your food.

|-
| 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. – [[User:Peristarkawan|Peristarkawan]] 17:27, 24 May 2007 (EDT)

|-
| VERMIN_HATEABLE
|
| Some dwarves will hate the creature and get unhappy thoughts when around it.

|-
| VERMIN_NOFISH
|
| The creature cannot be caught by fishing.

|-
| VERMIN_NOROAM
|
| The creature will not be observed randomly roaming about the map.

|-
| VERMIN_NOTRAP
|
| The creature cannot be caught by trappers or animal traps.

|-
| 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.

|-
| VESPERTINE
|
| Sets if the creature is active in evening.

|-
| VIEWRANGE
| value
| How far the creature can see?

|}

==W==
{| {{prettytable}}
|- bgcolor="#ddd"
! width="20%" | Token
! width="20%" | Arguments
! width="60%" | Description

|-
| WAGON_PULLER
|
| Allows the creature to pull caravan wagons.

|-
| WEBBER
|
| The creature will create webs. It also seems to make creatures flying. More testing is needed.

|-
| WEBIMMUNE
|
| The creature will not get caught in webs.

|}

=Attacks=
{| {{prettytable}}
|- bgcolor="#ddd"
!width="50"|Tag
!width="225"|What It Does

|-
|[ATTACK:MAIN:BYTYPE:GRASP:punch:punches:1:2:BLUDGEON][ATTACKFLAG_WITH]

''Format:''
[ATTACK:''priority'':(BYTYPE:''type'' || BYTOKEN:''bodypart''):''"verb"'':''"conjugate verb"'':''min dmg'':''max dmg'':''dmg type'']([(ATTACKFLAG_WITH || ATTACKFLAG_CANLATCH)])([SPECIALATTACK_INJECT_EXTRACT:''min'':''max''])
|Sets what natural attacks a creature has.

|-
|MAIN
SECOND
|''MAIN'': Sets the attack to act as the creatures' main attack.
''SECOND'': The creature will only use this attack if it can't use the MAIN attack(s).

|-
|BYTYPE:GRASP
BYTOKEN:TAIL_STINGER
|''BYTYPE'': Sets what body part type to use for the attack. Possible values for "type" are GRASP, MOUTH, STANCE, THOUGHT, BREATHE, and the like. See [[Body Tokens]].
''BYTOKEN'': Sets the explicit body part ID to use for the attack. The token must exist as part of the creature's [[Creature Tokens#B|BODY]] token.

|-
|punch:punches
|Sets the verb for the attack.

|-
|1:2
|Sets the Min Max for the damage.

|-
|BLUDGEON, PIERCE, SLASH, GORE, BURN, HEAT, COLD
|Sets the damage type for the attack.

|-
|[ATTACKFLAG_WITH]
|Attacks in combat inform which body part was used in the attack.
"Ratman punches Blargg with his right hand."

|-
|[ATTACKFLAG_CANLATCH]
|Allows the creature to latch on with the attack. "Crocodile latches on Blargg's head firmly."

|-
|[SPECIALATTACK_INJECT_EXTRACT:50:100]
|The creature injects an amount of its extract into a victim upon successfully using this attack. The significance of the amount is unknown (but probably determines duration before the extract wears off).

|-
|[SPECIALATTACK_SUCK_BLOOD:50:100]
|When blood is drained from a creature, it causes heavy bleeding (depending on the attacking creatures ability to suck blood). It's unknown if blood suckers feed or regain health while doing this. (Numbers affect amount of blood drawn?)
|}

[[Category:Modding]]
[[Category:Tokens]]

40d Talk:Creature token

2009-04-07T22:21:53Z

Darekun: /* ITEMCORPSE */

==Children==
Does anyone know which tag cause an animal to breed? I believe it's either [CHILD:] or [CHILDNAME:][[User:Moonman|Moonman]] 18:18, 23 July 2008 (EDT)
*[CHILD:?] sets the age that a child becomes an adult, [CHILDNAME:?] sets what children are called, example, calf instead of bull. [[User:i2amroy|i2amroy]] 19 January 2009

== HOW DO I SHOT WEB? ==
first, does [WEBBER] imply the ability to shoot web, make webs or both?
second (assuming the answer to at least one of the above is true), how would one use this in adventure mode?{{user:yrael/sig|DATE=12:45, 14 May 2008 (EDT)}}
*it adds the ability to shoot web, but creatures will only shoot web at other creatures they are hostile to.[[User:Moonman|Moonman]] 18:16, 23 July 2008 (EDT)

== MAGICAL ==

I think this tag was meant for creatures not from natural origin. Its the same as Natural, but elves might react differently to it. 
-Booken 06:22, 26 April 2008 (EST)

== ITEMCORPSE ==

(see [http://www.bay12games.com/cgi-local/ultimatebb.cgi?ubb=get_topic&f=13&t=000602 this forum thread])

[ITEMCORPSE:<type>:<subtype>:<material>:<matgloss>]

Does the sub-type field actually have a use, or is the only option "NO_SUBTYPE"?

Anyway, the USE_RACEGLOSS for the matgloss field seems to only work for some (built-in?) materials. For example, the [[Treant|Treants]] use the entry:
[HAS_RACEGLOSS:WOOD]
[ITEMCORPSE:WOOD:NO_SUBTYPE:WOOD:USE_RACEGLOSS]
[[Treant|Treants]] will appear as "Mahogany treant", "Oak treant", etc.

However, when using a custom matgloss file, this functionality stops working, and treants (and there log remains) are undescriptive. I've tried creating a ''matgloss_treant.txt'' file and adding a few unique entries, like [MATGLOSS_WOOD:FOOBAR_TREE] and [MATGLOSS_WOOD:BAZ_TREE], and editing the [Treant] to:
[HAS_RACEGLOSS:TREANT]
[ITEMCORPSE:WOOD:NO_SUBTYPE:WOOD:USE_RACEGLOSS]
...this doesn't seem to do anything. If I want the [[Treant]] to leave special remains, like my Foobar Tree, I have to change the creature tokens to:
[HAS_RACEGLOSS:TREANT]
[ITEMCORPSE:WOOD:NO_SUBTYPE:WOOD:FOOBAR_TREE]
But here, I can only have "Foobar treants".

:The subtype field has a use for types with subtypes; for example, weapons or vermin. See [[item tokens]] for the few item types that have subtypes.
:The "WOOD" in [HAS_RACEGLOSS:WOOD] isn't a user-definable category; it matches the "WOOD" in MATGLOSS_WOOD. So you could probably set it to [HAS_RACEGLOSS:WOOD], [HAS_RACEGLOSS:STONE], [HAS_RACEGLOSS:METAL], or [HAS_RACEGLOSS:PLANT], but that's it.
:[[User:Darekun|Darekun]] 22:21, 7 April 2009 (UTC)

== PACK_ANIMAL ==

Anybody happen to know anything about the [PACK_ANIMAL] tag? I noticed that [[muskox|muskoxen]], [[mule|mules]] and [[donkey|donkeys]] all share this distinction. I also noticed someone in the [[muskox]] page had said that muskoxen could serve as haulers. Has Toady implemented a tag for animal haulers and sneaked it past everyone? Perhaps they can only perform this function if they serve as a pet to haulers? Or is it simply that merchants can carry goods on them? [[User:Some1else|Some1else]] 01:05, 19 February 2008 (EST)
:It's only merchants, I believe. --[[User:Penguinofhonor|Penguinofhonor]] 21:31, 29 July 2008 (EDT)

== VERMIN_ tags ==

Made a new creature with VERMIN_CHASM and it spit out an unrecognised token message in my errorlog. Can someone confirm these work? Preferrably by pointing to a creature that has them? --[[User:Nunix|Nunix]] 18:57, 16 March 2008 (EDT)

:thats leftover from 2d. bats and such used to have it, but now have a biome tag instead -[[User:Chariot|Chariot]] 19:09, 16 March 2008 (EDT)

::Thanks. Do we know if that applies to any of the others? --[[User:Nunix|Nunix]] 18:29, 22 March 2008 (EDT)

Tried to make a dwarf mode playable race with the [VERMIN_HUNTER] tag, and they went hungry. Took it away and they ate normal food again. Seems that when this tag is in place, the race will ONLY eat vermin. Have noted this in the entry.18:22, 22 November 2008 (EST)

== Litter size ==

I've been testing the [LITTER_SIZE] token, and according to my tests it indeed affects the number of children. I set a creature to have 5-10 litter size and it did indeed produce 6 and 7 children, while another creature had 3-5 and produced 3-5 children. I'm gonna remove the "untested" tag from the wiki, feel free to tell me off if it proves otherwise.--[[IUser:Eurytus|Eurytus]] 23:14, 5 April 2008 (EDT)

== Redirect ==

In conformance with the [[DwarfFortressWiki:Community Portal|Community Portal]], I think this page should be moved to [[Creature tokens]]. It can keep the plural because people are usually concerned with all of the tokens instead of just one. Thoughts? --[[User:JT|JT]] 22:26, 7 April 2008 (EDT)

== defender ==

"DEFENDER Appears from the glowing pits after the magma river."

After the magma river? This seems to be left over from the 2d version, does this token still exist? If so we might want to adjust its description to the newest version
:Yeah, I just noticed that this entire article seems to have been copypasta-ed from the old version and not updated. There's a number of tags listed there that no longer exist, such as all of the RIVERATTACK_* tags. I'll stick an "old" template on the page for now, since it'll take some doing to go through all of the tags and verify that they still exist/do the same thing as they used to. But to answer your specific question, yes, the DEFENDER tag does still exist. It's just the magma river that doesn't. --[[User:Morlark|Morlark]] 12:14, 25 June 2008 (EDT)
::Ok, I've had a bit of a search, and I've removed those tags which I've verified as non-existent. I should stress though that my search was not exhaustive, so it's possible that this article does still contain errors. --[[User:Morlark|Morlark]]

== Body parts ==

It would be nice if there was a list of available body parts, ive been trying to make a new creature and am stuck using dwarven body parts... --[[User:High tech dragon|High tech dragon]] 22:59, 25 September 2008 (EDT)
:[[Body_tokens]] --[[User:Ikkonoishi|Ikkonoishi]] 08:28, 26 September 2008 (EDT)
::There is, of course, always the option to make your own body parts by editing the raws, though. Just make sure ''you know what you doing.'' </ayb> --[[User:GreyMario|GreyMaria]] 16:02, 26 September 2008 (EDT)

== Weapons and sizes ==

I'm curious as to what tags allow or disallow the use of bows or crossbows. It seems like it could be that the stout tag disallows the use of bows, and the narrow disallows the use of crossbows, as I believe the races that have neither tag (humans, goblins) can use both weapons. Anyone confirm/deny/antithesize before I accidentally mess up my raws trying to find out? --[[User:Zombiejustice|Zombiejustice]] 17:20, 6 October 2008 (EDT)
*All that it takes to add or remove the use of bows and crossbows is to add or remove the weapon tag from the entity file. Dwarves can't equip bows at the military screen even if you allow them to use them though, that is hardcoded. --[[User:i2amroy|i2amroy]] 19 January 2009

== Catgirls ==
I'm attempting to put a new creature into the game - specifically, catgirls. They have the COMMON_DOMESTIC token, but won't show up in the embark menu. As directed by the guy who made them, I put the code into the creature_domestic_humanoid.txt and the body parts into body_domestic_humanoid.txt and there aren't any errors on world generation, so I assume the coding is right. Any help for someone with no real idea of what they're doing? --[[User:Simmura McCrea|Simmura McCrea]] 16:58, 17 October 2008 (EDT)
:OK, I put them into creature_domestic.txt this time, and they showed up, but they suffocated when I started playing. They have lungs, a throat and a mouth, so I can't think what they're missing. They're not aquatic or anything like that either, so I've no idea why they drowned. Here's the full code if you want to instantly pick out what I'm missing. [CREATURE:CATHUMAN]
[NAME:catgirl:catgirls:catgirl]
[TILE:'f'][COLOR:2:0:0]
[FEMALE]
[PETVALUE:400]
[INTELLIGENT]
[TRAPAVOID]
[EXTRAVISION]
[CANOPENDOORS]
[COMMON_DOMESTIC][BENIGN][PET]
[MISCHIEVIOUS]
[PREFSTRING:cat ears]
[BODY:2BIGEARS:HUMANOID:TAIL:2EYES:NOSE:2LUNGS:HEART:GUTS:ORGANS:HUMANOID_JOINTS
:THROAT:NECK:SPINE:
BRAIN:5FINGERS:5TOES:MOUTH]
[SIZE:6]
[MAXAGE:60:110]
[ATTACK:MAIN:BYTYPE:GRASP:punch:punches:1:2:BLUDGEON][ATTACKFLAG_WITH]
[ATTACK:SECOND:BYTYPE:MOUTH:bite:bites:1:1:GORE][ATTACKFLAG_CANLATCH]
[CHILD:12][BABY:1][MULTIPLE_LITTER_RARE]
[FAT:1]
[EQUIPS]
[DIURNAL]
[STANDARD_FLESH]
[HOMEOTHERM:10067]
[LAYERING:10]
[SWIMS_INNATE][SWIM_SPEED:2500]
[NOT_BUTCHERABLE]
[CANNOT_UNDEAD]
[PERSONALITY:ACTIVITY_LEVEL:50:75:100]
[PERSONALITY:ADVENTUROUSNESS:0:60:100]
[PERSONALITY:CHEERFULNESS:50:75:100]
[PERSONALITY:EXCITEMENT_SEEKING:25:75:100]
[PERSONALITY:FRIENDLINESS:50:75:100]
[PERSONALITY:ORDERLINESS:0:20:40]
[PERSONALITY:CAUTIOUSNESS:0:10:30]
--[[User:Simmura McCrea|Simmura McCrea]] 12:17, 20 October 2008 (EDT)

They have no brain? They need a [Nothought] tag for that i think. You need to check the linkings in the body folder too to make sure everything's attached as it should be. If they still dont work just check through each of the tokens with the wiki and you should find the problem.
:They do have a brain and all the tokens seem to be fine. I added [CAN_LEARN] and [CAN_SPEAK] in case the [INTELLIGENT] tag was playing up, but it doesn't seem so. I'm a little stuck now, so I might have to go without catgirls for a while.--[[User:Simmura McCrea|Simmura McCrea]] 08:41, 15 November 2008 (EST)

:If you want a quick fix, just add [NOBREATHE]! That'll let you check the bodyparts in game (and in 99.9% of situations, it'll be the same as a more in-depth fix.) Putting the ears before the main body token might be the problem.--[[User:Navian|Navian]] 13:52, 15 November 2008 (EST)

:Messing with the order of the body parts didn't do anything, so it'll have to be [NOBREATHE]. Ah well, thanks for the help. --[[User:Simmura McCrea|Simmura McCrea]] 17:23, 16 November 2008 (EST)

::Yeah, there's something weird going on. They're still suffocating. I generated a new wold after saving the [NOBREATHE] tag and my catgirls are still suffocating. It seems that catgirls can defy even DF's questionable physics. --[[User:Simmura McCrea|Simmura McCrea]] 17:33, 16 November 2008 (EST)

::I had a similar problem when attempting to introduce a novel species: They would spawn with no body parts and instantly suffocate (apparently you run out of oxygen before having to worry about a lack of blood or brains). The errorlog told me I'd mistyped the name for the main body. And then I forgot that you had to close DF and reopen it for the changes to take effect. But I digress. Two things: Firstly, those line breaks (if they're in the source) may be confusing the game. Try turning off "word wrap" or similar so that it's all on one line before saving it. Secondly, check the errorlog and see if it's throwing any errors. Make a world, embark to a site, let them all suffocate, and then open up errorlog.txt. You say there weren't any errors in worldgen, but seeing as you can apparently have 200-year-old civilizations of bodiless beings waging war and generally not dying due to massive everything failure, I don't think it checks for sanity until they appear on the sitemap.--[[User:Quil|Quil]] 17:53, 16 November 2008 (EST)

:Yep, that's got it. Cheers! --[[User:Simmura McCrea|Simmura McCrea]] 13:31, 17 November 2008 (EST)

:If I may, which "that" was the one that got it?--[[User:Quil|Quil]] 14:17, 17 November 2008 (EST)

:The word wrap. What a weird way to break a creature. --[[User:Simmura McCrea|Simmura McCrea]] 17:36, 18 November 2008 (EST)

::Yeah, Notepad can be retarded like that. --[[User:GreyMario|GreyMaria]] 18:11, 18 November 2008 (EST)

==World Gen and Megabeasts==
Anyone know what controls how many megabeasts are spawned during world gen? I'm hoping its something in the creature tokens (like genpower) and thus easily moddable - just increasing DAMBLOCK doesn't seem to increase their longevity much, and I'd like to play in a world older than 50 years with a decent number of megabeasts remaining. --[[User:Squirrelloid|Squirrelloid]] 04:03, 20 December 2008 (EST)
*I think it is hard coded. Currently the best way to have your megabeasts survive longer is move all of you megabeasts to their own text file and then copy it make sure that both files have the exact same name, no copy number 1 on the end or anything like that. In one version change their DAMBLOCK and SIZE to enormous numbers, like 100000. worldgen with this text file in the raws. Then switch the two text files. This should restore all of your megabeasts to normal power. --[[User:i2amroy|i2amroy]] 19 January 2009

::You mean that for a medium (for example) world there can never be more than 18 megabeasts? That's really lame... --[[User:Squirrelloid|Squirrelloid]] 03:26, 20 January 2009 (EST)

About megabeast modding... after adding the TRAINABLE tag to some, and after one attacked and my Dungeon Master tamed it, we stopped having sieges. It's been 3 years now and we haven't even seen so much as a single thief or ambush. We count ourselves lucky to have continued to receive liaisons and caravans however. We're making plans to drop it into a bottomless pit to see if that fixes the problem however.
--[[User:Unseenmage|Unseenmage]] 04:31, 03 February 2009 (EST)

The megabeast burst into pieces against a ledge within the bottomless pit and that spring a vile force of darkness arrived. Problem solved.
--[[User:Unseenmage|Unseenmage]] 05:00, 03 February 2009 (EST)

40d:Stockpile

2009-04-03T00:06:28Z

Darekun: /* Uses for Custom Stockpiles */ Added Ingredients and Mason's Stone.

'''Stockpiles''' are where [[dwarves]] will store items of various types. Dwarves with the "[[hauling]]" job on will seek out items that aren't already on a stockpile that accepts them and carry them to the appropriate stockpile. It's important to place your stockpiles carefully to minimize the amount of time spent carrying items to and from them. Items in a stockpile may be stored in [[bag]]s, [[barrel]]s or [[bin]]s (see [[Using bins and barrels]]).

== Allocating stockpiles ==

To allocate an area as a stockpile, use the {{key|p}} menu. The right-hand menu pane will list all the stockpile categories, and the appropriate key to press to begin allocating that type. Allocating an area works exactly the same as designating an area. Press {{k|Enter}} to specify the first corner of the stockpile, use the primary movement keys to move the cursor to the opposite corner, and press {{k|Enter}} again. This will create a stockpile of the chosen type that occupies the area between the two corners specified. If the chosen area has parts that cannot be made into a stockpile, like a [[wall]], a [[workshop]], or an already existing stockpile, a stockpile will be created but they will not be part of it.

Removing a stockpile works exactly the same, but choose {{key|x}}: Remove Designation. This will unallocate the area specified. It is possible to create a single stockpile with a shape other than a rectangle by using the Remove Designation tool to remove only part of the stockpile.

== Using stockpiles ==

Once a stockpile has been allocated, dwarves will automatically move items to the stockpile when they are available, and as long as the stockpile has available space. Note that the dwarves will place the item into the empty spot that is nearest to the item, ''not counting any obstructions''. Additional behaviour also includes the fact that dwarves will stockpile the ''newest'' item first, which may not necessarily be the nearest item to the stockpile.

When dwarves need an item for a particular task, they will head to the nearest (again, not counting any obstructions that may lie in the way) item of the correct type, regardless of whether it is in a stockpile or not. Apart from some exceptions, items do not have to be stockpiled at all. Players are generally advised to avoid stone stockpiles, because stone [[hauling]] jobs take an extreme amount of time for unskilled dwarves, due to the weight hauled.

One method to ensure a workshop has raw material on hand is to place a small stockpile next to the workshop. This will speed up production as the crafter in question only has to take a few steps to obtain the material. It also has a useful side-effect, in that as soon as the crafter picks up the piece of material, the stockpile will issue a new task to fetch another piece of that material. Because that crafter is busy, that hauling job will be taken by another [[dwarf]]. This speeds up a queue of jobs, as other dwarfs perform the time-consuming distant haul whilst the crafter actually makes the items.

It's not necessary to place stockpiles for all types of objects. If no storage is available for a certain item type, dwarves will seek out items wherever they might lie as mentioned earlier. This can be advantageous -- if you don't have a stockpile for [[gem]]s, your [[jeweler]] will go pick up fresh gems without waiting for them to be carried to a pile first. However, this also means your jeweler has to spend a lot of time fetching the gems. If you have enough haulers available, it's generally more advantageous to designate stockpiles than not. Also remember that your workshops will get [[clutter]]ed and suffer production slowdowns if you let items pile up in them, so it's important to regularly clear out workshops when they get cluttered. This can be done either by having a stockpile available so that haulers will remove the items or by removing and rebuilding the workshop, which will empty its contents onto the ground.

== Take from a stockpile ==

Another feature of stockpiles, currently in a limited form, allows you to tell dwarves to fill one stockpile not only with unstockpiled items, but also those located on another stockpile that accepts those items. To specify such a flow, use the {{key|q}} menu, and highlight the ''destination'' stockpile. Press {{key|t}}, and, using the cursor, highlight another stockpile and press [Enter]. Your chosen stockpile will now list the stockpile it will take from. This will cause items in the second stockpile to be hauled to the first stockpile. To stop first stockpile taking items from second use {{K|q}} menu on first, higlight the unneeded stockpile in the list using {{K|+}} and {{K|-}} and press {{K|d}}'''elete Selected'''

Each stockpile can can take from any number of other stockpiles, but can only have one stockpile taking from it in turn. This limit applies even if the two stockpiles you want it to feed into don't share a single material that can be stored in both of them. Additionally, you can't make two stockpiles feed into each other, although larger loops (e.g. 3 stockpiles that feed into each other in a circle) are allowed.

However, despite these limitations, enough micromanagement will allow for effective and (relatively) streamlined supply chains. For example, you can speed up [[wood cutting|lumber harvesting]], [[carpentry]], ''and'' [[ash]] and [[charcoal]] production by putting several wood stockpiles near the various [[Chop_down_trees|tree-felling areas]], then one large "primary" stockpile near the [[carpenter's workshop]] that takes from those small ones, and then finally, a small stockpile near the [[wood furnace]] that takes from the primary one.

== Stockpile categories ==

===[[Ammo]]===
This stockpile contains ammo for all forms of ammunition-requiring weaponry is stored here. It can use [[bin]]s to consolidate up to 100 units of ammo. Since the only ammo dwarves can currently use is [[crossbow]] [[bolt]]s, it might be wise to disallow [[arrow]]s and blowdarts.

===[[Animal]]===
[[Animals]] stored in [[cage]]s that are not affixed to a location will be stored in these stockpiles. [[Trap]]s used for capturing wild animals and empty [[cage]]s are also stored here.

===[[Armor]]===
Armor of all types is stored here. This kind of stockpile can use bins to consolidate up to 10 items. There is no preference for specific body parts. All types of armor can be stored in [[bin]]s.

===[[Bar]]/[[Block]]===
Bars of smelted [[metal]] and blocks of cut stone and [[glass]] are kept here after being processed by the [[smelter]], [[mason's workshop]]s, and [[glass furnace]]s, before being used for other purposes. Weirdly, [[ash]]es, [[potash]], [[soap]], [[charcoal]], and [[coke]] from the [[wood furnace]], [[ashery]], [[alchemist's laboratory]] and smelter will also be stored here. Like with all stockpiles, this can be changed to allow for specific blocks and bars to be stored with custom settings. [[Bin]]s can be used to consolidate up to 10 bars and blocks.

===[[Cloth]]===
Woven cloth and [[thread]] from the [[loom]] is stored here. [[Bin]]s can be used to consolidate up to 10 items.

===[[Coins]]===
Minted coins are kept here. Bins can be used to consolidate up to 3000 coins, which is equivalent to six new coins stacks.

===[[Finished Goods]]===
Finished goods created by the [[craftsdwarf's workshop]], as well as the [[clothier's shop]] and the [[leather works]], are placed here before being used in trade or other uses. This type of stockpile can use [[bin]]s to consolidate up to 25 items.

=== [[Food]] ===

As one would assume based on the name, food is stored here. Unexpectedly, [[lye]], [[giant desert scorpion]] venom, bags of [[dye]], and [[liquid fire]] are as well. Raw [[fish]] is brought here before being processed by [[fishery]] and turned into edible [[meat]]. Drinks are always stored in [[barrel]]s. Seeds can be stored in [[bag]]s, whereas other food items can be stored in [[barrel]]s (up to 10 items per barrel, but note that
the stack +Cow meat roast [8]+ would count as eight items.)

Note that [[prepared meal]]s in stacks larger than ten (☼Dwarven Beer Roast [200]☼ is possible) will not fit in a barrel, but will not rot once placed in a food stockpile, and still only take up one space. To free up barrels, you may decide to have separate prepared food stockpiles that do not accept barrels. If you cook larger meals, this shouldn't be a problem.

Food stockpiles should in most cases be specified as things like [[seed]] stockpiles or meat stockpiles or unprepared fish stockpiles; there are simply too many things that go in them.

===[[Furniture]] Storage===
Completed items from the [[carpenter's workshop]], mason's workshop, and [[mechanic's workshop]] will be stored here, along with furniture created from other shops, until placed or used in another building. Since this is a very broad category, like food, generally more specific stockpiles should be created.

===[[Gem]]===
This stockpile stores gems and raw [[glass]], both cut and uncut, before being used in a construction. It can use [[bin]]s to consolidate up to 10 gems.

===[[Graveyard]]===
Dead dwarves and [[pet]]s that have no burial location will be placed here. If placed indoors, decaying bodies will generate [[miasma]], but [[bone]]s will not removed at the end of the season. 
Are dwarf and pet bones removed at the end of the season ever? --[[User:Savok|Savok]]

===[[Leather]]===
Leather, which is produced at a [[Tanner's shop]], will be kept here. Like most stockpiles, it can use [[bin]]s to consolidate up to 10 items.

===[[refuse stockpile|Refuse]]===
Since dwarves hate rot because of the miasma it spreads when in an enclosed place like a [[cave]], any garbage item that can rot will be stored in a refuse stockpile. Many players prefer to place this stockpile outside their cavern, usually a small distance from the entrance. If placed indoors, decaying items will generate miasma, which will spread through your fortress and generate a small unhappy thought in any dwarf passing through it. For this reason it is sensible to build [[door]]s to all of your indoor refuse stockpiles - the miasma won't spread through a closed door so only dwarves with business in the room will be bothered by the rot. An alternative to this is to dig [[channel]]s down from the surface, creating an outside area inside your fortress. You can place your refuse stockpile here and whilst it will be in your fort it will technically be outside and won't generate miasma.

Bones, [[skulls]], and [[shell]]s are also stored here, whether they be from defeated enemies or raw food processing. Outdoor refuse stockpiles are emptied at the turn of the seasons, but indoor refuse stockpiles are not, so you may wish to make an indoor refuse stockpile that takes bones from the outdoor stockpile.

Note that a refuse stockpile is not the same as a [[Activity_zone#Garbage_Dump|garbage dump]]. A garbage dump is only for things manually marked to be dumped. Additionally, refuse types specifically marked as '''Dwarves Dump '''''refuse type'' in {{k|o}}-{{k|r}} will be hauled to the garbage dump instead of the refuse stockpile.

===[[Stone]]===
Rough stone will be stored here, as well as [[ore]]. Given the extreme abundance of stone, it is very likely for this stockpile to fill up quickly, making stone stockpiles largely ineffective for [[Stone_management|dealing with excess stone]]. Probably the best use of stone stockpiles is to make sure that workshops and smelters, catapults, and impending construction projects have their materials close at hand. Be aware that these things can use up a lot of stone very quickly, leading to your dwarves scurrying around the fortress trying to keep up. To avoid stone hauling when you don't want it, you can slow down or stop the nearby usage, allowing the stockpile to fill back up (and thus no longer need more stone), or you can set the dwarves to ignore minerals in {{key|o}}rders and options.

===[[Weapon]]s===
Weapons of all types are stored here by default, including the weapons that dwarves do not use and trap components. [[Bin]]s can be used to consolidate up to 10 weapons of any type.

===[[Wood]]===
Chopped trees are brought to the wood stockpile before being used by the carpenter's workshop. Because wood takes a long time to haul down from the surface, it should be rather large. It is a good idea to position this stockpile close to your carpenter's workshop.

=== Custom stockpiles ===

With custom stockpiles you can change which types of materials, goods, etc, can be stored in that pile. Any types of things can be mixed, so you could have a stockpile that will hold raw [[turtle]], [[mechanism]]s and all stone types apart from [[onyx]] if you wanted. Highlighting a stockpile with {{key|q}}, then pressing {{key|s}} will allow you to adjust the stockpile settings or in the {{key|p}} menu you can press {{key|t}} to adjust a custom stockpiles settings before placing it with {{key|c}}. Note that many sub-menus consist of several pages ( the 'other' menu of stone e.g. consists of several pages while 'metal [[ore]]s' and 'economic' consist of only one ).

== Stockpile Settings ==
The '''Stockpile Settings''' screen is weird to use. In the first column are the major categories. In the second column there may or may not be subcategories. In the third you will see the individual items. The second and third columns are only visible when a category is enabled and selected.

You navigate this screen with {{key|+}} and {{key|-}}, and left and right on the arrow keys. {{key|e}} and {{key|d}} are used to enable and disable the categories. {{key|a}} and {{key|b}} are used to allow or disallow all the subcategories. {{key|p}} and {{key|f}} will permit of forbid individual subcategories. These six keys work no matter which column you have selected, though the last 4 will not always be available. {{key|Enter}} will toggle individual item types.

== Notes ==
Some categories will have a special extra type of item(s) that can be toggled with {{key|u}} and sometimes {{key|j}}.

{| border="1" cellpadding="4"
|+
! Categories
! Item type
|-
| Animals
| Empty cages and Empty animal traps
|-
| Food
| Prepared food
|-
| Furniture
| Sand bag
|-
| Weapons
| Local and Foreign
|-
| Armor
| Local and Foreign
|}

If you disable an item or items that are already sitting in a stockpile then they become loose items and your dwarves will move them to a more suitable stockpile should one exist.

== Uses for Custom Stockpiles ==

A custom stockpile is most useful for food, furniture, and bar/block stockpiles, to prevent your lye and venom sitting next to the [[kitchen]]s, your [[floodgate]]s and mechanisms near the [[room]]s that need [[statue]]s and doors, your stone blocks next to the forges, and your metal bars by the farms.

One use for this is to have an outdoor stockpile that will accept all refuse except bones, shells, and skulls, and then an indoor pile near to your craftsdwarf's workshop that will '''only''' accept these things. If you have set the option for dwarves to gather refuse from outside, the bones will be brought in for processing once all the meat has rotted off of any carcases outside. This means added risk to your dwarves if they try to gather refuse that is far from your gate, and a potentially large amount of useless hauling.

Another effective use of custom stockpiles is Elven trading. Make a stockpile just for elf-safe trade goods: most categories where it's relevant have a 'materials' option.

A highly efficient method is to have wood burning furnaces feeding into a '[[charcoal]] only' bar/blocks stockpile, which in turn is near the smelting furnaces and forges. Bonus points if you also place a small wood stockpile near the wood furnaces.

Other good uses:
* Planter's stock: [[seed]]s and [[potash]]. (If your [[ashery]] is nearby, include ashes and lye. It may be a good idea to turn off barrel usage in a seed stockpile if barrels are in short supply because while a seed stockpile won't use more than a couple, that's still barrels that aren't being used for food or booze.)
* Smelter stock: [[ore]]s and [[economic stone]].
* Sandpile: [[sand]] bags.
* Clothes Plus: a cloth stockpile that also includes [[dye]]s. (Dyes normally count as food.)
* Food Plus: a food stockpile that includes barrels. This spares your dwarves from carrying empty barrels to and from the furniture stores.
* Skins: a refuse stockpile limited to [[skin]]s, a bit like the bone & shell stockpile above. Place near the tannery.
* Brewer's stock: [[List of crops|brewable plants]].
* Refreshment stand: Since dwarves drink twice as often as they eat, having several small food stockpiles that only accept [[drink]]s scattered strategically through your fort can minimise [http://en.wikipedia.org/wiki/Smoko smoko breaks].
* Artifact materials: The massive value and effectiveness of [[artifacts]] means the materials used in them can have drastic effects, sometimes even into the ''[[Value|millions]]''. Having special stockpiles for high-value metals, stones, gems, and other such materials will make it that much easier to insure that you will get the most out of each [[strange mood]]. (However, even with materials-specific stockpiles, it can take a fair amount of micromanagement to get a moody dwarf to use a specific material.)
* Ingredients: Store things that are cookable but not edible, like cheese and quarry bush leaves, near kitchens. For that matter, store both fat and tallow near kitchens for efficient rendering.
* Mason's Stone: Since a mason's workshop doesn't let you pick what type of stone to use, use customized stone stockpiles to provide some of that control. On maps with mass [[flux]] stone, a small stockpile for flux stone near masons' workshops can boost the values of stone furniture in general.

[[Category:Stockpiles]]
[[Category:Items]]

40d Talk:Stockpile

2009-04-02T23:52:18Z

Darekun: /* Armor bin capacity */

=== Stockpile categories ===
'''[[Ore]]''' 
Ore will be brought here. This is one of the simpler stockpiles.
: Is it just me, or is this incorrect? I don't see an option in the new version for ore piles. I'm at work and so cannot double-check at this time, but I'll check when I get home and if I confirm it then, I'll remove Ore from the Stockpile categories.

You're correct. Ore is now included in the stone stockpile and there is no mining stockpile. I've made the change. -Valdemar

Should this page be retitled "Stockpile" to keep in line with the title style rules? --[[User:BahamutZERO|BahamutZERO]] 17:44, 1 November 2007 (EDT)
:Done. --[[User:Peristarkawan|Peristarkawan]] 18:15, 1 November 2007 (EDT)

==Custom Catastrophe==

According to the forums, and my own experiences, the "Custom" category doesn't actually work. Removing the unused stockpile and replacing it with one of the standard type, then editing it to your specifications will work. Also types can be safely changed after they're assigned. (I turned a wood stockpile to a bed stockpile with successful stocking).
I came across this after a great deal of kitchen rebuilding because my cook wouldn't fill the stockpiles. If someone more familiar with the wiki, and the game, could confirm this and edit the page it would be appreciated, it's something that should be out there. [[User:Scribbler|Scribbler]] 14:24, 26 September 2008 (EDT)

: I have not had this problem, although I do need to be careful making sure that I actually adjust the cus((k|t}}om stockpile settings before placing the stockpile, and then being sure that I'm still placing a custom stockpile. This menu is one of the least-intuitive to my mind, but the settings work, AFAIK. --[[User:RomeoFalling|RomeoFalling]] 20:48, 4 November 2008 (EST)

:Custom stockpiles work perfectly for me, and have for a logn time. Maybe the original poster overlooked the "prepared food" option under the food submenu?--[[User:Maximus|Maximus]] 18:53, 5 November 2008 (EST)

:::probably as simple as not allowing the 'material'/'core quality'/'total quality' options to be on. maybe even the 'metals' one if you want a metal-stuff stockpile. i've had lots of trouble with it, too x] usually done by {{k|b}}locking all, and just selecting the item on it's own. everything has to be made out of something! --[[User:DJ Devil|DJ Devil]] 13:01, 7 March 2009 (EST)

== Bins ==

how do I make my bins get to the "right" stockpiles (ie i want to put stone in bins to compact it but so far my bin is sitting in a "finished goods" stockpile)[[User:GarrieIrons|GarrieIrons]] 09:40, 4 January 2008 (EST)

:Raw objects generally can't be put in bins, only "processed" goods. For instance, [[block]]s can be put in bins, but not raw stone. The best way to get a compact stone store is to create a dump, though I haven't fiddled with that technique yet.--[[User:Maximus|Maximus]] 12:51, 4 January 2008 (EST)
::Stone designated for dumping (individually which is a pain no matter how you do it) can all end up on a single dump activity zone and then reclaimed, this is much more space-efficient than stone stockpiles.[[User:GarrieIrons|GarrieIrons]] 01:42, 8 July 2008 (EDT)
:::You can now mass designate items for dumping by selecting large amounts of stone, or any other object, really. [[User:Schm0|Schm0]] 15:46, 3 January 2009 (EST)
:Is my problem similar to what you mean, GarrieIrons? I have a clothing/leather stockpile that is filled to the brink with individual items. I want to put them in bins so that I can have more room (as there are more items to be stored) but whenever I find a way to make room in the stockpile, more non-bin items are added until it is full again. On top of that, there is already one bin on the stockpile and no one will store anything in it. [[User:FJH|FJH]] 21:30, 17 February 2009 (EST)
::i had the same problem, and was just about to post it, then found an answer! :D set your stockpile to accept bins/barrels/whatever (mine's a stone block stockpile way outside of my fort, from which the peasants were carting one block at a time into a free bin. now it's a bin and block stockpile (Note: DO NOT TURN OFF 'core quality', 'total quality' etc. if you do, NO bins/barrels will be accepted)), press {{k|q}}uery(?) over the stockpile, then press {{k|t}}ake from a pile. go to your finished goods stockpile (the one containing the bins/barrels), and hit {{k|Enter}}. your peasants will immediately start running over to it with bins/barrels. sorted :D note: they'll take all your bins over! remember to {{k|q}} over your new stockpile, and set the maximum amount of bins/barrels with {{k|c}} (more) and {{k|v}} (fewer). mine's set to 10. thinking about it... you may just be able to set your finished goods stockpile max to 10 bins/barrels, and any others will be taken somewhere else (probably not a good thing; they may get left clogging up your workspace) --[[User:DJ Devil|DJ Devil]] 12:45, 7 March 2009 (EST)

== Usable/Unusable Weapons/Armour? ==

Anyone knows exactly what this does? It seems that stockpiles set to "unusable" will only collect things that dwarfs can't possibly ever use, not even in Adventure mode (ex: big human two-handed weapons such as a halberd), but while technically things like whips and scimitars aren't unusable, dwarfs in Fortress mode will never equip them - no such option in the Military screen. Or will they use, for example, a scimitar if set to use swords? Will that use the Swordsdwarf skill? IMO it would be more useful if it included any weapon not in the Military screen. --[[User:Sergius|Sergius]] 12:44, 12 January 2008 (EST)
:I use this when I kill kobolds etc - all the weapons my dwarf collect of '''hostile''' creatures then go into the same bin. I can't use them, but I ''can'' drag one bin all at once to the visiting [[trading|merchant]] - ker-ching! They sell pretty well.
:But I agree, it should be that any weapon dwarves cannot use should end up there.[[User:GarrieIrons|GarrieIrons]] 02:53, 14 February 2008 (EST)

== my dear cook ==

preparing food stacks larger than *ten* - on what depends the number? my cook sometimes does it, sometimes not, both with lavish and simple meals. Is it from the stack size? --[[User:Koltom|Koltom]] 02:36, 14 February 2008 (EST)

:The biggest question here though is - what is the appropriate setting for a stockpile for cooked food?
:It seems to be, "forbid" everything but make sure "Prepared food" is turned on. But "prepared food" seems to be turned on as the default, and it allows even unprocessed fish etc to be placed in the stockpile. So this doesn't make much sense to me.[[User:GarrieIrons|GarrieIrons]] 05:40, 27 February 2008 (EST)
: well, you could use a refuse pile with only prepared meals enabled...--[[User:Koltom|Koltom]] 14:39, 29 February 2008 (EST)
:: to be more precise, a custom stockpile (t) with only prepared meals enabled under 'Refuse' - works and is not even called a refuse pile. Havent seen someone eat from it yet though.--[[User:Koltom|Koltom]] 22:03, 3 March 2008 (EST)
:I think in general, the number of prepared meals in the stack is based on the number of ingredients used. The biggest stacks of ingredients are generally quarry bush leaves, but depending on the animal, stacks of tallow can equal or exceed them. I have mini-stockpiles for quarry bush leaves and tallow adjacent to my kitchen, and if a stack smaller than 20 gets made, it generally means those mini-stockpiles are out. [[User:Darekun|Darekun]] 22:03, 2 April 2009 (UTC)

== Stone Stockpiles ==

Currently my dwarves are not hauling ores of iron, zinc and lignite which I have disabled for my other stone stockpiles. I have over 8000 stone in somewhat organized stockpiles since I thought my wealth would generate more slowly with everyone hauling them all around the map with the more common stones, siltstone and phyllite, creating common crafts, statues, hatch covers, flood gates, mechanisms and use in stone fall traps. I now have over 333 stockpiles. I went and mined all ores used in creating fuels and metals and it seems that the storage space I've made might not be that big enough. What's the problem?--[[User:Seaneat|Seaneat]] 21:35, 9 July 2008 (EDT)
:Just got it, I had ignore minerals. Sorry.--[[User:Seaneat|Seaneat]] 21:35, 9 July 2008 (EDT)

== Take From Stockpile ==

While we're adding information to this section, Can someone who has used this successfully give a more concrete example? --[[User:RomeoFalling|RomeoFalling]] 18:22, 6 November 2008 (EST)

:Well, I gave it a shot --[[User:LegacyCWAL|LegacyCWAL]] 14:27, 7 March 2009 (EST)

== Clear stone to replace with stockpile? ==

Is there any way to clear the stone out of the way so I can build a stock pile for something that ISN'T stone? Got a nice big room full of workshops and nowhere to put anything because 90% of the spots are filled with stones.

(Is it just me, or do the dwarves sometimes seem ''really'' dumb? I set up a paved road of about 10 sections from the top exit of the fortress to the edge of the map for caravans. I set up stone stockpiles next to every other segment of the road both so they didn't have to walk so far to do it and to clear some of the stone out... They started at the farthest away road segment, and will go all the way to the other end of the road, down three flights of stairs, all the way to an otherwise empty room to pick up a piece of stone to go all the way back to use it on the road, rather than use the nearby and completely full stockpiles. ) --[[User:Azaram|Azaram]] 05:24, 27 November 2008 (EST)

:[[Stone management]]. As for the road, when constructing a building, it shows you how distant the materials are, but only "as the crow flies". If the nearest stone is one z-level away and you unwittingly select it, they'll walk however long a path they have to actually fetch it. Same thing for workshops -- they'll go huge distances to get the item that's just above their heads.--[[User:Maximus|Maximus]] 12:01, 27 November 2008 (EST)

::That may explain it... I set up the stockpiles after designating the road, so (after everyone dropped everything to fill the stockpiles), they went to the stone that I apparently designated when I set up the road. Would be nice if you could just tell them 'take THIS item and put it THERE'... --[[User:Azaram|Azaram]] 21:16, 28 November 2008 (EST)

:::[[Dump]]ing more or less allows you to do that.--[[User:Maximus|Maximus]] 23:59, 28 November 2008 (EST)

::::Seems less than more. :-p I've got a leftover iron knife sitting on the remains of a two dimensional goblin in a stonefall trap... I set everything to dump, and they took everything but his body and his knife. (I sold all his crap to the elves that showed up shortly thereafter). I ended up going with the catapult version...had a peasant build three catapult parts then set it up and toss rocks across the room into a channel... he's now a siege engineer. So I had him build another and started another peasant on it, and they're happily banging away at the wall... --[[User:Azaram|Azaram]] 23:01, 29 November 2008 (EST)

==Armor bin capacity==

I have a bin in my armor stockpile that has 17 items in it, so unless something really weird is going on the statement in the article that bins in armor stockpiles can consolidate up to 10 items is probably false. Anyone know what the truth is? [[User:MJSS|MJSS]] 20:51, 16 December 2008 (EST)

:It depends on the size of the items. An armor bin can hold a lot more boots and gauntlets than it can suits of platemail. It was speculated that 10 is the minimum number of goods a bin can hold, although I think platemail bins don't even hold that many. --[[User:Squirrelloid|Squirrelloid]] 21:02, 16 December 2008 (EST)

::I've long been curious about what the formula is for bin capacity. A question for the future, I guess.--[[User:Maximus|Maximus]] 15:29, 17 December 2008 (EST)

:Crafts fit in bins in especially large numbers; perhaps based on the "material size" of the item, with some default applying to things with no explicit material size? There's also the matter of bags of seeds. [[User:Darekun|Darekun]] 23:52, 2 April 2009 (UTC)

== Core Quality vs Total Quality ==

What's the difference? Does core quality refer to the quality of the item while total quality somehow takes into account its decorations? If I have a standard quality sword menacing with masterwork spikes of bone, what total quality is that? [[User:Schwern|Schwern]] 17:49, 31 December 2008 (EST)

:Yes, and I have no idea. --[[User:GreyMario|GreyMaria]] 20:04, 31 December 2008 (EST)
:The formula is unknown. We wish we knew.--[[User:Zchris13|Zchris13]] 15:07, 7 March 2009 (EST)

40d Talk:Stockpile

2009-04-02T22:03:58Z

Darekun: /* my dear cook */

=== Stockpile categories ===
'''[[Ore]]''' 
Ore will be brought here. This is one of the simpler stockpiles.
: Is it just me, or is this incorrect? I don't see an option in the new version for ore piles. I'm at work and so cannot double-check at this time, but I'll check when I get home and if I confirm it then, I'll remove Ore from the Stockpile categories.

You're correct. Ore is now included in the stone stockpile and there is no mining stockpile. I've made the change. -Valdemar

Should this page be retitled "Stockpile" to keep in line with the title style rules? --[[User:BahamutZERO|BahamutZERO]] 17:44, 1 November 2007 (EDT)
:Done. --[[User:Peristarkawan|Peristarkawan]] 18:15, 1 November 2007 (EDT)

==Custom Catastrophe==

According to the forums, and my own experiences, the "Custom" category doesn't actually work. Removing the unused stockpile and replacing it with one of the standard type, then editing it to your specifications will work. Also types can be safely changed after they're assigned. (I turned a wood stockpile to a bed stockpile with successful stocking).
I came across this after a great deal of kitchen rebuilding because my cook wouldn't fill the stockpiles. If someone more familiar with the wiki, and the game, could confirm this and edit the page it would be appreciated, it's something that should be out there. [[User:Scribbler|Scribbler]] 14:24, 26 September 2008 (EDT)

: I have not had this problem, although I do need to be careful making sure that I actually adjust the cus((k|t}}om stockpile settings before placing the stockpile, and then being sure that I'm still placing a custom stockpile. This menu is one of the least-intuitive to my mind, but the settings work, AFAIK. --[[User:RomeoFalling|RomeoFalling]] 20:48, 4 November 2008 (EST)

:Custom stockpiles work perfectly for me, and have for a logn time. Maybe the original poster overlooked the "prepared food" option under the food submenu?--[[User:Maximus|Maximus]] 18:53, 5 November 2008 (EST)

:::probably as simple as not allowing the 'material'/'core quality'/'total quality' options to be on. maybe even the 'metals' one if you want a metal-stuff stockpile. i've had lots of trouble with it, too x] usually done by {{k|b}}locking all, and just selecting the item on it's own. everything has to be made out of something! --[[User:DJ Devil|DJ Devil]] 13:01, 7 March 2009 (EST)

== Bins ==

how do I make my bins get to the "right" stockpiles (ie i want to put stone in bins to compact it but so far my bin is sitting in a "finished goods" stockpile)[[User:GarrieIrons|GarrieIrons]] 09:40, 4 January 2008 (EST)

:Raw objects generally can't be put in bins, only "processed" goods. For instance, [[block]]s can be put in bins, but not raw stone. The best way to get a compact stone store is to create a dump, though I haven't fiddled with that technique yet.--[[User:Maximus|Maximus]] 12:51, 4 January 2008 (EST)
::Stone designated for dumping (individually which is a pain no matter how you do it) can all end up on a single dump activity zone and then reclaimed, this is much more space-efficient than stone stockpiles.[[User:GarrieIrons|GarrieIrons]] 01:42, 8 July 2008 (EDT)
:::You can now mass designate items for dumping by selecting large amounts of stone, or any other object, really. [[User:Schm0|Schm0]] 15:46, 3 January 2009 (EST)
:Is my problem similar to what you mean, GarrieIrons? I have a clothing/leather stockpile that is filled to the brink with individual items. I want to put them in bins so that I can have more room (as there are more items to be stored) but whenever I find a way to make room in the stockpile, more non-bin items are added until it is full again. On top of that, there is already one bin on the stockpile and no one will store anything in it. [[User:FJH|FJH]] 21:30, 17 February 2009 (EST)
::i had the same problem, and was just about to post it, then found an answer! :D set your stockpile to accept bins/barrels/whatever (mine's a stone block stockpile way outside of my fort, from which the peasants were carting one block at a time into a free bin. now it's a bin and block stockpile (Note: DO NOT TURN OFF 'core quality', 'total quality' etc. if you do, NO bins/barrels will be accepted)), press {{k|q}}uery(?) over the stockpile, then press {{k|t}}ake from a pile. go to your finished goods stockpile (the one containing the bins/barrels), and hit {{k|Enter}}. your peasants will immediately start running over to it with bins/barrels. sorted :D note: they'll take all your bins over! remember to {{k|q}} over your new stockpile, and set the maximum amount of bins/barrels with {{k|c}} (more) and {{k|v}} (fewer). mine's set to 10. thinking about it... you may just be able to set your finished goods stockpile max to 10 bins/barrels, and any others will be taken somewhere else (probably not a good thing; they may get left clogging up your workspace) --[[User:DJ Devil|DJ Devil]] 12:45, 7 March 2009 (EST)

== Usable/Unusable Weapons/Armour? ==

Anyone knows exactly what this does? It seems that stockpiles set to "unusable" will only collect things that dwarfs can't possibly ever use, not even in Adventure mode (ex: big human two-handed weapons such as a halberd), but while technically things like whips and scimitars aren't unusable, dwarfs in Fortress mode will never equip them - no such option in the Military screen. Or will they use, for example, a scimitar if set to use swords? Will that use the Swordsdwarf skill? IMO it would be more useful if it included any weapon not in the Military screen. --[[User:Sergius|Sergius]] 12:44, 12 January 2008 (EST)
:I use this when I kill kobolds etc - all the weapons my dwarf collect of '''hostile''' creatures then go into the same bin. I can't use them, but I ''can'' drag one bin all at once to the visiting [[trading|merchant]] - ker-ching! They sell pretty well.
:But I agree, it should be that any weapon dwarves cannot use should end up there.[[User:GarrieIrons|GarrieIrons]] 02:53, 14 February 2008 (EST)

== my dear cook ==

preparing food stacks larger than *ten* - on what depends the number? my cook sometimes does it, sometimes not, both with lavish and simple meals. Is it from the stack size? --[[User:Koltom|Koltom]] 02:36, 14 February 2008 (EST)

:The biggest question here though is - what is the appropriate setting for a stockpile for cooked food?
:It seems to be, "forbid" everything but make sure "Prepared food" is turned on. But "prepared food" seems to be turned on as the default, and it allows even unprocessed fish etc to be placed in the stockpile. So this doesn't make much sense to me.[[User:GarrieIrons|GarrieIrons]] 05:40, 27 February 2008 (EST)
: well, you could use a refuse pile with only prepared meals enabled...--[[User:Koltom|Koltom]] 14:39, 29 February 2008 (EST)
:: to be more precise, a custom stockpile (t) with only prepared meals enabled under 'Refuse' - works and is not even called a refuse pile. Havent seen someone eat from it yet though.--[[User:Koltom|Koltom]] 22:03, 3 March 2008 (EST)
:I think in general, the number of prepared meals in the stack is based on the number of ingredients used. The biggest stacks of ingredients are generally quarry bush leaves, but depending on the animal, stacks of tallow can equal or exceed them. I have mini-stockpiles for quarry bush leaves and tallow adjacent to my kitchen, and if a stack smaller than 20 gets made, it generally means those mini-stockpiles are out. [[User:Darekun|Darekun]] 22:03, 2 April 2009 (UTC)

== Stone Stockpiles ==

Currently my dwarves are not hauling ores of iron, zinc and lignite which I have disabled for my other stone stockpiles. I have over 8000 stone in somewhat organized stockpiles since I thought my wealth would generate more slowly with everyone hauling them all around the map with the more common stones, siltstone and phyllite, creating common crafts, statues, hatch covers, flood gates, mechanisms and use in stone fall traps. I now have over 333 stockpiles. I went and mined all ores used in creating fuels and metals and it seems that the storage space I've made might not be that big enough. What's the problem?--[[User:Seaneat|Seaneat]] 21:35, 9 July 2008 (EDT)
:Just got it, I had ignore minerals. Sorry.--[[User:Seaneat|Seaneat]] 21:35, 9 July 2008 (EDT)

== Take From Stockpile ==

While we're adding information to this section, Can someone who has used this successfully give a more concrete example? --[[User:RomeoFalling|RomeoFalling]] 18:22, 6 November 2008 (EST)

:Well, I gave it a shot --[[User:LegacyCWAL|LegacyCWAL]] 14:27, 7 March 2009 (EST)

== Clear stone to replace with stockpile? ==

Is there any way to clear the stone out of the way so I can build a stock pile for something that ISN'T stone? Got a nice big room full of workshops and nowhere to put anything because 90% of the spots are filled with stones.

(Is it just me, or do the dwarves sometimes seem ''really'' dumb? I set up a paved road of about 10 sections from the top exit of the fortress to the edge of the map for caravans. I set up stone stockpiles next to every other segment of the road both so they didn't have to walk so far to do it and to clear some of the stone out... They started at the farthest away road segment, and will go all the way to the other end of the road, down three flights of stairs, all the way to an otherwise empty room to pick up a piece of stone to go all the way back to use it on the road, rather than use the nearby and completely full stockpiles. ) --[[User:Azaram|Azaram]] 05:24, 27 November 2008 (EST)

:[[Stone management]]. As for the road, when constructing a building, it shows you how distant the materials are, but only "as the crow flies". If the nearest stone is one z-level away and you unwittingly select it, they'll walk however long a path they have to actually fetch it. Same thing for workshops -- they'll go huge distances to get the item that's just above their heads.--[[User:Maximus|Maximus]] 12:01, 27 November 2008 (EST)

::That may explain it... I set up the stockpiles after designating the road, so (after everyone dropped everything to fill the stockpiles), they went to the stone that I apparently designated when I set up the road. Would be nice if you could just tell them 'take THIS item and put it THERE'... --[[User:Azaram|Azaram]] 21:16, 28 November 2008 (EST)

:::[[Dump]]ing more or less allows you to do that.--[[User:Maximus|Maximus]] 23:59, 28 November 2008 (EST)

::::Seems less than more. :-p I've got a leftover iron knife sitting on the remains of a two dimensional goblin in a stonefall trap... I set everything to dump, and they took everything but his body and his knife. (I sold all his crap to the elves that showed up shortly thereafter). I ended up going with the catapult version...had a peasant build three catapult parts then set it up and toss rocks across the room into a channel... he's now a siege engineer. So I had him build another and started another peasant on it, and they're happily banging away at the wall... --[[User:Azaram|Azaram]] 23:01, 29 November 2008 (EST)

==Armor bin capacity==

I have a bin in my armor stockpile that has 17 items in it, so unless something really weird is going on the statement in the article that bins in armor stockpiles can consolidate up to 10 items is probably false. Anyone know what the truth is? [[User:MJSS|MJSS]] 20:51, 16 December 2008 (EST)

:It depends on the size of the items. An armor bin can hold a lot more boots and gauntlets than it can suits of platemail. It was speculated that 10 is the minimum number of goods a bin can hold, although I think platemail bins don't even hold that many. --[[User:Squirrelloid|Squirrelloid]] 21:02, 16 December 2008 (EST)

::I've long been curious about what the formula is for bin capacity. A question for the future, I guess.--[[User:Maximus|Maximus]] 15:29, 17 December 2008 (EST)

== Core Quality vs Total Quality ==

What's the difference? Does core quality refer to the quality of the item while total quality somehow takes into account its decorations? If I have a standard quality sword menacing with masterwork spikes of bone, what total quality is that? [[User:Schwern|Schwern]] 17:49, 31 December 2008 (EST)

:Yes, and I have no idea. --[[User:GreyMario|GreyMaria]] 20:04, 31 December 2008 (EST)
:The formula is unknown. We wish we knew.--[[User:Zchris13|Zchris13]] 15:07, 7 March 2009 (EST)

40d Talk:Reactions

2009-04-01T13:37:19Z

Darekun: /* Page expansion */ & /* Pets? */

== Page expansion ==

I want to explore the reaction mechanisms further so I'm going to be gathering information from the forum and other pages on the wiki and linking it to the talk page to have a nice list put together for information sources. --[[User:Ikkonoishi|Ikkonoishi]] 12:51, 11 January 2008 (EST)

Reactions can produce other items besides metal and stones.
http://www.bay12games.com/cgi-local/ultimatebb.cgi?ubb=get_topic&f=13&t=000101

Using Plants as materials.
http://www.bay12games.com/cgi-local/ultimatebb.cgi?ubb=get_topic&f=13&t=000051

just tested and confirmed that you can add reaction tags. testing if multiple reaction tags can be added to one items now.

adding to flint 
[MATGLOSS_STONE:FLINT] 
[NAME:flint][COLOR:0:7:1][TILE:178] 
[SEDIMENTARY] 
'''[REACTION_CLASS:TEST]''' 
[SOLID_DENSITY:9999] 
 

and adding a new reaction 

[REACTION:STONE_MAGIC] 
[NAME:make steel from test flag] 
[SMELTER] 
[REAGENT:1:REACTION_CLASS:TEST] 
[PRODUCT:100:2:BAR:NO_SUBTYPE:METAL:STEEL] 

gives out 2 bars of steel bars --[[User:Shadetree|Shadetree]] 23:29, 5 February 2008 (EST)

:Yes, but does it consume the flint? Have you checked the error log? If you create a reaction with an error in its [REAGENT]s, the offending reagents will be deleted, so you might end up with a "free steel bars" recipe. Given the presence of "FLUX" and "Flux Stone" in the [[string dump]] I'm skeptical, but that's sweet if it works :) [[User:Darekun|Darekun]] 13:37, 1 April 2009 (UTC)

=== Pets? ===
I notice one of the entries for item tokens is PET. Is it possible to smelt animals? Can I have a smelter pop out a swarm of giant eagles? [[User:Rkyeun|Rkyeun]] 22:26, 18 August 2008 (EDT)

:No. Well, technically you can, but it'll pop out as a swarm of tiny vermin instead of a flock of killer birds. --[[User:Untelligent|Untelligent]] 18:32, 19 August 2008 (EDT)

:Specifically, [PRODUCT:100:1:PET:NO_SUBTYPE:DRAGON:NO_SUBTYPE] will turn out a weird little tame-vermin version of a dragon, and [PRODUCT:100:1:VERMIN:NO_SUBTYPE:DRAGON:NO_SUBTYPE] will turn out a similar wild-vermin dragon. If you make vermin versions of [TRAINABLE] creatures, you might be able to train them as war vermin... [[User:Darekun|Darekun]] 13:37, 1 April 2009 (UTC)

==Plant Reactions==
In the August 12th dev log (which eventually became part of 40a), Toady mentioned that reactions for several items, notably "plants to bones to extracts etc." are fully supported now (as opposed to making the material number the same as the number of the plant). Can someone find the correct syntax for such reactions? --[[User:Untelligent|Untelligent]] 18:32, 19 August 2008 (EDT)
:I've added the syntax for plants and seeds to the [[Material tokens]] page, since that's where it gets a bit weird. --[[User:Zaranthan|Zaranthan]] 18:24, 17 February 2009 (EST)
== Update ==

Version 0.28.181.40a added embark profiles and generalized the item definitions. This means that reactions will work better with things other than stone and metal. How much better remains to be seen. We need to document it. --[[User:Ikkonoishi|Ikkonoishi]] 17:52, 3 September 2008 (EDT)
:I've updated the information some. Still needs some cleaning and more work, but I'm tired of it for now. --[[User:Ikkonoishi|Ikkonoishi]] 19:19, 3 September 2008 (EDT)

== Containers ==

Given that smelters look in bar/block bins as a matter of course, the line "The smelter cannot look inside containers for reagents..." seems overgeneralized or false. Any data to back it up? [[User:Darekun|Darekun]] 13:20, 1 April 2009 (UTC)

40d Talk:Reactions

2009-04-01T13:20:26Z

Darekun: /* Containers */ new section

== Page expansion ==

I want to explore the reaction mechanisms further so I'm going to be gathering information from the forum and other pages on the wiki and linking it to the talk page to have a nice list put together for information sources. --[[User:Ikkonoishi|Ikkonoishi]] 12:51, 11 January 2008 (EST)

Reactions can produce other items besides metal and stones.
http://www.bay12games.com/cgi-local/ultimatebb.cgi?ubb=get_topic&f=13&t=000101

Using Plants as materials.
http://www.bay12games.com/cgi-local/ultimatebb.cgi?ubb=get_topic&f=13&t=000051

just tested and confirmed that you can add reaction tags. testing if multiple reaction tags can be added to one items now.

adding to flint 
[MATGLOSS_STONE:FLINT] 
[NAME:flint][COLOR:0:7:1][TILE:178] 
[SEDIMENTARY] 
'''[REACTION_CLASS:TEST]''' 
[SOLID_DENSITY:9999] 
 

and adding a new reaction 

[REACTION:STONE_MAGIC] 
[NAME:make steel from test flag] 
[SMELTER] 
[REAGENT:1:REACTION_CLASS:TEST] 
[PRODUCT:100:2:BAR:NO_SUBTYPE:METAL:STEEL] 

gives out 2 bars of steel bars --[[User:Shadetree|Shadetree]] 23:29, 5 February 2008 (EST)

=== Pets? ===
I notice one of the entries for item tokens is PET. Is it possible to smelt animals? Can I have a smelter pop out a swarm of giant eagles? [[User:Rkyeun|Rkyeun]] 22:26, 18 August 2008 (EDT)

No. Well, technically you can, but it'll pop out as a swarm of tiny vermin instead of a flock of killer birds. --[[User:Untelligent|Untelligent]] 18:32, 19 August 2008 (EDT)

==Plant Reactions==
In the August 12th dev log (which eventually became part of 40a), Toady mentioned that reactions for several items, notably "plants to bones to extracts etc." are fully supported now (as opposed to making the material number the same as the number of the plant). Can someone find the correct syntax for such reactions? --[[User:Untelligent|Untelligent]] 18:32, 19 August 2008 (EDT)
:I've added the syntax for plants and seeds to the [[Material tokens]] page, since that's where it gets a bit weird. --[[User:Zaranthan|Zaranthan]] 18:24, 17 February 2009 (EST)
== Update ==

Version 0.28.181.40a added embark profiles and generalized the item definitions. This means that reactions will work better with things other than stone and metal. How much better remains to be seen. We need to document it. --[[User:Ikkonoishi|Ikkonoishi]] 17:52, 3 September 2008 (EDT)
:I've updated the information some. Still needs some cleaning and more work, but I'm tired of it for now. --[[User:Ikkonoishi|Ikkonoishi]] 19:19, 3 September 2008 (EDT)

== Containers ==

Given that smelters look in bar/block bins as a matter of course, the line "The smelter cannot look inside containers for reagents..." seems overgeneralized or false. Any data to back it up? [[User:Darekun|Darekun]] 13:20, 1 April 2009 (UTC)

40d:Reactions

2009-04-01T13:18:53Z

Darekun: /* PRODUCT */ Confirmed guess on "chance" term.

Reactions currently control the actions of the [[smelter]] building. They consist of at least one reagent and one product. Eventually the goal is to include all buildings and their actions within the raws.

You may have multiple reagents and products within a reaction. By including a product that replaces a consumed reagent, you could create things like tools and catalytic reactions.

Additions to reaction_standard.txt do not take effect until you generate a new world, but changes to existing reactions take effect next time you open the game.

==Anatomy of a Reaction==

[REACTION:BITUMINOUS_COAL_TO_COKE] <-- The name of the reaction. Not referenced elsewhere yet, but must be unique.
===NAME===
[NAME:make coke from bituminous coal] <-- What appears in the game when the necessary reagents are available.
===SMELTER===
[SMELTER] <-- Says the reaction is performed in the smelter. There are currently no other building tokens.
===REAGENT===
Reagents come in two main types.
====Type 1====
[REAGENT:<Quantity>:<[[Item Token|ITEM_TOKEN]]>:<ITEM_SUBTYPE>:<[[Material_tokens|MATGLOSS_TOKEN]]>:<MATGLOSS_SUBTYPE>]

As with all raw entries the values here are separated by semicolons. This style of reaction has six variables.
=====REAGENT=====
This is always the string REAGENT
=====Quantity=====
The number of items this reaction produces. Does not seem to have a hard upper limit. High numbers will most likely crash the game out of sheer lag though.
=====ITEM_TOKEN=====
A value from the <[[Item Tokens|ITEM_TOKEN]]> list for the item you want to make.
=====ITEM_SUBTYPE=====
An item identifier from the raw file for this item type. For instance if you want to make gloves you would look in the item_gloves.txt file and find the name of one of the items there like ITEM_GLOVES_GLOVES. You would also need to set the ITEM_TOKEN to GLOVES.
If you don't have a subtype to use just put "NONE".
=====MATGLOSS_TOKEN=====
You put the general category of the material you want to use here.
=====MATGLOSS_SUBTYPE=====
The specific type goes here. Like the ITEM_SUBTYPE, you can look up the possible values from the raws. The <[[Matgloss_tokens]]> page has information on where to find the subtype.

====Type 2====
[REAGENT:1:REACTION_CLASS:FLUX] <-- Reaction_class can be replaced with METAL_ORE and possibly STONE_NAME and THREAD_METAL though those aren't used in the basic reaction types.
Those are special cases that identify items that use the tags like [STONE_NAME:platinum nuggets] or [THREAD_METAL:ADAMANTINE:100] {{Verify}}

===PRODUCT===
[PRODUCT:100:3:BAR:NO_SUBTYPE:COAL:COKE] <-- The end product(s) of the reaction. The first parameter is the percent chance of producing that product. The rest is the same as in REAGENT.

===FUEL===
[FUEL] <-- Says the reaction uses fuel.

==Notes==

The smelter cannot look inside containers for reagents; this means not only bins and barrels, but bags, coffers, et cetera. In practice this makes it seemingly impossible to use extracts of any sort (liquid, powder, and so on) in smelter reactions. It likely won't show up on the job list at all and, if it does, will result in immediate cancellation when a dwarf tries to select it from the job queue. Extracts can be the product of a reaction but since they must be stored, they will immediately be "spilled" upon creation and be impossible to store and use.

[[Category:Modding]]

40d:Matgloss token

2009-04-01T11:43:51Z

Darekun: /* Stone-specific tokens */ Documented [GEM].

Preliminary information on tokens used in the material description files, stored at raw/objects/matgloss_*.txt in the default distribution.

These files begin with the filename as the other raws do, then [OBJECT:MATGLOSS]. Individual entries begin with [MATGLOSS_METAL:ID], [MATGLOSS_PLANT:ID], [MATGLOSS_STONE:ID], or [MATGLOSS_WOOD:ID].

__TOC__

{| {{prettytable}}
|- bgcolor="#ddd"
! Token !! Description
|-
| NAME
| The name of the material
|-
| ADJ
| The adjective applied to objects made of the item
|-
| COLOR
| The [[color]] of the material. Note that the background is not always used (i.e. bars, stones)
|-
| BASIC_COLOR
| The [[color]] of raw stones and gems.
|-
| VALUE
| The value multiplier of the material. Not wood?
|-
| SPEC_HEAT
| The [http://en.wikipedia.org/wiki/Specific_heat_capacity specific heat] of the material, in units of J/kg·K. Only on metal and stone?
|-
| MELTING_POINT
| See [[temperature scale]].
|-
| BOILING_POINT
| See [[temperature scale]].
|-
| SOLID_DENSITY
| Density in kg/m3.
|-
| DEEP
| [[glowing pit|Hidden fun stuff]].
|}

== Metal-specific tokens ==
* TILE is the tile (character or 437 ordinal) for the material while still in the ground (trees, plants, rough walls)
* Usage - different metals can be used for different things
** WEAPON (fun fact: the WEAPON token only appears in the list of items)
** WEAPON_RANGED
** DIGGER - e.g. for picks
** AMMO
** ANVIL
** ANY_USE
* BRITTLE - Unknown gameplay effect
* DAMAGE_PERC, BLOCK_PERC - weapons and armor respectively. Relative to Iron.
* WAFERS - Instead of bars. Items take three times as many wafers as bars to make.
== Wood-specific tokens ==
Some of these are also on plants.
* AUTUMNCOLOR - changes color with the seasons
* WET, DRY - Same as [[Plant tokens|for plants]]
* SAPLING - Young trees are called saplings instead of e.g. "young tower-cap"
* BIOME
* PREFSTRING
== Plant-specific tokens ==
See [[Plant tokens]].
== Stone-specific tokens ==
* STONE_NAME - Loose stones are called this, e.g. for "nuggets" vs native metal
* [METAL_ORE:<metal>:<percentage>] - automatically creates a smelter reaction requiring fuel and one stone to make one bar.
** Multiple METAL_ORE tokens mean that there is a percentage chance of each metal - c.f. [[tetrahedrite]] or [[galena]].
* ITEM_SYMBOL: Loose stones use this tile. Used to make [[bituminous coal]] show up as ☼ and ores as *.
* LAVA - lines the magma pipe; formed with water + magma
* SHARP - can be made into CAN_STONE weapons
* GLASS - [[rock crystal]].
* [GEM:singular:plural] - the stone drops gems, instead of loose stones. The plural can be STP, which seems to be short for "standard plural", i.e. just add an S after the singular.

===Layer types===
Note: Soils are considered to be a subtype of stone in the raws.

A stone material can be tagged with one of:
*[SEDIMENTARY]
*[IGNEOUS_INTRUSIVE]
*[IGNEOUS_EXTRUSIVE]
*[METAMORPHIC]
*[SOIL]
*[SOIL_OCEAN]

Additionally these can occur:
*[SEDIMENTARY_OCEAN_SHALLOW]
*[SEDIMENTARY_OCEAN_DEEP]
*[SOIL_SAND] - can be made into glass
*[AQUIFER] - aquifers can be in these layers

Layer tags are not mutually exclusive with ENVIRONMENT tags.

===ENVIROMENT and ENVIRONMENT_SPEC===

Format:
*[ENVIRONMENT:<class>:<inclusion type>:<frequency>]
** class may also be ALL_STONE, IGNEOUS_ALL, ALLUIVAL.
*[ENVIRONMENT_SPEC:<id>:<inclusion type>:<frequency>]

The inclusion type can be CLUSTER, CLUSTER_SMALL, CLUSTER_ONE, or VEIN. CLUSTERs are large ovoids that occupy their entire local map tile if present. CLUSTER_SMALL inclusions are blobs of 3-9 tiles; CLUSTER_ONE inclusions are single tiles; and VEINs are large streaks.

If no CLUSTER is present, then zero to two VEINs as well as roughly five to seven other clusters will be present in the local map tile.

Anecdotal evidence suggests that each z-layer will tend to reuse the same type of inclusions, leading to multiple clusters of the same type of opal rather than several different types.

== Tokens not found in the raws ==
These do not appear in any shipped raw file. They were found [[string dump|in the EXE]]. We can only speculate as to their syntax and meaning. Athough, some are obvious. Others may be easily discovered by modding. It is unknown whether any of these do anything.

* LIQUID_DENSITY
* BUILD_COLOR
* TILE_COLOR
* DROWN_LEVEL - probably for plants
* Probably Wood-specific, based on their positioning in the token table
** DEAD_TILE
** SAPLING_TILE
** DEAD_COLOR
** SAPLING_COLOR
** SAPLING_DROWN_LEVEL
** TREE_DROWN_LEVEL

[[Category:Modding]]
[[Category:Tokens]]