Dwarf Fortress Wiki - User contributions [en]

Tower-cap

2022-12-23T03:05:15Z

Talvieno: The tower-cap bug appears to have been fixed. In v50 it's dropping a great many logs - one per tile of cap, which honestly is nothing short of amazing and possibly overpowered.

{{migrated article}}
{{Quality|Unrated}}
{{Treelookup/0|wiki=no}}
{{av}}

'''Tower-caps''' are a type of mushroom-like [[underground|subterranean]] [[tree]]. Once fully grown, they can be designated for [[wood cutting]] and produce tower-cap [[Wood|logs]]. Tower-caps will grow on thick subterranean [[soil]] or [[mud|muddied]] [[rock]]. They may be found already growing on muddied rock in an [[Caverns|underground cavern]]. Tower-caps are white and produce white logs, and the resulting products are white or light grey - as a result, they are sometimes used in combination with other white [[stone]]s to create entirely white areas.

Tower-caps will not start growing in muddied soil until you have discovered the 1st underground cavern.

Some [[Dwarf|dwarves]] [[Preferences|like]] tower-caps for their ''great size''.

== Energy source? ==
{{d for dwarf}}
There is much controversy about the energy source that tower-caps use to grow. Although it is clear that, like any fungus, they gain energy by breaking down organic compounds in soil and mud, it's equally clear that they are able to do this underground, without access to sunlight. Without any obvious way to regenerate the organic matter that they sprout in, it's unclear how they can survive for thousands of years without sunlight. Thus, useless immigrant dwarven botanists have wasted entirely too much spare time trying to find their energy source.

The leading theory is that underground soil may contain perpetual motion machines, composed of molecular-scale screw pumps and water wheels. As every dwarven engineer knows, a perpetual motion machine must be given water to start up, after which, it will run indefinitely without any extra water required. Molecular-scale screw pumps and water wheels would, similarly, not provide energy until they become muddied, and, similarly, would remain functional indefinitely. The concept of things smaller than a [[monarch butterfly]], however, has led to enormous controversy. Although, obviously, it would be hard to see something smaller than a butterfly, it should be possible to show that it exists because, just like butterflies, it would sometimes get stuck in doors and prevent them from closing. So far, there is no evidence that doors have been held stuck by imperceptibly tiny objects, so the theory remains unsubstantiated.

Alternative theorists have proposed that energy is initially harvested from magma by vermin in the magma sea, and it steadily rises through biological interactions between other vermin, cavern inhabitants, and cave moss. While it is well-documented that vermin reside pretty much everywhere, this theory implies that it should be possible for a dwarf to subsist off of a diet consisting solely of vermin fresh from the [[magma sea]]. <strike>Un</strike>fortunately, all attempts to test this theory have been <strike>disastrous</strike> [[fun]] for the test subjects, leading one to conclude this theory is even more foolish than the first.

{{gamedata}}
{{Plants}}
{{Category|Subterranean trees}}

Body token

2014-09-11T18:11:48Z

Talvieno: Changed quality rating from "Unrated" to "Superior" using the rating script

{{Quality|Superior|18:11, 11 September 2014 (UTC)}}
{{Migrated_article}}
{{av}}

'''Body tokens''' are one of the fundamental parts of creatures, and determine their bodily structure. There are two major types of body tokens: ''body templates'' (BODY) and ''body parts'' (BP).

A creature uses the {{token|BODY|c}} [[creature token]] to list all of the body templates it includes. Each part listed in each template is then included in the creature. In other words: a creature lists the ''body templates'' it is made of. Each ''body template'' contains a set of ''body parts''. Each ''body part'' specifies which other body part it is attached to.

Body parts can connect specifically to another body part, or generally to any body part of a certain category. These connections are handled by the CON and CONTYPE body part tokens respectively.

Body parts can be renamed with a bodygloss, allowing someone to reuse an existing template instead of defining a similar template with only the names of the body parts changed.

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

|-
| {{text anchor|APERTURE}}
|
| Marks body part as an opening in the body. It cannot be severed from its parent body. If it is also EMBEDDED, it cannot be gouged.

|-
| {{text anchor|BP}}
|
*ID
*name
*pluralized name
| "STP stands for "Standard Plural" and it just adds an 's' to the singular word to save some typing. If you don't add something in that slot, the body part won't even load." --Toady. Note that this can cause confusing issues when porting from 40d to 2010. Make sure you add your pluralizations!

|-
| {{text anchor|BREATHE}}
|
| Body part is used to breathe. If all body parts with [BREATHE] are damaged or destroyed, the creature will suffocate unless it has the NOBREATHE tag. Note that bruising counts as (fast-healing) damage.

|-
| {{text anchor|CATEGORY}}
|
*ID
| Assigns the body part to a user-defined category. Used by CON_CAT to attach to other body parts.

|-
| {{text anchor|CON}}
|
*value
| Connects the body part to a specific other body part.

|-
| {{text anchor|CON_CAT}}
|
*value
| Connects the body part to all other body parts having the specified CATEGORY.

|-
| {{text anchor|CONTYPE}}
|
*value
| Connects the body part to all other body parts having the specified type token. Valid values are UPPERBODY, LOWERBODY, HEAD, GRASP, or STANCE.

|-
| {{text anchor|CIRCULATION}}
|
| Body part is responsible for blood circulation. Exact effects not known.

|-
| {{text anchor|CONNECTOR}}
|
| Body part is used to connect other body parts together. Used for the neck and lower spine.

|-
| {{text anchor|DEFAULT_RELSIZE}}
|
*Size
| This command establishes the relative size of body parts within a creature. The numbers have no absolute meaning or units.

|-
| {{text anchor|DIGIT}}
|
| Defines part as digit. Body parts that are digits or have them as direct sub-parts can perform gouging attacks within a wrestling hold.

|-
| {{text anchor|EMBEDDED}}
|
| Body part with this tag is on the surface of parent body part. i.e.: eye and mouth on head. It can be gouged.

|-
| {{text anchor|FLIER}}
|
| Flags the body part as being need for flight. Damage to a certain number of FLIER body parts will prevent the creature from flying. Note that a creature can only fly if the creature has the FLIER tag in its creature definition, and that a flying creature does not actually need any FLIER body parts. This tag's only purpose is to identify body parts which will cause a creature to '''lose''' the ability to fly when damaged.

|-
| {{text anchor|GRASP}}
|
| Creature can wield a picked-up weapon with body part, and can use the part to initiate almost all wrestling moves. When creatures are spawned with a weapon and shield, one GRASP part will hold a weapon while '''all others''' will hold shields.

|-
| {{text anchor|GUTS}}
|
| Body part is susceptible to low blows. Used for guts. Damage to this body part causes nausea and may make the creature lose turns, vomiting uncontrollably.

|-
| {{text anchor|HEAD}}
|
| Flags the body part as being able to wear head clothing like hats, helms, etc. If all heads are chopped off, the creature dies. Multiple heads '''are''' redundant - for example, [[hydra]]s can survive with several missing heads.

|-
| {{text anchor|HEAR}}
|
| Body part is used to hear. No known effects.

|-
| {{text anchor|INDIVIDUAL_NAME}}
|
*name
*plural
| Adding individual names tells the game what to call each individual part in a NUMBERed bodypart. This command replaces "first upper front tooth" for example.

|-
| {{text anchor|INTERNAL}}
|
| Marks the body part as being inside the body. It is behind all the other tissues of the body part and cannot be severed. Adding SMALL makes it untargetable in combat.

|-
| {{text anchor|JOINT}}
|
| Body part is a joint. If the limb it's in is grabbed in a wrestling hold, it can be broken with bending force. This disables the parent limb. If the joint is modded to sit outside the body, grabbing and breaking it snaps the entire limb right off.

|-
| {{text anchor|LIMB}}
|
| Body part is a limb. It can be used to initiate most wrestling moves. If it is located between an UPPERBODY part and a GRASP body part, it is eligible to be covered by certain types of armor (body armors and gauntlets). If it is located between a LOWERBODY part and a STANCE body part, it is eligible to be covered by other types of armor (Leg armors like pants, etc.; trailing body armors like mail shirts and robes; and high boots).

|-
| {{text anchor|LOWERBODY}}
|
| Flags the body part as being able to wear lower body clothing like skirts, pants, etc. If a lower body is chopped off, the creature dies. Full stop. Having multiple lower bodies does not stop this.

|-
| {{text anchor|LEFT}}
|
| Marks body part as on the left side of the body and vulnerable to attacks from the left. Used in conjunction with tags in the b_detail_plan_default raw.

|-
| {{text anchor|MOUTH}}
|
| Body part is a mouth. No idea what special things it implies.

|-
| {{text anchor|NUMBER}}
|
*value
| The number lets you stack identical body parts. These can be individually damaged by wounds, but you don't have to define them explicitly one by one. If you don't give them individual names (see teeth) they'll be preceded by ordinal numbers (first, second, etc.). In practice, though, they cannot be individually damaged - if you knock out one tooth, the entire group will be knocked out at once (and will be scattered across the area). Butchering doesn't respect this and produces only a single body part per group.

|-
| {{text anchor|NERVOUS}}
|
| Body part is the hub of nervous function. Used for the parts of the spine. Damage disables everything in the parent bodypart and what's below it, causing death by suffocation in most cases.

|-
| {{text anchor|PREVENTS_PARENT_COLLAPSE}}
|
| Body part must be destroyed in order for the attached parent object to be considered destroyed. Found on skulls and spinal columns.

|-
| {{text anchor|RIGHT}}
|
| Marks body part as on the right side of the body and vulnerable to attacks from the right. Used in conjunction with tags in the b_detail_plan_default raw.

|-
| {{text anchor|SKELETON}}
|
| Body part is part of the creature's skeleton.

|-
| {{text anchor|STANCE}}
|
| Allows the creature to stand. Damage or loss of these body parts will cause creature to fall over. Loss of one STANCE part can be substituted with a crutch. Does not give the body part an ability to initiate wrestling moves, unlike GRASP or LIMB.

|-
| {{text anchor|SIGHT}}
|
| Body part is used to see with. If the creature has no SIGHT body parts, or if all its sight body parts are damaged or destroyed, it can't see unless it has the EXTRAVISION tag in its creature def.

|-
| {{text anchor|SMELL}}
|
| Body part is used to smell. No known function. (could possibly control reactions to miasma in fortress mode?)

|-
| {{text anchor|SMALL}}
|
| "SMALL means that the part isn't displayed as part of the overall displayed body part lists. They can't be splinted. They are more often targeted for torture (although those situations might not occur anymore). They are removed in skeletons if they aren't specifically skeletons/joints/digits/apertures. They are more easily lost in world gen duels. They are the only gougable/pinchable parts ''(note: at least this is no longer the case.)''. SMALL is an old tag, so it has accumulated some weird functions which'll get split off over time. " --Toady

|-
| {{text anchor|SOCKET}}
|
| Body part breaks off and goes flying if broken, even with blunt force. Used on teeth to make them easy to knock out. Rendered invalid by INTERNAL.

|-
| {{text anchor|THROAT}}
|
| Body part can be strangled. Latching bites that hit the head have a chance to target this instead. Note: this tag doesn't control any bleeding behavior.

|-
| {{text anchor|THOUGHT}}
|
| The central core of the body. Used with the brain. Damage causes instant death unless the creature has NO_THOUGHT_CENTER_FOR_MOVEMENT/NOTHOUGHT.{{verify}}

|-
| {{text anchor|TOTEMABLE}}
|
| This bodypart can be turned into a totem by craftsmen. Always drops from slaughtered creatures, no matter how small.

|-
| {{text anchor|UPPERBODY}}
|
| Flags the body part as being able to wear upper body clothing like coats, breastplates etc. If an upper body is chopped off, the creature dies. Multiple UPPERBODY parts aren't redundant. All default creatures with bodies have the upperbody as the root of the body tree, making it impossible to chop off.

|-
| {{text anchor|UNDER_PRESSURE}}
|
| Makes the body part pop out of the body when cut through. Used on guts. Body part shows up as "~" and drags behind the victim when spilled.

|-
| {{text anchor|VERMIN_BUTCHER_ITEM}}
|
| Allows the item to be obtained from butchered or rotted vermin. Used with [[shell]]s.

|}

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

Creature token

2014-08-26T18:45:13Z

Talvieno: Changed quality rating from "Tattered" to "Fine" using the rating script

{{Quality|Fine|18:45, 26 August 2014 (UTC)}}
{{Migrated_article}}
{{av}}

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

|-
| {{text anchor|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}}

|-
| {{text anchor|ALCOHOL_DEPENDENT}}
| Caste
|
| Creature needs alcohol to get through the working day, choosing to drink booze instead of water if possible. Going sober for too long reduces speed.

|-
| {{text anchor|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.

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

|-
| {{text anchor|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}}

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

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

|-
| {{text anchor|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.

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

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

|-
| {{text anchor|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.

|-
| {{text anchor|APPLY_CREATURE_VARIATION}}
| Special
|
*CV TEMPLATE NAME
| Applies the specified [[creature variation token|creature variation]].

|-
| {{text anchor|APPLY_CURRENT_CREATURE_VARIATION}}
| Special
|
| Applies the effects of all pending [[#CV_ADD_TAG|CV_ADD_TAG]] and [[#CV_REMOVE_TAG|CV_REMOVE_TAG]] tokens that have been defined in the current creature.

|-
| {{text anchor|AQUATIC}}
| Caste
|
| Creature can breathe in water, but air-drowns on dry land.

|-
| {{text anchor|ARENA_RESTRICTED}}
| Caste
|
| Does not appear in arena mode list.

|-
| {{text anchor|ARTIFICIAL_HIVEABLE}}
| Creature
|
| Can be kept in artificial hives by beekeepers.

|-
| {{text anchor|AT_PEACE_WITH_WILDLIFE}}
| Caste
|
| Does not attack or frighten creatures with the NATURAL tag.

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

|-
| {{text anchor|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

|-
| {{text anchor|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.

|-
| {{text anchor|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.

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

|-
| {{text anchor|BENIGN}}
| Caste
|
| The creature is non-aggressive by default, but may lash out if agitated or disturbed.

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

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

|-
| {{text anchor|BLOODSUCKER}}
| Caste
|
| Seems to be required to make the creature denouncable as a creature of the night.

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

|-
| {{text anchor|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:'''<br />
[BODY_APPEARANCE_MODIFIER:HEIGHT:90:95:98:100:102:105:110] <br />
''HEIGHT'' : marks the height to be changed <br />
''90:95:98:100:102:105:110'' : sets the range from the shortest (90% of the average height) to the tallest (110% of the average height) creature variation.

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

|-
| {{text anchor|BODY_SIZE}}
| Caste
| years:days:size
| Sets size at a given age. Size is in cubic centimeters, and for normal body materials is roughly equal to the creature's average weight in grams.
'''Example:'''<br />
[BODY_SIZE:0:0:10000]<br />
[BODY_SIZE:1:168:50000]<br />
[BODY_SIZE:12:0:220000]<br />
This describes the size of a [[minotaur]]. His birth size would be 10,000 cm<sup>3</sup> (~10 kg). At 1 year and 168 days old he would be 50,000 cm<sup>3</sup> (~50 kg). And as an adult (at 12 years old) he would be 220,000 cm<sup>3</sup> and weigh roughly 220 kg.

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

|-
| {{text anchor|BONECARN}}
| Caste
|
| Creature eats bones. Implies CARNIVORE and has the same worldgen problem.

|-
| {{text anchor|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)

|-
| {{text anchor|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

|-
| {{text anchor|CAN_DO_INTERACTION}}
| Caste
| interaction token
| The creature can perform an interaction. See [[interaction token]].

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

|-
| {{text anchor|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}}

|-
| {{text anchor|CANNOT_CLIMB}}
| Caste {{Verify}}
|
| Creature cannot climb, even if it has free grasps.

|-
| {{text anchor|CANNOT_JUMP}}
| Caste
|
| Creature cannot jump.

|-
| {{text anchor|CANNOT_UNDEAD}}
| Caste
|
| Alias for NOT_LIVING

|-
| {{text anchor|CANOPENDOORS}}
| Caste
|
| Allows the creature to open doors.

|-
| {{text anchor|CARNIVORE}}
| Caste
|
| Creature ''only'' eats meat. If the creature goes on rampages in worldgen, it will often devour the people/animals it kills. Currently bugged in worldgen -- exclusively carnivore civilizations always starve out. Goblins and kobolds live off raw exceptions. Civilizations with [NO_EAT] token will still starve to death.

|-
| {{text anchor|CASTE}}
| Creature
|
*name
| Defines a caste.

|-
| {{text anchor|CASTE_ALTTILE}}
| Caste
|
*tile number or "letter"
| Caste-specific ALT_TILE. Requires CASTE_TILE.

|-
| {{text anchor|CASTE_COLOR}}
| Caste
|
*fg
*bg
*brightness
| Caste-specific COLOR.

|-
| {{text anchor|CASTE_GLOWCOLOR}}
| Caste
|
*fg
*bg
*brightness
| Caste-specific GLOWCOLOR.

|-
| {{text anchor|CASTE_GLOWTILE}}
| Caste
|
*tile value or "letter"
| Caste-specific GLOWTILE.

|-
| {{text anchor|CASTE_NAME}}
| Caste
| singular:plural:adjective
| Caste-specific NAME.

|-
| {{text anchor|CASTE_PROFESSION_NAME}}
| Caste
|
*[[Unit type token]] (Profession)
*singular
*plural
| Caste-specific PROFESSION_NAME.

|-
| {{text anchor|CASTE_SOLDIER_ALTTILE}}
| Caste
| 'character' or tile number
| Caste-specific SOLDIER_ALTTILE. Requires CASTE_SOLDIER_TILE.

|-
| {{text anchor|CASTE_SOLDIER_TILE}}
| Caste
| 'character' or tile number
| Caste-specific CREATURE_SOLDIER_TILE.

|-
| {{text anchor|CASTE_SPEECH}}
| Caste
| speech file
| Caste-specific SPEECH.

|-
| {{text anchor|CASTE_TILE}}
| Caste
|
* tile number or "letter"
| Caste-specific CREATURE_TILE.

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

|-
| {{text anchor|CDI}}
| Caste
| Varies
| Specifies details for the preceding CAN_DO_INTERACTION token. See [[Interaction token]].

|-
| {{text anchor|CHANGE_BODY_SIZE_PERC}}
| Caste
| integer
| Multiplies body size by a factor of (integer)%. 50 halves size, 200 doubles.

|-
| {{text anchor|CHANGE_FREQUENCY_PERC}}
| Creature
| integer
| Multiplies frequency by a factor of (integer)%.

|-
| {{text anchor|CHILD}}
| Caste
| integer
| age at which creature is considered an adult. One can think of this as the duration of the child stage.

|-
| {{text anchor|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.

|-
| {{text anchor|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]

|-
| {{text anchor|CLUTCH_SIZE}}
| Caste
|
*min
*max
|Number of eggs laid in one sitting.

|-
| {{text anchor|COLONY_EXTERNAL}}
| Caste
|
| Caste hovers around colony.

|-
| {{text anchor|COLOR}}
| Creature
| foreground:background:brightness
| Color of the creature's tile. See [[Color]] for usage.

|-
| {{text anchor|COMMON_DOMESTIC}}
| Caste
|
| Any civilization with USE_COMMON_DOMESTIC tag (humans, dwarves) has domesticated this creature by default and always has access to it, even without any wild populations. Useless without PET, PACK_ANIMAL, WAGON_PULLER or MOUNT tags and invalid on FANCIFUL creatures. Requires NATURAL tag?{{verify}}

|-
| {{text anchor|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.

|-
| {{text anchor|COOKABLE_LIVE}}
| Caste
|
| Set this to allow the creature to be cooked in meals without first being butchered/cleaned. Used for mussels, for one.

|-
| {{text anchor|CRAZED}}
| Caste
|
| Creature is 'berserk' and will attack all other creatures, except members of its own species that ALSO have the CRAZED tag.

|-
| {{text anchor|COPY_TAGS_FROM}}
| Special
|
*CREATURE NAME
| Copies tags from another specified creature.

|-
| {{text anchor|CREATURE_CLASS}}
| Caste
|
*classname
| An arbitrary creature classification. Can be set to anything, but only existing uses are GENERAL_POISON (used in syndromes) and EDIBLE_GROUND_BUG (valid targets for GOBBLE_VERMIN_x tokens). A single creature can have multiple classes. Eligibility for certain entity positions can also be permitted or restricted by this tag.

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

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

|-
| {{text anchor|CREPUSCULAR}}
| Caste
|
| Sets if the creature is active at twilight.

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

|-
| {{text anchor|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.

|-
| {{text anchor|CURIOUSBEAST_ITEM}}
| Caste
|
| Allows a creature to steal things (apparently the highest value it can find). If the creature goes on rampages in worldgen, it will often steal items instead of attacking. Kea birds are infamous for this.

|-
| {{text anchor|CV_ADD_TAG}}
| Special
|
*TAG NAME
| Adds a tag. Used in conjunction with creature variation templates.

|-
| {{text anchor|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

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

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

|-
| {{text anchor|DIE_WHEN_VERMIN_BITE}}
| Caste
|
| Dies upon attacking. Used for [[bee]] stings.

|-
| {{text anchor|DIFFICULTY}}
| Caste
| integer
| Increases experience gain during adventure mode. Creatures with 11 or higher are not assigned for quests in adventure mode.

|-
| {{text anchor|DIURNAL}}
| Caste
|
| Sets if the creature is active in day.

|-
| {{text anchor|DIVE_HUNTS_VERMIN}}
| Caste
|
| Found on [[peregrine falcon]]s. The creature hunts vermin by diving from the air. Does not seem to work on tame creatures.

|-
| {{text anchor|DOES_NOT_EXIST}}
| Creature
|
| Creature does not actually exist; used for a few [[fanciful]] creatures of myth.
|}

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

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

|-
| {{text anchor|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.

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

|-
| {{text anchor|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.

|-
| {{text anchor|EGG_SIZE}}
| Caste
|
*size
| Determines the size of eggs.

|-
| {{text anchor|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.

|-
| {{text anchor|EQUIPS}}
| Caste
|
| Allows the creature to wear or wield items.

|-
| {{text anchor|EVIL}}
| Creature
|
| Creature is considered evil and will only show up in evil biomes. Civilizations with USE_EVIL_ANIMALS can domesticate them regardless of exotic status. Has no effect on cavern creatures.

|-
| {{text anchor|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.

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

|-
| {{text anchor|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

|-
| {{text anchor|FANCIFUL}}
| Creature
|
| The creature is a thing of legend and known to all civilizations. Its materials cannot be requested or preferred. The tag also adds some art value modifiers. Used for things like dragons and other legendary creatures. Conflicts with {{token|COMMON_DOMESTIC|c}}

|-
| {{text anchor|FEATURE_ATTACK_GROUP}}
| Caste
|
| Found on subterranean animal-man tribals.

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

|-
| {{text anchor|FEMALE}}
| Caste
|
| The creature is female and can bear young. Usually determined inside a caste.

|-
| {{text anchor|FIREIMMUNE}}
| Caste
|
| The creature is immune to FIREBALL and FIREJET attacks.

|-
| {{text anchor|FIREIMMUNE_SUPER}}
| Caste
|
| The creature is immune to DRAGONFIRE attacks. Implies {{token|FIREIMMUNE|c}}.

|-
| {{text anchor|FISHITEM}}
| Caste
|
| Needs to be cleaned at a fishery

|-
| {{text anchor|FIXED_TEMP}}
| Caste
| temperature
| The natural heat generated by the creature.

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

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

|-
| {{text anchor|FREQUENCY}}
| Creature
|
*number, max 100
| Determines the chances of a creature appearing within its environment, with higher values resulting in more frequent appearance. The game effectively considers all creatures that can possibly appear and uses the FREQUENCY value as a ''weight'' - for example, if there are three creatures with frequencies 10/25/50, the creature with [FREQUENCY:50] will appear approximately 58.8% of the time. Defaults to 50 if not specified. Not to be confused with {{token|POP_RATIO|c}}.
|}

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

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

|-
| {{text anchor|GAIT}}
| Unknown
|
* type (WALK, CLIMB, SWIM, CRAWL, or FLY)
* gait name
* full speed
* build up time:max turning speed:start speed (or NO_BUILD_UP for instant use)
* energy use
* Optional flags:
** LAYERS_SLOW - if gait is slowed by increased weight
** STRENGTH - if gait is affected by strength stat
** AGILITY - if gait is affected by agility stat
** STEALTH_SLOWS:penalty - if gait is slowed by being stealthed
| Defines a gait at which the creature can move. See [[Gait]] for more information.

|-
| {{text anchor|GENERAL_BABY_NAME}}
| Creature
| singular:plural
| BABYNAME applied regardless of caste.

|-
| {{text anchor|GENERAL_CHILD_NAME}}
| Creature
| singular:plural
| CHILDNAME applied regardless of caste.

|-
| {{text anchor|GENERAL_MATERIAL_FORCE_MULTIPLIER}}
| Caste
| A:B
| Attacks against the creature have their force modified by A/B. For example, 1:2 will halve the force of an attack made against the creature. {{verify}}

|-
| {{text anchor|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.

|-
| {{text anchor|GETS_INFECTIONS_FROM_ROT}}
| Caste
|
| Creature can get infections from necrotic tissue.

|-
| {{text anchor|GETS_WOUND_INFECTIONS}}
| Caste
|
| This creature's wounds can become infected if left untreated for too long.

|-
| {{text anchor|GLOWCOLOR}}
| Creature
|
*foreground
*background
*brightness
| The colour of the creature's GLOWTILE.

|-
| {{text anchor|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.

|-
| {{text anchor|GNAWER}}
| Caste
| verb
| The creature can and will gnaw its way out of [[animal trap]]s and [[cage]]s using the specified verb, depending on the material from which it is made (normally wood). Currently, all gnawers brought onto the map by [[Elf|Elven]] caravans will almost immediately escape from their wooden cages{{bug|6343}}.

|-
| {{text anchor|GOBBLE_VERMIN_CLASS}}
| Caste
| class
| The creature eats vermin of the specified class.

|-
| {{text anchor|GOBBLE_VERMIN_CREATURE}}
| Caste
| creature:caste
| The creature eats a specified vermin.

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

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

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

|-
| {{text anchor|GOOD}}
| Creature
|
| Creature is considered good and will only show up in good biomes. [[unicorn]]s for example. Civilizations with USE_GOOD_ANIMALS can domesticate them regardless of exotic status. Presumably has no effect on cavern creatures.

|-
| {{text anchor|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.

|-
| {{text anchor|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.

|-
| {{text anchor|GRAZER}}
| Caste
|
*number
| The creature is a grazer. If tamed in Fortress mode, it needs a pasture to survive. The higher the number, the less frequently it needs to eat in order to live. See [[Pasture]] for details on its issues.
|}

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

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

|-
| {{text anchor|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 require the creature to have a lair to work properly, and also don't seem to work on creatures who are not (SEMI)MEGABEASTs or NIGHT_CREATURE_HUNTERs.

|-
| {{text anchor|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.".<sup>[[http://www.bay12forums.com/smf/index.php?topic=60554.msg1719248#msg1719248 source post]]</sup> All lists of HABITs are preceded by [HABIT_NUM:TEST_ALL]

|-
| {{text anchor|HAS_NERVES}}
| Caste
|
| The creature has nerves in its muscles. Cutting the muscle tissue can sever motor and sensory nerves.

|-
| {{text anchor|HASSHELL}}
| Caste
|
| The creature has a shell. Seemingly no longer used - holdover from previous versions.

|-
| {{text anchor|HFID}}
| Creature
| Integer (generic token?)
| Found on generated [[angel]]s. Seemingly identifies a historical figure with said hist figure ID, possibly to associate it with hist figure.

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

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

|-
| {{text anchor|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

|-
| {{text anchor|IMMOBILE}}
| Caste
|
| The creature cannot move. Found on [[sponge]]s. Will also stop a creature from breeding in Fortress Mode (MALE and FEMALE are affected, if one is IMMOBILE no breeding will happen)

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

|-
| {{text anchor|IMMOLATE}}
| Caste
|
| The creature radiates fire. It will ignite, and potentially completely destroy, items the creature is standing on. Keep booze away from critters with this tag. Also gives the vermin a high chance of escaping from [[animal trap]]s and [[cage]]s made of certain materials.

|-
| {{text anchor|INTELLIGENT}}
| Caste
|
| Alias for [CAN_SPEAK] + [CAN_LEARN].

|-
| {{text anchor|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.).

|-
| {{text anchor|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

|-
| {{text anchor|LAIR}}
| Caste
| type:probability
| Found on megabeasts, semimegabeasts, and night creatures. The creature will seek out sites of this type and take them as lairs. The lair types are SIMPLE_BURROW, SIMPLE_MOUND, WILDERNESS_LOCATION, SHRINE, and LABYRINTH.

|-
| {{text anchor|LAIR_CHARACTERISTIC}}
| Caste
| characteristic:probability
| Defines certain features of the creature's lair. The only valid characteristic is HAS_DOORS.

|-
| {{text anchor|LAIR_HUNTER}}
| Caste
|
| This creature will actively hunt adventurers in its lair.

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

|-
| {{text anchor|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). When tamed, large predators tend to be much more aggressive to enemies than non-large predators, making them a good choice for an animal army. They may go on rampages in worldgen, and adventurers may receive quests to kill them. Also, they can be mentioned in the intro paragraph when starting a fortress e.g. "ere the wolves get hungry."

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

|-
| {{text anchor|LAYS_EGGS}}
| Caste
|
| Creature lays eggs instead of giving birth to live young.

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

|-
| {{text anchor|LIGAMENTS}}
| Caste
|
* [[material token]]
*healing rate
| Creature has ligaments in its bones. Cutting the bone tissue severs them, disabling motor function if the target is a limb.

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

|-
| {{text anchor|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.

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

|-
| {{text anchor|LITTERSIZE}}
| Caste
|
* minimum
* maximum
| Determines the range of how many creatures are generated when giving birth. [LITTERSIZE:1:2]

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

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

|-
| {{text anchor|LOW_LIGHT_VISION}}
| Caste
| number
| Determines how well a creature can see in the dark. Higher is better. Dwarves have 10000, which amounts to perfect nightvision.
|}

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

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

|-
| {{text anchor|MAGICAL}}
| Caste
|
| Unknown.

|-
| {{text anchor|MAGMA_VISION}}
| Caste
|
| Creature's able to see while covered in magma.

|-
| {{text anchor|MALE}}
| Caste
|
| The creature is male. Usually declared inside a caste.

|-
| {{text anchor|MANNERISM|MANNERISM_*}}
| Caste
|
*occasionally body part
| Adds a possible mannerism to the creature's profile.
See [[Creature mannerism token]] for further info.

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

|-
| {{text anchor|MATERIAL_FORCE_MULTIPLIER}}
| Caste
|
*[[Material token]]
*A:B
| Set the force multiplier of a specific material against the creature to A/B. For example, 10:1 multiplies the force by 10. {{verify}}

|-
| {{text anchor|MATUTINAL}}
| Caste
|
| Sets if the creature is active in dawn.

|-
| {{text anchor|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.

|-
| {{text anchor|MEANDERER}}
| Caste
|
| Gives a creature random movement.

|-
| {{text anchor|MEGABEAST}}
| Caste
|
| A 'boss' creature. A small number of the creature are created during worldgen, their histories and descendants (if any) will be tracked in worldgen (as opposed to simply 'spawning'), and they will occasionally go on rampages, potentially leading to worship if they attack the same place multiple times. Their presence and number will also influence age names. When appearing in Fortress Mode, they will have a pop-up message announcing their arrival.

|-
| {{text anchor|MENT_ATT_CAP_PERC}}
| Caste
|
*[[DF2012:Attribute|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).

|-
| {{text anchor|MENT_ATT_RANGE}}
| Caste
|
*[[DF2012:Attribute|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.

|-
| {{text anchor|MENT_ATT_RATES}}
| Caste
|
*[[DF2012:Attribute|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.

|-
| {{text anchor|MILKABLE}}
| Caste
|
* [[material token]]
* frequency
| Allows the creature to be milked in the farmer's workshop. The frequency is the amount of time units the creature needs to "recharge".

|-
| {{text anchor|MISCHIEVIOUS}}
| Caste
|
| Alias for MISCHIEVOUS.

|-
| {{text anchor|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."

|-
| {{text anchor|MODVALUE}}
| Caste
|
| Seemingly no longer used.

|-
| {{text anchor|MOUNT}}
| Caste
|
| Creature may be used as a mount. No use for the player, but enemy siegers may arrive with cavalry.

|-
| {{text anchor|MOUNT_EXOTIC}}
| Caste
|
| Creature may be used as a mount, but civilizations cannot domesticate it in worldgen without certain exceptions.

|-
| {{text anchor|MULTIPART_FULL_VISION}}
| Caste {{Verify}}
|
| Allows the creature to have all-around vision as long as it has multiple heads(?) that can see. {{Verify}}

|-
| {{text anchor|MULTIPLE_LITTER_RARE}}
| Caste
|
| Makes the species usually produce a single offspring per birth, occasionally producing twins or triplets using typical real-world human probabilities. Requires [[Creature_token#FEMALE|FEMALE]]. Compare with [[Creature_token#LITTERSIZE|LITTERSIZE]]. If LITTERSIZE and MULTIPLE_LITTER_RARE are both absent, one offspring is guaranteed per birth.

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

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

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

|-
| {{text anchor|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. If left undefined, the creature will be labeled as "nothing" by the game.

|-
| {{text anchor|NATURAL}}
| Caste
|
| Animal is considered to be natural. Creatures with AT_PEACE_WITH_WILDLIFE will not fight with them.

|-
| {{text anchor|NATURAL_ANIMAL}}
| Caste
|
| Alias of NATURAL.

|-
| {{text anchor|NATURAL_SKILL}}
| Caste
| [[Skill_token|Skill token]]:value
| The creature possesses this skill at this level inherently. It begins with this skill at this level, and the skill may never rust below this level. A value of 16 is legendary. Requires CAN_LEARN or INTELLIGENT to function in .25 or earlier.

|-
| {{text anchor|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. This does not affect the creature's presence elsewhere, such as for generated megabeasts, normal creatures, entity members, etc. Setting the number of bogeyman types to zero in the world gen parameters will remove only the randomly-generated bogeymen.

|-
| {{text anchor|NIGHT_CREATURE_HUNTER}}
| Caste
|
| A very small population of the creature will be created during worldgen (sometimes only a single individual will be created), and their histories will be tracked (that is, they will not spawn spontaneously later, they must either have children or convert other creatures to increase their numbers). The creature will settle in a lair and go on rampages during worldgen. If this creature has SPOUSE_CONVERTER, it will actively attempt to seek out potential conversion targets to abduct, convert, and have children with (if possible).

This tag causes the usual behaviour of [[werebeast]]s in worldgen, that is, fleeing towns upon being cursed and conducting raids from a lair. If this tag is absent from a deity curse, the accursed will simply be driven out of towns in a similar manner to [[vampire]]s.

|-
| {{text anchor|NO_AUTUMN}}
| Caste
|
| This creature caste does not appear in [[Calendar|autumn]].

|-
| {{text anchor|NO_CONNECTIONS_FOR_MOVEMENT}}
| Caste
|
| Creature doesn't require connected body parts to move{{verify}}; generally used on undead creatures with connections that have rotted away.

|-
| {{text anchor|NO_DIZZINESS}}
| Caste
|
| Creature cannot become dizzy.

|-
| {{text anchor|NO_DRINK}}
| Caste
|
| Creature does not need to drink.

|-
| {{text anchor|NO_EAT}}
| Caste
|
| Creature does not need to eat.

|-
| {{text anchor|NO_FEVERS}}
| Caste
|
| Creature cannot suffer fevers.

|-
| {{text anchor|NO_GENDER}}
| Caste
|
| Creature has no gender.

|-
| {{text anchor|NO_PHYS_ATT_GAIN}}
| Caste
|
| The affected caste cannot gain any physical skills.

|-
| {{text anchor|NO_PHYS_ATT_RUST}}
| Caste
|
| The affected caste cannot lose any physical skills.

|-
| {{text anchor|NO_SLEEP}}
| Caste
|
| Creature does not need to sleep.

|-
| {{text anchor|NO_SPRING}}
| Caste
|
| This creature caste does not appear in [[Calendar|spring]].

|-
| {{text anchor|NO_SUMMER}}
| Caste
|
| This creature caste does not appear in [[Calendar|summer]].

|-
| {{text anchor|NO_THOUGHT_CENTER_FOR_MOVEMENT}}
| Caste
|
| Creature doesn't require an organ with the [THOUGHT] tag to survive or attack; generally used on creatures that don't have brains.

|-
| {{text anchor|NO_UNIT_TYPE_COLOR}}
| Caste
|
| Prevents creature from selecting its color based on its profession (e.g. Miner, Hunter, Wrestler).

|-
| {{text anchor|NO_VEGETATION_PERTURB}}
| Caste{{Verify}}
|
| Likely prevents the creature from leaving broken vegetation tracks.{{Verify}}

|-
| {{text anchor|NO_WINTER}}
| Caste
|
| This creature caste does not appear in [[Calendar|winter]].

|-
| {{text anchor|NOBONES}}
| Caste
|
| Creature has no bones.

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

|-
| {{text anchor|NOCTURNAL}}
| Caste
|
| Sets if the creature is active in night.

|-
| {{text anchor|NOEMOTION}}
| Caste
|
| The creature has no emotions, and does not rage.

|-
| {{text anchor|NOEXERT}}
| Caste
|
| Creature can't become tired or over-exerted from taking too many combat actions.

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

|-
| {{text anchor|NOMEAT}}
| Caste
|
| Creature will not drop meat when butchered.

|-
| {{text anchor|NONAUSEA}}
| Caste
|
| Creature isn't nauseated by gut hits and cannot vomit.

|-
| {{text anchor|NOPAIN}}
| Caste
|
| Creature doesn't feel pain.

|-
| {{text anchor|NOSKIN}}
| Caste
|
| Creature will not drop a hide when butchered.

|-
| {{text anchor|NOSKULL}}
| Caste
|
| Creature will not drop a skull on butcher, rot, or decay of severed head.

|-
| {{text anchor|NOSMELLYROT}}
| Caste
|
| Does not produce miasma when rotting.

|-
| {{text anchor|NOSTUCKINS}}
| Caste
|
| Weapons can't get stuck in creature.

|-
| {{text anchor|NOSTUN}}
| Caste
|
| Creature can't be stunned. Creatures with this tag never wake up from sleep in Fortress Mode and stay drowsy.{{verify}} If this creature must eat and drink while playing, it WILL die.

|-
| {{text anchor|NOT_BUTCHERABLE}}
| Caste
|
| Cannot be butchered

|-
| {{text anchor|NOT_LIVING}}
| Caste
|
| Cannot be raised from the dead.

|-
| {{text anchor|NOTHOUGHT}}
| Caste
|
| Creature doesn't require a [THOUGHT] body part to survive. If it does not have NO_THOUGHT_CENTER_FOR_MOVEMENT as well, it will be unable to use any attacks other than the default 'push'. Has the added effect of preventing speech.
|}

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

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

|-
| {{text anchor|ODOR_LEVEL}}
| Caste
| number
| How easy the creature is to smell. The higher the number, the easier the creature can be smelled. Zero is odorless. Default is 50.

|-
| {{text anchor|ODOR_STRING}}
| Caste
| string
| What the creature smells like. If no odor string is defined, the creature name (not the caste name) is used.

|-
| {{text anchor|OPPOSED_TO_LIFE}}
| Caste
|
| Is hostile to all creatures except undead and other non-living ones. Used for [[Undead]].

|-
| {{text anchor|ORIENTATION}}
| Caste
| MALE/FEMALE:disinterested chance:lover-possible chance:commitment-possible chance
| Determines caste's likelihood of having sexual attraction to certain sexes. Values default to 75:20:5 for the same sex and 5:20:75 for the opposite sex. The values themselves are simply ratios and do not need to add up to any particular value.

|}

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

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

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

|-
| {{text anchor|PARALYZEIMMUNE}}
| Caste
|
| The creature is immune to all paralyzing special attacks.

|-
| {{text anchor|PATTERNFLIER}}
| Caste
|
| Unknown. No creatures currently have this token.

|-
| {{text anchor|PEARL}}
| Caste
|
| In earlier versions, creature would generate pearls. Does nothing in the current version.

|-
| {{text anchor|PENETRATEPOWER}}
| Caste
| value
| Controls the ability of vermin to find a way into containers when they are eating food from your stockpiles.

|-
| {{text anchor|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.

|-
| {{text anchor|PET}}
| Caste
|
| Allows the creature to be tamed in Fortress mode. Prequisite for all other working animal roles and allows all females of the species to breed regardless of marital status. Civilizations that encounter it in worldgen will tame and domesticate it for their own use.

|-
| {{text anchor|PET_EXOTIC}}
| Caste
|
| Allows the creature to be tamed in Fortress mode. Prequisite for all other working animal roles and allows all females of the species to breed regardless of marital status. Civilizations cannot domesticate it in worldgen without certain exceptions. More difficult to tame?{{verify}}

|-
| {{text anchor|PETVALUE}}
| Caste
| value
| How valuable a tamed animal is. Actual cost in points in the embarking screen is 1+(PETVALUE/2) for an untrained animal, 1+PETVALUE for a war/hunting one.

|-
| {{text anchor|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.

|-
| {{text anchor|PHYS_ATT_CAP_PERC}}
| Caste
|
*[[DF2012:Attribute|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).

|-
| {{text anchor|PHYS_ATT_RANGE}}
| Caste
|
*[[DF2012:Attribute|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.

|-
| {{text anchor|PHYS_ATT_RATES}}
| Caste
|
*[[DF2012:Attribute|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.

|-
| {{text anchor|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.

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

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

|-
| {{text anchor|POPULATION_NUMBER}}
| Creature
| min:max
| The minimum/maximum numbers of how many of these creatures are present in each world map tile of the appropriate region.

|-
| {{text anchor|POWER}}
| Caste
|
| Allows the being to represent itself as a deity. Requires CAN_SPEAK to actually do anything more than settle at a location (e.g. write books, lead armies, profane temples). Doesn't appear to do anything for creatures that are already civilized.

|-
| {{text anchor|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

|-
| {{text anchor|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.

|-
| {{text anchor|PRONE_TO_RAGE}}
| Caste
| Chance
| Creature has a percentage chance to flip out at visible non-friendly creatures. Enraged creatures attack anything regardless of timidity and get a strength bonus to their hits. This is what makes badgers so hardcore.

|-
| {{text anchor|PUS}}
| Caste
|
* [[material token]]
*matter state (LIQUID, GAS, SOLID)
| The creature has pus. Specifies the stuff secreted by infected wounds.
|}

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

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

|-
| {{text anchor|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.

|-
| {{text anchor|REMAINS}}
| Caste
| singular:plural
| What creature's remains are called.

|-
| {{text anchor|REMAINS_COLOR}}
| Caste
|
| What color creature's remains are.

|-
| {{text anchor|REMAINS_ON_VERMIN_BITE_DEATH}}
| Caste
|
| Goes with VERMIN_BITE and DIE_WHEN_VERMIN_BITE, the vermin creature will leave remains on death when biting. Leaving this tag out will cause the creature to disappear entirely after it bites.

|-
| {{text anchor|REMAINS_UNDETERMINED}}
| Caste
|
| Unknown.

|-
| {{text anchor|REMOVE_MATERIAL}}
| Creature
|
*material token
| Removes a material from a creature.

|-
| {{text anchor|REMOVE_TISSUE}}
| Creature
|
*material token
| Removes a tissue from a creature.

|-
| {{text anchor|RETRACT_INTO_BP}}
| Caste
|
*BY_TYPE, BY_CATEGORY or BY_TOKEN
*TYPE, CATEGORY or TOKEN
| The creature will retract into a body part when threatened. It will be unable to move or attack, but enemies will only be able to attack the specified body part.

|-
| {{text anchor|RETURNS_VERMIN_KILLS_TO_OWNER}}
|
|
| Cat behavior. If it kills a vermin creature and has an owner, it carries the remains in its mouth and drops them at his feet. Requires HUNTS_VERMIN, obviously.

|-
| {{text anchor|ROOT_AROUND}}
| Caste
|
| Creature will occasionally root around in the grass, looking for insects. Used for flavor in Adventure Mode, spawns vermin edible by this creature in Fortress Mode.

|}

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

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

|-
| {{text anchor|SAVAGE}}
| Creature
|
| The creature will only show up in "savage" biomes.

|-
| {{text anchor|SECRETION}}
| Caste
|
* [[material token]]
*Material State
*location secreted from (by_type, by_category, by_token)
*body part
*tissue layer
*trigger
| creates a secreted material on given tissue on a given part of the body. Valid triggers are:
*CONTINUOUS
*EXTREME_EMOTION
*EXERTION

|-
| {{text anchor|SELECT_ADDITIONAL_CASTE}}
| Creature
|
*caste name
| adds an additional previously defined caste to the selection. Used after SELECT_CASTE.

|-
| {{text anchor|SELECT_CASTE}}
| Creature
|
*caste name, or ALL
| selects a previously defined caste

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

|-
| {{text anchor|SEMIMEGABEAST}}
| Caste
|
| Essentially the same as MEGABEAST, but more of them are created during worldgen.

|-
| {{text anchor|SENSE_CREATURE_CLASS}}
| Caste
|
* Creature class
* [[Tilesets|Tile]]
* [[Color|Color]]
| Allows creature to sense creatures with a certain creature class through walls, floors etc. Sense will be with tile and color specified.

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

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

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

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

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

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

|-
| {{text anchor|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]. Requires CAN_LEARN or INTELLIGENT to function.

|-
| {{text anchor|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.

|-
| {{text anchor|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.

|-
| {{text anchor|SLOW_LEARNER}}
| Caste
|
| Shorthand for [CAN_LEARN] + [SKILL_LEARN_RATES:50].{{verify}} Used for ogres and giants. Applicable to player races.

|-
| {{text anchor|SMALL_REMAINS}}
| Caste
|
| Creature leaves a "remains" instead of a corpse. Used for vermin.

|-
| {{text anchor|SMELL_TRIGGER}}
| Creature
| value
| Determines how keen a creature's sense of smell is. Lower is better. At 10000, a creature cannot smell at all.

|-
| {{text anchor|SOLDIER_ALTTILE}}
| 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.

|-
| {{text anchor|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.
* First-person reads "You '''bark'''"
* Third-person reads "The capybara '''barks'''"
* Out of sight reads "You hear '''a loud bark'''"
with the text in bold being the description arguments of the token.

|-
| {{text anchor|SPECIFIC_FOOD}}
| Caste
|
* PLANT or CREATURE
* Plant/creature ID
| Creature can will only graze or eat the designated plant or creature parts.

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

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

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

|-
| {{text anchor|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.

|-
| {{text anchor|SPOUSE_CONVERSION_TARGET}}
| Caste
|
| This creature can be converted by a night creature with SPOUSE_CONVERTED.

|-
| {{text anchor|SPOUSE_CONVERTER}}
| Caste
|
| If the creature has the NIGHT_CREATURE_HUNTER tag, it will kidnap SPOUSE_CONVERSION_TARGETs and transform them into the caste of its species with the CONVERTED_SPOUSE tag during worldgen. It may also start families this way.

|-
| {{text anchor|STANCE_CLIMBER}}
| Caste {{verify}}
|
| Caste does not require GRASP body parts to climb -- it can climb with STANCE parts instead.

|-
| {{text anchor|SUPERNATURAL}}
| Caste
|
| Gives the creature knowledge of any secrets with SUPERNATURAL_LEARNING_POSSIBLE that match its spheres. Other effects are unknown.

|-
| {{text anchor|SWIMS_INNATE}}
| Caste
|
| The creature naturally knows how to swim, as opposed to [SWIMS_LEARNED] below. However, Fortress mode AI never paths into water anyway, so it's less useful there.

|-
| {{text anchor|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

|-
| {{text anchor|TENDONS}}
| Caste
|
* [[material token]]
*healing rate
| The creature has tendons in its bones. Cutting the bone tissue severs them, disabling motor function if the target is a limb.

|-
| {{text anchor|THICKWEB}}
| Caste
|
| The creature's webs can catch larger creatures.

|-
| {{text anchor|TISSUE}}
| Creature
| name
| Begins defining a tissue in the creature file.

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

|-
| {{text anchor|TL_COLOR_MODIFIER}}
| Caste
| COLOR:freq:COLOR:freq etc.
| Creates a list of color patterns, giving each a relative frequency.

|-
| {{text anchor|TLCM_GENETIC_MODEL}}
| Caste
|
| The way the color modifier is passed on to offspring. May or may not work right now.{{verify}}

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

|-
| {{text anchor|TLCM_NOUN}}
| Caste
|
*name
*SINGULAR or PLURAL
| Names the tissue layer color modifier, and determines the noun. Also used by stonesense for colouring body parts.

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

|-
| {{text anchor|TRADE_CAPACITY}}
| Caste
|
| How much the creature can carry when used by merchants.

|-
| {{text anchor|TRAINABLE}}
| Caste
|
| Shortcut for [TRAINABLE_HUNTING] + [TRAINABLE_WAR].

|-
| {{text anchor|TRAINABLE_HUNTING}}
| Caste
|
| Can be trained as a hunting beast, increasing speed.

|-
| {{text anchor|TRAINABLE_WAR}}
| Caste
|
| Can be trained as a war beast, increasing strength and endurance.

|-
| {{text anchor|TRANCES}}
| Caste
|
| Allows the creature to go into martial trances.

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

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

|-
| {{text anchor|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

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

|-
| {{text anchor|UNDERGROUND_DEPTH}}
| Creature
|
*mindepth
*maxdepth
| Depth the creature appears underground. Numbers can be from 0 to 5. 0 is actually 'above ground' and can be used if the creature is to appear both above and below ground. A single argument may be used instead of min and max. Only magma creatures use 4 or 5 in the default raws. [[Demon]]s use only 5:5; user-defined creatures with both this depth and [FLIER] will take part in the initial wave from the HFS alongside generated demons. Without [FLIER], they will only spawn from the map edges. Civilizations that can use underground plants or animals will only export (via the embark screen or caravans) things that available at depth 1.

|-
| {{text anchor|UNDERSWIM}}
| Caste
|
| Creature swims under the water and can't be seen. Seems to be a relic from the 2D era.

|-
| {{text anchor|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.

|-
| {{text anchor|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."

|-
| {{text anchor|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.

|-
| {{text anchor|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.

|-
| {{text anchor|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.

|-
| {{text anchor|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.

|-
| {{text anchor|UTTERANCES}}
| Caste
|
| Changes the language of the creature into unintelligible 'kobold-speak', which creatures of other species will be unable to understand. If a civilized creature has this and is not part of a SKULKING civ, it will tend to start wars with all nearby civilizations and will be unable to make peace treaties due to 'inability to communicate'.
|}

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

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

|-
| {{text anchor|VEGETATION}}
| Caste
|
| The creature is made of swamp stuff. Used for [[grimeling]]s.

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

|-
| {{text anchor|VERMIN_EATER}}
| Creature
|
| The vermin creature will attempt to eat exposed food. See PENETRATEPOWER. Distinct from VERMIN_ROTTER.

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

|-
| {{text anchor|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).

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

|-
| {{text anchor|VERMIN_MICRO}}
| Caste
|
| This makes the creature move in a swarm of creatures of the same race as it (e.g. swarm of flies, swarm of ants).

|-
| {{text anchor|VERMIN_NOFISH}}
| Caste
|
| The creature cannot be caught by fishing.

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

|-
| {{text anchor|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.

|-
| {{text anchor|VERMIN_ROTTER}}
| Creature
|
| Present on flies, knuckle worms, acorn flies, and blood gnats. Attracted to rotting stuff left in the open. Speeds up decay?{{verify}}

|-
| {{text anchor|VERMIN_SOIL}}
| Creature
|
| The creature randomly appears near dirt or mud.

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

|-
| {{text anchor|VERMINHUNTER}}
| Caste
|
| Old shorthand for "does cat stuff". Contains [AT_PEACE_WITH_WILDLIFE] + [RETURNS_VERMIN_KILLS_TO_OWNER] + [HUNTS_VERMIN] + [ADOPTS_OWNER].

|-
| {{text anchor|VESPERTINE}}
| Caste
|
| Sets if the creature is active in evening.

|-
| {{text anchor|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.

|-
| {{text anchor|VISION_ARC}}
| Caste {{Verify}}
|
*binocular vision arc
*non-binocular vision arc
| The width of the creature's vision arcs. The first number is binocular vision, the second is non-binocular vision.
|}

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

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

|-
| {{text anchor|WAGON_PULLER}}
| Caste
|
| Allows the creature to pull caravan wagons. If a civilization doesn't have access to any, it is restricted to trading with pack animals.

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

|-
| {{text anchor|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

|-
| {{text anchor|ATTACK_SKILL}}
| Caste
|
*[[Skill token]]
| Defines the skill used by the attack.

|-
| {{text anchor|ATTACK_VERB}}
| Caste
| 2nd person:3rd person
| Descriptive text for the attack.

|-
| {{text anchor|ATTACK_CONTACT_PERC}}
| Caste
|
*% value
| The contact area of the attack, measured in % of the body part's volume. Note that all attack percentages can be more than 100%.

|-
| {{text anchor|ATTACK_PENETRATION_PERC}}
| Caste
|
*% value
| The penetration value of the attack, measured in % of the body part's volume. Requires ATTACK_FLAG_EDGE. Maximum value: 15000.

|-
| {{text anchor|ATTACK_PRIORITY}}
| Caste
|
*MAIN or SECOND
| Usage frequency. MAIN attacks are 100 times more frequently chosen than SECOND. Opportunity attacks ignore this preference.

|-
| {{text anchor|ATTACK_VELOCITY_MODIFIER}}
| Caste
| number
| The velocity multiplier of the attack, multiplied by 1000.

|-
| {{text anchor|ATTACK_FLAG_CANLATCH}}
| Caste
|
| Attacks that damage tissue have the chance to latch on in a wrestling hold. The grabbing bodypart can then use the "shake around" wrestling move, causing severe, armor-bypassing tensile damage according to the attacker's body volume.

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

|-
| {{text anchor|ATTACK_FLAG_EDGE}}
| Caste
|
| The attack is edged, with all the effects on physical resistance and contact area that it entails.

|-
| {{text anchor|ATTACK_PREPARE_AND_RECOVER}}
| Caste
|
* Preparation time
* Recovery time
| Determines the length of time to prepare this attack and until one can perform this attack again. Values appear to be calculated in adventure mode ticks.

|-
| {{text anchor|ATTACK_FLAG_BAD_MULTIATTACK}}
| Caste
|
| Multiple strikes with this attack cannot be performed effectively.

|-
| {{text anchor|ATTACK_FLAG_INDEPENDENT_MULTIATTACK}}
| Caste
|
| Multiple strikes with this attack can be performed with no penalty.

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

|-
| {{text anchor|SPECIALATTACK_INTERACTION}}
| Caste
| interaction
| When this attack lands successfully, an interaction with I_SOURCE:ATTACK will take effect on the target creature. The attack must break the target creature's skin in order to work. This will take effect in worldgen as well.

|-
| {{text anchor|SPECIALATTACK_SUCK_BLOOD}}
| Caste
| min:max
| Successful attack draws out an amount of blood randomized between the min and max value. Beware that this '''will''' trigger any ingestion syndromes attached to the target creature's blood - for example, using this attack on a vampire will turn you into one too.
|}

==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 properties of previously defined tissues. (See also [[Tissue definition token]])

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

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

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

|-
| {{text anchor|SELECT_TISSUE}}
| Creature
|
*tissue token
| Selects a tissue for editing.

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

|-
| {{text anchor|SET_LAYER_TISSUE}}
| Caste
|
| Sets a tissue layer to be made of a different tissue.

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

|-
| {{text anchor|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).

|-
| {{text anchor|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:<br>
[TISSUE:GAS] [TISSUE_NAME:gas:NP] [TISSUE_MATERIAL:LOCAL_CREATURE_MAT:GAS] [TISSUE_MAT_STATE:GAS] [RELATIVE_THICKNESS:50] [TISSUE_LEAKS] [TISSUE_SHAPE:LAYER]
|-
| {{text anchor|TISSUE_LAYER_APPEARANCE_MODIFIER}}
| Caste
|
*QUALITY
*lowest:lower:low:median:high:higher:highest
| sets the range of qualities, including LENGTH, DENSE, HIGH_POSITION, CURLY, GREASY, WRINKLY

|-
| {{text anchor|TISSUE_STYLE_UNIT}}
| Caste
|
*tissue style unit ID
*shaping
| sets tissue layer to be the target of TISSUE_STYLE token specified for an entity, works only on entity members. Mostly used with tissues HAIR, BEARD, MOUSTACHE, SIDEBURNS.

|-
| {{text anchor|TL_CONNECTS}}
| Caste
|
| Presumably gives the CONNECTS attribute to selected layers.

|-
| {{text anchor|TL_HEALING_RATE}}
| Caste
|
| Presumably changes the HEALING_RATE of the selected tissue layers.

|-
| {{text anchor|TL_MAJOR_ARTERIES}}
| Caste
|
| Gives the "major arteries" attribute to selected layers. Used to add massive bleeding properties to the throat, made from skin.

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

|-
| {{text anchor|TL_RELATIVE_THICKNESS}}
| Caste
|
| Seems to set new relative thickness for selected tissue layers.

|-
| {{text anchor|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}}

Creature token

2014-08-26T18:43:25Z

Talvieno: Changed quality rating from "Exceptional" to "Tattered" using the rating script

{{Quality|Tattered|18:43, 26 August 2014 (UTC)}}
{{Migrated_article}}
{{av}}

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

|-
| {{text anchor|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}}

|-
| {{text anchor|ALCOHOL_DEPENDENT}}
| Caste
|
| Creature needs alcohol to get through the working day, choosing to drink booze instead of water if possible. Going sober for too long reduces speed.

|-
| {{text anchor|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.

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

|-
| {{text anchor|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}}

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

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

|-
| {{text anchor|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.

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

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

|-
| {{text anchor|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.

|-
| {{text anchor|APPLY_CREATURE_VARIATION}}
| Special
|
*CV TEMPLATE NAME
| Applies the specified [[creature variation token|creature variation]].

|-
| {{text anchor|APPLY_CURRENT_CREATURE_VARIATION}}
| Special
|
| Applies the effects of all pending [[#CV_ADD_TAG|CV_ADD_TAG]] and [[#CV_REMOVE_TAG|CV_REMOVE_TAG]] tokens that have been defined in the current creature.

|-
| {{text anchor|AQUATIC}}
| Caste
|
| Creature can breathe in water, but air-drowns on dry land.

|-
| {{text anchor|ARENA_RESTRICTED}}
| Caste
|
| Does not appear in arena mode list.

|-
| {{text anchor|ARTIFICIAL_HIVEABLE}}
| Creature
|
| Can be kept in artificial hives by beekeepers.

|-
| {{text anchor|AT_PEACE_WITH_WILDLIFE}}
| Caste
|
| Does not attack or frighten creatures with the NATURAL tag.

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

|-
| {{text anchor|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

|-
| {{text anchor|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.

|-
| {{text anchor|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.

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

|-
| {{text anchor|BENIGN}}
| Caste
|
| The creature is non-aggressive by default, but may lash out if agitated or disturbed.

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

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

|-
| {{text anchor|BLOODSUCKER}}
| Caste
|
| Seems to be required to make the creature denouncable as a creature of the night.

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

|-
| {{text anchor|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:'''<br />
[BODY_APPEARANCE_MODIFIER:HEIGHT:90:95:98:100:102:105:110] <br />
''HEIGHT'' : marks the height to be changed <br />
''90:95:98:100:102:105:110'' : sets the range from the shortest (90% of the average height) to the tallest (110% of the average height) creature variation.

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

|-
| {{text anchor|BODY_SIZE}}
| Caste
| years:days:size
| Sets size at a given age. Size is in cubic centimeters, and for normal body materials is roughly equal to the creature's average weight in grams.
'''Example:'''<br />
[BODY_SIZE:0:0:10000]<br />
[BODY_SIZE:1:168:50000]<br />
[BODY_SIZE:12:0:220000]<br />
This describes the size of a [[minotaur]]. His birth size would be 10,000 cm<sup>3</sup> (~10 kg). At 1 year and 168 days old he would be 50,000 cm<sup>3</sup> (~50 kg). And as an adult (at 12 years old) he would be 220,000 cm<sup>3</sup> and weigh roughly 220 kg.

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

|-
| {{text anchor|BONECARN}}
| Caste
|
| Creature eats bones. Implies CARNIVORE and has the same worldgen problem.

|-
| {{text anchor|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)

|-
| {{text anchor|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

|-
| {{text anchor|CAN_DO_INTERACTION}}
| Caste
| interaction token
| The creature can perform an interaction. See [[interaction token]].

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

|-
| {{text anchor|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}}

|-
| {{text anchor|CANNOT_CLIMB}}
| Caste {{Verify}}
|
| Creature cannot climb, even if it has free grasps.

|-
| {{text anchor|CANNOT_JUMP}}
| Caste
|
| Creature cannot jump.

|-
| {{text anchor|CANNOT_UNDEAD}}
| Caste
|
| Alias for NOT_LIVING

|-
| {{text anchor|CANOPENDOORS}}
| Caste
|
| Allows the creature to open doors.

|-
| {{text anchor|CARNIVORE}}
| Caste
|
| Creature ''only'' eats meat. If the creature goes on rampages in worldgen, it will often devour the people/animals it kills. Currently bugged in worldgen -- exclusively carnivore civilizations always starve out. Goblins and kobolds live off raw exceptions. Civilizations with [NO_EAT] token will still starve to death.

|-
| {{text anchor|CASTE}}
| Creature
|
*name
| Defines a caste.

|-
| {{text anchor|CASTE_ALTTILE}}
| Caste
|
*tile number or "letter"
| Caste-specific ALT_TILE. Requires CASTE_TILE.

|-
| {{text anchor|CASTE_COLOR}}
| Caste
|
*fg
*bg
*brightness
| Caste-specific COLOR.

|-
| {{text anchor|CASTE_GLOWCOLOR}}
| Caste
|
*fg
*bg
*brightness
| Caste-specific GLOWCOLOR.

|-
| {{text anchor|CASTE_GLOWTILE}}
| Caste
|
*tile value or "letter"
| Caste-specific GLOWTILE.

|-
| {{text anchor|CASTE_NAME}}
| Caste
| singular:plural:adjective
| Caste-specific NAME.

|-
| {{text anchor|CASTE_PROFESSION_NAME}}
| Caste
|
*[[Unit type token]] (Profession)
*singular
*plural
| Caste-specific PROFESSION_NAME.

|-
| {{text anchor|CASTE_SOLDIER_ALTTILE}}
| Caste
| 'character' or tile number
| Caste-specific SOLDIER_ALTTILE. Requires CASTE_SOLDIER_TILE.

|-
| {{text anchor|CASTE_SOLDIER_TILE}}
| Caste
| 'character' or tile number
| Caste-specific CREATURE_SOLDIER_TILE.

|-
| {{text anchor|CASTE_SPEECH}}
| Caste
| speech file
| Caste-specific SPEECH.

|-
| {{text anchor|CASTE_TILE}}
| Caste
|
* tile number or "letter"
| Caste-specific CREATURE_TILE.

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

|-
| {{text anchor|CDI}}
| Caste
| Varies
| Specifies details for the preceding CAN_DO_INTERACTION token. See [[Interaction token]].

|-
| {{text anchor|CHANGE_BODY_SIZE_PERC}}
| Caste
| integer
| Multiplies body size by a factor of (integer)%. 50 halves size, 200 doubles.

|-
| {{text anchor|CHANGE_FREQUENCY_PERC}}
| Creature
| integer
| Multiplies frequency by a factor of (integer)%.

|-
| {{text anchor|CHILD}}
| Caste
| integer
| age at which creature is considered an adult. One can think of this as the duration of the child stage.

|-
| {{text anchor|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.

|-
| {{text anchor|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]

|-
| {{text anchor|CLUTCH_SIZE}}
| Caste
|
*min
*max
|Number of eggs laid in one sitting.

|-
| {{text anchor|COLONY_EXTERNAL}}
| Caste
|
| Caste hovers around colony.

|-
| {{text anchor|COLOR}}
| Creature
| foreground:background:brightness
| Color of the creature's tile. See [[Color]] for usage.

|-
| {{text anchor|COMMON_DOMESTIC}}
| Caste
|
| Any civilization with USE_COMMON_DOMESTIC tag (humans, dwarves) has domesticated this creature by default and always has access to it, even without any wild populations. Useless without PET, PACK_ANIMAL, WAGON_PULLER or MOUNT tags and invalid on FANCIFUL creatures. Requires NATURAL tag?{{verify}}

|-
| {{text anchor|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.

|-
| {{text anchor|COOKABLE_LIVE}}
| Caste
|
| Set this to allow the creature to be cooked in meals without first being butchered/cleaned. Used for mussels, for one.

|-
| {{text anchor|CRAZED}}
| Caste
|
| Creature is 'berserk' and will attack all other creatures, except members of its own species that ALSO have the CRAZED tag.

|-
| {{text anchor|COPY_TAGS_FROM}}
| Special
|
*CREATURE NAME
| Copies tags from another specified creature.

|-
| {{text anchor|CREATURE_CLASS}}
| Caste
|
*classname
| An arbitrary creature classification. Can be set to anything, but only existing uses are GENERAL_POISON (used in syndromes) and EDIBLE_GROUND_BUG (valid targets for GOBBLE_VERMIN_x tokens). A single creature can have multiple classes. Eligibility for certain entity positions can also be permitted or restricted by this tag.

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

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

|-
| {{text anchor|CREPUSCULAR}}
| Caste
|
| Sets if the creature is active at twilight.

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

|-
| {{text anchor|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.

|-
| {{text anchor|CURIOUSBEAST_ITEM}}
| Caste
|
| Allows a creature to steal things (apparently the highest value it can find). If the creature goes on rampages in worldgen, it will often steal items instead of attacking. Kea birds are infamous for this.

|-
| {{text anchor|CV_ADD_TAG}}
| Special
|
*TAG NAME
| Adds a tag. Used in conjunction with creature variation templates.

|-
| {{text anchor|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

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

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

|-
| {{text anchor|DIE_WHEN_VERMIN_BITE}}
| Caste
|
| Dies upon attacking. Used for [[bee]] stings.

|-
| {{text anchor|DIFFICULTY}}
| Caste
| integer
| Increases experience gain during adventure mode. Creatures with 11 or higher are not assigned for quests in adventure mode.

|-
| {{text anchor|DIURNAL}}
| Caste
|
| Sets if the creature is active in day.

|-
| {{text anchor|DIVE_HUNTS_VERMIN}}
| Caste
|
| Found on [[peregrine falcon]]s. The creature hunts vermin by diving from the air. Does not seem to work on tame creatures.

|-
| {{text anchor|DOES_NOT_EXIST}}
| Creature
|
| Creature does not actually exist; used for a few [[fanciful]] creatures of myth.
|}

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

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

|-
| {{text anchor|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.

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

|-
| {{text anchor|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.

|-
| {{text anchor|EGG_SIZE}}
| Caste
|
*size
| Determines the size of eggs.

|-
| {{text anchor|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.

|-
| {{text anchor|EQUIPS}}
| Caste
|
| Allows the creature to wear or wield items.

|-
| {{text anchor|EVIL}}
| Creature
|
| Creature is considered evil and will only show up in evil biomes. Civilizations with USE_EVIL_ANIMALS can domesticate them regardless of exotic status. Has no effect on cavern creatures.

|-
| {{text anchor|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.

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

|-
| {{text anchor|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

|-
| {{text anchor|FANCIFUL}}
| Creature
|
| The creature is a thing of legend and known to all civilizations. Its materials cannot be requested or preferred. The tag also adds some art value modifiers. Used for things like dragons and other legendary creatures. Conflicts with {{token|COMMON_DOMESTIC|c}}

|-
| {{text anchor|FEATURE_ATTACK_GROUP}}
| Caste
|
| Found on subterranean animal-man tribals.

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

|-
| {{text anchor|FEMALE}}
| Caste
|
| The creature is female and can bear young. Usually determined inside a caste.

|-
| {{text anchor|FIREIMMUNE}}
| Caste
|
| The creature is immune to FIREBALL and FIREJET attacks.

|-
| {{text anchor|FIREIMMUNE_SUPER}}
| Caste
|
| The creature is immune to DRAGONFIRE attacks. Implies {{token|FIREIMMUNE|c}}.

|-
| {{text anchor|FISHITEM}}
| Caste
|
| Needs to be cleaned at a fishery

|-
| {{text anchor|FIXED_TEMP}}
| Caste
| temperature
| The natural heat generated by the creature.

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

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

|-
| {{text anchor|FREQUENCY}}
| Creature
|
*number, max 100
| Determines the chances of a creature appearing within its environment, with higher values resulting in more frequent appearance. The game effectively considers all creatures that can possibly appear and uses the FREQUENCY value as a ''weight'' - for example, if there are three creatures with frequencies 10/25/50, the creature with [FREQUENCY:50] will appear approximately 58.8% of the time. Defaults to 50 if not specified. Not to be confused with {{token|POP_RATIO|c}}.
|}

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

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

|-
| {{text anchor|GAIT}}
| Unknown
|
* type (WALK, CLIMB, SWIM, CRAWL, or FLY)
* gait name
* full speed
* build up time:max turning speed:start speed (or NO_BUILD_UP for instant use)
* energy use
* Optional flags:
** LAYERS_SLOW - if gait is slowed by increased weight
** STRENGTH - if gait is affected by strength stat
** AGILITY - if gait is affected by agility stat
** STEALTH_SLOWS:penalty - if gait is slowed by being stealthed
| Defines a gait at which the creature can move. See [[Gait]] for more information.

|-
| {{text anchor|GENERAL_BABY_NAME}}
| Creature
| singular:plural
| BABYNAME applied regardless of caste.

|-
| {{text anchor|GENERAL_CHILD_NAME}}
| Creature
| singular:plural
| CHILDNAME applied regardless of caste.

|-
| {{text anchor|GENERAL_MATERIAL_FORCE_MULTIPLIER}}
| Caste
| A:B
| Attacks against the creature have their force modified by A/B. For example, 1:2 will halve the force of an attack made against the creature. {{verify}}

|-
| {{text anchor|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.

|-
| {{text anchor|GETS_INFECTIONS_FROM_ROT}}
| Caste
|
| Creature can get infections from necrotic tissue.

|-
| {{text anchor|GETS_WOUND_INFECTIONS}}
| Caste
|
| This creature's wounds can become infected if left untreated for too long.

|-
| {{text anchor|GLOWCOLOR}}
| Creature
|
*foreground
*background
*brightness
| The colour of the creature's GLOWTILE.

|-
| {{text anchor|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.

|-
| {{text anchor|GNAWER}}
| Caste
| verb
| The creature can and will gnaw its way out of [[animal trap]]s and [[cage]]s using the specified verb, depending on the material from which it is made (normally wood). Currently, all gnawers brought onto the map by [[Elf|Elven]] caravans will almost immediately escape from their wooden cages{{bug|6343}}.

|-
| {{text anchor|GOBBLE_VERMIN_CLASS}}
| Caste
| class
| The creature eats vermin of the specified class.

|-
| {{text anchor|GOBBLE_VERMIN_CREATURE}}
| Caste
| creature:caste
| The creature eats a specified vermin.

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

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

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

|-
| {{text anchor|GOOD}}
| Creature
|
| Creature is considered good and will only show up in good biomes. [[unicorn]]s for example. Civilizations with USE_GOOD_ANIMALS can domesticate them regardless of exotic status. Presumably has no effect on cavern creatures.

|-
| {{text anchor|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.

|-
| {{text anchor|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.

|-
| {{text anchor|GRAZER}}
| Caste
|
*number
| The creature is a grazer. If tamed in Fortress mode, it needs a pasture to survive. The higher the number, the less frequently it needs to eat in order to live. See [[Pasture]] for details on its issues.
|}

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

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

|-
| {{text anchor|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 require the creature to have a lair to work properly, and also don't seem to work on creatures who are not (SEMI)MEGABEASTs or NIGHT_CREATURE_HUNTERs.

|-
| {{text anchor|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.".<sup>[[http://www.bay12forums.com/smf/index.php?topic=60554.msg1719248#msg1719248 source post]]</sup> All lists of HABITs are preceded by [HABIT_NUM:TEST_ALL]

|-
| {{text anchor|HAS_NERVES}}
| Caste
|
| The creature has nerves in its muscles. Cutting the muscle tissue can sever motor and sensory nerves.

|-
| {{text anchor|HASSHELL}}
| Caste
|
| The creature has a shell. Seemingly no longer used - holdover from previous versions.

|-
| {{text anchor|HFID}}
| Creature
| Integer (generic token?)
| Found on generated [[angel]]s. Seemingly identifies a historical figure with said hist figure ID, possibly to associate it with hist figure.

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

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

|-
| {{text anchor|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

|-
| {{text anchor|IMMOBILE}}
| Caste
|
| The creature cannot move. Found on [[sponge]]s. Will also stop a creature from breeding in Fortress Mode (MALE and FEMALE are affected, if one is IMMOBILE no breeding will happen)

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

|-
| {{text anchor|IMMOLATE}}
| Caste
|
| The creature radiates fire. It will ignite, and potentially completely destroy, items the creature is standing on. Keep booze away from critters with this tag. Also gives the vermin a high chance of escaping from [[animal trap]]s and [[cage]]s made of certain materials.

|-
| {{text anchor|INTELLIGENT}}
| Caste
|
| Alias for [CAN_SPEAK] + [CAN_LEARN].

|-
| {{text anchor|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.).

|-
| {{text anchor|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

|-
| {{text anchor|LAIR}}
| Caste
| type:probability
| Found on megabeasts, semimegabeasts, and night creatures. The creature will seek out sites of this type and take them as lairs. The lair types are SIMPLE_BURROW, SIMPLE_MOUND, WILDERNESS_LOCATION, SHRINE, and LABYRINTH.

|-
| {{text anchor|LAIR_CHARACTERISTIC}}
| Caste
| characteristic:probability
| Defines certain features of the creature's lair. The only valid characteristic is HAS_DOORS.

|-
| {{text anchor|LAIR_HUNTER}}
| Caste
|
| This creature will actively hunt adventurers in its lair.

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

|-
| {{text anchor|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). When tamed, large predators tend to be much more aggressive to enemies than non-large predators, making them a good choice for an animal army. They may go on rampages in worldgen, and adventurers may receive quests to kill them. Also, they can be mentioned in the intro paragraph when starting a fortress e.g. "ere the wolves get hungry."

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

|-
| {{text anchor|LAYS_EGGS}}
| Caste
|
| Creature lays eggs instead of giving birth to live young.

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

|-
| {{text anchor|LIGAMENTS}}
| Caste
|
* [[material token]]
*healing rate
| Creature has ligaments in its bones. Cutting the bone tissue severs them, disabling motor function if the target is a limb.

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

|-
| {{text anchor|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.

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

|-
| {{text anchor|LITTERSIZE}}
| Caste
|
* minimum
* maximum
| Determines the range of how many creatures are generated when giving birth. [LITTERSIZE:1:2]

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

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

|-
| {{text anchor|LOW_LIGHT_VISION}}
| Caste
| number
| Determines how well a creature can see in the dark. Higher is better. Dwarves have 10000, which amounts to perfect nightvision.
|}

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

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

|-
| {{text anchor|MAGICAL}}
| Caste
|
| Unknown.

|-
| {{text anchor|MAGMA_VISION}}
| Caste
|
| Creature's able to see while covered in magma.

|-
| {{text anchor|MALE}}
| Caste
|
| The creature is male. Usually declared inside a caste.

|-
| {{text anchor|MANNERISM|MANNERISM_*}}
| Caste
|
*occasionally body part
| Adds a possible mannerism to the creature's profile.
See [[Creature mannerism token]] for further info.

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

|-
| {{text anchor|MATERIAL_FORCE_MULTIPLIER}}
| Caste
|
*[[Material token]]
*A:B
| Set the force multiplier of a specific material against the creature to A/B. For example, 10:1 multiplies the force by 10. {{verify}}

|-
| {{text anchor|MATUTINAL}}
| Caste
|
| Sets if the creature is active in dawn.

|-
| {{text anchor|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.

|-
| {{text anchor|MEANDERER}}
| Caste
|
| Gives a creature random movement.

|-
| {{text anchor|MEGABEAST}}
| Caste
|
| A 'boss' creature. A small number of the creature are created during worldgen, their histories and descendants (if any) will be tracked in worldgen (as opposed to simply 'spawning'), and they will occasionally go on rampages, potentially leading to worship if they attack the same place multiple times. Their presence and number will also influence age names. When appearing in Fortress Mode, they will have a pop-up message announcing their arrival.

|-
| {{text anchor|MENT_ATT_CAP_PERC}}
| Caste
|
*[[DF2012:Attribute|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).

|-
| {{text anchor|MENT_ATT_RANGE}}
| Caste
|
*[[DF2012:Attribute|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.

|-
| {{text anchor|MENT_ATT_RATES}}
| Caste
|
*[[DF2012:Attribute|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.

|-
| {{text anchor|MILKABLE}}
| Caste
|
* [[material token]]
* frequency
| Allows the creature to be milked in the farmer's workshop. The frequency is the amount of time units the creature needs to "recharge".

|-
| {{text anchor|MISCHIEVIOUS}}
| Caste
|
| Alias for MISCHIEVOUS.

|-
| {{text anchor|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."

|-
| {{text anchor|MODVALUE}}
| Caste
|
| Seemingly no longer used.

|-
| {{text anchor|MOUNT}}
| Caste
|
| Creature may be used as a mount. No use for the player, but enemy siegers may arrive with cavalry.

|-
| {{text anchor|MOUNT_EXOTIC}}
| Caste
|
| Creature may be used as a mount, but civilizations cannot domesticate it in worldgen without certain exceptions.

|-
| {{text anchor|MULTIPART_FULL_VISION}}
| Caste {{Verify}}
|
| Allows the creature to have all-around vision as long as it has multiple heads(?) that can see. {{Verify}}

|-
| {{text anchor|MULTIPLE_LITTER_RARE}}
| Caste
|
| Makes the species usually produce a single offspring per birth, occasionally producing twins or triplets using typical real-world human probabilities. Requires [[Creature_token#FEMALE|FEMALE]]. Compare with [[Creature_token#LITTERSIZE|LITTERSIZE]]. If LITTERSIZE and MULTIPLE_LITTER_RARE are both absent, one offspring is guaranteed per birth.

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

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

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

|-
| {{text anchor|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. If left undefined, the creature will be labeled as "nothing" by the game.

|-
| {{text anchor|NATURAL}}
| Caste
|
| Animal is considered to be natural. Creatures with AT_PEACE_WITH_WILDLIFE will not fight with them.

|-
| {{text anchor|NATURAL_ANIMAL}}
| Caste
|
| Alias of NATURAL.

|-
| {{text anchor|NATURAL_SKILL}}
| Caste
| [[Skill_token|Skill token]]:value
| The creature possesses this skill at this level inherently. It begins with this skill at this level, and the skill may never rust below this level. A value of 16 is legendary. Requires CAN_LEARN or INTELLIGENT to function in .25 or earlier.

|-
| {{text anchor|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. This does not affect the creature's presence elsewhere, such as for generated megabeasts, normal creatures, entity members, etc. Setting the number of bogeyman types to zero in the world gen parameters will remove only the randomly-generated bogeymen.

|-
| {{text anchor|NIGHT_CREATURE_HUNTER}}
| Caste
|
| A very small population of the creature will be created during worldgen (sometimes only a single individual will be created), and their histories will be tracked (that is, they will not spawn spontaneously later, they must either have children or convert other creatures to increase their numbers). The creature will settle in a lair and go on rampages during worldgen. If this creature has SPOUSE_CONVERTER, it will actively attempt to seek out potential conversion targets to abduct, convert, and have children with (if possible).

This tag causes the usual behaviour of [[werebeast]]s in worldgen, that is, fleeing towns upon being cursed and conducting raids from a lair. If this tag is absent from a deity curse, the accursed will simply be driven out of towns in a similar manner to [[vampire]]s.

|-
| {{text anchor|NO_AUTUMN}}
| Caste
|
| This creature caste does not appear in [[Calendar|autumn]].

|-
| {{text anchor|NO_CONNECTIONS_FOR_MOVEMENT}}
| Caste
|
| Creature doesn't require connected body parts to move{{verify}}; generally used on undead creatures with connections that have rotted away.

|-
| {{text anchor|NO_DIZZINESS}}
| Caste
|
| Creature cannot become dizzy.

|-
| {{text anchor|NO_DRINK}}
| Caste
|
| Creature does not need to drink.

|-
| {{text anchor|NO_EAT}}
| Caste
|
| Creature does not need to eat.

|-
| {{text anchor|NO_FEVERS}}
| Caste
|
| Creature cannot suffer fevers.

|-
| {{text anchor|NO_GENDER}}
| Caste
|
| Creature has no gender.

|-
| {{text anchor|NO_PHYS_ATT_GAIN}}
| Caste
|
| The affected caste cannot gain any physical skills.

|-
| {{text anchor|NO_PHYS_ATT_RUST}}
| Caste
|
| The affected caste cannot lose any physical skills.

|-
| {{text anchor|NO_SLEEP}}
| Caste
|
| Creature does not need to sleep.

|-
| {{text anchor|NO_SPRING}}
| Caste
|
| This creature caste does not appear in [[Calendar|spring]].

|-
| {{text anchor|NO_SUMMER}}
| Caste
|
| This creature caste does not appear in [[Calendar|summer]].

|-
| {{text anchor|NO_THOUGHT_CENTER_FOR_MOVEMENT}}
| Caste
|
| Creature doesn't require an organ with the [THOUGHT] tag to survive or attack; generally used on creatures that don't have brains.

|-
| {{text anchor|NO_UNIT_TYPE_COLOR}}
| Caste
|
| Prevents creature from selecting its color based on its profession (e.g. Miner, Hunter, Wrestler).

|-
| {{text anchor|NO_VEGETATION_PERTURB}}
| Caste{{Verify}}
|
| Likely prevents the creature from leaving broken vegetation tracks.{{Verify}}

|-
| {{text anchor|NO_WINTER}}
| Caste
|
| This creature caste does not appear in [[Calendar|winter]].

|-
| {{text anchor|NOBONES}}
| Caste
|
| Creature has no bones.

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

|-
| {{text anchor|NOCTURNAL}}
| Caste
|
| Sets if the creature is active in night.

|-
| {{text anchor|NOEMOTION}}
| Caste
|
| The creature has no emotions, and does not rage.

|-
| {{text anchor|NOEXERT}}
| Caste
|
| Creature can't become tired or over-exerted from taking too many combat actions.

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

|-
| {{text anchor|NOMEAT}}
| Caste
|
| Creature will not drop meat when butchered.

|-
| {{text anchor|NONAUSEA}}
| Caste
|
| Creature isn't nauseated by gut hits and cannot vomit.

|-
| {{text anchor|NOPAIN}}
| Caste
|
| Creature doesn't feel pain.

|-
| {{text anchor|NOSKIN}}
| Caste
|
| Creature will not drop a hide when butchered.

|-
| {{text anchor|NOSKULL}}
| Caste
|
| Creature will not drop a skull on butcher, rot, or decay of severed head.

|-
| {{text anchor|NOSMELLYROT}}
| Caste
|
| Does not produce miasma when rotting.

|-
| {{text anchor|NOSTUCKINS}}
| Caste
|
| Weapons can't get stuck in creature.

|-
| {{text anchor|NOSTUN}}
| Caste
|
| Creature can't be stunned. Creatures with this tag never wake up from sleep in Fortress Mode and stay drowsy.{{verify}} If this creature must eat and drink while playing, it WILL die.

|-
| {{text anchor|NOT_BUTCHERABLE}}
| Caste
|
| Cannot be butchered

|-
| {{text anchor|NOT_LIVING}}
| Caste
|
| Cannot be raised from the dead.

|-
| {{text anchor|NOTHOUGHT}}
| Caste
|
| Creature doesn't require a [THOUGHT] body part to survive. If it does not have NO_THOUGHT_CENTER_FOR_MOVEMENT as well, it will be unable to use any attacks other than the default 'push'. Has the added effect of preventing speech.
|}

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

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

|-
| {{text anchor|ODOR_LEVEL}}
| Caste
| number
| How easy the creature is to smell. The higher the number, the easier the creature can be smelled. Zero is odorless. Default is 50.

|-
| {{text anchor|ODOR_STRING}}
| Caste
| string
| What the creature smells like. If no odor string is defined, the creature name (not the caste name) is used.

|-
| {{text anchor|OPPOSED_TO_LIFE}}
| Caste
|
| Is hostile to all creatures except undead and other non-living ones. Used for [[Undead]].

|-
| {{text anchor|ORIENTATION}}
| Caste
| MALE/FEMALE:disinterested chance:lover-possible chance:commitment-possible chance
| Determines caste's likelihood of having sexual attraction to certain sexes. Values default to 75:20:5 for the same sex and 5:20:75 for the opposite sex. The values themselves are simply ratios and do not need to add up to any particular value.

|}

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

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

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

|-
| {{text anchor|PARALYZEIMMUNE}}
| Caste
|
| The creature is immune to all paralyzing special attacks.

|-
| {{text anchor|PATTERNFLIER}}
| Caste
|
| Unknown. No creatures currently have this token.

|-
| {{text anchor|PEARL}}
| Caste
|
| In earlier versions, creature would generate pearls. Does nothing in the current version.

|-
| {{text anchor|PENETRATEPOWER}}
| Caste
| value
| Controls the ability of vermin to find a way into containers when they are eating food from your stockpiles.

|-
| {{text anchor|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.

|-
| {{text anchor|PET}}
| Caste
|
| Allows the creature to be tamed in Fortress mode. Prequisite for all other working animal roles and allows all females of the species to breed regardless of marital status. Civilizations that encounter it in worldgen will tame and domesticate it for their own use.

|-
| {{text anchor|PET_EXOTIC}}
| Caste
|
| Allows the creature to be tamed in Fortress mode. Prequisite for all other working animal roles and allows all females of the species to breed regardless of marital status. Civilizations cannot domesticate it in worldgen without certain exceptions. More difficult to tame?{{verify}}

|-
| {{text anchor|PETVALUE}}
| Caste
| value
| How valuable a tamed animal is. Actual cost in points in the embarking screen is 1+(PETVALUE/2) for an untrained animal, 1+PETVALUE for a war/hunting one.

|-
| {{text anchor|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.

|-
| {{text anchor|PHYS_ATT_CAP_PERC}}
| Caste
|
*[[DF2012:Attribute|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).

|-
| {{text anchor|PHYS_ATT_RANGE}}
| Caste
|
*[[DF2012:Attribute|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.

|-
| {{text anchor|PHYS_ATT_RATES}}
| Caste
|
*[[DF2012:Attribute|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.

|-
| {{text anchor|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.

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

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

|-
| {{text anchor|POPULATION_NUMBER}}
| Creature
| min:max
| The minimum/maximum numbers of how many of these creatures are present in each world map tile of the appropriate region.

|-
| {{text anchor|POWER}}
| Caste
|
| Allows the being to represent itself as a deity. Requires CAN_SPEAK to actually do anything more than settle at a location (e.g. write books, lead armies, profane temples). Doesn't appear to do anything for creatures that are already civilized.

|-
| {{text anchor|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

|-
| {{text anchor|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.

|-
| {{text anchor|PRONE_TO_RAGE}}
| Caste
| Chance
| Creature has a percentage chance to flip out at visible non-friendly creatures. Enraged creatures attack anything regardless of timidity and get a strength bonus to their hits. This is what makes badgers so hardcore.

|-
| {{text anchor|PUS}}
| Caste
|
* [[material token]]
*matter state (LIQUID, GAS, SOLID)
| The creature has pus. Specifies the stuff secreted by infected wounds.
|}

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

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

|-
| {{text anchor|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.

|-
| {{text anchor|REMAINS}}
| Caste
| singular:plural
| What creature's remains are called.

|-
| {{text anchor|REMAINS_COLOR}}
| Caste
|
| What color creature's remains are.

|-
| {{text anchor|REMAINS_ON_VERMIN_BITE_DEATH}}
| Caste
|
| Goes with VERMIN_BITE and DIE_WHEN_VERMIN_BITE, the vermin creature will leave remains on death when biting. Leaving this tag out will cause the creature to disappear entirely after it bites.

|-
| {{text anchor|REMAINS_UNDETERMINED}}
| Caste
|
| Unknown.

|-
| {{text anchor|REMOVE_MATERIAL}}
| Creature
|
*material token
| Removes a material from a creature.

|-
| {{text anchor|REMOVE_TISSUE}}
| Creature
|
*material token
| Removes a tissue from a creature.

|-
| {{text anchor|RETRACT_INTO_BP}}
| Caste
|
*BY_TYPE, BY_CATEGORY or BY_TOKEN
*TYPE, CATEGORY or TOKEN
| The creature will retract into a body part when threatened. It will be unable to move or attack, but enemies will only be able to attack the specified body part.

|-
| {{text anchor|RETURNS_VERMIN_KILLS_TO_OWNER}}
|
|
| Cat behavior. If it kills a vermin creature and has an owner, it carries the remains in its mouth and drops them at his feet. Requires HUNTS_VERMIN, obviously.

|-
| {{text anchor|ROOT_AROUND}}
| Caste
|
| Creature will occasionally root around in the grass, looking for insects. Used for flavor in Adventure Mode, spawns vermin edible by this creature in Fortress Mode.

|}

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

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

|-
| {{text anchor|SAVAGE}}
| Creature
|
| The creature will only show up in "savage" biomes.

|-
| {{text anchor|SECRETION}}
| Caste
|
* [[material token]]
*Material State
*location secreted from (by_type, by_category, by_token)
*body part
*tissue layer
*trigger
| creates a secreted material on given tissue on a given part of the body. Valid triggers are:
*CONTINUOUS
*EXTREME_EMOTION
*EXERTION

|-
| {{text anchor|SELECT_ADDITIONAL_CASTE}}
| Creature
|
*caste name
| adds an additional previously defined caste to the selection. Used after SELECT_CASTE.

|-
| {{text anchor|SELECT_CASTE}}
| Creature
|
*caste name, or ALL
| selects a previously defined caste

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

|-
| {{text anchor|SEMIMEGABEAST}}
| Caste
|
| Essentially the same as MEGABEAST, but more of them are created during worldgen.

|-
| {{text anchor|SENSE_CREATURE_CLASS}}
| Caste
|
* Creature class
* [[Tilesets|Tile]]
* [[Color|Color]]
| Allows creature to sense creatures with a certain creature class through walls, floors etc. Sense will be with tile and color specified.

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

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

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

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

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

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

|-
| {{text anchor|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]. Requires CAN_LEARN or INTELLIGENT to function.

|-
| {{text anchor|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.

|-
| {{text anchor|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.

|-
| {{text anchor|SLOW_LEARNER}}
| Caste
|
| Shorthand for [CAN_LEARN] + [SKILL_LEARN_RATES:50].{{verify}} Used for ogres and giants. Applicable to player races.

|-
| {{text anchor|SMALL_REMAINS}}
| Caste
|
| Creature leaves a "remains" instead of a corpse. Used for vermin.

|-
| {{text anchor|SMELL_TRIGGER}}
| Creature
| value
| Determines how keen a creature's sense of smell is. Lower is better. At 10000, a creature cannot smell at all.

|-
| {{text anchor|SOLDIER_ALTTILE}}
| 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.

|-
| {{text anchor|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.
* First-person reads "You '''bark'''"
* Third-person reads "The capybara '''barks'''"
* Out of sight reads "You hear '''a loud bark'''"
with the text in bold being the description arguments of the token.

|-
| {{text anchor|SPECIFIC_FOOD}}
| Caste
|
* PLANT or CREATURE
* Plant/creature ID
| Creature can will only graze or eat the designated plant or creature parts.

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

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

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

|-
| {{text anchor|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.

|-
| {{text anchor|SPOUSE_CONVERSION_TARGET}}
| Caste
|
| This creature can be converted by a night creature with SPOUSE_CONVERTED.

|-
| {{text anchor|SPOUSE_CONVERTER}}
| Caste
|
| If the creature has the NIGHT_CREATURE_HUNTER tag, it will kidnap SPOUSE_CONVERSION_TARGETs and transform them into the caste of its species with the CONVERTED_SPOUSE tag during worldgen. It may also start families this way.

|-
| {{text anchor|STANCE_CLIMBER}}
| Caste {{verify}}
|
| Caste does not require GRASP body parts to climb -- it can climb with STANCE parts instead.

|-
| {{text anchor|SUPERNATURAL}}
| Caste
|
| Gives the creature knowledge of any secrets with SUPERNATURAL_LEARNING_POSSIBLE that match its spheres. Other effects are unknown.

|-
| {{text anchor|SWIMS_INNATE}}
| Caste
|
| The creature naturally knows how to swim, as opposed to [SWIMS_LEARNED] below. However, Fortress mode AI never paths into water anyway, so it's less useful there.

|-
| {{text anchor|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

|-
| {{text anchor|TENDONS}}
| Caste
|
* [[material token]]
*healing rate
| The creature has tendons in its bones. Cutting the bone tissue severs them, disabling motor function if the target is a limb.

|-
| {{text anchor|THICKWEB}}
| Caste
|
| The creature's webs can catch larger creatures.

|-
| {{text anchor|TISSUE}}
| Creature
| name
| Begins defining a tissue in the creature file.

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

|-
| {{text anchor|TL_COLOR_MODIFIER}}
| Caste
| COLOR:freq:COLOR:freq etc.
| Creates a list of color patterns, giving each a relative frequency.

|-
| {{text anchor|TLCM_GENETIC_MODEL}}
| Caste
|
| The way the color modifier is passed on to offspring. May or may not work right now.{{verify}}

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

|-
| {{text anchor|TLCM_NOUN}}
| Caste
|
*name
*SINGULAR or PLURAL
| Names the tissue layer color modifier, and determines the noun. Also used by stonesense for colouring body parts.

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

|-
| {{text anchor|TRADE_CAPACITY}}
| Caste
|
| How much the creature can carry when used by merchants.

|-
| {{text anchor|TRAINABLE}}
| Caste
|
| Shortcut for [TRAINABLE_HUNTING] + [TRAINABLE_WAR].

|-
| {{text anchor|TRAINABLE_HUNTING}}
| Caste
|
| Can be trained as a hunting beast, increasing speed.

|-
| {{text anchor|TRAINABLE_WAR}}
| Caste
|
| Can be trained as a war beast, increasing strength and endurance.

|-
| {{text anchor|TRANCES}}
| Caste
|
| Allows the creature to go into martial trances.

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

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

|-
| {{text anchor|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

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

|-
| {{text anchor|UNDERGROUND_DEPTH}}
| Creature
|
*mindepth
*maxdepth
| Depth the creature appears underground. Numbers can be from 0 to 5. 0 is actually 'above ground' and can be used if the creature is to appear both above and below ground. A single argument may be used instead of min and max. Only magma creatures use 4 or 5 in the default raws. [[Demon]]s use only 5:5; user-defined creatures with both this depth and [FLIER] will take part in the initial wave from the HFS alongside generated demons. Without [FLIER], they will only spawn from the map edges. Civilizations that can use underground plants or animals will only export (via the embark screen or caravans) things that available at depth 1.

|-
| {{text anchor|UNDERSWIM}}
| Caste
|
| Creature swims under the water and can't be seen. Seems to be a relic from the 2D era.

|-
| {{text anchor|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.

|-
| {{text anchor|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."

|-
| {{text anchor|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.

|-
| {{text anchor|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.

|-
| {{text anchor|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.

|-
| {{text anchor|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.

|-
| {{text anchor|UTTERANCES}}
| Caste
|
| Changes the language of the creature into unintelligible 'kobold-speak', which creatures of other species will be unable to understand. If a civilized creature has this and is not part of a SKULKING civ, it will tend to start wars with all nearby civilizations and will be unable to make peace treaties due to 'inability to communicate'.
|}

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

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

|-
| {{text anchor|VEGETATION}}
| Caste
|
| The creature is made of swamp stuff. Used for [[grimeling]]s.

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

|-
| {{text anchor|VERMIN_EATER}}
| Creature
|
| The vermin creature will attempt to eat exposed food. See PENETRATEPOWER. Distinct from VERMIN_ROTTER.

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

|-
| {{text anchor|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).

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

|-
| {{text anchor|VERMIN_MICRO}}
| Caste
|
| This makes the creature move in a swarm of creatures of the same race as it (e.g. swarm of flies, swarm of ants).

|-
| {{text anchor|VERMIN_NOFISH}}
| Caste
|
| The creature cannot be caught by fishing.

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

|-
| {{text anchor|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.

|-
| {{text anchor|VERMIN_ROTTER}}
| Creature
|
| Present on flies, knuckle worms, acorn flies, and blood gnats. Attracted to rotting stuff left in the open. Speeds up decay?{{verify}}

|-
| {{text anchor|VERMIN_SOIL}}
| Creature
|
| The creature randomly appears near dirt or mud.

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

|-
| {{text anchor|VERMINHUNTER}}
| Caste
|
| Old shorthand for "does cat stuff". Contains [AT_PEACE_WITH_WILDLIFE] + [RETURNS_VERMIN_KILLS_TO_OWNER] + [HUNTS_VERMIN] + [ADOPTS_OWNER].

|-
| {{text anchor|VESPERTINE}}
| Caste
|
| Sets if the creature is active in evening.

|-
| {{text anchor|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.

|-
| {{text anchor|VISION_ARC}}
| Caste {{Verify}}
|
*binocular vision arc
*non-binocular vision arc
| The width of the creature's vision arcs. The first number is binocular vision, the second is non-binocular vision.
|}

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

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

|-
| {{text anchor|WAGON_PULLER}}
| Caste
|
| Allows the creature to pull caravan wagons. If a civilization doesn't have access to any, it is restricted to trading with pack animals.

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

|-
| {{text anchor|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

|-
| {{text anchor|ATTACK_SKILL}}
| Caste
|
*[[Skill token]]
| Defines the skill used by the attack.

|-
| {{text anchor|ATTACK_VERB}}
| Caste
| 2nd person:3rd person
| Descriptive text for the attack.

|-
| {{text anchor|ATTACK_CONTACT_PERC}}
| Caste
|
*% value
| The contact area of the attack, measured in % of the body part's volume. Note that all attack percentages can be more than 100%.

|-
| {{text anchor|ATTACK_PENETRATION_PERC}}
| Caste
|
*% value
| The penetration value of the attack, measured in % of the body part's volume. Requires ATTACK_FLAG_EDGE. Maximum value: 15000.

|-
| {{text anchor|ATTACK_PRIORITY}}
| Caste
|
*MAIN or SECOND
| Usage frequency. MAIN attacks are 100 times more frequently chosen than SECOND. Opportunity attacks ignore this preference.

|-
| {{text anchor|ATTACK_VELOCITY_MODIFIER}}
| Caste
| number
| The velocity multiplier of the attack, multiplied by 1000.

|-
| {{text anchor|ATTACK_FLAG_CANLATCH}}
| Caste
|
| Attacks that damage tissue have the chance to latch on in a wrestling hold. The grabbing bodypart can then use the "shake around" wrestling move, causing severe, armor-bypassing tensile damage according to the attacker's body volume.

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

|-
| {{text anchor|ATTACK_FLAG_EDGE}}
| Caste
|
| The attack is edged, with all the effects on physical resistance and contact area that it entails.

|-
| {{text anchor|ATTACK_PREPARE_AND_RECOVER}}
| Caste
|
* Preparation time
* Recovery time
| Determines the length of time to prepare this attack and until one can perform this attack again. Values appear to be calculated in adventure mode ticks.

|-
| {{text anchor|ATTACK_FLAG_BAD_MULTIATTACK}}
| Caste
|
| Multiple strikes with this attack cannot be performed effectively.

|-
| {{text anchor|ATTACK_FLAG_INDEPENDENT_MULTIATTACK}}
| Caste
|
| Multiple strikes with this attack can be performed with no penalty.

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

|-
| {{text anchor|SPECIALATTACK_INTERACTION}}
| Caste
| interaction
| When this attack lands successfully, an interaction with I_SOURCE:ATTACK will take effect on the target creature. The attack must break the target creature's skin in order to work. This will take effect in worldgen as well.

|-
| {{text anchor|SPECIALATTACK_SUCK_BLOOD}}
| Caste
| min:max
| Successful attack draws out an amount of blood randomized between the min and max value. Beware that this '''will''' trigger any ingestion syndromes attached to the target creature's blood - for example, using this attack on a vampire will turn you into one too.
|}

==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 properties of previously defined tissues. (See also [[Tissue definition token]])

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

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

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

|-
| {{text anchor|SELECT_TISSUE}}
| Creature
|
*tissue token
| Selects a tissue for editing.

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

|-
| {{text anchor|SET_LAYER_TISSUE}}
| Caste
|
| Sets a tissue layer to be made of a different tissue.

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

|-
| {{text anchor|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).

|-
| {{text anchor|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:<br>
[TISSUE:GAS] [TISSUE_NAME:gas:NP] [TISSUE_MATERIAL:LOCAL_CREATURE_MAT:GAS] [TISSUE_MAT_STATE:GAS] [RELATIVE_THICKNESS:50] [TISSUE_LEAKS] [TISSUE_SHAPE:LAYER]
|-
| {{text anchor|TISSUE_LAYER_APPEARANCE_MODIFIER}}
| Caste
|
*QUALITY
*lowest:lower:low:median:high:higher:highest
| sets the range of qualities, including LENGTH, DENSE, HIGH_POSITION, CURLY, GREASY, WRINKLY

|-
| {{text anchor|TISSUE_STYLE_UNIT}}
| Caste
|
*tissue style unit ID
*shaping
| sets tissue layer to be the target of TISSUE_STYLE token specified for an entity, works only on entity members. Mostly used with tissues HAIR, BEARD, MOUSTACHE, SIDEBURNS.

|-
| {{text anchor|TL_CONNECTS}}
| Caste
|
| Presumably gives the CONNECTS attribute to selected layers.

|-
| {{text anchor|TL_HEALING_RATE}}
| Caste
|
| Presumably changes the HEALING_RATE of the selected tissue layers.

|-
| {{text anchor|TL_MAJOR_ARTERIES}}
| Caste
|
| Gives the "major arteries" attribute to selected layers. Used to add massive bleeding properties to the throat, made from skin.

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

|-
| {{text anchor|TL_RELATIVE_THICKNESS}}
| Caste
|
| Seems to set new relative thickness for selected tissue layers.

|-
| {{text anchor|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}}

Creature variation token

2014-08-24T18:04:55Z

Talvieno: Changed quality rating from "Unrated" to "Tattered" using the rating script

{{Quality|Tattered|18:04, 24 August 2014 (UTC)}}
{{Migrated_article}}

{{av}}
Creature variations are used to create creatures which are derived from another already-existing creature without having to duplicate every single token. They are defined as CREATURE_VARIATION objects, and the default variations are defined in c_variation_default.txt

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

|-
| {{text anchor|CV_NEW_TAG}}
|
*token (plus any additional parameters)
| Adds a new token to the creature's variant.

|-
| {{text anchor|CV_ADD_TAG}}
|
*token
| Alias for CV_NEW_TAG

|-
| {{text anchor|CV_REMOVE_TAG}}
|
*token
| Removes a token from the creature's variant.

|-
| {{text anchor|CV_CONVERT_TAG}}
|
| Begins altering tokens within the creature's variant using the CVCT_MASTER, CVCT_TARGET, and CVCT_REPLACEMENT tokens below. If a variation template contains multiple CV_CONVERT_TAG blocks for the same CVCT_MASTER, the replacements will be applied [http://bay12games.com/dwarves/mantisbt/view.php?id=6393#c24231 in reverse order].

|-
| {{text anchor|CVCT_MASTER}}
|
*token
| Specifies the token that will be modified.

|-
| {{text anchor|CVCT_TARGET}}
|
*value
| Locates the specified parameter within the token specified by CVCT_MASTER.

|-
| {{text anchor|CVCT_REPLACEMENT}}
|
*value
| Replaces the parameter specified by CVCT_TARGET within the token specified by CVCT_MASTER. If no replacement is specified, the target will simply be removed.
|}

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

Weaver

2014-08-20T15:02:46Z

Talvieno: Removed migrated article tag.

{{Quality|Fine}}
{{Skill
| color = 1:1
| skill = Weaver
| profession = [[Craftsdwarf]]
| job name = [[Weaving]]
| tasks =
* Weave [[Cloth]]
* Collect [[Web]]s
| workshop = *[[Loom]]
| attributes =
* Agility
* Creativity
* Spatial Sense
* Kinesthetic Sense
}}
{{av}}

'''Weaver''' uses a [[Loom]] to weave [[cloth]] from [[silk]] [[thread]] (from [[web]]s left by [[cave spider]]s, [[giant cave spider]]s, or [[phantom spider]]s), plant fiber thread (processed from [[rope reed]]s or [[pig tail]]s), or [[yarn]] ([[spinner|spun]] from [[wool]] of [[shearer|shearable]] creatures). Unlike most intermediate goods, cloth has a quality value, and [[dwarf|dwarves]] with high skill in weaving create higher quality cloth. Collecting spider webs also requires and trains the weaving skill.

{{Skills}}

Health care

2014-08-20T04:00:40Z

Talvieno: Changed quality rating from "Superior" to "Fine" using the rating script

{{Quality|Fine|04:00, 20 August 2014 (UTC)}}
{{av}}

A '''hospital''' is a [[Activity zone#Hospital|zone]] designated via the [[Activity zone|zone menu]]. Hospitals use any beds, tables, traction benches, and coffers/bags that have been built within the zone. The hospital will requisition [[thread]], [[cloth]], [[splint]]s, [[crutch]]es, [[plaster powder]] (for casts), [[bucket]]s, and [[soap]] for medical use. These will be stored within the hospital's coffers/bags; you may adjust the desired quantities.

'''Doctors''' are dwarves assigned to any of the five medical labors: [[wound dresser|dressing wounds]], [[diagnostician|diagnosis]], [[surgeon|surgery]], [[bone doctor|setting bones]], and [[suturer|suturing]]. All doctors in the fortress operate under the instruction of the [[Chief medical dwarf]], an appointed [[noble]]. Doctors <strike>inflict</strike> perform medicine on a dwarf only after treatment has been prescribed by a diagnostician. Doctors do not perform any healthcare on animals, despite injured animals "requesting" diagnosis in the [[Health screen|z-health screen]].

All beds within a hospital zone are automatically hospital beds, where injured dwarves will go (or be brought) to recuperate. Tired healthy dwarves will occasionally camp there too if the hospital is close, even if they have their own bed.

==Setting up a Hospital==
* Hit {{k|i}} and set up a hospital [[zone]] in the area you plan on having your hospital. Be sure "Hospital" is highlighted. Proximity to [[water]] is a plus, since patients need to be washed and cannot drink alcohol.
* Place enough [[bed]]s in that zone to ensure you can keep all wounded dwarves in the hospital, plus a few spare that will be occupied by lazy couch-surfers.{{bug|647}} Note that normal beds or [[bedroom]]s can and will accept wounded dwarves whether or not a hospital zone exists, though hospital beds will be preferred if they are free. Doctors do not need a hospital zone, though a lack of equipment will probably limit care options.
* Build [[container]]s ({{k|b}}-{{k|h}}) to store hospital supplies. A small hospital can manage with 2 containers, while a fully fledged fortress with an adventurous military may need as many as 8. (Containers are not strictly necessary; doctors can and will use supplies from anywhere. But dedicated hospital containers allow you to earmark some supplies for medical use -- for example, to prevent the auto-looming of ''every'' last thread.)
* Build at least one [[table]] ({{k|b}}-{{k|t}}) for surgeons to perform surgery on. You may perform surgery without tables; it will be more messy.
** Place the tables right next to the beds, or you may get "cancels surgery, patient not resting" spam, as moving the sleeping patient more than one square from the bed to the table wakes up the patient. {{bug|2773}}
** Multiple dwarves may undergo simultaneous surgeries on the same table.
* Build one or more [[traction bench]]es to handle compound fractures when the dwarf requires "immobilization." Remember to check back on the <strike>victim</strike> patient after a while or they may be in the traction bench for a long, long time.{{bug|4470}} (Or be lucky; sometimes immobilization requests simply disappear with no bad consequences.)
** Each traction bench can only accommodate one dwarf at a time, and the dwarf may be there for quite some time, so plan accordingly.
* Stockpiles are not needed but can be used instead of chests and bags in the hospital zone.
* Assign a [[chief medical dwarf]] (in the [[noble]]s screen) to enable the fortress-wide [[health screen]] as well as invidual dwarves' health summary screens ({{k|v}}-{{k|z}}-{{k|h}}).
* Pick one or more dwarves to be doctors, and enable the health labor(s) on them (through {{k|v}}-{{k|p}}-{{k|l}}). Be sure the diagnosis labor is well covered. Without a diagnosis, patients cannot be treated. If they cannot be treated, they will occupy the hospital area until they die, performing no function. (Any dwarf with the Diagnosis labor enabled can diagnose dwarves, but the Chief Medical Dwarf may impact the diagnosis job creation{{verify}}. Once a patient is diagnosed, you can see on the individual health screen what procedures are needed, for example washing or suturing.)
* If you use a [[burrow]] to keep doctors near the hospital zone, ensure that this burrow covers all needed materials or you could get job cancellations because of lack of material. Thread/cloth stockpiles, and items bought from caravans (e.g. plaster early in the game) are often the most troubling.

== Skills and Injuries==
'''Doctors''' have 5 specialized skills and 2 support healthcare labors.

[[Diagnostician]] -- [[Surgeon]] -- [[Suturer]] -- [[Wound dresser]] -- [[Bone doctor]] -- Feed patients/prisoners -- [[Recovering wounded]]

Those with the '''recover wounded''' labor will attempt to bring a wounded dwarf to the hospital zone, or lacking one to the nearest unoccupied bed. Note that recovering wounded appears to be an extremely low priority task. Since immobile patients will need to be carried to a hospital before diagnosis, it may be necessary to temporarily disable all other labors on another dwarf to move them first.

A '''diagnoser''' will then identify and prescribe a treatment which any doctor (including himself) may carry out. A dwarf cannot be treated without a diagnosis. Depending on the injury a treatment labor will occur. Diagnosis is often required between procedures as well.

[[Wound|Injuries]]
:{| border=0 cellpadding=0 cellspacing=1 style="background: black"
|-
|<font color="#ffffff"> '''NONE: No recorded active wounds on the part.'''</font>
|-
|<font color="#808000"> '''MINOR: Any damage that doesn't have functional/structural consequences (might be heavy bleeding, though).'''</font>
|-
|<font color="#ffff00"> '''INHIBITED: Any muscular, structural, or functional damage, without total loss.'''</font>
|-
|<font color="#00ffff"> '''FUNCTION LOSS: An important function of the part is completely lost, but the part is structurally sound (or, at least partially intact). '''</font>
|-
|<font color="#ff0000"> '''BROKEN: The part has lost all structural integrity or muscular ability.'''</font>
|-
|<font color="#808080"> '''MISSING: The part is completely gone. '''</font>
|}
If a chief medical dwarf is appointed you can view your fortress' health using the {{k|z}}-status key), or individually by selecting a dwarf and using {{k|w}} for wounds section.
* '''Bones''' can be set and treated by bone doctors depending on severity using thread and cloth for fractures, splints and casts, or traction benches. Grasping is often impaired during healing. The {{DFtext|Immobilization Request}} status tag is an indication that a splint or plaster cast is required. Multiple overlapping and compound fractures require a surgeon. Caused by [[attack_types#Blunt_weapons|blunt]] trauma.
*'''Skin and muscle''' can be treated by a suturer using thread and cloth. The wound will continue to bleed until sutured, severe wounds impair grasping during healing. Closed wounds will be dressed by a wound dresser. Caused by [[attack_types#Edged_weapons|slashing]] injuries.
*'''Internal Organs''' can be treated or removed by a surgeon using tables and traction benches. Repair of infected or rotten wounds is treated similarly. Caused by [[attack_types#Piercing_weapons|piercing]] injuries.

Any dwarves with the Feed patients/prisoners labor will attempt to give food or a bucket of water to a hungry or thirsty patient. By default all dwarves start with the non-doctor labors designated. These have no corresponding [[skill]]s - they do not cause experience gain, but merely are activities that can be turned on/off for each dwarf.

==Infection==
Every open wound can become infected. Infections may heal over time; however, many dwarves will die due to infection, often months after the actual wounding.

Causes of infection include:
* No cleaning of the wounds.
* Cleaning with water from a [[Water#Stagnant_Water|stagnant water]] source.
* Cleaning with [[Water#Water_laced_with_mud|water laced with mud]]. {{Verify}}
* Cleaning without [[soap]].
* <s>Bad luck</s> [[Fun]]!

== Equipment ==
=== Traction Benches ===

A '''traction bench''' is used by a [[doctor]] in a [[Hospital|hospital zone]] to immobilize a dwarf that has sustained complex or overlapping fractures.

It is constructed in the [[Mechanic's workshop]], and requires a [[table]], a [[mechanism]], and a [[rope]] or a [[chain]] to construct. The [[quality]] of each component is not reflected in the quality of the traction bench, and only the [[material]] of the table is used as the material for the bench. "Recycling" low-quality, low-value components into high-quality traction benches can provide a modest increase in [[value]]. Note that if any [[Stockpile|stockpiles]] have been linked to "Give" to the workshop, all of the resources needed to construct the traction bench must be found in the linked piles (e.g., linking only a stone stockpile may prevent access to the necessary tables/ropes/chains).

Currently there is a bug that may prevent fully healed dwarves from ever leaving the traction bench. {{bug|4470}} Removing the traction bench will free the dwarf.

Do not be hasty in removing a presumably-stuck dwarf from traction, however. Such treatment takes weeks or months to succeed and removing the dwarf prematurely will undo all the progress that has been made. If the dwarf has been in traction without being diagnosed or otherwise treated for a month and the health screen shows no scheduled treatment, they probably were forgotten and need the traction bench deconstructed to release them. Another possible way to check if a dwarf is stuck is by {{k|v}}iewing the {{k|w}}ounds of the dwarf in question. If the damaged part isn't at red, then the dwarf is stuck.

=== Casts ===

Casts are made out of [[plaster powder]] and are used to keep broken bones in their proper place until healed. To store it in a hospital, build a chest or other container inside the hospital zone. Applying a cast also requires a bucket and cloth, and a water source.

Plaster powder is produced at a [[kiln]] or [[magma kiln]] from [[gypsum]], [[alabaster]], [[selenite]], or [[satinspar]] and an empty [[bag]] by a dwarf with the furnace operator skill enabled. They can also be bought at embark for 3 points per unit; each unit comes with a free [[bag]].

=== Splints ===
Splints immobilize limbs that have sustained bone fractures. They allow the broken limb to be utilized until it is fully healed, Dwarves will be able to leave the hospital and resume their normal duties once securely splinted up since by this stage their wounds have already been cleaned, sutured and dressed. Applied by a bone doctor.

They can be made out of one [[wood]] at the [[carpenter's workshop]] or out of one metal [[bar]] at the [[metalsmith's forge]] or the [[magma forge]]. The use of splints seems to be an effective alternative to applying a plaster cast, which are also easier to obtain and prepare. Splints are categorized as [[finished goods]].

=== Other equipment===
*[[Crutch]]es {{DFtext|┬|770}} help a crippled dwarf walk again.
*[[Table]]s are used to conduct operations on.
*[[Bed]]s are used by patients to rest.
*[[Thread]] is used to suture closed wounds.
*[[Cloth]] is used to clean wounds, wash patients and dress wounds.
*[[Soap]] is used to clean wounds, sterilizing and preventing infection.
*[[Water]] is used to clean wounds, bathe patients and give drink. Patients do not drink alcohol.
*[[Bucket]]s are used to gather and hold the water for its uses.
*[[Container]]s are used to store hospital supplies.

==Tips for an Effective Hospital==
* Regularly use ({{k|i}}-{{k|H}}) to examine your hospital stockpile. Ensure your hospital is well-stocked. If you run out of materials regularly, increase the limits.
* It is possible to do without soap in the hospital stockpile. Choosing to do so, however, increases the risk of infection, which most likely will kill your dwarf. Consult the [[soap]] page to understand that industry. Bring 1 lye on embark for one bar of soap, which translates to 150 units.
* Put a [[well]] inside (or near) the hospital for maximum efficiency. Doctors need to wash patients regularly, and clean water reduces infection.
* Do not place chairs next to your surgery tables. A chair is an invitation for rat-roast eating freeloaders to block the medical process.
* Consider making use of [[burrow]]s to ensure your healthcare workers stay in the area.
* You may wish to consider individual rooms for each bed if you find your doctors are choosing to treat Urist McScratched over Urist McBloodFountainTheGushing. A locked door minimizes the mess and thereby infection and allows you to prioritize.
* The Chief Medical Dwarf only enables the Health status screen. The position has no in-game use. Look after your CMDs if you rely heavily on this screen, but otherwise they can be treated as any other dwarf.
** Diagnosis skill level does not affect the diagnosis, only the time it takes for the diagnosis to happen. Embarking with a dwarf skilled in diagnosis (and other medical skills) is helpful, both to speed diagnosis and to stave off skill rust when long periods of time go between injuries.
** Also helpful is enabling medical skills on all dwarves in the fortress, which allows medical jobs to be picked up immediately so long as there is an idle dwarf.
* Create "nurses" by setting dwarves to only use the Recover Wounded, Bring Food and Water labors.
** It is important not to distract doctors from treating patients (or other medical helpers such as crutch haulers, or wounded recoverers).
** "Recover wounded", "Give food" and "Give water" are low priority jobs, so it is entirely possible for a patient to starve to death, dehydrate to death, or bleed to death if no one ever gets "unbusy" enough to bring them food, water, or move them to the hospital.
** Similarly, it is important not to put your doctors at risk by recovering wounded in the middle of a battle—if they become injured, they cannot treat themselves.
* You can select nurses who enjoy helping people to give them good thoughts. This also prevents dwarves that hate bringing others food from receiving unhappy thoughts.
* When a serious injury happens, don't exit (or save) the game until the injured are in the hospital zone, especially if a dwarf is immobile. "Bring crutch" and "Recover Wounded" jobs will be lost, keeping the patient away from the hospital, and doctors will NOT go to patients, even if burrowed with them, because a diagnose job hasn't been created. Sometimes a second "crutch required" or "recover wounded" request will be generated, but often too late for the patient's full recovery. Best bet is ensure someone (not burrowed) has "recover wounded" enabled at all times; burrow doctors doing non-medical tasks immediately; hope the patient makes it to the hospital.

Dwarves will prefer to store and use the most expensive thread and cloth. Yes, that includes special "[[raw adamantine|exotic]]" strands. You may want to forbid these during medical emergencies.

==Bugs==
* For a variety of reasons, an injured dwarf may leave the hospital and/or refuse to go to the hospital. {{Bug|309}}
* Adamantine thread used for suturing. {{Bug|1346}}
* Wounded [[justice|criminals]] don't get sent to the hospital. {{Bug|3901}}
* Your dwarf may get stuck in traction, even after the wounds have healed. If this happens, simply remove the traction bench. {{Bug|4470}}
* The quality and value of a finished traction bench doesn't account for all of the inputs used to make it. {{verify}}
* Purchased plaster powder does not appear in the hospital storage. {{verify}}
* Dwarves resting in bed may be starving/dehydrated and not being taken care of, deconstructing the bed to generate a new Recover Wounded task and force them to rest properly fixes this.

{{d for dwarf}}
Soap is the only item dwarves will use to sterilize a wound. While dwarves are of course aware that humans will pour perfectly quaffable alcohol over their bloody wounds and onto the filthy ground to get the same effect, dwarves understand that some things are more precious than a single life, and face oblivion with a bit more dignity. Application of extreme heat is also well known to prevent infections and seal a wound, but dwarves consider magma the only legitimate heat source, and the non-lethal application of magma a sacrilege.

{{Category|Healthcare}}
{{Industry}}

Health care

2014-08-20T04:00:14Z

Talvieno: Changed quality rating from "Unrated" to "Superior" using the rating script

{{Quality|Superior|04:00, 20 August 2014 (UTC)}}
{{av}}

A '''hospital''' is a [[Activity zone#Hospital|zone]] designated via the [[Activity zone|zone menu]]. Hospitals use any beds, tables, traction benches, and coffers/bags that have been built within the zone. The hospital will requisition [[thread]], [[cloth]], [[splint]]s, [[crutch]]es, [[plaster powder]] (for casts), [[bucket]]s, and [[soap]] for medical use. These will be stored within the hospital's coffers/bags; you may adjust the desired quantities.

'''Doctors''' are dwarves assigned to any of the five medical labors: [[wound dresser|dressing wounds]], [[diagnostician|diagnosis]], [[surgeon|surgery]], [[bone doctor|setting bones]], and [[suturer|suturing]]. All doctors in the fortress operate under the instruction of the [[Chief medical dwarf]], an appointed [[noble]]. Doctors <strike>inflict</strike> perform medicine on a dwarf only after treatment has been prescribed by a diagnostician. Doctors do not perform any healthcare on animals, despite injured animals "requesting" diagnosis in the [[Health screen|z-health screen]].

All beds within a hospital zone are automatically hospital beds, where injured dwarves will go (or be brought) to recuperate. Tired healthy dwarves will occasionally camp there too if the hospital is close, even if they have their own bed.

==Setting up a Hospital==
* Hit {{k|i}} and set up a hospital [[zone]] in the area you plan on having your hospital. Be sure "Hospital" is highlighted. Proximity to [[water]] is a plus, since patients need to be washed and cannot drink alcohol.
* Place enough [[bed]]s in that zone to ensure you can keep all wounded dwarves in the hospital, plus a few spare that will be occupied by lazy couch-surfers.{{bug|647}} Note that normal beds or [[bedroom]]s can and will accept wounded dwarves whether or not a hospital zone exists, though hospital beds will be preferred if they are free. Doctors do not need a hospital zone, though a lack of equipment will probably limit care options.
* Build [[container]]s ({{k|b}}-{{k|h}}) to store hospital supplies. A small hospital can manage with 2 containers, while a fully fledged fortress with an adventurous military may need as many as 8. (Containers are not strictly necessary; doctors can and will use supplies from anywhere. But dedicated hospital containers allow you to earmark some supplies for medical use -- for example, to prevent the auto-looming of ''every'' last thread.)
* Build at least one [[table]] ({{k|b}}-{{k|t}}) for surgeons to perform surgery on. You may perform surgery without tables; it will be more messy.
** Place the tables right next to the beds, or you may get "cancels surgery, patient not resting" spam, as moving the sleeping patient more than one square from the bed to the table wakes up the patient. {{bug|2773}}
** Multiple dwarves may undergo simultaneous surgeries on the same table.
* Build one or more [[traction bench]]es to handle compound fractures when the dwarf requires "immobilization." Remember to check back on the <strike>victim</strike> patient after a while or they may be in the traction bench for a long, long time.{{bug|4470}} (Or be lucky; sometimes immobilization requests simply disappear with no bad consequences.)
** Each traction bench can only accommodate one dwarf at a time, and the dwarf may be there for quite some time, so plan accordingly.
* Stockpiles are not needed but can be used instead of chests and bags in the hospital zone.
* Assign a [[chief medical dwarf]] (in the [[noble]]s screen) to enable the fortress-wide [[health screen]] as well as invidual dwarves' health summary screens ({{k|v}}-{{k|z}}-{{k|h}}).
* Pick one or more dwarves to be doctors, and enable the health labor(s) on them (through {{k|v}}-{{k|p}}-{{k|l}}). Be sure the diagnosis labor is well covered. Without a diagnosis, patients cannot be treated. If they cannot be treated, they will occupy the hospital area until they die, performing no function. (Any dwarf with the Diagnosis labor enabled can diagnose dwarves, but the Chief Medical Dwarf may impact the diagnosis job creation{{verify}}. Once a patient is diagnosed, you can see on the individual health screen what procedures are needed, for example washing or suturing.)
* If you use a [[burrow]] to keep doctors near the hospital zone, ensure that this burrow covers all needed materials or you could get job cancellations because of lack of material. Thread/cloth stockpiles, and items bought from caravans (e.g. plaster early in the game) are often the most troubling.

== Skills and Injuries==
'''Doctors''' have 5 specialized skills and 2 support healthcare labors.

[[Diagnostician]] -- [[Surgeon]] -- [[Suturer]] -- [[Wound dresser]] -- [[Bone doctor]] -- Feed patients/prisoners -- [[Recovering wounded]]

Those with the '''recover wounded''' labor will attempt to bring a wounded dwarf to the hospital zone, or lacking one to the nearest unoccupied bed. Note that recovering wounded appears to be an extremely low priority task. Since immobile patients will need to be carried to a hospital before diagnosis, it may be necessary to temporarily disable all other labors on another dwarf to move them first.

A '''diagnoser''' will then identify and prescribe a treatment which any doctor (including himself) may carry out. A dwarf cannot be treated without a diagnosis. Depending on the injury a treatment labor will occur. Diagnosis is often required between procedures as well.

[[Wound|Injuries]]
:{| border=0 cellpadding=0 cellspacing=1 style="background: black"
|-
|<font color="#ffffff"> '''NONE: No recorded active wounds on the part.'''</font>
|-
|<font color="#808000"> '''MINOR: Any damage that doesn't have functional/structural consequences (might be heavy bleeding, though).'''</font>
|-
|<font color="#ffff00"> '''INHIBITED: Any muscular, structural, or functional damage, without total loss.'''</font>
|-
|<font color="#00ffff"> '''FUNCTION LOSS: An important function of the part is completely lost, but the part is structurally sound (or, at least partially intact). '''</font>
|-
|<font color="#ff0000"> '''BROKEN: The part has lost all structural integrity or muscular ability.'''</font>
|-
|<font color="#808080"> '''MISSING: The part is completely gone. '''</font>
|}
If a chief medical dwarf is appointed you can view your fortress' health using the {{k|z}}-status key), or individually by selecting a dwarf and using {{k|w}} for wounds section.
* '''Bones''' can be set and treated by bone doctors depending on severity using thread and cloth for fractures, splints and casts, or traction benches. Grasping is often impaired during healing. The {{DFtext|Immobilization Request}} status tag is an indication that a splint or plaster cast is required. Multiple overlapping and compound fractures require a surgeon. Caused by [[attack_types#Blunt_weapons|blunt]] trauma.
*'''Skin and muscle''' can be treated by a suturer using thread and cloth. The wound will continue to bleed until sutured, severe wounds impair grasping during healing. Closed wounds will be dressed by a wound dresser. Caused by [[attack_types#Edged_weapons|slashing]] injuries.
*'''Internal Organs''' can be treated or removed by a surgeon using tables and traction benches. Repair of infected or rotten wounds is treated similarly. Caused by [[attack_types#Piercing_weapons|piercing]] injuries.

Any dwarves with the Feed patients/prisoners labor will attempt to give food or a bucket of water to a hungry or thirsty patient. By default all dwarves start with the non-doctor labors designated. These have no corresponding [[skill]]s - they do not cause experience gain, but merely are activities that can be turned on/off for each dwarf.

==Infection==
Every open wound can become infected. Infections may heal over time; however, many dwarves will die due to infection, often months after the actual wounding.

Causes of infection include:
* No cleaning of the wounds.
* Cleaning with water from a [[Water#Stagnant_Water|stagnant water]] source.
* Cleaning with [[Water#Water_laced_with_mud|water laced with mud]]. {{Verify}}
* Cleaning without [[soap]].
* <s>Bad luck</s> [[Fun]]!

== Equipment ==
=== Traction Benches ===

A '''traction bench''' is used by a [[doctor]] in a [[Hospital|hospital zone]] to immobilize a dwarf that has sustained complex or overlapping fractures.

It is constructed in the [[Mechanic's workshop]], and requires a [[table]], a [[mechanism]], and a [[rope]] or a [[chain]] to construct. The [[quality]] of each component is not reflected in the quality of the traction bench, and only the [[material]] of the table is used as the material for the bench. "Recycling" low-quality, low-value components into high-quality traction benches can provide a modest increase in [[value]]. Note that if any [[Stockpile|stockpiles]] have been linked to "Give" to the workshop, all of the resources needed to construct the traction bench must be found in the linked piles (e.g., linking only a stone stockpile may prevent access to the necessary tables/ropes/chains).

Currently there is a bug that may prevent fully healed dwarves from ever leaving the traction bench. {{bug|4470}} Removing the traction bench will free the dwarf.

Do not be hasty in removing a presumably-stuck dwarf from traction, however. Such treatment takes weeks or months to succeed and removing the dwarf prematurely will undo all the progress that has been made. If the dwarf has been in traction without being diagnosed or otherwise treated for a month and the health screen shows no scheduled treatment, they probably were forgotten and need the traction bench deconstructed to release them. Another possible way to check if a dwarf is stuck is by {{k|v}}iewing the {{k|w}}ounds of the dwarf in question. If the damaged part isn't at red, then the dwarf is stuck.

=== Casts ===

Casts are made out of [[plaster powder]] and are used to keep broken bones in their proper place until healed. To store it in a hospital, build a chest or other container inside the hospital zone. Applying a cast also requires a bucket and cloth, and a water source.

Plaster powder is produced at a [[kiln]] or [[magma kiln]] from [[gypsum]], [[alabaster]], [[selenite]], or [[satinspar]] and an empty [[bag]] by a dwarf with the furnace operator skill enabled. They can also be bought at embark for 3 points per unit; each unit comes with a free [[bag]].

=== Splints ===
Splints immobilize limbs that have sustained bone fractures. They allow the broken limb to be utilized until it is fully healed, Dwarves will be able to leave the hospital and resume their normal duties once securely splinted up since by this stage their wounds have already been cleaned, sutured and dressed. Applied by a bone doctor.

They can be made out of one [[wood]] at the [[carpenter's workshop]] or out of one metal [[bar]] at the [[metalsmith's forge]] or the [[magma forge]]. The use of splints seems to be an effective alternative to applying a plaster cast, which are also easier to obtain and prepare. Splints are categorized as [[finished goods]].

=== Other equipment===
*[[Crutch]]es {{DFtext|┬|770}} help a crippled dwarf walk again.
*[[Table]]s are used to conduct operations on.
*[[Bed]]s are used by patients to rest.
*[[Thread]] is used to suture closed wounds.
*[[Cloth]] is used to clean wounds, wash patients and dress wounds.
*[[Soap]] is used to clean wounds, sterilizing and preventing infection.
*[[Water]] is used to clean wounds, bathe patients and give drink. Patients do not drink alcohol.
*[[Bucket]]s are used to gather and hold the water for its uses.
*[[Container]]s are used to store hospital supplies.

==Tips for an Effective Hospital==
* Regularly use ({{k|i}}-{{k|H}}) to examine your hospital stockpile. Ensure your hospital is well-stocked. If you run out of materials regularly, increase the limits.
* It is possible to do without soap in the hospital stockpile. Choosing to do so, however, increases the risk of infection, which most likely will kill your dwarf. Consult the [[soap]] page to understand that industry. Bring 1 lye on embark for one bar of soap, which translates to 150 units.
* Put a [[well]] inside (or near) the hospital for maximum efficiency. Doctors need to wash patients regularly, and clean water reduces infection.
* Do not place chairs next to your surgery tables. A chair is an invitation for rat-roast eating freeloaders to block the medical process.
* Consider making use of [[burrow]]s to ensure your healthcare workers stay in the area.
* You may wish to consider individual rooms for each bed if you find your doctors are choosing to treat Urist McScratched over Urist McBloodFountainTheGushing. A locked door minimizes the mess and thereby infection and allows you to prioritize.
* The Chief Medical Dwarf only enables the Health status screen. The position has no in-game use. Look after your CMDs if you rely heavily on this screen, but otherwise they can be treated as any other dwarf.
** Diagnosis skill level does not affect the diagnosis, only the time it takes for the diagnosis to happen. Embarking with a dwarf skilled in diagnosis (and other medical skills) is helpful, both to speed diagnosis and to stave off skill rust when long periods of time go between injuries.
** Also helpful is enabling medical skills on all dwarves in the fortress, which allows medical jobs to be picked up immediately so long as there is an idle dwarf.
* Create "nurses" by setting dwarves to only use the Recover Wounded, Bring Food and Water labors.
** It is important not to distract doctors from treating patients (or other medical helpers such as crutch haulers, or wounded recoverers).
** "Recover wounded", "Give food" and "Give water" are low priority jobs, so it is entirely possible for a patient to starve to death, dehydrate to death, or bleed to death if no one ever gets "unbusy" enough to bring them food, water, or move them to the hospital.
** Similarly, it is important not to put your doctors at risk by recovering wounded in the middle of a battle—if they become injured, they cannot treat themselves.
* You can select nurses who enjoy helping people to give them good thoughts. This also prevents dwarves that hate bringing others food from receiving unhappy thoughts.
* When a serious injury happens, don't exit (or save) the game until the injured are in the hospital zone, especially if a dwarf is immobile. "Bring crutch" and "Recover Wounded" jobs will be lost, keeping the patient away from the hospital, and doctors will NOT go to patients, even if burrowed with them, because a diagnose job hasn't been created. Sometimes a second "crutch required" or "recover wounded" request will be generated, but often too late for the patient's full recovery. Best bet is ensure someone (not burrowed) has "recover wounded" enabled at all times; burrow doctors doing non-medical tasks immediately; hope the patient makes it to the hospital.

Dwarves will prefer to store and use the most expensive thread and cloth. Yes, that includes special "[[raw adamantine|exotic]]" strands. You may want to forbid these during medical emergencies.

==Bugs==
* For a variety of reasons, an injured dwarf may leave the hospital and/or refuse to go to the hospital. {{Bug|309}}
* Adamantine thread used for suturing. {{Bug|1346}}
* Wounded [[justice|criminals]] don't get sent to the hospital. {{Bug|3901}}
* Your dwarf may get stuck in traction, even after the wounds have healed. If this happens, simply remove the traction bench. {{Bug|4470}}
* The quality and value of a finished traction bench doesn't account for all of the inputs used to make it. {{verify}}
* Purchased plaster powder does not appear in the hospital storage. {{verify}}
* Dwarves resting in bed may be starving/dehydrated and not being taken care of, deconstructing the bed to generate a new Recover Wounded task and force them to rest properly fixes this.

{{d for dwarf}}
Soap is the only item dwarves will use to sterilize a wound. While dwarves are of course aware that humans will pour perfectly quaffable alcohol over their bloody wounds and onto the filthy ground to get the same effect, dwarves understand that some things are more precious than a single life, and face oblivion with a bit more dignity. Application of extreme heat is also well known to prevent infections and seal a wound, but dwarves consider magma the only legitimate heat source, and the non-lethal application of magma a sacrilege.

{{Category|Healthcare}}
{{Industry}}

Cook

2014-08-19T22:01:01Z

Talvieno: Changed quality rating from "Unrated" to "Exceptional" using the rating script

{{Quality|Exceptional|22:01, 19 August 2014 (UTC)}}
{{Migrated_article}}

{{Skill
| color = 6:0
| skill = Cook
| profession = [[Farmer]]
| job name = [[Cooking]]
| workshop =
* [[Kitchen]]
| tasks =
* Prepare Easy Meal
* Prepare Fine Meal
* Prepare Lavish Meal
* Render Fat
| attributes =
* Agility
* Analytical Ability
* Creativity
* Kinesthetic Sense
}}
{{av}}

A '''Cook''' is a dwarf whose highest skill is in cooking. Cooks will prepare meals at the [[kitchen]] workshop using ingredients available in your fortress. They will also render [[fat]] into [[tallow]] at the kitchen. Both of these fall under the Cooking labor.

Although some kinds of [[food]] can be eaten raw, other food resources are ingredients which are only edible when cooked into a meal. Cooking thus increases the number of food sources available to your fortress. Conversely, cooking plants does not yield plant [[seed]]s, so cooking edible plants decreases your potential [[crop]]s. Eating high [[item quality|quality]] prepared food gives your dwarves happy [[thought]]s if the meal contains one of their [[preference|favorite]] foods {{Bug|4661}}. It is not precisely known how a cook's skill and the quality of ingredients affect the happiness generated by a meal, but as a general rule there's no such thing as "too good".

== Prepared Meals ==
There are three kinds of prepared meals: easy, fine, and lavish. All three of these give the same [[experience]] gain to the Cooking skill, so making easy meals maximizes experience gain; if you don't care about experience gain, preparing lavish meals saves much more stockpile space. The number of servings produced has no effect on experience gain. Prepared meals can [[wear|rot]], but will do so much more slowly than raw food, especially [[meat]].

Prepared meals are made with a varying number of ingredients:
* Easy meals require two ingredients, and are named "{last ingredient} biscuit".
* Fine meals require three ingredients, and are named "{last ingredient} stew".
* Lavish meals require four ingredients, and are named "{last ingredient} roast".

As you can see, the last ingredient added to the meal will determine its name, which in turn is determined more or less randomly by the order in which the cook grabs them. To successfully create a prepared meal, a cook must have access to the proper number of ''distinct stacks'' of ingredients when the job starts, otherwise the job will be cancelled. The same ingredient may be used for a meal multiple times, provided that ingredient is in multiple discrete stacks. The stack size of the finished prepared meal is the sum of the stack sizes of its ingredients, so a cook grabbing "turkey hen egg [14]", "plump helmets [5]" and "plump helmets [5]" would result in a stack of "plump helmet stew [24]". Prepared meals cannot be used as ingredients in other prepared meals.

Cooks may occasionally create a meal that has more than the required number of ingredients; roasts, for instance, may have 5, or, occasionally, 6 ingredients, or even rarely as many as 12. This behavior is presumably a bug, and may be related to the [[Main:Planepacked|Planepacked]] glitch and other similar bugs. It seems to occur when many stacks of the same food are available (for example, many, many quarry bush leaves) and the cook grabs multiple stacks of the same food.

Despite their large stack sizes, stacks of prepared meals can usually (though not always) fit into regular [[barrel]]s or [[pot]]s on a food stockpile.

Prepared meals are subject to quality modifiers to their base value while each individual ingredient gets a quality modifier as well, making prepared meals an extremely profitable item indeed.

=== Prepared Meal Value ===
This table shows how the [[item quality|quality modifiers]] compare to other items:
{| class="wikitable" cellspacing="0" border="1" cellpadding="5"
|-
! Quality
! Meal
! Ingredient
! Value Modifier
|-
|(normal)
|(none)
|minced
|1x
|-
|<nowiki>-Well-Crafted-</nowiki>
|well-prepared
|well-minced
|2x
|-
|<nowiki>+Finely-crafted+</nowiki>
|finely-prepared
|finely minced
|3x
|-
|*Superior quality*
|superior prepared
|superiorly minced
|4x
|-
|≡Exceptional≡
|exceptional prepared
|exceptionally minced
|5x
|-
|☼Masterful☼
|masterfully prepared
|masterfully minced
|12x
|}

The value of a stack of prepared meals is equal to the prepared meal's base value of 10 times the meal's quantity modifier (finely-prepared, etc.), plus the products of each ingredient's base value and its quality modifier (well-minced, etc.), all multiplied by the stack size. So, for example: a well-prepared meal consisting of 5 finely-minced cow cheese, 3 finely-minced llama tripe, 1 finely-minced llama sweetbread, and 2 superiorly minced mussels would be "-mussel roast [11]-", worth 770☼ (for 62☼ of ingredients!). (Exact calculation: (2*10 + 3*10 + 3*2 + 3*2 + 4*2)(5 + 3 + 1 + 2).

This example can be understood as:

(well-prepared = 2) x (base value of prepared meal = 10☼)

+

(finely-minced = 3) x (value of cheese = 10☼)

+

(finely minced = 3) x (value of tripe = 2☼)

+

(finely minced = 3) x (value of sweetbread = 2☼)

+

(superiorly minced = 4) x (value of mussels = 2☼)

all multiplied by the total number of ingredients (11)

=

770☼

The individual stack sizes of the ingredients may affect your profits, but have no effect on the final meal's value. One "masterfully minced plump helmet" cooked with ten "well-minced dog meat" will have exactly the same value and description as ten "masterfully minced plump helmet" and one "well-minced dog meat".

== Boozecooking==
Booze (and other liquid ingredients) can be used as an ingredient in prepared meals, but the first ingredient stack of any prepared meal must be a solid.

== Training ==

When rendering large units of fat (for example from elephants or forgotten beasts) a dwarf gains cooking skill extremely quickly due to the dozens or hundreds of units of tallow created per task - even to the point of going from dabbling to skilled in a single task. Thus rendering fat can be used to rapidly train cooking to high levels.

== Bugs ==
* Cooks will only use liquid bases (like [[dwarven syrup]]) as a last resort, instead preferring to cook solid foods with solid foods. {{Bug|2393}} A workaround for this is to set up multiple stockpiles around the kitchen, with ''only'' the stockpile for dwarven syrup set to allow barrels. When the other cooking materials around the kitchen are '''not''' in barrels, the cooks will use the dwarven syrup along with the other foodstuffs to cook their meals.
* Cooks prefer solid ingredients stored in containers (and, even more so, ingredients stored in containers stored in containers--e.g. [[flour]], [[quarry bush]] leaves, etc.).
* Cooking with eggs creates extreme kitchen [[clutter]]. {{Bug|3994}}
* Frozen milk gets cooked into prepared meals as a solid, causing the meal to melt later. {{Bug|2787}}
* High [[quality]] cooked meals only give a happy [[thought]] if at least one of the ingredients is [[preference|preferred]] by the dwarf eating it. {{Bug|4661}}

Monarch

2014-08-19T17:29:37Z

Talvieno: Changed quality rating from "Exceptional" to "Superior" using the rating script

{{Quality|Superior|17:29, 19 August 2014 (UTC)}}
{{Migrated_article}}

{{Noble
| noble= Monarch
| office= Royal Throne Room
| quarters= Royal Bedroom
| dining= Royal Dining Room
| tomb= Royal Mausoleum
| chests=10
| cabinets=5
| racks=5
| stands=5
| mandates=5
| demands=10
| arrival=
* 15,000☼ wealth in Architecture
* 5,000☼ in offerings to Dwarven [[caravan]]
* [[Fortress|Metropolis]] rank
}}{{av}}

The '''monarch''' is the highest level [[noble]], and also the noble of the highest precedence. Rather than being promoted from within, like the [[baron]], [[count]], and [[duke]], the monarch arrives as an immigrant from the previous capital. However, a Monarch may be appointed in your civilization without a migrant wave if the parent civilization has been destroyed. It is not required to have a baron or a count prior to the monarch's arrival. A male monarch is known as a "king" and a female as a "queen". Either may arrive with a "[[king consort]]" or "queen consort", as well as an entourage that can include elite military dwarves and ordinary workers.

Requirements for a monarch's arrival can be checked by pressing {{k|n}} {{k|c}} after a [[fortress]] has reached a certain [[wealth]]. It is unclear exactly what these requirements are, but usually a fortress must be a [[Fortress|metropolis]].

When the monarch arrives, a fortress becomes the capital of its [[civilization]]. As a result, it can no longer receive visits from a dwarven [[liaison]], nor can it give goods to dwarven caravans as offerings.

The monarch arrives at the same time as an [[immigration]] wave, but has an entirely separate entourage that can spawn from a different part of the map. The monarch's entourage consists of a group of dwarves with Legendary +5 skill in a random weapon (but no skill in Fighter), Accomplished skill in Dodger, Shield User, and Armor User, and the "doesn't really care about anything anymore" trait. This wave will arrive even if you have exceeded your [[Immigration|population cap]].

It may be that your monarch is an ancient [[vampire]] with thousands of kills to his name before arriving at your fortress. Some monarchs have been known to drop dead as soon as they enter the map, especially in older worlds. Monarchs may also be of a different race, such as [[Main:Cacame Awemedinade|an elven king]].

Random dwarves in [[dwarf fortress mode]] can become monarchs if the current monarch dies or if the civilization the user is playing as was previously extinct. Players can thus "resurrect" dead civilizations.

{{gamedata| [POSITION:MONARCH]
[NAME_MALE:king:kings]
[NAME_FEMALE:queen:queens]
[NUMBER:1]
[SPOUSE_MALE:king consort:kings consort]
[SPOUSE_FEMALE:queen consort:queens consort]
[SUCCESSION:BY_HEIR]
[RESPONSIBILITY:LAW_MAKING]
[RESPONSIBILITY:RECEIVE_DIPLOMATS]
[RESPONSIBILITY:MILITARY_GOALS]
[PRECEDENCE:1]
[SPECIAL_BURIAL]
[RULES_FROM_LOCATION]
[MENIAL_WORK_EXEMPTION]
[MENIAL_WORK_EXEMPTION_SPOUSE]
[SLEEP_PRETENSION]
[PUNISHMENT_EXEMPTION]
[FLASHES]
[BRAG_ON_KILL]
[CHAT_WORTHY]
[DO_NOT_CULL]
[KILL_QUEST]
[EXPORTED_IN_LEGENDS]
[DETERMINES_COIN_DESIGN]
[COLOR:5:0:1]
[ACCOUNT_EXEMPT]
[DUTY_BOUND]
[DEMAND_MAX:10]
[MANDATE_MAX:5]
[REQUIRED_BOXES:10]
[REQUIRED_CABINETS:5]
[REQUIRED_RACKS:5]
[REQUIRED_STANDS:5]
[REQUIRED_OFFICE:10000]
[REQUIRED_BEDROOM:10000]
[REQUIRED_DINING:10000]
[REQUIRED_TOMB:10000]}}
{{nobles}}
{{Category|Aristocrats}}

DF2014:Evil

2014-08-19T01:07:28Z

Talvieno: Hoping this works.

#REDIRECT [[DF2014:Surroundings#Evil]]

Phantom spider

2014-08-19T01:06:02Z

Talvieno: removed migration tag

{{Quality|Exceptional}}
{{verminlookup/0|wiki=no}}
{{av}}
{{creaturedesc}}

'''Phantom spiders''' are [[vermin]] that occur in [[Region#surroundings|evil]] forest [[biome]]s. They are closely related to [[cave spider]]s; they produce webs that can be collected and woven into [[thread]] at a [[loom]], and bite [[creature]]s to inject a venom which causes numbness and dizziness for approximately one [[time|month]]. Note that stripping an area of available [[tree]]s reduces the amount of webbing present due to dwarves trampling it.

{{gamedata}}
{{vermin}}

Raw adamantine

2014-08-18T06:58:38Z

Talvieno: removed migrated article tag

{{Quality|Exceptional|06:58, 18 August 2014 (UTC)}}

{{stonelookup/0|wiki=Adamant}}
{{av}}
{{minorspoiler}}

The ore of [[adamantine]] is absurdly valuable, and can be processed into one of the most valuable [[material]]s in the game, both in monetary value and utility. Its discovery is both a blessing and a curse; it has a massive [[value]] even unrefined, and weapons and armor made from it are very likely among the best possible. Its high melting point means you can easily use it to build magma-safe mechanisms and floodgates, but this is not recommended due to its scarcity and value in other items.

Raw adamantine has a [[Item_value#Material_multipliers|Material Multiplier]] of x250. For a comparison to other mined materials, generic [[stone]] has a MM of x1, [[obsidian]] x3, [[native silver]] x 10, [[native gold]] x30, and [[native platinum]] x40. Processed [[adamantine]] "metal" has a multiplier of x300, the highest in the game of any [[material]].

__TOC__

Adamantine is so valuable, both in price and usefulness, that a special message pops up when your miners discover a vein of it.

[[Image:raw adamantine 34.11.png]]

== Location ==

Every map can contain adamantine, regardless of the location. Very small maps can lack adamantine veins, usually however multiple veins are present (~1 per 4 embark squares). If an adamantine vein is located in an embark square, it will be in the center of this square. Adamantine veins can appear on the surface, but will be bordered by a great magma sea.(Confirmed in adventure mode)

More specific statistics, [http://www.bay12forums.com/smf/index.php?topic=69048.msg1677543#msg1677543 from this forum post]:

: Word of Toady, and supported by all the careful research I've seen so far, is that there is one blue spire generated in every 2x2 [[embark]] grid, randomly placed amongst the four embark squares. Every 16x16 region square therefore has exactly 64 blue (and one special [[main:HFS|HFS]]). A 2x2 embark aligned to the grid will have exactly one blue spire. A 2x2 embark offset may have as few as none or as many as four blue spires. Over all the possible configurations of 2x2 embarks, your odds are as follows (rounded): zero blue, 20.4%; one blue, 60.6%, two blue, 17.8%, three blue, 1.8%, four blue, 0.1%, with an average (not surprisingly) of one blue; you also have a chance of special HFS of about 1.6%.

: A 3x3 is guaranteed (barring serious program bugs) to have at least one blue, has an average of 2.25 blue, and a max of four blue, with a special HFS chance of about 3.5%. An unaligned 4x4 still has a minimum of one blue, but an average of four blue, and a max of nine blue; with special HFS chance of about 6.3%; aligning it with the grid gives you exactly four blue. Moving up to a 5x5 increases the minimum blue to four, with an average of 6.25 and a max still of nine; the special HFS chance is 9.8%. If you're planning on making the HFS a major part of your fortress and don't cheat with reveal, an aligned 4x2 is the smallest you can generate that is guaranteed to have multiple blue (and therefore a high chance of multiple entrances, reducing the risk that one of the spires will not be traversable).

==Storage==
Raw Adamantine is stored in stone stockpiles with "Raw Adamantine" enabled in that stockpile's 'other stone' category. Once extracted, adamantine strands will be stored in Cloth stockpiles which have the appropriate materials enabled.

==Veins and Mining==

[[File:Adamantine_vein_large_profile.png|200px|thumb|right|A profile view of an adamantine vein travelling through an underground cavern, solid rock, and a magma sea. For more detail and resolution click the thumbnail.]]

It's worth noting that a tile of Raw adamantine, when mined out, will always produce a stone. Raw adamantine veins, in contrast to usual ore veins, span z-levels nearly exactly straight upwards, and are thicker than many gem clusters. Adamantine veins can span from 5 to 30-40 z-levels, sometimes even significantly more. Despite being impossibly strong in its refined form, a simple copper pick works fine for mining it out, and the vein is full of raw adamantine ripe for the diggin'. Just make sure you don't dig too deep...

One serious downside to mining veins of raw adamantine is that they are hollow, and digging into the hollow section will lead to a certain [[Hidden fun stuff|spoiler]], triggering [[losing|dangerously large amounts of fun]] which can and usually will wipe out even a mature, heavily defended fortress. On the bright side, the location of all adamantine veins will be revealed at this time.

Hollow sections are always 2x2 tiles in size, encased by a 4x4 unbroken block of adamantine. A hollow section on one z-layer shares at least one x or y tile with the hollow sections above and below it. Using these constants, it is easy to determine where the hollow sections are not and mine the "safe" areas only, allowing you to mine about 50% of vein safely. However, one wrong designation can lead to disaster...

Adamantine can be found in vertical pillars in the [[magma sea]]. This makes mining difficult, as one must either drain the area around the pillar to mine the pillar fully, or in cases of thicker pillars, mine out only the interior without breaching the exterior layer (and thus flooding the interior with magma). However, with the access to vast amounts of water almost guaranteed on any map thanks to underground lakes, it might be possible to use selective flooding to cool the magma around the adamantine, and build walls of obsidian around them.

{{gamedata}}
{{stones}}
{{Category|Ore}}
{{Category|Economic Stone}}

Raw adamantine

2014-08-18T06:58:18Z

Talvieno: Changed quality rating from "Unrated" to "Exceptional" using the rating script

{{Quality|Exceptional|06:58, 18 August 2014 (UTC)}}
{{Migrated_article}}

{{stonelookup/0|wiki=Adamant}}
{{av}}
{{minorspoiler}}

The ore of [[adamantine]] is absurdly valuable, and can be processed into one of the most valuable [[material]]s in the game, both in monetary value and utility. Its discovery is both a blessing and a curse; it has a massive [[value]] even unrefined, and weapons and armor made from it are very likely among the best possible. Its high melting point means you can easily use it to build magma-safe mechanisms and floodgates, but this is not recommended due to its scarcity and value in other items.

Raw adamantine has a [[Item_value#Material_multipliers|Material Multiplier]] of x250. For a comparison to other mined materials, generic [[stone]] has a MM of x1, [[obsidian]] x3, [[native silver]] x 10, [[native gold]] x30, and [[native platinum]] x40. Processed [[adamantine]] "metal" has a multiplier of x300, the highest in the game of any [[material]].

__TOC__

Adamantine is so valuable, both in price and usefulness, that a special message pops up when your miners discover a vein of it.

[[Image:raw adamantine 34.11.png]]

== Location ==

Every map can contain adamantine, regardless of the location. Very small maps can lack adamantine veins, usually however multiple veins are present (~1 per 4 embark squares). If an adamantine vein is located in an embark square, it will be in the center of this square. Adamantine veins can appear on the surface, but will be bordered by a great magma sea.(Confirmed in adventure mode)

More specific statistics, [http://www.bay12forums.com/smf/index.php?topic=69048.msg1677543#msg1677543 from this forum post]:

: Word of Toady, and supported by all the careful research I've seen so far, is that there is one blue spire generated in every 2x2 [[embark]] grid, randomly placed amongst the four embark squares. Every 16x16 region square therefore has exactly 64 blue (and one special [[main:HFS|HFS]]). A 2x2 embark aligned to the grid will have exactly one blue spire. A 2x2 embark offset may have as few as none or as many as four blue spires. Over all the possible configurations of 2x2 embarks, your odds are as follows (rounded): zero blue, 20.4%; one blue, 60.6%, two blue, 17.8%, three blue, 1.8%, four blue, 0.1%, with an average (not surprisingly) of one blue; you also have a chance of special HFS of about 1.6%.

: A 3x3 is guaranteed (barring serious program bugs) to have at least one blue, has an average of 2.25 blue, and a max of four blue, with a special HFS chance of about 3.5%. An unaligned 4x4 still has a minimum of one blue, but an average of four blue, and a max of nine blue; with special HFS chance of about 6.3%; aligning it with the grid gives you exactly four blue. Moving up to a 5x5 increases the minimum blue to four, with an average of 6.25 and a max still of nine; the special HFS chance is 9.8%. If you're planning on making the HFS a major part of your fortress and don't cheat with reveal, an aligned 4x2 is the smallest you can generate that is guaranteed to have multiple blue (and therefore a high chance of multiple entrances, reducing the risk that one of the spires will not be traversable).

==Storage==
Raw Adamantine is stored in stone stockpiles with "Raw Adamantine" enabled in that stockpile's 'other stone' category. Once extracted, adamantine strands will be stored in Cloth stockpiles which have the appropriate materials enabled.

==Veins and Mining==

[[File:Adamantine_vein_large_profile.png|200px|thumb|right|A profile view of an adamantine vein travelling through an underground cavern, solid rock, and a magma sea. For more detail and resolution click the thumbnail.]]

It's worth noting that a tile of Raw adamantine, when mined out, will always produce a stone. Raw adamantine veins, in contrast to usual ore veins, span z-levels nearly exactly straight upwards, and are thicker than many gem clusters. Adamantine veins can span from 5 to 30-40 z-levels, sometimes even significantly more. Despite being impossibly strong in its refined form, a simple copper pick works fine for mining it out, and the vein is full of raw adamantine ripe for the diggin'. Just make sure you don't dig too deep...

One serious downside to mining veins of raw adamantine is that they are hollow, and digging into the hollow section will lead to a certain [[Hidden fun stuff|spoiler]], triggering [[losing|dangerously large amounts of fun]] which can and usually will wipe out even a mature, heavily defended fortress. On the bright side, the location of all adamantine veins will be revealed at this time.

Hollow sections are always 2x2 tiles in size, encased by a 4x4 unbroken block of adamantine. A hollow section on one z-layer shares at least one x or y tile with the hollow sections above and below it. Using these constants, it is easy to determine where the hollow sections are not and mine the "safe" areas only, allowing you to mine about 50% of vein safely. However, one wrong designation can lead to disaster...

Adamantine can be found in vertical pillars in the [[magma sea]]. This makes mining difficult, as one must either drain the area around the pillar to mine the pillar fully, or in cases of thicker pillars, mine out only the interior without breaching the exterior layer (and thus flooding the interior with magma). However, with the access to vast amounts of water almost guaranteed on any map thanks to underground lakes, it might be possible to use selective flooding to cool the magma around the adamantine, and build walls of obsidian around them.

{{gamedata}}
{{stones}}
{{Category|Ore}}
{{Category|Economic Stone}}

Bedroom

2014-08-18T06:55:57Z

Talvieno: removed migrated article tag.

{{av}}
{{Quality|Exceptional|06:22, 15 July 2010 (UTC)}}

A '''bedroom''' is a [[room]] defined from a [[bed]]. Bedrooms are automatically claimed by [[dwarves]] (or spouse of dwarves); or they may be manually assigned to a dwarf. Once a bedroom has an owner, it becomes the private quarters for that dwarf, where he/she will [[sleep]], store any belongings that are not carried, and hang out in if there is no [[activity zone|meeting area]]. Alternatively, a bedroom may be designated as a [[barracks]] or [[dormitory]].

==Setup and ownership==
To create a bedroom, you must first craft a [[bed]] in a [[carpenter's workshop]], then {{k|b}}uild it. Dwarves will not sleep in beds which have been produced in a workshop until they are placed via the build menu. Dwarves will sleep in beds that are built, but will not claim them until they are properly designated as a bedroom. To turn a bed into a bedroom, you must {{k|q}}uery the bed, make a bed{{k|r}}oom out of it, and set it to the desired size.

A dwarf with no bedroom will automatically claim an unowned bedroom upon sleeping in it. The player can also manually assign bedrooms or change the ownership from one dwarf to another. Married couples have joint ownership of a single bedroom and sleep in the same bed; [[children|babies]] will also share a bedroom with their mother until they grow into children. Assigning a dwarf a new bedroom will NOT un-assign them from their old bedroom(s), if you want them to only have one bedroom you'll need to track down their old bedroom and un-assign it.

===Other furniture===
Turning a bed into a bedroom makes all other pieces of [[furniture]] in the room (such as [[cabinet]]s and [[container|coffer]]s) usable by the dwarf that owns the bedroom. Owning furniture (especially high-quality furniture) gives dwarves happy [[thought]]s, and cabinets and coffers give them a place to store their possessions.

To remove a bedroom, {{k|q}}uery the bed that the room comes from and {{k|f}}ree it. The bedroom will be removed, and the bed will become a normal, constructed bed.



==Design tips==
[[Image:Dwarven_Housing.png|thumb|right|A true dwarf does not care for pretty designs or "privacy". For a dwarf, a bedroom is a hole where he dumps his body for rest and his [[Finished goods|Useless crap]] for storage, to never touch again.]]
{{main|Bedroom design}}
The living quarters of a fortress can take up a very large area, and since there will be constant [[traffic]] of dwarves going to and from their bedrooms, it is important to put some thought into the placement of the bedrooms. Simply making a long hall with rooms branching off from it is a simple method, but dwarves living at the end of the hall will have to travel a long time, and there will be a lot of dwarves bumping into each other at the entrance of the hall. Making multilevel living complexes can dramatically reduce the amount of time it takes for dwarves to travel to their bedrooms.

There is no need to build massive palaces for the average dwarf. They will get happy [[thoughts]] just from having a bedroom to claim as their own, though bigger and shinier ones will make them happier. Three tiles gives enough room for a [[bed]], a [[cabinet]], and a [[chest]], everything a dwarf needs. These pieces of furniture do ''not'' block movement.

{{Buildings}}
{{Category|Rooms|Bedroom}}

Magma sea

2014-08-18T06:50:14Z

Talvieno: Changed quality rating from "Exceptional" to "Fine" using the rating script

{{Quality|Fine|06:50, 18 August 2014 (UTC)}}
{{av}}

{{Minorspoiler}}

The '''Magma sea''' is a large, multi-level 'sea' of [[magma]] that expands across the entire world. These can typically be found by around Z level -120 (though this seems to vary wildly (minimum -5 maximum -450 z level){{verify}}. The '''magma sea''' is always found below the last [[Cavern]] level.

It is not uncommon to find multiple z-levels of pillars of [[Raw adamantine]] in the magma sea (in fact, a 3x3 embark square guarantees at least one).

In addition, around and under the magma sea is [[semi-molten rock]], which is impassible. There are [[Demonic fortress|a]] [[Hidden_Fun_Stuff|few]] [[Underworld spire|exceptions]], however.

Any items or natural rock walls dropped into the magma sea (specifically, onto "magma flow" tiles above semi-molten rock) will vanish without a trace.

Stockpiles may not be placed on a Magma Flow tile. However, the Magma Flow tile can be 'destroyed' by creating a construction on top of it and removing the construction.

==Wildlife==
* [[Fire imp]]
* [[Fire man]]
* [[Fire snake]]
* [[Magma crab]]
* [[Magma man]]

Magma sea

2014-08-18T06:49:44Z

Talvieno: Changed quality rating from "Unrated" to "Exceptional" using the rating script

{{Quality|Exceptional|06:49, 18 August 2014 (UTC)}}
{{av}}

{{Minorspoiler}}

The '''Magma sea''' is a large, multi-level 'sea' of [[magma]] that expands across the entire world. These can typically be found by around Z level -120 (though this seems to vary wildly (minimum -5 maximum -450 z level){{verify}}. The '''magma sea''' is always found below the last [[Cavern]] level.

It is not uncommon to find multiple z-levels of pillars of [[Raw adamantine]] in the magma sea (in fact, a 3x3 embark square guarantees at least one).

In addition, around and under the magma sea is [[semi-molten rock]], which is impassible. There are [[Demonic fortress|a]] [[Hidden_Fun_Stuff|few]] [[Underworld spire|exceptions]], however.

Any items or natural rock walls dropped into the magma sea (specifically, onto "magma flow" tiles above semi-molten rock) will vanish without a trace.

Stockpiles may not be placed on a Magma Flow tile. However, the Magma Flow tile can be 'destroyed' by creating a construction on top of it and removing the construction.

==Wildlife==
* [[Fire imp]]
* [[Fire man]]
* [[Fire snake]]
* [[Magma crab]]
* [[Magma man]]

Magma sea

2014-08-18T06:49:23Z

Talvieno: removed migration tag, fixed grammar error, added link to new stuff, polished.

{{quality|unrated}}{{av}}

{{Minorspoiler}}

The '''Magma sea''' is a large, multi-level 'sea' of [[magma]] that expands across the entire world. These can typically be found by around Z level -120 (though this seems to vary wildly (minimum -5 maximum -450 z level){{verify}}. The '''magma sea''' is always found below the last [[Cavern]] level.

It is not uncommon to find multiple z-levels of pillars of [[Raw adamantine]] in the magma sea (in fact, a 3x3 embark square guarantees at least one).

In addition, around and under the magma sea is [[semi-molten rock]], which is impassible. There are [[Demonic fortress|a]] [[Hidden_Fun_Stuff|few]] [[Underworld spire|exceptions]], however.

Any items or natural rock walls dropped into the magma sea (specifically, onto "magma flow" tiles above semi-molten rock) will vanish without a trace.

Stockpiles may not be placed on a Magma Flow tile. However, the Magma Flow tile can be 'destroyed' by creating a construction on top of it and removing the construction.

==Wildlife==
* [[Fire imp]]
* [[Fire man]]
* [[Fire snake]]
* [[Magma crab]]
* [[Magma man]]

Forgotten beast

2014-08-17T18:07:49Z

Talvieno: Changed quality rating from "Unrated" to "Superior" using the rating script

{{Quality|Superior|18:07, 17 August 2014 (UTC)}}
{{Migrated_article}}

{{av}}

{{minorspoiler}}

''In the deep, there are beasts so fell and terrible, that only they know what they are, for none who have met them have lived to tell of it... they are the Forgotten Beasts, born of the chaos from before the world's birth... they have waited, brooding in the dark places of the world... and now... by digging too deep... we have awakened them.''

'''Forgotten Beasts''' are large, monstrous, procedurally generated creatures that spawn in the [[caverns]] beneath your fortress, [[path]]ing through to your fort and seeding destruction amongst your dwarves. They are the subterranean equivalent of [[titan]]s.

Forgotten beasts are attracted by [[wealth]] and population size. Additionally, one may randomly appear when you reclaim a fortress. When a forgotten beast becomes visible onscreen, the game automatically pauses and displays a message.

== Generation ==
{{random image|location=right|size=300px}}

Forgotten beasts are procedurally randomized, and may be of any form, and be made of any sort of material. Multiple forgotten beasts may come to attack your fortress, each coming at different times. Most take the form of an animal, some not found in vanilla DF, with extra features (e.g. extra eyes, feathers) or removed body parts (e.g. skinless cobras) and unusual colours. However, a Forgotten Beast can also take more generic forms, such as shelled blobs, quadrupeds, and humanoid golems. Materials range from flesh and blood, to flimsy things like [[ash]] and [[steam]], to truly scary monsters of pure [[rock]], [[gem]], or [[metal]]. They may get a special attack, ranging from anything between venomous stings, poisoned blood, explosive dust clouds, to flame breath.

If a forgotten beast has a venomous attack of some sort, it is randomly generated as are the resulting [[symptoms]]. The beast's [[Syndrome#Breath_attacks|breath attack]] is also randomly generated, if it has one. Venom attacks come in a variety of forms, from boiling ichor to trailing dust, and the effects can range from mild pain to complete and instantaneous necrosis or paralysis. Some forms of venom can spread from spatters and contact with your dwarves, eventually infecting your entire fort. Decontaminating your soldiers in shallow running water is one way to deal with this problem. Some beasts breathe fire or shoot [[web]] in lieu of any syndrome-bearing attacks. Web-shooters are immune to the effects of webs they, or any other creature, create and will shoot web even at targets they lack a proper path to. Forgotten beasts based on spiders may be capable of shooting webs in addition to any other special abilities.

The number of forgotten beasts cannot be controlled directly, but is influenced by the size of the world. They dwell most often in caverns. All are [[building destroyer]]s, and are almost entirely immune to [[trap]]s (they are trapavoid and nostun but non-webspinners will trigger a trap that has been webbed). [[Bridge]]s are also less useful, as they cannot be raised or lowered as long as the beast is standing on (or under) them, preventing the traditional [[magma]] pit / [[dwarven atom smasher]] designs from working. This is probably one of [[Main:Toady One|Toady One]]'s ways of making the encounters even more [[fun]].

[[Image:DF2010ForgottenBeast1.png|thumb|center|500px]]

== Death and application ==
{{random image|location=right|size=300px}}
If you need to kill a Forgotten Beast, order your military to attack. Some beasts, however, are content not to path to your fortress and will stay dormant underground. Most "fleshy" forgotten beasts can be butchered; some are quite massive and may leave you with hundreds of meat and bone units and dozens of prepared organ units. Forgotten beast [[shell]]s may prove valuable during a [[strange mood]], particularly on a map without other sources of shells. Unfortunately, all forgotten beasts have a value multiplier of 1.

Some Forgotten Beasts whose bodies are made of liquid, gas, fire, or powder will die or lose limbs on the first hit. Other Forgotten Beasts are extremely difficult to kill due to being made of very hard materials or having an amorphous shape. When confronted with such near-invulnerable creatures the only option is usually to use your brain and try to lock it away somehow. Walls and raised [[bridge|draw bridges]] stop them. Since they are [[building destroyer]]s, you can used installed [[furniture]] to lure them to a particular location. If you can put it in a pit, a clever trapmaker can feed it invaders. If a near-indestructible beast isn't in a position to threaten your dwarves, it can be used to train marksdwarves.

One method of defeating nearly combat-invulnerable Forgotten Beasts (those whose bodies are made of rock, for instance) is to cause a [[Cave-in]] on top of them. They'll be killed by dropping either natural or constructed walls or floors on them. It is also possible to capture some forgotten beasts in cage traps by using [[giant cave spider]] webs (or similar).

You can prevent Forgotten Beasts from appearing by editing [[d_init.txt]] to change [INVADERS:YES] to [INVADERS:NO], though that will also prevent [[ambush]]es and [[siege]]s.

== Bugs ==
* If a beast has a dust attack, the dust will behave like it was from a [[cave-in]], flinging dwarves away (causing further damage if they hit a wall) and knocking them out. {{Bug|3133}}

== Forgotten Beast Threat Analysis==
'''If you do not want your [[fun]] spoiled, do not look below!'''

{{clear|both}}

Forgotten beast pose different levels of threat to your fortress, based on their composition, body shape, movements or special attacks.

Of course, general threat must be appraised after all categories

'''Material Composition'''
*''Water, Grime, Filth, Salt, Steam, Smoke, Snow'': Liquids, gasses, and powders are incredibly fragile. Unless paired with a dangerous attack method, these should not be a threat at all.
*''Fire'': While very fragile, [[fire]] is incredibly !![[fun]]!!. This type of forgotten beast will usually stay at the edge of the map and may burn large parts of the cavern when it first enters. Engagement should be avoided if it does not path to your fortress (and into a trap) as it could cause casualties with fire spread, contact, and fireballs (passive ability). Dropping an unarmed goblin or two (or a ceiling) on top of it should kill it as it will die as easily as any other gas beast. Upon death, beasts made of fire tend to explode in a large fireball which will kill all units within range, so keep your melee fighters away!
*''Flesh'': Most forgotten beasts are fleshy. It's about the standard level of threat for a forgotten beast.
*''Rock or Mineral'': Quite difficult, but not unbeatable. Can be damaged with metallic weapons. Beasts may be made of native copper or silver ore; see below for those.
*''Glass or Gem'': Dangerous. You may want to eschew melee combat, unless you've got sufficiently good weapons and dwarves.
*''Non-weapon grade metal'': Similar to rock forgotten beasts. Most weapons-grade metal can damage it.
*''Copper/Silver'': If you've got a good military and weapons as good as bronze, it should at least be beatable. Don't expect an easy fight by any means, however.
*''Bronze'': If you have encountered a bronze colossus before, this beast should be comparable in how dangerous it is. Whether it is more or less dangerous will depend on various features such as size, body type, whether it can fly, material emissions and whatever syndromes it may possess.
*''Iron'': It's quite possibly more dangerous than a bronze colossus, so be on your guard. Do not send anything against it that has less than steel weapons. Magma does nothing against these.
*''Steel'': It's official: the RNG hates you. These can be beaten only with cunning traps (magma won't do anything) or adamantine weapons.

'''Body Shape'''
*''Blob'': Possibly the easiest shape to fight - having only a single body part, all attacks will target it, causing it to accumulate damage rapidly and explode into gore.{{verify}} Has only a blunt push attack, which at a FB's size is deadly.
*''Quadruped, Humanoid'': about the average for FB's. Try and use cutting weapons to cripple them.
*''Insect, Spider'': Obnoxious because of the large amounts of redundant limbs. Spiders will be guaranteed to have a webbing attack and should thus be treated with extreme care.

'''Movement'''
*''Walking'': Normal movement.
*''Flying'': More dangerous than walking, for obvious mobility reasons. Be sure you only have one entry for your caverns.

'''Special attack'''
*''None'': Consider yourself lucky—most forgotten beasts have some kind of [[Syndrome]]-based effect. However, certain kinds of beasts have inherent abilities, like fire balls for a beast composed of fire, or webs for a spider-based beast.
*''Noxious Secretions'': Every single part of the creature's body is covered in extract. If it's in liquid or solid form and any of your dwarves touch this extract, they will receive the syndrome effects. Usually not a threat since dwarves are often well clothed, your military even more so. If the secretions are in gas form, treat the FB as if it has a toxic breath attack. Note that, unlike other attacks, gaseous noxious secretions are effective even if the beast is [[cage]]d.
*''Hunger for warm blood'': When the creature stabs the opponent, some blood will be drawn. Not dangerous.
*''Poisonous bite or sting'': Not dangerous by FB standards.
*''Spitting glob'': Generally not dangerous, unless you forgot shields and shield use on your military for some reason.
*''Fire breath'': By itself not threatening if you have shields and decent shield skill. However, [[Fun]] is always where fire is—a burst of flame is quite likely to start a cavern wildfire.
*''Toxic blood, vapor, or gas'': Threat depends of the syndrome's effects. Can be harmless or kill your entire military. You may want to sacrifice something for seeing what the FB's extract does.
*''Webs'': Webs are incredibly deadly in melee, but do not help much in range. It will slaughter your whole melee squad with incredible ease, but not your ranged squad as long as the ranged squad is out of reach. Engage it with marksdwarves or kill it with a cunning trap.
*''Deadly dust'': Possibly the most [[fun]] attack a FB can come with. Deadly dust acts like [[cave-in]] dust with syndromes. Dust coming from all directions (as opposed to a breath attack) is even more [[fun]]. If the material of the FB of is weak (like flesh), or if it has articulations or organs to be damaged, it will harm itself with its own deadly dust. However if it is made of stronger material, it will be immune to this effect. Deadly dust is generally a very effective defense against melee and marksdwarves, but is a liability if the FB is fleshy and not a blob.

==Applications==
Forgotten beasts are hard to catch, being both [[Creature token#T|[TRAPAVOID]]] and [[Creature token#N|[NOSTUN]]]; however trapping them is not impossible. All webbed creatures become vulnerable to [[trap]]s, except for the ones that have a [[web]]bing attack of their own: having a [[giant cave spider]] shoot web on your cage traps will render them into perfect FB-proof nets. Your new prizes can be put to various uses; the most obvious ones consist in dropping them onto various invaders - forgotten beasts are hostile toward each other and will attack any [[Surroundings|wildlife]] or [[Civilization|civilized]] creature they may encounter - but with careful micromanagement, the opportunities are limitless.

===Silk farm===
Web-shooting forgotten beasts are notoriously hard to catch and you'll only get your hands on one of these through ''very'' careful micromanagement, such as building a 'trap room' with retractable bridges and some random animal at the center to attract the beast. The set-up is otherwise the same as that of a [[silk farm]], except that forgotten beast silk is only as valuable as mere [[cave spider]] silk. Note that some beasts have special attacks ''in addition'' to their web-shooting ability (in the case of beasts based on spider-like anatomy resembling that of the [[giant cave spider]]), which may make them more difficult to capture and use (as they may kill their targets rather than simply covering them with webs).

===Weapon coating===

[http://www.bay12forums.com/smf/index.php?topic=91084 Syndrome-bearing poison can and will affect any creature it can spread to and infect.] While there is no formal job or workshop related to poison coating in vanilla DF (although it does exist in some [http://dwarffortresswiki.org/index.php/Masterwork:Main_Page mods]), poisoning your weapons is still possible thanks to the impossibly infinite metabolism of your caged guests. Pit them in a similar set-up to that of a [[silk farm]] (you may want to set up a pit from above the farm so you can regularly replace the bait used for the silk farm, or just use a syndrome-immune creature, e.g. a [[zombie]]) and put your weapons (and ammo) stockpiles in the farm so your beast will shoot syndrome-inducing dust/spittle on them. '''Make sure your military dwarves wear gloves when they equip your newly poisoned weapons,''' unless you actually want them to vomit or rot themselves in the middle of the battlefield. You also want them to wear cloaks so they don't contaminate each other while sparring. Some poisons can be '''extremely deadly'''; dwarves equipped with poisoned weapons can one-shot most creatures - well, most creatures with functioning organs, at least - through the infliction of superficial wounds. If you can prevent your dwarves from infecting themselves, that is.

==[http://www.reddit.com/r/dwarffortress/comments/19083j/what_makes_forgotten_beasts_forgotten/c8jlvg7 On The Origins of Forgotten Beasts] ==

{{D for Dwarf}}

In the time before time, when Armok himself was not part of the great machine beast framework, the idea itself of ALL-dom, dwarf dom, elf dom, tools and valueless, remained in the greater unknowable realm of hard possibility called <HARDDISKSPACE>; all was concept data idiosyncratic.

Thence came the being of the <flesh machine> and the <machine beast framework> and thence Armok was, is, and ever will be.

Armok hands moved, and invoked the commands of the ur-<plane/realm?>, and raised the possibility of all worlds that can be, of the-blessed-who-can-know-Armok.

Thence Armok exhaled his vaporous breath and said "CREATE NEW WORLD" and the <machine beast framework> began his dire task.

Legions of empires, battalions of timelines, and civilizations of worlds were born, lost, and discarded, as the will of Arm0k angered in wait.

Finally World Acceptance was allowed.

Yet, the <Flesh Machine Beast Framework> has failed Armok. For Armok knows of the world behind the worlds, of the '''Intent''' of his dimension, of the destination of the unmoving stone.

He knows that the beats of <null result un-parseable>, those ideas from the time before the rules, exist not.

The Pen-Factor of Armok, the Toady one, foresaw this failure. He knew that the Armok transcended the very power of the universe vessel, the <Machine Beast Framework>, and to please our God, to let him revel in the glory that is the knowing of himself, he created forced the existence of the beasts...

==Art==
View a [[Forgotten beast/gallery|gallery]] of artwork from the [http://www.bay12forums.com/smf/index.php?topic=76346.msg1936555#msg1936555 forums].

{{random image|location=left|size=600px}}

{{Category|Megabeasts}}
{{Category|Trapavoid}}
{{Category|Building destroyer}}
{{Category|No Stun}}
{{Category|Flying}}
{{Category|Syndrome}}
{{Category|Webs}}
{{Category|Shell}}
[[ru:DF2012:Forgotten beast]]

Forgotten beast

2014-08-17T18:07:28Z

Talvieno: /* Forgotten Beast Threat Analysis */

{{Migrated_article}}
{{quality|unrated}}
{{av}}

{{minorspoiler}}

''In the deep, there are beasts so fell and terrible, that only they know what they are, for none who have met them have lived to tell of it... they are the Forgotten Beasts, born of the chaos from before the world's birth... they have waited, brooding in the dark places of the world... and now... by digging too deep... we have awakened them.''

'''Forgotten Beasts''' are large, monstrous, procedurally generated creatures that spawn in the [[caverns]] beneath your fortress, [[path]]ing through to your fort and seeding destruction amongst your dwarves. They are the subterranean equivalent of [[titan]]s.

Forgotten beasts are attracted by [[wealth]] and population size. Additionally, one may randomly appear when you reclaim a fortress. When a forgotten beast becomes visible onscreen, the game automatically pauses and displays a message.

== Generation ==
{{random image|location=right|size=300px}}

Forgotten beasts are procedurally randomized, and may be of any form, and be made of any sort of material. Multiple forgotten beasts may come to attack your fortress, each coming at different times. Most take the form of an animal, some not found in vanilla DF, with extra features (e.g. extra eyes, feathers) or removed body parts (e.g. skinless cobras) and unusual colours. However, a Forgotten Beast can also take more generic forms, such as shelled blobs, quadrupeds, and humanoid golems. Materials range from flesh and blood, to flimsy things like [[ash]] and [[steam]], to truly scary monsters of pure [[rock]], [[gem]], or [[metal]]. They may get a special attack, ranging from anything between venomous stings, poisoned blood, explosive dust clouds, to flame breath.

If a forgotten beast has a venomous attack of some sort, it is randomly generated as are the resulting [[symptoms]]. The beast's [[Syndrome#Breath_attacks|breath attack]] is also randomly generated, if it has one. Venom attacks come in a variety of forms, from boiling ichor to trailing dust, and the effects can range from mild pain to complete and instantaneous necrosis or paralysis. Some forms of venom can spread from spatters and contact with your dwarves, eventually infecting your entire fort. Decontaminating your soldiers in shallow running water is one way to deal with this problem. Some beasts breathe fire or shoot [[web]] in lieu of any syndrome-bearing attacks. Web-shooters are immune to the effects of webs they, or any other creature, create and will shoot web even at targets they lack a proper path to. Forgotten beasts based on spiders may be capable of shooting webs in addition to any other special abilities.

The number of forgotten beasts cannot be controlled directly, but is influenced by the size of the world. They dwell most often in caverns. All are [[building destroyer]]s, and are almost entirely immune to [[trap]]s (they are trapavoid and nostun but non-webspinners will trigger a trap that has been webbed). [[Bridge]]s are also less useful, as they cannot be raised or lowered as long as the beast is standing on (or under) them, preventing the traditional [[magma]] pit / [[dwarven atom smasher]] designs from working. This is probably one of [[Main:Toady One|Toady One]]'s ways of making the encounters even more [[fun]].

[[Image:DF2010ForgottenBeast1.png|thumb|center|500px]]

== Death and application ==
{{random image|location=right|size=300px}}
If you need to kill a Forgotten Beast, order your military to attack. Some beasts, however, are content not to path to your fortress and will stay dormant underground. Most "fleshy" forgotten beasts can be butchered; some are quite massive and may leave you with hundreds of meat and bone units and dozens of prepared organ units. Forgotten beast [[shell]]s may prove valuable during a [[strange mood]], particularly on a map without other sources of shells. Unfortunately, all forgotten beasts have a value multiplier of 1.

Some Forgotten Beasts whose bodies are made of liquid, gas, fire, or powder will die or lose limbs on the first hit. Other Forgotten Beasts are extremely difficult to kill due to being made of very hard materials or having an amorphous shape. When confronted with such near-invulnerable creatures the only option is usually to use your brain and try to lock it away somehow. Walls and raised [[bridge|draw bridges]] stop them. Since they are [[building destroyer]]s, you can used installed [[furniture]] to lure them to a particular location. If you can put it in a pit, a clever trapmaker can feed it invaders. If a near-indestructible beast isn't in a position to threaten your dwarves, it can be used to train marksdwarves.

One method of defeating nearly combat-invulnerable Forgotten Beasts (those whose bodies are made of rock, for instance) is to cause a [[Cave-in]] on top of them. They'll be killed by dropping either natural or constructed walls or floors on them. It is also possible to capture some forgotten beasts in cage traps by using [[giant cave spider]] webs (or similar).

You can prevent Forgotten Beasts from appearing by editing [[d_init.txt]] to change [INVADERS:YES] to [INVADERS:NO], though that will also prevent [[ambush]]es and [[siege]]s.

== Bugs ==
* If a beast has a dust attack, the dust will behave like it was from a [[cave-in]], flinging dwarves away (causing further damage if they hit a wall) and knocking them out. {{Bug|3133}}

== Forgotten Beast Threat Analysis==
'''If you do not want your [[fun]] spoiled, do not look below!'''

{{clear|both}}

Forgotten beast pose different levels of threat to your fortress, based on their composition, body shape, movements or special attacks.

Of course, general threat must be appraised after all categories

'''Material Composition'''
*''Water, Grime, Filth, Salt, Steam, Smoke, Snow'': Liquids, gasses, and powders are incredibly fragile. Unless paired with a dangerous attack method, these should not be a threat at all.
*''Fire'': While very fragile, [[fire]] is incredibly !![[fun]]!!. This type of forgotten beast will usually stay at the edge of the map and may burn large parts of the cavern when it first enters. Engagement should be avoided if it does not path to your fortress (and into a trap) as it could cause casualties with fire spread, contact, and fireballs (passive ability). Dropping an unarmed goblin or two (or a ceiling) on top of it should kill it as it will die as easily as any other gas beast. Upon death, beasts made of fire tend to explode in a large fireball which will kill all units within range, so keep your melee fighters away!
*''Flesh'': Most forgotten beasts are fleshy. It's about the standard level of threat for a forgotten beast.
*''Rock or Mineral'': Quite difficult, but not unbeatable. Can be damaged with metallic weapons. Beasts may be made of native copper or silver ore; see below for those.
*''Glass or Gem'': Dangerous. You may want to eschew melee combat, unless you've got sufficiently good weapons and dwarves.
*''Non-weapon grade metal'': Similar to rock forgotten beasts. Most weapons-grade metal can damage it.
*''Copper/Silver'': If you've got a good military and weapons as good as bronze, it should at least be beatable. Don't expect an easy fight by any means, however.
*''Bronze'': If you have encountered a bronze colossus before, this beast should be comparable in how dangerous it is. Whether it is more or less dangerous will depend on various features such as size, body type, whether it can fly, material emissions and whatever syndromes it may possess.
*''Iron'': It's quite possibly more dangerous than a bronze colossus, so be on your guard. Do not send anything against it that has less than steel weapons. Magma does nothing against these.
*''Steel'': It's official: the RNG hates you. These can be beaten only with cunning traps (magma won't do anything) or adamantine weapons.

'''Body Shape'''
*''Blob'': Possibly the easiest shape to fight - having only a single body part, all attacks will target it, causing it to accumulate damage rapidly and explode into gore.{{verify}} Has only a blunt push attack, which at a FB's size is deadly.
*''Quadruped, Humanoid'': about the average for FB's. Try and use cutting weapons to cripple them.
*''Insect, Spider'': Obnoxious because of the large amounts of redundant limbs. Spiders will be guaranteed to have a webbing attack and should thus be treated with extreme care.

'''Movement'''
*''Walking'': Normal movement.
*''Flying'': More dangerous than walking, for obvious mobility reasons. Be sure you only have one entry for your caverns.

'''Special attack'''
*''None'': Consider yourself lucky—most forgotten beasts have some kind of [[Syndrome]]-based effect. However, certain kinds of beasts have inherent abilities, like fire balls for a beast composed of fire, or webs for a spider-based beast.
*''Noxious Secretions'': Every single part of the creature's body is covered in extract. If it's in liquid or solid form and any of your dwarves touch this extract, they will receive the syndrome effects. Usually not a threat since dwarves are often well clothed, your military even more so. If the secretions are in gas form, treat the FB as if it has a toxic breath attack. Note that, unlike other attacks, gaseous noxious secretions are effective even if the beast is [[cage]]d.
*''Hunger for warm blood'': When the creature stabs the opponent, some blood will be drawn. Not dangerous.
*''Poisonous bite or sting'': Not dangerous by FB standards.
*''Spitting glob'': Generally not dangerous, unless you forgot shields and shield use on your military for some reason.
*''Fire breath'': By itself not threatening if you have shields and decent shield skill. However, [[Fun]] is always where fire is—a burst of flame is quite likely to start a cavern wildfire.
*''Toxic blood, vapor, or gas'': Threat depends of the syndrome's effects. Can be harmless or kill your entire military. You may want to sacrifice something for seeing what the FB's extract does.
*''Webs'': Webs are incredibly deadly in melee, but do not help much in range. It will slaughter your whole melee squad with incredible ease, but not your ranged squad as long as the ranged squad is out of reach. Engage it with marksdwarves or kill it with a cunning trap.
*''Deadly dust'': Possibly the most [[fun]] attack a FB can come with. Deadly dust acts like [[cave-in]] dust with syndromes. Dust coming from all directions (as opposed to a breath attack) is even more [[fun]]. If the material of the FB of is weak (like flesh), or if it has articulations or organs to be damaged, it will harm itself with its own deadly dust. However if it is made of stronger material, it will be immune to this effect. Deadly dust is generally a very effective defense against melee and marksdwarves, but is a liability if the FB is fleshy and not a blob.

==Applications==
Forgotten beasts are hard to catch, being both [[Creature token#T|[TRAPAVOID]]] and [[Creature token#N|[NOSTUN]]]; however trapping them is not impossible. All webbed creatures become vulnerable to [[trap]]s, except for the ones that have a [[web]]bing attack of their own: having a [[giant cave spider]] shoot web on your cage traps will render them into perfect FB-proof nets. Your new prizes can be put to various uses; the most obvious ones consist in dropping them onto various invaders - forgotten beasts are hostile toward each other and will attack any [[Surroundings|wildlife]] or [[Civilization|civilized]] creature they may encounter - but with careful micromanagement, the opportunities are limitless.

===Silk farm===
Web-shooting forgotten beasts are notoriously hard to catch and you'll only get your hands on one of these through ''very'' careful micromanagement, such as building a 'trap room' with retractable bridges and some random animal at the center to attract the beast. The set-up is otherwise the same as that of a [[silk farm]], except that forgotten beast silk is only as valuable as mere [[cave spider]] silk. Note that some beasts have special attacks ''in addition'' to their web-shooting ability (in the case of beasts based on spider-like anatomy resembling that of the [[giant cave spider]]), which may make them more difficult to capture and use (as they may kill their targets rather than simply covering them with webs).

===Weapon coating===

[http://www.bay12forums.com/smf/index.php?topic=91084 Syndrome-bearing poison can and will affect any creature it can spread to and infect.] While there is no formal job or workshop related to poison coating in vanilla DF (although it does exist in some [http://dwarffortresswiki.org/index.php/Masterwork:Main_Page mods]), poisoning your weapons is still possible thanks to the impossibly infinite metabolism of your caged guests. Pit them in a similar set-up to that of a [[silk farm]] (you may want to set up a pit from above the farm so you can regularly replace the bait used for the silk farm, or just use a syndrome-immune creature, e.g. a [[zombie]]) and put your weapons (and ammo) stockpiles in the farm so your beast will shoot syndrome-inducing dust/spittle on them. '''Make sure your military dwarves wear gloves when they equip your newly poisoned weapons,''' unless you actually want them to vomit or rot themselves in the middle of the battlefield. You also want them to wear cloaks so they don't contaminate each other while sparring. Some poisons can be '''extremely deadly'''; dwarves equipped with poisoned weapons can one-shot most creatures - well, most creatures with functioning organs, at least - through the infliction of superficial wounds. If you can prevent your dwarves from infecting themselves, that is.

==[http://www.reddit.com/r/dwarffortress/comments/19083j/what_makes_forgotten_beasts_forgotten/c8jlvg7 On The Origins of Forgotten Beasts] ==

{{D for Dwarf}}

In the time before time, when Armok himself was not part of the great machine beast framework, the idea itself of ALL-dom, dwarf dom, elf dom, tools and valueless, remained in the greater unknowable realm of hard possibility called <HARDDISKSPACE>; all was concept data idiosyncratic.

Thence came the being of the <flesh machine> and the <machine beast framework> and thence Armok was, is, and ever will be.

Armok hands moved, and invoked the commands of the ur-<plane/realm?>, and raised the possibility of all worlds that can be, of the-blessed-who-can-know-Armok.

Thence Armok exhaled his vaporous breath and said "CREATE NEW WORLD" and the <machine beast framework> began his dire task.

Legions of empires, battalions of timelines, and civilizations of worlds were born, lost, and discarded, as the will of Arm0k angered in wait.

Finally World Acceptance was allowed.

Yet, the <Flesh Machine Beast Framework> has failed Armok. For Armok knows of the world behind the worlds, of the '''Intent''' of his dimension, of the destination of the unmoving stone.

He knows that the beats of <null result un-parseable>, those ideas from the time before the rules, exist not.

The Pen-Factor of Armok, the Toady one, foresaw this failure. He knew that the Armok transcended the very power of the universe vessel, the <Machine Beast Framework>, and to please our God, to let him revel in the glory that is the knowing of himself, he created forced the existence of the beasts...

==Art==
View a [[Forgotten beast/gallery|gallery]] of artwork from the [http://www.bay12forums.com/smf/index.php?topic=76346.msg1936555#msg1936555 forums].

{{random image|location=left|size=600px}}

{{Category|Megabeasts}}
{{Category|Trapavoid}}
{{Category|Building destroyer}}
{{Category|No Stun}}
{{Category|Flying}}
{{Category|Syndrome}}
{{Category|Webs}}
{{Category|Shell}}
[[ru:DF2012:Forgotten beast]]

Copper

2014-08-17T17:54:09Z

Talvieno: /* Alloys */

{{Quality|Exceptional|17:50, 17 August 2014 (UTC)}}

{{Metal|name=Copper|color=6:4:0
|uses=
* Make [[Brass]] at [[smelter]]
* Make [[Bronze]] at [[smelter]]
* Make [[Billon]] at [[smelter]]
* Make [[Fine pewter]] at [[smelter]]
* Make [[Trifle pewter]] at [[smelter]]
* Make [[Lay pewter]] at [[smelter]]
* Make [[Nickel silver]] at [[smelter]]
* Make [[Black bronze]] at [[smelter]]
* Make [[Sterling silver]] at [[smelter]]
* Make [[Rose gold]] at [[smelter]]
* Make [[Bismuth bronze]] at [[smelter]]
* [[weapon|Melee Weapons]]
* [[Crossbow]]s
* [[Bolt]]s
* [[Pick]]s
* [[Armor]]
* [[Metalsmith's forge|Metal crafting]]
|ore=
* [[Native copper]]
* [[Malachite]]
* [[Tetrahedrite]]
|properties=
* [[Material value]] 2
* [[Melting point]] 11952
* [[Boiling point]] 14611
* [[Ignition point]] none
* [[Solid density]] 8930
* Liquid [[density]] 8020
* [[Specific heat]] 385
}}{{av}}

'''Copper''' is a [[metal]] used in a large number of alloys, among them [[bronze]], which is almost as good as [[iron]] for smithing [[weapon]]s and [[armor]], and [[brass]], which has the largest value increase of all non-[[steel]] alloys. Copper itself is a common, low-value metal and a sub-par arms material- more specifically, it is the second worst metal available for slashing weapons, but is pretty good for blunt weapons.

Copper is fire-safe but ''not'' magma-safe.

== Major uses ==

*Early-game melee weapon and armor production, if you have no [[tin]] to make [[bronze]] or no [[iron]]. You will probably do best to find better metals though.
*Making [[bronze]], which is better overall than copper for military applications.
*Training metalworking dwarves : copper is generally plentiful. This is possibly the best use for copper if you have better metals.
*Copper crossbows and copper bolts. Copper crossbows are the best crossbows if your marksdwarves are forced into melee : silver crossbows are only brought by humans and have no quality modifiers. Copper bolts are heavy enough and sharp enough to work as a good projectile, and iron/steel is generally too rare to be used in bolts. Both uses also train your weaponsmiths, which is always a good thing.
*Bins, cages, and barrels: although wooden ones are generally cheaper and lighter, copper containers are fire-safe and resistant to [[vermin]]. On maps where wood is scarce, copper can serve as a suitable substitute.
*Copper giant spiked balls for weapon traps.

== Alloys ==

Copper is smelted (at a [[smelter]]) from [[native copper]], [[malachite]], or [[tetrahedrite]].

Copper may be combined with other metals at a [[smelter]]. The following is a list of recipes involving copper:
*[[Brass]] = Copper + [[Zinc]]
*[[Bronze]] = Copper + [[Tin]]
*[[Billon]] = Copper + [[Silver]]
*[[Fine pewter]] = Copper + 3x [[Tin]]
*[[Trifle pewter]] = Copper + 2x [[Tin]]
*[[Lay pewter]] = Copper + 2x [[Tin]] + [[Lead]]
*[[Nickel silver]] = Copper + 2x [[Nickel]] + [[Zinc]]
*[[Black bronze]] = 2x Copper + [[Silver]] + [[Gold]]
*[[Sterling silver]] = Copper + 3x [[Silver]]
*[[Rose gold]] = Copper + 3x [[Gold]]
*[[Bismuth bronze]] = 2x Copper + [[Tin]] + [[Bismuth]]

<gallery>
File:Copper_2.jpg|A copper ingot, coin and rod.
</gallery>

{{gamedata}}
{{metals}}

Copper

2014-08-17T17:53:40Z

Talvieno: fixed redlink, did a number of minor edits, removed migrated article tag

{{Quality|Exceptional|17:50, 17 August 2014 (UTC)}}

{{Metal|name=Copper|color=6:4:0
|uses=
* Make [[Brass]] at [[smelter]]
* Make [[Bronze]] at [[smelter]]
* Make [[Billon]] at [[smelter]]
* Make [[Fine pewter]] at [[smelter]]
* Make [[Trifle pewter]] at [[smelter]]
* Make [[Lay pewter]] at [[smelter]]
* Make [[Nickel silver]] at [[smelter]]
* Make [[Black bronze]] at [[smelter]]
* Make [[Sterling silver]] at [[smelter]]
* Make [[Rose gold]] at [[smelter]]
* Make [[Bismuth bronze]] at [[smelter]]
* [[weapon|Melee Weapons]]
* [[Crossbow]]s
* [[Bolt]]s
* [[Pick]]s
* [[Armor]]
* [[Metalsmith's forge|Metal crafting]]
|ore=
* [[Native copper]]
* [[Malachite]]
* [[Tetrahedrite]]
|properties=
* [[Material value]] 2
* [[Melting point]] 11952
* [[Boiling point]] 14611
* [[Ignition point]] none
* [[Solid density]] 8930
* Liquid [[density]] 8020
* [[Specific heat]] 385
}}{{av}}

'''Copper''' is a [[metal]] used in a large number of alloys, among them [[bronze]], which is almost as good as [[iron]] for smithing [[weapon]]s and [[armor]], and [[brass]], which has the largest value increase of all non-[[steel]] alloys. Copper itself is a common, low-value metal and a sub-par arms material- more specifically, it is the second worst metal available for slashing weapons, but is pretty good for blunt weapons.

Copper is fire-safe but ''not'' magma-safe.

== Major uses ==

*Early-game melee weapon and armor production, if you have no [[tin]] to make [[bronze]] or no [[iron]]. You will probably do best to find better metals though.
*Making [[bronze]], which is better overall than copper for military applications.
*Training metalworking dwarves : copper is generally plentiful. This is possibly the best use for copper if you have better metals.
*Copper crossbows and copper bolts. Copper crossbows are the best crossbows if your marksdwarves are forced into melee : silver crossbows are only brought by humans and have no quality modifiers. Copper bolts are heavy enough and sharp enough to work as a good projectile, and iron/steel is generally too rare to be used in bolts. Both uses also train your weaponsmiths, which is always a good thing.
*Bins, cages, and barrels: although wooden ones are generally cheaper and lighter, copper containers are fire-safe and resistant to [[vermin]]. On maps where wood is scarce, copper can serve as a suitable substitute.
*Copper giant spiked balls for weapon traps.

== Alloys ==

Copper is smelted (at a [[smelter]]) from [[native copper]], [[Malachite]], or [[tetrahedrite]].

Copper may be combined with other metals at a [[smelter]]. The following is a list of recipes involving copper:
*[[Brass]] = Copper + [[Zinc]]
*[[Bronze]] = Copper + [[Tin]]
*[[Billon]] = Copper + [[Silver]]
*[[Fine pewter]] = Copper + 3x [[Tin]]
*[[Trifle pewter]] = Copper + 2x [[Tin]]
*[[Lay pewter]] = Copper + 2x [[Tin]] + [[Lead]]
*[[Nickel silver]] = Copper + 2x [[Nickel]] + [[Zinc]]
*[[Black bronze]] = 2x Copper + [[Silver]] + [[Gold]]
*[[Sterling silver]] = Copper + 3x [[Silver]]
*[[Rose gold]] = Copper + 3x [[Gold]]
*[[Bismuth bronze]] = 2x Copper + [[Tin]] + [[Bismuth]]

<gallery>
File:Copper_2.jpg|A copper ingot, coin and rod.
</gallery>

{{gamedata}}
{{metals}}

Copper

2014-08-17T17:50:42Z

Talvieno: Changed quality rating from "Masterwork" to "Exceptional" using the rating script

{{Quality|Exceptional|17:50, 17 August 2014 (UTC)}}
{{Migrated_article}}

{{Metal|name=Copper|color=6:4:0
|uses=
* Make [[Brass]] at [[smelter]]
* Make [[Bronze]] at [[smelter]]
* Make [[Billon]] at [[smelter]]
* Make [[Fine pewter]] at [[smelter]]
* Make [[Trifle pewter]] at [[smelter]]
* Make [[Lay pewter]] at [[smelter]]
* Make [[Nickel silver]] at [[smelter]]
* Make [[Black bronze]] at [[smelter]]
* Make [[Sterling silver]] at [[smelter]]
* Make [[Rose gold]] at [[smelter]]
* Make [[Bismuth bronze]] at [[smelter]]
* [[weapon|Melee Weapons]]
* [[Crossbow]]s
* [[Bolt]]s
* [[Pick]]s
* [[Armor]]
* [[Metalsmith's forge|Metal crafting]]
|ore=
* [[Native copper]]
* [[Malachite]]
* [[Tetrahedrite]]
|properties=
* [[Material value]] 2
* [[Melting point]] 11952
* [[Boiling point]] 14611
* [[Ignition point]] none
* [[Solid density]] 8930
* Liquid [[density]] 8020
* [[Specific heat]] 385
}}{{av}}

'''Copper''' is a [[metal]] used in a large number of [[alloy]]s, among them [[Bronze]], which is almost as good as [[iron]] for smithing [[weapon]]s and [[armor]], and [[Brass]], which has the largest value increase of all non-[[steel]] alloys. Copper itself is a common, low-value metal and a sub-par arms material- more specifically, it is the second worst metal available for slashing weapons, but is pretty good for blunt weapons.

Copper is fire-safe but ''not'' magma-safe.

== Major uses ==

*Early-game melee weapon and armor production, if you have no [[tin]] to make [[bronze]] or no [[iron]]. You will probably do best to find better metals though.
*Making [[bronze]], which is better overall than copper for military applications.
*Training metalworking dwarves : copper is generally plentiful. This is possibly the best use for copper if you have better metals.
*Copper crossbows and copper bolts. Copper crossbows are the best crossbows if your marksdwarves are forced into melee : silver crossbows are only brought by humans and have no quality modifiers. Copper bolts are heavy enough and sharp enough to work as a good projectile, and iron/steel is generally too rare to be used in bolts. Both uses also train your weaponsmiths, which is always a good thing.
*Bins, cages, and barrels: although wooden ones are generally cheaper and lighter, copper containers are fire-safe and resistant to [[vermin]]. On maps where wood is scarce, copper can serve as a suitable substitute.
*Copper giant spiked balls for weapon traps.

== Alloys ==

Copper is smelted (at a [[Smelter]]) from [[Native copper]], [[Malachite]], or [[Tetrahedrite]].

Copper may be combined with other metals at a [[smelter]]. The following is a list of recipes involving copper:
*[[Brass]] = Copper + [[Zinc]]
*[[Bronze]] = Copper + [[Tin]]
*[[Billon]] = Copper + [[Silver]]
*[[Fine pewter]] = Copper + 3x [[Tin]]
*[[Trifle pewter]] = Copper + 2x [[Tin]]
*[[Lay pewter]] = Copper + 2x [[Tin]] + [[Lead]]
*[[Nickel silver]] = Copper + 2x [[Nickel]] + [[Zinc]]
*[[Black bronze]] = 2x Copper + [[Silver]] + [[Gold]]
*[[Sterling silver]] = Copper + 3x [[Silver]]
*[[Rose gold]] = Copper + 3x [[Gold]]
*[[Bismuth bronze]] = 2x Copper + [[Tin]] + [[Bismuth]]

<gallery>
File:Copper_2.jpg|A copper ingot, coin and rod.
</gallery>

{{gamedata}}
{{metals}}

Tower-cap

2014-08-17T17:21:52Z

Talvieno: Added a bug.

{{Quality|Exceptional|17:17, 17 August 2014 (UTC)}}
{{Migrated_article}}

{{Treelookup/0|wiki=no}}
{{av}}

'''Tower-caps''' are a type of mushroom-like [[underground|subterranean]] [[tree]]. Once fully grown, they can be designated for [[wood cutting]] and produce tower-cap [[Wood|logs]]. Tower-caps will grow on thick subterranean [[soil]] or [[mud|muddied]] [[rock]]. They may be found already growing on muddied rock in an [[Caverns|underground cavern]]. Tower-caps are white and produce white logs, and the resulting products are white or light grey - as a result, they are sometimes used in combination with other white [[stone]]s to create entirely white areas.

Tower-caps will not start growing in muddied soil until you have discovered the 1st underground cavern.

==Bugs==
* Mushroom trees only drop a single log.{{bug|7313}}

== Energy source? ==
{{d for dwarf}}
There is much controversy about the energy source that tower-caps use to grow. Although it is clear that, like any fungus, they gain energy by breaking down organic compounds in soil and mud, it's equally clear that they are able to do this underground, without access to sunlight. Without any obvious way to regenerate the organic matter that they sprout in, it's unclear how they can survive for thousands of years without sunlight. Thus, useless immigrant dwarven botanists have wasted entirely too much spare time trying to find their energy source.

The leading theory is that underground soil may contain perpetual motion machines, composed of molecular-scale screw pumps and water wheels. As every dwarven engineer knows, a perpetual motion machine must be given water to start up, after which, it will run indefinitely without any extra water required. Molecular-scale screw pumps and water wheels would, similarly, not provide energy until they become muddied, and, similarly, would remain functional indefinitely. The concept of things smaller than monarch butterflies, however, has led to enormous controversy. Although, obviously, it would be hard to see something smaller than a butterfly, it should be possible to show that it exists because, just like butterflies, it would sometimes get stuck in doors and prevent them from closing. So far, there is no evidence that doors have been held stuck by imperceptibly tiny objects, so the theory remains unsubstantiated.

{{gamedata}}
{{Plants}}
{{Category|Subterranean trees}}

Tower-cap

2014-08-17T17:17:28Z

Talvieno: Changed quality rating from "Unrated" to "Exceptional" using the rating script

{{Quality|Exceptional|17:17, 17 August 2014 (UTC)}}
{{Migrated_article}}

{{Treelookup/0|wiki=no}}
{{av}}

'''Tower-caps''' are a type of mushroom-like [[underground|subterranean]] [[tree]]. Once fully grown, they can be designated for [[wood cutting]] and produce tower-cap [[Wood|logs]]. Tower-caps will grow on thick subterranean [[soil]] or [[mud|muddied]] [[rock]]. They may be found already growing on muddied rock in an [[Caverns|underground cavern]]. Tower-caps are white and produce white logs, and the resulting products are white or light grey - as a result, they are sometimes used in combination with other white [[stone]]s to create entirely white areas.

Tower-caps will not start growing in muddied soil until you have discovered the 1st underground cavern.

== Energy source? ==
{{d for dwarf}}
There is much controversy about the energy source that tower-caps use to grow. Although it is clear that, like any fungus, they gain energy by breaking down organic compounds in soil and mud, it's equally clear that they are able to do this underground, without access to sunlight. Without any obvious way to regenerate the organic matter that they sprout in, it's unclear how they can survive for thousands of years without sunlight. Thus, useless immigrant dwarven botanists have wasted entirely too much spare time trying to find their energy source.

The leading theory is that underground soil may contain perpetual motion machines, composed of molecular-scale screw pumps and water wheels. As every dwarven engineer knows, a perpetual motion machine must be given water to start up, after which, it will run indefinitely without any extra water required. Molecular-scale screw pumps and water wheels would, similarly, not provide energy until they become muddied, and, similarly, would remain functional indefinitely. The concept of things smaller than monarch butterflies, however, has led to enormous controversy. Although, obviously, it would be hard to see something smaller than a butterfly, it should be possible to show that it exists because, just like butterflies, it would sometimes get stuck in doors and prevent them from closing. So far, there is no evidence that doors have been held stuck by imperceptibly tiny objects, so the theory remains unsubstantiated.

{{gamedata}}
{{Plants}}
{{Category|Subterranean trees}}

Siege

2014-08-17T15:58:11Z

Talvieno: Changed quality rating from "Tattered" to "Fine" using the rating script

{{Quality|Fine|15:58, 17 August 2014 (UTC)}}
{{Migrated_article}}
{{av}}

:''For catapults and ballistae, see [[Siege engine]].''

'''Sieges''' are large scale assaults on your fortress by other [[civilization]]s. Sieges are drawn from moving units advancing towards the fortress, whether from an army, a bandit group, or a necromancer's [[tower]]. They are announced with a full-screen message that differs depending on the attacking race, and the main screen showing the "*SIEGE*" tag along the top for the duration.

Caravans will not arrive at a besieged fortress. They will arrive, though, if a siege is broken quickly enough, but it is possible to miss out entirely on a civilization's caravan for the year this way. Even if they do arrive before the siege, the attackers may kill them or chase them off if they can reach them. Consider this when deciding how you set up your [[trade depot]] and how heavily reliant your economy is on imported goods.

A civilization will be unable to lay siege if it can't reach your fortress site. Armies need to physically move to the location of your fortress; they are normally allowed a 30-tile radius of interaction (towers have 10 tiles), beyond which sieges are impossible. You will never get sieges if you embark on an island or in a valley which is completely surrounded by mountains. If you want to make sure that a certain civilization will be capable of laying siege to you, then look at the "neighbors" view of the [[Embark]] site finder when selecting your fortress site.

== Structure of a siege ==

*Siege forces usually consist of several 'squads'. Using the [[goblin]]s as an example, each squad consists of several goblins of one military class (swordsman, lasher, etc.), and often one 'squad leader' (typically an Elite or better, which need not be the same class as the squad it leads).
*Occasionally, a squad will be mounted - this means each of its members will be riding a suitable [[creature]], though the creatures typically vary between members. The squad leader can be mounted, even if his squad is not. These mounts can change the combat dynamics, since some can fly, are [[building destroyer]]s, or have substantially different combat traits than their rider. For more info on mounted units, and the [[Fun]] they can unleash upon an ill-prepared defender, see: [[Mount]]
*Invaders can climb [[wall]]s and pits. This can be quite [[Fun]], if your fort defence relies on the same kind of walls and pits as previous versions.
*After being sufficiently "successful" at defending against the siege (killing sufficient attackers, waiting them out, or some combination thereof), the attackers will retreat. All of the remaining squads and groups will head for the map edges and leave, typically favoring the edge they entered from. Once all of the remaining attackers have decided to retreat, the "SIEGE" tag will go away.
*It is possible to have multiple sieges at the same time. If the attacking civilizations are at war with each other, they will start to fight with each other as well.
*Different races will favor different styles of attack during sieges. The following attack styles were observed in .40d; it remains to be seen if these traits are still present in current releases.
*You can turn off sieges and [[Forgotten beast]]s altogether by editing the [[d_init.txt]] file to change [INVADERS:YES] to [INVADERS:NO].

== [[Goblin]] sieges ==

Goblin sieges are announced with the message, "''A vile force of darkness has arrived!''"

Goblins will start laying siege to your fortress when you reach a certain [[population]], usually around 80. Usually the tactics used by the goblins are no more sophisticated than charging in an open march toward your fortress and attempting to kill your [[dwarves]]. Goblins sieges often include groups of [[troll]]s, [[ogre]]s, or [[cave dragon]]s that can [[Building destroyer|break buildings]] and smash workshops. Unlike the squads, however, these 'groups' usually enter the map in a single tile, somewhat akin to arriving [[migrants]]. These war creatures usually possess random civilian classes, and show little of the organized behavior of the squads. Goblins may also bring elite human or even dwarven fighters as leaders of their squads, previously kidnapped by [[snatcher]]s. Goblin sieges usually involve [[mount]]ed squads, some of which can fly over whatever defenses you might have set up to stop them.

== [[Elf|Elven]] sieges ==

Elven sieges are announced with the message, "''The elves have brought the full forces of their lands against you.''"

It is possible to have elven attacks as well, but that usually requires some effort on part of the player, or for your starting civilization to have a pre-existing conflict with a nearby elven one. You can check this when you embark while looking at nearby civilizations, where it will read WAR next to the elf civilization, though it seems to be entirely dependent on how world gen plays out and embarking at a time when a war is happening. Another, possibly simpler (and more amusing) way to elven siege is to blatantly provoke them. If you don't want to be attacked by elves you should not offer them wooden goods or goods stored in wooden barrels or bins. You might also avoid clearing too much woodland, as elves will be offended if you do so.

Elves use stealth squads, a la goblin ambushes, to hide their numbers and locations. It should be noted, however, that unlike goblin ambushes which cap at four squads, elves can come in '''massive''' numbers, atop mighty (and tasty) [[unicorn]]s or other [[elephant|exotic beasts]]. Fortunately, unlike goblins and humans, who wear heavy armor and wield metal weapons that can cause considerable damage, the elves are very weak in battle. Their weapons and arrows are made are made of wood, which will simply bounce off any standard metal armour, and they march into battle wearing easily breakable wooden armor or even nothing but cloth robes and trousers.

== [[Human]] sieges ==

Human sieges are announced with the message "''The enemy have come and are laying siege to the fortress.''".

Humans may also siege you should you let their [[diplomat]] die while visiting your fortress, if too many of their trade wagons get destroyed or if you trade with an elven nation the humans are at war with. Humans would sometimes set up a camp near the map edge they arrived on, harassing wandering dwarves and waiting for you to come to them instead of blindly charging toward your fortress. Humans often ride rather mundane animals, such as horses, camels (of both varieties), or war grizzly bears, and may bring along further war animals like trained cheetahs. Be aware that human siegers know of all traps that their diplomats have seen before, even their war animals are immune to those traps. If you had a human diplomat in your fort, best assume that your traps are useless against the invaders unless they were built after his last visit. A removed and rebuilt trap counts as "new", even if it's the same type of trap in the same tile.

== [[Necromancer]] sieges ==

Necromancer sieges are announced with ''"The [[undead|dead]] walk. Hide while you still can!"''

Necromancers will only be able to siege you if you embark in an area near a tower. If no tower is present in the neighbors list, no necromancers will ever besiege your fortress.

Necromancers will besiege your fortress by sending [[undead]] to your fort or even coming themselves. Either way, undead sieges are a guaranteed source of [[Fun]]. The undead units will arrive from all sides of the map, slowly meandering towards your fortress. Undead sieges may arrive with as few as one zombie to as many as fifty or more. The undead in general are serious enemies that one cannot treat like goblin garbage. A legendary squad can take down unarmed zombies in equal numbers, but the large numbers that necromancers can bring are unmatchable. To make things worse, "elite" zombie fighters may carry ''weapons and armour'', a truly terrifying thought were there ever one.

It is recommended that you have <s>many traps</s> every single trap with the best materials possible you could possibly build set in advance, and when the undead legions arrive, '''shut down everything'''. Be sure to shut down all of your butcher's shops, crypts, and refuse stockpiles, as necromancers can reanimate armies of body parts to destroy your fortress from the inside. Be also careful with fishery workshops, as reports of mussel shells rising from the dead are fairly common. Necromancers will raise any corpse or corpse part that they see, and simple proximity to undead can cause things like skin and hair to rise and attack the unfortunate butcher. It doesn't really matter how many zombies arrive; if you are not prepared, you will probably get slaughtered, as one zombie can easily become two zombies, then four, then eight and so on. If the zombies cannot attack your dwarves immediately, they will simply mill about on the surface until something living (wild animals included) comes too close or until they are all destroyed. Like other sieges, it is also possible to wait out necromancer sieges, though this can take a year or more.

Necromancers can besiege your fortress at any time, including before the second spring's elven caravan arrives, or even before the first dwarven caravan arrives in the fall of your first year (thus preventing its arrival). The number of undead sent will depend on your wealth and population, and early sieges tend to have as few as 3 undead; but can cause very much cheesy fun if a lone necromancer accompanies them (which isn't uncommon).

== [[Bandit]] sieges ==

Roving bandit groups nearby your fortress may also besiege your fortress. This can happen as early as ''the first year'', making them an excellent source of surprise [[Fun]].

Bandit groups are drawn from any entity with the {{token|BANDITRY|e}} and {{token|LOCAL_BANDITRY|e}} tokens. In unmodded games, these are [[goblin]]s, [[human]]s and [[kobold]]s, though other races (even [[dwarves]]) have been reported. Their announcement messages are the same as the messages for regular sieges of their race. Bandit sieges are generally smaller than a later-game full-blown siege, more similar to goblin [[ambush]]es in size, as there are fewer units from which to draw combatants.

== [[Dwarf]] sieges ==
{{mod}}
Dwarf sieges will only arrive when you [[mod]] the game, because the game has been programmed to never cause sieges from the player's civilization. Unless you are playing with another civilization(for example, humans), Dwarf sieges will cause a massive [[loyalty cascade]] even if you don't attack the invaders.

Dwarf sieges are announced with the same message as human sieges("''The enemy have come and are laying siege to the fortress.''"). The also behave very similar to human sieges, possibly indicating that dwarves and humans have the same AI when invading a site. They even bring mounts, whereas dwarven cavalry is not implemented for the player.

== Bugs ==
* Enemy squads will never abandon their caged or dead leader. {{Bug|1598}}
* Amphibian invader mounts drown their riders. {{Bug|926}}

{{Military}}

Siege

2014-08-17T15:57:52Z

Talvieno: Changed quality rating from "Fine" to "Tattered" using the rating script

{{Quality|Tattered|15:57, 17 August 2014 (UTC)}}
{{Migrated_article}}
{{av}}

:''For catapults and ballistae, see [[Siege engine]].''

'''Sieges''' are large scale assaults on your fortress by other [[civilization]]s. Sieges are drawn from moving units advancing towards the fortress, whether from an army, a bandit group, or a necromancer's [[tower]]. They are announced with a full-screen message that differs depending on the attacking race, and the main screen showing the "*SIEGE*" tag along the top for the duration.

Caravans will not arrive at a besieged fortress. They will arrive, though, if a siege is broken quickly enough, but it is possible to miss out entirely on a civilization's caravan for the year this way. Even if they do arrive before the siege, the attackers may kill them or chase them off if they can reach them. Consider this when deciding how you set up your [[trade depot]] and how heavily reliant your economy is on imported goods.

A civilization will be unable to lay siege if it can't reach your fortress site. Armies need to physically move to the location of your fortress; they are normally allowed a 30-tile radius of interaction (towers have 10 tiles), beyond which sieges are impossible. You will never get sieges if you embark on an island or in a valley which is completely surrounded by mountains. If you want to make sure that a certain civilization will be capable of laying siege to you, then look at the "neighbors" view of the [[Embark]] site finder when selecting your fortress site.

== Structure of a siege ==

*Siege forces usually consist of several 'squads'. Using the [[goblin]]s as an example, each squad consists of several goblins of one military class (swordsman, lasher, etc.), and often one 'squad leader' (typically an Elite or better, which need not be the same class as the squad it leads).
*Occasionally, a squad will be mounted - this means each of its members will be riding a suitable [[creature]], though the creatures typically vary between members. The squad leader can be mounted, even if his squad is not. These mounts can change the combat dynamics, since some can fly, are [[building destroyer]]s, or have substantially different combat traits than their rider. For more info on mounted units, and the [[Fun]] they can unleash upon an ill-prepared defender, see: [[Mount]]
*Invaders can climb [[wall]]s and pits. This can be quite [[Fun]], if your fort defence relies on the same kind of walls and pits as previous versions.
*After being sufficiently "successful" at defending against the siege (killing sufficient attackers, waiting them out, or some combination thereof), the attackers will retreat. All of the remaining squads and groups will head for the map edges and leave, typically favoring the edge they entered from. Once all of the remaining attackers have decided to retreat, the "SIEGE" tag will go away.
*It is possible to have multiple sieges at the same time. If the attacking civilizations are at war with each other, they will start to fight with each other as well.
*Different races will favor different styles of attack during sieges. The following attack styles were observed in .40d; it remains to be seen if these traits are still present in current releases.
*You can turn off sieges and [[Forgotten beast]]s altogether by editing the [[d_init.txt]] file to change [INVADERS:YES] to [INVADERS:NO].

== [[Goblin]] sieges ==

Goblin sieges are announced with the message, "''A vile force of darkness has arrived!''"

Goblins will start laying siege to your fortress when you reach a certain [[population]], usually around 80. Usually the tactics used by the goblins are no more sophisticated than charging in an open march toward your fortress and attempting to kill your [[dwarves]]. Goblins sieges often include groups of [[troll]]s, [[ogre]]s, or [[cave dragon]]s that can [[Building destroyer|break buildings]] and smash workshops. Unlike the squads, however, these 'groups' usually enter the map in a single tile, somewhat akin to arriving [[migrants]]. These war creatures usually possess random civilian classes, and show little of the organized behavior of the squads. Goblins may also bring elite human or even dwarven fighters as leaders of their squads, previously kidnapped by [[snatcher]]s. Goblin sieges usually involve [[mount]]ed squads, some of which can fly over whatever defenses you might have set up to stop them.

== [[Elf|Elven]] sieges ==

Elven sieges are announced with the message, "''The elves have brought the full forces of their lands against you.''"

It is possible to have elven attacks as well, but that usually requires some effort on part of the player, or for your starting civilization to have a pre-existing conflict with a nearby elven one. You can check this when you embark while looking at nearby civilizations, where it will read WAR next to the elf civilization, though it seems to be entirely dependent on how world gen plays out and embarking at a time when a war is happening. Another, possibly simpler (and more amusing) way to elven siege is to blatantly provoke them. If you don't want to be attacked by elves you should not offer them wooden goods or goods stored in wooden barrels or bins. You might also avoid clearing too much woodland, as elves will be offended if you do so.

Elves use stealth squads, a la goblin ambushes, to hide their numbers and locations. It should be noted, however, that unlike goblin ambushes which cap at four squads, elves can come in '''massive''' numbers, atop mighty (and tasty) [[unicorn]]s or other [[elephant|exotic beasts]]. Fortunately, unlike goblins and humans, who wear heavy armor and wield metal weapons that can cause considerable damage, the elves are very weak in battle. Their weapons and arrows are made are made of wood, which will simply bounce off any standard metal armour, and they march into battle wearing easily breakable wooden armor or even nothing but cloth robes and trousers.

== [[Human]] sieges ==

Human sieges are announced with the message "''The enemy have come and are laying siege to the fortress.''".

Humans may also siege you should you let their [[diplomat]] die while visiting your fortress, if too many of their trade wagons get destroyed or if you trade with an elven nation the humans are at war with. Humans would sometimes set up a camp near the map edge they arrived on, harassing wandering dwarves and waiting for you to come to them instead of blindly charging toward your fortress. Humans often ride rather mundane animals, such as horses, camels (of both varieties), or war grizzly bears, and may bring along further war animals like trained cheetahs. Be aware that human siegers know of all traps that their diplomats have seen before, even their war animals are immune to those traps. If you had a human diplomat in your fort, best assume that your traps are useless against the invaders unless they were built after his last visit. A removed and rebuilt trap counts as "new", even if it's the same type of trap in the same tile.

== [[Necromancer]] sieges ==

Necromancer sieges are announced with ''"The [[undead|dead]] walk. Hide while you still can!"''

Necromancers will only be able to siege you if you embark in an area near a tower. If no tower is present in the neighbors list, no necromancers will ever besiege your fortress.

Necromancers will besiege your fortress by sending [[undead]] to your fort or even coming themselves. Either way, undead sieges are a guaranteed source of [[Fun]]. The undead units will arrive from all sides of the map, slowly meandering towards your fortress. Undead sieges may arrive with as few as one zombie to as many as fifty or more. The undead in general are serious enemies that one cannot treat like goblin garbage. A legendary squad can take down unarmed zombies in equal numbers, but the large numbers that necromancers can bring are unmatchable. To make things worse, "elite" zombie fighters may carry ''weapons and armour'', a truly terrifying thought were there ever one.

It is recommended that you have <s>many traps</s> every single trap with the best materials possible you could possibly build set in advance, and when the undead legions arrive, '''shut down everything'''. Be sure to shut down all of your butcher's shops, crypts, and refuse stockpiles, as necromancers can reanimate armies of body parts to destroy your fortress from the inside. Be also careful with fishery workshops, as reports of mussel shells rising from the dead are fairly common. Necromancers will raise any corpse or corpse part that they see, and simple proximity to undead can cause things like skin and hair to rise and attack the unfortunate butcher. It doesn't really matter how many zombies arrive; if you are not prepared, you will probably get slaughtered, as one zombie can easily become two zombies, then four, then eight and so on. If the zombies cannot attack your dwarves immediately, they will simply mill about on the surface until something living (wild animals included) comes too close or until they are all destroyed. Like other sieges, it is also possible to wait out necromancer sieges, though this can take a year or more.

Necromancers can besiege your fortress at any time, including before the second spring's elven caravan arrives, or even before the first dwarven caravan arrives in the fall of your first year (thus preventing its arrival). The number of undead sent will depend on your wealth and population, and early sieges tend to have as few as 3 undead; but can cause very much cheesy fun if a lone necromancer accompanies them (which isn't uncommon).

== [[Bandit]] sieges ==

Roving bandit groups nearby your fortress may also besiege your fortress. This can happen as early as ''the first year'', making them an excellent source of surprise [[Fun]].

Bandit groups are drawn from any entity with the {{token|BANDITRY|e}} and {{token|LOCAL_BANDITRY|e}} tokens. In unmodded games, these are [[goblin]]s, [[human]]s and [[kobold]]s, though other races (even [[dwarves]]) have been reported. Their announcement messages are the same as the messages for regular sieges of their race. Bandit sieges are generally smaller than a later-game full-blown siege, more similar to goblin [[ambush]]es in size, as there are fewer units from which to draw combatants.

== [[Dwarf]] sieges ==
{{mod}}
Dwarf sieges will only arrive when you [[mod]] the game, because the game has been programmed to never cause sieges from the player's civilization. Unless you are playing with another civilization(for example, humans), Dwarf sieges will cause a massive [[loyalty cascade]] even if you don't attack the invaders.

Dwarf sieges are announced with the same message as human sieges("''The enemy have come and are laying siege to the fortress.''"). The also behave very similar to human sieges, possibly indicating that dwarves and humans have the same AI when invading a site. They even bring mounts, whereas dwarven cavalry is not implemented for the player.

== Bugs ==
* Enemy squads will never abandon their caged or dead leader. {{Bug|1598}}
* Amphibian invader mounts drown their riders. {{Bug|926}}

{{Military}}

Siege

2014-08-17T15:57:16Z

Talvieno: Changed quality rating from "Unrated" to "Fine" using the rating script

{{Quality|Fine|15:57, 17 August 2014 (UTC)}}
{{Migrated_article}}
{{av}}

:''For catapults and ballistae, see [[Siege engine]].''

'''Sieges''' are large scale assaults on your fortress by other [[civilization]]s. Sieges are drawn from moving units advancing towards the fortress, whether from an army, a bandit group, or a necromancer's [[tower]]. They are announced with a full-screen message that differs depending on the attacking race, and the main screen showing the "*SIEGE*" tag along the top for the duration.

Caravans will not arrive at a besieged fortress. They will arrive, though, if a siege is broken quickly enough, but it is possible to miss out entirely on a civilization's caravan for the year this way. Even if they do arrive before the siege, the attackers may kill them or chase them off if they can reach them. Consider this when deciding how you set up your [[trade depot]] and how heavily reliant your economy is on imported goods.

A civilization will be unable to lay siege if it can't reach your fortress site. Armies need to physically move to the location of your fortress; they are normally allowed a 30-tile radius of interaction (towers have 10 tiles), beyond which sieges are impossible. You will never get sieges if you embark on an island or in a valley which is completely surrounded by mountains. If you want to make sure that a certain civilization will be capable of laying siege to you, then look at the "neighbors" view of the [[Embark]] site finder when selecting your fortress site.

== Structure of a siege ==

*Siege forces usually consist of several 'squads'. Using the [[goblin]]s as an example, each squad consists of several goblins of one military class (swordsman, lasher, etc.), and often one 'squad leader' (typically an Elite or better, which need not be the same class as the squad it leads).
*Occasionally, a squad will be mounted - this means each of its members will be riding a suitable [[creature]], though the creatures typically vary between members. The squad leader can be mounted, even if his squad is not. These mounts can change the combat dynamics, since some can fly, are [[building destroyer]]s, or have substantially different combat traits than their rider. For more info on mounted units, and the [[Fun]] they can unleash upon an ill-prepared defender, see: [[Mount]]
*Invaders can climb [[wall]]s and pits. This can be quite [[Fun]], if your fort defence relies on the same kind of walls and pits as previous versions.
*After being sufficiently "successful" at defending against the siege (killing sufficient attackers, waiting them out, or some combination thereof), the attackers will retreat. All of the remaining squads and groups will head for the map edges and leave, typically favoring the edge they entered from. Once all of the remaining attackers have decided to retreat, the "SIEGE" tag will go away.
*It is possible to have multiple sieges at the same time. If the attacking civilizations are at war with each other, they will start to fight with each other as well.
*Different races will favor different styles of attack during sieges. The following attack styles were observed in .40d; it remains to be seen if these traits are still present in current releases.
*You can turn off sieges and [[Forgotten beast]]s altogether by editing the [[d_init.txt]] file to change [INVADERS:YES] to [INVADERS:NO].

== [[Goblin]] sieges ==

Goblin sieges are announced with the message, "''A vile force of darkness has arrived!''"

Goblins will start laying siege to your fortress when you reach a certain [[population]], usually around 80. Usually the tactics used by the goblins are no more sophisticated than charging in an open march toward your fortress and attempting to kill your [[dwarves]]. Goblins sieges often include groups of [[troll]]s, [[ogre]]s, or [[cave dragon]]s that can [[Building destroyer|break buildings]] and smash workshops. Unlike the squads, however, these 'groups' usually enter the map in a single tile, somewhat akin to arriving [[migrants]]. These war creatures usually possess random civilian classes, and show little of the organized behavior of the squads. Goblins may also bring elite human or even dwarven fighters as leaders of their squads, previously kidnapped by [[snatcher]]s. Goblin sieges usually involve [[mount]]ed squads, some of which can fly over whatever defenses you might have set up to stop them.

== [[Elf|Elven]] sieges ==

Elven sieges are announced with the message, "''The elves have brought the full forces of their lands against you.''"

It is possible to have elven attacks as well, but that usually requires some effort on part of the player, or for your starting civilization to have a pre-existing conflict with a nearby elven one. You can check this when you embark while looking at nearby civilizations, where it will read WAR next to the elf civilization, though it seems to be entirely dependent on how world gen plays out and embarking at a time when a war is happening. Another, possibly simpler (and more amusing) way to elven siege is to blatantly provoke them. If you don't want to be attacked by elves you should not offer them wooden goods or goods stored in wooden barrels or bins. You might also avoid clearing too much woodland, as elves will be offended if you do so.

Elves use stealth squads, a la goblin ambushes, to hide their numbers and locations. It should be noted, however, that unlike goblin ambushes which cap at four squads, elves can come in '''massive''' numbers, atop mighty (and tasty) [[unicorn]]s or other [[elephant|exotic beasts]]. Fortunately, unlike goblins and humans, who wear heavy armor and wield metal weapons that can cause considerable damage, the elves are very weak in battle. Their weapons and arrows are made are made of wood, which will simply bounce off any standard metal armour, and they march into battle wearing easily breakable wooden armor or even nothing but cloth robes and trousers.

== [[Human]] sieges ==

Human sieges are announced with the message "''The enemy have come and are laying siege to the fortress.''".

Humans may also siege you should you let their [[diplomat]] die while visiting your fortress, if too many of their trade wagons get destroyed or if you trade with an elven nation the humans are at war with. Humans would sometimes set up a camp near the map edge they arrived on, harassing wandering dwarves and waiting for you to come to them instead of blindly charging toward your fortress. Humans often ride rather mundane animals, such as horses, camels (of both varieties), or war grizzly bears, and may bring along further war animals like trained cheetahs. Be aware that human siegers know of all traps that their diplomats have seen before, even their war animals are immune to those traps. If you had a human diplomat in your fort, best assume that your traps are useless against the invaders unless they were built after his last visit. A removed and rebuilt trap counts as "new", even if it's the same type of trap in the same tile.

== [[Necromancer]] sieges ==

Necromancer sieges are announced with ''"The [[undead|dead]] walk. Hide while you still can!"''

Necromancers will only be able to siege you if you embark in an area near a tower. If no tower is present in the neighbors list, no necromancers will ever besiege your fortress.

Necromancers will besiege your fortress by sending [[undead]] to your fort or even coming themselves. Either way, undead sieges are a guaranteed source of [[Fun]]. The undead units will arrive from all sides of the map, slowly meandering towards your fortress. Undead sieges may arrive with as few as one zombie to as many as fifty or more. The undead in general are serious enemies that one cannot treat like goblin garbage. A legendary squad can take down unarmed zombies in equal numbers, but the large numbers that necromancers can bring are unmatchable. To make things worse, "elite" zombie fighters may carry ''weapons and armour'', a truly terrifying thought were there ever one.

It is recommended that you have <s>many traps</s> every single trap with the best materials possible you could possibly build set in advance, and when the undead legions arrive, '''shut down everything'''. Be sure to shut down all of your butcher's shops, crypts, and refuse stockpiles, as necromancers can reanimate armies of body parts to destroy your fortress from the inside. Be also careful with fishery workshops, as reports of mussel shells rising from the dead are fairly common. Necromancers will raise any corpse or corpse part that they see, and simple proximity to undead can cause things like skin and hair to rise and attack the unfortunate butcher. It doesn't really matter how many zombies arrive; if you are not prepared, you will probably get slaughtered, as one zombie can easily become two zombies, then four, then eight and so on. If the zombies cannot attack your dwarves immediately, they will simply mill about on the surface until something living (wild animals included) comes too close or until they are all destroyed. Like other sieges, it is also possible to wait out necromancer sieges, though this can take a year or more.

Necromancers can besiege your fortress at any time, including before the second spring's elven caravan arrives, or even before the first dwarven caravan arrives in the fall of your first year (thus preventing its arrival). The number of undead sent will depend on your wealth and population, and early sieges tend to have as few as 3 undead; but can cause very much cheesy fun if a lone necromancer accompanies them (which isn't uncommon).

== [[Bandit]] sieges ==

Roving bandit groups nearby your fortress may also besiege your fortress. This can happen as early as ''the first year'', making them an excellent source of surprise [[Fun]].

Bandit groups are drawn from any entity with the {{token|BANDITRY|e}} and {{token|LOCAL_BANDITRY|e}} tokens. In unmodded games, these are [[goblin]]s, [[human]]s and [[kobold]]s, though other races (even [[dwarves]]) have been reported. Their announcement messages are the same as the messages for regular sieges of their race. Bandit sieges are generally smaller than a later-game full-blown siege, more similar to goblin [[ambush]]es in size, as there are fewer units from which to draw combatants.

== [[Dwarf]] sieges ==
{{mod}}
Dwarf sieges will only arrive when you [[mod]] the game, because the game has been programmed to never cause sieges from the player's civilization. Unless you are playing with another civilization(for example, humans), Dwarf sieges will cause a massive [[loyalty cascade]] even if you don't attack the invaders.

Dwarf sieges are announced with the same message as human sieges("''The enemy have come and are laying siege to the fortress.''"). The also behave very similar to human sieges, possibly indicating that dwarves and humans have the same AI when invading a site. They even bring mounts, whereas dwarven cavalry is not implemented for the player.

== Bugs ==
* Enemy squads will never abandon their caged or dead leader. {{Bug|1598}}
* Amphibian invader mounts drown their riders. {{Bug|926}}

{{Military}}

Beekeeping industry

2014-08-15T18:00:51Z

Talvieno: Changed quality rating from "Unrated" to "Exceptional" using the rating script

{{Quality|Exceptional|18:00, 15 August 2014 (UTC)}}
{{av}}
{{buggy}}

[[Image:Beekeeping Industry Flowchart.png|right|400px]]
The '''beekeeping industry''' is an agricultural process that allows a fortress to produce auxiliary food ([[honey]], [[royal jelly]]), drink ([[mead]]), and craftable materials ([[wax]]) by farming [[honey bee]]s.

== Basic setup ==
Before you can have a beekeeping industry you must logically have bees. There are two types of bees in the game: [[honey bee]]s, which (true to their name) can be used for beekeeping, and [[bumblebee]]s, which cannot currently be so applied (this may or [http://www.bay12games.com/dwarves/mantisbt/view.php?id=3990#c15308 may not] change in the future). Honey bee colonies appear in any non-[[Freezing#Climate|freezing]] [[biome]] in some number, but are not necessarily guaranteed to appear in your fortress [[surroundings]] if you [[embark]] on such a biome, especially if a large part of your embark site is incompatible.

Honey bee colonies are one of a number of "colony" type tile features, and so it is possible that all of your "slots" are occupied by other, more boring things. If you do not have any honey bee colonies on your screen, then you (obviously) cannot have a beekeeping industry, at least not until a honey bee colony spawns. If you ''really'' want beekeeping you can build [[bridge]]s over existing colonies to "free up" space for honey bee ones (whether or not this is worth the effort is a different story).

Once you are sure you have a colony of bees, the next step is to create an artificial [[hive]], either from [[stone]] or [[wood]] at a [[craftsdwarf's workshop]], from [[ceramic]]s at a [[kiln]], from [[glass]] at a [[glass furnace]], or from [[metal]] at a [[metalsmith's forge]]. Hives are [[tool]]s stored in the [[finished goods]] [[stockpile]], and can be {{k|b}}uilt by a [[beekeeper]] using the {{k|Alt}}+{{k|h}} [[hotkeys|hotkey]]. In order to be productive, a hive must be constructed on or adjacent to a [[tile]] that is [[Tile attributes|above ground]]. Dwarves will install colonies in hives installed underground, and such colonies will grow and allow splitting off new colonies, but they will not produce honey.

Once a hive is installed, it is automatically toggled to "install colony when ready", which will generate an "Install Colony in Hive" job onto the [[manager|job list]], unless the player specifies otherwise (with {{K|q}}-{{K|c}}). Hives can have colonies installed into them from preexisting wild colonies or from hives that are ready to split (more on that later); the beekeeper will walk to the location of the colony, pick it up and bring it to the built hive. How exactly the beekeepers carry thousands of bees to a hive with their bare hands is a mystery for the ages. If there are no wild honey bee colonies on your map, no colony can be installed and nothing can be done about it for the moment. It may be beneficial to build a single hive and then see if your beekeeper can find a colony to fill it with rather than go looking for it beforehand if you're unsure whether or not you have any honey bees on your map. You may need to wait a while until you're sure the beekeeper actually doesn't have a colony available and isn't just busy doing other stuff; if there is no available colony, the "install colony in hive" job will not cancel but rather stay "inactive" indefinitely.

== Hive management ==
Once there is a colony (of 10 000 to 20 000 bees) in your hive, you have two options:
* You may toggle the hive (using {{K|q}}-{{K|g}}) so that the product is not automatically gathered. This will prevent your dwarves from collecting the products but at the same time preserves the colony, which will keep growing, so that new colonies can be split off it regularly and placed in additional hives. Assuming you have spare hives built and available, this is the option you set your hives to in order to grow them.
* Or you can choose to have the hive harvested, causing a beekeeper to approach the hive about nine months later to transfer the [[royal jelly]] into an empty [[jug]] and to make the [[honeycomb]] available, so that it can be moved to storage. This is the production option; the hives will produce things for you at a steady rate, but the harvesting destroys the colony in the hive; it can then be repopulated by a colony ready for splitting.

Note: The colony in a hive set to "collect products" will still grow, but splitting off a new colony only becomes possible shortly before the hive is ripe for harvesting, and harvesting will always destroy the entire colony, whether it is ready to split or not. Consequently, dwarves will sometimes replenish hives from colonies set to "collect", but not reliably. To sustain a beekeeping industry without tedious micro-management, a healthy number of "breeding" hives are needed which are not allowed for collection.

Beekeeping as an industry is currently extremely buggy, involves a lot of micromanagement on the supply side, and doesn't produce as many products as it really should to be worthwhile. Most annoyingly, there is a bug where multiple empty hives will generate conflicting jobs targeting the same colony which reliably get beekeepers stuck {{bug|3981}}. Consequently, a beekeeping industry must be grown quite slowly and measures must be taken to reduce the number of hives which are empty at the same time, like limiting the number of dwarves who may perform the beekeeping labour. Additionally, there is no way to tell beekeepers to prioritize fortress hives over wild ones for colony installation (except perhaps by using a [[burrow]]) - they will often wander far out into the map without even the [[ambusher]]'s [[crossbow]]s for self-protection. For these reasons the industry is typically seen as a novelty, at least until the kinks are ironed out.

===Examining hives===
Interacting with a hive ({{K|q}}) will show:

* Which options have been set for that hive (install colony or don't, gather products or save for split).
* Whether it has {{DFtext|Outdoor access|2:1}} or {{DFtext|No outdoor access|4:1}}.
* If the hive is {{DFtext|Ready to be split|2:1}}.

If interacting with the hive shows {{DFtext|Not ready to be split|7:0}} then it might mean it has a colony too small to be split, or that it has no colony at all. To see if a hive has a colony, uses "view items in buildings" ({{K|t}}), which will show an item [[stack]] of thousands of bees if there's a colony. {{K|t}} will also show if the hive has a honey comb or lump of royal jelly.

===Artificial hive limits===
If your fortress has more than 40 inhabited artificial hives, but less than 60, then interacting with a hive ({{K|q}}) will show:

{{Gametext|Too many hives|6:1}}
{{Gametext|* Output restricted|6:0}}

Presumably this means that existing artificial hives grow more slowly. {{Verify}}

Having more than 40 or more than 60 inhabited artificial hives does not appear to prevent new wild hives from appearing, and these can still be transferred to empty artificial hives.

If you fortress has 60 or more inhabited artificial hives, then interacting with a hive ({{K|q}}) will show:

{{Gametext|Too many hives|4:1}}
{{Gametext|* No output|4:1}}

Presumably this means that existing artificial hives no longer grow, or that grown hives can't be split.

==Products==
Harvesting a hive produces two items, one of which is a lump of [[royal jelly]], which must be collected in an empty [[jug]], an item used only by the beekeeping industry and in the production of [[quarry bush|rock nut oil]]. Royal jelly is a liquid [[food]] item, and so can only be used in [[cook]]ing [[prepared meal]]s, and only if another, solid food item is included in the meal. Every harvest will result in a single jug filled with jelly. The other item produced by a harvest job is the [[honeycomb]], which is a little more complicated to process: it is considered a [[wax]] [[tool]] and doesn't have any direct application, but when [[presser|pressed]] at a [[screw press]] produces two products, one jug filled with [[honey]] and a [[wax]] press cake, both of which are handled as food items for storage.

Harvesting a hive requires a jug (ae. you cannot harvest the honeycomb alone), as does pressing the honeycomb; carrying the products to their destination [[stockpile]] or production point is considered an [[item hauling]] job unrelated with the beekeeping labor, so after being harvested by a beekeeper they will be left at the foot of the hive until someone comes by to haul them off, unless the beekeeper has item hauling enabled themselves (in which case they'll send it to nearest applicable stockpiles). The same is true of honeycomb pressing.

[[Honey]] can be cooked into a meal or brought to a [[still]] and processed with a [[barrel]] or [[large pot]] into mead, the only non plant-based alcoholic drink in the game. [[Wax]], meanwhile, can be processed into various wax [[craft]]s by a [[wax worker]] at a [[craftsdwarf's workshop]]. Wax crafts are not particularly valuable - they have a [[material value]] of one, the same as [[wood]] and non-[[flux]] [[stone]] - but they're something.

==Bugs==
* Filled [[Jug]]s may be stored in [[bin]]s as [[finished goods]], preventing the use of their contents in the food industry.{{bug|4229}}
* Stacks of [[honey bee]]s in their hives can be [[wear|mangled]] by [[fire|forest fires]], but will still live, resulting in some odd descriptions.{{bug|4101}}

{{Category|Guides}}
{{Category|Industry}}
{{Industry}}

Beekeeping industry

2014-08-15T18:00:20Z

Talvieno: Removed migrated article tag and fixed bugs.

{{quality|unrated}}{{av}}
{{buggy}}

[[Image:Beekeeping Industry Flowchart.png|right|400px]]
The '''beekeeping industry''' is an agricultural process that allows a fortress to produce auxiliary food ([[honey]], [[royal jelly]]), drink ([[mead]]), and craftable materials ([[wax]]) by farming [[honey bee]]s.

== Basic setup ==
Before you can have a beekeeping industry you must logically have bees. There are two types of bees in the game: [[honey bee]]s, which (true to their name) can be used for beekeeping, and [[bumblebee]]s, which cannot currently be so applied (this may or [http://www.bay12games.com/dwarves/mantisbt/view.php?id=3990#c15308 may not] change in the future). Honey bee colonies appear in any non-[[Freezing#Climate|freezing]] [[biome]] in some number, but are not necessarily guaranteed to appear in your fortress [[surroundings]] if you [[embark]] on such a biome, especially if a large part of your embark site is incompatible.

Honey bee colonies are one of a number of "colony" type tile features, and so it is possible that all of your "slots" are occupied by other, more boring things. If you do not have any honey bee colonies on your screen, then you (obviously) cannot have a beekeeping industry, at least not until a honey bee colony spawns. If you ''really'' want beekeeping you can build [[bridge]]s over existing colonies to "free up" space for honey bee ones (whether or not this is worth the effort is a different story).

Once you are sure you have a colony of bees, the next step is to create an artificial [[hive]], either from [[stone]] or [[wood]] at a [[craftsdwarf's workshop]], from [[ceramic]]s at a [[kiln]], from [[glass]] at a [[glass furnace]], or from [[metal]] at a [[metalsmith's forge]]. Hives are [[tool]]s stored in the [[finished goods]] [[stockpile]], and can be {{k|b}}uilt by a [[beekeeper]] using the {{k|Alt}}+{{k|h}} [[hotkeys|hotkey]]. In order to be productive, a hive must be constructed on or adjacent to a [[tile]] that is [[Tile attributes|above ground]]. Dwarves will install colonies in hives installed underground, and such colonies will grow and allow splitting off new colonies, but they will not produce honey.

Once a hive is installed, it is automatically toggled to "install colony when ready", which will generate an "Install Colony in Hive" job onto the [[manager|job list]], unless the player specifies otherwise (with {{K|q}}-{{K|c}}). Hives can have colonies installed into them from preexisting wild colonies or from hives that are ready to split (more on that later); the beekeeper will walk to the location of the colony, pick it up and bring it to the built hive. How exactly the beekeepers carry thousands of bees to a hive with their bare hands is a mystery for the ages. If there are no wild honey bee colonies on your map, no colony can be installed and nothing can be done about it for the moment. It may be beneficial to build a single hive and then see if your beekeeper can find a colony to fill it with rather than go looking for it beforehand if you're unsure whether or not you have any honey bees on your map. You may need to wait a while until you're sure the beekeeper actually doesn't have a colony available and isn't just busy doing other stuff; if there is no available colony, the "install colony in hive" job will not cancel but rather stay "inactive" indefinitely.

== Hive management ==
Once there is a colony (of 10 000 to 20 000 bees) in your hive, you have two options:
* You may toggle the hive (using {{K|q}}-{{K|g}}) so that the product is not automatically gathered. This will prevent your dwarves from collecting the products but at the same time preserves the colony, which will keep growing, so that new colonies can be split off it regularly and placed in additional hives. Assuming you have spare hives built and available, this is the option you set your hives to in order to grow them.
* Or you can choose to have the hive harvested, causing a beekeeper to approach the hive about nine months later to transfer the [[royal jelly]] into an empty [[jug]] and to make the [[honeycomb]] available, so that it can be moved to storage. This is the production option; the hives will produce things for you at a steady rate, but the harvesting destroys the colony in the hive; it can then be repopulated by a colony ready for splitting.

Note: The colony in a hive set to "collect products" will still grow, but splitting off a new colony only becomes possible shortly before the hive is ripe for harvesting, and harvesting will always destroy the entire colony, whether it is ready to split or not. Consequently, dwarves will sometimes replenish hives from colonies set to "collect", but not reliably. To sustain a beekeeping industry without tedious micro-management, a healthy number of "breeding" hives are needed which are not allowed for collection.

Beekeeping as an industry is currently extremely buggy, involves a lot of micromanagement on the supply side, and doesn't produce as many products as it really should to be worthwhile. Most annoyingly, there is a bug where multiple empty hives will generate conflicting jobs targeting the same colony which reliably get beekeepers stuck {{bug|3981}}. Consequently, a beekeeping industry must be grown quite slowly and measures must be taken to reduce the number of hives which are empty at the same time, like limiting the number of dwarves who may perform the beekeeping labour. Additionally, there is no way to tell beekeepers to prioritize fortress hives over wild ones for colony installation (except perhaps by using a [[burrow]]) - they will often wander far out into the map without even the [[ambusher]]'s [[crossbow]]s for self-protection. For these reasons the industry is typically seen as a novelty, at least until the kinks are ironed out.

===Examining hives===
Interacting with a hive ({{K|q}}) will show:

* Which options have been set for that hive (install colony or don't, gather products or save for split).
* Whether it has {{DFtext|Outdoor access|2:1}} or {{DFtext|No outdoor access|4:1}}.
* If the hive is {{DFtext|Ready to be split|2:1}}.

If interacting with the hive shows {{DFtext|Not ready to be split|7:0}} then it might mean it has a colony too small to be split, or that it has no colony at all. To see if a hive has a colony, uses "view items in buildings" ({{K|t}}), which will show an item [[stack]] of thousands of bees if there's a colony. {{K|t}} will also show if the hive has a honey comb or lump of royal jelly.

===Artificial hive limits===
If your fortress has more than 40 inhabited artificial hives, but less than 60, then interacting with a hive ({{K|q}}) will show:

{{Gametext|Too many hives|6:1}}
{{Gametext|* Output restricted|6:0}}

Presumably this means that existing artificial hives grow more slowly. {{Verify}}

Having more than 40 or more than 60 inhabited artificial hives does not appear to prevent new wild hives from appearing, and these can still be transferred to empty artificial hives.

If you fortress has 60 or more inhabited artificial hives, then interacting with a hive ({{K|q}}) will show:

{{Gametext|Too many hives|4:1}}
{{Gametext|* No output|4:1}}

Presumably this means that existing artificial hives no longer grow, or that grown hives can't be split.

==Products==
Harvesting a hive produces two items, one of which is a lump of [[royal jelly]], which must be collected in an empty [[jug]], an item used only by the beekeeping industry and in the production of [[quarry bush|rock nut oil]]. Royal jelly is a liquid [[food]] item, and so can only be used in [[cook]]ing [[prepared meal]]s, and only if another, solid food item is included in the meal. Every harvest will result in a single jug filled with jelly. The other item produced by a harvest job is the [[honeycomb]], which is a little more complicated to process: it is considered a [[wax]] [[tool]] and doesn't have any direct application, but when [[presser|pressed]] at a [[screw press]] produces two products, one jug filled with [[honey]] and a [[wax]] press cake, both of which are handled as food items for storage.

Harvesting a hive requires a jug (ae. you cannot harvest the honeycomb alone), as does pressing the honeycomb; carrying the products to their destination [[stockpile]] or production point is considered an [[item hauling]] job unrelated with the beekeeping labor, so after being harvested by a beekeeper they will be left at the foot of the hive until someone comes by to haul them off, unless the beekeeper has item hauling enabled themselves (in which case they'll send it to nearest applicable stockpiles). The same is true of honeycomb pressing.

[[Honey]] can be cooked into a meal or brought to a [[still]] and processed with a [[barrel]] or [[large pot]] into mead, the only non plant-based alcoholic drink in the game. [[Wax]], meanwhile, can be processed into various wax [[craft]]s by a [[wax worker]] at a [[craftsdwarf's workshop]]. Wax crafts are not particularly valuable - they have a [[material value]] of one, the same as [[wood]] and non-[[flux]] [[stone]] - but they're something.

==Bugs==
* Filled [[Jug]]s may be stored in [[bin]]s as [[finished goods]], preventing the use of their contents in the food industry.{{bug|4229}}
* Stacks of [[honey bee]]s in their hives can be [[wear|mangled]] by [[fire|forest fires]], but will still live, resulting in some odd descriptions.{{bug|4101}}

{{Category|Guides}}
{{Category|Industry}}
{{Industry}}

Fire snake

2014-08-15T17:32:17Z

Talvieno: I don't think anything has changed here. Removing the migration tag.

{{Quality|Exceptional|00:22, 10 June 2010 (UTC)}}
{{verminlookup/0|wiki=no}}
{{av}}
{{creaturedesc}}

'''Fire snakes''' are [[fire-safe|fire-proof]] [[vermin]]. They spawn only around [[magma]] sites, which are defined as the original [[biome|biomes]], and don't include any [[channel|channels]] that carry magma away from magma pipes or magma pools. They may start [[fire|fires]], so locating [[fuel]] or [[graphite]] [[stockpile|stockpiles]] near magma (or passages leading to magma) is risky. They will also inspire an unhappy [[thought]] if a dwarf that [[preference|hates]] them encounters one.

With a body temperature of 14,000, a fire snake is hotter than magma and hotter than the melting point of nearly all [[magma-safe]] materials. It can melt or burn its way out of nearly any [[animal trap]], with the exceptions of [[nether-cap]] and [[adamantine]].

Although fire snakes spawn near magma, a dwarf on trapping duty can unwittingly transport a fire snake to an animal stockpile elsewhere in your fortress. Once set down by the trapper, a fire snake's high temperature can destroy the animal trap that holds it. Once free, a fire snake far can cause all sorts of [[fun]] with your loose objects. It can destroy masterworks, which cause unhappy thoughts and can lead to [[tantrum spiral]]s. And it can destroy [[cage]]s, releasing any creatures held therein.

[[Liquid fire]] is a valuable [[extracts|extract]] derived from captured fire snakes.

{{gamedata}}
{{Vermin}}
{{category|Fire immune}}

Magma

2014-08-07T00:57:22Z

Talvieno: fixed a redlink.

{{av}}{{Quality|Exceptional|21:13, 6 July 2010 (UTC)}}
'''Magma''' is red-hot [[fluid|molten rock]] that wells up from deep within the earth (but not so deep that it cannot be found by dwarves), entering the map either by the edges or by the area beneath a magma pool. Magma that emerges aboveground is called '''Lava'''; however the substance itself remains the same. Magma is very [[Fun]].

Magma serves as a heat source, replacing [[fuel]] in [[magma smelter]]s, [[magma forge]]s, [[magma glass furnace]]s, and [[magma kiln]]s. Magma is ''extremely'' hot which can lead to even more [[Fun]]. Materials that can withstand the temperature of magma are called '''[[magma-safe]]''', and the list is rather extensive.

Magma never cools, but can [[evaporation|evaporate]] if left at a depth of 1/7 for long enough. When magma is mixed with water it forms [[obsidian]] (and [[steam]]). Note that magma located above [[semi-molten rock]] will be listed as a Magma Flow; magma in magma flow tiles will disappear when mixed with water (instead of cooling into obsidian).

Without [[screw pump]]s to impart [[pressure]], magma flows rather slowly (though no more slowly than unpressurized water). A pipe to bring magma across the full map can take as much as a year to fill. This, combined with the fact that it will evaporate, can make filling a reservoir difficult and tedious. As a rule of thumb, the area coming out of a 1-wide-pipe shouldn't be more than three squares wide and 20 squares long, or else it will evaporate as fast as you fill it.

==Magma sources==

Magma occurs in several different geological formations:
===[[Magma pool]]s===
Although the name suggests them as pools, they are more like pipes. They can be found underground, however they rarely reach the upper z-levels (40+). Most end a few z-levels above the magma sea, though some may span more than 100 z-levels.
Magma pools seem to be always connected to a magma sea, and the sea and pipe can occasionally reach up to the same level, making them hard to separate. However, magma pools can be identified by the obsidian walls which surround them.
Magma pools will slowly refill themselves, giving the player an infinite source of magma. The entire embark tile containing the pool will produce sporadic bursts of magma until the magma within it is at its natural level (i.e. the magma level at embark) or until it is halted by a bridge, floor, or bottom of a wall.

===[[Volcano]]es===
Volcanoes are magma pools that extend all the way to the surface. Volcanoes are an endless source of magma as they will always refill themselves. They never erupt, unlike their real-life counterparts. Volcanoes are geographical features visible on the [[location]] screen, making them much easier to find when choosing a site for your fortress.

===[[Magma sea]]===
The magma sea is a large body of magma deep under the earth. Nearly all maps will include a magma sea at the lowest z-levels, though its inconvenient placement may inspire your dwarves to [[#Bringing Magma Up|bring the magma up]] to the fortress proper.

== Finding magma ==

Nearly all maps will have magma available at the lowest z-levels, but it can be advantageous to select a site with a more easily accessible source, particularly when starting out.

Volcanoes are visible on the "local" screen in the starting location chooser. It is represented as a red ˜ mark (a double tilde) - essentially it looks like red water. Note that red ˜ marks in the "region" screen mean something different entirely (e.g. red sand).

After you have chosen to embark in a place that has a volcano, and once your dwarves have arrived at their target destination, you should see a large red pool of lava on your map. If you don't, you should expect your volcano to be somewhere underground. You then have to use [[exploratory mining]] to find it. If you can find a large patch of obsidian on the surface that is devoid of boulders, chances are there is a magma vent below, so that would be a good place to start your mining.

Much harder than simply finding a volcano is finding a volcano that is also near suitable terrain for building. Depending on your requirements - you may be looking for a source of running [[water]], or a [[mountain]] for minerals, or a healthy [[tree]] population, a layer of [[flux]] for [[steel]] production or even all four - suitable building sites can be extremely scarce.

==Working with magma==

Although magma is a liquid, it does not move via [[pressure]] unless it has been pumped. This reduced rate of flow can allow miners to survive digging into a magma reservoir, ''if'' they are lucky enough. There are ways to minimize this risk however:

'''Digging From Above:'''
If you can find a suitable position above the magma, your miner can dig a [[channel]] while remaining above the level of the magma. Be warned, however, that your dwarves might take the ramp down into the magma channel as a shortcut; preemptively designating the channel for restricted [[traffic]] is recommended.

'''Diagonal Digging:'''
Magma moves more slowly diagonally than orthogonally, giving the miner more time to escape. However, slower flow means you must keep in mind the evaporation. You should dig a smaller channel, wait for it to fill up, and extends the channel by Digging From Above. Workers that dig into a magma reservoir are not instantly killed as the magma touches them, but they are set on fire, which will kill them very quickly. For this reason, taking steps to ensure there is adequate water available to extinguish flaming dwarves running in random directions is advised before digging into any magma pools from the side. Channeling a single square wide pit across the planned magma pipe one tile away from the wall to breach and filling it with 2/7 water using the [[Activity zone#Pit/Pond|pond zone]] tool is recommended, so the panicking dwarves have no choice but to run through the water, and the water itself turns into an obsidian wall as soon as the magma flows into it.

'''Busy To Leave:'''
[http://www.bay12forums.com/smf/index.php?topic=111883.0]
Dwarves who dig into magma often die not because they are unable to flee but because they choose not to. By ensuring a dwarf has another task waiting (ideally far away) they will immediately move away from the ensuing magma flow.

Simply mine up to the corner of a lava tube and then smooth the last tile. Dig a staircase within a few tiles of the place where you will be breaching that leads up and back into your fortress, this will allow your dwarf to get out before the magma gets him. Now designate the smoothed corner to be carved into a fortification. Now immediately when the dwarf begins to carve the fortification, (and this is the most important part!), designate a bunch of other tiles to be smoothed/carved. It's not important that your dwarves actually smooth, carve, or engrave those tiles, what is important is that your dwarf immediately takes another smooth/carve/engrave task elsewhere in the fortress when they finish the current one. If they do not then they will pause for the briefest of instants as they pick a new task, resulting in their death. If they have the job though, they will instantly turn and head up the staircase, stopping the magma from catching and killing them."

'''Exploit From Below:'''
[http://www.bay12forums.com/smf/index.php?topic=110724.0]
Miners are able to mine out tiles diagonally above them '''even if there is a bridge over their heads'''. First you dig out your magma tunnel to feed magma to wherever in your fort you need it and dig it right up against the volcano pipe. Then you channel a trench against the pipe that can be the width of the tunnel if you wish. Build a magma-safe bridge over the trench, making sure to cover it completely, and then seal off access to the magma tunnel. Dig a new separate path to access the now bridged-over trench. Finally, designate the magma wall '''on the Z level of the magma tunnel''' for mining. Your dwarves will stand in the trench beneath the bridge but will somehow still mine out the squares diagonally above them, causing the magma to flow safely onto the bridge leaving your dwarves unscathed."

Example (use {{k|<}}{{k|>}} to navigate):
<diagram>
<frame type="level" level="0">
Z=0
[%205][%205][%205][%205][%205]╗[#F00]≈≈≈[#]
....[#080]╥[#000][@880][%186][@][#F00]≈≈≈[#]
....[#080][%186][#000][@880][%186][@][#F00]≈≈≈[#]
....[#080]╨[#000][@880][%186][@][#F00]≈≈≈[#]
[%205][%205][%205][%203][%205][%185][#F00]≈≈≈[#]
[%186]X[%186][#F00]≈≈≈[#]
[%200][%205][%188][#F00]≈≈≈[#]
</frame>
<frame type=level level=1>
Z=1
[#F00]≈≈≈[#]
[#F00]≈≈≈[#]
[#F00]≈≈≈[#]
[#F00]≈≈≈[#]
[%205][%205][%205][%205][%205][%187][#F00]≈≈≈[#]
....X[%186][#F00]≈≈≈[#]
[%205][%205][%205][%205][%205][%188][#F00]≈≈≈[#]
</frame>
<frame type="level" level="-1">
Z=-1
[%201][%205][%187][#F00]≈≈≈[#]
║▲║[#F00]≈≈≈[#]
║▲║[#F00]≈≈≈[#]
║▲║[#F00]≈≈≈[#]
║.║[#F00]≈≈≈[#]
║X║[#F00]≈≈≈[#]
[%200][%205][%188][#F00]≈≈≈[#]
</frame>
</diagram>

Make sure the top z-level is sealed off from miners and '''[[dig]]''' ({{k|d}}-{{k|d}}) the highlighted tiles on the upper z-level.

== Bringing Magma Up ==

Magma can be brought to the surface by three different methods: [[pump|pump stack]]s, magma pistons, and minecarts. Pump stacks are conceptually the simplest, but require an enormous amount of in-game time to make. Magma pistons tend to be faster to make, but require more time to understand how to build them. Minecarts are a simple solution, but require more management than pump stacks because they can overfill a reservoir.

=== Pump stacks ===
Pumping magma up from the [[magma sea]] via a conventional [[pump#Example layouts#pump stack|pump stack]] is a lot of work, requiring dozens of pumps and significant amounts of power. Making all of the pumps [[magma safe]] also requires a lot of precious materials like iron, or a functioning glass industry.

=== Magma pistons ===
[[Magma piston]]s are another way to move magma near the surface. Magma pistons require less time and fewer precious materials to construct than pump stacks. However, magma pistons are a bit more complicated than pump stacks, so it takes more time to understand how to operate and build them.

=== Minecarts ===
[[Minecart]]s submerged in 7/7 magma (or possibly less, but 2/7 is not enough) will fill with magma. Each minecart holds 2/7 worth of magma, which is subtracted from the amount of magma in the tile. The minecart is then shown as containing magma [833]. Minecarts used for this must be [[magma-safe]].

Minecarts full of magma can be tipped at a track stop, which will pour the magma in a specified direction from the stop. Therefore, the challenge is to get the minecart full of magma to the track stop. There are several ways to accomplish this.

The first task is to separate the minecart from the tile of magma. The obvious way is to build [[roller]]s in magma to pull the minecarts out; such rollers would also need to be magma-safe. Another way would be to drain the magma.

The second task is to move the liberated minecart to the track stop. Tracks can be built from the magma sea to the surface. A minecart track can be operated by dwarves or fully automatic, using powered rollers. Depending on the placement of the track stop, dangerous overflow can be prevented by making the track stop of a material that will melt/burn once the reservoir begins to overflow.

[[Minecart#Impulse ramps|Impulse ramps]] can be used to get magma-filled carts to wherever they need to go without having to provide power to an extensive system of rollers, and will fully automate bringing magma to the surface. Since such systems require comparatively little designation and magma-safe materials, work can be begun much earlier than some other methods of bringing magma to the surface.

==== Design 1 ====
In [http://www.bay12forums.com/smf/index.php?topic=125679.msg4217863#msg4217863 one design] posted to the forums by gchristopher, a pump can provide power to the [[roller]], making the ramp eligible for building the roller, and keeping the trench at 7 magma so the carts fill instantly.

{{diagram|spaces=yes|\
▒▒▒
▒#▒ # {{=}} floor grate
▒%▒ % {{=}} south facing pump
▒%▒▒
▒▲▲▒ Left ramp ▲ has a left-pushing roller
▒▒▒▒ Right ramp ▲ has a retracting bridge
}}

If you drop minecarts in directly from at least 2 z-levels above onto the right ramp, this setup has the magical property that it can handle an arbitrary number of minecarts, and dispense them at a constant controlled rate. Carts are pushed up the left ramp by the roller.

If you extend the right bridge, that tile ceases to be a ramp. Exactly one minecart will fall onto the tile and stay there, and all other minecarts dropped from above will form a quantum pile 1 z-level up.

The last time I [gchristopher] built one, I timed the cart dispensing rate at 1 per 8 ticks. This is slow enough that carts can be brought to the surface using an impulse ramp spiral, but fast enough that you can still quickly cover a large area with magma.

The same design works with water, for giving you a lot of flexibility creating tall waterfalls without pump stacks, quickly and cheaply.

==== Design 2 ====
Rafal99 posted [http://www.bay12forums.com/smf/index.php?topic=109460.msg3374816#msg3374816 another design] using dwarf-powered [[wheelbarrow]]s to transport the magma-filled minecarts from one minecart stockpile to another.

<pre>
▒ddddd=====S==<<Zccccc Near the surface (top view)
U

▒bbbbb== ==<<Xaaaaa Near the magma (side view)
\7777/

\7777/ - Magma reservoir, with tracks in it and rollers to bring minecart up the ramp
U - Here we want magma
aabbccdd - Stockpiles accepting minecarts
===<< - Track and rollers
S - Track stop, set to lowest friction (so it doesn't stop the minecart), set to dump the contents into the U
XZ - Track stops set to dump their contents to the left
▒ - Wall to stop minecarts
</pre>

# Empty minecarts are put into stockpile aaaaa.
# There is a hauling route with one stop on X, with assigned vehicle, set to take furniture->minecarts from stockpile aaaaa.
# Empty minecarts are put into the minecart on track stop X, the track stop dumps them to the left, placing them on the rollers.
# Rollers move the empty minecarts into the magma reservoir, they get filled with magma, then the roller on ramp moves them up. They follow the track, then go out of it and stop at the wall; effectively the minecart with magma is being placed in stockpile bbbbb.
# Stockpile ccccc is set to take from stockpile bbbbb and has assigned 3 wheelbarrows. Dwarves safely transport the minecarts with magma inside wheelbarrows up to the surface into stockpile ccccc.
# There is a hauling route with one stop on Z, with assigned vehicle, set to take furniture->minecarts from stockpile ccccc.
# Magma minecarts are put into the minecart on track stop Z, and the track stop dumps them to the left, placing them on the rollers. (Same as in 3.)
# Rollers move the magma minecarts along the track. They pass through the track stop S and dump the magma in the destination point U, then they follow the track, go out of it and stop at the wall; effectively the emptied minecart is being placed in stockpile ddddd.
# Stockpile aaaaa is set to take from stockpile ddddd. Dwarves haul the empty minecarts back underground near the magma into stockpile aaaaa.
Then we go back to start and the whole thing repeats.

==== Design 3: Minimalist magma moving ====

You'll need two magma-safe pumps, a magma-safe wheelbarrow, and at least one magma-safe minecart. If you get lucky, the first dwarven caravan will bring all the tools you need. If not, you can forge your own by melting down the surplus of anvils that caravans carry, or just embark with a couple chunks of iron ore.

{{diagram|spaces=yes|\
sideview
░░░░░░░░░░░░░░░░░░░░░░░
░░░ %% ░░░░░░░░░░░░
░░░░░░░░░░▲%% ░░░░░░░░░
░░░░░░░░░░░░░7777777░░░
}}

# Dig down to the magma sea and channel a tile above the magma
# Build the first pump to pull magma up into a 1x1 room with a ramp (▲)
# Build the second pump to pull the magma out of the 1x1 room and dispose of it (a 3x3 evaporation chamber works fine)
# Designate a garbage dump zone in the 1x1 room and dump all your magma-safe minecarts
# Wait for all the minecarts to be carried down to the dump zone
# Operate pump 1 briefly, then stop it and activate pump 2 briefly (the minecarts should now contain magma)
# Designate a minecart stockpile near your desired magma workshops, and set it to use your magma-safe wheelbarrow
# Unforbid your minecarts and wait for your dwarves to wheelbarrow them up to the stockpile
# Build a dumping track stop to place the magma where you want it
# Create a new hauling route, specify a new stop on the constructed track stop, and assign one of the magma minecarts to the route
# Unassign the cart, and mark it for dumping; once you've emptied all the carts return to step 5

This design is only useful for moving small amounts of magma, but it is simple and flexible. With any luck you can have your topside magma workshops up and running in a year.

==Using magma==
The primary use for magma is to <s>flood your fortress</s> power [[magma smelter]]s, [[magma glass furnace]]s, [[magma kiln]]s, and [[magma forge]]s. To power a building with magma at least one of the external eight squares must be a hole above a square of magma on the level below. Placing one of the workshop's [[impassable tile]]s above the magma conveniently prevents clumsy dwarves from falling in. Magma used for power is not consumed; a single tile of magma can operate the furnace indefinitely.

Other uses for magma include [[obsidian farming]], [[DF2012:Trap_design#Magma_and_fire_traps|trap design]], melting [[ice]], igniting [[fire]]s, and even [[garbage disposal]].

==Properties of magma==
Magma behaves the same way as water with the exception of not being affected by [[pressure]] (except when being moved by a [[screw pump]]) and apparently not showing [[flow]]. Magma will turn into [[obsidian]]<sup>1</sup> if it touches [[water]]. In the game, magma's temperature is {{ct|12000}}. See the list of '''[[magma-safe]]''' materials for more information on what can (or cannot) be safely submerged in magma.

Tiles directly adjacent to magma will be heated to a temperature of {{ct|10075}}, causing revealed unmined tiles to flash with {{Tile|☼|6:4:1}} when placing digging designations and causing unrevealed mining-designated tiles to cancel their designation (with a "warm stone" warning) once they are revealed.

[[Construction]]s ([[wall]]s, [[floor]]s, etc.) of any material can safely contain magma. Non-construction [[building]]s ([[door]]s, [[bridge]]s, [[Screw pump|pump]]s, etc.) that come into contact with magma should be built entirely of [[magma-safe]] materials. Non-magma-safe components will eventually melt and the building will deconstruct. Any [[mechanism]]s likely to come into contact with magma should also be made of magma-safe materials.

<small><sup>1</sup> - specifically, one of the inorganic materials having the [LAVA] tag, selected randomly ''per biome'' during worldgen.</small>

==Dangers of magma==
Any contact with magma results in nearly instant immolation, followed by death if water is not close at hand. Additionally, dropping large items into magma will generate clouds of [[magma mist]] which can set your haulers on fire if you aren't careful. Magma is also home to various fiery creatures which can present a significant threat to unprepared fortresses.

{{D for Dwarf}}

Magma is very well known for being the perfect solution to any problem encountered by dwarves. Giant badger invasion? Pour magma on it. Noble being his usual snotty, useless, arrogant self? Pour magma on it. Door locked due to invaders? Pour magma on it! Flooded your fortress with magma? [[Fun|Congratulations, you just won the game!]]

{{gamedata|{{raw|DF2012:hardcoded_materials.txt|MATERIAL|INORGANIC}}}}
{{Magma FAQ}}

{{Category|Physics}}

Magma

2014-08-07T00:54:36Z

Talvieno: Removing the migration tag. I'm almost positive nothing has changed as far as magma goes.

{{av}}{{Quality|Exceptional|21:13, 6 July 2010 (UTC)}}
'''Magma''' is red-hot [[fluid|molten rock]] that wells up from deep within the earth (but not so deep that it cannot be found by dwarves), entering the map either by the edges or by the area beneath a magma pool. Magma that emerges aboveground is called '''Lava'''; however the substance itself remains the same. Magma is very [[Fun]].

Magma serves as a heat source, replacing [[fuel]] in [[magma smelter]]s, [[magma forge]]s, [[magma glass furnace]]s, and [[magma kiln]]s. Magma is ''extremely'' hot which can lead to even more [[Fun]]. Materials that can withstand the temperature of magma are called '''[[magma-safe]]''', and the list is rather extensive.

Magma never cools, but can [[evaporation|evaporate]] if left at a depth of 1/7 for long enough. When magma is mixed with water it forms [[obsidian]] (and [[steam]]). Note that magma located above [[semi-molten rock]] will be listed as a Magma Flow; magma in magma flow tiles will disappear when mixed with water (instead of cooling into obsidian).

Without [[screw pump]]s to impart [[pressure]], magma flows rather slowly (though no more slowly than unpressurized water). A pipe to bring magma across the full map can take as much as a year to fill. This, combined with the fact that it will evaporate, can make filling a reservoir difficult and tedious. As a rule of thumb, the area coming out of a 1-wide-pipe shouldn't be more than three squares wide and 20 squares long, or else it will evaporate as fast as you fill it.

==Magma sources==

Magma occurs in several different geological formations:
===[[Magma pool]]s===
Although the name suggests them as pools, they are more like pipes. They can be found underground, however they rarely reach the upper z-levels (40+). Most end a few z-levels above the magma sea, though some may span more than 100 z-levels.
Magma pools seem to be always connected to a magma sea, and the sea and pipe can occasionally reach up to the same level, making them hard to separate. However, magma pools can be identified by the obsidian walls which surround them.
Magma pools will slowly refill themselves, giving the player an infinite source of magma. The entire embark tile containing the pool will produce sporadic bursts of magma until the magma within it is at its natural level (i.e. the magma level at embark) or until it is halted by a bridge, floor, or bottom of a wall.

===[[Volcano]]es===
Volcanoes are magma pools that extend all the way to the surface. Volcanoes are an endless source of magma as they will always refill themselves. They never erupt, unlike their real-life counterparts. Volcanoes are geographical features visible on the [[location]] screen, making them much easier to find when choosing a site for your fortress.

===[[Magma sea]]===
The magma sea is a large body of magma deep under the earth. Nearly all maps will include a magma sea at the lowest z-levels, though its inconvenient placement may inspire your dwarves to [[#Bringing Magma Up|bring the magma up]] to the fortress proper.

== Finding magma ==

Nearly all maps will have magma available at the lowest z-levels, but it can be advantageous to select a site with a more easily accessible source, particularly when starting out.

Volcanoes are visible on the "local" screen in the starting location chooser. It is represented as a red ˜ mark (a double tilde) - essentially it looks like red water. Note that red ˜ marks in the "region" screen mean something different entirely (e.g. red sand).

After you have chosen to embark in a place that has a volcano, and once your dwarves have arrived at their target destination, you should see a large red pool of lava on your map. If you don't, you should expect your volcano to be somewhere underground. You then have to use [[exploratory mining]] to find it. If you can find a large patch of obsidian on the surface that is devoid of boulders, chances are there is a magma vent below, so that would be a good place to start your mining.

Much harder than simply finding a volcano is finding a volcano that is also near suitable terrain for building. Depending on your requirements - you may be looking for a source of running [[water]], or a [[mountain]] for minerals, or a healthy [[tree]] population, a layer of [[flux]] for [[steel]] production or even all four - suitable building sites can be extremely scarce.

==Working with magma==

Although magma is a liquid, it does not move via [[pressure]] unless it has been pumped. This reduced rate of flow can allow miners to survive digging into a magma reservoir, ''if'' they are lucky enough. There are ways to minimize this risk however:

'''Digging From Above:'''
If you can find a suitable position above the magma, your miner can dig a [[channel]] while remaining above the level of the magma. Be warned, however, that your dwarves might take the ramp down into the magma channel as a shortcut; preemptively designating the channel for restricted [[traffic]] is recommended.

'''Diagonal Digging:'''
Magma moves more slowly diagonally than orthogonally, giving the miner more time to escape. However, slower flow means you must keep in mind the evaporation. You should dig a smaller channel, wait for it to fill up, and extends the channel by Digging From Above. Workers that dig into a magma reservoir are not instantly killed as the magma touches them, but they are set on fire, which will kill them very quickly. For this reason, taking steps to ensure there is adequate water available to extinguish flaming dwarves running in random directions is advised before digging into any magma pools from the side. Channeling a single square wide pit across the planned magma pipe one tile away from the wall to breach and filling it with 2/7 water using the [[Activity zone#Pit/Pond|pond zone]] tool is recommended, so the panicking dwarves have no choice but to run through the water, and the water itself turns into an obsidian wall as soon as the magma flows into it.

'''Busy To Leave:'''
[http://www.bay12forums.com/smf/index.php?topic=111883.0]
Dwarves who dig into magma often die not because they are unable to flee but because they choose not to. By ensuring a dwarf has another task waiting (ideally far away) they will immediately move away from the ensuing magma flow.

Simply mine up to the corner of a lava tube and then smooth the last tile. Dig a staircase within a few tiles of the place where you will be breaching that leads up and back into your fortress, this will allow your dwarf to get out before the magma gets him. Now designate the smoothed corner to be carved into a fortification. Now immediately when the dwarf begins to carve the fortification, (and this is the most important part!), designate a bunch of other tiles to be smoothed/carved. It's not important that your dwarves actually smooth, carve, or engrave those tiles, what is important is that your dwarf immediately takes another smooth/carve/engrave task elsewhere in the fortress when they finish the current one. If they do not then they will pause for the briefest of instants as they pick a new task, resulting in their death. If they have the job though, they will instantly turn and head up the staircase, stopping the magma from catching and killing them."

'''Exploit From Below:'''
[http://www.bay12forums.com/smf/index.php?topic=110724.0]
Miners are able to mine out tiles diagonally above them '''even if there is a bridge over their heads'''. First you dig out your magma tunnel to feed magma to wherever in your fort you need it and dig it right up against the volcano pipe. Then you channel a trench against the pipe that can be the width of the tunnel if you wish. Build a magma-safe bridge over the trench, making sure to cover it completely, and then seal off access to the magma tunnel. Dig a new separate path to access the now bridged-over trench. Finally, designate the magma wall '''on the Z level of the magma tunnel''' for mining. Your dwarves will stand in the trench beneath the bridge but will somehow still mine out the squares diagonally above them, causing the magma to flow safely onto the bridge leaving your dwarves unscathed."

Example (use {{k|<}}{{k|>}} to navigate):
<diagram>
<frame type="level" level="0">
Z=0
[%205][%205][%205][%205][%205]╗[#F00]≈≈≈[#]
....[#080]╥[#000][@880][%186][@][#F00]≈≈≈[#]
....[#080][%186][#000][@880][%186][@][#F00]≈≈≈[#]
....[#080]╨[#000][@880][%186][@][#F00]≈≈≈[#]
[%205][%205][%205][%203][%205][%185][#F00]≈≈≈[#]
[%186]X[%186][#F00]≈≈≈[#]
[%200][%205][%188][#F00]≈≈≈[#]
</frame>
<frame type=level level=1>
Z=1
[#F00]≈≈≈[#]
[#F00]≈≈≈[#]
[#F00]≈≈≈[#]
[#F00]≈≈≈[#]
[%205][%205][%205][%205][%205][%187][#F00]≈≈≈[#]
....X[%186][#F00]≈≈≈[#]
[%205][%205][%205][%205][%205][%188][#F00]≈≈≈[#]
</frame>
<frame type="level" level="-1">
Z=-1
[%201][%205][%187][#F00]≈≈≈[#]
║▲║[#F00]≈≈≈[#]
║▲║[#F00]≈≈≈[#]
║▲║[#F00]≈≈≈[#]
║.║[#F00]≈≈≈[#]
║X║[#F00]≈≈≈[#]
[%200][%205][%188][#F00]≈≈≈[#]
</frame>
</diagram>

Make sure the top z-level is sealed off from miners and '''[[dig]]''' ({{k|d}}-{{k|d}}) the highlighted tiles on the upper z-level.

== Bringing Magma Up ==

Magma can be brought to the surface by three different methods: [[pump|pump stack]]s, magma pistons, and minecarts. Pump stacks are conceptually the simplest, but require an enormous amount of in-game time to make. Magma pistons tend to be faster to make, but require more time to understand how to build them. Minecarts are a simple solution, but require more management than pump stacks because they can overfill a reservoir.

=== Pump stacks ===
Pumping magma up from the [[magma sea]] via a conventional [[pump#Example layouts#pump stack|pump stack]] is a lot of work, requiring dozens of pumps and significant amounts of power. Making all of the pumps [[magma safe]] also requires a lot of precious materials like iron, or a functioning glass industry.

=== Magma pistons ===
[[Magma piston]]s are another way to move magma near the surface. Magma pistons require less time and fewer precious materials to construct than pump stacks. However, magma pistons are a bit more complicated than pump stacks, so it takes more time to understand how to operate and build them.

=== Minecarts ===
[[Minecart]]s submerged in 7/7 magma (or possibly less, but 2/7 is not enough) will fill with magma. Each minecart holds 2/7 worth of magma, which is subtracted from the amount of magma in the tile. The minecart is then shown as containing magma [833]. Minecarts used for this must be [[magma-safe]].

Minecarts full of magma can be tipped at a track stop, which will pour the magma in a specified direction from the stop. Therefore, the challenge is to get the minecart full of magma to the track stop. There are several ways to accomplish this.

The first task is to separate the minecart from the tile of magma. The obvious way is to build [[roller]]s in magma to pull the minecarts out; such rollers would also need to be magma-safe. Another way would be to drain the magma.

The second task is to move the liberated minecart to the track stop. Tracks can be built from the magma sea to the surface. A minecart track can be operated by dwarves or fully automatic, using powered rollers. Depending on the placement of the track stop, dangerous overflow can be prevented by making the track stop of a material that will melt/burn once the reservoir begins to overflow.

[[Minecart#Impulse ramps|Impulse ramps]] can be used to get magma-filled carts to wherever they need to go without having to provide power to an extensive system of rollers, and will fully automate bringing magma to the surface. Since such systems require comparatively little designation and magma-safe materials, work can be begun much earlier than some other methods of bringing magma to the surface.

==== Design 1 ====
In [http://www.bay12forums.com/smf/index.php?topic=125679.msg4217863#msg4217863 one design] posted to the forums by gchristopher, a pump can provide power to the [[roller]], making the ramp eligible for building the roller, and keeping the trench at 7 magma so the carts fill instantly.

{{diagram|spaces=yes|\
▒▒▒
▒#▒ # {{=}} floor grate
▒%▒ % {{=}} south facing pump
▒%▒▒
▒▲▲▒ Left ramp ▲ has a left-pushing roller
▒▒▒▒ Right ramp ▲ has a retracting bridge
}}

If you drop minecarts in directly from at least 2 z-levels above onto the right ramp, this setup has the magical property that it can handle an arbitrary number of minecarts, and dispense them at a constant controlled rate. Carts are pushed up the left ramp by the roller.

If you extend the right bridge, that tile ceases to be a ramp. Exactly one minecart will fall onto the tile and stay there, and all other minecarts dropped from above will form a quantum pile 1 z-level up.

The last time I [gchristopher] built one, I timed the cart dispensing rate at 1 per 8 ticks. This is slow enough that carts can be brought to the surface using an impulse ramp spiral, but fast enough that you can still quickly cover a large area with magma.

The same design works with water, for giving you a lot of flexibility creating tall waterfalls without pump stacks, quickly and cheaply.

==== Design 2 ====
Rafal99 posted [http://www.bay12forums.com/smf/index.php?topic=109460.msg3374816#msg3374816 another design] using dwarf-powered [[wheelbarrow]]s to transport the magma-filled minecarts from one minecart stockpile to another.

<pre>
▒ddddd=====S==<<Zccccc Near the surface (top view)
U

▒bbbbb== ==<<Xaaaaa Near the magma (side view)
\7777/

\7777/ - Magma reservoir, with tracks in it and rollers to bring minecart up the ramp
U - Here we want magma
aabbccdd - Stockpiles accepting minecarts
===<< - Track and rollers
S - Track stop, set to lowest friction (so it doesn't stop the minecart), set to dump the contents into the U
XZ - Track stops set to dump their contents to the left
▒ - Wall to stop minecarts
</pre>

# Empty minecarts are put into stockpile aaaaa.
# There is a hauling route with one stop on X, with assigned vehicle, set to take furniture->minecarts from stockpile aaaaa.
# Empty minecarts are put into the minecart on track stop X, the track stop dumps them to the left, placing them on the rollers.
# Rollers move the empty minecarts into the magma reservoir, they get filled with magma, then the roller on ramp moves them up. They follow the track, then go out of it and stop at the wall; effectively the minecart with magma is being placed in stockpile bbbbb.
# Stockpile ccccc is set to take from stockpile bbbbb and has assigned 3 wheelbarrows. Dwarves safely transport the minecarts with magma inside wheelbarrows up to the surface into stockpile ccccc.
# There is a hauling route with one stop on Z, with assigned vehicle, set to take furniture->minecarts from stockpile ccccc.
# Magma minecarts are put into the minecart on track stop Z, and the track stop dumps them to the left, placing them on the rollers. (Same as in 3.)
# Rollers move the magma minecarts along the track. They pass through the track stop S and dump the magma in the destination point U, then they follow the track, go out of it and stop at the wall; effectively the emptied minecart is being placed in stockpile ddddd.
# Stockpile aaaaa is set to take from stockpile ddddd. Dwarves haul the empty minecarts back underground near the magma into stockpile aaaaa.
Then we go back to start and the whole thing repeats.

==== Design 3: Minimalist magma moving ====

You'll need two magma-safe pumps, a magma-safe wheelbarrow, and at least one magma-safe minecart. If you get lucky, the first dwarven caravan will bring all the tools you need. If not, you can forge your own by melting down the surplus of anvils that caravans carry, or just embark with a couple chunks of iron ore.

{{diagram|spaces=yes|\
sideview
░░░░░░░░░░░░░░░░░░░░░░░
░░░ %% ░░░░░░░░░░░░
░░░░░░░░░░▲%% ░░░░░░░░░
░░░░░░░░░░░░░7777777░░░
}}

# Dig down to the magma sea and channel a tile above the magma
# Build the first pump to pull magma up into a 1x1 room with a ramp (▲)
# Build the second pump to pull the magma out of the 1x1 room and dispose of it (a 3x3 evaporation chamber works fine)
# Designate a garbage dump zone in the 1x1 room and dump all your magma-safe minecarts
# Wait for all the minecarts to be carried down to the dump zone
# Operate pump 1 briefly, then stop it and activate pump 2 briefly (the minecarts should now contain magma)
# Designate a minecart stockpile near your desired magma workshops, and set it to use your magma-safe wheelbarrow
# Unforbid your minecarts and wait for your dwarves to wheelbarrow them up to the stockpile
# Build a dumping track stop to place the magma where you want it
# Create a new hauling route, specify a new stop on the constructed track stop, and assign one of the magma minecarts to the route
# Unassign the cart, and mark it for dumping; once you've emptied all the carts return to step 5

This design is only useful for moving small amounts of magma, but it is simple and flexible. With any luck you can have your topside magma workshops up and running in a year.

==Using magma==
The primary use for magma is to <s>flood your fortress</s> power [[magma smelter]]s, [[magma glass furnace]]s, [[magma kiln]]s, and [[magma forge]]s. To power a building with magma at least one of the external eight squares must be a hole above a square of magma on the level below. Placing one of the workshop's [[impassable tile]]s above the magma conveniently prevents clumsy dwarves from falling in. Magma used for power is not consumed; a single tile of magma can operate the furnace indefinitely.

Other uses for magma include [[obsidian farming]], [[DF2012:Trap_design#Magma_and_fire_traps|trap design]], melting [[ice]], igniting [[fire]]s, and even [[garbage disposal]].

==Properties of magma==
Magma behaves the same way as water with the exception of not being affected by [[pressure]] (except when being moved by a [[screw pump]]) and apparently not showing [[flow]]. Magma will turn into [[obsidian]]<sup>1</sup> if it touches [[water]]. In the game, magma's temperature is {{ct|12000}}. See the list of '''[[magma-safe]]''' materials for more information on what can (or cannot) be safely submerged in magma.

Tiles directly adjacent to magma will be heated to a temperature of {{ct|10075}}, causing revealed unmined tiles to flash with {{Tile|☼|6:4:1}} when placing digging designations and causing unrevealed mining-designated tiles to cancel their designation (with a "warm stone" warning) once they are revealed.

[[Construction]]s ([[wall]]s, [[floor]]s, etc.) of any material can safely contain magma. Non-construction [[building]]s ([[door]]s, [[bridge]]s, [[pump]]s, etc.) that come into contact with magma should be built entirely of [[magma-safe]] materials. Non-magma-safe components will eventually melt and the building will deconstruct. Any [[mechanism]]s likely to come into contact with magma should also be made of magma-safe materials.

<small><sup>1</sup> - specifically, one of the inorganic materials having the [LAVA] tag, selected randomly ''per biome'' during worldgen.</small>

==Dangers of magma==
Any contact with magma results in nearly instant immolation, followed by death if water is not close at hand. Additionally, dropping large items into magma will generate clouds of [[magma mist]] which can set your haulers on fire if you aren't careful. Magma is also home to various fiery creatures which can present a significant threat to unprepared fortresses.

{{D for Dwarf}}

Magma is very well known for being the perfect solution to any problem encountered by dwarves. Giant badger invasion? Pour magma on it. Noble being his usual snotty, useless, arrogant self? Pour magma on it. Door locked due to invaders? Pour magma on it! Flooded your fortress with magma? [[Fun|Congratulations, you just won the game!]]

{{gamedata|{{raw|DF2012:hardcoded_materials.txt|MATERIAL|INORGANIC}}}}
{{Magma FAQ}}

{{Category|Physics}}

Animal trap

2014-07-31T17:38:10Z

Talvieno: Changed quality rating from "Unrated" to "Exceptional" using the rating script

{{Quality|Exceptional|17:38, 31 July 2014 (UTC)}}
{{av}}

'''Animal traps''' are items used by a [[trapper]] to catch [[vermin]]. They are created at a [[carpenter's workshop]] or a [[metalsmith's forge]] by a dwarf with the trapping labor enabled.

Animal traps can be used by ordering one of your trappers to capture a live land animal in the [[kennel]] or [[butcher's shop]] with {{k|q}} then {{k|a}}, or placing an order with the [[manager]] from a [[kennel]] to catch a live land animal, and can also be built by going into the {{k|b}}uild menu, and choosing {{k|m}} to place an animal trap anywhere. In order to catch small animals, after the trap is placed it must be baited ({{k|q}} to select bait type). Bait can be [[fish]], [[meat]], or a large [[gem]] (though gems are currently useless). There is a chance, depending on the [[quality]] of the trap, that it will not spring fast enough to catch the vermin, causing the bait to be lost, and the trap will need to be reset and rebaited, which a trapper dwarf will automatically do on his own. According to [[Main:Toady One|Toady]], the formula for the chance that a trap quality gives you successfully trapping a creature (as opposed to being robbed) is '''50/65/75/85/95/100'''; this means that masterwork traps will never be robbed.

When a vermin is caught in a trap, it will be brought to an animal [[stockpile]] which accepts vermin of that type by a dwarf with the animal [[hauling]] labor enabled. You can remove a vermin from a trap (thus freeing it for re-use) by assigning it to an installed [[cage]]; for doing this to [[vermin#Hateable_vermin|hateable vermin]] you should have a separate cage in a far away place, so as to reduce the chance of dwarves getting unhappy [[thought]]s.

Note that a caught vermin is treated as if it were an item; marking it for [[Activity zone|dumping]] releases it.

== Currently reported bugs ==

* Baiting a trap with meat/fish uses up a whole stack. {{bug|1436}}

{{buildings}}

Animal trap

2014-07-31T17:37:48Z

Talvieno: Removed bug Toady fixed, fixed redlink, removed migration tag. Remove the last bug in the 40.06, it will be fixed at that point.

{{quality|unrated}}{{av}}

'''Animal traps''' are items used by a [[trapper]] to catch [[vermin]]. They are created at a [[carpenter's workshop]] or a [[metalsmith's forge]] by a dwarf with the trapping labor enabled.

Animal traps can be used by ordering one of your trappers to capture a live land animal in the [[kennel]] or [[butcher's shop]] with {{k|q}} then {{k|a}}, or placing an order with the [[manager]] from a [[kennel]] to catch a live land animal, and can also be built by going into the {{k|b}}uild menu, and choosing {{k|m}} to place an animal trap anywhere. In order to catch small animals, after the trap is placed it must be baited ({{k|q}} to select bait type). Bait can be [[fish]], [[meat]], or a large [[gem]] (though gems are currently useless). There is a chance, depending on the [[quality]] of the trap, that it will not spring fast enough to catch the vermin, causing the bait to be lost, and the trap will need to be reset and rebaited, which a trapper dwarf will automatically do on his own. According to [[Main:Toady One|Toady]], the formula for the chance that a trap quality gives you successfully trapping a creature (as opposed to being robbed) is '''50/65/75/85/95/100'''; this means that masterwork traps will never be robbed.

When a vermin is caught in a trap, it will be brought to an animal [[stockpile]] which accepts vermin of that type by a dwarf with the animal [[hauling]] labor enabled. You can remove a vermin from a trap (thus freeing it for re-use) by assigning it to an installed [[cage]]; for doing this to [[vermin#Hateable_vermin|hateable vermin]] you should have a separate cage in a far away place, so as to reduce the chance of dwarves getting unhappy [[thought]]s.

Note that a caught vermin is treated as if it were an item; marking it for [[Activity zone|dumping]] releases it.

== Currently reported bugs ==

* Baiting a trap with meat/fish uses up a whole stack. {{bug|1436}}

{{buildings}}

Entity token

2014-07-27T14:56:55Z

Talvieno: Changed quality rating from "Unrated" to "Fine" using the rating script

{{Quality|Fine|14:56, 27 July 2014 (UTC)}}
{{Migrated_article}}
{{av}}
'''Entity tokens''' define entities, or civilizations, in entity_*.txt files.

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

|-
| {{text anchor|ADVENTURE_TIER}}
| order
| Allows adventure mode for entities with sites. Dwarves, Elves, and Humans take up tier 3, 2, and 1 respectively. Order doesn't need to be maintained; a custom creature can have a tier of 3000 and still work even if it's the only custom creature.
[ADVENTURE_TIER:4]

|-
| {{text anchor|INDIV_CONTROLLABLE}}
|
| Allows the race to be played as an "outsider" in adventure mode. Not having this specified in one of the entities will cause the Adventure mode option to disappear. Note that ADVENTURE_TIER is not required if this token is included, and that this cannot be applied to civilizations that were not in an entity_*.txt file during world gen.

|-
| {{text anchor|CIV_CONTROLLABLE}}
|
| Allows fortress mode. If multiple entities have the CIV_CONTROLLABLE token, than in embark mode the specific civs can be chosen by + or - on the civ list screen (by pressing tab), though it will not state what entity the civs belong to. To check which one, tab to the neighbors screen: the entity's race will be at the top. At least one civilization must have this token.

|-
| {{text anchor|CREATURE}}
| creature
|The type of creature that will inhabit the civilization. If multiple creature types are specified, each civilization will randomly choose one of the creatures.
[CREATURE:DWARF]

|-
| {{text anchor|CREATURE_HFID}}
| integer (or generic token?)
| Found on generated [[angel]] entities. Appears to draw from creatures with this HFID, which associates the entity with a historical figure of the same ID corresponding to a [[deity]].

|}

== Placement ==

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

|-
| {{text anchor|BIOME_SUPPORT}}
|
* [[Biome token|biome]]
* frequency
| Frequency goes from 0 to 10. Higher numbers make the entity more likely to settle there.
[BIOME_SUPPORT:ANY_GRASSLAND:4]

|-
| {{text anchor|START_BIOME}}
| [[Biome token|biome]]
| Birth of the civilization can be performed on this biome.
[START_BIOME:ANY_FOREST]

|-
| {{text anchor|EXCLUSIVE_START_BIOME}}
| [[Biome token|biome]]
| Birth of the civilization only occurs in this biome.
[EXCLUSIVE_START_BIOME:MOUNTAIN]

|-
| {{text anchor|SETTLEMENT_BIOME}}
| [[Biome token|biome]]
| This civ will create small settlements on this biome, not too far from the EXCLUSIVE_START_BIOME. Used for dwarven hillocks.
[SETTLEMENT_BIOME:ANY_GRASSLAND]

|-
| {{text anchor|DEFAULT_SITE_TYPE}}
| site type
| Valid site types are DARK_FORTRESS (π), CAVE (•), CAVE_DETAILED (Ω), TREE_CITY (î), and CITY (#). Also recognizes PLAYER_FORTRESS, and MONUMENT, though these likely will not work. FORTRESS is no longer a valid entry, instead castles are controlled by BUILDS_OUTDOOR_FORTIFICATIONS. Defaults to CITY.
[DEFAULT_SITE_TYPE:CAVE_DETAILED]

|-
| {{text anchor|LIKES_SITE}}
| site type
| Most residents will try to move to this site type, unless already at one.
[LIKES_SITE:CAVE_DETAILED]

|-
| {{text anchor|TOLERATES_SITE}}
| site type
| Some residents will try to move to this site type, unless already at one.
[TOLERATES_SITE:CITY]

|-
| {{text anchor|WORLD_CONSTRUCTION}}
| construction
| Controls which constructions the civ will build on the world map. Valid constructions are ROAD, TUNNEL, BRIDGE, and WALL.
[WORLD_CONSTRUCTION:BRIDGE]
[WORLD_CONSTRUCTION:ROAD]
[WORLD_CONSTRUCTION:TUNNEL]
[WORLD_CONSTRUCTION:WALL]

|}

== Population ==

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

|-
| {{text anchor|START_GROUP_NUMBER}}
| number
| Number of breeding couples to start with per entity. Helps give a boost to weaker civs by giving them more cannon fodder at the beginning of their histories, and better genetic diversity (if that's modeled for that particular creature). Note that single-gender (e.g. [FEMALE], [MALE], [NO_GENDER]) creatures will not have breeding couples, so a civilization with only these creatures will not be very likely to survive. As of 40d, although many had problems getting such civilizations to survive, there are those who have demonstrably and repeatedly done so. Presumably if the civ-stating code can't place breeding couples, it doesn't start the civ. However, because the children never grow up, the civ is limited to its original individuals).
[START_GROUP_NUMBER:10]

|-
| {{text anchor|MAX_POP_NUMBER}}
| number
| Max population '''per entity'''. Multiply this by max starting civ to get the total population of the species. Defaults to 500.
[MAX_POP_NUMBER:500]

|-
| {{text anchor|MAX_SITE_POP_NUMBER}}
| number
| Max population per individual site. Generic site types will not hold any more than this number of entities. Must be at least 80 for towns to be generated. In general, lower pop numbers mean more sprawl, and higher numbers mean more needing to crawl when entering town stores, which are not affected by this cap. Defaults to 50.
[MAX_SITE_POP_NUMBER:200]

|-
| {{text anchor|MAX_STARTING_CIV_NUMBER}}
| number
| Max number of entities to spawn at world generation. Worldgen picks civs in some sequential order from the raws. Once it reaches the end of the list, it will begin again at the top. Setting this number lower than 100, like say, 7, will cause worldgen to skip over this civ for placement if there are already 7 civs of this type. Note that if all civs are set to lower numbers, and the number of starting civs is set higher than the maximum possible amount of civs in total, it will gracefully stop placing civs and get down to the history aspect of worldgen. Defaults to 3.
[MAX_STARTING_CIV_NUMBER:3]

|}

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

|-
| {{text anchor|PERMITTED_BUILDING}}
| building name
| The named, custom building can be built by a civilization in Fortress Mode.
[PERMITTED_BUILDING:SOAP_MAKER]

|-
| {{text anchor|PERMITTED_JOB}}
| [[Unit type token|profession]]
| Allows this job type to be selected. This applies to worldgen creatures, in the embark screen, and in play. Certain professions also influence the availability of materials for trade.
[PERMITTED_JOB:MINER]

|-
| {{text anchor|PERMITTED_REACTION}}
| reaction name
| Allows this reaction to be used by a civilization. It is used primarily in Fortress Mode, but also allow certain resources, such as [[steel]], to be available to a race. When creating custom reactions, this token MUST be present or the player will not be able to use the reaction in Fortress Mode.
[PERMITTED_REACTION:TAN_A_HIDE]

|-
| {{text anchor|CURRENCY_BY_YEAR}}
|
| Causes the civ's currency to be numbered with the year it was minted.

|-
| {{text anchor|CURRENCY}}
|
* inorganic material
* value
| What kind of metals the civ uses for coin minting as well as the value of the coin.
[CURRENCY:SILVER:5]

|-
| {{text anchor|ART_FACET_MODIFIER}}
|
* type
* number
| OWN_RACE, FANCIFUL, EVIL, GOOD
Number goes from 0 to 25600 where 256 is the default.
[ART_FACET_MODIFIER:OWN_RACE:512]

|-
| {{text anchor|ART_IMAGE_ELEMENT_MODIFIER}}
|
* item
* number
| CREATURE, PLANT, TREE, SHAPE, ITEM<br />0-25600

Determines the chance of each image occurring in that entity's artwork, such as engravings and on artifacts, for default (non-historical) artwork.

[ART_IMAGE_ELEMENT_MODIFIER:TREE:512]

|-
| {{text anchor|ITEM_IMPROVEMENT_MODIFIER}}
|
* item
* number
| ART_IMAGE, COVERED or GLAZED, RINGS_HANGING, BANDS, SPIKES, ITEMSPECIFIC, THREAD, CLOTH, SEWN_IMAGE<br />0-25600

Determines the chance of the entity using that particular artwork method, such as "encircled with bands" or "menaces with spikes".

[ITEM_IMPROVEMENT_MODIFIER:SPIKES:0]

This also seems to change the amount that the entity will pay for items that are improved in the ways in their tokens.

|-
| {{text anchor|TRANSLATION}}
| language
| What language raw the entity uses.
* If an entity lacks this tag, translations appear to be drawn randomly from all translation files{{verify}}.
[TRANSLATION:DWARF]

|-
| {{text anchor|SELECT_SYMBOL}}
|
* noun
* symbol
| ALL, REMAINING, CIV, SITE, VESSEL, RELIGION, MILITARY_UNIT, TEMPLE, WAR, BATTLE, SIEGE, ROAD, BRIDGE, TUNNEL, WALL
Causes the entity to more often use these symbols in the particular SYM set.
[SELECT_SYMBOL:ALL:PEACE]

|-
| {{text anchor|SUBSELECT_SYMBOL}}
|
* noun
* symbol
| Causes the symbol set to be prefered as adjectives by the civilization. Used in vanilla to put violent names in sieges and batttles.
[SELECT_SYMBOL:SIEGE:NAME_SIEGE]
[SUBSELECT_SYMBOL:SIEGE:VIOLENT]

|-
| {{text anchor|CULL_SYMBOL}}
|
* noun
* symbol
| Causes the entity to not use the words in these SYM sets.
[CULL_SYMBOL:ALL:UGLY]

|-
| {{text anchor|FRIENDLY_COLOR}}
| see [[color]]
|
The color of this entity's civilization settlements in the world gen and embark screens. Defaults to 7:0:1.
[FRIENDLY_COLOR:1:0:1]

|}

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

|-
| {{text anchor|RELIGION}}
| type
|
* REGIONAL_FORCE: The creatures will worship a single force associated with their spheres. Currently hardcoded to only be associated with rivers and nature.
* PANTHEON: The creatures will worship a group of gods, each aligned with their spheres and other appropriate ones as well.

[RELIGION:PANTHEON]

|-
| {{text anchor|RELIGION_SPHERE}}
| sphere
| Can by any available [[Sphere]]. Multiple entries are possible. Choosing a religious sphere will automatically make its opposing sphere not possible for the species to have: adding WATER, for example, means the species will never get FIRE as a religious sphere.

[RELIGION_SPHERE:FORTRESSES]

|-
| {{text anchor|SPHERE_ALIGNMENT}}
|
* type
* number
|
This token forces an entity to favor or disfavor particular religious spheres, causing them to acquire those spheres more often when generating a pantheon.

[SPHERE_ALIGNMENT:TREES:512]

|}

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

|-
| {{text anchor|POSITION}}
| string
| Defines a leader/noble position for a civilization. These replace previous tags such as [MAYOR] and [CAN_HAVE_SITE_LEADER] and so on. To define a position further, see [[Position token]].

|-
| {{text anchor|LAND_HOLDER_TRIGGER}}
|
* land holder number
* population
* wealth exported
* created wealth
| Defines when a particular land-holding noble (baron, count, duke in vanilla) will arrive at a fortress.

|-
| {{text anchor|SITE_VARIABLE_POSITIONS}}
| Position responsibility or ALL
| Allows a site responsibility to be taken up by a dynamically generated position (usually lord). Also appears to cause site disputes.{{Verify}}

|-
| {{text anchor|VARIABLE_POSITIONS}}
| Position responsibility or ALL
| Allows a responsibility to be taken up by a dynamically generated position (such as Law-maker).

|}

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

|-
| {{text anchor|ETHIC}}
|
*behavior
*reaction
| Sets the civ's view of [[ethic]]s (certain behaviors), from capital punishment to completely acceptable. This also causes the civ to look upon opposing ethics with disfavor, if their reaction to it is opposing, and when at extremes (one ACCEPTABLE, another civ UNTHINKABLE for example) they will often go to war over it.
[ETHIC:EAT_SAPIENT_KILL:ACCEPTABLE]

|-
| {{text anchor|VALUE}}
|
*value
*number
| Sets the civ's cultural values. Numbers range from -50 (completely anathema) to 0 (neutral) to 50 (highly valued).
[VALUE:CRAFTSMANSHIP:50]

|-
| {{text anchor|WILL_ACCEPT_TRIBUTE}}
|
| Makes the civ's traders accept offered goods.

|-
| {{text anchor|WANDERER}}, {{text anchor|BEAST_HUNTER}}, {{text anchor|SCOUT}}
|
| The civ will send out these sorts of adventurers in worldgen. This seems to increase Tracker skill.

|-
| {{text anchor|ABUSE_BODIES}}
|
| The civilization will mutilate bodies when they are the victors in history-gen warfare, such as hanging bodies from trees, putting them on spikes, and so forth. Adventurers killed in Adventurer mode will sometimes be impaled on spikes wherever they died, with or without this token, and regardless of whether they actually antagonized the townspeople.

|-
| {{text anchor|ACTIVE_SEASON}}
| season
| the season when the civ is most active: when they will trade, interact with you via diplomats, and/or invade you. Civs can have multiple season entries. Note: If multiple caravans arrive at the same time, you are able to select which civ to trade with at the depot menu. ACTIVE_SEASON tags may be changed for a currently active fort.
[ACTIVE_SEASON:AUTUMN]

|-
| {{text anchor|AMBUSHER}}
|
| When invading sneaks around and shoots at straggling members of your society. They will spawn on the edge of the map and will only be visible when one of their party are spotted; this can be quite dangerous to undefended trade depots.

|-
| {{text anchor|AT_PEACE_WITH_WILDLIFE}}
|
| Will not attack wildlife, and will not be attacked by them, even if you have them in your party. This can be somewhat disconcerting when attacked by bears in the forest and your elven ally sits back and does nothing.

|-
| {{text anchor|BABYSNATCHER}}
|
| Sends thieves to steal babies. Also sends ambush parties to harass your civilization. Without this tag, enemy civs will only siege, and will siege as early as they would otherwise babysnatch. This can happen as early as the first year of the fort! In addition, babysnatcher civs will snatch children during worldgen, allowing them to become part of the civ if they do not escape.

Note: If the playable civ in Fortress Mode has this tag (i.e. you add BABYSNATCHER to the Dwarf entity) then the roles will be reversed and elves and humans will siege and ambush and goblins will trade with you.

|-
| {{text anchor|BUILDS_OUTDOOR_FORTIFICATIONS}}
|
| Makes the civilization build castles.

|-
| {{text anchor|BUILDS_OUTDOOR_TOMBS}}
|
| Makes the civilization build tombs.

|-
| {{text anchor|BANDITRY}}
| percentage
| Sets a percentage of the entity population to be used as bandits.

|-
| {{text anchor|DIPLOMAT_BODYGUARDS}}
|
| Visiting diplomats are accompanied by a pair of soldiers. Does not work due to a bug.{{bug|5854}}

|-
| {{text anchor|GENERATED}}
|
| Found on generated divine "HF Guardian Entities". Cannot be used in user-defined raws.

|-
| {{text anchor|INVADERS_IGNORE_NEUTRALS}}
|
| Causes invaders to ignore visiting caravans and other neutral creatures.{{verify}}

|-
| {{text anchor|ITEM_THIEF}}
|
| Sends thieves to steal items. This will also occur in history generation, and thieves will have the "thief" profession. Items stolen in history gen will be scattered around that creature's home.

|-
| {{text anchor|LOCAL_BANDITRY}}
|
| Causes the entity to send out patrols that can ambush adventurers. Will cause cities to be hostile to adventurers whenever they enter, regardless of race or nationality. Adding this tag to playable entities will also make adventurers with this token willing to move-attack non-hostile villagers, rather than having to make an aimed attack.

|-
| {{text anchor|MERCHANT_BODYGUARDS}}
|
| Caravan merchants are accompanied by soldiers.

|-
| {{text anchor|MERCHANT_NOBILITY}}
|
| Effect unknown - in previous versions, this resulted in the civ having a Guild Representative / Merchant Baron / Merchant Prince, but now this is controlled solely by positions.

|-
| {{text anchor|PROGRESS_TRIGGER_POPULATION}}
| level
| 0 to 5, civ will come to site once population at site has reached that level. If multiple progress triggers exist for a civ, it will come when any one of them is fulfilled instead of waiting for all of them to be reached. A value of 0 disables the trigger. 1 corresponds to 20 dwarves, 2 to 50 dwarves, 3 to 80, 4 to 110, and 5 to 140. Progress triggers may be changed, added, or deleted for a currently active fort. Note: hostile civs require that the population trigger be fulfilled as well as at least one other trigger before attacking.

|-
| {{text anchor|PROGRESS_TRIGGER_PRODUCTION}}
| level
| 0 to 5, civ will come to site once created wealth has reached that level. If multiple progress triggers exist for a civ, it will come when any one of them is fulfilled instead of waiting for all of them to be reached. A value of 0 disables the trigger. 1 corresponds to 5000☼ created wealth, 2 to 25000☼, 3 to 100000☼, 4 to 200000☼, and 5 to 300000☼. Progress triggers may be changed, added, or deleted for a currently active fort.

|-
| {{text anchor|PROGRESS_TRIGGER_TRADE}}
| level
| 0 to 5, civ will come to site once exported goods has reached that level. If multiple progress triggers exist for a civ, it will come when any one of them is fulfilled instead of waiting for all of them to be reached. A value of 0 disables the trigger. 1 corresponds to 500☼ exported wealth, 2 to 2500☼, 3 to 10000☼, 4 to 20000☼, and 5 to 30000☼. Progress triggers may be changed, added, or deleted for a currently active fort.

|-
| {{text anchor|PROGRESS_TRIGGER_POP_SIEGE}}
| level
| 0 to 5, civ will begin to send sieges against the player civ when this level is reached if it is hostile.

If multiple progress triggers exist for a civ, it will come when any one of them is fulfilled instead of waiting for all of them to be reached. A value of 0 disables the trigger.

|-
| {{text anchor|PROGRESS_TRIGGER_PROD_SIEGE}}
| level
| 0 to 5, civ will begin to send sieges against the player civ when this level is reached if it is hostile.

|-
| {{text anchor|PROGRESS_TRIGGER_TRADE_SIEGE}}
| level
| 0 to 5, civ will begin to send sieges against the player civ when this level is reached if it is hostile.

|-
| {{text anchor|SIEGER}}
|
| Will start campfires and wait around at the edge of your map for a month or two before rushing in to attack.

|-
| {{text anchor|SITE_GUARDIAN}}
|
| Guards certain special sites, such as a [[vault]] belonging to a [[demon]] allied with a [[deity]]. Used in generated divine entities.

|-
| {{text anchor|SKULKING}}
|
| This makes the severity of attacks depend on the extent of item/baby thievery rather than the passage of time. Makes trade impossible with the related civilization.

|-
| {{text anchor|TREE_CAP_DIPLOMACY}}
|
| Visiting diplomats impose tree cutting quotas; without this, they will simply compliment your fortress and leave. Also causes the diplomat to make unannounced first contact at the very beginning of the first Spring after your fortress becomes a Barony.

|-
| {{text anchor|LAYER_LINKED}}
|
| Defines if a civilization is a hidden subterranean entity, such as batman civilizations.

|-
| {{text anchor|UNDEAD_CANDIDATE}}
|
| Unknown. Possibly makes this creature available as a "Corpse" (e.g. Human Corpse) for necromancers in adventure mode.

|}

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

|-
| {{text anchor|AMMO}}
| item token
|
[AMMO:ITEM_AMMO_BOLTS]

|-
| {{text anchor|ARMOR}}
|
* item token
* rarity
|Rarity is optional. Permitted rarity values are RARE, UNCOMMON, FORCED (anything else is treated as COMMON).
[ARMOR:ITEM_ARMOR_PLATEMAIL:COMMON]

|-
| {{text anchor|DIGGER}}
| item token
|
[DIGGER:ITEM_WEAPON_PICK]

|-
| {{text anchor|GLOVES}}
|
* item token
* rarity
| Rarity is optional. Permitted rarity values are RARE, UNCOMMON, FORCED (anything else is treated as COMMON).
[GLOVES:ITEM_GLOVES_GLOVES:COMMON]

|-
| {{text anchor|HELM}}
|
* item token
* rarity
| Rarity is optional. Permitted rarity values are RARE, UNCOMMON, FORCED (anything else is treated as COMMON).
[HELM:ITEM_HELM_HELM:COMMON]

|-
| {{text anchor|INSTRUMENT}}
| item token
|
[INSTRUMENT:ITEM_INSTRUMENT_FLUTE]

|-
| {{text anchor|PANTS}}
|
* item token
* rarity
| Rarity is optional. Permitted rarity values are RARE, UNCOMMON, FORCED (anything else is treated as COMMON).
[PANTS:ITEM_PANTS_PANTS:COMMON]

|-
| {{text anchor|SHIELD}}
| item token
|
[SHIELD:ITEM_SHIELD_SHIELD]

|-
| {{text anchor|SHOES}}
|
* item token
* rarity
| Rarity is optional. Permitted rarity values are RARE, UNCOMMON, FORCED (anything else is treated as COMMON).
[SHOES:ITEM_SHOES_SHOES:COMMON]

|-
| {{text anchor|SIEGEAMMO}}
| item token
|
[SIEGEAMMO:ITEM_SIEGEAMMO_BALLISTA]

|-
| {{text anchor|TOOL}}
| item token
|
[TOOL:ITEM_TOOL_NEST_BOX]

|-
| {{text anchor|TOY}}
| item token
|
[TOY:ITEM_TOY_PUZZLEBOX]

|-
| {{text anchor|TRAPCOMP}}
| item token
|
[TRAPCOMP:ITEM_TRAPCOMP_GIANTAXEBLADE]

|-
| {{text anchor|WEAPON}}
| item token
|
[WEAPON:ITEM_WEAPON_AXE_BATTLE]

|-
| {{text anchor|USE_ANIMAL_PRODUCTS}}
|
| Allows civilization to use products made from animals. All relevant creatures will be able to provide wool, silk, and extracts (including milk and venom) for trade, and non-sentient creatures (unless ethics state otherwise) will be able to provide eggs, caught fish, meat, leather, bone, shell, pearl, horn, and ivory.

|-
| {{text anchor|USE_ANY_PET_RACE}}
|
| Any creature in the civilization's list of usables (from the surrounding 7x7 or so of squares and map features in those squares) which has PET or PET_EXOTIC will be available as a pet, pack animal (with PACK_ANIMAL), wagon puller (with WAGON_PULLER), mount (with MOUNT or MOUNT_EXOTIC), or siege minion (with TRAINABLE_WAR and ''without'' CAN_LEARN). This notion of the initial usable creature list, which then gets pared down or otherwise considered, applies below as well. All common domestic and equipment creatures are also added to the initial list.

|-
| {{text anchor|USE_CAVE_ANIMALS}}
|
| If they don't have it, creatures with exclusively subterranean biomes are skipped. If they have it, cave creatures with PET will also be available as pets, pack animals (with PACK_ANIMAL), wagon pullers (with WAGON_PULLER), mounts (with MOUNT or MOUNT_EXOTIC), and siege minions (with TRAINABLE_WAR and ''without'' CAN_LEARN).

|-
| {{text anchor|USE_EVIL_ANIMALS}}
|
| Don't have it -> EVIL creatures skipped. If they have it, evil creatures with SLOW_LEARNER or ''without'' CAN_LEARN will be also available as pets (with PET), pack animals (with PACK_ANIMAL), wagon pullers (with WAGON_PULLER), mounts (with MOUNT or MOUNT_EXOTIC), and siege minions (with TRAINABLE_WAR or SLOW_LEARNER).

|-
| {{text anchor|USE_EVIL_PLANTS}}
|
| As EVIL creatures for all uses of plants.

|-
| {{text anchor|USE_EVIL_WOOD}}
|
| As EVIL creatures for all uses of wood.

|-
| {{text anchor|USE_GOOD_ANIMALS}}
|
| Don't have it -> GOOD creatures skipped. If they have it, good creatures ''without'' CAN_LEARN will also be available as pets (with PET), pack animals (with PACK_ANIMAL), wagon pullers (with WAGON_PULLER), mounts (with MOUNT or MOUNT_EXOTIC), and siege minions (with TRAINABLE_WAR).

|-
| {{text anchor|USE_GOOD_PLANTS}}
|
| As GOOD creatures for all uses of plants.

|-
| {{text anchor|USE_GOOD_WOOD}}
|
| As GOOD creatures for all uses of wood.

|-
| {{text anchor|USE_MISC_PROCESSED_WOOD_PRODUCTS}}
|
| If the relevant professions are permitted, controls availability of lye (LYE_MAKING), charcoal (BURN_WOOD), and potash (POTASH_MAKING).

|-
| {{text anchor|COMMON_DOMESTIC_MOUNT}}
|
| Gives the civilization access to creatures with COMMON_DOMESTIC and MOUNT. Additionally, all available (based on USE_ANY_PET_RACE, USE_CAVE_ANIMALS, USE_GOOD_ANIMALS, and USE_EVIL_ANIMALS) creature with MOUNT and PET will be allowed for use as mounts during combat.

|-
| {{text anchor|COMMON_DOMESTIC_PACK}}
|
| Gives the civilization access to creatures with COMMON_DOMESTIC and PACK_ANIMAL. Additionally, all available (see above) creatures with PACK_ANIMAL and PET will be allowed for use during trade as pack animals.

|-
| {{text anchor|COMMON_DOMESTIC_PET}}
|
| Gives the civilization access to creatures with COMMON_DOMESTIC and PET. Additionally, all available (see above) creatures with PET will be allowed for use as pets.

|-
| {{text anchor|COMMON_DOMESTIC_PULL}}
|
| Gives the civilization access to creatures with COMMON_DOMESTIC and WAGON_PULLER. Additionally, all available (see above) creatures with WAGON_PULLER and PET will be allowed for use during trade to pull [[wagon]]s.

|-
| {{text anchor|RIVER_PRODUCTS}}
|
| Allow civ to use river products in the goods it has available for trade.

|-
| {{text anchor|OCEAN_PRODUCTS}}
|
| Allow civ to use ocean products (including [[amber]] and [[coral]]) in the goods it has available for trade. Without OCEAN_PRODUCTS, civilizations will not be able to trade ocean fish even if they are ''also'' available from other sources (e.g. [[sturgeon]]s and [[stingray]]s).

|-
| {{text anchor|INDOOR_FARMING}}
|
| Allow civ to use underground plant products in the goods it has available for trade.

|-
| {{text anchor|OUTDOOR_FARMING}}
|
| Allow civ to use outdoor plant products in the goods it has available for trade.

|-
| {{text anchor|INDOOR_GARDENS}}
|
| Allow civ to use underground plant growths (quarry bush leaves in unmodded games) in the goods it has available for trade.

|-
| {{text anchor|OUTDOOR_GARDENS}}
|
| Allow civ to use outdoor plant growths in the goods it has available for trade.

|-
| {{text anchor|OUTDOOR_ORCHARDS}}
|
| Allows civ to use outdoor tree growths in the goods it has available for trade.

|-
| {{text anchor|CLOTHING}}
|
| Civ members will attempt to wear clothing.

|-
| {{text anchor|SUBTERRANEAN_CLOTHING}}
|
| Will wear things made of spider silk and other subterranean materials.

|-
| {{text anchor|EQUIPMENT_IMPROVEMENTS}}
|
| Adds decorations to equipment based on the level of the generated unit. Also improves item quality.

|-
| {{text anchor|IMPROVED_BOWS}}
|
| Adds decorations to weapons generated for bowman and master bowman. An elf hack.

|-
| {{text anchor|METAL_PREF}}
|
| Allows metal materials to be used to make cages (inexpensive metals only) and crafts.

|-
| {{text anchor|STONE_PREF}}
|
| Allows the civilization to make use of nearby stone types. If the FURNACE_OPERATOR job is permitted, also allows ore-bearing stones to be smelted into metals.

|-
| {{text anchor|WOOD_WEAPONS}}
|
| The civilization can make traditionally metallic weapons such as swords and spears from wood. An elf hack.

|-
| {{text anchor|WOOD_ARMOR}}
|
| The civilization can make traditionally metallic armor such as mail shirts and helmets from wood. An elf hack.

|-
| {{text anchor|GEM_PREF}}
|
| Enables creatures of this entity to bring gems in trade.

|-
| {{text anchor|INDOOR_WOOD}}
|
| Allow civ to use subterranean wood types, such as tower-cap and fungiwood logs.

|-
| {{text anchor|OUTDOOR_WOOD}}
|
| Allow civ to use outdoor wood types, such as mangrove and oak.

|-
| {{text anchor|GEM_SHAPE}}
| [[Descriptor shape token|shape]]
| Precious gems cut by this civilization's jewelers can be of this shape.

|-
| {{text anchor|STONE_SHAPE}}
| [[Descriptor shape token|shape]]
| Ordinary non-gem stones cut by this civilization's jewelers can be of this shape.

|-
| {{text anchor|DIVINE_MAT_CLOTH}}
|
| Allows civ to use materials with [DIVINE] for clothing. Used for generated divine entities.

|-
| {{text anchor|DIVINE_MAT_WEAPONS}}
|
| Allows civ to use metals with [DIVINE] for weapons. Used for generated divine entities.

|-
| {{text anchor|DIVINE_MAT_ARMOR}}
|
| Allows civ to use metals with [DIVINE] for armour. Used for generated divine entities.

|}

== Tissue Styling Related Tokens ==
{| {{prettytable}}
|- bgcolor="#ddd"
! Token
! Arguments
! Description

|-
| {{text anchor|TISSUE_STYLE}}
| tissue style unit ID
| Select tissue layer which have the ID attached using TISSUE_STYLE_UNIT token in unit raws. This allows setting further cultural style parameters for selected tissue layer.

|-
| {{text anchor|TS_MAINTAIN_LENGTH}}
|
* minimum length?
* maximum length?
| Presumably sets culturally preferred tissue length for selected tissue. Needs testing.
Dwarves have their beards set to 100:NONE by default.

|-
| {{text anchor|TS_PREFERRED_SHAPING}}
| styling token
| Valid tokens are NEATLY_COMBED, BRAIDED, DOUBLE_BRAIDS, PONY_TAILS, CLEAN_SHAVEN and STANDARD_HAIR/BEARD/MOUSTACHE/SIDEBURNS_SHAPINGS.
Presumably sets culturally preferred tissue shapings for selected tissue. Needs testing.

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

Entity token

2014-07-27T14:56:11Z

Talvieno: Undo revision 208272 by Talvieno (talk)

{{Migrated_article}}
{{quality|unrated}}{{av}}
'''Entity tokens''' define entities, or civilizations, in entity_*.txt files.

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

|-
| {{text anchor|ADVENTURE_TIER}}
| order
| Allows adventure mode for entities with sites. Dwarves, Elves, and Humans take up tier 3, 2, and 1 respectively. Order doesn't need to be maintained; a custom creature can have a tier of 3000 and still work even if it's the only custom creature.
[ADVENTURE_TIER:4]

|-
| {{text anchor|INDIV_CONTROLLABLE}}
|
| Allows the race to be played as an "outsider" in adventure mode. Not having this specified in one of the entities will cause the Adventure mode option to disappear. Note that ADVENTURE_TIER is not required if this token is included, and that this cannot be applied to civilizations that were not in an entity_*.txt file during world gen.

|-
| {{text anchor|CIV_CONTROLLABLE}}
|
| Allows fortress mode. If multiple entities have the CIV_CONTROLLABLE token, than in embark mode the specific civs can be chosen by + or - on the civ list screen (by pressing tab), though it will not state what entity the civs belong to. To check which one, tab to the neighbors screen: the entity's race will be at the top. At least one civilization must have this token.

|-
| {{text anchor|CREATURE}}
| creature
|The type of creature that will inhabit the civilization. If multiple creature types are specified, each civilization will randomly choose one of the creatures.
[CREATURE:DWARF]

|-
| {{text anchor|CREATURE_HFID}}
| integer (or generic token?)
| Found on generated [[angel]] entities. Appears to draw from creatures with this HFID, which associates the entity with a historical figure of the same ID corresponding to a [[deity]].

|}

== Placement ==

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

|-
| {{text anchor|BIOME_SUPPORT}}
|
* [[Biome token|biome]]
* frequency
| Frequency goes from 0 to 10. Higher numbers make the entity more likely to settle there.
[BIOME_SUPPORT:ANY_GRASSLAND:4]

|-
| {{text anchor|START_BIOME}}
| [[Biome token|biome]]
| Birth of the civilization can be performed on this biome.
[START_BIOME:ANY_FOREST]

|-
| {{text anchor|EXCLUSIVE_START_BIOME}}
| [[Biome token|biome]]
| Birth of the civilization only occurs in this biome.
[EXCLUSIVE_START_BIOME:MOUNTAIN]

|-
| {{text anchor|SETTLEMENT_BIOME}}
| [[Biome token|biome]]
| This civ will create small settlements on this biome, not too far from the EXCLUSIVE_START_BIOME. Used for dwarven hillocks.
[SETTLEMENT_BIOME:ANY_GRASSLAND]

|-
| {{text anchor|DEFAULT_SITE_TYPE}}
| site type
| Valid site types are DARK_FORTRESS (π), CAVE (•), CAVE_DETAILED (Ω), TREE_CITY (î), and CITY (#). Also recognizes PLAYER_FORTRESS, and MONUMENT, though these likely will not work. FORTRESS is no longer a valid entry, instead castles are controlled by BUILDS_OUTDOOR_FORTIFICATIONS. Defaults to CITY.
[DEFAULT_SITE_TYPE:CAVE_DETAILED]

|-
| {{text anchor|LIKES_SITE}}
| site type
| Most residents will try to move to this site type, unless already at one.
[LIKES_SITE:CAVE_DETAILED]

|-
| {{text anchor|TOLERATES_SITE}}
| site type
| Some residents will try to move to this site type, unless already at one.
[TOLERATES_SITE:CITY]

|-
| {{text anchor|WORLD_CONSTRUCTION}}
| construction
| Controls which constructions the civ will build on the world map. Valid constructions are ROAD, TUNNEL, BRIDGE, and WALL.
[WORLD_CONSTRUCTION:BRIDGE]
[WORLD_CONSTRUCTION:ROAD]
[WORLD_CONSTRUCTION:TUNNEL]
[WORLD_CONSTRUCTION:WALL]

|}

== Population ==

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

|-
| {{text anchor|START_GROUP_NUMBER}}
| number
| Number of breeding couples to start with per entity. Helps give a boost to weaker civs by giving them more cannon fodder at the beginning of their histories, and better genetic diversity (if that's modeled for that particular creature). Note that single-gender (e.g. [FEMALE], [MALE], [NO_GENDER]) creatures will not have breeding couples, so a civilization with only these creatures will not be very likely to survive. As of 40d, although many had problems getting such civilizations to survive, there are those who have demonstrably and repeatedly done so. Presumably if the civ-stating code can't place breeding couples, it doesn't start the civ. However, because the children never grow up, the civ is limited to its original individuals).
[START_GROUP_NUMBER:10]

|-
| {{text anchor|MAX_POP_NUMBER}}
| number
| Max population '''per entity'''. Multiply this by max starting civ to get the total population of the species. Defaults to 500.
[MAX_POP_NUMBER:500]

|-
| {{text anchor|MAX_SITE_POP_NUMBER}}
| number
| Max population per individual site. Generic site types will not hold any more than this number of entities. Must be at least 80 for towns to be generated. In general, lower pop numbers mean more sprawl, and higher numbers mean more needing to crawl when entering town stores, which are not affected by this cap. Defaults to 50.
[MAX_SITE_POP_NUMBER:200]

|-
| {{text anchor|MAX_STARTING_CIV_NUMBER}}
| number
| Max number of entities to spawn at world generation. Worldgen picks civs in some sequential order from the raws. Once it reaches the end of the list, it will begin again at the top. Setting this number lower than 100, like say, 7, will cause worldgen to skip over this civ for placement if there are already 7 civs of this type. Note that if all civs are set to lower numbers, and the number of starting civs is set higher than the maximum possible amount of civs in total, it will gracefully stop placing civs and get down to the history aspect of worldgen. Defaults to 3.
[MAX_STARTING_CIV_NUMBER:3]

|}

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

|-
| {{text anchor|PERMITTED_BUILDING}}
| building name
| The named, custom building can be built by a civilization in Fortress Mode.
[PERMITTED_BUILDING:SOAP_MAKER]

|-
| {{text anchor|PERMITTED_JOB}}
| [[Unit type token|profession]]
| Allows this job type to be selected. This applies to worldgen creatures, in the embark screen, and in play. Certain professions also influence the availability of materials for trade.
[PERMITTED_JOB:MINER]

|-
| {{text anchor|PERMITTED_REACTION}}
| reaction name
| Allows this reaction to be used by a civilization. It is used primarily in Fortress Mode, but also allow certain resources, such as [[steel]], to be available to a race. When creating custom reactions, this token MUST be present or the player will not be able to use the reaction in Fortress Mode.
[PERMITTED_REACTION:TAN_A_HIDE]

|-
| {{text anchor|CURRENCY_BY_YEAR}}
|
| Causes the civ's currency to be numbered with the year it was minted.

|-
| {{text anchor|CURRENCY}}
|
* inorganic material
* value
| What kind of metals the civ uses for coin minting as well as the value of the coin.
[CURRENCY:SILVER:5]

|-
| {{text anchor|ART_FACET_MODIFIER}}
|
* type
* number
| OWN_RACE, FANCIFUL, EVIL, GOOD
Number goes from 0 to 25600 where 256 is the default.
[ART_FACET_MODIFIER:OWN_RACE:512]

|-
| {{text anchor|ART_IMAGE_ELEMENT_MODIFIER}}
|
* item
* number
| CREATURE, PLANT, TREE, SHAPE, ITEM<br />0-25600

Determines the chance of each image occurring in that entity's artwork, such as engravings and on artifacts, for default (non-historical) artwork.

[ART_IMAGE_ELEMENT_MODIFIER:TREE:512]

|-
| {{text anchor|ITEM_IMPROVEMENT_MODIFIER}}
|
* item
* number
| ART_IMAGE, COVERED or GLAZED, RINGS_HANGING, BANDS, SPIKES, ITEMSPECIFIC, THREAD, CLOTH, SEWN_IMAGE<br />0-25600

Determines the chance of the entity using that particular artwork method, such as "encircled with bands" or "menaces with spikes".

[ITEM_IMPROVEMENT_MODIFIER:SPIKES:0]

This also seems to change the amount that the entity will pay for items that are improved in the ways in their tokens.

|-
| {{text anchor|TRANSLATION}}
| language
| What language raw the entity uses.
* If an entity lacks this tag, translations appear to be drawn randomly from all translation files{{verify}}.
[TRANSLATION:DWARF]

|-
| {{text anchor|SELECT_SYMBOL}}
|
* noun
* symbol
| ALL, REMAINING, CIV, SITE, VESSEL, RELIGION, MILITARY_UNIT, TEMPLE, WAR, BATTLE, SIEGE, ROAD, BRIDGE, TUNNEL, WALL
Causes the entity to more often use these symbols in the particular SYM set.
[SELECT_SYMBOL:ALL:PEACE]

|-
| {{text anchor|SUBSELECT_SYMBOL}}
|
* noun
* symbol
| Causes the symbol set to be prefered as adjectives by the civilization. Used in vanilla to put violent names in sieges and batttles.
[SELECT_SYMBOL:SIEGE:NAME_SIEGE]
[SUBSELECT_SYMBOL:SIEGE:VIOLENT]

|-
| {{text anchor|CULL_SYMBOL}}
|
* noun
* symbol
| Causes the entity to not use the words in these SYM sets.
[CULL_SYMBOL:ALL:UGLY]

|-
| {{text anchor|FRIENDLY_COLOR}}
| see [[color]]
|
The color of this entity's civilization settlements in the world gen and embark screens. Defaults to 7:0:1.
[FRIENDLY_COLOR:1:0:1]

|}

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

|-
| {{text anchor|RELIGION}}
| type
|
* REGIONAL_FORCE: The creatures will worship a single force associated with their spheres. Currently hardcoded to only be associated with rivers and nature.
* PANTHEON: The creatures will worship a group of gods, each aligned with their spheres and other appropriate ones as well.

[RELIGION:PANTHEON]

|-
| {{text anchor|RELIGION_SPHERE}}
| sphere
| Can by any available [[Sphere]]. Multiple entries are possible. Choosing a religious sphere will automatically make its opposing sphere not possible for the species to have: adding WATER, for example, means the species will never get FIRE as a religious sphere.

[RELIGION_SPHERE:FORTRESSES]

|-
| {{text anchor|SPHERE_ALIGNMENT}}
|
* type
* number
|
This token forces an entity to favor or disfavor particular religious spheres, causing them to acquire those spheres more often when generating a pantheon.

[SPHERE_ALIGNMENT:TREES:512]

|}

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

|-
| {{text anchor|POSITION}}
| string
| Defines a leader/noble position for a civilization. These replace previous tags such as [MAYOR] and [CAN_HAVE_SITE_LEADER] and so on. To define a position further, see [[Position token]].

|-
| {{text anchor|LAND_HOLDER_TRIGGER}}
|
* land holder number
* population
* wealth exported
* created wealth
| Defines when a particular land-holding noble (baron, count, duke in vanilla) will arrive at a fortress.

|-
| {{text anchor|SITE_VARIABLE_POSITIONS}}
| Position responsibility or ALL
| Allows a site responsibility to be taken up by a dynamically generated position (usually lord). Also appears to cause site disputes.{{Verify}}

|-
| {{text anchor|VARIABLE_POSITIONS}}
| Position responsibility or ALL
| Allows a responsibility to be taken up by a dynamically generated position (such as Law-maker).

|}

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

|-
| {{text anchor|ETHIC}}
|
*behavior
*reaction
| Sets the civ's view of [[ethic]]s (certain behaviors), from capital punishment to completely acceptable. This also causes the civ to look upon opposing ethics with disfavor, if their reaction to it is opposing, and when at extremes (one ACCEPTABLE, another civ UNTHINKABLE for example) they will often go to war over it.
[ETHIC:EAT_SAPIENT_KILL:ACCEPTABLE]

|-
| {{text anchor|VALUE}}
|
*value
*number
| Sets the civ's cultural values. Numbers range from -50 (completely anathema) to 0 (neutral) to 50 (highly valued).
[VALUE:CRAFTSMANSHIP:50]

|-
| {{text anchor|WILL_ACCEPT_TRIBUTE}}
|
| Makes the civ's traders accept offered goods.

|-
| {{text anchor|WANDERER}}, {{text anchor|BEAST_HUNTER}}, {{text anchor|SCOUT}}
|
| The civ will send out these sorts of adventurers in worldgen. This seems to increase Tracker skill.

|-
| {{text anchor|ABUSE_BODIES}}
|
| The civilization will mutilate bodies when they are the victors in history-gen warfare, such as hanging bodies from trees, putting them on spikes, and so forth. Adventurers killed in Adventurer mode will sometimes be impaled on spikes wherever they died, with or without this token, and regardless of whether they actually antagonized the townspeople.

|-
| {{text anchor|ACTIVE_SEASON}}
| season
| the season when the civ is most active: when they will trade, interact with you via diplomats, and/or invade you. Civs can have multiple season entries. Note: If multiple caravans arrive at the same time, you are able to select which civ to trade with at the depot menu. ACTIVE_SEASON tags may be changed for a currently active fort.
[ACTIVE_SEASON:AUTUMN]

|-
| {{text anchor|AMBUSHER}}
|
| When invading sneaks around and shoots at straggling members of your society. They will spawn on the edge of the map and will only be visible when one of their party are spotted; this can be quite dangerous to undefended trade depots.

|-
| {{text anchor|AT_PEACE_WITH_WILDLIFE}}
|
| Will not attack wildlife, and will not be attacked by them, even if you have them in your party. This can be somewhat disconcerting when attacked by bears in the forest and your elven ally sits back and does nothing.

|-
| {{text anchor|BABYSNATCHER}}
|
| Sends thieves to steal babies. Also sends ambush parties to harass your civilization. Without this tag, enemy civs will only siege, and will siege as early as they would otherwise babysnatch. This can happen as early as the first year of the fort! In addition, babysnatcher civs will snatch children during worldgen, allowing them to become part of the civ if they do not escape.

Note: If the playable civ in Fortress Mode has this tag (i.e. you add BABYSNATCHER to the Dwarf entity) then the roles will be reversed and elves and humans will siege and ambush and goblins will trade with you.

|-
| {{text anchor|BUILDS_OUTDOOR_FORTIFICATIONS}}
|
| Makes the civilization build castles.

|-
| {{text anchor|BUILDS_OUTDOOR_TOMBS}}
|
| Makes the civilization build tombs.

|-
| {{text anchor|BANDITRY}}
| percentage
| Sets a percentage of the entity population to be used as bandits.

|-
| {{text anchor|DIPLOMAT_BODYGUARDS}}
|
| Visiting diplomats are accompanied by a pair of soldiers. Does not work due to a bug.{{bug|5854}}

|-
| {{text anchor|GENERATED}}
|
| Found on generated divine "HF Guardian Entities". Cannot be used in user-defined raws.

|-
| {{text anchor|INVADERS_IGNORE_NEUTRALS}}
|
| Causes invaders to ignore visiting caravans and other neutral creatures.{{verify}}

|-
| {{text anchor|ITEM_THIEF}}
|
| Sends thieves to steal items. This will also occur in history generation, and thieves will have the "thief" profession. Items stolen in history gen will be scattered around that creature's home.

|-
| {{text anchor|LOCAL_BANDITRY}}
|
| Causes the entity to send out patrols that can ambush adventurers. Will cause cities to be hostile to adventurers whenever they enter, regardless of race or nationality. Adding this tag to playable entities will also make adventurers with this token willing to move-attack non-hostile villagers, rather than having to make an aimed attack.

|-
| {{text anchor|MERCHANT_BODYGUARDS}}
|
| Caravan merchants are accompanied by soldiers.

|-
| {{text anchor|MERCHANT_NOBILITY}}
|
| Effect unknown - in previous versions, this resulted in the civ having a Guild Representative / Merchant Baron / Merchant Prince, but now this is controlled solely by positions.

|-
| {{text anchor|PROGRESS_TRIGGER_POPULATION}}
| level
| 0 to 5, civ will come to site once population at site has reached that level. If multiple progress triggers exist for a civ, it will come when any one of them is fulfilled instead of waiting for all of them to be reached. A value of 0 disables the trigger. 1 corresponds to 20 dwarves, 2 to 50 dwarves, 3 to 80, 4 to 110, and 5 to 140. Progress triggers may be changed, added, or deleted for a currently active fort. Note: hostile civs require that the population trigger be fulfilled as well as at least one other trigger before attacking.

|-
| {{text anchor|PROGRESS_TRIGGER_PRODUCTION}}
| level
| 0 to 5, civ will come to site once created wealth has reached that level. If multiple progress triggers exist for a civ, it will come when any one of them is fulfilled instead of waiting for all of them to be reached. A value of 0 disables the trigger. 1 corresponds to 5000☼ created wealth, 2 to 25000☼, 3 to 100000☼, 4 to 200000☼, and 5 to 300000☼. Progress triggers may be changed, added, or deleted for a currently active fort.

|-
| {{text anchor|PROGRESS_TRIGGER_TRADE}}
| level
| 0 to 5, civ will come to site once exported goods has reached that level. If multiple progress triggers exist for a civ, it will come when any one of them is fulfilled instead of waiting for all of them to be reached. A value of 0 disables the trigger. 1 corresponds to 500☼ exported wealth, 2 to 2500☼, 3 to 10000☼, 4 to 20000☼, and 5 to 30000☼. Progress triggers may be changed, added, or deleted for a currently active fort.

|-
| {{text anchor|PROGRESS_TRIGGER_POP_SIEGE}}
| level
| 0 to 5, civ will begin to send sieges against the player civ when this level is reached if it is hostile.

If multiple progress triggers exist for a civ, it will come when any one of them is fulfilled instead of waiting for all of them to be reached. A value of 0 disables the trigger.

|-
| {{text anchor|PROGRESS_TRIGGER_PROD_SIEGE}}
| level
| 0 to 5, civ will begin to send sieges against the player civ when this level is reached if it is hostile.

|-
| {{text anchor|PROGRESS_TRIGGER_TRADE_SIEGE}}
| level
| 0 to 5, civ will begin to send sieges against the player civ when this level is reached if it is hostile.

|-
| {{text anchor|SIEGER}}
|
| Will start campfires and wait around at the edge of your map for a month or two before rushing in to attack.

|-
| {{text anchor|SITE_GUARDIAN}}
|
| Guards certain special sites, such as a [[vault]] belonging to a [[demon]] allied with a [[deity]]. Used in generated divine entities.

|-
| {{text anchor|SKULKING}}
|
| This makes the severity of attacks depend on the extent of item/baby thievery rather than the passage of time. Makes trade impossible with the related civilization.

|-
| {{text anchor|TREE_CAP_DIPLOMACY}}
|
| Visiting diplomats impose tree cutting quotas; without this, they will simply compliment your fortress and leave. Also causes the diplomat to make unannounced first contact at the very beginning of the first Spring after your fortress becomes a Barony.

|-
| {{text anchor|LAYER_LINKED}}
|
| Defines if a civilization is a hidden subterranean entity, such as batman civilizations.

|-
| {{text anchor|UNDEAD_CANDIDATE}}
|
| Unknown. Possibly makes this creature available as a "Corpse" (e.g. Human Corpse) for necromancers in adventure mode.

|}

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

|-
| {{text anchor|AMMO}}
| item token
|
[AMMO:ITEM_AMMO_BOLTS]

|-
| {{text anchor|ARMOR}}
|
* item token
* rarity
|Rarity is optional. Permitted rarity values are RARE, UNCOMMON, FORCED (anything else is treated as COMMON).
[ARMOR:ITEM_ARMOR_PLATEMAIL:COMMON]

|-
| {{text anchor|DIGGER}}
| item token
|
[DIGGER:ITEM_WEAPON_PICK]

|-
| {{text anchor|GLOVES}}
|
* item token
* rarity
| Rarity is optional. Permitted rarity values are RARE, UNCOMMON, FORCED (anything else is treated as COMMON).
[GLOVES:ITEM_GLOVES_GLOVES:COMMON]

|-
| {{text anchor|HELM}}
|
* item token
* rarity
| Rarity is optional. Permitted rarity values are RARE, UNCOMMON, FORCED (anything else is treated as COMMON).
[HELM:ITEM_HELM_HELM:COMMON]

|-
| {{text anchor|INSTRUMENT}}
| item token
|
[INSTRUMENT:ITEM_INSTRUMENT_FLUTE]

|-
| {{text anchor|PANTS}}
|
* item token
* rarity
| Rarity is optional. Permitted rarity values are RARE, UNCOMMON, FORCED (anything else is treated as COMMON).
[PANTS:ITEM_PANTS_PANTS:COMMON]

|-
| {{text anchor|SHIELD}}
| item token
|
[SHIELD:ITEM_SHIELD_SHIELD]

|-
| {{text anchor|SHOES}}
|
* item token
* rarity
| Rarity is optional. Permitted rarity values are RARE, UNCOMMON, FORCED (anything else is treated as COMMON).
[SHOES:ITEM_SHOES_SHOES:COMMON]

|-
| {{text anchor|SIEGEAMMO}}
| item token
|
[SIEGEAMMO:ITEM_SIEGEAMMO_BALLISTA]

|-
| {{text anchor|TOOL}}
| item token
|
[TOOL:ITEM_TOOL_NEST_BOX]

|-
| {{text anchor|TOY}}
| item token
|
[TOY:ITEM_TOY_PUZZLEBOX]

|-
| {{text anchor|TRAPCOMP}}
| item token
|
[TRAPCOMP:ITEM_TRAPCOMP_GIANTAXEBLADE]

|-
| {{text anchor|WEAPON}}
| item token
|
[WEAPON:ITEM_WEAPON_AXE_BATTLE]

|-
| {{text anchor|USE_ANIMAL_PRODUCTS}}
|
| Allows civilization to use products made from animals. All relevant creatures will be able to provide wool, silk, and extracts (including milk and venom) for trade, and non-sentient creatures (unless ethics state otherwise) will be able to provide eggs, caught fish, meat, leather, bone, shell, pearl, horn, and ivory.

|-
| {{text anchor|USE_ANY_PET_RACE}}
|
| Any creature in the civilization's list of usables (from the surrounding 7x7 or so of squares and map features in those squares) which has PET or PET_EXOTIC will be available as a pet, pack animal (with PACK_ANIMAL), wagon puller (with WAGON_PULLER), mount (with MOUNT or MOUNT_EXOTIC), or siege minion (with TRAINABLE_WAR and ''without'' CAN_LEARN). This notion of the initial usable creature list, which then gets pared down or otherwise considered, applies below as well. All common domestic and equipment creatures are also added to the initial list.

|-
| {{text anchor|USE_CAVE_ANIMALS}}
|
| If they don't have it, creatures with exclusively subterranean biomes are skipped. If they have it, cave creatures with PET will also be available as pets, pack animals (with PACK_ANIMAL), wagon pullers (with WAGON_PULLER), mounts (with MOUNT or MOUNT_EXOTIC), and siege minions (with TRAINABLE_WAR and ''without'' CAN_LEARN).

|-
| {{text anchor|USE_EVIL_ANIMALS}}
|
| Don't have it -> EVIL creatures skipped. If they have it, evil creatures with SLOW_LEARNER or ''without'' CAN_LEARN will be also available as pets (with PET), pack animals (with PACK_ANIMAL), wagon pullers (with WAGON_PULLER), mounts (with MOUNT or MOUNT_EXOTIC), and siege minions (with TRAINABLE_WAR or SLOW_LEARNER).

|-
| {{text anchor|USE_EVIL_PLANTS}}
|
| As EVIL creatures for all uses of plants.

|-
| {{text anchor|USE_EVIL_WOOD}}
|
| As EVIL creatures for all uses of wood.

|-
| {{text anchor|USE_GOOD_ANIMALS}}
|
| Don't have it -> GOOD creatures skipped. If they have it, good creatures ''without'' CAN_LEARN will also be available as pets (with PET), pack animals (with PACK_ANIMAL), wagon pullers (with WAGON_PULLER), mounts (with MOUNT or MOUNT_EXOTIC), and siege minions (with TRAINABLE_WAR).

|-
| {{text anchor|USE_GOOD_PLANTS}}
|
| As GOOD creatures for all uses of plants.

|-
| {{text anchor|USE_GOOD_WOOD}}
|
| As GOOD creatures for all uses of wood.

|-
| {{text anchor|USE_MISC_PROCESSED_WOOD_PRODUCTS}}
|
| If the relevant professions are permitted, controls availability of lye (LYE_MAKING), charcoal (BURN_WOOD), and potash (POTASH_MAKING).

|-
| {{text anchor|COMMON_DOMESTIC_MOUNT}}
|
| Gives the civilization access to creatures with COMMON_DOMESTIC and MOUNT. Additionally, all available (based on USE_ANY_PET_RACE, USE_CAVE_ANIMALS, USE_GOOD_ANIMALS, and USE_EVIL_ANIMALS) creature with MOUNT and PET will be allowed for use as mounts during combat.

|-
| {{text anchor|COMMON_DOMESTIC_PACK}}
|
| Gives the civilization access to creatures with COMMON_DOMESTIC and PACK_ANIMAL. Additionally, all available (see above) creatures with PACK_ANIMAL and PET will be allowed for use during trade as pack animals.

|-
| {{text anchor|COMMON_DOMESTIC_PET}}
|
| Gives the civilization access to creatures with COMMON_DOMESTIC and PET. Additionally, all available (see above) creatures with PET will be allowed for use as pets.

|-
| {{text anchor|COMMON_DOMESTIC_PULL}}
|
| Gives the civilization access to creatures with COMMON_DOMESTIC and WAGON_PULLER. Additionally, all available (see above) creatures with WAGON_PULLER and PET will be allowed for use during trade to pull [[wagon]]s.

|-
| {{text anchor|RIVER_PRODUCTS}}
|
| Allow civ to use river products in the goods it has available for trade.

|-
| {{text anchor|OCEAN_PRODUCTS}}
|
| Allow civ to use ocean products (including [[amber]] and [[coral]]) in the goods it has available for trade. Without OCEAN_PRODUCTS, civilizations will not be able to trade ocean fish even if they are ''also'' available from other sources (e.g. [[sturgeon]]s and [[stingray]]s).

|-
| {{text anchor|INDOOR_FARMING}}
|
| Allow civ to use underground plant products in the goods it has available for trade.

|-
| {{text anchor|OUTDOOR_FARMING}}
|
| Allow civ to use outdoor plant products in the goods it has available for trade.

|-
| {{text anchor|INDOOR_GARDENS}}
|
| Allow civ to use underground plant growths (quarry bush leaves in unmodded games) in the goods it has available for trade.

|-
| {{text anchor|OUTDOOR_GARDENS}}
|
| Allow civ to use outdoor plant growths in the goods it has available for trade.

|-
| {{text anchor|OUTDOOR_ORCHARDS}}
|
| Allows civ to use outdoor tree growths in the goods it has available for trade.

|-
| {{text anchor|CLOTHING}}
|
| Civ members will attempt to wear clothing.

|-
| {{text anchor|SUBTERRANEAN_CLOTHING}}
|
| Will wear things made of spider silk and other subterranean materials.

|-
| {{text anchor|EQUIPMENT_IMPROVEMENTS}}
|
| Adds decorations to equipment based on the level of the generated unit. Also improves item quality.

|-
| {{text anchor|IMPROVED_BOWS}}
|
| Adds decorations to weapons generated for bowman and master bowman. An elf hack.

|-
| {{text anchor|METAL_PREF}}
|
| Allows metal materials to be used to make cages (inexpensive metals only) and crafts.

|-
| {{text anchor|STONE_PREF}}
|
| Allows the civilization to make use of nearby stone types. If the FURNACE_OPERATOR job is permitted, also allows ore-bearing stones to be smelted into metals.

|-
| {{text anchor|WOOD_WEAPONS}}
|
| The civilization can make traditionally metallic weapons such as swords and spears from wood. An elf hack.

|-
| {{text anchor|WOOD_ARMOR}}
|
| The civilization can make traditionally metallic armor such as mail shirts and helmets from wood. An elf hack.

|-
| {{text anchor|GEM_PREF}}
|
| Enables creatures of this entity to bring gems in trade.

|-
| {{text anchor|INDOOR_WOOD}}
|
| Allow civ to use subterranean wood types, such as tower-cap and fungiwood logs.

|-
| {{text anchor|OUTDOOR_WOOD}}
|
| Allow civ to use outdoor wood types, such as mangrove and oak.

|-
| {{text anchor|GEM_SHAPE}}
| [[Descriptor shape token|shape]]
| Precious gems cut by this civilization's jewelers can be of this shape.

|-
| {{text anchor|STONE_SHAPE}}
| [[Descriptor shape token|shape]]
| Ordinary non-gem stones cut by this civilization's jewelers can be of this shape.

|-
| {{text anchor|DIVINE_MAT_CLOTH}}
|
| Allows civ to use materials with [DIVINE] for clothing. Used for generated divine entities.

|-
| {{text anchor|DIVINE_MAT_WEAPONS}}
|
| Allows civ to use metals with [DIVINE] for weapons. Used for generated divine entities.

|-
| {{text anchor|DIVINE_MAT_ARMOR}}
|
| Allows civ to use metals with [DIVINE] for armour. Used for generated divine entities.

|}

== Tissue Styling Related Tokens ==
{| {{prettytable}}
|- bgcolor="#ddd"
! Token
! Arguments
! Description

|-
| {{text anchor|TISSUE_STYLE}}
| tissue style unit ID
| Select tissue layer which have the ID attached using TISSUE_STYLE_UNIT token in unit raws. This allows setting further cultural style parameters for selected tissue layer.

|-
| {{text anchor|TS_MAINTAIN_LENGTH}}
|
* minimum length?
* maximum length?
| Presumably sets culturally preferred tissue length for selected tissue. Needs testing.
Dwarves have their beards set to 100:NONE by default.

|-
| {{text anchor|TS_PREFERRED_SHAPING}}
| styling token
| Valid tokens are NEATLY_COMBED, BRAIDED, DOUBLE_BRAIDS, PONY_TAILS, CLEAN_SHAVEN and STANDARD_HAIR/BEARD/MOUSTACHE/SIDEBURNS_SHAPINGS.
Presumably sets culturally preferred tissue shapings for selected tissue. Needs testing.

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

Entity token

2014-07-27T14:54:40Z

Talvieno: /* Placement */ Added some useful info.

{{Migrated_article}}
{{quality|unrated}}{{av}}
'''Entity tokens''' define entities, or civilizations, in entity_*.txt files.

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

|-
| {{text anchor|ADVENTURE_TIER}}
| order
| Allows adventure mode for entities with sites. Dwarves, Elves, and Humans take up tier 3, 2, and 1 respectively. Order doesn't need to be maintained; a custom creature can have a tier of 3000 and still work even if it's the only custom creature.
[ADVENTURE_TIER:4]

|-
| {{text anchor|INDIV_CONTROLLABLE}}
|
| Allows the race to be played as an "outsider" in adventure mode. Not having this specified in one of the entities will cause the Adventure mode option to disappear. Note that ADVENTURE_TIER is not required if this token is included, and that this cannot be applied to civilizations that were not in an entity_*.txt file during world gen.

|-
| {{text anchor|CIV_CONTROLLABLE}}
|
| Allows fortress mode. If multiple entities have the CIV_CONTROLLABLE token, than in embark mode the specific civs can be chosen by + or - on the civ list screen (by pressing tab), though it will not state what entity the civs belong to. To check which one, tab to the neighbors screen: the entity's race will be at the top. At least one civilization must have this token.

|-
| {{text anchor|CREATURE}}
| creature
|The type of creature that will inhabit the civilization. If multiple creature types are specified, each civilization will randomly choose one of the creatures.
[CREATURE:DWARF]

|-
| {{text anchor|CREATURE_HFID}}
| integer (or generic token?)
| Found on generated [[angel]] entities. Appears to draw from creatures with this HFID, which associates the entity with a historical figure of the same ID corresponding to a [[deity]].

|}

== Placement ==

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

|-
| {{text anchor|BIOME_SUPPORT}}
|
* [[Biome token|biome]]
* frequency
| Frequency goes from 0 to 10. Higher numbers make the entity more likely to settle there.
[BIOME_SUPPORT:ANY_GRASSLAND:4]

|-
| {{text anchor|START_BIOME}}
| [[Biome token|biome]]
| Birth of the civilization can be performed on this biome. Removing this tag results in the civilization not being placed.
[START_BIOME:ANY_FOREST]

|-
| {{text anchor|EXCLUSIVE_START_BIOME}}
| [[Biome token|biome]]
| Birth of the civilization only occurs in this biome.
[EXCLUSIVE_START_BIOME:MOUNTAIN]

|-
| {{text anchor|SETTLEMENT_BIOME}}
| [[Biome token|biome]]
| This civ will create small settlements on this biome, not too far from the EXCLUSIVE_START_BIOME. Used for dwarven hillocks.
[SETTLEMENT_BIOME:ANY_GRASSLAND]

|-
| {{text anchor|DEFAULT_SITE_TYPE}}
| site type
| Valid site types are DARK_FORTRESS (π), CAVE (•), CAVE_DETAILED (Ω), TREE_CITY (î), and CITY (#). Also recognizes PLAYER_FORTRESS, and MONUMENT, though these likely will not work. FORTRESS is no longer a valid entry, instead castles are controlled by BUILDS_OUTDOOR_FORTIFICATIONS. Defaults to CITY.
[DEFAULT_SITE_TYPE:CAVE_DETAILED]

|-
| {{text anchor|LIKES_SITE}}
| site type
| Most residents will try to move to this site type, unless already at one.
[LIKES_SITE:CAVE_DETAILED]

|-
| {{text anchor|TOLERATES_SITE}}
| site type
| Some residents will try to move to this site type, unless already at one.
[TOLERATES_SITE:CITY]

|-
| {{text anchor|WORLD_CONSTRUCTION}}
| construction
| Controls which constructions the civ will build on the world map. Valid constructions are ROAD, TUNNEL, BRIDGE, and WALL.
[WORLD_CONSTRUCTION:BRIDGE]
[WORLD_CONSTRUCTION:ROAD]
[WORLD_CONSTRUCTION:TUNNEL]
[WORLD_CONSTRUCTION:WALL]

|}

== Population ==

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

|-
| {{text anchor|START_GROUP_NUMBER}}
| number
| Number of breeding couples to start with per entity. Helps give a boost to weaker civs by giving them more cannon fodder at the beginning of their histories, and better genetic diversity (if that's modeled for that particular creature). Note that single-gender (e.g. [FEMALE], [MALE], [NO_GENDER]) creatures will not have breeding couples, so a civilization with only these creatures will not be very likely to survive. As of 40d, although many had problems getting such civilizations to survive, there are those who have demonstrably and repeatedly done so. Presumably if the civ-stating code can't place breeding couples, it doesn't start the civ. However, because the children never grow up, the civ is limited to its original individuals).
[START_GROUP_NUMBER:10]

|-
| {{text anchor|MAX_POP_NUMBER}}
| number
| Max population '''per entity'''. Multiply this by max starting civ to get the total population of the species. Defaults to 500.
[MAX_POP_NUMBER:500]

|-
| {{text anchor|MAX_SITE_POP_NUMBER}}
| number
| Max population per individual site. Generic site types will not hold any more than this number of entities. Must be at least 80 for towns to be generated. In general, lower pop numbers mean more sprawl, and higher numbers mean more needing to crawl when entering town stores, which are not affected by this cap. Defaults to 50.
[MAX_SITE_POP_NUMBER:200]

|-
| {{text anchor|MAX_STARTING_CIV_NUMBER}}
| number
| Max number of entities to spawn at world generation. Worldgen picks civs in some sequential order from the raws. Once it reaches the end of the list, it will begin again at the top. Setting this number lower than 100, like say, 7, will cause worldgen to skip over this civ for placement if there are already 7 civs of this type. Note that if all civs are set to lower numbers, and the number of starting civs is set higher than the maximum possible amount of civs in total, it will gracefully stop placing civs and get down to the history aspect of worldgen. Defaults to 3.
[MAX_STARTING_CIV_NUMBER:3]

|}

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

|-
| {{text anchor|PERMITTED_BUILDING}}
| building name
| The named, custom building can be built by a civilization in Fortress Mode.
[PERMITTED_BUILDING:SOAP_MAKER]

|-
| {{text anchor|PERMITTED_JOB}}
| [[Unit type token|profession]]
| Allows this job type to be selected. This applies to worldgen creatures, in the embark screen, and in play. Certain professions also influence the availability of materials for trade.
[PERMITTED_JOB:MINER]

|-
| {{text anchor|PERMITTED_REACTION}}
| reaction name
| Allows this reaction to be used by a civilization. It is used primarily in Fortress Mode, but also allow certain resources, such as [[steel]], to be available to a race. When creating custom reactions, this token MUST be present or the player will not be able to use the reaction in Fortress Mode.
[PERMITTED_REACTION:TAN_A_HIDE]

|-
| {{text anchor|CURRENCY_BY_YEAR}}
|
| Causes the civ's currency to be numbered with the year it was minted.

|-
| {{text anchor|CURRENCY}}
|
* inorganic material
* value
| What kind of metals the civ uses for coin minting as well as the value of the coin.
[CURRENCY:SILVER:5]

|-
| {{text anchor|ART_FACET_MODIFIER}}
|
* type
* number
| OWN_RACE, FANCIFUL, EVIL, GOOD
Number goes from 0 to 25600 where 256 is the default.
[ART_FACET_MODIFIER:OWN_RACE:512]

|-
| {{text anchor|ART_IMAGE_ELEMENT_MODIFIER}}
|
* item
* number
| CREATURE, PLANT, TREE, SHAPE, ITEM<br />0-25600

Determines the chance of each image occurring in that entity's artwork, such as engravings and on artifacts, for default (non-historical) artwork.

[ART_IMAGE_ELEMENT_MODIFIER:TREE:512]

|-
| {{text anchor|ITEM_IMPROVEMENT_MODIFIER}}
|
* item
* number
| ART_IMAGE, COVERED or GLAZED, RINGS_HANGING, BANDS, SPIKES, ITEMSPECIFIC, THREAD, CLOTH, SEWN_IMAGE<br />0-25600

Determines the chance of the entity using that particular artwork method, such as "encircled with bands" or "menaces with spikes".

[ITEM_IMPROVEMENT_MODIFIER:SPIKES:0]

This also seems to change the amount that the entity will pay for items that are improved in the ways in their tokens.

|-
| {{text anchor|TRANSLATION}}
| language
| What language raw the entity uses.
* If an entity lacks this tag, translations appear to be drawn randomly from all translation files{{verify}}.
[TRANSLATION:DWARF]

|-
| {{text anchor|SELECT_SYMBOL}}
|
* noun
* symbol
| ALL, REMAINING, CIV, SITE, VESSEL, RELIGION, MILITARY_UNIT, TEMPLE, WAR, BATTLE, SIEGE, ROAD, BRIDGE, TUNNEL, WALL
Causes the entity to more often use these symbols in the particular SYM set.
[SELECT_SYMBOL:ALL:PEACE]

|-
| {{text anchor|SUBSELECT_SYMBOL}}
|
* noun
* symbol
| Causes the symbol set to be prefered as adjectives by the civilization. Used in vanilla to put violent names in sieges and batttles.
[SELECT_SYMBOL:SIEGE:NAME_SIEGE]
[SUBSELECT_SYMBOL:SIEGE:VIOLENT]

|-
| {{text anchor|CULL_SYMBOL}}
|
* noun
* symbol
| Causes the entity to not use the words in these SYM sets.
[CULL_SYMBOL:ALL:UGLY]

|-
| {{text anchor|FRIENDLY_COLOR}}
| see [[color]]
|
The color of this entity's civilization settlements in the world gen and embark screens. Defaults to 7:0:1.
[FRIENDLY_COLOR:1:0:1]

|}

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

|-
| {{text anchor|RELIGION}}
| type
|
* REGIONAL_FORCE: The creatures will worship a single force associated with their spheres. Currently hardcoded to only be associated with rivers and nature.
* PANTHEON: The creatures will worship a group of gods, each aligned with their spheres and other appropriate ones as well.

[RELIGION:PANTHEON]

|-
| {{text anchor|RELIGION_SPHERE}}
| sphere
| Can by any available [[Sphere]]. Multiple entries are possible. Choosing a religious sphere will automatically make its opposing sphere not possible for the species to have: adding WATER, for example, means the species will never get FIRE as a religious sphere.

[RELIGION_SPHERE:FORTRESSES]

|-
| {{text anchor|SPHERE_ALIGNMENT}}
|
* type
* number
|
This token forces an entity to favor or disfavor particular religious spheres, causing them to acquire those spheres more often when generating a pantheon.

[SPHERE_ALIGNMENT:TREES:512]

|}

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

|-
| {{text anchor|POSITION}}
| string
| Defines a leader/noble position for a civilization. These replace previous tags such as [MAYOR] and [CAN_HAVE_SITE_LEADER] and so on. To define a position further, see [[Position token]].

|-
| {{text anchor|LAND_HOLDER_TRIGGER}}
|
* land holder number
* population
* wealth exported
* created wealth
| Defines when a particular land-holding noble (baron, count, duke in vanilla) will arrive at a fortress.

|-
| {{text anchor|SITE_VARIABLE_POSITIONS}}
| Position responsibility or ALL
| Allows a site responsibility to be taken up by a dynamically generated position (usually lord). Also appears to cause site disputes.{{Verify}}

|-
| {{text anchor|VARIABLE_POSITIONS}}
| Position responsibility or ALL
| Allows a responsibility to be taken up by a dynamically generated position (such as Law-maker).

|}

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

|-
| {{text anchor|ETHIC}}
|
*behavior
*reaction
| Sets the civ's view of [[ethic]]s (certain behaviors), from capital punishment to completely acceptable. This also causes the civ to look upon opposing ethics with disfavor, if their reaction to it is opposing, and when at extremes (one ACCEPTABLE, another civ UNTHINKABLE for example) they will often go to war over it.
[ETHIC:EAT_SAPIENT_KILL:ACCEPTABLE]

|-
| {{text anchor|VALUE}}
|
*value
*number
| Sets the civ's cultural values. Numbers range from -50 (completely anathema) to 0 (neutral) to 50 (highly valued).
[VALUE:CRAFTSMANSHIP:50]

|-
| {{text anchor|WILL_ACCEPT_TRIBUTE}}
|
| Makes the civ's traders accept offered goods.

|-
| {{text anchor|WANDERER}}, {{text anchor|BEAST_HUNTER}}, {{text anchor|SCOUT}}
|
| The civ will send out these sorts of adventurers in worldgen. This seems to increase Tracker skill.

|-
| {{text anchor|ABUSE_BODIES}}
|
| The civilization will mutilate bodies when they are the victors in history-gen warfare, such as hanging bodies from trees, putting them on spikes, and so forth. Adventurers killed in Adventurer mode will sometimes be impaled on spikes wherever they died, with or without this token, and regardless of whether they actually antagonized the townspeople.

|-
| {{text anchor|ACTIVE_SEASON}}
| season
| the season when the civ is most active: when they will trade, interact with you via diplomats, and/or invade you. Civs can have multiple season entries. Note: If multiple caravans arrive at the same time, you are able to select which civ to trade with at the depot menu. ACTIVE_SEASON tags may be changed for a currently active fort.
[ACTIVE_SEASON:AUTUMN]

|-
| {{text anchor|AMBUSHER}}
|
| When invading sneaks around and shoots at straggling members of your society. They will spawn on the edge of the map and will only be visible when one of their party are spotted; this can be quite dangerous to undefended trade depots.

|-
| {{text anchor|AT_PEACE_WITH_WILDLIFE}}
|
| Will not attack wildlife, and will not be attacked by them, even if you have them in your party. This can be somewhat disconcerting when attacked by bears in the forest and your elven ally sits back and does nothing.

|-
| {{text anchor|BABYSNATCHER}}
|
| Sends thieves to steal babies. Also sends ambush parties to harass your civilization. Without this tag, enemy civs will only siege, and will siege as early as they would otherwise babysnatch. This can happen as early as the first year of the fort! In addition, babysnatcher civs will snatch children during worldgen, allowing them to become part of the civ if they do not escape.

Note: If the playable civ in Fortress Mode has this tag (i.e. you add BABYSNATCHER to the Dwarf entity) then the roles will be reversed and elves and humans will siege and ambush and goblins will trade with you.

|-
| {{text anchor|BUILDS_OUTDOOR_FORTIFICATIONS}}
|
| Makes the civilization build castles.

|-
| {{text anchor|BUILDS_OUTDOOR_TOMBS}}
|
| Makes the civilization build tombs.

|-
| {{text anchor|BANDITRY}}
| percentage
| Sets a percentage of the entity population to be used as bandits.

|-
| {{text anchor|DIPLOMAT_BODYGUARDS}}
|
| Visiting diplomats are accompanied by a pair of soldiers. Does not work due to a bug.{{bug|5854}}

|-
| {{text anchor|GENERATED}}
|
| Found on generated divine "HF Guardian Entities". Cannot be used in user-defined raws.

|-
| {{text anchor|INVADERS_IGNORE_NEUTRALS}}
|
| Causes invaders to ignore visiting caravans and other neutral creatures.{{verify}}

|-
| {{text anchor|ITEM_THIEF}}
|
| Sends thieves to steal items. This will also occur in history generation, and thieves will have the "thief" profession. Items stolen in history gen will be scattered around that creature's home.

|-
| {{text anchor|LOCAL_BANDITRY}}
|
| Causes the entity to send out patrols that can ambush adventurers. Will cause cities to be hostile to adventurers whenever they enter, regardless of race or nationality. Adding this tag to playable entities will also make adventurers with this token willing to move-attack non-hostile villagers, rather than having to make an aimed attack.

|-
| {{text anchor|MERCHANT_BODYGUARDS}}
|
| Caravan merchants are accompanied by soldiers.

|-
| {{text anchor|MERCHANT_NOBILITY}}
|
| Effect unknown - in previous versions, this resulted in the civ having a Guild Representative / Merchant Baron / Merchant Prince, but now this is controlled solely by positions.

|-
| {{text anchor|PROGRESS_TRIGGER_POPULATION}}
| level
| 0 to 5, civ will come to site once population at site has reached that level. If multiple progress triggers exist for a civ, it will come when any one of them is fulfilled instead of waiting for all of them to be reached. A value of 0 disables the trigger. 1 corresponds to 20 dwarves, 2 to 50 dwarves, 3 to 80, 4 to 110, and 5 to 140. Progress triggers may be changed, added, or deleted for a currently active fort. Note: hostile civs require that the population trigger be fulfilled as well as at least one other trigger before attacking.

|-
| {{text anchor|PROGRESS_TRIGGER_PRODUCTION}}
| level
| 0 to 5, civ will come to site once created wealth has reached that level. If multiple progress triggers exist for a civ, it will come when any one of them is fulfilled instead of waiting for all of them to be reached. A value of 0 disables the trigger. 1 corresponds to 5000☼ created wealth, 2 to 25000☼, 3 to 100000☼, 4 to 200000☼, and 5 to 300000☼. Progress triggers may be changed, added, or deleted for a currently active fort.

|-
| {{text anchor|PROGRESS_TRIGGER_TRADE}}
| level
| 0 to 5, civ will come to site once exported goods has reached that level. If multiple progress triggers exist for a civ, it will come when any one of them is fulfilled instead of waiting for all of them to be reached. A value of 0 disables the trigger. 1 corresponds to 500☼ exported wealth, 2 to 2500☼, 3 to 10000☼, 4 to 20000☼, and 5 to 30000☼. Progress triggers may be changed, added, or deleted for a currently active fort.

|-
| {{text anchor|PROGRESS_TRIGGER_POP_SIEGE}}
| level
| 0 to 5, civ will begin to send sieges against the player civ when this level is reached if it is hostile.

If multiple progress triggers exist for a civ, it will come when any one of them is fulfilled instead of waiting for all of them to be reached. A value of 0 disables the trigger.

|-
| {{text anchor|PROGRESS_TRIGGER_PROD_SIEGE}}
| level
| 0 to 5, civ will begin to send sieges against the player civ when this level is reached if it is hostile.

|-
| {{text anchor|PROGRESS_TRIGGER_TRADE_SIEGE}}
| level
| 0 to 5, civ will begin to send sieges against the player civ when this level is reached if it is hostile.

|-
| {{text anchor|SIEGER}}
|
| Will start campfires and wait around at the edge of your map for a month or two before rushing in to attack.

|-
| {{text anchor|SITE_GUARDIAN}}
|
| Guards certain special sites, such as a [[vault]] belonging to a [[demon]] allied with a [[deity]]. Used in generated divine entities.

|-
| {{text anchor|SKULKING}}
|
| This makes the severity of attacks depend on the extent of item/baby thievery rather than the passage of time. Makes trade impossible with the related civilization.

|-
| {{text anchor|TREE_CAP_DIPLOMACY}}
|
| Visiting diplomats impose tree cutting quotas; without this, they will simply compliment your fortress and leave. Also causes the diplomat to make unannounced first contact at the very beginning of the first Spring after your fortress becomes a Barony.

|-
| {{text anchor|LAYER_LINKED}}
|
| Defines if a civilization is a hidden subterranean entity, such as batman civilizations.

|-
| {{text anchor|UNDEAD_CANDIDATE}}
|
| Unknown. Possibly makes this creature available as a "Corpse" (e.g. Human Corpse) for necromancers in adventure mode.

|}

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

|-
| {{text anchor|AMMO}}
| item token
|
[AMMO:ITEM_AMMO_BOLTS]

|-
| {{text anchor|ARMOR}}
|
* item token
* rarity
|Rarity is optional. Permitted rarity values are RARE, UNCOMMON, FORCED (anything else is treated as COMMON).
[ARMOR:ITEM_ARMOR_PLATEMAIL:COMMON]

|-
| {{text anchor|DIGGER}}
| item token
|
[DIGGER:ITEM_WEAPON_PICK]

|-
| {{text anchor|GLOVES}}
|
* item token
* rarity
| Rarity is optional. Permitted rarity values are RARE, UNCOMMON, FORCED (anything else is treated as COMMON).
[GLOVES:ITEM_GLOVES_GLOVES:COMMON]

|-
| {{text anchor|HELM}}
|
* item token
* rarity
| Rarity is optional. Permitted rarity values are RARE, UNCOMMON, FORCED (anything else is treated as COMMON).
[HELM:ITEM_HELM_HELM:COMMON]

|-
| {{text anchor|INSTRUMENT}}
| item token
|
[INSTRUMENT:ITEM_INSTRUMENT_FLUTE]

|-
| {{text anchor|PANTS}}
|
* item token
* rarity
| Rarity is optional. Permitted rarity values are RARE, UNCOMMON, FORCED (anything else is treated as COMMON).
[PANTS:ITEM_PANTS_PANTS:COMMON]

|-
| {{text anchor|SHIELD}}
| item token
|
[SHIELD:ITEM_SHIELD_SHIELD]

|-
| {{text anchor|SHOES}}
|
* item token
* rarity
| Rarity is optional. Permitted rarity values are RARE, UNCOMMON, FORCED (anything else is treated as COMMON).
[SHOES:ITEM_SHOES_SHOES:COMMON]

|-
| {{text anchor|SIEGEAMMO}}
| item token
|
[SIEGEAMMO:ITEM_SIEGEAMMO_BALLISTA]

|-
| {{text anchor|TOOL}}
| item token
|
[TOOL:ITEM_TOOL_NEST_BOX]

|-
| {{text anchor|TOY}}
| item token
|
[TOY:ITEM_TOY_PUZZLEBOX]

|-
| {{text anchor|TRAPCOMP}}
| item token
|
[TRAPCOMP:ITEM_TRAPCOMP_GIANTAXEBLADE]

|-
| {{text anchor|WEAPON}}
| item token
|
[WEAPON:ITEM_WEAPON_AXE_BATTLE]

|-
| {{text anchor|USE_ANIMAL_PRODUCTS}}
|
| Allows civilization to use products made from animals. All relevant creatures will be able to provide wool, silk, and extracts (including milk and venom) for trade, and non-sentient creatures (unless ethics state otherwise) will be able to provide eggs, caught fish, meat, leather, bone, shell, pearl, horn, and ivory.

|-
| {{text anchor|USE_ANY_PET_RACE}}
|
| Any creature in the civilization's list of usables (from the surrounding 7x7 or so of squares and map features in those squares) which has PET or PET_EXOTIC will be available as a pet, pack animal (with PACK_ANIMAL), wagon puller (with WAGON_PULLER), mount (with MOUNT or MOUNT_EXOTIC), or siege minion (with TRAINABLE_WAR and ''without'' CAN_LEARN). This notion of the initial usable creature list, which then gets pared down or otherwise considered, applies below as well. All common domestic and equipment creatures are also added to the initial list.

|-
| {{text anchor|USE_CAVE_ANIMALS}}
|
| If they don't have it, creatures with exclusively subterranean biomes are skipped. If they have it, cave creatures with PET will also be available as pets, pack animals (with PACK_ANIMAL), wagon pullers (with WAGON_PULLER), mounts (with MOUNT or MOUNT_EXOTIC), and siege minions (with TRAINABLE_WAR and ''without'' CAN_LEARN).

|-
| {{text anchor|USE_EVIL_ANIMALS}}
|
| Don't have it -> EVIL creatures skipped. If they have it, evil creatures with SLOW_LEARNER or ''without'' CAN_LEARN will be also available as pets (with PET), pack animals (with PACK_ANIMAL), wagon pullers (with WAGON_PULLER), mounts (with MOUNT or MOUNT_EXOTIC), and siege minions (with TRAINABLE_WAR or SLOW_LEARNER).

|-
| {{text anchor|USE_EVIL_PLANTS}}
|
| As EVIL creatures for all uses of plants.

|-
| {{text anchor|USE_EVIL_WOOD}}
|
| As EVIL creatures for all uses of wood.

|-
| {{text anchor|USE_GOOD_ANIMALS}}
|
| Don't have it -> GOOD creatures skipped. If they have it, good creatures ''without'' CAN_LEARN will also be available as pets (with PET), pack animals (with PACK_ANIMAL), wagon pullers (with WAGON_PULLER), mounts (with MOUNT or MOUNT_EXOTIC), and siege minions (with TRAINABLE_WAR).

|-
| {{text anchor|USE_GOOD_PLANTS}}
|
| As GOOD creatures for all uses of plants.

|-
| {{text anchor|USE_GOOD_WOOD}}
|
| As GOOD creatures for all uses of wood.

|-
| {{text anchor|USE_MISC_PROCESSED_WOOD_PRODUCTS}}
|
| If the relevant professions are permitted, controls availability of lye (LYE_MAKING), charcoal (BURN_WOOD), and potash (POTASH_MAKING).

|-
| {{text anchor|COMMON_DOMESTIC_MOUNT}}
|
| Gives the civilization access to creatures with COMMON_DOMESTIC and MOUNT. Additionally, all available (based on USE_ANY_PET_RACE, USE_CAVE_ANIMALS, USE_GOOD_ANIMALS, and USE_EVIL_ANIMALS) creature with MOUNT and PET will be allowed for use as mounts during combat.

|-
| {{text anchor|COMMON_DOMESTIC_PACK}}
|
| Gives the civilization access to creatures with COMMON_DOMESTIC and PACK_ANIMAL. Additionally, all available (see above) creatures with PACK_ANIMAL and PET will be allowed for use during trade as pack animals.

|-
| {{text anchor|COMMON_DOMESTIC_PET}}
|
| Gives the civilization access to creatures with COMMON_DOMESTIC and PET. Additionally, all available (see above) creatures with PET will be allowed for use as pets.

|-
| {{text anchor|COMMON_DOMESTIC_PULL}}
|
| Gives the civilization access to creatures with COMMON_DOMESTIC and WAGON_PULLER. Additionally, all available (see above) creatures with WAGON_PULLER and PET will be allowed for use during trade to pull [[wagon]]s.

|-
| {{text anchor|RIVER_PRODUCTS}}
|
| Allow civ to use river products in the goods it has available for trade.

|-
| {{text anchor|OCEAN_PRODUCTS}}
|
| Allow civ to use ocean products (including [[amber]] and [[coral]]) in the goods it has available for trade. Without OCEAN_PRODUCTS, civilizations will not be able to trade ocean fish even if they are ''also'' available from other sources (e.g. [[sturgeon]]s and [[stingray]]s).

|-
| {{text anchor|INDOOR_FARMING}}
|
| Allow civ to use underground plant products in the goods it has available for trade.

|-
| {{text anchor|OUTDOOR_FARMING}}
|
| Allow civ to use outdoor plant products in the goods it has available for trade.

|-
| {{text anchor|INDOOR_GARDENS}}
|
| Allow civ to use underground plant growths (quarry bush leaves in unmodded games) in the goods it has available for trade.

|-
| {{text anchor|OUTDOOR_GARDENS}}
|
| Allow civ to use outdoor plant growths in the goods it has available for trade.

|-
| {{text anchor|OUTDOOR_ORCHARDS}}
|
| Allows civ to use outdoor tree growths in the goods it has available for trade.

|-
| {{text anchor|CLOTHING}}
|
| Civ members will attempt to wear clothing.

|-
| {{text anchor|SUBTERRANEAN_CLOTHING}}
|
| Will wear things made of spider silk and other subterranean materials.

|-
| {{text anchor|EQUIPMENT_IMPROVEMENTS}}
|
| Adds decorations to equipment based on the level of the generated unit. Also improves item quality.

|-
| {{text anchor|IMPROVED_BOWS}}
|
| Adds decorations to weapons generated for bowman and master bowman. An elf hack.

|-
| {{text anchor|METAL_PREF}}
|
| Allows metal materials to be used to make cages (inexpensive metals only) and crafts.

|-
| {{text anchor|STONE_PREF}}
|
| Allows the civilization to make use of nearby stone types. If the FURNACE_OPERATOR job is permitted, also allows ore-bearing stones to be smelted into metals.

|-
| {{text anchor|WOOD_WEAPONS}}
|
| The civilization can make traditionally metallic weapons such as swords and spears from wood. An elf hack.

|-
| {{text anchor|WOOD_ARMOR}}
|
| The civilization can make traditionally metallic armor such as mail shirts and helmets from wood. An elf hack.

|-
| {{text anchor|GEM_PREF}}
|
| Enables creatures of this entity to bring gems in trade.

|-
| {{text anchor|INDOOR_WOOD}}
|
| Allow civ to use subterranean wood types, such as tower-cap and fungiwood logs.

|-
| {{text anchor|OUTDOOR_WOOD}}
|
| Allow civ to use outdoor wood types, such as mangrove and oak.

|-
| {{text anchor|GEM_SHAPE}}
| [[Descriptor shape token|shape]]
| Precious gems cut by this civilization's jewelers can be of this shape.

|-
| {{text anchor|STONE_SHAPE}}
| [[Descriptor shape token|shape]]
| Ordinary non-gem stones cut by this civilization's jewelers can be of this shape.

|-
| {{text anchor|DIVINE_MAT_CLOTH}}
|
| Allows civ to use materials with [DIVINE] for clothing. Used for generated divine entities.

|-
| {{text anchor|DIVINE_MAT_WEAPONS}}
|
| Allows civ to use metals with [DIVINE] for weapons. Used for generated divine entities.

|-
| {{text anchor|DIVINE_MAT_ARMOR}}
|
| Allows civ to use metals with [DIVINE] for armour. Used for generated divine entities.

|}

== Tissue Styling Related Tokens ==
{| {{prettytable}}
|- bgcolor="#ddd"
! Token
! Arguments
! Description

|-
| {{text anchor|TISSUE_STYLE}}
| tissue style unit ID
| Select tissue layer which have the ID attached using TISSUE_STYLE_UNIT token in unit raws. This allows setting further cultural style parameters for selected tissue layer.

|-
| {{text anchor|TS_MAINTAIN_LENGTH}}
|
* minimum length?
* maximum length?
| Presumably sets culturally preferred tissue length for selected tissue. Needs testing.
Dwarves have their beards set to 100:NONE by default.

|-
| {{text anchor|TS_PREFERRED_SHAPING}}
| styling token
| Valid tokens are NEATLY_COMBED, BRAIDED, DOUBLE_BRAIDS, PONY_TAILS, CLEAN_SHAVEN and STANDARD_HAIR/BEARD/MOUSTACHE/SIDEBURNS_SHAPINGS.
Presumably sets culturally preferred tissue shapings for selected tissue. Needs testing.

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

Alcohol

2014-07-26T19:04:48Z

Talvieno: Changed quality rating from "Unrated" to "Exceptional" using the rating script

{{Quality|Exceptional|19:04, 26 July 2014 (UTC)}}
{{av}}
[[File:Thirsty Dwarves.gif|thumb|right|A booze [[stockpile]] at work.]]
'''Alcohol''' is the favored drink of the [[Dwarf|dwarves]]; a dwarf will drink booze an average of four times per [[calendar|season]] to satisfy their [[thirst]], and although they can subsist on [[water]], without booze they will work increasingly slowly. Dwarves like to have some variety in what they drink, and will garner a bad thought if they are forced to drink the same variety of drink repeatedly ("has been tired of drinking the same old booze lately"). Every dwarf likewise has [[preference]]s for various types of drinks, starting hidden and then appearing as each type of drink becomes known to your fortress. Thus alcohol is important both for maintaining your fortress (at a minimum) and (with some investment in variety) for keeping your dwarves happy.

== Acquisition ==
Most of the [[crop|plants]] in the game can be turned into drink, and thus most drink is sourced from dwarven [[farming]], both indoor and out. Most of the plants [[plant gathering|gathered]] from the wild can also be used for brewing, but the reduced yields relative to farming makes it a less ideal solution. Drinks can be sourced at [[embark#supplies|embarkation]], and taking at least a few barrels with you is recommended to hold your initial dwarves over until you can build a [[still]]. [[Caravan]]s always bring some drinks along as well, although not enough to support a reasonably large fortress. Finally, [[honey]] acquired through [[beekeeping industry|beekeeping]] can be brewed into alcoholic mead, the only form of drink that is not derived from plants.

The most direct way to acquire the booze itself is through a [[still]]; large fortresses will usually have one or more dedicated [[brewer]]s keeping the dwarven drinks cellar well stocked. To brew a drink a dwarf will need an empty watertight container of some kind (either a [[barrel]] or a [[large pot]]) and a [[stack]] of brewables. Each brewing job produces five units of alcohol per brewable item and deposits the alcohol in the container, recovering any plant [[seed]]s in the process. The size of a stack does not affect how long it takes to brew it, which is based entirely on the brewer's [[skill]], making brewing jobs performed on large stacks much more efficient than those done on individual consumables. Stacks of alcohol do not have quality levels, and the strength of a happy thought obtained by drinking alcohol is based entirely on the value of the drink (including the stack size) and the dwarf's personal preferences.

== Mechanics ==
Dwarven thirst is constrained by the important [ALCOHOL_DEPENDENT] [[creature token]] tag, which causes them to suffer severe performance penalties when deprived of alcohol. Thirsty dwarves increasingly lose [[speed]] in almost every activity, including basic movement; dwarves will also wait longer before drinking from a non-alcoholic water source, resulting in negative [[thought]]s from thirst. Alcohol withdrawal appears in the dwarf's thoughts and preferences as "starting to work slowly due to its scarcity" after 3 months, "really wants a drink" after 6 months, "has gone without a drink for far, far too long" after 9 months, and finally "can't even remember the last time he/she had some" after an entire year. Precisely how much dwarves trudge their feet due to alcohol withdrawal is unknown.

While dwarves rely on alcohol from the moment they are born, creatures of ''any'' race who are exposed to enough combat to become fully hardened ("doesn't really care about anything anymore") will also become alcoholics.

Setting booze on [[fire]] will not cause it to explode, but exposing it to high [[temperature]]s ''will'' cause it to boil away. If the container is flammable, it (and, subsequently, the booze) will be consumed by fire; [[magma-safe]] containers would never be destroyed by [[magma]], but any booze inside will likely quickly perish due to heat transfer (unless the container is made of [[nether-cap]]).

== Types of Alcohol ==
{|style="margin:1em 1em 1em 0;background:#F9F9F9;border:1px #AAA solid;border-collapse:collapse;" width="90%" class="wikitable sortable"
|- style="background:#F2F2F2;text-align:center;"
!style="border:1px #AAA solid;padding:0.2em;"|Ingredient
!style="border:1px #AAA solid;padding:0.2em;"|Beverage Produced
!style="border:1px #AAA solid;padding:0.2em;" align="center"|Beverage Value
!style="border:1px #AAA solid;padding:0.2em;" align="center"|Type
!style="border:1px #AAA solid;padding:0.2em;" align="center"|Source
|-
|style="border:1px #AAA solid;padding:0.2em;"|[[Plump helmet]]
|style="border:1px #AAA solid;padding:0.2em;"|Dwarven Wine
|style="border:1px #AAA solid;padding:0.2em;"|2
|style="border:1px #AAA solid;padding:0.2em; background-color:#cfc "|Plant-based
|style="border:1px #AAA solid;padding:0.2em;"|Indoors
|-
|style="border:1px #AAA solid;padding:0.2em;"|[[Pig tail]]
|style="border:1px #AAA solid;padding:0.2em;"|Dwarven Ale
|style="border:1px #AAA solid;padding:0.2em;"|2
|style="border:1px #AAA solid;padding:0.2em; background-color:#cfc "|Plant-based
|style="border:1px #AAA solid;padding:0.2em;"|Indoors
|-
|style="border:1px #AAA solid;padding:0.2em;"|[[Cave wheat]]
|style="border:1px #AAA solid;padding:0.2em;"|Dwarven Beer
|style="border:1px #AAA solid;padding:0.2em;"|2
|style="border:1px #AAA solid;padding:0.2em; background-color:#cfc "|Plant-based
|style="border:1px #AAA solid;padding:0.2em;"|Indoors
|-
|style="border:1px #AAA solid;padding:0.2em;"|[[Sweet pod]]
|style="border:1px #AAA solid;padding:0.2em;"|Dwarven Rum
|style="border:1px #AAA solid;padding:0.2em;"|2
|style="border:1px #AAA solid;padding:0.2em; background-color:#cfc "|Plant-based
|style="border:1px #AAA solid;padding:0.2em;"|Indoors
|-
|style="border:1px #AAA solid;padding:0.2em;"|[[Muck root]]
|style="border:1px #AAA solid;padding:0.2em;"|Swamp Whiskey
|style="border:1px #AAA solid;padding:0.2em;"|1
|style="border:1px #AAA solid;padding:0.2em; background-color:#cfc "|Plant-based
|style="border:1px #AAA solid;padding:0.2em;"|Outdoors
|-
|style="border:1px #AAA solid;padding:0.2em;"|[[Bloated tuber]]
|style="border:1px #AAA solid;padding:0.2em;"|Tuber Beer
|style="border:1px #AAA solid;padding:0.2em;"|2
|style="border:1px #AAA solid;padding:0.2em; background-color:#cfc "|Plant-based
|style="border:1px #AAA solid;padding:0.2em;"|Outdoors
|-
|style="border:1px #AAA solid;padding:0.2em;"|[[Prickle berry]]
|style="border:1px #AAA solid;padding:0.2em;"|Prickle Berry Wine
|style="border:1px #AAA solid;padding:0.2em;"|1
|style="border:1px #AAA solid;padding:0.2em; background-color:#cfc "|Plant-based
|style="border:1px #AAA solid;padding:0.2em;"|Outdoors
|-
|style="border:1px #AAA solid;padding:0.2em;"|[[Wild strawberry]]
|style="border:1px #AAA solid;padding:0.2em;"|Strawberry Wine
|style="border:1px #AAA solid;padding:0.2em;"|2
|style="border:1px #AAA solid;padding:0.2em; background-color:#cfc "|Plant-based
|style="border:1px #AAA solid;padding:0.2em;"|Outdoors
|-
|style="border:1px #AAA solid;padding:0.2em;"|[[Longland grass]]
|style="border:1px #AAA solid;padding:0.2em;"|Longland Beer
|style="border:1px #AAA solid;padding:0.2em;"|2
|style="border:1px #AAA solid;padding:0.2em; background-color:#cfc "|Plant-based
|style="border:1px #AAA solid;padding:0.2em;"|Outdoors
|-
|style="border:1px #AAA solid;padding:0.2em;"|[[Rat weed]]
|style="border:1px #AAA solid;padding:0.2em;"|Sewer Brew
|style="border:1px #AAA solid;padding:0.2em;"|1
|style="border:1px #AAA solid;padding:0.2em; background-color:#cfc "|Plant-based
|style="border:1px #AAA solid;padding:0.2em;"|Outdoors
|-
|style="border:1px #AAA solid;padding:0.2em;"|[[Fisher berry]]
|style="border:1px #AAA solid;padding:0.2em;"|Fisher Berry Wine
|style="border:1px #AAA solid;padding:0.2em;"|2
|style="border:1px #AAA solid;padding:0.2em; background-color:#cfc "|Plant-based
|style="border:1px #AAA solid;padding:0.2em;"|Outdoors
|-
|style="border:1px #AAA solid;padding:0.2em;"|[[Rope reed]]
|style="border:1px #AAA solid;padding:0.2em;"|River Spirits
|style="border:1px #AAA solid;padding:0.2em;"|2
|style="border:1px #AAA solid;padding:0.2em; background-color:#cfc"|Plant-based
|style="border:1px #AAA solid;padding:0.2em;"|Outdoors
|-
|style="border:1px #AAA solid;padding:0.2em;"|[[Sliver barb]]
|style="border:1px #AAA solid;padding:0.2em;"|Gutter Cruor
|style="border:1px #AAA solid;padding:0.2em;"|1
|style="border:1px #AAA solid;padding:0.2em;background-color:#cfc"|Plant-based
|style="border:1px #AAA solid;padding:0.2em;"|Outdoors
|-
|style="border:1px #AAA solid;padding:0.2em;"|[[Sun berry]]
|style="border:1px #AAA solid;padding:0.2em;"|Sunshine
|style="border:1px #AAA solid;padding:0.2em;"|5
|style="border:1px #AAA solid;padding:0.2em;background-color:#cfc"|Plant-based
|style="border:1px #AAA solid;padding:0.2em;"|Outdoors
|-
|style="border:1px #AAA solid;padding:0.2em;"|[[Whip vine]]
|style="border:1px #AAA solid;padding:0.2em;"|Whip Wine
|style="border:1px #AAA solid;padding:0.2em;"|3
|style="border:1px #AAA solid;padding:0.2em;background-color:#cfc"|Plant-based
|style="border:1px #AAA solid;padding:0.2em;"|Outdoors
|-
|style="border:1px #AAA solid;padding:0.2em;"|[[Barley]]
|style="border:1px #AAA solid;padding:0.2em;"|Barley Wine
|style="border:1px #AAA solid;padding:0.2em;"|2
|style="border:1px #AAA solid;padding:0.2em;background-color:#cfc"|Plant-based
|style="border:1px #AAA solid;padding:0.2em;"|Outdoors
|-
|style="border:1px #AAA solid;padding:0.2em;"|[[Cassava]]
|style="border:1px #AAA solid;padding:0.2em;"|Cassava Beer
|style="border:1px #AAA solid;padding:0.2em;"|2
|style="border:1px #AAA solid;padding:0.2em;background-color:#cfc"|Plant-based
|style="border:1px #AAA solid;padding:0.2em;"|Outdoors
|-
|style="border:1px #AAA solid;padding:0.2em;"|[[Kaniwa]]
|style="border:1px #AAA solid;padding:0.2em;"|Kaniwa Beer
|style="border:1px #AAA solid;padding:0.2em;"|2
|style="border:1px #AAA solid;padding:0.2em;background-color:#cfc"|Plant-based
|style="border:1px #AAA solid;padding:0.2em;"|Outdoors
|-
|style="border:1px #AAA solid;padding:0.2em;"|[[Parsnip]]
|style="border:1px #AAA solid;padding:0.2em;"|Parsnip Wine
|style="border:1px #AAA solid;padding:0.2em;"|2
|style="border:1px #AAA solid;padding:0.2em;background-color:#cfc"|Plant-based
|style="border:1px #AAA solid;padding:0.2em;"|Outdoors
|-
|style="border:1px #AAA solid;padding:0.2em;"|[[Pendant amaranth]]
|style="border:1px #AAA solid;padding:0.2em;"|Pendant Amaranth Wine
|style="border:1px #AAA solid;padding:0.2em;"|2
|style="border:1px #AAA solid;padding:0.2em;background-color:#cfc"|Plant-based
|style="border:1px #AAA solid;padding:0.2em;"|Outdoors
|-
|style="border:1px #AAA solid;padding:0.2em;"|[[Quinoa]]
|style="border:1px #AAA solid;padding:0.2em;"|Quinoa Beer
|style="border:1px #AAA solid;padding:0.2em;"|2
|style="border:1px #AAA solid;padding:0.2em;background-color:#cfc"|Plant-based
|style="border:1px #AAA solid;padding:0.2em;"|Outdoors
|-
|style="border:1px #AAA solid;padding:0.2em;"|[[Radish]]
|style="border:1px #AAA solid;padding:0.2em;"|Radish Wine
|style="border:1px #AAA solid;padding:0.2em;"|2
|style="border:1px #AAA solid;padding:0.2em;background-color:#cfc"|Plant-based
|style="border:1px #AAA solid;padding:0.2em;"|Outdoors
|-
|style="border:1px #AAA solid;padding:0.2em;"|[[Rice]]
|style="border:1px #AAA solid;padding:0.2em;"|Rice Beer
|style="border:1px #AAA solid;padding:0.2em;"|2
|style="border:1px #AAA solid;padding:0.2em;background-color:#cfc"|Plant-based
|style="border:1px #AAA solid;padding:0.2em;"|Outdoors
|-
|style="border:1px #AAA solid;padding:0.2em;"|[[Rye]]
|style="border:1px #AAA solid;padding:0.2em;"|Rye Beer
|style="border:1px #AAA solid;padding:0.2em;"|2
|style="border:1px #AAA solid;padding:0.2em;background-color:#cfc"|Plant-based
|style="border:1px #AAA solid;padding:0.2em;"|Outdoors
|-
|style="border:1px #AAA solid;padding:0.2em;"|[[Spelt]]
|style="border:1px #AAA solid;padding:0.2em;"|Spelt Beer
|style="border:1px #AAA solid;padding:0.2em;"|2
|style="border:1px #AAA solid;padding:0.2em;background-color:#cfc"|Plant-based
|style="border:1px #AAA solid;padding:0.2em;"|Outdoors
|-
|style="border:1px #AAA solid;padding:0.2em;"|[[Sweet potato]]
|style="border:1px #AAA solid;padding:0.2em;"|Sweet Potato Wine
|style="border:1px #AAA solid;padding:0.2em;"|2
|style="border:1px #AAA solid;padding:0.2em;background-color:#cfc"|Plant-based
|style="border:1px #AAA solid;padding:0.2em;"|Outdoors
|-
|style="border:1px #AAA solid;padding:0.2em;"|[[Tomatillo]]
|style="border:1px #AAA solid;padding:0.2em;"|Tomatillo Wine
|style="border:1px #AAA solid;padding:0.2em;"|2
|style="border:1px #AAA solid;padding:0.2em;background-color:#cfc"|Plant-based
|style="border:1px #AAA solid;padding:0.2em;"|Outdoors
|-
|style="border:1px #AAA solid;padding:0.2em;"|[[White millet]]
|style="border:1px #AAA solid;padding:0.2em;"|White Millet Beer
|style="border:1px #AAA solid;padding:0.2em;"|2
|style="border:1px #AAA solid;padding:0.2em;background-color:#cfc"|Plant-based
|style="border:1px #AAA solid;padding:0.2em;"|Outdoors
|-
|style="border:1px #AAA solid;padding:0.2em;"|[[Wild carrot]]
|style="border:1px #AAA solid;padding:0.2em;"|Carrot Wine
|style="border:1px #AAA solid;padding:0.2em;"|2
|style="border:1px #AAA solid;padding:0.2em;background-color:#cfc"|Plant-based
|style="border:1px #AAA solid;padding:0.2em;"|Outdoors
|-
|style="border:1px #AAA solid;padding:0.2em;"|[[Apple]]
|style="border:1px #AAA solid;padding:0.2em;"|Apple Cider
|style="border:1px #AAA solid;padding:0.2em;"|2
|style="border:1px #AAA solid;padding:0.2em;background-color:#fcc"|Fruit-based
|style="border:1px #AAA solid;padding:0.2em;"|Outdoors
|-
|style="border:1px #AAA solid;padding:0.2em;"|[[Apricot]]
|style="border:1px #AAA solid;padding:0.2em;"|Apricot Wine
|style="border:1px #AAA solid;padding:0.2em;"|2
|style="border:1px #AAA solid;padding:0.2em;background-color:#fcc"|Fruit-based
|style="border:1px #AAA solid;padding:0.2em;"|Outdoors
|-
|style="border:1px #AAA solid;padding:0.2em;"|[[Banana]]
|style="border:1px #AAA solid;padding:0.2em;"|Banana Beer
|style="border:1px #AAA solid;padding:0.2em;"|2
|style="border:1px #AAA solid;padding:0.2em;background-color:#fcc"|Fruit-based
|style="border:1px #AAA solid;padding:0.2em;"|Outdoors
|-
|style="border:1px #AAA solid;padding:0.2em;"|[[Bayberry]]
|style="border:1px #AAA solid;padding:0.2em;"|Bayberry Wine
|style="border:1px #AAA solid;padding:0.2em;"|2
|style="border:1px #AAA solid;padding:0.2em;background-color:#fcc"|Fruit-based
|style="border:1px #AAA solid;padding:0.2em;"|Outdoors
|-
|style="border:1px #AAA solid;padding:0.2em;"|[[Bilberry]]
|style="border:1px #AAA solid;padding:0.2em;"|Bilberry Wine
|style="border:1px #AAA solid;padding:0.2em;"|2
|style="border:1px #AAA solid;padding:0.2em;background-color:#fcc"|Fruit-based
|style="border:1px #AAA solid;padding:0.2em;"|Outdoors
|-
|style="border:1px #AAA solid;padding:0.2em;"|[[Blackberry]]
|style="border:1px #AAA solid;padding:0.2em;"|Blackberry Wine
|style="border:1px #AAA solid;padding:0.2em;"|2
|style="border:1px #AAA solid;padding:0.2em;background-color:#fcc"|Fruit-based
|style="border:1px #AAA solid;padding:0.2em;"|Outdoors
|-
|style="border:1px #AAA solid;padding:0.2em;"|[[Blueberry]]
|style="border:1px #AAA solid;padding:0.2em;"|Blueberry Wine
|style="border:1px #AAA solid;padding:0.2em;"|2
|style="border:1px #AAA solid;padding:0.2em;background-color:#fcc"|Fruit-based
|style="border:1px #AAA solid;padding:0.2em;"|Outdoors
|-
|style="border:1px #AAA solid;padding:0.2em;"|[[Cherry]]
|style="border:1px #AAA solid;padding:0.2em;"|Cherry Wine
|style="border:1px #AAA solid;padding:0.2em;"|2
|style="border:1px #AAA solid;padding:0.2em;background-color:#fcc"|Fruit-based
|style="border:1px #AAA solid;padding:0.2em;"|Outdoors
|-
|style="border:1px #AAA solid;padding:0.2em;"|[[Cranberry]]
|style="border:1px #AAA solid;padding:0.2em;"|Cranberry Wine
|style="border:1px #AAA solid;padding:0.2em;"|2
|style="border:1px #AAA solid;padding:0.2em;background-color:#fcc"|Fruit-based
|style="border:1px #AAA solid;padding:0.2em;"|Outdoors
|-
|style="border:1px #AAA solid;padding:0.2em;"|[[Custard apple]]
|style="border:1px #AAA solid;padding:0.2em;"|Custard Apple Cider
|style="border:1px #AAA solid;padding:0.2em;"|2
|style="border:1px #AAA solid;padding:0.2em;background-color:#fcc"|Fruit-based
|style="border:1px #AAA solid;padding:0.2em;"|Outdoors
|-
|style="border:1px #AAA solid;padding:0.2em;"|[[Passion fruit]]
|style="border:1px #AAA solid;padding:0.2em;"|Passion Fruit Wine
|style="border:1px #AAA solid;padding:0.2em;"|2
|style="border:1px #AAA solid;padding:0.2em;background-color:#fcc"|Fruit-based
|style="border:1px #AAA solid;padding:0.2em;"|Outdoors
|-
|style="border:1px #AAA solid;padding:0.2em;"|[[Papaya]]
|style="border:1px #AAA solid;padding:0.2em;"|Papaya Wine
|style="border:1px #AAA solid;padding:0.2em;"|2
|style="border:1px #AAA solid;padding:0.2em;background-color:#fcc"|Fruit-based
|style="border:1px #AAA solid;padding:0.2em;"|Outdoors
|-
|style="border:1px #AAA solid;padding:0.2em;"|[[Peach]]
|style="border:1px #AAA solid;padding:0.2em;"|Peach Cider
|style="border:1px #AAA solid;padding:0.2em;"|2
|style="border:1px #AAA solid;padding:0.2em;background-color:#fcc"|Fruit-based
|style="border:1px #AAA solid;padding:0.2em;"|Outdoors
|-
|style="border:1px #AAA solid;padding:0.2em;"|[[Pear]]
|style="border:1px #AAA solid;padding:0.2em;"|Perry
|style="border:1px #AAA solid;padding:0.2em;"|2
|style="border:1px #AAA solid;padding:0.2em;background-color:#fcc"|Fruit-based
|style="border:1px #AAA solid;padding:0.2em;"|Outdoors
|-
|style="border:1px #AAA solid;padding:0.2em;"|[[Plum]]
|style="border:1px #AAA solid;padding:0.2em;"|Plum Wine
|style="border:1px #AAA solid;padding:0.2em;"|2
|style="border:1px #AAA solid;padding:0.2em;background-color:#fcc"|Fruit-based
|style="border:1px #AAA solid;padding:0.2em;"|Outdoors
|-
|style="border:1px #AAA solid;padding:0.2em;"|[[Raspberry]]
|style="border:1px #AAA solid;padding:0.2em;"|Raspberry Wine
|style="border:1px #AAA solid;padding:0.2em;"|2
|style="border:1px #AAA solid;padding:0.2em;background-color:#fcc"|Fruit-based
|style="border:1px #AAA solid;padding:0.2em;"|Outdoors
|-
|style="border:1px #AAA solid;padding:0.2em;"|[[Sand pear]]
|style="border:1px #AAA solid;padding:0.2em;"|Sand Pear Cider
|style="border:1px #AAA solid;padding:0.2em;"|2
|style="border:1px #AAA solid;padding:0.2em;background-color:#fcc"|Fruit-based
|style="border:1px #AAA solid;padding:0.2em;"|Outdoors
|-
|style="border:1px #AAA solid;padding:0.2em;"|[[Honey]]
|style="border:1px #AAA solid;padding:0.2em;"|Mead
|style="border:1px #AAA solid;padding:0.2em;"|1
|style="border:1px #AAA solid;padding:0.2em;background-color:#dddddd"|Animal-based
|style="border:1px #AAA solid;padding:0.2em;"|Outdoors
|}

== See also ==
* [[Thirst]]
* [[Crop]]
* [[Brewer]]
* [[Beekeeping industry]]

{{Industry}}

Alcohol

2014-07-26T19:04:19Z

Talvieno: Fixed a few of the red links. It appears we need new pages for some of the stuff.

{{quality|unrated}}
{{av}}
[[File:Thirsty Dwarves.gif|thumb|right|A booze [[stockpile]] at work.]]
'''Alcohol''' is the favored drink of the [[Dwarf|dwarves]]; a dwarf will drink booze an average of four times per [[calendar|season]] to satisfy their [[thirst]], and although they can subsist on [[water]], without booze they will work increasingly slowly. Dwarves like to have some variety in what they drink, and will garner a bad thought if they are forced to drink the same variety of drink repeatedly ("has been tired of drinking the same old booze lately"). Every dwarf likewise has [[preference]]s for various types of drinks, starting hidden and then appearing as each type of drink becomes known to your fortress. Thus alcohol is important both for maintaining your fortress (at a minimum) and (with some investment in variety) for keeping your dwarves happy.

== Acquisition ==
Most of the [[crop|plants]] in the game can be turned into drink, and thus most drink is sourced from dwarven [[farming]], both indoor and out. Most of the plants [[plant gathering|gathered]] from the wild can also be used for brewing, but the reduced yields relative to farming makes it a less ideal solution. Drinks can be sourced at [[embark#supplies|embarkation]], and taking at least a few barrels with you is recommended to hold your initial dwarves over until you can build a [[still]]. [[Caravan]]s always bring some drinks along as well, although not enough to support a reasonably large fortress. Finally, [[honey]] acquired through [[beekeeping industry|beekeeping]] can be brewed into alcoholic mead, the only form of drink that is not derived from plants.

The most direct way to acquire the booze itself is through a [[still]]; large fortresses will usually have one or more dedicated [[brewer]]s keeping the dwarven drinks cellar well stocked. To brew a drink a dwarf will need an empty watertight container of some kind (either a [[barrel]] or a [[large pot]]) and a [[stack]] of brewables. Each brewing job produces five units of alcohol per brewable item and deposits the alcohol in the container, recovering any plant [[seed]]s in the process. The size of a stack does not affect how long it takes to brew it, which is based entirely on the brewer's [[skill]], making brewing jobs performed on large stacks much more efficient than those done on individual consumables. Stacks of alcohol do not have quality levels, and the strength of a happy thought obtained by drinking alcohol is based entirely on the value of the drink (including the stack size) and the dwarf's personal preferences.

== Mechanics ==
Dwarven thirst is constrained by the important [ALCOHOL_DEPENDENT] [[creature token]] tag, which causes them to suffer severe performance penalties when deprived of alcohol. Thirsty dwarves increasingly lose [[speed]] in almost every activity, including basic movement; dwarves will also wait longer before drinking from a non-alcoholic water source, resulting in negative [[thought]]s from thirst. Alcohol withdrawal appears in the dwarf's thoughts and preferences as "starting to work slowly due to its scarcity" after 3 months, "really wants a drink" after 6 months, "has gone without a drink for far, far too long" after 9 months, and finally "can't even remember the last time he/she had some" after an entire year. Precisely how much dwarves trudge their feet due to alcohol withdrawal is unknown.

While dwarves rely on alcohol from the moment they are born, creatures of ''any'' race who are exposed to enough combat to become fully hardened ("doesn't really care about anything anymore") will also become alcoholics.

Setting booze on [[fire]] will not cause it to explode, but exposing it to high [[temperature]]s ''will'' cause it to boil away. If the container is flammable, it (and, subsequently, the booze) will be consumed by fire; [[magma-safe]] containers would never be destroyed by [[magma]], but any booze inside will likely quickly perish due to heat transfer (unless the container is made of [[nether-cap]]).

== Types of Alcohol ==
{|style="margin:1em 1em 1em 0;background:#F9F9F9;border:1px #AAA solid;border-collapse:collapse;" width="90%" class="wikitable sortable"
|- style="background:#F2F2F2;text-align:center;"
!style="border:1px #AAA solid;padding:0.2em;"|Ingredient
!style="border:1px #AAA solid;padding:0.2em;"|Beverage Produced
!style="border:1px #AAA solid;padding:0.2em;" align="center"|Beverage Value
!style="border:1px #AAA solid;padding:0.2em;" align="center"|Type
!style="border:1px #AAA solid;padding:0.2em;" align="center"|Source
|-
|style="border:1px #AAA solid;padding:0.2em;"|[[Plump helmet]]
|style="border:1px #AAA solid;padding:0.2em;"|Dwarven Wine
|style="border:1px #AAA solid;padding:0.2em;"|2
|style="border:1px #AAA solid;padding:0.2em; background-color:#cfc "|Plant-based
|style="border:1px #AAA solid;padding:0.2em;"|Indoors
|-
|style="border:1px #AAA solid;padding:0.2em;"|[[Pig tail]]
|style="border:1px #AAA solid;padding:0.2em;"|Dwarven Ale
|style="border:1px #AAA solid;padding:0.2em;"|2
|style="border:1px #AAA solid;padding:0.2em; background-color:#cfc "|Plant-based
|style="border:1px #AAA solid;padding:0.2em;"|Indoors
|-
|style="border:1px #AAA solid;padding:0.2em;"|[[Cave wheat]]
|style="border:1px #AAA solid;padding:0.2em;"|Dwarven Beer
|style="border:1px #AAA solid;padding:0.2em;"|2
|style="border:1px #AAA solid;padding:0.2em; background-color:#cfc "|Plant-based
|style="border:1px #AAA solid;padding:0.2em;"|Indoors
|-
|style="border:1px #AAA solid;padding:0.2em;"|[[Sweet pod]]
|style="border:1px #AAA solid;padding:0.2em;"|Dwarven Rum
|style="border:1px #AAA solid;padding:0.2em;"|2
|style="border:1px #AAA solid;padding:0.2em; background-color:#cfc "|Plant-based
|style="border:1px #AAA solid;padding:0.2em;"|Indoors
|-
|style="border:1px #AAA solid;padding:0.2em;"|[[Muck root]]
|style="border:1px #AAA solid;padding:0.2em;"|Swamp Whiskey
|style="border:1px #AAA solid;padding:0.2em;"|1
|style="border:1px #AAA solid;padding:0.2em; background-color:#cfc "|Plant-based
|style="border:1px #AAA solid;padding:0.2em;"|Outdoors
|-
|style="border:1px #AAA solid;padding:0.2em;"|[[Bloated tuber]]
|style="border:1px #AAA solid;padding:0.2em;"|Tuber Beer
|style="border:1px #AAA solid;padding:0.2em;"|2
|style="border:1px #AAA solid;padding:0.2em; background-color:#cfc "|Plant-based
|style="border:1px #AAA solid;padding:0.2em;"|Outdoors
|-
|style="border:1px #AAA solid;padding:0.2em;"|[[Prickle berry]]
|style="border:1px #AAA solid;padding:0.2em;"|Prickle Berry Wine
|style="border:1px #AAA solid;padding:0.2em;"|1
|style="border:1px #AAA solid;padding:0.2em; background-color:#cfc "|Plant-based
|style="border:1px #AAA solid;padding:0.2em;"|Outdoors
|-
|style="border:1px #AAA solid;padding:0.2em;"|[[Wild strawberry]]
|style="border:1px #AAA solid;padding:0.2em;"|Strawberry Wine
|style="border:1px #AAA solid;padding:0.2em;"|2
|style="border:1px #AAA solid;padding:0.2em; background-color:#cfc "|Plant-based
|style="border:1px #AAA solid;padding:0.2em;"|Outdoors
|-
|style="border:1px #AAA solid;padding:0.2em;"|[[Longland grass]]
|style="border:1px #AAA solid;padding:0.2em;"|Longland Beer
|style="border:1px #AAA solid;padding:0.2em;"|2
|style="border:1px #AAA solid;padding:0.2em; background-color:#cfc "|Plant-based
|style="border:1px #AAA solid;padding:0.2em;"|Outdoors
|-
|style="border:1px #AAA solid;padding:0.2em;"|[[Rat weed]]
|style="border:1px #AAA solid;padding:0.2em;"|Sewer Brew
|style="border:1px #AAA solid;padding:0.2em;"|1
|style="border:1px #AAA solid;padding:0.2em; background-color:#cfc "|Plant-based
|style="border:1px #AAA solid;padding:0.2em;"|Outdoors
|-
|style="border:1px #AAA solid;padding:0.2em;"|[[Fisher berry]]
|style="border:1px #AAA solid;padding:0.2em;"|Fisher Berry Wine
|style="border:1px #AAA solid;padding:0.2em;"|2
|style="border:1px #AAA solid;padding:0.2em; background-color:#cfc "|Plant-based
|style="border:1px #AAA solid;padding:0.2em;"|Outdoors
|-
|style="border:1px #AAA solid;padding:0.2em;"|[[Rope reed]]
|style="border:1px #AAA solid;padding:0.2em;"|River Spirits
|style="border:1px #AAA solid;padding:0.2em;"|2
|style="border:1px #AAA solid;padding:0.2em; background-color:#cfc"|Plant-based
|style="border:1px #AAA solid;padding:0.2em;"|Outdoors
|-
|style="border:1px #AAA solid;padding:0.2em;"|[[Sliver barb]]
|style="border:1px #AAA solid;padding:0.2em;"|Gutter Cruor
|style="border:1px #AAA solid;padding:0.2em;"|1
|style="border:1px #AAA solid;padding:0.2em;background-color:#cfc"|Plant-based
|style="border:1px #AAA solid;padding:0.2em;"|Outdoors
|-
|style="border:1px #AAA solid;padding:0.2em;"|[[Sun berry]]
|style="border:1px #AAA solid;padding:0.2em;"|Sunshine
|style="border:1px #AAA solid;padding:0.2em;"|5
|style="border:1px #AAA solid;padding:0.2em;background-color:#cfc"|Plant-based
|style="border:1px #AAA solid;padding:0.2em;"|Outdoors
|-
|style="border:1px #AAA solid;padding:0.2em;"|[[Whip vine]]
|style="border:1px #AAA solid;padding:0.2em;"|Whip Wine
|style="border:1px #AAA solid;padding:0.2em;"|3
|style="border:1px #AAA solid;padding:0.2em;background-color:#cfc"|Plant-based
|style="border:1px #AAA solid;padding:0.2em;"|Outdoors
|-
|style="border:1px #AAA solid;padding:0.2em;"|[[Barley]]
|style="border:1px #AAA solid;padding:0.2em;"|Barley Wine
|style="border:1px #AAA solid;padding:0.2em;"|2
|style="border:1px #AAA solid;padding:0.2em;background-color:#cfc"|Plant-based
|style="border:1px #AAA solid;padding:0.2em;"|Outdoors
|-
|style="border:1px #AAA solid;padding:0.2em;"|[[Cassava]]
|style="border:1px #AAA solid;padding:0.2em;"|Cassava Beer
|style="border:1px #AAA solid;padding:0.2em;"|2
|style="border:1px #AAA solid;padding:0.2em;background-color:#cfc"|Plant-based
|style="border:1px #AAA solid;padding:0.2em;"|Outdoors
|-
|style="border:1px #AAA solid;padding:0.2em;"|[[Kaniwa]]
|style="border:1px #AAA solid;padding:0.2em;"|Kaniwa Beer
|style="border:1px #AAA solid;padding:0.2em;"|2
|style="border:1px #AAA solid;padding:0.2em;background-color:#cfc"|Plant-based
|style="border:1px #AAA solid;padding:0.2em;"|Outdoors
|-
|style="border:1px #AAA solid;padding:0.2em;"|[[Parsnip]]
|style="border:1px #AAA solid;padding:0.2em;"|Parsnip Wine
|style="border:1px #AAA solid;padding:0.2em;"|2
|style="border:1px #AAA solid;padding:0.2em;background-color:#cfc"|Plant-based
|style="border:1px #AAA solid;padding:0.2em;"|Outdoors
|-
|style="border:1px #AAA solid;padding:0.2em;"|[[Pendant amaranth]]
|style="border:1px #AAA solid;padding:0.2em;"|Pendant Amaranth Wine
|style="border:1px #AAA solid;padding:0.2em;"|2
|style="border:1px #AAA solid;padding:0.2em;background-color:#cfc"|Plant-based
|style="border:1px #AAA solid;padding:0.2em;"|Outdoors
|-
|style="border:1px #AAA solid;padding:0.2em;"|[[Quinoa]]
|style="border:1px #AAA solid;padding:0.2em;"|Quinoa Beer
|style="border:1px #AAA solid;padding:0.2em;"|2
|style="border:1px #AAA solid;padding:0.2em;background-color:#cfc"|Plant-based
|style="border:1px #AAA solid;padding:0.2em;"|Outdoors
|-
|style="border:1px #AAA solid;padding:0.2em;"|[[Radish]]
|style="border:1px #AAA solid;padding:0.2em;"|Radish Wine
|style="border:1px #AAA solid;padding:0.2em;"|2
|style="border:1px #AAA solid;padding:0.2em;background-color:#cfc"|Plant-based
|style="border:1px #AAA solid;padding:0.2em;"|Outdoors
|-
|style="border:1px #AAA solid;padding:0.2em;"|[[Rice]]
|style="border:1px #AAA solid;padding:0.2em;"|Rice Beer
|style="border:1px #AAA solid;padding:0.2em;"|2
|style="border:1px #AAA solid;padding:0.2em;background-color:#cfc"|Plant-based
|style="border:1px #AAA solid;padding:0.2em;"|Outdoors
|-
|style="border:1px #AAA solid;padding:0.2em;"|[[Rye]]
|style="border:1px #AAA solid;padding:0.2em;"|Rye Beer
|style="border:1px #AAA solid;padding:0.2em;"|2
|style="border:1px #AAA solid;padding:0.2em;background-color:#cfc"|Plant-based
|style="border:1px #AAA solid;padding:0.2em;"|Outdoors
|-
|style="border:1px #AAA solid;padding:0.2em;"|[[Spelt]]
|style="border:1px #AAA solid;padding:0.2em;"|Spelt Beer
|style="border:1px #AAA solid;padding:0.2em;"|2
|style="border:1px #AAA solid;padding:0.2em;background-color:#cfc"|Plant-based
|style="border:1px #AAA solid;padding:0.2em;"|Outdoors
|-
|style="border:1px #AAA solid;padding:0.2em;"|[[Sweet potato]]
|style="border:1px #AAA solid;padding:0.2em;"|Sweet Potato Wine
|style="border:1px #AAA solid;padding:0.2em;"|2
|style="border:1px #AAA solid;padding:0.2em;background-color:#cfc"|Plant-based
|style="border:1px #AAA solid;padding:0.2em;"|Outdoors
|-
|style="border:1px #AAA solid;padding:0.2em;"|[[Tomatillo]]
|style="border:1px #AAA solid;padding:0.2em;"|Tomatillo Wine
|style="border:1px #AAA solid;padding:0.2em;"|2
|style="border:1px #AAA solid;padding:0.2em;background-color:#cfc"|Plant-based
|style="border:1px #AAA solid;padding:0.2em;"|Outdoors
|-
|style="border:1px #AAA solid;padding:0.2em;"|[[White millet]]
|style="border:1px #AAA solid;padding:0.2em;"|White Millet Beer
|style="border:1px #AAA solid;padding:0.2em;"|2
|style="border:1px #AAA solid;padding:0.2em;background-color:#cfc"|Plant-based
|style="border:1px #AAA solid;padding:0.2em;"|Outdoors
|-
|style="border:1px #AAA solid;padding:0.2em;"|[[Wild carrot]]
|style="border:1px #AAA solid;padding:0.2em;"|Carrot Wine
|style="border:1px #AAA solid;padding:0.2em;"|2
|style="border:1px #AAA solid;padding:0.2em;background-color:#cfc"|Plant-based
|style="border:1px #AAA solid;padding:0.2em;"|Outdoors
|-
|style="border:1px #AAA solid;padding:0.2em;"|[[Apple]]
|style="border:1px #AAA solid;padding:0.2em;"|Apple Cider
|style="border:1px #AAA solid;padding:0.2em;"|2
|style="border:1px #AAA solid;padding:0.2em;background-color:#fcc"|Fruit-based
|style="border:1px #AAA solid;padding:0.2em;"|Outdoors
|-
|style="border:1px #AAA solid;padding:0.2em;"|[[Apricot]]
|style="border:1px #AAA solid;padding:0.2em;"|Apricot Wine
|style="border:1px #AAA solid;padding:0.2em;"|2
|style="border:1px #AAA solid;padding:0.2em;background-color:#fcc"|Fruit-based
|style="border:1px #AAA solid;padding:0.2em;"|Outdoors
|-
|style="border:1px #AAA solid;padding:0.2em;"|[[Banana]]
|style="border:1px #AAA solid;padding:0.2em;"|Banana Beer
|style="border:1px #AAA solid;padding:0.2em;"|2
|style="border:1px #AAA solid;padding:0.2em;background-color:#fcc"|Fruit-based
|style="border:1px #AAA solid;padding:0.2em;"|Outdoors
|-
|style="border:1px #AAA solid;padding:0.2em;"|[[Bayberry]]
|style="border:1px #AAA solid;padding:0.2em;"|Bayberry Wine
|style="border:1px #AAA solid;padding:0.2em;"|2
|style="border:1px #AAA solid;padding:0.2em;background-color:#fcc"|Fruit-based
|style="border:1px #AAA solid;padding:0.2em;"|Outdoors
|-
|style="border:1px #AAA solid;padding:0.2em;"|[[Bilberry]]
|style="border:1px #AAA solid;padding:0.2em;"|Bilberry Wine
|style="border:1px #AAA solid;padding:0.2em;"|2
|style="border:1px #AAA solid;padding:0.2em;background-color:#fcc"|Fruit-based
|style="border:1px #AAA solid;padding:0.2em;"|Outdoors
|-
|style="border:1px #AAA solid;padding:0.2em;"|[[Blackberry]]
|style="border:1px #AAA solid;padding:0.2em;"|Blackberry Wine
|style="border:1px #AAA solid;padding:0.2em;"|2
|style="border:1px #AAA solid;padding:0.2em;background-color:#fcc"|Fruit-based
|style="border:1px #AAA solid;padding:0.2em;"|Outdoors
|-
|style="border:1px #AAA solid;padding:0.2em;"|[[Blueberry]]
|style="border:1px #AAA solid;padding:0.2em;"|Blueberry Wine
|style="border:1px #AAA solid;padding:0.2em;"|2
|style="border:1px #AAA solid;padding:0.2em;background-color:#fcc"|Fruit-based
|style="border:1px #AAA solid;padding:0.2em;"|Outdoors
|-
|style="border:1px #AAA solid;padding:0.2em;"|[[Cherry]]
|style="border:1px #AAA solid;padding:0.2em;"|Cherry Wine
|style="border:1px #AAA solid;padding:0.2em;"|2
|style="border:1px #AAA solid;padding:0.2em;background-color:#fcc"|Fruit-based
|style="border:1px #AAA solid;padding:0.2em;"|Outdoors
|-
|style="border:1px #AAA solid;padding:0.2em;"|[[Cranberry]]
|style="border:1px #AAA solid;padding:0.2em;"|Cranberry Wine
|style="border:1px #AAA solid;padding:0.2em;"|2
|style="border:1px #AAA solid;padding:0.2em;background-color:#fcc"|Fruit-based
|style="border:1px #AAA solid;padding:0.2em;"|Outdoors
|-
|style="border:1px #AAA solid;padding:0.2em;"|[[Custard apple]]
|style="border:1px #AAA solid;padding:0.2em;"|Custard Apple Cider
|style="border:1px #AAA solid;padding:0.2em;"|2
|style="border:1px #AAA solid;padding:0.2em;background-color:#fcc"|Fruit-based
|style="border:1px #AAA solid;padding:0.2em;"|Outdoors
|-
|style="border:1px #AAA solid;padding:0.2em;"|[[Passion fruit]]
|style="border:1px #AAA solid;padding:0.2em;"|Passion Fruit Wine
|style="border:1px #AAA solid;padding:0.2em;"|2
|style="border:1px #AAA solid;padding:0.2em;background-color:#fcc"|Fruit-based
|style="border:1px #AAA solid;padding:0.2em;"|Outdoors
|-
|style="border:1px #AAA solid;padding:0.2em;"|[[Papaya]]
|style="border:1px #AAA solid;padding:0.2em;"|Papaya Wine
|style="border:1px #AAA solid;padding:0.2em;"|2
|style="border:1px #AAA solid;padding:0.2em;background-color:#fcc"|Fruit-based
|style="border:1px #AAA solid;padding:0.2em;"|Outdoors
|-
|style="border:1px #AAA solid;padding:0.2em;"|[[Peach]]
|style="border:1px #AAA solid;padding:0.2em;"|Peach Cider
|style="border:1px #AAA solid;padding:0.2em;"|2
|style="border:1px #AAA solid;padding:0.2em;background-color:#fcc"|Fruit-based
|style="border:1px #AAA solid;padding:0.2em;"|Outdoors
|-
|style="border:1px #AAA solid;padding:0.2em;"|[[Pear]]
|style="border:1px #AAA solid;padding:0.2em;"|Perry
|style="border:1px #AAA solid;padding:0.2em;"|2
|style="border:1px #AAA solid;padding:0.2em;background-color:#fcc"|Fruit-based
|style="border:1px #AAA solid;padding:0.2em;"|Outdoors
|-
|style="border:1px #AAA solid;padding:0.2em;"|[[Plum]]
|style="border:1px #AAA solid;padding:0.2em;"|Plum Wine
|style="border:1px #AAA solid;padding:0.2em;"|2
|style="border:1px #AAA solid;padding:0.2em;background-color:#fcc"|Fruit-based
|style="border:1px #AAA solid;padding:0.2em;"|Outdoors
|-
|style="border:1px #AAA solid;padding:0.2em;"|[[Raspberry]]
|style="border:1px #AAA solid;padding:0.2em;"|Raspberry Wine
|style="border:1px #AAA solid;padding:0.2em;"|2
|style="border:1px #AAA solid;padding:0.2em;background-color:#fcc"|Fruit-based
|style="border:1px #AAA solid;padding:0.2em;"|Outdoors
|-
|style="border:1px #AAA solid;padding:0.2em;"|[[Sand pear]]
|style="border:1px #AAA solid;padding:0.2em;"|Sand Pear Cider
|style="border:1px #AAA solid;padding:0.2em;"|2
|style="border:1px #AAA solid;padding:0.2em;background-color:#fcc"|Fruit-based
|style="border:1px #AAA solid;padding:0.2em;"|Outdoors
|-
|style="border:1px #AAA solid;padding:0.2em;"|[[Honey]]
|style="border:1px #AAA solid;padding:0.2em;"|Mead
|style="border:1px #AAA solid;padding:0.2em;"|1
|style="border:1px #AAA solid;padding:0.2em;background-color:#dddddd"|Animal-based
|style="border:1px #AAA solid;padding:0.2em;"|Outdoors
|}

== See also ==
* [[Thirst]]
* [[Crop]]
* [[Brewer]]
* [[Beekeeping industry]]

{{Industry}}

Unfortunate accident

2014-07-26T18:45:11Z

Talvieno: Missed a redlink; fixed.

{{av}}
{{Quality|Exceptional|08:26, 18 July 2010 (UTC)}}
{{D for Dwarf}}
[[Noble]]s are fragile, delicate, put-upon beings, burdened with responsibilities which are far more taxing than any lowly commoner could ever hope to wrap their [[Alcohol|booze]]-soaked brains around. However, your dear friends at Happy Fun Surprises Incorporated (Stock Exchange Symbol: "HFS") have prepared a wide variety of [[Losing|Fun]] activities to help your administrators unwind.

==Lever Of Mystery==
What activity could be more fit for nobility than the investigation of mysterious levers? Will it collapse the roof? Will it [[Main:Boatmurdered|flood the world with magma?]] Will it simply lure the duchess into an enclosed space so the unwashed masses can barricade her in and flood it? Any noble -- no matter where they happen to be -- will surely come running to the lever's location to savor the thrill of the unknown!

Be sure to use the Workshop Profile screen to restrict the lever to the noble in need of some down time. After all, it just wouldn't do to have some filthy commoner pull it instead.

==Underground Safari==
The [[Forgotten beast|fantastic beasts]] lurking in the darkness of the underground [[caverns]] would surely captivate any noble with an appreciation for nature. Why not send them out into the darkness so they can experience these [[Giant cave spider|wonders]] for themselves? While your noble is out and about, make sure to keep an eye on the entryway in case any unruly commoners should attempt to wall it off. After all, what would happen if your baron got hungry, or was attacked by [[giant cave swallow]]s, or had his face melted by a [[forgotten beast]]'s venom, and there was no way for him to return to the safety of the fortress? The horror!

==Throne Room Over Troubled Magma==
Aside from being the home of many strange and wonderful beasts, the deepest places of the earth also give access to vast [[Magma sea|seas of magma]]. Imagine the powerful and intimidating effect of a [[Office|throne room]] suspended over the sizzling surface of the abyssal planes! Such a throne room would befit only the greatest of nobles, of course. Common dwarves would have no place in such a suite. Therefore, be sure to build a retractable [[bridge]] from the shore to the throne room, with the associated [[lever]] placed ''inside'' the room.

==The Situation Room==
Your ever-loyal cadre of nobles have to make hard decisions every day that affect the economic and social future of your fortress. Debating psychosocial theory in front of the less-gifted working class may frighten and demoralize them. For this reason, place your [[Noble|Magenta Magnates]] inside a room with plenty of seating. Once all of your people are inside, lock the door behind them while they hash out a plan. To assist in the discussion, you may wish to place a bin of [[Weapon|debating tools]] in the room with them. Nobles under pressure think quickly, particularly on an empty stomach.

==Speartiful==
Your wonderful nobles love the beautiful weapons that come out of your forges. Why else would they ask for weapon racks? Maybe you should make them happy and give them some weapons. Simply lay a bunch of upright spears or [[Trap component#Menacing_spike|other beautiful things]] on the floor of their room and they'll come begging for more. Now, you may want to link those spears to a lever and pull it so they can actually walk around their room, remember to leave it on repeat so they'll be able to see the wonders that your [[weaponsmith]]s made every passing second. Just make sure they '''are'''n't in the room while the spears are in motion, or your nobles may become dwarven Swiss cheese and die before their screams can even be heard. And, if possible, whatever you do, '''do''' not use adamantine spears!

==Exotic Housing==
What more could your nobles want than some truly fantastic housing to call their own? Maybe you can build them a huuuuge tower, balancing on a single support as a miracle of dwarven engineering? Or perhaps a house made of glass, which is then flooded over? No door required, that'd just ruin the view. Maybe even a palace down a great hole, where you could throw new [[Goblin|friends]] that have come to visit your fortress?

==Grave(n) Image==
The nobles serve everyday, day after day, to tirelessly [[syndrome|serve]] your fort. All they demand are some [[slade|nice]] [[artifact|furniture]] for their personal rooms and some recognition. Symbolizing their eternal bond with the mountains, be sure to sculpt it from obsidian. What could be better? Make sure it's fresh by casting it <s>on</s> near the noble. To ensure that the image to be special, arrange for the likeness to be created by only the finest mason. If done correctly, the noble will be forever invested in the fortress, to the delight of the workers.

==Artifact==
What could be possibly better than a big, imposing artifact made <s>from</s> for a noble, as a tribute to how special the noble is? Simply house a noble next to a craftsdwarf's, leatherworker's, or butcher's workshop, and house as well the unhappy, disgruntled hauler next to it. Wait. And when [[DF2012:Mood#Fell|a beautiful laughter]] is heard, make sure the happy dwarf is next to the noble, so he can share the [[fun]]! Make also sure the resulting artifact is made so it records the noble's life!

==Immortality==
Every noble's dream is to rule forever, so make them happy ! Rather than <s>murdering</s> honoring the noble, what about making them eternal and fit to rule? Make them drink the blood of the [[vampire|children of the night]]! Let them partake in the gift of [[werebeast|shapechanging beasts]]! Then isolate them to let them ponder on their new status for a while, make sure they do <s>not</s> have a room worthy of their standing, then when they are [[Insanity|suitably happy about immortality, or suddenly unhappy about it]], let them outside and welcome them as <s>utterly insane and harmless</s> the reasonable rulers they are!
If [[Berserk|the dwarf is frustrated by the experience]], though, there is no need to worry! Build an engraved [[gold]] [[cage|house]], [[trap|persuade them into their new home]] and let them rule from here!

==Diplomatic Outreach==
There's nothing a good noble loves more than politics and diplomacy. In fact, the next time a disgruntled group of goblins shows up, your nobles would be downright miffed if they didn't get a chance to practice their diplomacy. Designate a [[burrow|diplomatic outpost]] in front of your fortress, and make sure it is well stocked with food and alcohol. That way, your nobles can have many long, engaging conversations with your neighboring goblins. I'm sure they will be very productive.

==Talk Like a Pirate Day==
Plenty of nobles enjoy celebrating International Talk Like a Pirate Day, on [[Calendar|the 19th of Limestone]]. So let your [[Mandate|favorite]] member of the nobility have a little fun with it, to get into the spirit of the holiday. Maybe give him a pet [[Giant kea|parrot]]. Or build a ship and let him [[Drowning chamber|sail the ocean blue]]. If he doesn't feel in the mood, the other [[Hammerer|scurvy dogs]] will be quite pleased to make that landlubber walk the plank.

==Tropical Vacation==
Every noble would love to go to [[Hell|areas with a warm climate]], but why stop there? Take him to a place fit for a dwarf king, [[Hell|somewhere hot and underground]]! He could [[death|chat]] with the [[Demon|locals]], and have lots of [[Fun]]! If he gets [[tantrum|stressed]], there are plenty of [[Magma|native hot tubs]] to take a break in! If he doesn't feel convinced, there is always room for the [[king]]!

Unfortunate accident

2014-07-26T18:44:07Z

Talvieno: Unfortunate accidents are the same as ever. Might need something about trees now, though. Removed migration tag.

{{av}}
{{Quality|Exceptional|08:26, 18 July 2010 (UTC)}}
{{D for Dwarf}}
[[Noble]]s are fragile, delicate, put-upon beings, burdened with responsibilities which are far more taxing than any lowly commoner could ever hope to wrap their [[Alcohol|booze]]-soaked brains around. However, your dear friends at Happy Fun Surprises Incorporated (Stock Exchange Symbol: "HFS") have prepared a wide variety of [[Losing|Fun]] activities to help your administrators unwind.

==Lever Of Mystery==
What activity could be more fit for nobility than the investigation of mysterious levers? Will it collapse the roof? Will it [[Main:Boatmurdered|flood the world with magma?]] Will it simply lure the duchess into an enclosed space so the unwashed masses can barricade her in and flood it? Any noble -- no matter where they happen to be -- will surely come running to the lever's location to savor the thrill of the unknown!

Be sure to use the Workshop Profile screen to restrict the lever to the noble in need of some down time. After all, it just wouldn't do to have some filthy commoner pull it instead.

==Underground Safari==
The [[Forgotten beast|fantastic beasts]] lurking in the darkness of the underground [[caverns]] would surely captivate any noble with an appreciation for nature. Why not send them out into the darkness so they can experience these [[Giant cave spider|wonders]] for themselves? While your noble is out and about, make sure to keep an eye on the entryway in case any unruly commoners should attempt to wall it off. After all, what would happen if your baron got hungry, or was attacked by [[giant cave swallow]]s, or had his face melted by a [[forgotten beast]]'s venom, and there was no way for him to return to the safety of the fortress? The horror!

==Throne Room Over Troubled Magma==
Aside from being the home of many strange and wonderful beasts, the deepest places of the earth also give access to vast [[Magma sea|seas of magma]]. Imagine the powerful and intimidating effect of a [[Office|throne room]] suspended over the sizzling surface of the abyssal planes! Such a throne room would befit only the greatest of nobles, of course. Common dwarves would have no place in such a suite. Therefore, be sure to build a retractable [[bridge]] from the shore to the throne room, with the associated [[lever]] placed ''inside'' the room.

==The Situation Room==
Your ever-loyal cadre of nobles have to make hard decisions every day that affect the economic and social future of your fortress. Debating psychosocial theory in front of the less-gifted working class may frighten and demoralize them. For this reason, place your [[Noble|Magenta Magnates]] inside a room with plenty of seating. Once all of your people are inside, lock the door behind them while they hash out a plan. To assist in the discussion, you may wish to place a bin of [[Weapon|debating tools]] in the room with them. Nobles under pressure think quickly, particularly on an empty stomach.

==Speartiful==
Your wonderful nobles love the beautiful weapons that come out of your forges. Why else would they ask for weapon racks? Maybe you should make them happy and give them some weapons. Simply lay a bunch of upright spears or [[Trap component#Menacing_spike|other beautiful things]] on the floor of their room and they'll come begging for more. Now, you may want to link those spears to a lever and pull it so they can actually walk around their room, remember to leave it on repeat so they'll be able to see the wonders that your [[weaponsmith]]s made every passing second. Just make sure they '''are'''n't in the room while the spears are in motion, or your nobles may become dwarven Swiss cheese and die before their screams can even be heard. And, if possible, whatever you do, '''do''' not use adamantine spears!

==Exotic Housing==
What more could your nobles want than some truly fantastic housing to call their own? Maybe you can build them a huuuuge tower, balancing on a single support as a miracle of dwarven engineering? Or perhaps a house made of glass, which is then flooded over? No door required, that'd just ruin the view. Maybe even a palace down a great hole, where you could throw new [[Goblin|friends]] that have come to visit your fortress?

==Grave(n) Image==
The nobles serve everyday, day after day, to tirelessly [[syndrome|serve]] your fort. All they demand are some [[slade|nice]] [[artifact|furniture]] for their personal rooms and some recognition. Symbolizing their eternal bond with the mountains, be sure to sculpt it from obsidian. What could be better? Make sure it's fresh by casting it <s>on</s> near the noble. To ensure that the image to be special, arrange for the likeness to be created by only the finest mason. If done correctly, the noble will be forever invested in the fortress, to the delight of the workers.

==Artifact==
What could be possibly better than a big, imposing artifact made <s>from</s> for a noble, as a tribute to how special the noble is? Simply house a noble next to a craftsdwarf's, leatherworker's, or butcher's workshop, and house as well the unhappy, disgruntled hauler next to it. Wait. And when [[DF2012:Mood#Fell|a beautiful laughter]] is heard, make sure the happy dwarf is next to the noble, so he can share the [[fun]]! Make also sure the resulting artifact is made so it records the noble's life!

==Immortality==
Every noble's dream is to rule forever, so make them happy ! Rather than <s>murdering</s> honoring the noble, what about making them eternal and fit to rule? Make them drink the blood of the [[vampire|children of the night]]! Let them partake in the gift of [[werebeast|shapechanging beasts]]! Then isolate them to let them ponder on their new status for a while, make sure they do <s>not</s> have a room worthy of their standing, then when they are [[Insanity|suitably happy about immortality, or suddenly unhappy about it]], let them outside and welcome them as <s>utterly insane and harmless</s> the reasonable rulers they are!
If [[Berserk|the dwarf is frustrated by the experience]], though, there is no need to worry! Build an engraved [[gold]] [[cage|house]], [[trap|persuade them into their new home]] and let them rule from here!

==Diplomatic Outreach==
There's nothing a good noble loves more than politics and diplomacy. In fact, the next time a disgruntled group of goblins shows up, your nobles would be downright miffed if they didn't get a chance to practice their diplomacy. Designate a [[burrow|diplomatic outpost]] in front of your fortress, and make sure it is well stocked with food and alcohol. That way, your nobles can have many long, engaging conversations with your neighboring goblins. I'm sure they will be very productive.

==Talk Like a Pirate Day==
Plenty of nobles enjoy celebrating International Talk Like a Pirate Day, on [[Calendar|the 19th of Limestone]]. So let your [[Mandate|favorite]] member of the nobility have a little fun with it, to get into the spirit of the holiday. Maybe give him a pet [[Giant kea|parrot]]. Or build a ship and let him [[Drowning chamber|sail the ocean blue]]. If he doesn't feel in the mood, the other [[Hammerer|scurvy dogs]] will be quite pleased to make that landlubber walk the plank.

==Tropical Vacation==
Every noble would love to go to [[HFS|areas with a warm climate]], but why stop there? Take him to a place fit for a dwarf king, [[Hell|somewhere hot and underground]]! He could [[death|chat]] with the [[Demon|locals]], and have lots of [[Fun]]! If he gets [[tantrum|stressed]], there are plenty of [[Magma|native hot tubs]] to take a break in! If he doesn't feel convinced, there is always room for the [[king]]!

Herbalist

2014-07-26T18:40:34Z

Talvieno: Changed quality rating from "Unrated" to "Exceptional" using the rating script

{{Quality|Exceptional|18:40, 26 July 2014 (UTC)}}
{{Skill
| color = 6:0
| skill = Herbalist
| profession = [[Farmer]]
| job name = [[Plant gathering]]
| tasks =
* Gather plants
* Extract Plant Essence
| workshop =
* [[Still]]
| attributes =
* Agility
* Memory
* Kinesthetic Sense
}}
{{av}}

The '''herbalist''' skill is used by dwarves with the '''plant gathering''' [[labor]]. They will attempt to gather [[plant]]s from [[Designations Menu|designated]] [[shrub]]s. If successful, a stack of 1 to 5 plants will be produced.

== Food production ==
Herbalists are often used to help with food production in an early fortress as they do not require farm plots or other setup. While plant gathering is less efficient than [[farming]] and significantly less reliable, it provides a relatively immediate payoff in comparison. Plant gathering is also an excellent way to acquire above ground plants in order to bootstrap above ground farming (the only alternative is to wait for a human or elven caravan and hope they brought seeds).

Above ground, this skill works best in areas with thick vegetation like [[forest]]s; is less useful in sparsely vegetated biomes like [[Desert|deserts or badlands]]; and is completely useless in [[mountain]] biomes which cannot have shrubs. Underground, plant gathering can be a high risk activity in the caverns, and production can be easily outstripped by farms. However, once a non-dry cavern has been opened, underground shrubs will begin to appear on ''all'' underground soil or muddy tiles. Herbalists can continue to gather from these to supplement your farming production, at no risk.

The number of plants in a stack a herbalist gathers depends on his skill the same as with quality levels in earlier versions - for every 'bump' in quality, there is one more plant, starting with 0-1 and capped at 5.

When a herbalist picks some plants, he will carry them to the food stockpile himself, even if his food hauling labor is disabled.

== Gathering seeds ==
Plants gathered by herbalists can be eaten or processed to provide [[seed|seeds]] which can then be [[crop|planted]] in farms. For this reason, it is popular (if not necessary) to gather above ground plants early in a fort's existence if one wants to grow above ground crops.

==Speed of training==
Dwarves gain [[experience]] in plant gathering every time they pick over a shrub whether they are successful at harvesting anything or not. Training a completely unskilled dwarf to legendary status in this skill requires the harvesting of 600 plants, and can be done in less than a couple of years. A legendary herbalist not suffering from any [[Skill#Skill_penalties|skill penalties]] will never fail to harvest a stack of four or five [[crop|plant]]s.

{{skills}}

Herbalist

2014-07-26T18:40:09Z

Talvieno: Fixed redlink, removed migration text, fixed typo.

{{quality|unrated}}
{{Skill
| color = 6:0
| skill = Herbalist
| profession = [[Farmer]]
| job name = [[Plant gathering]]
| tasks =
* Gather plants
* Extract Plant Essence
| workshop =
* [[Still]]
| attributes =
* Agility
* Memory
* Kinesthetic Sense
}}
{{av}}

The '''herbalist''' skill is used by dwarves with the '''plant gathering''' [[labor]]. They will attempt to gather [[plant]]s from [[Designations Menu|designated]] [[shrub]]s. If successful, a stack of 1 to 5 plants will be produced.

== Food production ==
Herbalists are often used to help with food production in an early fortress as they do not require farm plots or other setup. While plant gathering is less efficient than [[farming]] and significantly less reliable, it provides a relatively immediate payoff in comparison. Plant gathering is also an excellent way to acquire above ground plants in order to bootstrap above ground farming (the only alternative is to wait for a human or elven caravan and hope they brought seeds).

Above ground, this skill works best in areas with thick vegetation like [[forest]]s; is less useful in sparsely vegetated biomes like [[Desert|deserts or badlands]]; and is completely useless in [[mountain]] biomes which cannot have shrubs. Underground, plant gathering can be a high risk activity in the caverns, and production can be easily outstripped by farms. However, once a non-dry cavern has been opened, underground shrubs will begin to appear on ''all'' underground soil or muddy tiles. Herbalists can continue to gather from these to supplement your farming production, at no risk.

The number of plants in a stack a herbalist gathers depends on his skill the same as with quality levels in earlier versions - for every 'bump' in quality, there is one more plant, starting with 0-1 and capped at 5.

When a herbalist picks some plants, he will carry them to the food stockpile himself, even if his food hauling labor is disabled.

== Gathering seeds ==
Plants gathered by herbalists can be eaten or processed to provide [[seed|seeds]] which can then be [[crop|planted]] in farms. For this reason, it is popular (if not necessary) to gather above ground plants early in a fort's existence if one wants to grow above ground crops.

==Speed of training==
Dwarves gain [[experience]] in plant gathering every time they pick over a shrub whether they are successful at harvesting anything or not. Training a completely unskilled dwarf to legendary status in this skill requires the harvesting of 600 plants, and can be done in less than a couple of years. A legendary herbalist not suffering from any [[Skill#Skill_penalties|skill penalties]] will never fail to harvest a stack of four or five [[crop|plant]]s.

{{skills}}

Bluefish

2014-07-26T18:38:24Z

Talvieno: Fixed red link. Accidentally did this to a 34.xx page, but no issue.

{{Quality|Exceptional|21:35, 9 July 2013 (UTC)}}
{{Creaturelookup/0
|contrib=no
|bone=6
|meat=8
|brain=1
|skull=1
|heart=1
|intestine=1
|liver=1
|tripe=1
|sweetbread=1
|spleen=1
|kidney=2
|fat=8
|skin=none
|wiki=yes
}}
{{av}}
{{creaturedesc}}

'''Bluefish''' are small oceanic fish that appear in clusters of five to ten and produce an excellent amount of [[meat]] for their size when [[butcher]]ed. Unlike many other aquatic {{Catlink|Animals|animals}} they also produce [[bone]]s, six per fish (plus a skull). Some dwarves prefer them for their coloration.

{{gamedata}}
{{Creatures}}
{{Category|Creatures}}

v0.34:Bluefish

2014-07-26T18:37:46Z

Talvieno: Fixed red link.

Gem cutter

2014-07-26T18:36:57Z

Talvieno: Changed quality rating from "Unrated" to "Exceptional" using the rating script

{{Quality|Exceptional|18:36, 26 July 2014 (UTC)}}
{{Skill
| color = 2:1
| skill = Gem Cutter
| profession = [[Jeweler]]
| job name = [[Gem cutting]]
| tasks =
* Cut ''gem name''
| workshop = [[Jeweler's workshop]]
| attributes =
* Agility
* Analytical Ability
* Spatial Sense
* Kinesthetic Sense
}}
{{av}}

A '''gem cutter''' is the profession of a dwarf whose highest skill is in gem cutting. Performed at a [[jeweler's workshop]], gem cutting is the basis of the [[gem industry]], turning mildly valuable [[gem]] clusters you find as you [[mining|mine]] away rock into valuable [[decoration]]s for [[furniture]] and [[Finished goods|trade good]]s. It is the counterpart to [[gem setting]]; together, the two belong to the category profession of the [[Jeweler]], and indeed if a dwarf has relatively balanced skill level in both, he will be known as a Jeweler. More often then not, migrants who are skilled in gem cutting will also be similarly skilled in gem setting.

Large amounts of mining are bound to produce dozens of rough gems, so gem cutting is a method of developing [[wealth]] quickly, [[Quickstart guide#Gemcutting and Trinkets|especially]] for new players. Cutting and encrusting with a gem more than triples the [[value]] of the rough gem, which is then multiplied by a [[quality]] modifier based on the gem setter's skill. A masterwork gem decoration is worth 40x the value of the original rough gem.

Cutting a [[gem]] can result in a cut gem, a large gem, or a gem [[craft]]. Cut gems are the most likely, and are used by a gem setter in creating gem [[window]]s and [[encrust]]ing other objects. Large gems and gem crafts are only created occasionally, and are currently only useful for [[trade]]. The skill level of a gem cutter affects the cutting speed, and quality of large gems and gem crafts, but not the quantity of crafts produced<sup>[[DF2012 talk:Gem_cutter|1]]</sup>.

=== Training ===
Gem cutters can cut not only gems proper but regular [[stone]], [[glass]] and [[clay]] as well. Although cut stone is next to worthless, it still provides experience points, and can be used to keep a jeweler busy while you mine out a fresh batch of gems. It is also the only way to decorate with stone, and an easy way to create [[window|windows]] without [[fuel]] or [[sand]].

{{D for Dwarf}}

How one cuts gems without a chisel or any other tool is a source of much study. The predominant theory is that dwarven teeth, sharpened and conditioned by years of eating the tough flesh of [[plump helmet|plump helmets]], function as a crude cutting tool hard enough to cut diamonds. This is followed by polishing the gem using the tough fibers of their beards, just as it's used to smooth surfaces.

{{Skills}}

Gem cutter

2014-07-26T18:36:17Z

Talvieno: Fixed red link, removed migration tag

{{quality|unrated}}{{Skill
| color = 2:1
| skill = Gem Cutter
| profession = [[Jeweler]]
| job name = [[Gem cutting]]
| tasks =
* Cut ''gem name''
| workshop = [[Jeweler's workshop]]
| attributes =
* Agility
* Analytical Ability
* Spatial Sense
* Kinesthetic Sense
}}
{{av}}

A '''gem cutter''' is the profession of a dwarf whose highest skill is in gem cutting. Performed at a [[jeweler's workshop]], gem cutting is the basis of the [[gem industry]], turning mildly valuable [[gem]] clusters you find as you [[mining|mine]] away rock into valuable [[decoration]]s for [[furniture]] and [[Finished goods|trade good]]s. It is the counterpart to [[gem setting]]; together, the two belong to the category profession of the [[Jeweler]], and indeed if a dwarf has relatively balanced skill level in both, he will be known as a Jeweler. More often then not, migrants who are skilled in gem cutting will also be similarly skilled in gem setting.

Large amounts of mining are bound to produce dozens of rough gems, so gem cutting is a method of developing [[wealth]] quickly, [[Quickstart guide#Gemcutting and Trinkets|especially]] for new players. Cutting and encrusting with a gem more than triples the [[value]] of the rough gem, which is then multiplied by a [[quality]] modifier based on the gem setter's skill. A masterwork gem decoration is worth 40x the value of the original rough gem.

Cutting a [[gem]] can result in a cut gem, a large gem, or a gem [[craft]]. Cut gems are the most likely, and are used by a gem setter in creating gem [[window]]s and [[encrust]]ing other objects. Large gems and gem crafts are only created occasionally, and are currently only useful for [[trade]]. The skill level of a gem cutter affects the cutting speed, and quality of large gems and gem crafts, but not the quantity of crafts produced<sup>[[DF2012 talk:Gem_cutter|1]]</sup>.

=== Training ===
Gem cutters can cut not only gems proper but regular [[stone]], [[glass]] and [[clay]] as well. Although cut stone is next to worthless, it still provides experience points, and can be used to keep a jeweler busy while you mine out a fresh batch of gems. It is also the only way to decorate with stone, and an easy way to create [[window|windows]] without [[fuel]] or [[sand]].

{{D for Dwarf}}

How one cuts gems without a chisel or any other tool is a source of much study. The predominant theory is that dwarven teeth, sharpened and conditioned by years of eating the tough flesh of [[plump helmet|plump helmets]], function as a crude cutting tool hard enough to cut diamonds. This is followed by polishing the gem using the tough fibers of their beards, just as it's used to smooth surfaces.

{{Skills}}

Elephant seal man

2014-07-26T16:36:34Z

Talvieno: Removed migrated article tag.

Elephant seal man

2014-07-26T16:36:17Z

Talvieno: Changed quality rating from "Unrated" to "Fine" using the rating script

{{Quality|Fine|16:36, 26 July 2014 (UTC)}}
{{Migrated_article}}

{{Creaturelookup/0}}
{{av}}
{{creaturedesc}}

{{gamedata}}
{{Creatures}}