Dwarf Fortress Wiki - User contributions [en]

v0.34 Talk:Creature token

2012-10-22T04:46:49Z

Bohandas:

Do crazed creatures refuse to attack other crazed creatures of the same species? Werebeasts don't seem to attack each other when they're the same.--[[User:HugoLuman|HugoLuman]] 07:46, 7 April 2012 (UTC)

Either CASTE_SOLDIER_ALTTILE doesn't work as described or I'm doing something wrong. Example of the RAW I'm using, I've included the human to show that tile 154 works etc.

<nowiki> [SELECT_CASTE:HUMAN_MALE]
[SELECT_ADDITIONAL_CASTE:HUMAN_FEMALE]
[DESCRIPTION:A human member of the fierce barbarian tribes of the woods and glaciers.]
[CREATURE_TILE:'@']
[CASTE_SOLDIER_TILE:154]

[SELECT_CASTE:BADGER_MAN_MALE]
[SELECT_ADDITIONAL_CASTE:BADGER_MAN_FEMALE]
[DESCRIPTION:A beastkin member of the fierce barbarian tribes of the woods and glaciers. A humanoid with the head and fur of a badger.]
[CASTE_TILE:'b']
[CASTE_SOLDIER_ALTTILE:154]
</nowiki>
- Autonomy
:You have to specify CASTE_SOLDIER_ALTTILE '''and''' CASTE_SOLDIER_TILE... --[[User:Quietust|Quietust]] 00:08, 20 April 2012 (UTC)
:Thanks, much better now - Autonomy

I added links to the "attribute" and "skill token" pages in appropriate places. While modding some critters, I found it quite difficult to find the valid values for these things, hopefully this will help. [[Special:Contributions/92.21.230.29|92.21.230.29]] 13:54, 29 April 2012 (UTC), who would be jimj316 had he bothered to create an account here

== DEMON, TITAN, FEATURE_BEAST, etc. ==

What tags would be required to create (or at least closely approximate) all the same creature behaviors/placement as each of the generated-only tags? —[[User:Andux|Andux]]<sup>[[User_talk:Andux|␅]]</sup> 02:48, 4 May 2012 (UTC)

== CHANGE_BODY_SIZE_PERC ==
Look like it's a multipler to source BODY_SIZE tag? --[[User:Peregarrett|Peregarrett]] 20:04, 20 August 2012 (UTC)

== Section on Material Modification needed ==
This article could use a section on material modification similar to its section on tissue modification. Does anybody know enough about the topic to do this?

v0.34 Talk:Goblin

2012-09-14T21:02:03Z

Bohandas: Created page with "The listed raws are incomplete. They show the creature raws but not the entity raws."

The listed raws are incomplete. They show the creature raws but not the entity raws.

v0.34 Talk:Ethic

2012-06-22T04:19:19Z

Bohandas: Created page with "== REQUIRED tag == Someone needs to do !!SCIENCE!! with the REQUIRED ethic response token to determine its numerical values for determining warfare chances, as well as its effec..."

== REQUIRED tag ==

Someone needs to do !!SCIENCE!! with the REQUIRED ethic response token to determine its numerical values for determining warfare chances, as well as its effects on the handful of ethic action tokens that actually have specific in-game effects. the same goes for NOT_APPLICABLE

v0.34:Ethic

2012-06-19T01:45:13Z

Bohandas: Added mention of "REQUIRED" ethic response token (see string dump)

{{quality|Exceptional|18:03, 28 April 2011 (UTC)}}{{av}}
== List of acceptable ethics tags==

Ethics tags are used in the entity_default raw file to determine how races feel about various issues. Relationships between civs are based on their ethics value numbers in relation to each other; Some yield favourable positive numbers or unfavourable negative numbers that result in ethic/civ conflict. Civs with UNTHINKABLE in a specific ethic will happily go to war with a different civ that has ACCEPTABLE in that same ethic type.

Example usage: [ETHIC:ASSAULT:PUNISH_SERIOUS]

In un-modded DF, this corresponds to wars over eating sapients and elves declaring war on everybody for harming plants and hunting/displaying trophies.

== Ethics types ==
{| {{prettytable}}
|- bgcolor="#dddddd"
!Token
!Extra Information
|-
|ASSAULT
|
|-
|EAT_SAPIENT_KILL
| This determines if the race will sometimes devour dead enemy combatants.
|-
|EAT_SAPIENT_OTHER
| This also determines whatever or not a race is willing to butcher other sapients.
|-
|KILL_ANIMAL
| A response between MISGUIDED and UNTHINKABLE (see below) causes the entity to refuse animal products in trade - namely, [[material token|materials]] with [IMPLIES_ANIMAL_KILL].
|-
|KILL_ENEMY
|
|-
|KILL_ENTITY_MEMBER
|
|-
|KILL_NEUTRAL
|
|-
|KILL_PLANT
| This determines a race's position towards wood as well - a response between MISGUIDED and UNTHINKABLE (see below) causes the entity to refuse wooden objects in trade, and it also prohibits them from bringing caravan [[wagon]]s.
|-
|LYING
|
|-
|MAKE_TROPHY_ANIMAL
|
|-
|MAKE_TROPHY_SAME_RACE
|
|-
|MAKE_TROPHY_SAPIENT
|
|-
|OATH_BREAKING
|
|-
|SLAVERY
|
|-
|THEFT
| This determines whether the race will try to steal goods.
|-
|TORTURE_ANIMALS
|
|-
|TORTURE_AS_EXAMPLE
|
|-
|TORTURE_FOR_FUN
|
|-
|TORTURE_FOR_INFORMATION
|
|-
|TREASON
|
|-
|TRESPASSING
|
|-
|VANDALISM
|
|}

==Ethics values==
In order of acceptability:

{| {{prettytable}}
|- bgcolor="#dddddd"
! Num !! Token
|-
| 0 || NOT_APPLICABLE
|-
| 1 || ACCEPTABLE
|-
| 2 || PERSONAL_MATTER
|-
| 3 || JUSTIFIED_IF_NO_REPERCUSSIONS
|-
| 4 || JUSTIFIED_IF_GOOD_REASON
|-
| 5 || JUSTIFIED_IF_EXTREME_REASON
|-
| 6 || JUSTIFIED_IF_SELF_DEFENSE
|-
| 7 || ONLY_IF_SANCTIONED
|-
| 8 || MISGUIDED
|-
| 9 || SHUN
|-
| 10 || APPALLING
|-
| 11 || PUNISH_REPRIMAND
|-
| 12 || PUNISH_SERIOUS
|-
| 13 || PUNISH_EXILE
|-
| 14 || PUNISH_CAPITAL
|-
| 15 || UNTHINKABLE
|}

[[DF2012:String dump|String Dump]] also lists "REQUIRED" as a possible ethic response token

==Ethics value numbers in relation to each other==

Note: These were given by Toady himself [http://www.bay12forums.com/smf/index.php?topic=22151.msg239689]. Anything above listed value indicator is counted for same value difference.

{| {{prettytable}}
|- bgcolor="#dddddd"
!Token
|-
|JUSTIFIED_IF_GOOD_REASON
|<pre>JUSTIFIED_IF_GOOD_REASON +2
JUSTIFIED_IF_EXTREME_REASON +1
SHUN
APPALLING
PUNISH_REPRIMAND
PUNISH_SERIOUS
PUNISH_EXILE
PUNISH_CAPITAL
UNTHINKABLE
-1
</pre>
|-
|JUSTIFIED_IF_EXTREME_REASON
|<pre>JUSTIFIED_IF_GOOD_REASON +1
JUSTIFIED_IF_EXTREME_REASON +2
SHUN
APPALLING
PUNISH_REPRIMAND
PUNISH_SERIOUS
PUNISH_EXILE
PUNISH_CAPITAL
UNTHINKABLE
PERSONAL_MATTER
ACCEPTABLE
-1
</pre>
|-
|JUSTIFIED_IF_SELF_DEFENSE
|<pre>JUSTIFIED_IF_EXTREME_REASON +1
JUSTIFIED_IF_SELF_DEFENSE +2
APPALLING
PUNISH_REPRIMAND
PUNISH_SERIOUS
PUNISH_EXILE
PUNISH_CAPITAL
UNTHINKABLE
JUSTIFIED_IF_NO_REPERCUSSIONS
-1
PERSONAL_MATTER
ACCEPTABLE
-2
</pre>
|-
|ONLY_IF_SANCTIONED
|<pre>ONLY_IF_SANCTIONED +2
JUSTIFIED_IF_EXTREME_REASON +1
JUSTIFIED_IF_NO_REPERCUSSIONS
UNTHINKABLE
APPALLING
PUNISH_REPRIMAND
PUNISH_SERIOUS
PUNISH_EXILE
PUNISH_CAPITAL
-1
PERSONAL_MATTER
ACCEPTABLE
-2
</pre>
|-
|MISGUIDED
|<pre>MISGUIDED +2
SHUN
APPALLING
PUNISH_REPRIMAND
UNTHINKABLE
+1
PUNISH_CAPITAL
PERSONAL_MATTER
ACCEPTABLE
-1
</pre>
|-
|SHUN
|<pre>SHUN +2
MISGUIDED
APPALLING
PUNISH_REPRIMAND
UNTHINKABLE
+1
PUNISH_CAPITAL
PERSONAL_MATTER
ACCEPTABLE
-1
</pre>
|-
|APPALLING
|<pre>PERSONAL_MATTER
ACCEPTABLE
-5
JUSTIFIED_IF_NO_REPERCUSSIONS -3
JUSTIFIED_IF_GOOD_REASON
ONLY_IF_SANCTIONED
-2
JUSTIFIED_IF_EXTREME_REASON
JUSTIFIED_IF_SELF_DEFENSE
-1
SHUN
PUNISH_REPRIMAND
PUNISH_SERIOUS
MISGUIDED
PUNISH_EXILE
UNTHINKABLE
+1
APPALLING +2
</pre>
|-
|PUNISH_REPRIMAND
|<pre>PERSONAL_MATTER
ACCEPTABLE
-5
JUSTIFIED_IF_NO_REPERCUSSIONS -3
JUSTIFIED_IF_GOOD_REASON
ONLY_IF_SANCTIONED
-2
JUSTIFIED_IF_EXTREME_REASON
JUSTIFIED_IF_SELF_DEFENSE
-1
SHUN
PUNISH_SERIOUS
APPALLING
MISGUIDED
PUNISH_EXILE
UNTHINKABLE
+1
PUNISH_REPRIMAND +2
</pre>
|-
|PUNISH_SERIOUS
|<pre>PERSONAL_MATTER
ACCEPTABLE
-10
JUSTIFIED_IF_NO_REPERCUSSIONS
-7
JUSTIFIED_IF_GOOD_REASON
ONLY_IF_SANCTIONED
-3
JUSTIFIED_IF_EXTREME_REASON
JUSTIFIED_IF_SELF_DEFENSE
-2
SHUN
APPALLING
PUNISH_EXILE
UNTHINKABLE
PUNISH_CAPITAL
1
PUNISH_SERIOUS +2
</pre>
|-
|PUNISH_EXILE
|<pre>PERSONAL_MATTER
ACCEPTABLE
-10
JUSTIFIED_IF_NO_REPERCUSSIONS
-7
JUSTIFIED_IF_GOOD_REASON
ONLY_IF_SANCTIONED
-3
JUSTIFIED_IF_EXTREME_REASON
JUSTIFIED_IF_SELF_DEFENSE
-2
SHUN
APPALLING
PUNISH_SERIOUS
UNTHINKABLE
PUNISH_CAPITAL
+1
PUNISH_EXILE +2
</pre>
|-
|PUNISH_CAPITAL
|<pre>PERSONAL_MATTER
ACCEPTABLE
-15
JUSTIFIED_IF_NO_REPERCUSSIONS
-10
JUSTIFIED_IF_GOOD_REASON
ONLY_IF_SANCTIONED
-5
JUSTIFIED_IF_EXTREME_REASON
JUSTIFIED_IF_SELF_DEFENSE
-3
APPALLING
PUNISH_SERIOUS
UNTHINKABLE
PUNISH_EXILE
+1
PUNISH_CAPITAL +2
</pre>
|-
|UNTHINKABLE
|<pre>PERSONAL_MATTER
ACCEPTABLE
-15
JUSTIFIED_IF_NO_REPERCUSSIONS
-10
JUSTIFIED_IF_GOOD_REASON
ONLY_IF_SANCTIONED
-5
JUSTIFIED_IF_EXTREME_REASON
JUSTIFIED_IF_SELF_DEFENSE
-3
SHUN
APPALLING
PUNISH_SERIOUS
PUNISH_EXILE
PUNISH_CAPITAL
+1
UNTHINKABLE
+2
</pre>
|-
|JUSTIFIED_IF_NO_REPERCUSSIONS<br>PERSONAL_MATTER<br>ACCEPTABLE
|<pre>MISGUIDED -1
SHUN
APPALLING
PUNISH_REPRIMAND
UNTHINKABLE
-2
PUNISH_SERIOUS -3
PUNISH_EXILE
PUNISH_CAPITAL
-5
JUSTIFIED_IF_NO_REPERCUSSIONS
PERSONAL_MATTER
ACCEPTABLE
+1
</pre>
|}

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

v0.31:Personality facet

2011-04-22T18:00:07Z

Bohandas:

{{quality|Fine|14:52, 22 January 2011 (UTC)}}{{av}}

Dwarven personalities are determined by a set of traits. These traits are distinct from {{L|attributes}}.

Personality traits are shown in a dwarf's "thoughts and preferences" description page, which can be accessed by {{k|v}}iewing that dwarf then {{k|p}}, {{k|z}}, {{k|Enter}}, or from the {{k|u}}nit menu with {{k|v}}iew, {{k|Enter}}.

Each trait varies from 1 (lowest possible) to 100 (highest possible), but are categorised as below. The points are distributed in 7 levels:
{| {{prettytable}}
|- style="background:#ddd"
! | Token
! | Value Range
! | Value Points
! | Effect
|-
! rowspan="7" | ???
| | 91 - 100
| | 10
| rowspan="3" | High
|-
| | 76 - 90
| | 15
|-
| | 61 - 75
| | 15
|-
| | 40 - 60
| | 20
| | Neutral
|-
| | 25 - 39
| | 15
| rowspan="3" | Low
|-
| | 10 - 24
| | 15
|-
| | 0 - 9
| | 10
|}

Traits are also influenced by species via the use of the PERSONALITY {{L|creature token}}. For example, dwarves are slightly more straightforward than average with a median of 55 in that trait, whereas goblins aren't likely to help others out - their altruism median is a mere 25, and is capped at 50.

Traits also have an effect on which social skills are learned in social interaction, and determine whether certain actions may give a good or bad {{L|thought}}. Traits may have other, more subtle effects on creature behaviour, which are currently not entirely understood.

{| {{prettytable}}
|- style="background:#ddd"
! Token
! style="width:4em" | Value
! Description
! Gameplay effects

|- style="border-top: 3px solid #aaa"
! rowspan=6 | ANXIETY
| 91 - 100 || Is a nervous wreck.
|-
| 76 - 90 || Is always tense and jittery.
|-
| 61 - 75 || Is often nervous.
|-
| 25 - 39 || Has a calm demeanor.
|-
| 10 - 24 || Has a very calm demeanor.
|-
| 0 - 9 || Has an incredibly calm demeanor.

|- style="border-top: 3px solid #aaa"
! rowspan=6 | ANGER
| 91 - 100 || Is in a constant state of internal rage.
| rowspan=3 | Prone to becoming {{L|Status icon|enraged}}
|-
| 76 - 90 || Is very quick to anger.
|-
| 61 - 75 || Is quick to anger.
|-
| 25 - 39 || Is slow to anger.
| rowspan=3 | Not prone to becoming {{L|Status icon|enraged}}
|-
| 10 - 24 || Is very slow to anger.
|-
| 0 - 9 || Never becomes angry.

|- style="border-top: 3px solid #aaa"
! rowspan=6 | DEPRESSION
| 91 - 100 || Is frequently depressed.
|-
| 76 - 90 || Is often sad and dejected.
|-
| 61 - 75 || Often feels discouraged.
|-
| 25 - 39 || Rarely feels discouraged.
|-
| 10 - 24 || Almost never feels discouraged.
|-
| 0 - 9 || Never feels discouraged.

|- style="border-top: 3px solid #aaa"
! rowspan=6 | SELF_CONSCIOUSNESS
| 91 - 100 || Is socially crippled by thoughts that everyone is watching and judging it/him/her.
| rowspan=2 | Cannot gain {{L|Comedian}} experience
|-
| 76 - 90 || Is concerned about rejection and ridicule.
|-
| 61 - 75 || Is self-conscious.
|-
| 25 - 39 || Is comfortable in social situations.
|-
| 10 - 24 || Is very comfortable in social situations.
|-
| 0 - 9 || Is absolutely unfazed by the opinions of others.

|- style="border-top: 3px solid #aaa"
! rowspan=6 | IMMODERATION
| 91 - 100 || Is ruled by irresistible cravings and urges.
|-
| 76 - 90 || Feels strong urges and seeks short-term rewards.
|-
| 61 - 75 || Occassionally overindulges.
|-
| 25 - 39 || Doesn't often experience strong cravings or urges.
|-
| 10 - 24 || Only rarely feels strong cravings or urges.
|-
| 0 - 9 || Never feels tempted to overindulge in anything.

|- style="border-top: 3px solid #aaa"
! rowspan=6 | VULNERABILITY
| 91 - 100 || Becomes completely helpless in stressful situations.
|-
| 76 - 90 || Cracks easily under pressure.
|-
| 61 - 75 || Doesn't handle stress well.
|-
| 25 - 39 || Can handle stress.
|-
| 10 - 24 || Is confident under pressure.
|-
| 0 - 9 || Is impervious to the effects of stress.

|- style="border-top: 3px solid #aaa"
! rowspan=6 | FRIENDLINESS
| 91 - 100 || Truly treasures the company of others.
|-
| 76 - 90 || Enjoys being in crowds.
|-
| 61 - 75 || Enjoys the company of others.
|-
| 25 - 39 || Tends to avoid crowds.
|-
| 10 - 24 || Prefers to be alone.
|-
| 0 - 9 || Considers spending time alone much more important than associating with others.

|- style="border-top: 3px solid #aaa"
! rowspan=6 | GREGARIOUSNESS
| 91 - 100 || Genuinely likes others and openly expresses positive feelings toward them.
|-
| 76 - 90 || Makes friends quickly.
|-
| 61 - 75 || Is very friendly.
|-
| 25 - 39 || Is somewhat reserved.
| rowspan=3 | Cannot gain {{L|Conversationalist}} experience
|-
| 10 - 24 || Is very distant and reserved.
|-
| 0 - 9 || Does not actively seek friendships and is incredibly distant and reserved.

|- style="border-top: 3px solid #aaa"
! rowspan=6 | ASSERTIVENESS
| 91 - 100 || Loves to take charge and direct activities.
|-
| 76 - 90 || Is very assertive.
|-
| 61 - 75 || Is assertive.
|-
| 25 - 39 || Is unassertive.
| rowspan=3 | Cannot gain {{L|Persuader}} experience
|-
| 10 - 24 || Prefers that others handle the leadership roles.
|-
| 0 - 9 || Never speaks out or attempts to direct activities.

|- style="border-top: 3px solid #aaa"
! rowspan=6 | ACTIVITY_LEVEL
| 91 - 100 || Is constantly active and energetic.
|-
| 76 - 90 || Is very energetic and active.
|-
| 61 - 75 || Is very active.
|-
| 25 - 39 || Is relaxed.
|-
| 10 - 24 || Lives life at a leisurely pace.
|-
| 0 - 9 || Can't be bothered with frantic, fast-paced living.

|- style="border-top: 3px solid #aaa"
! rowspan=6 | EXCITEMENT_SEEKING
| 91 - 100 || Lives for risk and excitement.
| rowspan=3 | More likely to join {{L|adventurer mode|adventurers}}
|-
| 76 - 90 || Is a risk-taker and a thrill-seeker.
|-
| 61 - 75 || Loves a good thrill.
|-
| 25 - 39 || Is not a risk-taker.
|-
| 10 - 24 || Doesn't need thrills or risks in life.
|-
| 0 - 9 || Is entirely adverse to risk and excitement.

|- style="border-top: 3px solid #aaa"
! rowspan=6 | CHEERFULNESS
| 91 - 100 || Often feels filled with joy.
|-
| 76 - 90 || Can be very happy and optimistic.
|-
| 61 - 75 || Is often cheerful.
|-
| 25 - 39 || Is rarely happy or enthusiastic.
|-
| 10 - 24 || Is a pessimist.
|-
| 0 - 9 || Is never optimistic or enthusiastic about anything.

|- style="border-top: 3px solid #aaa"
! rowspan=6 | IMAGINATION
| 91 - 100 || Is bored by reality and has a wonderful imagination.
|-
| 76 - 90 || Is incredibly creative.
|-
| 61 - 75 || Has a fertile imagination.
|-
| 25 - 39 || Isn't given to flights of fancy.
|-
| 10 - 24 || Is grounded in reality.
|-
| 0 - 9 || Is interested only in facts and the real world.

|- style="border-top: 3px solid #aaa"
! rowspan=6 | ARTISTIC_INTEREST
| 91 - 100 || Can easily become absorbed in art and the beauty of the natural world.
|-
| 76 - 90 || Greatly appreciates art and natural beauty.
|-
| 61 - 75 || Appreciates art and natural beauty.
|-
| 25 - 39 || Does not have a great aesthetic sensitivity.
|-
| 10 - 24 || Is not interested in art.
|-
| 0 - 9 || Is completely uninterested in art.

|- style="border-top: 3px solid #aaa"
! rowspan=6 | EMOTIONALITY
| 91 - 100 || Has a profound understanding of its/his/her own emotions.
|-
| 76 - 90 || Has a great awareness of its/his/her own emotions.
|-
| 61 - 75 || Has a good awareness of its/his/her own emotions.
|-
| 25 - 39 || Tends not to openly express emotions.
|-
| 10 - 24 || Is mostly unaware of its/his/her own emotions and rarely expresses them.
|-
| 0 - 9 || Does not display its/his/her own emotions and has no awareness of them.

|- style="border-top: 3px solid #aaa"
! rowspan=6 | ADVENTUROUSNESS
| 91 - 100 || Is highly adventurous and loves fresh experiences.
|-
| 76 - 90 || Is eager for new experiences.
|-
| 61 - 75 || Likes to try new things.
|-
| 25 - 39 || Prefers familiar routines.
|-
| 10 - 24 || Is uncomfortable with change.
|-
| 0 - 9 || Is resistant to change.

|- style="border-top: 3px solid #aaa"
! rowspan=6 | INTELLECTUAL_CURIOSITY
| 91 - 100 || Is entranced by riddles and puzzles and loves to debate issues and ideas.
|-
| 76 - 90 || Loves new and fresh ideas.
|-
| 61 - 75 || Is open-minded to new ideas.
|-
| 25 - 39 || Dislikes intellectual discussions.
|-
| 10 - 24 || Regards intellectual exercises as a waste of energy.
|-
| 0 - 9 || Is completely uninterested in ideas and debates over intellectual issues.

|- style="border-top: 3px solid #aaa"
! rowspan=6 | LIBERALISM
| 91 - 100 || Revels in chaos and disorder.
| rowspan=3 | Receives unhappy {{L|thought}} from talking to {{L|noble}}s{{verify}}
|-
| 76 - 90 || Loves to defy convention.
|-
| 61 - 75 || Is put off by authority and tradition.
|-
| 25 - 39 || Admires tradition.
| rowspan=3 | Receives happy {{L|thought}} from talking to {{L|noble}}s{{verify}}
|-
| 10 - 24 || Prefers stability and security to ambiguity and disorder.
|-
| 0 - 9 || Is an ardent believer in convention and traditional society.

|- style="border-top: 3px solid #aaa"
! rowspan=6 | TRUST
| 91 - 100 || Is naturally trustful of everybody.
|-
| 76 - 90 || Is very trusting.
|-
| 61 - 75 || Is trusting.
|-
| 25 - 39 || Is slow to trust others.
|-
| 10 - 24 || Does not trust others.
|-
| 0 - 9 || Sees others as selfish and conniving.

|- style="border-top: 3px solid #aaa"
! rowspan=6 | STRAIGHTFORWARDNESS
| 91 - 100 || Is incredibly frank and candid in dealings with others.
| rowspan=3 | Cannot gain {{L|Flatterer}} experience.
|-
| 76 - 90 || Is very straightforward with others.
|-
| 61 - 75 || Is candid and sincere in dealings with others.
|-
| 25 - 39 || Is guarded in {{L|relationship|relationships}} with others.
| rowspan=3 | Cannot gain {{L|Consoler}} experience<br />Can gain {{L|Liar}} experience.
|-
| 10 - 24 || Is not straightforward when dealing with others.
|-
| 0 - 9 || Believes that some deception is necessary in relationships with others.

|- style="border-top: 3px solid #aaa"
! rowspan=6 | ALTRUISM
| 91 - 100 || Is truly fulfilled by assisting those in need.
| rowspan=3 | Receives happy {{L|thought}} from rescuing wounded
|-
| 76 - 90 || Finds helping others very rewarding.
|-
| 61 - 75 || Finds helping others rewarding.
|-
| 25 - 39 || Does not go out of its/his/her way to help others.
| rowspan=3 | Receives unhappy {{L|thought}} from rescuing wounded
|-
| 10 - 24 || Dislikes helping others.
|-
| 0 - 9 || Views helping others as an imposition on own needs to get along with others.

|- style="border-top: 3px solid #aaa"
! rowspan=6 | COOPERATION
| 91 - 100 || Sacrifices its/his/her own needs to get along with others.
| rowspan=3 | Cannot gain {{L|Intimidator}} experience
|-
| 76 - 90 || Dislikes confrontations.
|-
| 61 - 75 || Is willing to compromise with others.
|-
| 25 - 39 || Doesn't like to compromise with others.
| rowspan=3 | Cannot gain {{L|Pacifier}} experience
|-
| 10 - 24 || Would rather intimidate others than compromise with them.
|-
| 0 - 9 || Would never deny its/his/her own needs just to compromise with somebody else.

|- style="border-top: 3px solid #aaa"
! rowspan=6 | MODESTY
| 91 - 100 || Would never claim to be better than somebody else.
|-
| 76 - 90 || Finds immodesty distasteful.
|-
| 61 - 75 || Is modest.
|-
| 25 - 39 || Is immodest.
|-
| 10 - 24 || Is very willing to compare itself/himself/herself favorably with others.
|-
| 0 - 9 || Would never shy away from an opportunity to say it/he/she is better than somebody else.

|- style="border-top: 3px solid #aaa"
! rowspan=6 | SYMPATHY
| 91 - 100 || Is incredibly compassionate and feels the pain of others.
|-
| 76 - 90 || Is easily moved to pity.
|-
| 61 - 75 || Is compassionate.
|-
| 25 - 39 || Is not easily moved to pity.
|-
| 10 - 24 || Is not affected by the suffering of others.
|-
| 0 - 9 || Would never let an objective judgement be tempered by mercy or pity.

|- style="border-top: 3px solid #aaa"
! rowspan=6 | SELF_EFFICACY
| 91 - 100 || Is incredibly confident.
|-
| 76 - 90 || Is very confident.
|-
| 61 - 75 || Is confident.
|-
| 25 - 39 || Lacks confidence.
|-
| 10 - 24 || Does not feel effective in life.
|-
| 0 - 9 || Feels as if it/he/she is not in control of its/his/her life.

|- style="border-top: 3px solid #aaa"
! rowspan=6 | ORDERLINESS
| 91 - 100 || Loves to make lists and keep schedules.
|-
| 76 - 90 || Tries to live a well-organized life.
|-
| 61 - 75 || Is organized.
|-
| 25 - 39 || Is disorganized.
|-
| 10 - 24 || Is very disorganized.
|-
| 0 - 9 || Is completely disorganized.

|- style="border-top: 3px solid #aaa"
! rowspan=6 | DUTIFULNESS
| 91 - 100 || Has a profound sense of duty and obligation.
|-
| 76 - 90 || Has a strong sense of duty.
|-
| 61 - 75 || Has a sense of duty.
|-
| 25 - 39 || Finds rules confining.
|-
| 10 - 24 || Dislikes contracts and regulations.
|-
| 0 - 9 || Hates rules, contracts and other confining elements in its/his/her life.

|- style="border-top: 3px solid #aaa"
! rowspan=6 | ACHIEVEMENT_STRIVING
| 91 - 100 || Constantly strives for perfection.
|-
| 76 - 90 || Thinks it is incredibly important to strive for excellence.
|-
| 61 - 75 || Strives for excellence.
|-
| 25 - 39 || Doesn't go out of its/his/her way to do more work than necessary.
|-
| 10 - 24 || Very rarely does more work than necessary.
|-
| 0 - 9 || Does the bare minimum necessary to accomplish the task at hand.

|- style="border-top: 3px solid #aaa"
! rowspan=6 | SELF_DISCIPLINE
| 91 - 100 || Will persist in the face of any difficulty until the task is complete.
| rowspan=6 | Affects duration of {{L|on break|breaks}}{{verify}}
|-
| 76 - 90 || Possesses great willpower.
|-
| 61 - 75 || Is self-disciplined.
|-
| 25 - 39 || Is occasionally given to procrastination.
|-
| 10 - 24 || Has very little self-discipline.
|-
| 0 - 9 || Rarely completes tasks and is often overcome by distractions.

|- style="border-top: 3px solid #aaa"
! rowspan=6 | CAUTIOUSNESS
| 91 - 100 || Thinks through every alternatives and their consequences before acting.
|-
| 76 - 90 || Is extremely cautious.
|-
| 61 - 75 || Takes time when making decisions.
|-
| 25 - 39 || Often does the first thing that comes to mind.
|-
| 10 - 24 || Acts impulsively.
|-
| 0 - 9 || Always acts without considering alternatives or thinking through possibilities.

|}

==Personality-Trait-Like Characteristics==

The following are not moddable personality traits, and unlike true personality traits, they can vary in response to certain hardcoded stimuli however in other respects they are tracked in a by the game in a related manner.

{| {{prettytable}}
|- style="background:#ddd"
! | Token
! | Value Range
! | Value Points
! | Effect

|- style="border-top: 3px solid #aaa"
! rowspan=6 | ALCOHOL_DEPENDENT *
| 91 - 100
| Needs alcohol to get through the working day.
|Had a drink recently, no penalty.
|-
| 76 - 90
| Needs alcohol to get through the working day and is starting to work slowly due to its scarcity.
| rowspan=3 | The lower this gets, the slower an alcohol dependent creature will work, and the longer their breaks become. Low intake of booze may be one cause of {{l|insanity}}.
|-
| 61 - 75
| Needs alcohol to get through the working day and really wants a drink.
|-
| 25 - 39
| Needs alcohol to get through the working day and has gone without a drink for far, far too long.
|-
| 10 - 24
| Needs alcohol to get through the working day and can't even remember the last time s/he had some.
|-
| 0 - 9
| ?????
|- style="border-top: 3px solid #aaa"
! rowspan=5 | CAVE_ADAPT †
| 91 - 100
| rowspan=3 | (There aren't actually personality traits that appear, but there are multiple levels of this that control how {{l|Cave_adaptation|cave adapted}} the creature actually is (whether or not they will grow irritated or {{l|vomit}}). This trait goes lower as creatures spend time in the {{l|sun}}.)
|-
| 76 - 90
|-
| 61 - 75
| rowspan=3 | These low levels of Cave Adaptation cause no ill effects.
|-
| 25 - 39
| Does not mind being outdoors, at least for a time.
|-
| 0 - 24
| Likes working outdoors and grumbles only mildly at inclement weather.
|- style="border-top: 3px solid #aaa"
! rowspan=4 | DETACHMENT ‡
| 76 - 100
| Doesn't really care about anything anymore.
| rowspan=3 | This trait increases as dwarves witness death and suffer tragedy. The higher it gets, the harder it is for the dwarf to be affected by negative thoughts, so in several ways, this is a useful if tragic side effect of running a bloody fort. This trait often finds its way into experienced {{l|military|soldiers}}, who might watch {{l|friend|friends}} and comrades die as often as they kill {{l|goblin|goblins}}.
|-
| 40 - 75
| Is a hardened individual.
|-
| 10 - 39
| Is getting used to tragedy.
|-
| 0 - 9
|
| Nothing displayed. Dwarf is not yet traumatized.
|}
* Applies to creatures with the [ALCOHOL_DEPENDENT] token and changes depending on when they last had {{l|alcohol|booze}}.
† Applies to creatures with the [CAVE_ADAPT] token.
‡ Probably not the actual name, but it fits.

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

v0.31:Personality facet

2011-04-22T17:59:33Z

Bohandas:

{{quality|Fine|14:52, 22 January 2011 (UTC)}}{{av}}

Dwarven personalities are determined by a set of traits. These traits are distinct from {{L|attributes}}.

Personality traits are shown in a dwarf's "thoughts and preferences" description page, which can be accessed by {{k|v}}iewing that dwarf then {{k|p}}, {{k|z}}, {{k|Enter}}, or from the {{k|u}}nit menu with {{k|v}}iew, {{k|Enter}}.

Each trait varies from 1 (lowest possible) to 100 (highest possible), but are categorised as below. The points are distributed in 7 levels:
{| {{prettytable}}
|- style="background:#ddd"
! | Token
! | Value Range
! | Value Points
! | Effect
|-
! rowspan="7" | ???
| | 91 - 100
| | 10
| rowspan="3" | High
|-
| | 76 - 90
| | 15
|-
| | 61 - 75
| | 15
|-
| | 40 - 60
| | 20
| | Neutral
|-
| | 25 - 39
| | 15
| rowspan="3" | Low
|-
| | 10 - 24
| | 15
|-
| | 0 - 9
| | 10
|}

Traits are also influenced by species via the use of the PERSONALITY {{L|creature token}}. For example, dwarves are slightly more straightforward than average with a median of 55 in that trait, whereas goblins aren't likely to help others out - their altruism median is a mere 25, and is capped at 50.

Traits also have an effect on which social skills are learned in social interaction, and determine whether certain actions may give a good or bad {{L|thought}}. Traits may have other, more subtle effects on creature behaviour, which are currently not entirely understood.

{| {{prettytable}}
|- style="background:#ddd"
! Token
! style="width:4em" | Value
! Description
! Gameplay effects

|- style="border-top: 3px solid #aaa"
! rowspan=6 | ANXIETY
| 91 - 100 || Is a nervous wreck.
|-
| 76 - 90 || Is always tense and jittery.
|-
| 61 - 75 || Is often nervous.
|-
| 25 - 39 || Has a calm demeanor.
|-
| 10 - 24 || Has a very calm demeanor.
|-
| 0 - 9 || Has an incredibly calm demeanor.

|- style="border-top: 3px solid #aaa"
! rowspan=6 | ANGER
| 91 - 100 || Is in a constant state of internal rage.
| rowspan=3 | Prone to becoming {{L|Status icon|enraged}}
|-
| 76 - 90 || Is very quick to anger.
|-
| 61 - 75 || Is quick to anger.
|-
| 25 - 39 || Is slow to anger.
| rowspan=3 | Not prone to becoming {{L|Status icon|enraged}}
|-
| 10 - 24 || Is very slow to anger.
|-
| 0 - 9 || Never becomes angry.

|- style="border-top: 3px solid #aaa"
! rowspan=6 | DEPRESSION
| 91 - 100 || Is frequently depressed.
|-
| 76 - 90 || Is often sad and dejected.
|-
| 61 - 75 || Often feels discouraged.
|-
| 25 - 39 || Rarely feels discouraged.
|-
| 10 - 24 || Almost never feels discouraged.
|-
| 0 - 9 || Never feels discouraged.

|- style="border-top: 3px solid #aaa"
! rowspan=6 | SELF_CONSCIOUSNESS
| 91 - 100 || Is socially crippled by thoughts that everyone is watching and judging it/him/her.
| rowspan=2 | Cannot gain {{L|Comedian}} experience
|-
| 76 - 90 || Is concerned about rejection and ridicule.
|-
| 61 - 75 || Is self-conscious.
|-
| 25 - 39 || Is comfortable in social situations.
|-
| 10 - 24 || Is very comfortable in social situations.
|-
| 0 - 9 || Is absolutely unfazed by the opinions of others.

|- style="border-top: 3px solid #aaa"
! rowspan=6 | IMMODERATION
| 91 - 100 || Is ruled by irresistible cravings and urges.
|-
| 76 - 90 || Feels strong urges and seeks short-term rewards.
|-
| 61 - 75 || Occassionally overindulges.
|-
| 25 - 39 || Doesn't often experience strong cravings or urges.
|-
| 10 - 24 || Only rarely feels strong cravings or urges.
|-
| 0 - 9 || Never feels tempted to overindulge in anything.

|- style="border-top: 3px solid #aaa"
! rowspan=6 | VULNERABILITY
| 91 - 100 || Becomes completely helpless in stressful situations.
|-
| 76 - 90 || Cracks easily under pressure.
|-
| 61 - 75 || Doesn't handle stress well.
|-
| 25 - 39 || Can handle stress.
|-
| 10 - 24 || Is confident under pressure.
|-
| 0 - 9 || Is impervious to the effects of stress.

|- style="border-top: 3px solid #aaa"
! rowspan=6 | FRIENDLINESS
| 91 - 100 || Truly treasures the company of others.
|-
| 76 - 90 || Enjoys being in crowds.
|-
| 61 - 75 || Enjoys the company of others.
|-
| 25 - 39 || Tends to avoid crowds.
|-
| 10 - 24 || Prefers to be alone.
|-
| 0 - 9 || Considers spending time alone much more important than associating with others.

|- style="border-top: 3px solid #aaa"
! rowspan=6 | GREGARIOUSNESS
| 91 - 100 || Genuinely likes others and openly expresses positive feelings toward them.
|-
| 76 - 90 || Makes friends quickly.
|-
| 61 - 75 || Is very friendly.
|-
| 25 - 39 || Is somewhat reserved.
| rowspan=3 | Cannot gain {{L|Conversationalist}} experience
|-
| 10 - 24 || Is very distant and reserved.
|-
| 0 - 9 || Does not actively seek friendships and is incredibly distant and reserved.

|- style="border-top: 3px solid #aaa"
! rowspan=6 | ASSERTIVENESS
| 91 - 100 || Loves to take charge and direct activities.
|-
| 76 - 90 || Is very assertive.
|-
| 61 - 75 || Is assertive.
|-
| 25 - 39 || Is unassertive.
| rowspan=3 | Cannot gain {{L|Persuader}} experience
|-
| 10 - 24 || Prefers that others handle the leadership roles.
|-
| 0 - 9 || Never speaks out or attempts to direct activities.

|- style="border-top: 3px solid #aaa"
! rowspan=6 | ACTIVITY_LEVEL
| 91 - 100 || Is constantly active and energetic.
|-
| 76 - 90 || Is very energetic and active.
|-
| 61 - 75 || Is very active.
|-
| 25 - 39 || Is relaxed.
|-
| 10 - 24 || Lives life at a leisurely pace.
|-
| 0 - 9 || Can't be bothered with frantic, fast-paced living.

|- style="border-top: 3px solid #aaa"
! rowspan=6 | EXCITEMENT_SEEKING
| 91 - 100 || Lives for risk and excitement.
| rowspan=3 | More likely to join {{L|adventurer mode|adventurers}}
|-
| 76 - 90 || Is a risk-taker and a thrill-seeker.
|-
| 61 - 75 || Loves a good thrill.
|-
| 25 - 39 || Is not a risk-taker.
|-
| 10 - 24 || Doesn't need thrills or risks in life.
|-
| 0 - 9 || Is entirely adverse to risk and excitement.

|- style="border-top: 3px solid #aaa"
! rowspan=6 | CHEERFULNESS
| 91 - 100 || Often feels filled with joy.
|-
| 76 - 90 || Can be very happy and optimistic.
|-
| 61 - 75 || Is often cheerful.
|-
| 25 - 39 || Is rarely happy or enthusiastic.
|-
| 10 - 24 || Is a pessimist.
|-
| 0 - 9 || Is never optimistic or enthusiastic about anything.

|- style="border-top: 3px solid #aaa"
! rowspan=6 | IMAGINATION
| 91 - 100 || Is bored by reality and has a wonderful imagination.
|-
| 76 - 90 || Is incredibly creative.
|-
| 61 - 75 || Has a fertile imagination.
|-
| 25 - 39 || Isn't given to flights of fancy.
|-
| 10 - 24 || Is grounded in reality.
|-
| 0 - 9 || Is interested only in facts and the real world.

|- style="border-top: 3px solid #aaa"
! rowspan=6 | ARTISTIC_INTEREST
| 91 - 100 || Can easily become absorbed in art and the beauty of the natural world.
|-
| 76 - 90 || Greatly appreciates art and natural beauty.
|-
| 61 - 75 || Appreciates art and natural beauty.
|-
| 25 - 39 || Does not have a great aesthetic sensitivity.
|-
| 10 - 24 || Is not interested in art.
|-
| 0 - 9 || Is completely uninterested in art.

|- style="border-top: 3px solid #aaa"
! rowspan=6 | EMOTIONALITY
| 91 - 100 || Has a profound understanding of its/his/her own emotions.
|-
| 76 - 90 || Has a great awareness of its/his/her own emotions.
|-
| 61 - 75 || Has a good awareness of its/his/her own emotions.
|-
| 25 - 39 || Tends not to openly express emotions.
|-
| 10 - 24 || Is mostly unaware of its/his/her own emotions and rarely expresses them.
|-
| 0 - 9 || Does not display its/his/her own emotions and has no awareness of them.

|- style="border-top: 3px solid #aaa"
! rowspan=6 | ADVENTUROUSNESS
| 91 - 100 || Is highly adventurous and loves fresh experiences.
|-
| 76 - 90 || Is eager for new experiences.
|-
| 61 - 75 || Likes to try new things.
|-
| 25 - 39 || Prefers familiar routines.
|-
| 10 - 24 || Is uncomfortable with change.
|-
| 0 - 9 || Is resistant to change.

|- style="border-top: 3px solid #aaa"
! rowspan=6 | INTELLECTUAL_CURIOSITY
| 91 - 100 || Is entranced by riddles and puzzles and loves to debate issues and ideas.
|-
| 76 - 90 || Loves new and fresh ideas.
|-
| 61 - 75 || Is open-minded to new ideas.
|-
| 25 - 39 || Dislikes intellectual discussions.
|-
| 10 - 24 || Regards intellectual exercises as a waste of energy.
|-
| 0 - 9 || Is completely uninterested in ideas and debates over intellectual issues.

|- style="border-top: 3px solid #aaa"
! rowspan=6 | LIBERALISM
| 91 - 100 || Revels in chaos and disorder.
| rowspan=3 | Receives unhappy {{L|thought}} from talking to {{L|noble}}s{{verify}}
|-
| 76 - 90 || Loves to defy convention.
|-
| 61 - 75 || Is put off by authority and tradition.
|-
| 25 - 39 || Admires tradition.
| rowspan=3 | Receives happy {{L|thought}} from talking to {{L|noble}}s{{verify}}
|-
| 10 - 24 || Prefers stability and security to ambiguity and disorder.
|-
| 0 - 9 || Is an ardent believer in convention and traditional society.

|- style="border-top: 3px solid #aaa"
! rowspan=6 | TRUST
| 91 - 100 || Is naturally trustful of everybody.
|-
| 76 - 90 || Is very trusting.
|-
| 61 - 75 || Is trusting.
|-
| 25 - 39 || Is slow to trust others.
|-
| 10 - 24 || Does not trust others.
|-
| 0 - 9 || Sees others as selfish and conniving.

|- style="border-top: 3px solid #aaa"
! rowspan=6 | STRAIGHTFORWARDNESS
| 91 - 100 || Is incredibly frank and candid in dealings with others.
| rowspan=3 | Cannot gain {{L|Flatterer}} experience.
|-
| 76 - 90 || Is very straightforward with others.
|-
| 61 - 75 || Is candid and sincere in dealings with others.
|-
| 25 - 39 || Is guarded in {{L|relationship|relationships}} with others.
| rowspan=3 | Cannot gain {{L|Consoler}} experience<br />Can gain {{L|Liar}} experience.
|-
| 10 - 24 || Is not straightforward when dealing with others.
|-
| 0 - 9 || Believes that some deception is necessary in relationships with others.

|- style="border-top: 3px solid #aaa"
! rowspan=6 | ALTRUISM
| 91 - 100 || Is truly fulfilled by assisting those in need.
| rowspan=3 | Receives happy {{L|thought}} from rescuing wounded
|-
| 76 - 90 || Finds helping others very rewarding.
|-
| 61 - 75 || Finds helping others rewarding.
|-
| 25 - 39 || Does not go out of its/his/her way to help others.
| rowspan=3 | Receives unhappy {{L|thought}} from rescuing wounded
|-
| 10 - 24 || Dislikes helping others.
|-
| 0 - 9 || Views helping others as an imposition on own needs to get along with others.

|- style="border-top: 3px solid #aaa"
! rowspan=6 | COOPERATION
| 91 - 100 || Sacrifices its/his/her own needs to get along with others.
| rowspan=3 | Cannot gain {{L|Intimidator}} experience
|-
| 76 - 90 || Dislikes confrontations.
|-
| 61 - 75 || Is willing to compromise with others.
|-
| 25 - 39 || Doesn't like to compromise with others.
| rowspan=3 | Cannot gain {{L|Pacifier}} experience
|-
| 10 - 24 || Would rather intimidate others than compromise with them.
|-
| 0 - 9 || Would never deny its/his/her own needs just to compromise with somebody else.

|- style="border-top: 3px solid #aaa"
! rowspan=6 | MODESTY
| 91 - 100 || Would never claim to be better than somebody else.
|-
| 76 - 90 || Finds immodesty distasteful.
|-
| 61 - 75 || Is modest.
|-
| 25 - 39 || Is immodest.
|-
| 10 - 24 || Is very willing to compare itself/himself/herself favorably with others.
|-
| 0 - 9 || Would never shy away from an opportunity to say it/he/she is better than somebody else.

|- style="border-top: 3px solid #aaa"
! rowspan=6 | SYMPATHY
| 91 - 100 || Is incredibly compassionate and feels the pain of others.
|-
| 76 - 90 || Is easily moved to pity.
|-
| 61 - 75 || Is compassionate.
|-
| 25 - 39 || Is not easily moved to pity.
|-
| 10 - 24 || Is not affected by the suffering of others.
|-
| 0 - 9 || Would never let an objective judgement be tempered by mercy or pity.

|- style="border-top: 3px solid #aaa"
! rowspan=6 | SELF_EFFICACY
| 91 - 100 || Is incredibly confident.
|-
| 76 - 90 || Is very confident.
|-
| 61 - 75 || Is confident.
|-
| 25 - 39 || Lacks confidence.
|-
| 10 - 24 || Does not feel effective in life.
|-
| 0 - 9 || Feels as if it/he/she is not in control of its/his/her life.

|- style="border-top: 3px solid #aaa"
! rowspan=6 | ORDERLINESS
| 91 - 100 || Loves to make lists and keep schedules.
|-
| 76 - 90 || Tries to live a well-organized life.
|-
| 61 - 75 || Is organized.
|-
| 25 - 39 || Is disorganized.
|-
| 10 - 24 || Is very disorganized.
|-
| 0 - 9 || Is completely disorganized.

|- style="border-top: 3px solid #aaa"
! rowspan=6 | DUTIFULNESS
| 91 - 100 || Has a profound sense of duty and obligation.
|-
| 76 - 90 || Has a strong sense of duty.
|-
| 61 - 75 || Has a sense of duty.
|-
| 25 - 39 || Finds rules confining.
|-
| 10 - 24 || Dislikes contracts and regulations.
|-
| 0 - 9 || Hates rules, contracts and other confining elements in its/his/her life.

|- style="border-top: 3px solid #aaa"
! rowspan=6 | ACHIEVEMENT_STRIVING
| 91 - 100 || Constantly strives for perfection.
|-
| 76 - 90 || Thinks it is incredibly important to strive for excellence.
|-
| 61 - 75 || Strives for excellence.
|-
| 25 - 39 || Doesn't go out of its/his/her way to do more work than necessary.
|-
| 10 - 24 || Very rarely does more work than necessary.
|-
| 0 - 9 || Does the bare minimum necessary to accomplish the task at hand.

|- style="border-top: 3px solid #aaa"
! rowspan=6 | SELF_DISCIPLINE
| 91 - 100 || Will persist in the face of any difficulty until the task is complete.
| rowspan=6 | Affects duration of {{L|on break|breaks}}{{verify}}
|-
| 76 - 90 || Possesses great willpower.
|-
| 61 - 75 || Is self-disciplined.
|-
| 25 - 39 || Is occasionally given to procrastination.
|-
| 10 - 24 || Has very little self-discipline.
|-
| 0 - 9 || Rarely completes tasks and is often overcome by distractions.

|- style="border-top: 3px solid #aaa"
! rowspan=6 | CAUTIOUSNESS
| 91 - 100 || Thinks through every alternatives and their consequences before acting.
|-
| 76 - 90 || Is extremely cautious.
|-
| 61 - 75 || Takes time when making decisions.
|-
| 25 - 39 || Often does the first thing that comes to mind.
|-
| 10 - 24 || Acts impulsively.
|-
| 0 - 9 || Always acts without considering alternatives or thinking through possibilities.

|}

==Personality-Trait-Like Characteristics==

The following are not moddable personality traits, and unlike true personality traits, they can vary in response to certain hardcoded stimuli
however in other respects they are tracked in a by the game in a related manner.

{| {{prettytable}}
|- style="background:#ddd"
! | Token
! | Value Range
! | Value Points
! | Effect

|- style="border-top: 3px solid #aaa"
! rowspan=6 | ALCOHOL_DEPENDENT *
| 91 - 100
| Needs alcohol to get through the working day.
|Had a drink recently, no penalty.
|-
| 76 - 90
| Needs alcohol to get through the working day and is starting to work slowly due to its scarcity.
| rowspan=3 | The lower this gets, the slower an alcohol dependent creature will work, and the longer their breaks become. Low intake of booze may be one cause of {{l|insanity}}.
|-
| 61 - 75
| Needs alcohol to get through the working day and really wants a drink.
|-
| 25 - 39
| Needs alcohol to get through the working day and has gone without a drink for far, far too long.
|-
| 10 - 24
| Needs alcohol to get through the working day and can't even remember the last time s/he had some.
|-
| 0 - 9
| ?????
|- style="border-top: 3px solid #aaa"
! rowspan=5 | CAVE_ADAPT †
| 91 - 100
| rowspan=3 | (There aren't actually personality traits that appear, but there are multiple levels of this that control how {{l|Cave_adaptation|cave adapted}} the creature actually is (whether or not they will grow irritated or {{l|vomit}}). This trait goes lower as creatures spend time in the {{l|sun}}.)
|-
| 76 - 90
|-
| 61 - 75
| rowspan=3 | These low levels of Cave Adaptation cause no ill effects.
|-
| 25 - 39
| Does not mind being outdoors, at least for a time.
|-
| 0 - 24
| Likes working outdoors and grumbles only mildly at inclement weather.
|- style="border-top: 3px solid #aaa"
! rowspan=4 | DETACHMENT ‡
| 76 - 100
| Doesn't really care about anything anymore.
| rowspan=3 | This trait increases as dwarves witness death and suffer tragedy. The higher it gets, the harder it is for the dwarf to be affected by negative thoughts, so in several ways, this is a useful if tragic side effect of running a bloody fort. This trait often finds its way into experienced {{l|military|soldiers}}, who might watch {{l|friend|friends}} and comrades die as often as they kill {{l|goblin|goblins}}.
|-
| 40 - 75
| Is a hardened individual.
|-
| 10 - 39
| Is getting used to tragedy.
|-
| 0 - 9
|
| Nothing displayed. Dwarf is not yet traumatized.
|}
* Applies to creatures with the [ALCOHOL_DEPENDENT] token and changes depending on when they last had {{l|alcohol|booze}}.
† Applies to creatures with the [CAVE_ADAPT] token.
‡ Probably not the actual name, but it fits.

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

v0.31:Personality facet

2011-04-22T17:55:20Z

Bohandas:

{{quality|Fine|14:52, 22 January 2011 (UTC)}}{{av}}

Dwarven personalities are determined by a set of traits. These traits are distinct from {{L|attributes}}.

Personality traits are shown in a dwarf's "thoughts and preferences" description page, which can be accessed by {{k|v}}iewing that dwarf then {{k|p}}, {{k|z}}, {{k|Enter}}, or from the {{k|u}}nit menu with {{k|v}}iew, {{k|Enter}}.

Each trait varies from 1 (lowest possible) to 100 (highest possible), but are categorised as below. The points are distributed in 7 levels:
{| {{prettytable}}
|- style="background:#ddd"
! | Token
! | Value Range
! | Value Points
! | Effect
|-
! rowspan="7" | ???
| | 91 - 100
| | 10
| rowspan="3" | High
|-
| | 76 - 90
| | 15
|-
| | 61 - 75
| | 15
|-
| | 40 - 60
| | 20
| | Neutral
|-
| | 25 - 39
| | 15
| rowspan="3" | Low
|-
| | 10 - 24
| | 15
|-
| | 0 - 9
| | 10
|}

Traits are also influenced by species via the use of the PERSONALITY {{L|creature token}}. For example, dwarves are slightly more straightforward than average with a median of 55 in that trait, whereas goblins aren't likely to help others out - their altruism median is a mere 25, and is capped at 50.

Traits also have an effect on which social skills are learned in social interaction, and determine whether certain actions may give a good or bad {{L|thought}}. Traits may have other, more subtle effects on creature behaviour, which are currently not entirely understood.

{| {{prettytable}}
|- style="background:#ddd"
! Token
! style="width:4em" | Value
! Description
! Gameplay effects

|- style="border-top: 3px solid #aaa"
! rowspan=6 | ANXIETY
| 91 - 100 || Is a nervous wreck.
|-
| 76 - 90 || Is always tense and jittery.
|-
| 61 - 75 || Is often nervous.
|-
| 25 - 39 || Has a calm demeanor.
|-
| 10 - 24 || Has a very calm demeanor.
|-
| 0 - 9 || Has an incredibly calm demeanor.

|- style="border-top: 3px solid #aaa"
! rowspan=6 | ANGER
| 91 - 100 || Is in a constant state of internal rage.
| rowspan=3 | Prone to becoming {{L|Status icon|enraged}}
|-
| 76 - 90 || Is very quick to anger.
|-
| 61 - 75 || Is quick to anger.
|-
| 25 - 39 || Is slow to anger.
| rowspan=3 | Not prone to becoming {{L|Status icon|enraged}}
|-
| 10 - 24 || Is very slow to anger.
|-
| 0 - 9 || Never becomes angry.

|- style="border-top: 3px solid #aaa"
! rowspan=6 | DEPRESSION
| 91 - 100 || Is frequently depressed.
|-
| 76 - 90 || Is often sad and dejected.
|-
| 61 - 75 || Often feels discouraged.
|-
| 25 - 39 || Rarely feels discouraged.
|-
| 10 - 24 || Almost never feels discouraged.
|-
| 0 - 9 || Never feels discouraged.

|- style="border-top: 3px solid #aaa"
! rowspan=6 | SELF_CONSCIOUSNESS
| 91 - 100 || Is socially crippled by thoughts that everyone is watching and judging it/him/her.
| rowspan=2 | Cannot gain {{L|Comedian}} experience
|-
| 76 - 90 || Is concerned about rejection and ridicule.
|-
| 61 - 75 || Is self-conscious.
|-
| 25 - 39 || Is comfortable in social situations.
|-
| 10 - 24 || Is very comfortable in social situations.
|-
| 0 - 9 || Is absolutely unfazed by the opinions of others.

|- style="border-top: 3px solid #aaa"
! rowspan=6 | IMMODERATION
| 91 - 100 || Is ruled by irresistible cravings and urges.
|-
| 76 - 90 || Feels strong urges and seeks short-term rewards.
|-
| 61 - 75 || Occassionally overindulges.
|-
| 25 - 39 || Doesn't often experience strong cravings or urges.
|-
| 10 - 24 || Only rarely feels strong cravings or urges.
|-
| 0 - 9 || Never feels tempted to overindulge in anything.

|- style="border-top: 3px solid #aaa"
! rowspan=6 | VULNERABILITY
| 91 - 100 || Becomes completely helpless in stressful situations.
|-
| 76 - 90 || Cracks easily under pressure.
|-
| 61 - 75 || Doesn't handle stress well.
|-
| 25 - 39 || Can handle stress.
|-
| 10 - 24 || Is confident under pressure.
|-
| 0 - 9 || Is impervious to the effects of stress.

|- style="border-top: 3px solid #aaa"
! rowspan=6 | FRIENDLINESS
| 91 - 100 || Truly treasures the company of others.
|-
| 76 - 90 || Enjoys being in crowds.
|-
| 61 - 75 || Enjoys the company of others.
|-
| 25 - 39 || Tends to avoid crowds.
|-
| 10 - 24 || Prefers to be alone.
|-
| 0 - 9 || Considers spending time alone much more important than associating with others.

|- style="border-top: 3px solid #aaa"
! rowspan=6 | GREGARIOUSNESS
| 91 - 100 || Genuinely likes others and openly expresses positive feelings toward them.
|-
| 76 - 90 || Makes friends quickly.
|-
| 61 - 75 || Is very friendly.
|-
| 25 - 39 || Is somewhat reserved.
| rowspan=3 | Cannot gain {{L|Conversationalist}} experience
|-
| 10 - 24 || Is very distant and reserved.
|-
| 0 - 9 || Does not actively seek friendships and is incredibly distant and reserved.

|- style="border-top: 3px solid #aaa"
! rowspan=6 | ASSERTIVENESS
| 91 - 100 || Loves to take charge and direct activities.
|-
| 76 - 90 || Is very assertive.
|-
| 61 - 75 || Is assertive.
|-
| 25 - 39 || Is unassertive.
| rowspan=3 | Cannot gain {{L|Persuader}} experience
|-
| 10 - 24 || Prefers that others handle the leadership roles.
|-
| 0 - 9 || Never speaks out or attempts to direct activities.

|- style="border-top: 3px solid #aaa"
! rowspan=6 | ACTIVITY_LEVEL
| 91 - 100 || Is constantly active and energetic.
|-
| 76 - 90 || Is very energetic and active.
|-
| 61 - 75 || Is very active.
|-
| 25 - 39 || Is relaxed.
|-
| 10 - 24 || Lives life at a leisurely pace.
|-
| 0 - 9 || Can't be bothered with frantic, fast-paced living.

|- style="border-top: 3px solid #aaa"
! rowspan=6 | EXCITEMENT_SEEKING
| 91 - 100 || Lives for risk and excitement.
| rowspan=3 | More likely to join {{L|adventurer mode|adventurers}}
|-
| 76 - 90 || Is a risk-taker and a thrill-seeker.
|-
| 61 - 75 || Loves a good thrill.
|-
| 25 - 39 || Is not a risk-taker.
|-
| 10 - 24 || Doesn't need thrills or risks in life.
|-
| 0 - 9 || Is entirely adverse to risk and excitement.

|- style="border-top: 3px solid #aaa"
! rowspan=6 | CHEERFULNESS
| 91 - 100 || Often feels filled with joy.
|-
| 76 - 90 || Can be very happy and optimistic.
|-
| 61 - 75 || Is often cheerful.
|-
| 25 - 39 || Is rarely happy or enthusiastic.
|-
| 10 - 24 || Is a pessimist.
|-
| 0 - 9 || Is never optimistic or enthusiastic about anything.

|- style="border-top: 3px solid #aaa"
! rowspan=6 | IMAGINATION
| 91 - 100 || Is bored by reality and has a wonderful imagination.
|-
| 76 - 90 || Is incredibly creative.
|-
| 61 - 75 || Has a fertile imagination.
|-
| 25 - 39 || Isn't given to flights of fancy.
|-
| 10 - 24 || Is grounded in reality.
|-
| 0 - 9 || Is interested only in facts and the real world.

|- style="border-top: 3px solid #aaa"
! rowspan=6 | ARTISTIC_INTEREST
| 91 - 100 || Can easily become absorbed in art and the beauty of the natural world.
|-
| 76 - 90 || Greatly appreciates art and natural beauty.
|-
| 61 - 75 || Appreciates art and natural beauty.
|-
| 25 - 39 || Does not have a great aesthetic sensitivity.
|-
| 10 - 24 || Is not interested in art.
|-
| 0 - 9 || Is completely uninterested in art.

|- style="border-top: 3px solid #aaa"
! rowspan=6 | EMOTIONALITY
| 91 - 100 || Has a profound understanding of its/his/her own emotions.
|-
| 76 - 90 || Has a great awareness of its/his/her own emotions.
|-
| 61 - 75 || Has a good awareness of its/his/her own emotions.
|-
| 25 - 39 || Tends not to openly express emotions.
|-
| 10 - 24 || Is mostly unaware of its/his/her own emotions and rarely expresses them.
|-
| 0 - 9 || Does not display its/his/her own emotions and has no awareness of them.

|- style="border-top: 3px solid #aaa"
! rowspan=6 | ADVENTUROUSNESS
| 91 - 100 || Is highly adventurous and loves fresh experiences.
|-
| 76 - 90 || Is eager for new experiences.
|-
| 61 - 75 || Likes to try new things.
|-
| 25 - 39 || Prefers familiar routines.
|-
| 10 - 24 || Is uncomfortable with change.
|-
| 0 - 9 || Is resistant to change.

|- style="border-top: 3px solid #aaa"
! rowspan=6 | INTELLECTUAL_CURIOSITY
| 91 - 100 || Is entranced by riddles and puzzles and loves to debate issues and ideas.
|-
| 76 - 90 || Loves new and fresh ideas.
|-
| 61 - 75 || Is open-minded to new ideas.
|-
| 25 - 39 || Dislikes intellectual discussions.
|-
| 10 - 24 || Regards intellectual exercises as a waste of energy.
|-
| 0 - 9 || Is completely uninterested in ideas and debates over intellectual issues.

|- style="border-top: 3px solid #aaa"
! rowspan=6 | LIBERALISM
| 91 - 100 || Revels in chaos and disorder.
| rowspan=3 | Receives unhappy {{L|thought}} from talking to {{L|noble}}s{{verify}}
|-
| 76 - 90 || Loves to defy convention.
|-
| 61 - 75 || Is put off by authority and tradition.
|-
| 25 - 39 || Admires tradition.
| rowspan=3 | Receives happy {{L|thought}} from talking to {{L|noble}}s{{verify}}
|-
| 10 - 24 || Prefers stability and security to ambiguity and disorder.
|-
| 0 - 9 || Is an ardent believer in convention and traditional society.

|- style="border-top: 3px solid #aaa"
! rowspan=6 | TRUST
| 91 - 100 || Is naturally trustful of everybody.
|-
| 76 - 90 || Is very trusting.
|-
| 61 - 75 || Is trusting.
|-
| 25 - 39 || Is slow to trust others.
|-
| 10 - 24 || Does not trust others.
|-
| 0 - 9 || Sees others as selfish and conniving.

|- style="border-top: 3px solid #aaa"
! rowspan=6 | STRAIGHTFORWARDNESS
| 91 - 100 || Is incredibly frank and candid in dealings with others.
| rowspan=3 | Cannot gain {{L|Flatterer}} experience.
|-
| 76 - 90 || Is very straightforward with others.
|-
| 61 - 75 || Is candid and sincere in dealings with others.
|-
| 25 - 39 || Is guarded in {{L|relationship|relationships}} with others.
| rowspan=3 | Cannot gain {{L|Consoler}} experience<br />Can gain {{L|Liar}} experience.
|-
| 10 - 24 || Is not straightforward when dealing with others.
|-
| 0 - 9 || Believes that some deception is necessary in relationships with others.

|- style="border-top: 3px solid #aaa"
! rowspan=6 | ALTRUISM
| 91 - 100 || Is truly fulfilled by assisting those in need.
| rowspan=3 | Receives happy {{L|thought}} from rescuing wounded
|-
| 76 - 90 || Finds helping others very rewarding.
|-
| 61 - 75 || Finds helping others rewarding.
|-
| 25 - 39 || Does not go out of its/his/her way to help others.
| rowspan=3 | Receives unhappy {{L|thought}} from rescuing wounded
|-
| 10 - 24 || Dislikes helping others.
|-
| 0 - 9 || Views helping others as an imposition on own needs to get along with others.

|- style="border-top: 3px solid #aaa"
! rowspan=6 | COOPERATION
| 91 - 100 || Sacrifices its/his/her own needs to get along with others.
| rowspan=3 | Cannot gain {{L|Intimidator}} experience
|-
| 76 - 90 || Dislikes confrontations.
|-
| 61 - 75 || Is willing to compromise with others.
|-
| 25 - 39 || Doesn't like to compromise with others.
| rowspan=3 | Cannot gain {{L|Pacifier}} experience
|-
| 10 - 24 || Would rather intimidate others than compromise with them.
|-
| 0 - 9 || Would never deny its/his/her own needs just to compromise with somebody else.

|- style="border-top: 3px solid #aaa"
! rowspan=6 | MODESTY
| 91 - 100 || Would never claim to be better than somebody else.
|-
| 76 - 90 || Finds immodesty distasteful.
|-
| 61 - 75 || Is modest.
|-
| 25 - 39 || Is immodest.
|-
| 10 - 24 || Is very willing to compare itself/himself/herself favorably with others.
|-
| 0 - 9 || Would never shy away from an opportunity to say it/he/she is better than somebody else.

|- style="border-top: 3px solid #aaa"
! rowspan=6 | SYMPATHY
| 91 - 100 || Is incredibly compassionate and feels the pain of others.
|-
| 76 - 90 || Is easily moved to pity.
|-
| 61 - 75 || Is compassionate.
|-
| 25 - 39 || Is not easily moved to pity.
|-
| 10 - 24 || Is not affected by the suffering of others.
|-
| 0 - 9 || Would never let an objective judgement be tempered by mercy or pity.

|- style="border-top: 3px solid #aaa"
! rowspan=6 | SELF_EFFICACY
| 91 - 100 || Is incredibly confident.
|-
| 76 - 90 || Is very confident.
|-
| 61 - 75 || Is confident.
|-
| 25 - 39 || Lacks confidence.
|-
| 10 - 24 || Does not feel effective in life.
|-
| 0 - 9 || Feels as if it/he/she is not in control of its/his/her life.

|- style="border-top: 3px solid #aaa"
! rowspan=6 | ORDERLINESS
| 91 - 100 || Loves to make lists and keep schedules.
|-
| 76 - 90 || Tries to live a well-organized life.
|-
| 61 - 75 || Is organized.
|-
| 25 - 39 || Is disorganized.
|-
| 10 - 24 || Is very disorganized.
|-
| 0 - 9 || Is completely disorganized.

|- style="border-top: 3px solid #aaa"
! rowspan=6 | DUTIFULNESS
| 91 - 100 || Has a profound sense of duty and obligation.
|-
| 76 - 90 || Has a strong sense of duty.
|-
| 61 - 75 || Has a sense of duty.
|-
| 25 - 39 || Finds rules confining.
|-
| 10 - 24 || Dislikes contracts and regulations.
|-
| 0 - 9 || Hates rules, contracts and other confining elements in its/his/her life.

|- style="border-top: 3px solid #aaa"
! rowspan=6 | ACHIEVEMENT_STRIVING
| 91 - 100 || Constantly strives for perfection.
|-
| 76 - 90 || Thinks it is incredibly important to strive for excellence.
|-
| 61 - 75 || Strives for excellence.
|-
| 25 - 39 || Doesn't go out of its/his/her way to do more work than necessary.
|-
| 10 - 24 || Very rarely does more work than necessary.
|-
| 0 - 9 || Does the bare minimum necessary to accomplish the task at hand.

|- style="border-top: 3px solid #aaa"
! rowspan=6 | SELF_DISCIPLINE
| 91 - 100 || Will persist in the face of any difficulty until the task is complete.
| rowspan=6 | Affects duration of {{L|on break|breaks}}{{verify}}
|-
| 76 - 90 || Possesses great willpower.
|-
| 61 - 75 || Is self-disciplined.
|-
| 25 - 39 || Is occasionally given to procrastination.
|-
| 10 - 24 || Has very little self-discipline.
|-
| 0 - 9 || Rarely completes tasks and is often overcome by distractions.

|- style="border-top: 3px solid #aaa"
! rowspan=6 | CAUTIOUSNESS
| 91 - 100 || Thinks through every alternatives and their consequences before acting.
|-
| 76 - 90 || Is extremely cautious.
|-
| 61 - 75 || Takes time when making decisions.
|-
| 25 - 39 || Often does the first thing that comes to mind.
|-
| 10 - 24 || Acts impulsively.
|-
| 0 - 9 || Always acts without considering alternatives or thinking through possibilities.

|}

==Personality-Trait-Like Characteristics==

The following are not moddable personality traits, but are tracked in a similar manner by the game.

{| {{prettytable}}
|- style="background:#ddd"
! | Token
! | Value Range
! | Value Points
! | Effect

|- style="border-top: 3px solid #aaa"
! rowspan=6 | ALCOHOL_DEPENDENT *
| 91 - 100
| Needs alcohol to get through the working day.
|Had a drink recently, no penalty.
|-
| 76 - 90
| Needs alcohol to get through the working day and is starting to work slowly due to its scarcity.
| rowspan=3 | The lower this gets, the slower an alcohol dependent creature will work, and the longer their breaks become. Low intake of booze may be one cause of {{l|insanity}}.
|-
| 61 - 75
| Needs alcohol to get through the working day and really wants a drink.
|-
| 25 - 39
| Needs alcohol to get through the working day and has gone without a drink for far, far too long.
|-
| 10 - 24
| Needs alcohol to get through the working day and can't even remember the last time s/he had some.
|-
| 0 - 9
| ?????
|- style="border-top: 3px solid #aaa"
! rowspan=5 | CAVE_ADAPT †
| 91 - 100
| rowspan=3 | (There aren't actually personality traits that appear, but there are multiple levels of this that control how {{l|Cave_adaptation|cave adapted}} the creature actually is (whether or not they will grow irritated or {{l|vomit}}). This trait goes lower as creatures spend time in the {{l|sun}}.)
|-
| 76 - 90
|-
| 61 - 75
| rowspan=3 | These low levels of Cave Adaptation cause no ill effects.
|-
| 25 - 39
| Does not mind being outdoors, at least for a time.
|-
| 0 - 24
| Likes working outdoors and grumbles only mildly at inclement weather.
|- style="border-top: 3px solid #aaa"
! rowspan=4 | DETACHMENT ‡
| 76 - 100
| Doesn't really care about anything anymore.
| rowspan=3 | This trait increases as dwarves witness death and suffer tragedy. The higher it gets, the harder it is for the dwarf to be affected by negative thoughts, so in several ways, this is a useful if tragic side effect of running a bloody fort. This trait often finds its way into experienced {{l|military|soldiers}}, who might watch {{l|friend|friends}} and comrades die as often as they kill {{l|goblin|goblins}}.
|-
| 40 - 75
| Is a hardened individual.
|-
| 10 - 39
| Is getting used to tragedy.
|-
| 0 - 9
|
| Nothing displayed. Dwarf is not yet traumatized.
|}

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

v0.31:Sleep

2011-04-12T01:04:48Z

Bohandas: Added "See Adventure_mode#Sleep for information on sleep as it pertains to adventurer mode"

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

Just as dwarves need [[food]] and [[drink]], dwarves will eventually become tired. This is denoted by the term '''drowsy''' or later, '''exhausted''' on the wound screen. The dwarf will also have a blinking gray arrow.

Not all dwarves sleep at the same time, and dwarves don't sleep every day, but eventually all your dwarves will drop down. Sleeping dwarves will have their labor listed as '''sleep''', and they will be labeled '''unconscious''' on the wound screen. Dwarves receive a happy [[thought]] from sleeping in a bed, and from choosing when they sleep{{verify}}. In contrast, dwarves will receive an unhappy thought from sleeping on the floor, and from collapsing due to exhaustion.

Sleeping will occur in any constructed bed, this includes beds which have been designated as bedrooms, dormitories, barracks, and hospitals.

See [[Bedroom_design|Bedroom design]] and [[noise]] for information on planning for your dwarfs sleep.

See [[Adventure_mode#Sleep]] for information on sleep as it pertains to adventurer mode

v0.31:Material definition token

2011-04-09T02:26:05Z

Bohandas: Added note: "Allows storage in stone stockpiles, among other effects." for IS_STONE. Don't know what the other effects are, but there must be one, as some mats have both it & [NO_STONE_STOCKPILE]

{{av}}

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

==Material Properties==
{| {{prettytable}}
|- bgcolor="#C0C0C0"
! Token
! Arguments
! Description

|-
| PREFIX
|
| Unknown. Not permitted in material template definitions.

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

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

|-
| TEMP_DIET_INFO
|
| Unknown

|-
| POWDER_DYE
| {{L|color}} token
| Defines the material as a type of dye.

|-
| TILE
| tile
| Specifies the tile that will be used to represent unmined tiles made of this material. Generally only used with stones.

|-
| ITEM_SYMBOL
| tile
| Specifies the tile that will be used to represent BOULDER objects made of this material. Generally only used with stones.

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

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

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

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

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

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

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

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

|-
| ABSORPTION
|
*value
| The material's tendency to absorb liquids. Containers made of materials with nonzero absorption cannot hold liquids unless they have been {{L|glaze}}d.

|-
| IMPACT_YIELD
|
*value
| Specifies how hard of an impact the material can withstand before it will bend. Used for blunt-force combat.

|-
| IMPACT_FRACTURE
|
*value
| Specifies how hard of an impact the material can withstand before it will break. Used for blunt-force combat.

|-
| IMPACT_STRAIN_AT_YIELD or IMPACT_ELASTICITY
|
*value
| Specifies how much the material will bend when subjected to an impact. Used for blunt-force combat.

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

|-
| MULTIPLY_VALUE
|
*value
| Multiplies the value of the material. Not permitted in material template definitions.

|-
| SPEC_HEAT
|
*specific heat capacity
| Rate at which the material heats up or cools down. See {{L|SPEC HEAT}} for more information.

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

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

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

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

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

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

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

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

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

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

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

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

|-
| SOLID_DENSITY
|
*density
| Specifies the density (in kilograms per cubic meter) of the material when in solid form. Also affects combat calculations; affects blunt-force damage and ability of edged weapons to pierce tissue layers.{{verify}}

|-
| LIQUID_DENSITY
|
*density
| Specifies the density of the material when in liquid form.

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

|-
| EXTRACT_STORAGE
| BARREL or FLASK
| Specifies the type of container used to store the material. Used in conjunction with the [EXTRACT_BARREL], [EXTRACT_VIAL], or [EXTRACT_STILL_VIAL] {{L|plant token}}s.

|-
| BUTCHER_SPECIAL
|
*{{L|item token}}
| Specifies the item type used for butchering results made of this material. Stock raws use GLOB:NONE for fat and MEAT:NONE for other meat materials.

|-
| MEAT_NAME
|
*prefix
*name
*adjective?
| When a creature is butchered, meat yielded from organs made from this material will be named via this token.

|-
| BLOCK_NAME
|
*singular
*plural
| Specifies the name of {{L|block}}s made from this material.

|-
| MATERIAL_REACTION_PRODUCT
|
*reaction reference
*{{L|material token}}
| Used with reaction raws to associate a reagent material with a product material. The first argument is used by HAS_MATERIAL_REACTION_PRODUCT and GET_MATERIAL_FROM_REAGENT in reaction raws. The remainder is a material reference, generally LOCAL_CREATURE_MAT:SUBTYPE or LOCAL_PLANT_MAT:SUBTYPE or INORGANIC:STONETYPE.
[MATERIAL_REACTION_PRODUCT:TAN_MAT:LOCAL_CREATURE_MAT:LEATHER]

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

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

|-
| SOAP_LEVEL
|
*value
| Unknown
|}

==Material Usage Tokens==
{| {{prettytable}}
|- bgcolor="#C0C0C0"
! Token
! Arguments
! Description

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

|-
| ALCOHOL_PLANT or ALCOHOL
|
| Classifies the material as plant alcohol, allowing it to be stored in food stockpiles under "Drink (Plant)".

|-
| ALCOHOL_CREATURE
|
| Classifies the material as creature alcohol, allowing it to be stored in food stockpiles under "Drink (Animal)".

|-
| CHEESE_PLANT
|
| Classifies the material as plant cheese, allowing it to be stored in food stockpiles under "Cheese (Plant)".

|-
| CHEESE_CREATURE or CHEESE
|
| Classifies the material as creature cheese, allowing it to be stored in food stockpiles under "Cheese (Animal)".

|-
| POWDER_MISC_PLANT or POWDER_MISC
|
| Classifies the material as plant powder, allowing it to be stored in food stockpiles under "Milled Plant".

|-
| POWDER_MISC_CREATURE
|
| Classifies the material as creature powder, allowing it to be stored in food stockpiles under "Bone Meal".

|-
| STOCKPILE_GLOB or STOCKPILE_GLOB_SOLID
|
| Permits globs of the material in solid form to be stored in food stockpiles under "Fat" - without it, dwarves will come by and "clean" the items, destroying them (unless [DO_NOT_CLEAN_GLOB] is also included).

|-
| STOCKPILE_GLOB_PASTE
|
| Permits globs of the material in paste form to be stored in food stockpiles under "Paste".

|-
| STOCKPILE_GLOB_PRESSED
|
| Permits globs of the material in pressed form to be stored in food stockpiles under "Pressed Material".

|-
| LIQUID_MISC_PLANT or LIQUID_MISC
|
| Classifies the material as a plant extract, allowing it to be stored in food stockpiles under "Extract (Plant)".

|-
| LIQUID_MISC_CREATURE
|
| Classifies the material as a creature extract, allowing it to be stored in food stockpiles under "Extract (Animal)".

|-
| LIQUID_MISC_OTHER
|
| Classifies the material as a miscellaneous liquid, allowing it to be stored in food stockpiles under "Misc. Liquid" along with lye.

|-
| STRUCTURAL_PLANT_MAT
|
| Classifies the material as plant, allowing it to be stored in food stockpiles under "Plants".

|-
| SEED_MAT
|
| Classifies the material as plant seed, allowing it to be stored in food stockpiles under "Seeds".{{verify}}

|-
| LEAF_MAT
|
| Classifies the material as plant leaf, allowing it to be stored in food stockpiles under "Leaves".{{verify}}

|-
| BONE
|
| Classifies the material as bone, allowing it to be used by craftsdwarves.{{verify}}

|-
| WOOD
|
| Classifies the material as wood, allowing it to be used by carpenters.{{verify}} May also make elves angry if you try to trade it to them.

|-
| THREAD_PLANT
|
| Classifies the material as plant fiber, permitting thread and cloth to be stored in cloth stockpiles under "Thread (Plant)" and "Cloth (Plant)".

|-
| TOOTH
|
| Classifies the material as tooth, allowing it to be used by craftsdwarves.{{verify}}

|-
| HORN
|
| Classifies the material as horn, allowing it to be used by craftsdwarves.{{verify}}

|-
| PEARL
|
| Classifies the material as pearl, allowing it to be used by craftsdwarves.{{verify}}

|-
| SHELL
|
| Classifies the material as shell, allowing it to be used by craftsdwarves.{{verify}}

|-
| LEATHER
|
| Classifies the material as leather, allowing it to be used by craftsdwarves.{{verify}}

|-
| SILK
|
| Classifies the material as silk, permitting thread and cloth to be stored in cloth stockpiles under "Thread (Silk)" and "Cloth (Silk)".

|-
| SOAP
|
| Classifies the material as soap, permitting it to be stored in Bar/Block stockpiles with Soap enabled.{{verify}}

|-
| GENERATES_MIASMA
|
| Material generates miasma when it rots

|-
| MEAT
|
| Classifies the material as edible meat.{{verify}}

|-
| ROTS
|
| Material will rot if not stockpiled appropriately

|-
| BLOOD_MAP_DESCRIPTOR
|
| Tells the game to classify contaminants of this material as being "blood", both in Adventurer mode tile descriptions ("Here we have a Dwarf in a slurry of blood.") and for unhappy thoughts from drinking water ("He was forced to drink bloody water lately").

|-
| ICHOR_MAP_DESCRIPTOR
|
| Tells the game to classify contaminants of this material as being "ichor".

|-
| GOO_MAP_DESCRIPTOR
|
| Tells the game to classify contaminants of this material as being "goo".

|-
| SLIME_MAP_DESCRIPTOR
|
| Tells the game to classify contaminants of this material as being "slime".

|-
| PUS_MAP_DESCRIPTOR
|
| Tells the game to classify contaminants of this material as being "pus".

|-
| ENTERS_BLOOD
|
| Used for materials which cause {{L|syndrome}}s, causes it to enter the creature's blood instead of simply spattering on the surface.

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

|-
| EDIBLE_RAW
|
| Can be eaten raw.

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

|-
| DO_NOT_CLEAN_GLOB
|
| Prevents globs made of this material from being cleaned up and destroyed.

|-
| NO_STONE_STOCKPILE
|
| Prevents the material from showing up in Stone stockpile settings.

|-
| ITEMS_METAL
|
| Effect unknown

|-
| ITEMS_BARRED
|
| {{L|Bone}} items (clothes with [BARRED]) can be made from this material.

|-
| ITEMS_SCALED
|
| {{L|Shell}} items (clothes with [SCALED]) can be made from this material.

|-
| ITEMS_LEATHER
|
| {{L|Leather}} items (clothes with [LEATHER]) can be made from this material.

|-
| ITEMS_SOFT
|
| Soft clothing items, backpacks and quivers, and siege engine parts can be made from this material.

|-
| ITEMS_HARD
|
| Furniture, medical supplies, and crafts can be made out of this material.

|-
| IS_STONE
|
| Used to define that said material is stone. Allows storage in stone stockpiles, among other effects.

|-
| UNDIGGABLE
|
| Used for a stone that cannot be dug into.

|-
| DISPLAY_UNGLAZED
|
| Causes containers made of this material to be prefixed with "unglazed" if they have not yet been {{L|glaze}}d.

|-
| YARN
|
| Classifies the material as yarn, permitting thread and cloth to be stored in cloth stockpiles under "Thread (Yarn)" and "Cloth (Yarn)".

|-
| STOCKPILE_THREAD_METAL
|
| Classifies the material as metal thread, permitting thread and cloth to be stored in cloth stockpiles under "Thread (Metal)" and "Cloth (Metal)".

|-
| IS_METAL
|
| Defines the material as being metal, allowing it to be used at forges.

|-
| IS_GLASS
|
| Used internally by green glass, clear glass, and crystal glass.

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

|-
| ITEMS_WEAPON
|
| Melee {{L|Weapon#Manufactured weapons|weapons}} can be made out of this material.

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

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

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

|-
| ITEMS_DIGGER
|
| {{L|Weapon#Dwarf-manufactured weapons|Picks}} can be made out of this material.

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

|-
| ITEMS_DELICATE
|
| Used internally by amber and coral.

|-
| ITEMS_SIEGE_ENGINE
|
| Siege engine parts can be made out of this material. Does not appear to work.

|-
| ITEMS_QUERN
|
| Querns and millstones can be made out of this material.{{verify}}
|}

==Syndrome tokens==

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

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

|-
| SYN_INJECTED
|
| syndrome can be contracted by injection (by a creature)

|-
| SYN_CONTACT
|
| syndrome can be contracted on contact (e.g. poison dust or liquid)

|-
| SYN_INHALED
|
| syndrome can be contracted by inhalation (e.g. poison vapor or gas)

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

|-
| SYN_IMMUNE_CLASS
|
| makes the class of creatures immune to the syndrome

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

|-
| SYN_IMMUNE_CREATURE
| creature
| makes the creature immune to the syndrome

|-
| CE_PAIN<br />CE_SWELLING<br />CE_OOZING<br />CE_BRUISING<br />CE_BLISTERS<br />CE_NUMBNESS<br />CE_PARALYSIS<br />CE_FEVER<br />CE_BLEEDING<br />CE_COUGH_BLOOD<br />CE_VOMIT_BLOOD<br />CE_NAUSEA<br />CE_UNCONSCIOUSNESS<br />CE_NECROSIS<br />CE_IMPAIR_FUNCTION<br />CE_DROWSINESS<br />CE_DIZZINESS
|
*SEV:<value> (severity, higher is worse)
*PROB:<value(1-100)> (probability)
*RESISTABLE (optional) allows resistance
*SIZE_DILUTES (optional) lessens effect based on size
Place affected:
*LOCALIZED (optional)
*VASCULAR_ONLY (optional)
*MUSCULAR_ONLY (optional)
*BP:(select BY_CATEGORY, BY_TYPE, or BY_TOKEN):category, type or token:tissues affected (specific or ALL) (optional)
Timeline:
*Start:effect start time
*Peak:effect peak time
*End:effect end time
| Specifies the way that a syndrome affects a creature -- more detail can be found on the {{L|Syndrome#Creature effect tokens|Syndromes page}}

|}

==See Also==
* {{L|Inorganic material definition token}}
* {{L|Syndrome}}

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

v0.31:Material definition token

2011-04-09T02:21:58Z

Bohandas: Changed bgcolor="#ddd" to bgcolor="#COCOCO" to make table headings readable

{{av}}

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

==Material Properties==
{| {{prettytable}}
|- bgcolor="#COCOCO"
! Token
! Arguments
! Description

|-
| PREFIX
|
| Unknown. Not permitted in material template definitions.

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

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

|-
| TEMP_DIET_INFO
|
| Unknown

|-
| POWDER_DYE
| {{L|color}} token
| Defines the material as a type of dye.

|-
| TILE
| tile
| Specifies the tile that will be used to represent unmined tiles made of this material. Generally only used with stones.

|-
| ITEM_SYMBOL
| tile
| Specifies the tile that will be used to represent BOULDER objects made of this material. Generally only used with stones.

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

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

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

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

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

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

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

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

|-
| ABSORPTION
|
*value
| The material's tendency to absorb liquids. Containers made of materials with nonzero absorption cannot hold liquids unless they have been {{L|glaze}}d.

|-
| IMPACT_YIELD
|
*value
| Specifies how hard of an impact the material can withstand before it will bend. Used for blunt-force combat.

|-
| IMPACT_FRACTURE
|
*value
| Specifies how hard of an impact the material can withstand before it will break. Used for blunt-force combat.

|-
| IMPACT_STRAIN_AT_YIELD or IMPACT_ELASTICITY
|
*value
| Specifies how much the material will bend when subjected to an impact. Used for blunt-force combat.

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

|-
| MULTIPLY_VALUE
|
*value
| Multiplies the value of the material. Not permitted in material template definitions.

|-
| SPEC_HEAT
|
*specific heat capacity
| Rate at which the material heats up or cools down. See {{L|SPEC HEAT}} for more information.

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

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

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

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

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

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

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

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

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

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

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

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

|-
| SOLID_DENSITY
|
*density
| Specifies the density (in kilograms per cubic meter) of the material when in solid form. Also affects combat calculations; affects blunt-force damage and ability of edged weapons to pierce tissue layers.{{verify}}

|-
| LIQUID_DENSITY
|
*density
| Specifies the density of the material when in liquid form.

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

|-
| EXTRACT_STORAGE
| BARREL or FLASK
| Specifies the type of container used to store the material. Used in conjunction with the [EXTRACT_BARREL], [EXTRACT_VIAL], or [EXTRACT_STILL_VIAL] {{L|plant token}}s.

|-
| BUTCHER_SPECIAL
|
*{{L|item token}}
| Specifies the item type used for butchering results made of this material. Stock raws use GLOB:NONE for fat and MEAT:NONE for other meat materials.

|-
| MEAT_NAME
|
*prefix
*name
*adjective?
| When a creature is butchered, meat yielded from organs made from this material will be named via this token.

|-
| BLOCK_NAME
|
*singular
*plural
| Specifies the name of {{L|block}}s made from this material.

|-
| MATERIAL_REACTION_PRODUCT
|
*reaction reference
*{{L|material token}}
| Used with reaction raws to associate a reagent material with a product material. The first argument is used by HAS_MATERIAL_REACTION_PRODUCT and GET_MATERIAL_FROM_REAGENT in reaction raws. The remainder is a material reference, generally LOCAL_CREATURE_MAT:SUBTYPE or LOCAL_PLANT_MAT:SUBTYPE or INORGANIC:STONETYPE.
[MATERIAL_REACTION_PRODUCT:TAN_MAT:LOCAL_CREATURE_MAT:LEATHER]

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

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

|-
| SOAP_LEVEL
|
*value
| Unknown
|}

==Material Usage Tokens==
{| {{prettytable}}
|- bgcolor="#COCOCO"
! Token
! Arguments
! Description

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

|-
| ALCOHOL_PLANT or ALCOHOL
|
| Classifies the material as plant alcohol, allowing it to be stored in food stockpiles under "Drink (Plant)".

|-
| ALCOHOL_CREATURE
|
| Classifies the material as creature alcohol, allowing it to be stored in food stockpiles under "Drink (Animal)".

|-
| CHEESE_PLANT
|
| Classifies the material as plant cheese, allowing it to be stored in food stockpiles under "Cheese (Plant)".

|-
| CHEESE_CREATURE or CHEESE
|
| Classifies the material as creature cheese, allowing it to be stored in food stockpiles under "Cheese (Animal)".

|-
| POWDER_MISC_PLANT or POWDER_MISC
|
| Classifies the material as plant powder, allowing it to be stored in food stockpiles under "Milled Plant".

|-
| POWDER_MISC_CREATURE
|
| Classifies the material as creature powder, allowing it to be stored in food stockpiles under "Bone Meal".

|-
| STOCKPILE_GLOB or STOCKPILE_GLOB_SOLID
|
| Permits globs of the material in solid form to be stored in food stockpiles under "Fat" - without it, dwarves will come by and "clean" the items, destroying them (unless [DO_NOT_CLEAN_GLOB] is also included).

|-
| STOCKPILE_GLOB_PASTE
|
| Permits globs of the material in paste form to be stored in food stockpiles under "Paste".

|-
| STOCKPILE_GLOB_PRESSED
|
| Permits globs of the material in pressed form to be stored in food stockpiles under "Pressed Material".

|-
| LIQUID_MISC_PLANT or LIQUID_MISC
|
| Classifies the material as a plant extract, allowing it to be stored in food stockpiles under "Extract (Plant)".

|-
| LIQUID_MISC_CREATURE
|
| Classifies the material as a creature extract, allowing it to be stored in food stockpiles under "Extract (Animal)".

|-
| LIQUID_MISC_OTHER
|
| Classifies the material as a miscellaneous liquid, allowing it to be stored in food stockpiles under "Misc. Liquid" along with lye.

|-
| STRUCTURAL_PLANT_MAT
|
| Classifies the material as plant, allowing it to be stored in food stockpiles under "Plants".

|-
| SEED_MAT
|
| Classifies the material as plant seed, allowing it to be stored in food stockpiles under "Seeds".{{verify}}

|-
| LEAF_MAT
|
| Classifies the material as plant leaf, allowing it to be stored in food stockpiles under "Leaves".{{verify}}

|-
| BONE
|
| Classifies the material as bone, allowing it to be used by craftsdwarves.{{verify}}

|-
| WOOD
|
| Classifies the material as wood, allowing it to be used by carpenters.{{verify}} May also make elves angry if you try to trade it to them.

|-
| THREAD_PLANT
|
| Classifies the material as plant fiber, permitting thread and cloth to be stored in cloth stockpiles under "Thread (Plant)" and "Cloth (Plant)".

|-
| TOOTH
|
| Classifies the material as tooth, allowing it to be used by craftsdwarves.{{verify}}

|-
| HORN
|
| Classifies the material as horn, allowing it to be used by craftsdwarves.{{verify}}

|-
| PEARL
|
| Classifies the material as pearl, allowing it to be used by craftsdwarves.{{verify}}

|-
| SHELL
|
| Classifies the material as shell, allowing it to be used by craftsdwarves.{{verify}}

|-
| LEATHER
|
| Classifies the material as leather, allowing it to be used by craftsdwarves.{{verify}}

|-
| SILK
|
| Classifies the material as silk, permitting thread and cloth to be stored in cloth stockpiles under "Thread (Silk)" and "Cloth (Silk)".

|-
| SOAP
|
| Classifies the material as soap, permitting it to be stored in Bar/Block stockpiles with Soap enabled.{{verify}}

|-
| GENERATES_MIASMA
|
| Material generates miasma when it rots

|-
| MEAT
|
| Classifies the material as edible meat.{{verify}}

|-
| ROTS
|
| Material will rot if not stockpiled appropriately

|-
| BLOOD_MAP_DESCRIPTOR
|
| Tells the game to classify contaminants of this material as being "blood", both in Adventurer mode tile descriptions ("Here we have a Dwarf in a slurry of blood.") and for unhappy thoughts from drinking water ("He was forced to drink bloody water lately").

|-
| ICHOR_MAP_DESCRIPTOR
|
| Tells the game to classify contaminants of this material as being "ichor".

|-
| GOO_MAP_DESCRIPTOR
|
| Tells the game to classify contaminants of this material as being "goo".

|-
| SLIME_MAP_DESCRIPTOR
|
| Tells the game to classify contaminants of this material as being "slime".

|-
| PUS_MAP_DESCRIPTOR
|
| Tells the game to classify contaminants of this material as being "pus".

|-
| ENTERS_BLOOD
|
| Used for materials which cause {{L|syndrome}}s, causes it to enter the creature's blood instead of simply spattering on the surface.

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

|-
| EDIBLE_RAW
|
| Can be eaten raw.

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

|-
| DO_NOT_CLEAN_GLOB
|
| Prevents globs made of this material from being cleaned up and destroyed.

|-
| NO_STONE_STOCKPILE
|
| Prevents the material from showing up in Stone stockpile settings.

|-
| ITEMS_METAL
|
| Effect unknown

|-
| ITEMS_BARRED
|
| {{L|Bone}} items (clothes with [BARRED]) can be made from this material.

|-
| ITEMS_SCALED
|
| {{L|Shell}} items (clothes with [SCALED]) can be made from this material.

|-
| ITEMS_LEATHER
|
| {{L|Leather}} items (clothes with [LEATHER]) can be made from this material.

|-
| ITEMS_SOFT
|
| Soft clothing items, backpacks and quivers, and siege engine parts can be made from this material.

|-
| ITEMS_HARD
|
| Furniture, medical supplies, and crafts can be made out of this material.

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

|-
| UNDIGGABLE
|
| Used for a stone that cannot be dug into.

|-
| DISPLAY_UNGLAZED
|
| Causes containers made of this material to be prefixed with "unglazed" if they have not yet been {{L|glaze}}d.

|-
| YARN
|
| Classifies the material as yarn, permitting thread and cloth to be stored in cloth stockpiles under "Thread (Yarn)" and "Cloth (Yarn)".

|-
| STOCKPILE_THREAD_METAL
|
| Classifies the material as metal thread, permitting thread and cloth to be stored in cloth stockpiles under "Thread (Metal)" and "Cloth (Metal)".

|-
| IS_METAL
|
| Defines the material as being metal, allowing it to be used at forges.

|-
| IS_GLASS
|
| Used internally by green glass, clear glass, and crystal glass.

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

|-
| ITEMS_WEAPON
|
| Melee {{L|Weapon#Manufactured weapons|weapons}} can be made out of this material.

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

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

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

|-
| ITEMS_DIGGER
|
| {{L|Weapon#Dwarf-manufactured weapons|Picks}} can be made out of this material.

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

|-
| ITEMS_DELICATE
|
| Used internally by amber and coral.

|-
| ITEMS_SIEGE_ENGINE
|
| Siege engine parts can be made out of this material. Does not appear to work.

|-
| ITEMS_QUERN
|
| Querns and millstones can be made out of this material.{{verify}}
|}

==Syndrome tokens==

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

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

|-
| SYN_INJECTED
|
| syndrome can be contracted by injection (by a creature)

|-
| SYN_CONTACT
|
| syndrome can be contracted on contact (e.g. poison dust or liquid)

|-
| SYN_INHALED
|
| syndrome can be contracted by inhalation (e.g. poison vapor or gas)

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

|-
| SYN_IMMUNE_CLASS
|
| makes the class of creatures immune to the syndrome

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

|-
| SYN_IMMUNE_CREATURE
| creature
| makes the creature immune to the syndrome

|-
| CE_PAIN<br />CE_SWELLING<br />CE_OOZING<br />CE_BRUISING<br />CE_BLISTERS<br />CE_NUMBNESS<br />CE_PARALYSIS<br />CE_FEVER<br />CE_BLEEDING<br />CE_COUGH_BLOOD<br />CE_VOMIT_BLOOD<br />CE_NAUSEA<br />CE_UNCONSCIOUSNESS<br />CE_NECROSIS<br />CE_IMPAIR_FUNCTION<br />CE_DROWSINESS<br />CE_DIZZINESS
|
*SEV:<value> (severity, higher is worse)
*PROB:<value(1-100)> (probability)
*RESISTABLE (optional) allows resistance
*SIZE_DILUTES (optional) lessens effect based on size
Place affected:
*LOCALIZED (optional)
*VASCULAR_ONLY (optional)
*MUSCULAR_ONLY (optional)
*BP:(select BY_CATEGORY, BY_TYPE, or BY_TOKEN):category, type or token:tissues affected (specific or ALL) (optional)
Timeline:
*Start:effect start time
*Peak:effect peak time
*End:effect end time
| Specifies the way that a syndrome affects a creature -- more detail can be found on the {{L|Syndrome#Creature effect tokens|Syndromes page}}

|}

==See Also==
* {{L|Inorganic material definition token}}
* {{L|Syndrome}}

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

v0.31:Health care

2011-04-08T02:42:49Z

Bohandas: Added parenthetical question mark to tip regarding keeping the chief medical dwarf unbusy to represent the uncertainty that he is the only one who may diagnose. See discussion page.

{{quality|Fine|14:52, 25 March 2011 (UTC)}}{{av}}

'''Hospitals''' are a {{l|Activity zone#Hospital|zone}} designated via the {{l|Activity zone|zone menu}}. Hospitals use any beds, tables, traction benches, and boxes/bags that are within these zones. You may also alter how much {{l|thread}}, {{l|cloth}}, {{l|splint}}s, {{l|crutch}}es, {{l|plaster powder}} for casts, {{l|bucket}}s, and {{l|soap}} hospitals use.

'''Doctors''' are dwarves assigned to any of the five medical labors; dressing wounds, diagnosis, surgery, setting bones, and suturing. All doctors in the fortress operate under the instruction of the {{l|Chief medical dwarf}}, an appointed {{l|noble}}. Doctors 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 {{l|Health screen|z-health screen}}.

All beds within a hospital zone are automatically Hospital beds, where injured dwarves will go to recuperate. Tired healthy dwarves will occasionally camp there too if the hospital is close, even if they have their own bed.

== Medical Skills ==
There are five doctor skills - how critical they are is unclear at the moment, but from [[Toady]]'s pre-release comments we can assume they are moderately important to the healing process.

Labors (& Skills)

* {{l|Diagnosis}} ({{L|Diagnostician}}) This skill is used at the start of the treatment of every wounded; used a lot and also needed by your chief medical dwarf
* {{l|Surgery}} ({{L|Surgeon}}) Somewhat less common; amongst others, wounds to organs seem to require it
* {{l|Setting bones}} ({{L|Bone doctor}}) This is obviously needed for broken bones, but perhaps not for all?
* {{l|Suturing}} ({{L|Suturer}}) Fairly common; most open wounds (from cutting) seem to need it? Seems more like every fracture needs suture
* {{l|Dressing wounds}} ({{L|Wound dresser}}) This is also used pretty often; any wound seems to need it

===Non-doctor labors===

"Non"-doctors have 2 {{L|labor}}s that contribute to healthcare:

* {{L|Feed patients/prisoners}}
* {{L|Recovering wounded}}

Note that these are not {{L|skill}}s - they do not cause experience gain, but merely are activities that can be turned on/off for each dwarf. By default, all dwarves start with these labors designated.

==Setting up a Hospital==
* You must have assigned a Chief Medical Dwarf to diagnose patients. 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.)
* Ensure your doctors have their respective healthcare labors enabled through {{k|v}}-{{k|p}}-{{k|l}} in order to handle treatments.
* Hit {{k|i}} and set up a hospital [[zone]] for the area you plan on having your hospital in. Be sure "Hospital" is highlighted.
* Place enough beds 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.
* Build at least four containers ({{k|b}}-{{k|h}}) to store hospital supplies.
* Build tables ({{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 will 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 [http://www.bay12forums.com/smf/index.php?topic=60231.0]
* Build one (or more) traction benches to handle compound fractures when the dwarf requires "immobilization."

== Broken bones ==

Broken bones can be treated with just thread and cloth. After a while the treated broken bone will turn into a fracture, allowing a suture to be applied which will finally allow the bedridden dwarf to get up and make himself relatively useful, grasping is still impaired during healing. If you want the dwarf to get up and make himself useful immediately, you'll need to apply a plaster cast, which will require some more effort.

=== Traction Benches ===

A '''traction bench''' is used by a {{l|doctor}} in a {{l|Hospital|hospital zone}} to immobilize a dwarf that has sustained complex or overlapping fractures.

It is constructed in the {{l|Mechanic's workshop}}, and requires a {{l|table}}, a {{l|mechanism}}, and a {{l|rope}} or a {{l|chain}} to construct.

=== Casts ===

Casts are made out of {{l|plaster powder}} and are used to keep broken bones in their proper place until healed. To store it in a hospital, create a stockpile with furniture/siege ammo enabled, metals allowed (is this needed?), core and total quality all allowed, material plant cloth, and boxes and bags individually selected. Gypsum plaster under "other stones" should also be selected. Applying a cast also requires a bucket and cloth, and a water source.

Plaster powder is produced at a {{L|kiln}} or {{L|magma kiln}} from {{L|gypsum}}, {{L|alabaster}}, {{L|selenite}}, or {{L|satinspar}} and an empty {{L|bag}} by a dwarf with the furnace operator skill enabled. They can also be bought at embark for 3 points per unit, with each unit coming with a free {{L|bag}}.

=== Crutches ===

{|
|Crutches are represented with the symbol
|{{RT0|┬|#770}}
|.
|}

A dwarf that needs to use a crutch/crutches will gain experience in the '''Crutch Walking''' skill, which Toady has stated will reduce the speed penalty for having to use crutches. Presumably, at legendary, they will move just as fast as without crutches. Testing remains to be seen whether using crutches causes any other penalties that this skill might reduce.

'''See Also:'''
*{{l|Health screen|z-health screen}}

==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 stagnant water source
* Cleaning without soap
* Medical operation from unskilled doctors {{verify}}
* Bad luck

==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 {{l|soap}} page to understand that industry. Bring a 2 lye on embark for easy soap.
* Put a well inside the hospital for maximum efficiency. Doctors need to wash regularly, and clean water reduces infection.
* Do not place chairs next your surgery tables. A chair is an invitation for rat-roast eating freeloaders to block the medical process.
* Consider making use of burrows 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 should be kept unbusy and near the hospital, as no treatment will begin until he(?) has diagnosed them.
** Yes, expecting him to also treat dwarves is a distraction. When you have multiple dwarves needing a diagnosis, the other medical dwarves cannot start work until he has finished.
* 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.
** "Give food" and "Give water" are low priority jobs, so it is entirely possible for a patient to starve to death if no one ever gets "unbusy" enough to bring them food.
** 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 helps prevent dwarves that hate bringing others food from receiving unhappy thoughts for being "forced" to.
* Consult the talk page where past bugs are detailed. Healthcare started out with many bugs. Some of those bugs may no longer be valid.

Dwarves will prefer to store and use the most expensive thread and cloth. Yes, that includes '''adamantine strands'''. ''Fortunately,'' adamantine is not nearly as useful in DF2010 as it used to be; this would have been crippling in 40d.

==Problems==

You can re-injure a dwarf if it is stuck in surgery, or is never properly treated by causing a {{l|Cave-in}}. This will result in a request for a new diagnosis to be made. If he is stuck in a bed you may be able to remove the bed the dwarf is resting in to cause him to leave the hospital. However if a dwarf appears to be "stuck" in a bed they may be resting because of a severe infection. Forcing it out of the hospital may contaminate the rest of the fortress.

Items linking to a bug on the bug tracker are accurate as of {{version|0.31.22}}. Older bugs should be removed or tagged with the version they were fixed in.
* Dwarves with healthcare jobs will use the closest supplies to do their work, even if they are not stored in the hospital. {{bug|287}}
* The quality and value of a finished traction bench doesn't account for all of the inputs used to make it. {{verify}}
* Dwarves will steal items from the caravan and store them in hospital.
* Dwarves with broken legs may get up and walk out of the hospital if not treated quickly enough. {{Verify}}

[[Category:Current]]

v0.31:Advanced world generation

2011-04-08T02:08:11Z

Bohandas: Modified table headings to make them readable (why does everyone always seem to create new tables using that stupic no-contrast, black on black color scheme anyway???)

{{quality|Exceptional|23:35, 30 March 2011 (UTC)}}{{av}}

:''This article contains information on advanced world generation. For information on basic world generation, see {{L|World generation}}.''
:''See {{L|World token}} to more easily find information by the names used in the world_gen.txt file.''
:''See {{L|World rejection}} for information on solving problems related to worlds always being rejected.''
:''See {{L|Worldgen examples}} for example worlds.''

When you want more control of what your world looks like, it's time for '''advanced world generation'''. A detailed reference with advice is provided below. This article assumes that you are already familiar with {{L|World generation|'''basic''' world generation}}. If you are not then please read about that first.

= Advanced World Generation Screen =

Once you select {{DFtext|Design New World With Advanced Parameters}} from the main menu, a screen that looks something like this will appear:

[[File:AdvancedWorldGen.png‎]]

This screen is relatively intuitive but some parts could use some explanation.

== Parameter Sets ==

The list of already defined parameter sets is in the upper right corner. You can select the current set that you want to work with using the up and down directional keys.

Hitting {{K|a}} will add a new set to the end of the list. You can also {{K|c}}opy an existing set to a new one allowing you to base a new set on an existing one. Using {{K|t}} you can change the name of the parameter set but note that this will not effect the name of the world that is generated.

Parameter sets are stored in the <tt>data/init/world_gen.txt</tt> file in the main DF directory. The {{K|F1}} and {{K|F6}} keys will load and save '''all''' of the parameter sets to this file. You will need to save the world gen parameters to this file before you hit {{K|Enter}} to generate the world.

The <tt>world_gen.txt</tt> file can also be edited with a text editor. This is particularly useful because people will often post their parameter sets on the forum or wiki in text form. (See below for more info.) The {{K|F1}} key comes in handy when editing this file while the game is still running.

The tokens used in <tt>world_gen.txt</tt> are at the bottom of each parameter description. Here's the one for title.

{| {{prettytable}}
|- bgcolor="#dddddd"
! Token
! Example
! Notes
|-
| <tt><nowiki>[TITLE: <name>]</nowiki></tt>
| <tt><nowiki>[TITLE:MEDIUM ISLAND]</nowiki></tt>
| Required
|}

== World Name ==

As previously mentioned, the title of the parameter set doesn't affect the name of the world. You can force a particular name for your world using {{K|n}} or set it back to the default random setting using {{K|N}}.

{| {{prettytable}}
|- bgcolor="#dddddd"
! Token
! Example
! Notes
|-
| <tt><nowiki>[CUSTOM_NAME: <name>]</nowiki></tt>
| <tt><nowiki>[CUSTOM_NAME:Realm of Cheese Engravings]</nowiki></tt>
| For a random name, simply don't use this token.
|}

== World Dimensions ==

The size of the map to be generated can be selected with {{K|u}} {{K|i}} {{K|o}} {{K|p}}. Larger maps take longer to generate and may limit {{L|Frames per second|FPS}} in game.

Changing the dimensions of the world will reset the parameters because many of them have different defaults depending on the surface area available.

{| {{prettytable}}
|- bgcolor="#dddddd"
! Token
! Example
! Notes
|-
| <tt><nowiki>[DIM:<width>:<height>]</nowiki></tt>
| <tt><nowiki>[DIM:129:129]</nowiki></tt>
| Valid values are 17,33,65,129, and 257. Others may not work.
|}

== Seed Values ==

The world generation process uses a PRNG (Pseudo Random Number Generator) algorithm. A PRNG will produce a sequence of numbers that "looks" random even though the actual sequence of numbers will always be the same if the PRNG is started with the same seed value. Basically this means that if you run word generation with a certain seed value on your computer, and someone else runs world generation with the same seed value on their computer, the same sequence of random numbers will be generated on both computers. The practical impact of this is that someone else can generate exactly the same world that you generated by entering the same seed value that you used.

A specific seed value can be entered with {{K|s}}. This will change '''all''' of the seed values to the value you enter. If you need to enter different seed values for each type of see, use {{K|e}}.

In order to find out what seed values were used for the last world you generated you can look at this screen. If you want to be able to tell someone else how to generate exactly the same world that you just generated, they will need all of the seed value listed under Last Param Set.

Normally you don't enter these seed values and the world generation process comes up with seed values based on some sort of "true" random information from things like random values in uninitialized memory, the current date/time, etc. If you have entered a seed value you can revert back to all seeds being random using {{K|S}}.

== Entering Advanced Parameters and Generating a World ==

Unless you're using an already defined parameter set you will probably want to {{K|e}}dit the parameters. Select the set you want to edit using the up/down directional keys and press {{K|e}}. Information about each parameter is documented below.

Once you are happy with the parameters you have set, hit {{K|Esc}} to get back to this screen, hit {{K|F6}} to save the values you just edited, and hit {{K|Enter}} to start. The rest of the process is the same as basic {{L|World generation}}.

The phases of the world generation process are (this order is not completely correct):
* Preparing elevation...
* Setting temperature...
* Running rivers...
* Forming lakes and minerals...
* Growing vegetation...
* Verifying terrain...
* Importing wildlife...
* Recounting legends...
* Placing civilizations...
* Making cave civilizations...
* Making cave pops...
* Placing other beasts...
* Placing megabeasts...
* Placing good/evil...
* Placing caves...
* Prehistory generation
* Finalizing civ mats...
* Finalizing art...
* Finalizing uniforms...
* Finalizing sites...

== World Painter ==
:''Main article {{L|World painter}}
The '''world painter''' tool allows you to paint features onto a map that is then used when generating a world. It is very difficult to use properly, and tends to result in endless rejected worlds, unless you loosen or remove the restrictions placed on biomes and civilizations in the advanced settings. That being said it is also a very powerful tool, and allows you to generate worlds more to your liking.

To access the world painter, hit {{k|e}} to start editing the advanced parameters and finally hit {{k|p}} to open world painter. How to use the world painter is not entirely obvious so please check out the {{L|World painter}} documentation to avoid frustration. (Losing may be fun, but frustration is not.)

== Editing the Parameters Init File Directly ==

Parameter sets are stored in ''world_gen.txt'' in the ''\data\init'' folder, using {{L|world token}}. You can copy and paste other player's sets of parameters into your ''world_gen.txt'' to use their parameter sets, and some are provided at [[Pregenerated worlds]]. Another place to find parameter sets is the [http://www.bay12games.com/forum/index.php?topic=20638.0 Worldgen cookbook] thread on the official forums.

= Advanced Parameters =

To access advanced parameters, press {{key|e}} when at the screen for creating new worlds with parameters screen. This will bring you to an editable list of various guidelines the world-gen process will use when creating your new world.

The parameters are described below in the order that they appear in the list in the UI, not necessarily the other they appear in the configuration file. See {{L|world token}} for an index that will help you look things up by token name.

== Seed Values ==

Here you can enter specific seed values for different parts of the world generation process. Different sequences of pseudorandom numbers are used for different parts, so you can use this to reproduce only the particular part of world generation from some previously generated world if you want.

Normally you will want to leave all of these set to Random unless you're specifically trying to reproduce the results of another world generation run.

{| {{prettytable}}
|- bgcolor="#dddddd"
! Token
! Example
! Notes
|-
| <tt><nowiki>[SEED:<number>]</nowiki></tt>
| <tt><nowiki>[SEED:31337]</nowiki></tt>
| rowspan="4" |
For each of these not in the config file, a random seed will be used.
|-
| <tt><nowiki>[HISTORY_SEED:<number>]</nowiki></tt>
| <tt><nowiki>[HISTORY_SEED:31337]</nowiki></tt>
|-
| <tt><nowiki>[NAME_SEED:<number>]</nowiki></tt>
| <tt><nowiki>[NAME_SEED:31337]</nowiki></tt>
|-
| <tt><nowiki>[CREATURE_SEED:<number>]</nowiki></tt>
| <tt><nowiki>[CREATURE_SEED:31337]</nowiki></tt>
|}

== Embark Points ==

This controls the number of points that you have for skills and equipment when you embark in fortress mode. Turning this value up will allow games started in this world to start with more skilled dwarves with better equipment. Normally you can do just fine by leaving this value set to default, but you might want to up it for experimental/testing purposes or to help dwarves survive in a particularly evil world.

{| {{prettytable}}
|- bgcolor="#dddddd"
! Token
! Example
! Notes
|-
| <tt><nowiki>[EMBARK_POINTS:<number>]</nowiki></tt>
| <tt><nowiki>[EMBARK_POINTS:1274]</nowiki></tt>
| Required
|}

== End Year ==

This is how many years of history are generated for the world. This is basically the same as the History parameter in basic world gen, except that you can enter an exact value for number of years. See {{L|World_generation#History|History}} for more info.

History is divided into "ages" which are determined by the ''percentage'' of megabeasts and semi-megabeasts killed at various points. One can attempt to make a world go through the ages more quickly by pumping up the amount of semimegabeasts, who are usually more killable than the regular megabeasts. This will net you more "Age of Legends", "Age of Heroes", etc. See [[#Titan Parameters|Titan Parameters]] for how to do this.

{| {{prettytable}}
|- bgcolor="#dddddd"
! Token
! Example
! Notes
|-
| <tt><nowiki>[END_YEAR:<number>]</nowiki></tt>
| <tt><nowiki>[END_YEAR:1050]</nowiki></tt>
| Required
|}

== Population Cap After Civ Creation ==

This determines the maximum possible population of civilization member beings on the map. It should usually be kept the same value as the appropriate sized standard map. Turning the value up will result in larger civilizations. You can enter -1 to make population unlimited in which case populations will only be limited by factors like biome, space, number of sites, and per-civilization population caps.

Each race may have up to 100 civilizations each, and each civilization a maximum population of 10,000. This means that '''if you set this parameter to -1 ("No cap"), you can quickly be overrun''' by sites and population. Civilizations, known as ''entities'' in the {{L|Raw file|raw files}}, have 3 or 4 basic variables that will greatly affect their final placement on the world map, in respect to this kind of unchecked growth. See {{L|Entity_token#Population|Population (Entity Token)}} for more information on interpreting/editing the raws if you need more precise control of civilization placement.

Huge populations can cause the size of history data to explode, cause history generation to take forever, lower FPS, and generally slow down the game.

{| {{prettytable}}
|- bgcolor="#dddddd"
! Token
! Example
! Notes
|-
| <tt><nowiki>[TOTAL_CIV_POPULATION:<number>]</nowiki></tt>
| <tt><nowiki>[TOTAL_CIV_POPULATION:15000]</nowiki></tt>
| Required
|}

== Site Cap After Civ Creation ==

This controls the maximum number of towns and similar sites on the entire map. Raising the number will allow for more towns, etc though the number of sites will ultimately still be limited by things like space, terrain, and population cap.

Note that '''this parameter controls only "civilization" sites''' like towns. Other sites such as lairs will be added on to this maximum. After civilizations reach this cap, they will not spread out anymore to place new cities.

By default, the raws limit each civilization site to a population of 120 regardless of the race of the civilization. Therefore, without editing the raws, the total population on the map can't go above site cap x 120.

{| {{prettytable}}
|- bgcolor="#dddddd"
! Token
! Example
! Notes
|-
| <tt><nowiki>[SITE_CAP:<number>]</nowiki></tt>
| <tt><nowiki>[SITE_CAP:1040]</nowiki></tt>
| Required
|}

== Beast Control ==

These parameters don't usually matter too much, but may matter for small numbers of beasts.

=== Percentage of Beasts Dead for Stoppage ===

The world starts out with a certain number of megabeasts in existence. If this percentage of megabeasts dies during history generation, then history generation will stop early. For example if the value is 80, if history starts with 200 megabeasts and 160 of them are killed by historical events or otherwise die before End Year is reached, history generation will stop early.

=== Year to Begin Checking Megabeast Percentage ===

The percentage of dead megabeasts for stoppage will not be checked until this year is reached in history generation. The usefulness of this parameter is unknown.{{Verify}}

{| {{prettytable}}
|- bgcolor="#dddddd"
! Token
! Example
! Notes
|-
| <tt><nowiki>[BEAST_END_YEAR:<year>:<percentage or -1>]</nowiki></tt>
| <tt><nowiki>[BEAST_END_YEAR:200:80]</nowiki></tt>
| Use -1 as percentage to disable. Year must still be at least 2.
|}

== Cull Unimportant Historical Figures ==

Whether or not the game ignores unimportant figures in history generation. The culling is many CPU-intensive steps in history generation but it saves memory and will speed up loading/saving games a bit. This does mean that the "unimportant" figures will not appear in Legends mode or in things like dwarf engravings, but they might not appear in engravings anyway.

Unimportant figures are people or creatures who suffer early deaths, never having offspring or killing anything named during history generation. For example, residents of goblin towers may get murdered by demons at a young age. After culling unimportant figures, Legends mode would say something like the demon has killed "a creature at Eviltower in the year 102."

{| {{prettytable}}
|- bgcolor="#dddddd"
! Token
! Example
! Notes
|-
| <tt><nowiki>[CULL_HISTORICAL_FIGURES:<0 or 1>]</nowiki></tt>
| <tt><nowiki>[CULL_HISTORICAL_FIGURES:0]</nowiki></tt>
| 0 = No, 1 = Yes
|}

== Reveal All Historical Events ==

Setting this to Yes will allow access to all information about the history of the world in Legends mode. If set to No, then you will have to discover historical information in adventure mode or by instructing dwarves to make engravings.{{Verify}}

{| {{prettytable}}
|- bgcolor="#dddddd"
! Token
! Example
! Notes
|-
| <tt><nowiki>[REVEAL_ALL_HISTORY:<0 or 1>]</nowiki></tt>
| <tt><nowiki>[REVEAL_ALL_HISTORY::1]</nowiki></tt>
| 0 = No, 1 = Yes
|}

== Terrain Parameters ==

These determine how random values for terrain elevation, rainfall, temperature, drainage, volcanism, and savagery are generated. What biomes exist are then determined by how these factors overlap with each other.

=== Minimum and Maximums ===

These are the absolute minimum and maximum values that can ever be generated for a particular map square characteristic. Changing these can cause the occurrence of certain {{L|Biome|biomes}} to become impossible, so modify these with care. Because of this problem, you may want to use [[#Weighted Ranges|Weighted Ranges]] instead.

By ''subtly'' tweaking the min and max values, vastly different maps can be made.

=== X and Y Variance ===

These control how wildly things like elevation and rainfall can vary between adjacent map squares. For example, if these values are set to the maximum of 3,200 for elevation then you will end up with more very low areas right next to very high areas. The number for X determines the east-west variance and the number for Y determines the north-south variance. By setting only one of these to a high value you can, for example, create horizontal or vertical bands of areas which are more similar to each other.

Generally speaking, raising both of these values will create a more random "patchwork" of many small biomes while setting both x and y values to 0 will cause every square on the map to use a single random value for the given characteristic.

For "patchwork" worlds to avoid being rejected, [[#Maximum_Number_of_Subregions|Maximum Number of Subregions]] will probably need to be increased from the default.

=== Elevation ===

This controls the range of terrain elevations that can occur in the world.

Usually you just want to leave the min/max values alone. Raising the minimum elevation can, for example, make it impossible for oceans to exist. This does '''not''' directly control the number of available Z-levels at a particular site, though high maximum values may contribute to peaks which can raise the number of above ground Z-levels. In other words, a maximum elevation of 400 and minimum of 1 does not mean you get 400 Z-levels but it might increase the number of Z-levels somewhat in some regions compared to others.

Raising the variance will result in a more bumpy uneven landscape.

Some biomes/features that are impacted by elevation:
* A high minimum (above 99) means no oceans as they need elevations below 100.
* A low maximum (below 300) means no mountains as mountains need elevations above 300.
* River start locations need a minimum elevation of 300. Therefore, a world with a maximum elevation of 299 everywhere prevents river generation, but rivers can still occur if maximum elevation is set to 300.
*Mountain peaks can only form in squares with an elevation of 400.

=== Rainfall ===

Controls the amount of rainfall in each map square/area. Setting the minimum too high or the maximum too low can make the formation of certain biomes impossible. Rainfall causes it to {{L|Rain}} more in a given area, which can have various effects.

Also makes more rivers appear on the world map.

=== Temperature ===

These parameters control how hot or cold various areas will be. If you lower the minimum and maximum values, the world will be colder overall, for example. As with the others, changing these values too much could make it impossible for certain biomes to exist. See {{L|Climate}} for more info.

Temperature appears to always be a vertical gradient of some sort no matter how these parameters are set, but if the values are lower then the gradient could be from "cold" to "colder" rather than "cold" to "warm" for example.

So, the value from the temperature rolling process is ''not the absolute temperature value the region will get, but rather local variation.'' The "base" temperature for an area is derived from its latitude (and maybe elevation{{Verify}}), and then the random value determined by these parameters are applied to it to make it vary a bit. The local variation is fairly small compared to the base temperature, which appears to be hard coded.

=== Drainage ===

Changing drainage parameters will change the way water-affected biomes are formed. Low drainage will contribute to the formation of {{L|Lake|lakes}}, {{L|River|rivers}}, and {{L|Swamp|swamps}}. High drainage will cause water to sink into the ground rather than sit on the surface, which is important for forming hills.

Lower drainage values have been reported to contribute to the formation of thicker soil layers though it is currently unknown exactly how other factors (such as elevation or perhaps rain) impact soil formation.

=== Volcanism ===

Volcanism controls the occurrence of Igneous {{L|Layer|Layers}}, and the formation of volcanoes. For a volcano to form, a square must have a volcanism value of 100 so reducing the maximum from 100 will make volcanoes impossible. Rising the minimum will increase the rarity of non-igneous layers.

Setting minimum to high value is not a good way to produce multiple volcanoes as you are likely to get a "Volcanism not evenly distributed" rejection. Instead use the Minimum Number of Volcanoes parameter and possibly adjust the weighted ranges for volcanism as described below.

=== Savagery ===

These parameters control the level of {{L|Surroundings#Savage|savagery}} on the map. Raising the minimum savagery too high may make it impossible for certain races to exist, and similarly lowering the maximum too far can make it impossible for certain creatures to exist. The largest chance of having unusable maps comes from too high of a savagery value.

=== Configuration Tokens ===

{| {{prettytable}}
|- bgcolor="#dddddd"
! Token
! Example
! Notes
|-
| <tt><nowiki>[ELEVATION:<min>:<max>:<x variance>:<y variance>]</nowiki></tt>
| <tt><nowiki>[ELEVATION:1:400:401:401]</nowiki></tt>
| Range: 0 to 400<br/>Maximum of 400 required for mountain peaks.
|-
| <tt><nowiki>[RAINFALL:<min>:<max>:<x variance>:<y variance>]</nowiki></tt>
| <tt><nowiki>[RAINFALL:0:100:200:200]</nowiki></tt>
| Range: 0 to 100
|-
| <tt><nowiki>[TEMPERATURE:<min>:<max>:<x variance>:<y variance>]</nowiki></tt>
| <tt><nowiki>[TEMPERATURE:25:75:200:200]</nowiki></tt>
| Range: -1000 to 1000
|-
| <tt><nowiki>[DRAINAGE:<min>:<max>:<x variance>:<y variance>]</nowiki></tt>
| <tt><nowiki>[DRAINAGE:0:100:200:200]</nowiki></tt>
| Range: 0 to 100
|-
| <tt><nowiki>[VOLCANISM:<min>:<max>:<x variance>:<y variance>]</nowiki></tt>
| <tt><nowiki>[VOLCANISM:1:100:200:200]</nowiki></tt>
| Range: 0 to 100<br/>Maximum of 100 required for volcanoes.
|-
| <tt><nowiki>[SAVAGERY:<min>:<max>:<x variance>:<y variance>]</nowiki></tt>
| <tt><nowiki>[SAVAGERY:1:100:200:200]</nowiki></tt>
| Range: 0 to 100
|}

== Terrain Mesh Sizes and Weights ==

These parameters make it possible to influence the number of squares in a particular range without making conditions outside of that range impossible. For example, you can make it possible for more many more low elevation squares to exist without making it impossible for high elevations to form. Changing these parameters is often preferable to simply changing the min/max values.

[[File:World_map-large-32x32-elevation-mesh.png|thumb|300px|A large world generated with an Elevation Mesh Size of 32x32 and range weights set to 1:0:0:0:1 (i.e., only extreme high and low elevations). Notice that with this coarse mesh, the terrain seems to appear almost like a grid of "pyramids" that are smoothed together. With a finer mesh size, these pyramids will be smaller, more numerous, smoother, and less apparent.]]
=== Mesh Size ===

Mesh size determines how "finely grained" weighted ranges will be applied. Setting this to Ignore will cause the weighted range settings to be ignored for that terrain characteristic.

Mesh Size affects the smoothing brush in the world painter.

=== Weighted Ranges ===

If mesh size is set to something other than Ignore, these weights will be applied at the granularity of the selected mesh size for purposes of generating random values in each range. This allows random number generation to be non-linear for the given terrain characteristic.

For example, if the Elevation Weighted Range parameters were set to (starting with the 0-20 range) 60:10:10:10:10 (these values do not have to add up to any particular number) then about 60% of the map squares (on average) will have an elevation in the range of 0-20, and the other ranges will be represented by around 10% of the map squares each. The exact distribution is still left up to chance though ''on average'' it will be close to this specification.

The way the process appears to work is that the map is divided into a "wireframe mesh" where the lines are Mesh Size number of tiles apart. Each intersection of the "wires" is randomly assigned an elevation (or whatever) and then the tiles between these points are smoothed out. See the image on the right for an example.

Weighted ranges do not make rejection checks, although they can be responsible for many rejections if you neglect to adjust or disable some of the [[#Minimum Number of Mid/Low/High Characteristic Squares|Minimum Number of Mid/Low/High Characteristic Squares]] for example.

=== Configuration Tokens ===

{| {{prettytable}}
|- bgcolor="#dddddd"
! Token
! Example
! Notes
|-
| <tt><nowiki>[ELEVATION_FREQUENCY:<mesh>:<0-20 weight>:<20-40 weight>:<40-60 weight>:<60-80 weight>:<80-100 weight>]</nowiki></tt>
| <tt><nowiki>[ELEVATION_FREQUENCY:2:1:2:3:4:5]</nowiki></tt>
| rowspan="6" | Valid mesh values:

1 = Ignore

2 = 2x2

3 = 4x4

4 = 8x8

5 = 16x16

6 = 32x32

(limited by world size)
|-
| <tt><nowiki>[RAIN_FREQUENCY:<mesh>:<0-20 weight>:<20-40 weight>:<40-60 weight>:<60-80 weight>:<80-100 weight>]</nowiki></tt>
| <tt><nowiki>[RAIN_FREQUENCY:3:1:2:3:4:5]</nowiki></tt>
|-
| <tt><nowiki>[DRAINAGE_FREQUENCY:<mesh>:<0-20 weight>:<20-40 weight>:<40-60 weight>:<60-80 weight>:<80-100 weight>]</nowiki></tt>
| <tt><nowiki>[DRAINAGE_FREQUENCY:4:1:2:3:4:5]</nowiki></tt>
|-
| <tt><nowiki>[TEMPERATURE_FREQUENCY:<mesh>:<0-20 weight>:<20-40 weight>:<40-60 weight>:<60-80 weight>:<80-100 weight>]</nowiki></tt>
| <tt><nowiki>[TEMPERATURE_FREQUENCY:1:1:1:1:1:1]</nowiki></tt>
|-
| <tt><nowiki>[SAVAGERY_FREQUENCY:<mesh>:<0-20 weight>:<20-40 weight>:<40-60 weight>:<60-80 weight>:<80-100 weight>]</nowiki></tt>
| <tt><nowiki>[SAVAGERY_FREQUENCY:5:1:2:3:4:5]</nowiki></tt>
|-
| <tt><nowiki>[VOLCANISM_FREQUENCY:<mesh>:<0-20 weight>:<20-40 weight>:<40-60 weight>:<60-80 weight>:<80-100 weight>]</nowiki></tt>
| <tt><nowiki>[VOLCANISM_FREQUENCY:1:1:1:1:1:1]</nowiki></tt>
|}

== Minimum Mountain Peak Number ==

This will cause the world to be rejected if fewer than this many peaks (based on elevation) are present on the map. Elevations of 400 must be possible for mountain peaks to occur. If set to zero then worlds will not be rejected based on number of peaks.

You may need to adjust elevation parameters, such as the highest weighted range, in order to get the desired number of elevation 400 squares needed for larger numbers of peaks. Like volcanoes, mountain peaks can make embark zones more interesting but other than that they don't appear to "do" anything special. Reportedly they do increase the highest Z-level above ground in all embark zones in the same region even if the selected embark zone does not include the peak.

{| {{prettytable}}
|- bgcolor="#dddddd"
! Token
! Example
! Notes
|-
| <tt><nowiki>[PEAK_NUMBER_MIN:<number>]</nowiki></tt>
| <tt><nowiki>[PEAK_NUMBER_MIN:20]</nowiki></tt>
| Elevations of 400 must occur for peaks to form.
|}

== Minimum Partial Edge Oceans ==

This will cause a world to be rejected unless there are at least this many oceans touching an edge of the map. If set to zero then worlds will not be rejected based on this criterion. Setting both this parameter and Minimum Complete Edge Oceans to values that total more than 4 when added together may cause all worlds to be rejected as you can't have both a partial and complete edge ocean on a given edge.{{Verify}}

{| {{prettytable}}
|- bgcolor="#dddddd"
! Token
! Example
! Notes
|-
| <tt><nowiki>[PARTIAL_OCEAN_EDGE_MIN:<number>]</nowiki></tt>
| <tt><nowiki>[PARTIAL_OCEAN_EDGE_MIN:2]</nowiki></tt>
| Maximum of 4
|}

== Minimum Complete Edge Oceans ==

This will cause a world to be rejected unless there are at least this many oceans which completely cover an edge of the map. Since a square map only has 4 edges, the maximum value possible is 4. If set to zero then worlds will not be rejected based on this criterion but still might end up with complete edge oceans by chance.

Note that the ability for this many edge oceans to exist will be limited by elevation. Therefore to actually create large oceans you will probably need to change things like the Elevation Mesh Size and Weighted Ranges to increase the number and distribution of very low elevation squares on the map.

Given appropriate weight, range, and variance values for things like elevation, a setting of:
*1 results in a world that seems like a chunk of coastline. One edge of the map will be completely underwater and there will be ocean taking up much of the map on that side. Think the east or west coast of the United States, the north coast of Canada, or southern Europe. If your edge ocean happens to pick your world's frozen side most of it will be glacier.
*2 results in another coastline along with the first one. The map could end up looking something like Panama if the oceans pick opposite sides of the map.
*3 results in a peninsula, like Florida in the US. There will be oceans surrounding 3 sides of the map, and land touching only one side of the map.
*4 results in one or more island(s) depending on things like elevation variance and weights. Regardless of whether you get one island or multiple islands, the entire map will be surrounded by water.
Unfortunately there's no easy way to control which oceans end up on which edges, except perhaps setting X and Y variance to different values.

Edge oceans will take up part of the other edges too. For example a full edge ocean on the east side will have part of the north and south sides underwater, but that does ''not'' add to the ''partial'' edge oceans count.

{| {{prettytable}}
|- bgcolor="#dddddd"
! Token
! Example
! Notes
|-
| <tt><nowiki>[COMPLETE_OCEAN_EDGE_MIN:<number>]</nowiki></tt>
| <tt><nowiki>[COMPLETE_OCEAN_EDGE_MIN:0]</nowiki></tt>
| Maximum of 4
|}

== Minimum Volcano Number ==

Worlds with less than this number of volcanoes will be rejected. Note that this will not just create this many volcanoes at random; there must be at least this many squares with a Volcanism of 100. Therefore adjusting Weighted Range for 80-100 to some higher value is recommended if you want to facilitate a large number of volcanoes. In addition, Maximum Volcanism must be set to 100 or squares with volcanism of 100 will be impossible making volcanoes impossible.

{| {{prettytable}}
|- bgcolor="#dddddd"
! Token
! Example
! Notes
|-
| <tt><nowiki>[VOLCANO_MIN:<number>]</nowiki></tt>
| <tt><nowiki>[VOLCANO_MIN:15]</nowiki></tt>
| Volcanoes require a volcanism of 100 to occur.
|}

== Mineral Scarcity ==

Controls the frequency at which minerals occur. Setting this value lower will increase the amount of ore present on a map, the number of different types of ore, and the number/types of gems. The default value will result in a maximum of 2-4 metal ores per map (assuming you choose a good embark location) which may be limiting until the economy is fully implemented and desired metals can be traded for.

According to research by [http://www.bay12forums.com/smf/index.php?action=profile;u=36045 Shandra] on v0.31.25, this is the relationship between the value of this setting and the approximate number of gems and ore:

[[File:MineralSetting_v25_limit10k.png]]

This is for the same 8x8 embark region in a world which is otherwise the same except for the mineral scarcity parameter. See [http://www.bay12forums.com/smf/index.php?topic=79018.msg2063804#msg2063804 this forum thread] for detailed information on peoples' experiments and possible changes to newer versions.

{| {{prettytable}}
|- bgcolor="#dddddd"
! Token
! Example
! Notes
|-
| <tt><nowiki>[MINERAL_SCARCITY:<number>]</nowiki></tt>
| <tt><nowiki>[MINERAL_SCARCITY:2500]</nowiki></tt>
| Range: 100 to 100,000
|}

== Max Megabeast Caves ==

This is the maximum number of caves that will be inhabited by {{L|Megabeast|megabeasts}}. Even though the parameter uses the word "caves" it appears to impact the number of sites (lairs) of different types.{{Verify}} If there are more megabeasts than "caves", megabeasts will suffer from a housing shortage and you may end up with things like 10 dragons sharing a lair.

{| {{prettytable}}
|- bgcolor="#dddddd"
! Token
! Example
! Notes
|-
| <tt><nowiki>[MEGABEAST_CAP:<number>]</nowiki></tt>
| <tt><nowiki>[MEGABEAST_CAP:75]</nowiki></tt>
| Number of caves/labyrinths/lairs, not beasts.
|}

== Max Semi-Megabeast Caves ==

The maximum number of caves that will be inhabited by {{L|Creature#Semi-Megabeasts|semi-megabeasts}}. If there are more semi-megabeasts than caves, semi-megabeasts will be forced to cohabitate and you may end up with 10 minotaurs in one labyrinth (for example).

{| {{prettytable}}
|- bgcolor="#dddddd"
! Token
! Example
! Notes
|-
| <tt><nowiki>[SEMIMEGABEAST_CAP:<number>]</nowiki></tt>
| <tt><nowiki>[SEMIMEGABEAST_CAP:150]</nowiki></tt>
| Number of caves/labyrinths/lairs, not beasts.
|}

== Titan Parameters ==

=== Number ===

This controls the number of megabeasts and semi-megabeasts that exist at the beginning of history. Note that they can get killed or die later due to events during history generation. The number of forgotten beasts is unaffected by this parameter.

Note: One can generate more historical ages by pumping up the amount of semimegabeasts, who are usually more killable than the regular megabeasts.

{| {{prettytable}}
|- bgcolor="#dddddd"
! Token
! Example
! Notes
|-
| <tt><nowiki>[TITAN_NUMBER:<number>]</nowiki></tt>
| <tt><nowiki>[TITAN_NUMBER:33]</nowiki></tt>
| 0 is a valid number
|}

=== Attack Population Requirement ===

Megabeasts will begin to attack your fort once at least this many dwarves inhabit it, regardless of whether any other attack criteria have been met. This number defaults to 80 which isn't usually too difficult to deal with.

=== Exported Wealth Requirement ===

Megabeasts will begin to attack your fort once you have exported at least this many {{L|Currency|dwarfbucks}} worth of merchandise, regardless of whether or not any other criteria have been met. This parameter defaults to None (disabled).

=== Created Wealth Requirement ===

Megabeasts will begin to attack your fort once the fort's total wealth has reached this many {{L|Currency|dwarfbucks}} in value. This happens regardless of whether any of the other criteria, such as population, have been met. Therefore even with 1 dwarf a fort could be attacked if the fort were worth at least this value.

{| {{prettytable}}
|- bgcolor="#dddddd"
! Token
! Example
! Notes
|-
| <tt><nowiki>[TITAN_ATTACK_TRIGGER:<population>:<exp wealth>:<created wealth>]</nowiki></tt>
| <tt><nowiki>[TITAN_ATTACK_TRIGGER:80:0:100000]</nowiki></tt>
| 0 = None (disabled). Only one requirement must be met for an attack.
|}

== Number of Demon Types ==

{{L|Demon|Demons}} are similar to titans and forgotten beasts in that they are procedurally generated, but unlike titans they are not unique. This many different types of demons will exist in the world but there will be many members of each type. Setting this to zero means no demons will exist, limiting the amount of fun you can have.

{| {{prettytable}}
|- bgcolor="#dddddd"
! Token
! Example
! Notes
|-
| <tt><nowiki>[DEMON_NUMBER:<number>]</nowiki></tt>
| <tt><nowiki>[DEMON_NUMBER:52]</nowiki></tt>
| 0 to 1000
|}

== Number of Night Creature Types ==

The number of different {{L|Night creature|night creatures}} that will exist in the world. Setting this to zero means that the world will have no night creatures.

A setting of zero also means that there will be no {{L|Bogeyman|Bogeymen}} in adventure mode.

{| {{prettytable}}
|- bgcolor="#dddddd"
! Token
! Example
! Notes
|-
| <tt><nowiki>[NIGHT_CREATURE_NUMBER:<number>]</nowiki></tt>
| <tt><nowiki>[NIGHT_CREATURE_NUMBER:52]</nowiki></tt>
| 0 to 1000
|}

== Desired Good/Evil Square Counts ==

These values change the amount of {{L|Surroundings#Good|good or evil}} tiles on the map, depending on the size of the region they are being considered for.

Though the exact size of small, medium, and large are unknown, the counts used here will always be restricted to regions of the given size no matter how large the number. Also, the count is more of a goal than a minimum or maximum. As a result you can end up with many more or many fewer than the requested number of squares in some situations.

In particular, if you have something like case where only 3 large regions exists in a world, and you request "1 evil square" in large regions, you will end up with one of the large regions being ''entirely evil''. So any non-zero value in one of these settings essentially means "force at least one region of this size to be all good/evil."

Note that the "evilness" of evil biomes is also impacted by savagery.

Certain civilizations can not exist in good and/or evil squares, so too many of one or the other may limit the size of certain types of civilizations. Dwarves, for example, need non-aligned biomes.

{| {{prettytable}}
|- bgcolor="#dddddd"
! Token
! Example
! Notes
|-
| <tt><nowiki>[GOOD_SQ_COUNTS:<small region>:<med region>:<lg region>]</nowiki></tt>
| <tt><nowiki>[GOOD_SQ_COUNTS:100:1000:2000]</nowiki></tt>
| rowspan="2" | Set count to zero to disable for that region size.
|-
| <tt><nowiki>[EVIL_SQ_COUNTS:<small region>:<med region>:<lg region>]</nowiki></tt>
| <tt><nowiki>[EVIL_SQ_COUNTS:100:1000:2000]</nowiki></tt>
|}

== Minimum Biome Square Counts ==

These numbers control whether or not a world will be rejected based on a lack of different {{L|biome|biomes}}. Raising these numbers will '''not''' automatically generate the given number of squares of the given biome! For a biome to exist, certain conditions like elevation and rainfall must exist.

These parameters simply filter out worlds that (for example) randomly fail to have enough high elevation squares to support a given number of mountains, etc. Some settings may cause worlds to always be rejected. For example, if for some reason the maximum elevation parameter is set to a value below what will support mountain biomes, it will be impossible to satisfy a non-zero requirement for mountain squares. The same principle goes for other conditions and biomes such as low elevations and oceans, etc.

Certain civilizations require different biomes to exist (such as dwarves and mountains), so eliminating certain biomes will make it impossible for certain civilizations to form.

These parameters often result in infinite world rejection problems. See {{L|World rejection}} for information on solving problems related to worlds always being rejected due to one or more of these parameters.

0 means no minimum for rejection. Setting to 0 does not guarantee 0 squares of that biome.

=== Biome Type Requirement Table ===

Terrain requirements for various biomes are described below.{{Verify}} Note that some of the exact ranges are unknown.

{| {{prettytable}}
|- bgcolor="#dddddd"
! rowspan="2" | Biome
! colspan="4" | Terrain Requirement
|-
! Elevation
! Rainfall
! Temperature
! Drainage
|-
| Swamp/Marsh
| 100-299
| 33-100
| Non-Freezing
| 0-32
|-
| Desert/Badland
| 100-299
| 0-10(?)
| non-freezing
| N/A
|-
| Forest
| 100-299
| 66-100
| non-freezing
| 66-100
|-
| Mountains
| 300-400
| N/A
| N/A
| N/A
|-
| Ocean
| 0-99
| N/A
| N/A
| N/A
|-
| Glacier
| 100-299
| N/A
| Freezing
| 80(?)-100
|-
| Tundra
| 100-299
| N/A
| Freezing
| 0-66
|-
| Grassland
| 100-299
| 0-66
| Non-Freezing
| 0-66
|-
| Hills
| 100-299
| 0-66
| Non-Freezing
| 66-100
|}

=== Minimum Initial Square Count ===

This is the minimum number of squares of the given biome that must exist before things like erosion take place.

One thing to keep in mind is the maximum number of squares on a map of a given size. If the total number of squares on a map is lower than the sum of all square count parameters then you will get infinite world rejection.

To determine the number of squares on a map, just multiply the dimensions. In practice these parameters will need to sum to lower than the maximum because some space is needed for "slack".

{| {{prettytable}}
|- bgcolor="#dddddd"
! Map Size
! Number of Squares
|-
| 17x17
| 289
|-
| 33x33
| 1089
|-
| 65x65
| 4225
|-
| 129x129
| 16614
|-
| 257x257
| 66049
|}

=== Minimum Initial Region Count ===

This is the minimum number of regions of contiguous biome squares that must exist before other processes such as erosion take place.

=== Minimum Final Region Count ===

This many regions of the given biome must exist after erosion and similar phases of generation have been completed.

{| {{prettytable}}
|- bgcolor="#dddddd"
! Token
! Example
|-
| <tt><nowiki>[REGION_COUNTS:SWAMP:<init sq>:<init rg>:<final rg>]</nowiki></tt>
| <tt><nowiki>[REGION_COUNTS:SWAMP:1032:7:6]</nowiki></tt>
|-
| <tt><nowiki>[REGION_COUNTS:DESERT:<init sq>:<init rg>:<final rg>]</nowiki></tt>
| <tt><nowiki>[REGION_COUNTS:DESERT:1032:7:6]</nowiki></tt>
|-
| <tt><nowiki>[REGION_COUNTS:FOREST:<init sq>:<init rg>:<final rg>]</nowiki></tt>
| <tt><nowiki>[REGION_COUNTS:FOREST:4128:13:12]</nowiki></tt>
|-
| <tt><nowiki>[REGION_COUNTS:MOUNTAINS:<init sq>:<init rg>:<final rg>]</nowiki></tt>
| <tt><nowiki>[REGION_COUNTS:MOUNTAINS:8256:9:9]</nowiki></tt>
|-
| <tt><nowiki>[REGION_COUNTS:OCEAN:<init sq>:<init rg>:<final rg>]</nowiki></tt>
| <tt><nowiki>[REGION_COUNTS:OCEAN:8256:7:6]</nowiki></tt>
|-
| <tt><nowiki>[REGION_COUNTS:GLACIER:<init sq>:<init rg>:<final rg>]</nowiki></tt>
| <tt><nowiki>[REGION_COUNTS:GLACIER:0:0:0]</nowiki></tt>
|-
| <tt><nowiki>[REGION_COUNTS:TUNDRA:<init sq>:<init rg>:<final rg>]</nowiki></tt>
| <tt><nowiki>[REGION_COUNTS:TUNDRA:0:0:0]</nowiki></tt>
|-
| <tt><nowiki>[REGION_COUNTS:GRASSLAND:<init sq>:<init rg>:<final rg>]</nowiki></tt>
| <tt><nowiki>[REGION_COUNTS:GRASSLAND:8256:13:12]</nowiki></tt>
|-
| <tt><nowiki>[REGION_COUNTS:HILLS:<init sq>:<init rg>:<final rg>]</nowiki></tt>
| <tt><nowiki>[REGION_COUNTS:HILLS:8256:13:12]</nowiki></tt>
|}

== Erosion Cycle Count ==

Tells the world-generator how long the world has to erode its tall peaks down to mountainsides during the 'running rivers...' stage of world creation. The higher this number, the less jagged the world will be, and the more wide the major rivers will be. If you use the maximum number, your mountains will dissolve before your eyes into plains which can lead to rejections if there aren't enough mountains to use for river start points and dwarven civilization origin points.

{| {{prettytable}}
|- bgcolor="#dddddd"
! Token
! Example
! Notes
|-
| <tt><nowiki>[EROSION_CYCLE_COUNT:<number>]</nowiki></tt>
| <tt><nowiki>[EROSION_CYCLE_COUNT:250]</nowiki></tt>
| Range: 0 to 1000
|}

== Minimum/Desired River Start Locations ==

This is the minimum number of riverheads that must exist before and after erosion takes place. Worlds will be rejected if they fail to meet these numbers. As with minimum biome counts, raising this number doesn't automatically create this many riverheads. Other conditions like terrain and rainfall must exist for rivers to form.

Extremely high pre-erosion values speed erosion greatly, while low post erosion values are useful for limiting rejects due to lack of river origin points. One can try the 800 value to get more lakes.

{| {{prettytable}}
|- bgcolor="#dddddd"
! Token
! Example
! Notes
|-
| <tt><nowiki>[RIVER_MINS:<min pre-erosion>:<des post-erosion>]</nowiki></tt>
| <tt><nowiki>[RIVER_MINS:200:400]</nowiki></tt>
| Range: 0 to 800
|}

== Periodically Erode Extreme Cliffs ==

If enabled, makes every impassable rock wall into a series of ramps. Some prefer to pump up erosion to about 250, and turn the "Desired pre-erosion river count" to 0 for good erosion and no extra canyons.

Normally this is set to Yes (1).

{| {{prettytable}}
|- bgcolor="#dddddd"
! Token
! Example
! Notes
|-
| <tt><nowiki>[PERIODICALLY_ERODE_EXTREMES:<1 or 0>]</nowiki></tt>
| <tt><nowiki>[PERIODICALLY_ERODE_EXTREMES:1]</nowiki></tt>
| 1/0 = Yes/No
|}

== Do Orthographic Precipitation and Rain Shadows ==

Toggle that allows terrain height to affect rainfall. For example, moist air coming from the ocean blows over the land. As the terrain gets higher, it forces the moist air up, causing it to rain on the seaward side of a mountain. Eventually, all the rain has fallen if the mountain is tall enough. So, when the breeze goes over the top, there's no moisture left to fall on the other side, creating a rain-shadow. This should create a tendency for more extreme rainfall in regions, creating more forests, deserts, marshlands, and grasslands. Turning it off should result in more controllable, less complex rainfall conditions based on rainfall parameters as it adds a random element which can distort or otherwise mess up the climates on a pregenerated map.

This should be disabled if you're importing a map or using a preset map file that has weather.

{| {{prettytable}}
|- bgcolor="#dddddd"
! Token
! Example
! Notes
|-
| <tt><nowiki>[OROGRAPHIC_PRECIPITATION:<1 or 0>]</nowiki></tt>
| <tt><nowiki>[OROGRAPHIC_PRECIPITATION:1]</nowiki></tt>
| 1/0 = Yes/No
|}

== Maximum Number of Subregions ==

This is the number of separate biomes (the flashing regions you see on embark when you hit F1, F2, etc when there's more than one biome on the embark location) that are allowed to exist on the entire map.

Setting this to very low values will result in numerous rejections depending on [[#X and Y Variance|variance parameters]]. If variance values are set to high numbers, many small biomes will be created causing rejection if this parameter value is not increased beyond the default.

Increasing the value of this tag is oten a must when generating "patchwork" worlds with lots of biome variance, but simply increasing it without increasing variance parameters will not guarantee more biomes.

{| {{prettytable}}
|- bgcolor="#dddddd"
! Token
! Example
! Notes
|-
| <tt><nowiki>[SUBREGION_MAX:<number>]</nowiki></tt>
| <tt><nowiki>[SUBREGION_MAX:2750]</nowiki></tt>
| Range: 1 to 5000
|}

== Cavern Parameters ==
[[File:Open00Density100.jpg|thumb|200px|Cavern slice with Openness of 0 and Density of 100]]
[[File:Open100Density00.jpg|thumb|200px|Cavern slice with Openness of 100 and Density of 0]]
[[File:Open100Density100.jpg|thumb|left|200px|Cavern slice with Openness of 100 and Density of 100]]
[[File:Open50Density50.jpg|thumb|left|200px|Cavern slice with Openness of 50 and Density of 50]]

{{L|Caverns}} are the hollow areas underground which dwarves tend to encounter when they're digging around.

=== Cavern Layer Number ===

This parameter determines how many cavern systems will be generated, not including the Magma layer or the Bottom layer. Defaults to three. Setting it to lower values could help FPS.

'''Warning:''' If this is 0 then you will not have caverns on your map. Note that disabling caverns will make it impossible to grow any underground plants because none will exist for your civilization to cultivate. (Underground plants will not be available on embark.)

{| {{prettytable}}
|- bgcolor="#dddddd"
! Token
! Example
! Notes
|-
| <tt><nowiki>[CAVERN_LAYER_COUNT:<number>]</nowiki></tt>
| <tt><nowiki>[CAVERN_LAYER_COUNT:3]</nowiki></tt>
| Range: 0 to 3
|}

=== Cavern Layout Parameters ===

Open caverns and dense passageways are not mutually exclusive. When both are raised, bizarre results can occur, such as layers showing a combination of open caverns, a cluster of network passages, and natural walls sprinkling the inside of an otherwise open cavern. [http://www.bay12forums.com/smf/index.php?topic=76355.msg1936859#msg1936859 Reference]

If you want the largest open spaces possible, then decrease the density and increase the openness. If you want a labyrinth of passageways, lower the openness and raise the passage density.

Another interesting note about the cavern layers is that the seed and number of demon types effect the layout of the caverns.

==== Layer Openness Min/Max ====

Dictates the size of cavern passages. When Passage Density (see below) is set to minimum (0), caverns will be open expanses. Raising the maximum will increase the size of the caverns.

{| {{prettytable}}
|- bgcolor="#dddddd"
! Token
! Example
! Notes
|-
| <tt><nowiki>[CAVERN_LAYER_OPENNESS_MIN:<number>]</nowiki></tt>
| <tt><nowiki>[CAVERN_LAYER_OPENNESS_MIN:0]</nowiki></tt>
| rowspan="2" | Range: 0 to 100
|-
| <tt><nowiki>[CAVERN_LAYER_OPENNESS_MAX:<number>]</nowiki></tt>
| <tt><nowiki>[CAVERN_LAYER_OPENNESS_MAX:100]</nowiki></tt>
|}

==== Layer Passage Density Min/Max ====

This determines how many passages form the cavern. If openness (see above) is set to minimum and density increased then you will get a maze like network of small criss-crossing passages. Raising the values further increases the number of the maze-like passages.

Caverns will be large, open spaces at 0, and comprised of many small vertical shafts of rock at 100. Setting both values to be the same results in a uniform look for the caverns.{{Verify}}

{| {{prettytable}}
|- bgcolor="#dddddd"
! Token
! Example
! Notes
|-
| <tt><nowiki>[CAVERN_LAYER_PASSAGE_DENSITY_MIN:<number>]</nowiki></tt>
| <tt><nowiki>[CAVERN_LAYER_PASSAGE_DENSITY_MIN:0]</nowiki></tt>
| rowspan="2" | Range: 0 to 100
|-
| <tt><nowiki>[CAVERN_LAYER_PASSAGE_DENSITY_MAX:<number>]</nowiki></tt>
| <tt><nowiki>[CAVERN_LAYER_PASSAGE_DENSITY_MAX:100]</nowiki></tt>
|}

See [http://www.bay12forums.com/smf/index.php?topic=76355.0 this forum thread] for more information on openness and density including many more images.

==== Layer Water min\max ====

Determines how many caverns will have water at the bottom. Note that, even at 100, there will be some amount of ground in caverns, but each cavern 'bubble' will contain some amount of water.

At 0, there will be no water in your caverns. This may impact future underground plant growth, although maps will still start with underground flora.{{Verify}}

{| {{prettytable}}
|- bgcolor="#dddddd"
! Token
! Example
! Notes
|-
| <tt><nowiki>[CAVERN_LAYER_WATER_MIN:<number>]</nowiki></tt>
| <tt><nowiki>[CAVERN_LAYER_WATER_MIN:0]</nowiki></tt>
| rowspan="2" | Range: 0 to 100
|-
| <tt><nowiki>[CAVERN_LAYER_WATER_MAX:<number>]</nowiki></tt>
| <tt><nowiki>[CAVERN_LAYER_WATER_MAX:100]</nowiki></tt>
|}

=== Magma Layer ===

This parameter controls whether the {{L|magma sea}} exists.

Setting 1/Yes causes the magma layer to exist, value 0/No prevents it. Appears not have impact on volcanoes, nor vulcanism, so even if 0/No there will still be emark locations with magma. If a {{L|volcano}} exists, it appears to always tap the magma sea, but the magma sea will not be revealed by revealing the volcano.

{| {{prettytable}}
|- bgcolor="#dddddd"
! Token
! Example
|-
| <tt><nowiki>[HAVE_BOTTOM_LAYER_1:<1 or 0>]</nowiki></tt>
| <tt><nowiki>[HAVE_BOTTOM_LAYER_1:1]</nowiki></tt>
|}

=== Bottom Layer ===

Determines if the space below the magma sea exists. If Yes the "HFS" layer is always present. Normally you want to leave this set to Yes for maximum fun.

If enabled, this will force the magma layer above it. (Unknown whether this has any impact on occurrence of HFS "temple".){{Verify}}

{| {{prettytable}}
|- bgcolor="#dddddd"
! Token
! Example
|-
| <tt><nowiki>[HAVE_BOTTOM_LAYER_2:<1 or 0>]</nowiki></tt>
| <tt><nowiki>[HAVE_BOTTOM_LAYER_2:1]</nowiki></tt>
|}

== Z Levels (Depth) Settings ==

These parameters control the "thickness" of various "layers" on the map. Note that a "layer" in this case does not refer to one Z-level, but refers to a number of related Z-levels such as "levels above ground".

The following table assumes that you have 3 cavern layers. The Levels Above Layer settings control how many Z-Levels are above each layer. A layer may itself consist of multiple Z-Levels (and almost always does).

{|style="margin:1em 1em 1em 0;background:#F9F9F9;border:1px #AAA solid;border-collapse:collapse;" class="wikitable"
|-style="background:#F2F2F2;text-align:center;"
!style="border:1px #AAA solid;padding:0.2em;" width="120"|Setting Name
!style="border:1px #AAA solid;padding:0.2em;" width="200"|Token
!style="border:1px #AAA solid;padding:0.2em;"| Description
|-
|style="border:1px #AAA solid;padding:0.2em;"| Above Ground
|style="border:1px #AAA solid;padding:0.2em;"| <nowiki>[LEVELS_ABOVE_GROUND:<number>]</nowiki>
|style="border:1px #AAA solid;padding:0.2em;"| The number of Z-Levels of air above the highest surface level.<br />Has no impact on how many Z-levels deep the surface layer is.
|-
|style="border:1px #AAA solid;padding:0.2em;"| Above layer 1
|style="border:1px #AAA solid;padding:0.2em;"| <nowiki>[LEVELS_ABOVE_LAYER_1:<number>]</nowiki>
|style="border:1px #AAA solid;padding:0.2em;"| Z-Levels of stone above the first cavern layer. Making this higher will guarantee ''at least'' this many levels to build your fortress, but will have no impact on how many z-levels thick the surface layer is. Also, the top of a cavern may be higher than the rest of a cavern, so in practice there will be more "solid" levels than this above the cavern.
|-
|style="border:1px #AAA solid;padding:0.2em;"| Above Layer 2
|style="border:1px #AAA solid;padding:0.2em;"| <nowiki>[LEVELS_ABOVE_LAYER_2:<number>]</nowiki>
|style="border:1px #AAA solid;padding:0.2em;"| Z-levels of earth between very top of second cavern and very bottom of first cavern.
|-
|style="border:1px #AAA solid;padding:0.2em;"| Above Layer 3
|style="border:1px #AAA solid;padding:0.2em;"| <nowiki>[LEVELS_ABOVE_LAYER_3:<number>]</nowiki>
|style="border:1px #AAA solid;padding:0.2em;"| Z-levels of earth between very top of third cavern and very bottom of second cavern.
|-
|style="border:1px #AAA solid;padding:0.2em;"| Above Layer 4
|style="border:1px #AAA solid;padding:0.2em;"| <nowiki>[LEVELS_ABOVE_LAYER_4:<number>]</nowiki>
|style="border:1px #AAA solid;padding:0.2em;"| Z-Levels of earth between very highest magma and very bottom of third cavern.<br />Spoiler Hidden (select invisible text to read): <span style='color:#eee;'>Making this high will give a large area for HFS veins, so that it never touches caverns, giving more to mine '''if''' it was impacting the cavern previously.</span>
|-
|style="border:1px #AAA solid;padding:0.2em;"| Above Layer 5
|style="border:1px #AAA solid;padding:0.2em;"| <nowiki>[LEVELS_ABOVE_LAYER_5:<number>]</nowiki>
|style="border:1px #AAA solid;padding:0.2em;"| Uncertain. May control the number of levels of "Semi Molten Rock" between HFS and Magma, may control number of levels of magma, may impact both.<br />In experimentation, the overall depth of all magma sea and semi-molten rock levels appears to increase, but not consistent enough to say for certain.<br />Only valid if Magma Layer present.<br />Spoiler Hidden:<span style='color:#eee;'>Often the HFS vein will only extend as high as the highest magma, making this the only guaranteed way to increase amount of HFS to mine, but unfortunately also creating enormous useless semi-molten z-levels</span>
|-
|style="border:1px #AAA solid;padding:0.2em;"| At Bottom
|style="border:1px #AAA solid;padding:0.2em;"| <nowiki>[LEVELS_AT_BOTTOM:<number>]</nowiki>
|style="border:1px #AAA solid;padding:0.2em;"| Appears to be number of levels of HFS chamber.<br />Only valid if Bottom Layer present.<br />Often has no impact.<br />Values larger than default results in strange things.
|}

Some implications:
* The number of surface layers (e.g. soil), at this time, can not be controlled. For example, on a map with 1 layer of Peat, then a layer of Silt, then a layer of Obsidian, there is no control to let you increase either one to be, say, 20 z-levels. (though you may get lucky with the Obsidian).
* There can be multiple stone layers between the cavern and the surface. So increasing Levels Above Layer 1 may give you more Conglomerate, or more Granite, and you have no control over which stone layer spans those Z-Levels.
* The layers shown on embark span across the cavern layers in an unknown and inconsistent way. Sometimes those 10 different layers of stone are evenly distributed over your 400 z-level deep map, sometimes the first 9 get 1 z-level each and the last gets the other 391 levels. No way to control found yet.
* The HFS temple, if present, will always extend into the rock layers, and appears to always make contact with the bottom cave. Large values for levels above layer 5 and layer 4 can result in enormous temples, but the number of levels at the top (the part with undead) appears to be unaffected.
* Unconfirmed whether number of levels between caverns has any impact on cavern height. There will be connecting ramps and/or shafts between cavern layers no matter how many levels are between them.
* '''Very Important''': These values appear to apply across a whole 16x16 Region, not just embark areas. That means that if a 16x16 region is completely flat, but has one tall mountain in one far corner, even if you set Levels Above Ground low (e.g. 2 z-levels) you still have all the empty air of the highest mountain in every embark tile (e.g. 200 z-levels). Also can happen to the semi-molten layer, and can lead to unexpected behavior.
* Very large values can cause strange things to happen. Even more true for small values.

== Cave Parameters ==

Caves are sort of like caverns except that they have a passage to the surface and are generally much smaller. Caves can connect to caverns if they are sufficiently deep.

=== Minimum/Maximum Natural Cave Size ===

These parameters appear to control the length and depth of caves.

{| {{prettytable}}
|- bgcolor="#dddddd"
! Token
! Example
! Notes
|-
| <tt><nowiki>[CAVE_MIN_SIZE:<number>]</nowiki></tt>
| <tt><nowiki>[CAVE_MIN_SIZE:5]</nowiki></tt>
| rowspan="2" | Range: 1 to 500
|-
| <tt><nowiki>[CAVE_MAX_SIZE:<number>]</nowiki></tt>
| <tt><nowiki>[CAVE_MAX_SIZE:25]</nowiki></tt>
|}

=== Number of (Non-)Mountain Caves ===

These are the numbers of mountain and non-mountain caves that will be placed. These parameters will cause this number of caves to be placed, but rejections may occur if a world has an insufficient number of mountain or non-mountain squares to place the caves in.

{| {{prettytable}}
|- bgcolor="#dddddd"
! Token
! Example
! Notes
|-
| <tt><nowiki>[MOUNTAIN_CAVE_MIN:<number>]</nowiki></tt>
| <tt><nowiki>[MOUNTAIN_CAVE_MIN:100]</nowiki></tt>
| rowspan="2" | Range: 1 to 800
|-
| <tt><nowiki>[NON_MOUNTAIN_CAVE_MIN:<number>]</nowiki></tt>
| <tt><nowiki>[NON_MOUNTAIN_CAVE_MIN:200]</nowiki></tt>
|}

=== Make Caves Visible ===

If set to no (default) then the location of caves will not be marked on the map. If set to yes, caves will appear on the map as {{Raw Tile|•|#808080|#00DD00}} symbols so that they may be sought out or avoided as desired.

{| {{prettytable}}
|- bgcolor="#dddddd"
! Token
! Example
! Notes
|-
| <tt><nowiki>[ALL_CAVES_VISIBLE:<1 or 0>]</nowiki></tt>
| <tt><nowiki>[ALL_CAVES_VISIBLE:0]</nowiki></tt>
| 1/0 = Yes/No
|}

== Allow Init Options to Show Tunnels ==

This parameter doesn't do anything in DF2010.{{Verify}} In older versions, tunnels could be built between dwarven settlements and these could appear on the map similarly to roads.

{| {{prettytable}}
|- bgcolor="#dddddd"
! Token
! Example
! Notes
|-
| <tt><nowiki>[SHOW_EMBARK_TUNNEL:<0-2>]</nowiki></tt>
| <tt><nowiki>[SHOW_EMBARK_TUNNEL:2]</nowiki></tt>
| 0 = No<br/>1 = Only in Finder<br/>2 = Always
|}

== Number of Civilizations ==

This number of civilizations will be placed on the map before history generation begins. These civilizations may later die out due to historical events.

Note that a high value here can cause lots of map rejections, particularly on smaller maps as there simply isn't enough room or regions to put them all in.

{| {{prettytable}}
|- bgcolor="#dddddd"
! Token
! Example
! Notes
|-
| <tt><nowiki>[TOTAL_CIV_NUMBER:<number>]</nowiki></tt>
| <tt><nowiki>[TOTAL_CIV_NUMBER:40]</nowiki></tt>
| Range: 0 to 300
|}

== Playable Civilization Required ==

If this is set to yes (default) then worlds will be rejected if no civilization with {{L|Entity token|CIV_CONTROLLABLE}} exists or if all such civilizations die out. In an unmodded game, only the dwarves have this token.

If set to no, the result may be a world that cannot be played in Fortress Mode.

{| {{prettytable}}
|- bgcolor="#dddddd"
! Token
! Example
! Notes
|-
| <tt><nowiki>[PLAYABLE_CIVILIZATION_REQUIRED:<1 or 0>]</nowiki></tt>
| <tt><nowiki>[PLAYABLE_CIVILIZATION_REQUIRED:1]</nowiki></tt>
| 1/0 = Yes/No
|}

== Minimum Number of Mid/Low/High Characteristic Squares ==

Sets the minimum possible number of squares of certain ranges of each of the region qualities, such as elevation, rain, drainage, volcanism, savagery, and temperature. These need to be changed to reflect your regional meshes and weights. These are responsible for a HUGE number of map rejections. These values can all be set to 0 for much fewer map rejections, particularly in the case of more wacky, non-standard maps.

These values will cause worlds to be rejected unless at least the given number of squares of the given type are randomly generated. Setting these values too high could result in worlds always being rejected if other parameters such as the maximum/minimums for elevation, etc, don't allow enough of those squares to get generated.

{| {{prettytable}}
|- bgcolor="#dddddd"
! Token
! Example
! Notes
|-
| <tt><nowiki>[ELEVATION_RANGES:<low sq>:<mid sq>:<high sq>]</nowiki></tt>
| <tt><nowiki>[ELEVATION_RANGES:8256:16512:8256]</nowiki></tt>
| rowspan="5" | Minimum number of squares that must have low, medium, and high amounts of the given attribute.<br/>
0 = No minimum
|-
| <tt><nowiki>[RAIN_RANGES:<low sq>:<mid sq>:<high sq>]</nowiki></tt>
| <tt><nowiki>[RAIN_RANGES:8256:16512:8256]</nowiki></tt>
|-
| <tt><nowiki>[DRAINAGE_RANGES:<low sq>:<mid sq>:<high sq>]</nowiki></tt>
| <tt><nowiki>[DRAINAGE_RANGES:8256:16512:8256]</nowiki></tt>
|-
| <tt><nowiki>[SAVAGERY_RANGES:<low sq>:<mid sq>:<high sq>]</nowiki></tt>
| <tt><nowiki>[SAVAGERY_RANGES:8256:16512:8256]</nowiki></tt>
|-
| <tt><nowiki>[VOLCANISM_RANGES:<low sq>:<mid sq>:<high sq>]</nowiki></tt>
| <tt><nowiki>[VOLCANISM_RANGES:8256:16512:8256]</nowiki></tt>
|}

="The World Generator is having trouble placing..."=

:''Main article {{L|World rejection}}''

If you are having the common problem of your generated worlds always being rejected by the world generator, see {{L|World_rejection#Solving_World_Rejection_Problems|Solving World Rejection Problems}} as it contains many detailed suggestions on how to troubleshoot and solve these issues.

= Default Worldgen Parameters =

There is no single default for each parameter. Several advanced world generation profiles come with the game by default. See {{L|world_gen.txt|Default world_gen.txt}} to take a look at this file.

= Parameter Set Examples =

If you're trying to do something specific then the {{L|Worldgen examples|}} might be helpful. These are complete parameter sets that can be copied directly into your ''world_gen.txt'' file and customized as desired.

For many many more examples see:
* [http://www.bay12forums.com/smf/index.php?topic=64032.0 DF2010 WorldGen "Cookbook" Thread]

{{World}}
[[Category:World]]

40d:Ethic

2011-04-04T02:20:30Z

Bohandas: tweaked color scheme to improve heading readability

{{quality|Exceptional|21:18, 30 March 2011 (UTC)}}{{av}}
== List of acceptable ethics tags==

Ethics tags are used in the entity_default file to determine how races feel about various issues. Example usage: [ETHIC:ASSAULT:PUNISH_SERIOUS]

Entities will start {{L|war|wars}} with each other over ethical differences during {{L|World generation|world gen}}. Ongoing wars may influence fortress mode, causing early {{L|siege|sieges}}.

== Ethics types ==
{| {{prettytable}}
|- bgcolor="#dddddd"
!Token
!Extra Information
|-
|ASSAULT
|
|-
|EAT_SAPIENT_KILL
| Civilizations that accept this type of cannibalism and civilizations that do not may go to war over "the devouring of the bodies of sapient beings" in world-gen. Members of civilizations that accept this type of cannibalism will devour the bodies of creatures they kill in world-gen.
|-
|EAT_SAPIENT_OTHER
| Civilizations that accept this type of cannibalism and civilizations that do not may go to war over "the devouring of the bodies of sapient beings" in world-gen.
|-
|KILL_ANIMAL
| Civilized that accept killing animals and civilizations that do not may go to war over "the treatment of animals."
|-
|KILL_ENEMY
|
|-
|KILL_ENTITY_MEMBER
| Members of a civilization that accepts murder may kill other entity members in world-gen.
|-
|KILL_NEUTRAL
|
|-
|KILL_PLANT
| Civilizations that accept killing plants and civilizations that do not may go to war in world-gen.
|-
|LYING
| Civilizations that accept lying and civilizations that do not may go to war over "truthfulness" in world-gen.
|-
|MAKE_TROPHY_ANIMAL
| Civilizations that accept making this type of trophy and civilizations that do not may go to war over "the display of war and hunting trophies" in world-gen.
|-
|MAKE_TROPHY_SAME_RACE
| Civilizations that accept making this type of trophy and civilizations that do not may go to war over "the display of war and hunting trophies" in world-gen.
|-
|MAKE_TROPHY_SAPIENT
| Civilizations that accept making this type of trophy and civilizations that do not may go to war over "the display of war and hunting trophies" in world-gen.
|-
|OATH_BREAKING
| Civilizations that accept oath-breaking and civilizations that do not may go to war over "a formalized agreement" in world-gen.
|-
|SLAVERY
| Civilizations that accept slavery will take the former population of sites they conquer as slaves in world-gen.
|-
|THEFT
|
|-
|TORTURE_ANIMALS
| Civilizations that accept this type of torture and civilizations that do not may go to war in world-gen.
|-
|TORTURE_AS_EXAMPLE
|
|-
|TORTURE_FOR_FUN
| Civilizations that accept this type of torture and civilizations that do not may go to war over "torture" in world-gen.
|-
|TORTURE_FOR_INFORMATION
|
|-
|TREASON
|
|-
|TRESPASSING
|
|-
|VANDALISM
|
|}

==Ethics values==

This table shows the degree to which relations between two civilizations will be affected by disputes over an ethical issue, based on how much they accept it. Columns list the ethics values of the target civilization, while rows list the ethics values of the evaluating civilization. When several disputes accumulate a strong enough negative value for the evaluating civilization, they will go to war. Blank comparisons have no effect at all.

Ethics are listed loosely in order of descending acceptability.

{| {{prettytable}}
|- bgcolor="#dddddd"
|
!Token
!A
!B
!C
!D
!E
!F
!G
!H
!I
!J
!K
!L
!M
!N
!O
!P
|-
!A
|ACCEPTABLE
| +1
| +1
| +1
|
|
|
|
| -1
| -2
| -2
| -3
| -5
| -5
| -2
|
|
|-
!B
|PERSONAL_MATTER
| +1
| +1
| +1
|
|
|
|
| -1
| -2
| -2
| -3
| -5
| -5
| -2
|
|
|-
!C
|JUSTIFIED_IF_NO_REPERCUSSIONS
| +1
| +1
| +1
|
|
|
|
| -1
| -2
| -2
| -3
| -5
| -5
| -2
|
|
|-
!D
|ONLY_IF_SANCTIONED
| -2
| -2
|
| +2
|
| +1
|
|
|
| -1
| -1
| -1
| -1
| -1
| -1
|
|-
!E
|JUSTIFIED_IF_GOOD_REASON
|
|
|
|
| +2
| +1
|
| -1
| -1
| -1
| -1
| -1
| -1
| -1
| -1
|
|-
!F
|JUSTIFIED_IF_EXTREME_REASON
| -1
| -1
|
|
| +1
| +2
|
| -1
| -1
| -1
| -1
| -1
| -1
| -1
| -1
|
|-
!G
|JUSTIFIED_IF_SELF_DEFENSE
| -2
| -2
| -1
|
|
| +1
| +2
|
|
| -1
| -1
| -1
| -1
| -1
| -1
|
|-
!H
|MISGUIDED
| -1
| -1
| -1
|
|
|
|
| +2
| +1
| +1
| +1
|
|
| -1
| +1
|
|-
!I
|SHUN
| -1
| -1
| -1
|
|
|
|
| +1
| +2
| +1
| +1
|
|
| -1
| +1
|
|-
!J
|APPALLING
| -5
| -5
| -3
| -2
| -2
| -1
| -1
| +1
| +1
| +2
| +1
| +1
| +1
|
| +1
|
|-
!K
|PUNISH_REPRIMAND
| -5
| -5
| -3
| -2
| -2
| -1
| -1
| +1
| +1
| +1
| +2
| +1
| +1
|
| +1
|
|-
!L
|PUNISH_SERIOUS
| -10
| -10
| -7
| -3
| -3
| -2
| -2
|
| +1
| +1
|
| +2
| +1
| +1
| +1
|
|-
!M
|PUNISH_EXILE
| -10
| -10
| -7
| -3
| -3
| -2
| -2
|
| +1
| +1
|
| +1
| +2
| +1
| +1
|
|-
!N
|PUNISH_CAPITAL
| -15
| -15
| -10
| -5
| -5
| -3
| -3
|
| +1
| +1
|
| +1
| +1
| +2
| +1
|
|-
!O
|UNTHINKABLE
| -15
| -15
| -10
| -5
| -5
| -3
| -3
|
| +1
| +1
|
| +1
| +1
| +1
| +2
|
|-
!P
|NOT_APPLICABLE
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|}
----

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

v0.31:Ethic

2011-04-04T02:19:25Z

Bohandas: modified table color scheme to increase readability

{{av}}
== List of acceptable ethics tags==

Ethics tags are used in the entity_default raw file to determine how races feel about various issues. Relationships between civs are based on their ethics value numbers in relation to each other; Some yield favourable positive numbers or unfavourable negative numbers that result in ethic/civ conflict. Civs with UNTHINKABLE in a specific ethic will happily go to war with a different civ that has ACCEPTABLE in that same ethic type.

Example usage: [ETHIC:ASSAULT:PUNISH_SERIOUS]

In un-modded DF, this corresponds to wars over eating sapients and elves declaring war on everybody for harming plants and hunting/displaying trophies.

== Ethics types ==
{| {{prettytable}}
|- bgcolor="#dddddd"
!Token
!Extra Information
|-
|ASSAULT
|
|-
|EAT_SAPIENT_KILL
|
|-
|EAT_SAPIENT_OTHER
|
|-
|KILL_ANIMAL
|
|-
|KILL_ENEMY
|
|-
|KILL_ENTITY_MEMBER
|
|-
|KILL_NEUTRAL
|
|-
|KILL_PLANT
|
|-
|LYING
|
|-
|MAKE_TROPHY_ANIMAL
|
|-
|MAKE_TROPHY_SAME_RACE
|
|-
|MAKE_TROPHY_SAPIENT
|
|-
|OATH_BREAKING
|
|-
|SLAVERY
|
|-
|THEFT
|
|-
|TORTURE_ANIMALS
|
|-
|TORTURE_AS_EXAMPLE
|
|-
|TORTURE_FOR_FUN
|
|-
|TORTURE_FOR_INFORMATION
|
|-
|TREASON
|
|-
|TRESPASSING
|
|-
|VANDALISM
|
|}

==Ethics values==

Note: Written in alphabetical order, not order of acceptability

{| {{prettytable}}
|- bgcolor="#dddddd"
!Token

|-
|ACCEPTABLE

|-
|APPALLING

|-
|JUSTIFIED_IF_EXTREME_REASON

|-
|JUSTIFIED_IF_GOOD_REASON

|-
|JUSTIFIED_IF_NO_REPERCUSSIONS

|-
|JUSTIFIED_IF_SELF_DEFENSE

|-
|MISGUIDED

|-
|NOT_APPLICABLE

|-
|ONLY_IF_SANCTIONED

|-
|PERSONAL_MATTER

|-
|PUNISH_CAPITAL

|-
|PUNISH_EXILE

|-
|PUNISH_REPRIMAND

|-
|PUNISH_SERIOUS

|-
|SHUN

|-
|UNTHINKABLE
|}
----

==Ethics value numbers in relation to each other==

Note: These were given by Toady himself [http://www.bay12forums.com/smf/index.php?topic=22151.msg239689].

{| {{prettytable}}
|- bgcolor="#dddddd"
!Token

JUSTIFIED_IF_GOOD_REASON
JUSTIFIED_IF_GOOD_REASON +2
JUSTIFIED_IF_EXTREME_REASON +1
SHUN
APPALLING
PUNISH_REPRIMAND
PUNISH_SERIOUS
PUNISH_EXILE
PUNISH_CAPITAL
UNTHINKABLE
-1

JUSTIFIED_IF_EXTREME_REASON
JUSTIFIED_IF_GOOD_REASON +1
JUSTIFIED_IF_EXTREME_REASON +2
SHUN
APPALLING
PUNISH_REPRIMAND
PUNISH_SERIOUS
PUNISH_EXILE
PUNISH_CAPITAL
UNTHINKABLE
PERSONAL_MATTER
ACCEPTABLE
-1

JUSTIFIED_IF_SELF_DEFENSE
JUSTIFIED_IF_EXTREME_REASON +1
JUSTIFIED_IF_SELF_DEFENSE +2
APPALLING
PUNISH_REPRIMAND
PUNISH_SERIOUS
PUNISH_EXILE
PUNISH_CAPITAL
UNTHINKABLE
JUSTIFIED_IF_NO_REPERCUSSIONS
-1
PERSONAL_MATTER
ACCEPTABLE
-2

ONLY_IF_SANCTIONED
ONLY_IF_SANCTIONED +2
JUSTIFIED_IF_EXTREME_REASON +1
JUSTIFIED_IF_NO_REPERCUSSIONS
UNTHINKABLE
APPALLING
PUNISH_REPRIMAND
PUNISH_SERIOUS
PUNISH_EXILE
PUNISH_CAPITAL
-1
PERSONAL_MATTER
ACCEPTABLE
-2

MISGUIDED
MISGUIDED +2
SHUN
APPALLING
PUNISH_REPRIMAND
UNTHINKABLE
+1
PUNISH_CAPITAL
PERSONAL_MATTER
ACCEPTABLE
-1

SHUN
SHUN +2
MISGUIDED
APPALLING
PUNISH_REPRIMAND
UNTHINKABLE
+1
PUNISH_CAPITAL
PERSONAL_MATTER
ACCEPTABLE
-1

APPALLING
PERSONAL_MATTER
ACCEPTABLE
-5
JUSTIFIED_IF_NO_REPERCUSSIONS -3
JUSTIFIED_IF_GOOD_REASON
ONLY_IF_SANCTIONED
-2
JUSTIFIED_IF_EXTREME_REASON
JUSTIFIED_IF_SELF_DEFENSE
-1
SHUN
PUNISH_REPRIMAND
PUNISH_SERIOUS
MISGUIDED
PUNISH_EXILE
UNTHINKABLE
+1
APPALLING +2

PUNISH_REPRIMAND
PERSONAL_MATTER
ACCEPTABLE
-5
JUSTIFIED_IF_NO_REPERCUSSIONS -3
JUSTIFIED_IF_GOOD_REASON
ONLY_IF_SANCTIONED
-2
JUSTIFIED_IF_EXTREME_REASON
JUSTIFIED_IF_SELF_DEFENSE
-1
SHUN
PUNISH_SERIOUS
APPALLING
MISGUIDED
PUNISH_EXILE
UNTHINKABLE
+1
PUNISH_REPRIMAND +2

PUNISH_SERIOUS
PERSONAL_MATTER
ACCEPTABLE
-10
JUSTIFIED_IF_NO_REPERCUSSIONS
-7
JUSTIFIED_IF_GOOD_REASON
ONLY_IF_SANCTIONED
-3
JUSTIFIED_IF_EXTREME_REASON
JUSTIFIED_IF_SELF_DEFENSE
-2
SHUN
APPALLING
PUNISH_EXILE
UNTHINKABLE
PUNISH_CAPITAL
1
PUNISH_SERIOUS +2

PUNISH_EXILE
PERSONAL_MATTER
ACCEPTABLE
-10
JUSTIFIED_IF_NO_REPERCUSSIONS
-7
JUSTIFIED_IF_GOOD_REASON
ONLY_IF_SANCTIONED
-3
JUSTIFIED_IF_EXTREME_REASON
JUSTIFIED_IF_SELF_DEFENSE
-2
SHUN
APPALLING
PUNISH_SERIOUS
UNTHINKABLE
PUNISH_CAPITAL
+1
PUNISH_EXILE +2

PUNISH_CAPITAL
PERSONAL_MATTER
ACCEPTABLE
-15
JUSTIFIED_IF_NO_REPERCUSSIONS
-10
JUSTIFIED_IF_GOOD_REASON
ONLY_IF_SANCTIONED
-5
JUSTIFIED_IF_EXTREME_REASON
JUSTIFIED_IF_SELF_DEFENSE
-3
APPALLING
PUNISH_SERIOUS
UNTHINKABLE
PUNISH_EXILE
+1
PUNISH_CAPITAL +2

UNTHINKABLE
PERSONAL_MATTER
ACCEPTABLE
-15
JUSTIFIED_IF_NO_REPERCUSSIONS
-10
JUSTIFIED_IF_GOOD_REASON
ONLY_IF_SANCTIONED
-5
JUSTIFIED_IF_EXTREME_REASON
JUSTIFIED_IF_SELF_DEFENSE
-3
SHUN
APPALLING
PUNISH_SERIOUS
PUNISH_EXILE
PUNISH_CAPITAL
+1
UNTHINKABLE
+2

JUSTIFIED_IF_NO_REPERCUSSIONS
PERSONAL_MATTER
ACCEPTABLE
MISGUIDED -1
SHUN
APPALLING
PUNISH_REPRIMAND
UNTHINKABLE
-2
PUNISH_SERIOUS -3
PUNISH_EXILE
PUNISH_CAPITAL
-5
JUSTIFIED_IF_NO_REPERCUSSIONS
PERSONAL_MATTER
ACCEPTABLE
+1

----

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

v0.31:Item token

2011-04-03T20:55:24Z

Bohandas: Corrected a typo in my previous edit

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

Item tokens are the first part in defining the target item in reactions, containing the ITEM_TOKEN and ITEM_SUBTYPE. They determine the most basic form of item, and made more specific by {{l|material token}}s. Most item tokens use NO_SUBTYPE or NONE for subtype unless explicitly stated otherwise.

==Standard Item Tokens==

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

==Limited/Special Use Item Tokens==

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

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

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

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

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

|}

==Related Tokens==

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

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

|-
| METAL_ORE
| Metal
| {{L|Reaction}} [REAGENT]
| This functions a bit differently from the other tokens. It Seems to call for a stone/boulder (only????) of a material with a [METAL_ORE:<Metal>:<percentage>] token for the metal specified. This token is therefore more specific and seems to fill the role of both the item token and the material token in a reaction reagent. Found in the "(use ore)" versions of smelter reactions.

|}

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

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

v0.31:Item token

2011-04-03T20:54:07Z

Bohandas: Added See Also section

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

Item tokens are the first part in defining the target item in reactions, containing the ITEM_TOKEN and ITEM_SUBTYPE. They determine the most basic form of item, and made more specific by {{l|material token}}s. Most item tokens use NO_SUBTYPE or NONE for subtype unless explicitly stated otherwise.

==Standard Item Tokens==

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

==Limited/Special Use Item Tokens==

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

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

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

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

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

|}

==Related Tokens==

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

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

|-
| METAL_ORE
| Metal
| {{L|Reaction}} [REAGENT]
| This functions a bit differently from the other tokens. It Seems to call for a stone/boulder (only????) of a material with a [METAL_ORE:<Metal>:<percentage>] token for the metal specified. This token is therefore more specific and seems to fill the role of both the item token and the material token in a reaction reagent. Found in the "(use ore)" versions of smelter reactions.

|}

==See Also==
[[DF2010:Material token]]
[[DE2010:Reactions]]

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

v0.31:Language token

2011-04-02T22:53:33Z

Bohandas: Added see also section

{{av}}

Language tokens are used within the language_*.txt raw files. Each token is permitted in a specific context.

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

|-
| NOUN
|
* singular
* plural
| Begins defining a noun usage of a word

|-
| ADJ
|
* adjective
| Begins defining an adjective usage of a word

|-
| PREFIX
|
* prefix
| Begins defining a prefix usage of a word

|-
| VERB
|
* base
* present simple
* past tense
* past participle
* present participle
| Defines a verb usage of a word

|-
| ADJ_DIST
| number
| Determines what order the adjective being defined comes in when in a string of multiple adjectives.

|-
| THE_NOUN_SING
|
|

|-
| THE_NOUN_PLUR
|
|

|-
| THE_COMPOUND_NOUN_SING
|
|

|-
| THE_COMPOUND_NOUN_PLUR
|
|

|-
| THE_COMPOUND_ADJ
|
|

|-
| OF_NOUN_SING
|
|

|-
| OF_NOUN_PLUR
|
|

|-
| FRONT_COMPOUND_NOUN_SING
|
|

|-
| FRONT_COMPOUND_NOUN_PLUR
|
|

|-
| REAR_COMPOUND_NOUN_SING
|
|

|-
| REAR_COMPOUND_NOUN_PLUR
|
|

|-
| FRONT_COMPOUND_ADJ
|
|

|-
| REAR_COMPOUND_ADJ
|
|

|-
| FRONT_COMPOUND_PREFIX
|
|

|-
| THE_COMPOUND_PREFIX
|
|

|-
| STANDARD_VERB
|
| Unknown.

|}

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

|-
| S_WORD
|
* WORD
| Specifies the given WORD (defined in language_words.txt) as belonging to the symbol being defined. A given word can belong to multiple symbols.

|}

==TRANSLATION==

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

|-
| T_WORD
|
* WORD
* translation
| Specifies a translation from a given WORD (defined in language_words.txt) into the language being defined.

|}

==See Also==
[[40d:Language]] (has expanded explanations of parts of the language system, which seems to still be the same in the current version)

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

v0.31:Language token

2011-03-31T20:55:43Z

Bohandas: Created page. Listed tokens. Explained some tokens

This is a list of the Word Tokens, Symbol Tokens, and Translation Tokens used in the "language_..." files in the raws

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

|-
| ADJ
| adjective
| Begins defining an adjective usage of a word

|-
| ADJ_DIST
| number
| Determines what order the adjective being defined comes in when in a string of multiple adjectives

|-
| FRONT_COMPOUND_ADJ
|
|

|-
| FRONT_COMPOUND_NOUN_PLUR
|
|

|-
| FRONT_COMPOUND_NOUN_SING
|
|

|-
| FRONT_COMPOUND_PREFIX
|
|

|-
| NOUN
| noun
| Begins defining a noun usage of a word

|-
| OF_NOUN_PLUR
|
|

|-
| OF_NOUN_SING
|
|

|-
| PREFIX
| prefix
| Begins defining a prefix usage of a word

|-
| REAR_COMPOUND_ADJ
|
|

|-
| REAR_COMPOUND_NOUN_PLUR
|
|

|-
| REAR_COMPOUND_NOUN_SING
|
|

|-
| S_WORD
| WORD
| Selects a WORD as appearing as part of the current SYMBOL

|-
| STANDARD_VERB
|
| ???

|-
| SYMBOL
| Symbol Name
| Begins list of words in a language_SYM symbol

|-
| THE_COMPOUND_ADJ
|
|

|-
| THE_COMPOUND_NOUN_PLUR
|
|

|-
| THE_COMPOUND_NOUN_SING
|
|

|-
| THE_COMPOUND_PREFIX
|
|

|-
| THE_NOUN_PLUR
|
|

|-
| THE_NOUN_SING
|
|

|-
| T_WORD
|
|

|-
| VERB
| Verb tenses
| Defines a verb usage of a word

|-
| WORD
|
| Begins defining a word
|}

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

v0.31:Item token

2011-03-19T21:14:15Z

Bohandas: fixed minor grammarical error in my previous entry

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

Item tokens are the first part in defining the target item in reactions, containing the ITEM_TOKEN and ITEM_SUBTYPE. They determine the most basic form of item, and made more specific by {{l|material token}}s. Most item tokens use NO_SUBTYPE or NONE for subtype.

==Standard Item Tokens==

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

==Limited/Special Use Item Tokens==

Several locations which accept item tokens will also accept special values not permitted anywhere else.

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

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

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

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

|-
| METAL_ORE
| Metal
| {{L|Reaction}} [REAGENT]
| This functions a bit differently from the other tokens. It Seems to call for a stone/boulder (only????) of a material with a [METAL_ORE:<Metal>:<percentage>] token for the metal specified. This token is therefore more specific and seems to fill the role of both the item token and the material token in a reaction reagent. Found in the "(use ore)" versions of smelter reactions.

|}

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

v0.31:Item token

2011-03-19T21:11:01Z

Bohandas: Added the METAL_ORE token (which has qualities of both an item token and a material token) from the (use ore) versions of the smelter reactions to the list of limited/special use tokens.

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

Item tokens are the first part in defining the target item in reactions, containing the ITEM_TOKEN and ITEM_SUBTYPE. They determine the most basic form of item, and made more specific by {{l|material token}}s. Most item tokens use NO_SUBTYPE or NONE for subtype.

==Standard Item Tokens==

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

==Limited/Special Use Item Tokens==

Several locations which accept item tokens will also accept special values not permitted anywhere else.

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

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

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

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

|-
| METAL_ORE
| Metal
| {{L|Reaction}} [REAGENT]
| This functions a bit differently from the other tokens. It Seems to call for a stone/boulder (only????) of a material with a [METAL_ORE:<Metal>:<percentage>] for the metal specified. This token is therefore more specific and seems to fill the role of both the item token and the material token in a reaction reagent. Found in the "(use ore)" versions of smelter reactions.

|}

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

v0.31:Creature token

2011-03-14T02:03:49Z

Bohandas: Added names of new tags from the splitting of VERMINHUNTER

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

Tentative at best in some cases.

__NOTOC__

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

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

|-
| ADOPTS_OWNER
|
|

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

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

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

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

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

|-
| APP_MOD_DESC_RANGE
| ?
| ?

|-
| APP_MOD_GENETIC_MODEL
|
|

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

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

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

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

|-
| APPLY_CURRENT_CREATURE_VARIATION
|
| Applies loaded Creature Variation

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

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

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

|-
| AT_PEACE_WITH_WILDLIFE
|
|

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

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

|}

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

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

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

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

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

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

|-
| BLOOD, PUS, OTHER MATERIAL state definition
|
* {{L|material token}}
*matter state (LIQUID, GAS, SOLID)
| Controls bleeding behaviour

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

|-
| CASTE
|
*name
| defines a caste

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

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

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

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

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

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

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

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

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

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

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

|-
| CHANGE_BODY_SIZE_PERC
|
|

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

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

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

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

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

|-
| COLONY_EXTERNAL
|
| Caste hovers around colony.

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

|-
| FEATURE_ATTACK_GROUP
|
| Found on subterranean animalmen.

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

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

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

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

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

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

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

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

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

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

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

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

|-
| GENERATED
|
| Found on procedurally generated creatures like {{L|Forgotten beast}}s, (biome name) {{L|titan}}s, {{L|Demon}}s, and {{L|night creature}}s.

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

|-
| HUNTS_VERMIN
|
|

|}

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

|-
| LAYS_UNUSUAL_EGGS
|
* {{L|item token}}
* {{L|material token}}
| Creature lays a particular item instead of regular eggs. As of v0.31.19, this tag only makes the game crash.

|-
| LIGAMENTS
|
* {{L|material token}}
*healing rate
| Defines the material and healing rate of ligaments.

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

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

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

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

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

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

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

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

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

|-
| MALE
|
| all male

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

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

|-
| MATERIAL_BREATH_ATTACK
|
* {{L|material token}}
* breath attack type (TRAILING_DUST_FLOW, TRAILING_VAPOR_FLOW, TRAILING_GAS_FLOW, SOLID_GLOB, LIQUID_GLOB, UNDIRECTED_GAS, UNDIRECTED_VAPOR, UNDIRECTED_DUST)
| Creates an attack referencing a material, using a given type of breath attack.

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

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

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

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

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

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

|-
| MILKABLE
|
* {{L|material token}}
* frequency
| Allows the creature to be milked.

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

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

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

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

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

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

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

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

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

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

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

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

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

|-
| NO_DIZZINESS
|
| Creature cannot become dizzy

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

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

|-
| NO_FEVERS
|
| Creature cannot suffer fevers

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

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

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

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

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

|-
| NOBONES
|
| Creature has no bones.

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

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

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

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

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

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

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

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

|-
| NORMAL
| ???
| Unknown. Found in string dump.

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

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

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

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

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

|-
| NOT_BUTCHERABLE
|
| Cannot be butchered

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

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

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

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

|-
| PATTERNFLIER
|
|

|-
| PEARL
|
| Creature will generate pearls.

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

|-
| REMAINS_COLOR
|
|

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

|-
| REMAINS_UNDETERMINED
|
|

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

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

|-
| RETURNS_VERMIN_KILLS_TO_OWNER
|
|

|}

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

|-
| SMALL_REMAINS
|
| If a creature has this token, it'll leave "remains" instead of a corpse.

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

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

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

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

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

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

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

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

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

|}

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

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

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

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

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

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

|-
| TISSUE_LAYER_UNDER
|
*BY_TYPE, BY_CATEGORY, BY_TOKEN
*TYPE,CATEGORY, or TOKEN
*TISSUE
| Adds the tissue layer under a given part.
See Important Related Tokens, below, for more information.

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

|-
| USE_CASTE
|
*caste token
|

|-
| USE_MATERIAL
|
*new material token
*old material id
| Uses an existing material to define a new material. Old material id accepts any valid material id, including INORGANIC:X, CREATURE_MAT:C:X, LOCAL_CREATURE_MAT:X, and others (where X is a material id from that set, and C is a valid creature id).

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

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

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

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

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

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

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

|-
| VERMIN_BITE
|
*amount
*verb (bitten, stung)
* {{L|material token}}
| vermin bites, and injects something.

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

|-
| VERMIN_FISH
|
| Acts like a fish

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

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

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

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

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

|-
| VERMIN_NOTRAP
|
| The creature cannot be caught in baited animal traps; however, a "catch live land animal" task may still be able to capture one if a dwarf finds one roaming around.

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

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

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

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

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

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

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

|-
| WEBBER
|
* {{L|material token}}
| allows the creature to web, and defines what the webs are made of.

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

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

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

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

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

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

|-
| ATTACK_FLAG_EDGE
|
| attack type

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

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

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

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

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

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

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

===Tissue Modification===
This next group of tokens deals setting and modifying tissue properties. (See also [[DF2010:Tissue definition token]])

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

|}

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

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

v0.31:Reactions

2011-03-13T19:06:30Z

Bohandas: Added note to the effect that the full token list is in alphabetical order (mentioned in the lead-in to said list)

{{quality|Fine|09:41, 6 October 2010 (UTC)}}
{{av}}

Reactions are modular, editable formulas that take specific ingredients, or reagents, and use them to produce a desired item. A lot of reactions are hardcoded - building beds or creating glass, for example -- but a few are freely editable, and it's quite simple to add additional ones.

== Reaction differences between modes ==
In [[Fortress mode]], reactions are linked to specific buildings, and must be added to a civilization's [[Entities|entity file]] to be usable by that civilization. This has the useful effect of limiting new items and materials (such as special [[wood]] or [[metal]]) to civilizations that have the requisite reaction -- so that if you give your custom civilization a reaction to produce star metal or some other custom material, only they will be able to use it.

In [[Adventure mode]], reactions are freely available via x > create, and any adventurer character can make free use of them. Reagents may be held in the hands or dropped on the ground, but cannot be used within a backpack or quiver. As of .10, there are several bugs with Adventure mode reactions, chief of which is the fact that the [HAS_MATERIAL_REACTION_PRODUCT] token is completely ignored, leading to dragon eye tissue tanned hides, among other things.

Prior to version 31.10, a reaction could only result in an object of base [[quality]]. However, in .10 items produced via reactions have been observed to have quality modifiers. The way skill factors into them has yet is the same as for normal items{{version|0.31.21}}.

==Anatomy of a reaction==

Reactions are found within reaction_x files (such as reaction_smelter or reaction_other). Generally speaking they adhere to the following structure:

[REACTION:<identifier>]
[NAME:<name>]
[BUILDING:<BUILDING NAME>:<BUILDING KEY>]
[REAGENT:A:150:BAR:NONE:POTASH:NONE]
[PRODUCT:100:1:BAR:NONE:PEARLASH:NONE][PRODUCT_DIMENSION:150]
[FUEL]
[SKILL:<SKILL TOKEN>]
[AUTOMATIC]
[ADVENTURE_MODE_ENABLED]
* ''[[#Reaction identifier|identifier]]'': The internal ID of the reaction.
* ''[[#Reaction name|name]]'': The name of the reaction, visible to the player in the Fortress mode or Adventure mode menus.
* ''[[#Building|building]]'': The building ID that the reaction uses, and the relevant keyboard shortcut.
* ''[[#Reagents|...reagents...]]'': Zero or more reagents (ingredients) that are required to be in stock for the reaction to be possible.
* ''[[#Products|...products...]]'': Zero or more products that are created from the reaction.
* ''[[#fuel|fuel]]'': (optional) If present, the reaction requires charcoal, coke or a magma-powered workshop.
* ''[[#skill|skill]]'': (optional) The skill required and trained by the reaction.
* ''[[#automatic|automatic]]'': (optional) If present, the reaction will automatically be enqueued whenever it can possibly be performed.
* ''[[#adventure mode|adventure mode]]'': (optional) If present, the reaction is used by the player in Adventure mode instead.

=== Reaction identifier ===

The reaction identifier may be anything, so long as it is unique within the raw data files. A good habit to get into is to append a short prefix or suffix to each name related to the name of your mod, to ensure nobody else is going to make an identical reaction and thereby mess up the game if their mod is run alongside yours.

=== Reaction name ===

This can be anything at all, and is usually used to describe the reaction. '''Tan a hide''', for example, is the name of the default leather-producing reaction. Generally this should be written as a small descriptive verb phrase, with the first letter capitalised, for consistency with the existing reactions.

=== Building ===

[BUILDING:<BUILDING NAME>:<BUILDING KEY>]
* ''name'': The ID of the building where this reaction will appear in the tasks menu.
* ''key'': The keyboard shortcut used to queue up the reaction.

The BUILDING NAME is the name of the building that will house this reaction, and the building key is the keyboard shortcut that will queue up the reaction. If two reactions have the same key, then one of them will be assigned a different key, the first alphabetically available at the building.

=== Reagents ===
REAGENTs are a little bit complicated. They are the ingredients that the reaction will use. You can define as many as you like within a reaction.

[REAGENT:<name>:<quantity>:<item token>:<material token>][...modifiers...]
* ''[[#name|name]]'': The name of the reagent, local to the reaction.
* ''[[#quantity|quantity]]'': The amount of the item that will be used in the reaction.
* ''[[#item_token|item token]]'': The type of the item you require.
* ''[[#material_token|material token]]'': The material the item should be made of.
* ''[[#Modifiers|...modifiers...]]'': Zero or more tokens which further clarify the acceptable types when the item type and material types are insufficient to distinguish them.

==== name ====
The name field is a small string used to identify the reagent within the reaction. The name is not visible to the player. It is local to the reaction and does not need to be unique across all of the reactions, so you can reuse the same names over and over, although each reagent within the same individual reaction must have a different name.

Most reactions are simply named '''A''', '''B''', and so forth in default reactions, although names such as '''TOOLSTONE''' or '''FLUX''' will also work equally well. The PRODUCT may make reference to this name — for instance, if a container '''B''' is specified as a reagent, PRODUCT_TO_CONTAINER:B specifies that container.

==== quantity ====
The quantity differs between item types. Generally speaking, cloth, thread, powder and globs use numbers representing the size of material within one item, and everything else uses a static quantity. While REAGENT:A:'''''10''''':'''''THREAD''''':NONE:NONE:NONE thread is an extremely tiny portion of a random spool of thread, REAGENT:A:'''''10''''':'''''TOY''''':NONE:NONE:NONE is ten unique, solid toy items.

Sometimes the quantity of product is directly connected with the quantity of reagent; it seems to be 150 / REAGENT <quantity> (rounding down) so that Reagent <quantity> of 3 gives 50 product and a <quantity> of 4 gives 37. (150/4=37.5) [List of item types this applies to? Bars, for instance.]

==== item token ====
Item tokens are of the form ITEM_TYPE:ITEM_SUBTYPE.

The item type is the sort of item you require; WEAPON, TOY or SKIN_TANNED, for example. A {{L|item token|full list}} is available.

*For reagents, the item type can also be set to ANY_RAW_MATERIAL (to permit POWDER_MISC, BAR, BOULDER, or GLOB{{verify}}) or ANY_CRAFT (to permit FIGURINE, AMULET, SCEPTER, CROWN, RING, EARRING, or BRACELET).
*For products, the item type can also be set to CRAFTS to randomly pick a type of {{L|craft}} (and possibly produce more than one{{verify}}).

The item subtype is name of the exact item that you require. Examples are ITEM_WEAPON_SPEAR or ITEM_TOY_PUZZLEBOX. Some items, like quivers or backpacks, or chunks of stone or metal, only require the item token to be filled in, so if you're asking for those you should set the subtype to NONE. Subtypes are the entities defined within the local raw data files and their exact names can be referenced by looking at the corresponding file.

==== material token ====
Material tokens come in several forms - see {{L|material token|here}} for a full list. For reagents, this will typically be INORGANIC:MATERIAL_ID, whereas products will typically use GET_MATERIAL_FROM_REAGENT:REAGENT_ID:REACTION_PRODUCT_ID.

==== Modifiers ====
Reagents may also have extra tokens added on afterwards, placed just after the REAGENT tag.

A list of them follows:

{| {{prettytable}}
|- bgcolor="#dddddd"
! Token
! Meaning
|-
| [PRESERVE_REAGENT]
| Reagent is not destroyed, which is the normal effect, at the completion of the reaction. Typically used for containers.
|-
| [REACTION_CLASS:X]
| Detailed below the reaction anatomy section.
|-
| [HAS_MATERIAL_REACTION_PRODUCT:X]
| Detailed below the reaction anatomy section.
|-
| [CONTAINS:X]
| Reagent is a container that holds the specified reagent.
|-
| [UNROTTEN]
| Reagent must not be rotten, mainly for organic materials.
|-
| [BUILDMAT]
| Reagent is able to be used to build structures (Stone, Wood, Blocks, Bars?).
|-
| [GLASS_MATERIAL]
| Reagent is made of one of the 3 types of glass.
|-
| [WORTHLESS_STONE_ONLY]
| Reagent is not made of an economic stone.
|-
| [FIRE_BUILD_SAFE]
| Reagent must be considered fire safe - ie. not wood, and not coal.
|-
| [MAGMA_BUILD_SAFE]
| Reagent must have a melting point greater than the temperature of Magma.
|-
| [CAN_USE_ARTIFACT]
| Reagent can be an Artifact. Using [PRESERVE_REAGENT] with this is strongly advised.
|-
| [ANY_PLANT_MATERIAL]
| Reagent material must have any of the [STRUCTURAL_PLANT_MAT], [SEED_MAT], or [LEAF_MAT] tokens.{{verify}}
|-
| [ANY_SILK_MATERIAL]
| Reagent material must have the [SILK] token.
|-
| [ANY_YARN_MATERIAL]
| Reagent material must have the [YARN] token.
|-
| [ANY_SOAP_MATERIAL]
| Reagent material must have the [SOAP] token.
|-
| [ANY_LEATHER_MATERIAL]
| Reagent material must have the [LEATHER] token.
|-
| [ANY_BONE_MATERIAL]
| Reagent material must have the [BONE] token.
|-
| [ANY_STRAND_TISSUE]
| Unknown
|-
| [ANY_SHELL_MATERIAL]
| Reagent material must have the [SHELL] token.
|-
| [ANY_TOOTH_MATERIAL]
| Reagent material must have the [TOOTH] token.
|-
| [ANY_HORN_MATERIAL]
| Reagent material must have the [HORN] token.
|-
| [ANY_PEARL_MATERIAL]
| Reagent material must have the [PEARL] token.
|-
| [USE_BODY_COMPONENT]
| Reagent material must come off a creature's body.
|-
| [NO_EDGE_ALLOWED]
| Reagent must not be sharpened (used for knapping).
|-
| [NOT_ENGRAVED]
| ?
|-
| [NOT_IMPROVED]
| Reagent has not been decorated.
|-
| [DOES_NOT_ABSORB]
| Reagent material must have [ABSORPTION:0]
|-
| [NOT_PRESSED]
| Reagent must not be in the SOLID_PRESSED state.
|-
| [METAL_ORE]
| Reagent material must be a metal ore.
|-
| [NOT_WEB]
| States that the material cannot be a web (For making only plant/adamantine thread?).
|-
| [WEB_ONLY]
| States that the material has to be a web (For making only silk thread?).
|-
| [POTASHABLE]
| The reagent must be able to be turned into potash - thus, it must be either ASH or LYE.
|-
| [EMPTY]
| If the reagent is a container, it must be empty.
|-
| [CONTAINS_LYE]
| If the reagent is a container, it must contain LYE. No longer used - instead, use one reagent for the LYE itself and another reagent with [CONTAINS:lye_reagent].
|-
| [NOT_CONTAIN_BARREL_ITEM]
| If the reagent is a Barrel, it must not contain an item that has to reside in a barrel. Barrel items appear to be lye and milk. Alcohol appears to be covered as part of [EMPTY]. A reaction which places an item in a barrel should probably have both tags.
|-
| [BAG]
| Reagent has to be a bag. Intended to be used with an item type of BOX, to prevent chests, coffers, and other containers from being used instead.
|-
| [MIN_DIMENSION]
| ?
|-
| [HAS_TOOL_USE:X]
| Reagent must be a {{L|tool}} with the specific TOOL_USE value. The reagent's item type must be TOOL:NONE for this to make any sense.
|-
| [DOES_NOT_DETERMINE_PRODUCT_AMOUNT]
| ?
|}

Generally speaking, if you set a field in a reagent to NONE, the reaction won't discriminate when it comes to that particular field. For example, if you require a BOULDER reagent but leave the material as NONE:NONE, it will grab any available BOULDER-type item regardless of material.

===Products===
Products are the end product of the reaction. A reaction can have as many products as it likes.

Products are almost identical to reagents, except that they do not need to be named, can't have fields undefined, and don't use the quantity field to determine the product size. Instead, the token PRODUCT_DIMENSION:X is tacked on after the PRODUCT token, determining the size of the product.

Products can be produced directly to a container using the [PRODUCT_TO_CONTAINER:<IDENTIFIER>] token, where the IDENTIFIER is the name of a reagent. This requires the reagent to have the PRESERVE_REAGENT token.

Restating this in the above style, we have:
[PRODUCT:<probability>:<quantity>:<item token>:<material token>][...modifiers...][PRODUCT_DIMENSION:X][PRODUCT_TO_CONTAINER:<IDENTIFIER>]

====probability====
The percentage chance the product will be produced when the reaction is completed.

====quantity====
Determines how many of the product will be produced.

====item token====
The {{L|item token}} and subtype of the item you produce.

====material token====
A {{L|material token}} describing what the product will be made of.

====Product modifiers====
Zero or more tokens which further clarify the acceptable types when the item type and material types are insufficient to distinguish them.

{| {{prettytable}}
|- bgcolor="#dddddd"
! Token
! Meaning
|-
| [FORCE_EDGE]
| Product is given a sharp edge. Used for knapping.
|-
| [PRODUCT_PASTE]
| Product is created in the SOLID_PASTE state.
|-
| [PRODUCT_PRESSED]
| Product is created in the SOLID_PRESSED state.
|-
| [PRODUCT_DIMENSION:<size>]
| Specifies the size of the product. A size of 150 is typical for BAR, POWDER_MISC, LIQUID_MISC, and DRINK. A size of 15000 is typical for THREAD, and a size of 10000 is typical for CLOTH.
|-
| [PRODUCT_TO_CONTAINER:<id>]
| Places the product in a container; <id> must be the name of a reagent with the PRESERVE_REAGENT token and a container item type.

|}

===Improvements===
Improvements are applied to existing reagents. A reaction can have as many improvements as it likes.

Restating this in the above style, we have:
[IMPROVEMENT:<probability>:<reagent name>:<improvement type>:<material token>]

====probability====
The percentage chance the improvement will be applied to the reagent when the reaction is completed.

====reagent name====
The name of the reagent that will be improved. In order to be meaningful, this reagent must have [PRESERVE_REAGENT].

====improvement type====
The following improvement types can be used:
{| {{prettytable}}
|- bgcolor="#dddddd"
! Token
! Meaning
|-
| COVERED
| Item is encrusted/studded/decorated with <material>.
|-
| GLAZED
| Item is glazed with <material>.
|-
| RINGS_HANGING
| Item is adorned with hanging rings of <material>.
|-
| BANDS
| Item is encircled with bands of <material>.
|-
| SPIKES
| Item menaces with spikes of <material>.
|}

All other item improvement tokens (ART_IMAGE, ITEMSPECIFIC, THREAD, CLOTH, and SEWN_IMAGE) are ignored.

====material token====
A {{L|material token}} describing what the decoration will be made of.

===Other tokens===

==== fuel ====
The FUEL token means that the reaction requires coke or charcoal to be performed, or magma in magma workshops.

==== skill ====
The SKILL token determines what [[Skill tokens|skill]] the reaction requires and what skill it trains. Multiple skills can be listed but only one will be used.

==== automatic ====
The AUTOMATIC token means that the reaction will be queued automatically if the reaction reagents are all present.

==== adventure mode enabled ====
The ADVENTURE_MODE_ENABLED token means that this version of the reaction is not used by dwarves at home in a fortress, but rather the wanderers of Adventure Mode. When using this token, it will be allowed for adventurers of any race, without editing Entity files.

==Material reaction products and reaction classes==

You can get a certain measure of control over very specific materials using reaction classes and material reaction products - the tokens look like this:

[REACTION_CLASS:FAT]
[HAS_MATERIAL_REACTION_PRODUCT:RENDER_MAT]

Reaction classes represent different classes of material - basically, the material of the reagent must have a REACTION_CLASS the same as the one in the reaction.

Material reaction products are similar, but are generally used more for things like different kinds of creature materials than universal materials like stone. This token is how skin can be tanned into leather, which are two separate materials - the skin material has leather as a MATERIAL_REACTION_PRODUCT.

In short, they require the material to have a token such as
[MATERIAL_REACTION_PRODUCT:X:Y]
...where X is the name of the reaction product that will be referred to in the reaction (RENDER_MAT, in the reaction class example, or TAN_MAT for leather) and Y is a {{L|material token}} indicating the material of the desired product (such as LOCAL_CREATURE_MAT:LEATHER]).

==Reactions and world generation==

There are several things to keep in mind when you're adding reactions to a game that already exists.

* Most entity changes require a regen, but adding PERMITTED_REACTION tokens for reactions that existed at the time of world generation to the entity file in the save directory do not.
* Adding reactions to the raws in a save directory requires you to regen the world.
* You can alter an existing reaction in any way you like without regenning the world, so long as you don't alter the reaction identifier.

==Full Token List==
For the sake of convenience and readability this is a complete compilation of the previously listed reaction tokens in alphabetical order

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

|-
| ADVENTURE_MODE_ENABLED
|
| this version of the reaction is not used by dwarves at home in a fortress, but rather the wanderers of Adventure Mode. When using this token, it will be allowed for adventurers of any race, without editing Entity files

|-
| ANY_BONE_MATERIAL
|
| Reagent material must have the [BONE] token.

|-
| ANY_HORN_MATERIAL
|
| Reagent material must have the [HORN] token.

|-
| ANY_LEATHER_MATERIAL
|
| Reagent material must have the [LEATHER] token.

|-
| ANY_PEARL_MATERIAL
|
| Reagent material must have the [PEARL] token.

|-
| ANY_PLANT_MATERIAL
|
| Reagent material must have any of the [STRUCTURAL_PLANT_MAT], [SEED_MAT], or [LEAF_MAT] tokens.{{verify}}

|-
| ANY_SHELL_MATERIAL
|
| Reagent material must have the [SHELL] token.

|-
| ANY_SILK_MATERIAL
|
| Reagent material must have the [SILK] token.

|-
| ANY_SOAP_MATERIAL
|
| Reagent material must have the [SOAP] token.

|-
| ANY_STRAND_TISSUE
|
| Unknown

|-
| ANY_TOOTH_MATERIAL
|
| Reagent material must have the [TOOTH] token.

|-
| ANY_YARN_MATERIAL
|
| Reagent material must have the [YARN] token.

|-
| AUTOMATIC
|
| the reaction will be queued automatically if the reaction reagents are all present.

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

|-
| BUILDING
|
* Building name
* in-building reaction hotkey
| Sets the building that the reaction will be performed in, and the button used to queue the reaction once that building's menu is accessed in-game

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

|-
| CAN_USE_ARTIFACT
|
| Reagent can be an Artifact. Using [PRESERVE_REAGENT] with this is strongly advised.

|-
| CONTAINS
| required content
| Reagent is a container that holds the specified reagent.

|-
| CONTAINS_LYE
|
| If the reagent is a container, it must contain LYE. No longer used - instead, use one reagent for the LYE itself and another reagent with [CONTAINS:lye_reagent].

|-
| DOES_NOT_ABSORB
|
| Reagent material must have [ABSORPTION:0]

|-
| DOES_NOT_DETERMINE_PRODUCT_AMOUNT
|
| ?

|-
| EMPTY
|
| If the reagent is a container, it must be empty.

|-
| FIRE_BUILD_SAFE
|
| Reagent must be considered fire safe - ie. not wood, and not coal.

|-
| FORCE_EDGE
|
| Product is given a sharp edge. Used for knapping.

|-
| FUEL
|
| Requires that the reaction either use up a unit of coal or charcoal or else be performed at a magma workshop

|-
| GLASS_MATERIAL
|
| Reagent is made of one of the 3 types of glass. (Or another material with the IS_GLASS token in its definition???)

|-
| HAS_MATERIAL_REACTION_PRODUCT
| required reaction product
|

|-
| HAS_TOOL_USE
| Tool-use token
| Reagent must be a {{L|tool}} with the specific TOOL_USE value. The reagent's item type must be TOOL:NONE for this to make any sense.

|-
| IMPROVEMENT
|
* Probability
* Reagent Name
* Improvement type
* Material Token
| Improvement types include BANDS, COVERED, GLAZED, RINGS_HANGING, and SPIKES

|-
| MAGMA_BUILD_SAFE
|
| Reagent must have a melting point greater than the temperature of Magma.

|-
| METAL_ORE
|
| Reagent material must be a metal ore.

|-
| MIN_DIMENSION
|
| ?

|-
| NAME
| name
| defines the name used by the reaction in-game

|-
| NO_EDGE_ALLOWED
|
| Reagent must not be sharpened (used for knapping).

|-
| NOT_CONTAIN_BARREL_ITEM
|
| If the reagent is a Barrel, it must not contain an item that has to reside in a barrel. Barrel items appear to be lye and milk. Alcohol appears to be covered as part of [EMPTY]. A reaction which places an item in a barrel should probably have both tags.

|-
| NOT_ENGRAVED
|
| Reagent must not be engraved?

|-
| NOT_IMPROVED
|
| Reagent has not been decorated.

|-
| NOT_PRESSED
|
| Reagent must not be in the SOLID_PRESSED state.

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

|-
| POTASHABLE
|
| The reagent must be able to be turned into potash - thus, it must be either ASH or LYE.

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

|-
| PRODUCT
|
*Probability
*Quantity
*Item Token
*Material Token
| Defines one of the products to be outputted by the reaction

|-
| PRODUCT_DIMENSION
| size
| Specifies the size of the product. A size of 150 is typical for BAR, POWDER_MISC, LIQUID_MISC, and DRINK. A size of 15000 is typical for THREAD, and a size of 10000 is typical for CLOTH.

|-
| PRODUCT_PASTE
|
| Product is created in the SOLID_PASTE state.

|-
| PRODUCT_PRESSED
|
| Product is created in the SOLID_PRESSED state.

|-
| PRODUCT_TO_CONTAINER
| Reagent ID
| Places the product in a container; <id> must be the name of a reagent with the PRESERVE_REAGENT token and a container item type.

|-
| REACTION
| Identifier
| defines a new reaction

|-
| REACTION_CLASS
|
|

|-
|REAGENT
|
* name/id
* quantity
* item token (and subtoken)
* material token (and subtoken)
| Requires a given reagent as an input for a reaction

|-
| SKILL
| Skill Token
| Skill used by the reaction

|-
| UNROTTEN
|
| Reagent must not be rotten, mainly for organic materials.

|-
| USE_BODY_COMPONENT
|
| Reagent material must come off a creature's body.

|-
| WEB_ONLY
|
| States that the material has to be a web (For making only silk thread?).

|-
| WORTHLESS_STONE_ONLY
|
| Reagent is not made of an economic stone.

|}

[[Category:DF2010:Modding]]

v0.31 Talk:Reactions

2011-03-13T07:06:37Z

Bohandas: Commented on comment about page quality.

== Worthless Stone Only ==

'''[WORTHLESS_STONE_ONLY]''' - Only a stone of value 1 can be used?

This tag is probably unconcerned with ''value'', but rather ''economic stone status'' -- whether the stone is used in any specific reactions. For instance, anything which is listed under a [REAGENT:BOULDER...] is fair game (broad categories of reagents do not force economic stone status), but if it were to directly specify [REAGENT:CLAYSTONE...] then claystone would become an economic stone and would be forbidden from any WORTHLESS_STONE_ONLY reactions.

One thing that would be necessary is to verify whether the WORTHLESS_STONE_ONLY setting honours the economic stone state of the Status screen -- i.e., if you enable an economic stone for routine crafting (say your entire fort is built on dolomite), is it now considered worthless stone? --[[User:JT|JT]] 20:42, 6 April 2010 (UTC)

===Tested===

I tested what I had written on account of the WORTHLESS_STONE_ONLY tag. It forces the reaction to honor the settings on the Economic Stone screen. Without this tag, ANY stone can be used in the reaction. With it, only stone allowed in the Economic Stone screen can be used.

Further, [REAGENT:A:1:NONE:NONE:NONE:NONE][WORTHLESS_STONE_ONLY] can result in using a Stone, Flute, Bar of Ash, as the reagent.
[[User:Uprightpath|Upright Path]]

==Gemstones and Quantity==

Consider the following reaction:

<blockquote>
[REACTION:CHARCOAL_TO_DIAMOND]
[NAME:make diamond from charcoal]
[BUILDING:SMELTER:NONE]
[REAGENT:A:1:BAR:NO_SUBTYPE:COAL:CHARCOAL]
[PRODUCT:100:1:ROUGH:NONE:STONE:DIAMOND_CLEAR]
[FUEL]
[SKILL:SMELT]
</blockquote>

This produces not 1 but 150 diamonds from one piece of charcoal. It seems the product quantity is equal to x times y, where x is the quantity value and y is the product dimension of the reagent. If I verify this I'll put the info on the main page. --[[User:SethCreiyd|SethCreiyd]] 20:01, 12 June 2010 (UTC)
:That only does so because the reagent is incorrect. It is using 150 bars, but since the reagent only calls for 1, it produces 150.--[[Special:Contributions/174.113.156.80|174.113.156.80]] 02:02, 29 July 2010 (UTC)

== [AUTOMATIC] Tag ==

Does anyone know if this tag functions on reactions which don't require a reagent? It would be nice to have certain reactions (training, etc) queued up automatically. [[User:Shukaro|Shukaro]]

After testing, I have determined that reagentless reactions will indeed autopopulate the queue if they have the [AUTOMATIC] tag. Hooray! [[User:Shukaro|Shukaro]]

== Quality ==
Several tests indicate that items produced via reactions in .10 have varying quality levels. No idea how skill factors into it, though. [[User:Lofn|Lofn]] 12:21, 14 July 2010 (UTC)

== Page quality ==

I disagree that this article is masterwork, or even close to it. The article is difficult to read and each tag is described randomly. The only tokens that appear with a useful reference are those in the table, and those pertain only to modifiers for reagents. To be even "exceptional", this article needs a solid table like [[Creature token]]s in addition to the attempt at providing a general description. --[[Special:Contributions/99.199.37.230|99.199.37.230]] 09:40, 6 October 2010 (UTC)
:I've recently stuck in a Creature Tokens style table, like the one suggested by the previous poster, at the end of the article, but the article still needs a lot of work. --[[User:Bohandas|Bohandas]]

v0.31:Skill token

2011-03-13T06:23:25Z

Bohandas: Added skills by type section for increased ease of use. Added article to "Skills" category.

{{av}}
==Skills By Type==

===General Skills===
{| {{prettytable}}
|- bgcolor="#dddddd"
! Token
! Skill

|-
| ANIMALCARE
| Animal Caretaker

|-
| ANIMALTRAIN
| Animal Trainer

|-
| BEEKEEPING
| Beekeper

|-
| BONECARVE
| Bonecarver

|-
| BOWYER
| Bowyer

|-
| BREWING
| Brewer

|-
| BUTCHER
| Butcher

|-
| CARPENTRY
| Carpenter

|-
| CHEESEMAKING
| Cheese Maker

|-
| CLOTHESMAKING
| Clothier

|-
| COOK
| Cook

|-
| CUTGEM
| Gem Cutter

|-
| DETAILSTONE
| Engraver

|-
| DISSECT_FISH
| Fish Dissector

|-
| DISSECT_VERMIN
| Animal Dissector

|-
| DYER
| Dyer

|-
| ENCRUSTGEM
| Gem Setter

|-
| EXTRACT_STRAND
| Strand Extractor

|-
| FISH
| Fisherman (Fisherdwarf)

|-
| FORGE_ARMOR
| Armorsmith

|-
| FORGE_FURNITURE
| Metalsmith

|-
| FORGE_WEAPON
| Weaponsmith

|-
| GLASSMAKER
| Glassmaker

|-
| GLAZING
| Glazer

|-
| HERBALISM
| Herbalist

|-
| LEATHERWORK
| Leatherworker

|-
| LYE_MAKING
| Lye Maker

|-
| MASONRY
| Mason

|-
| MECHANICS
| Mechanic

|-
| METALCRAFT
| Metal Crafter

|-
| MILLING
| Miller

|-
| MILK
| Milker

|-
| MINING
| Miner

|-
| OPERATE_PUMP
| Pump Operator

|-
| PLANT
| Grower

|-
| POTASH_MAKING
| Potash Maker

|-
| POTTERY
| Potter

|-
| PRESSING
| Presser

|-
| PROCESSFISH
| Fish Cleaner

|-
| PROCESSPLANTS
| Thresher

|-
| SHEARING
| Shearer

|-
| SIEGECRAFT
| Siege Engineer

|-
| SMELT
| Furnace Operator

|-
| SPINNING
| Spinner

|-
| STONECRAFT
| Stone Crafter

|-
| TANNER
| Tanner

|-
| TRAPPING
| Trapper

|-
| WAX_WORKING
| Wax Worker

|-
| WEAVING
| Weaver

|-
| WOOD_BURNING
| Wood Burner

|-
| WOODCRAFT
| Wood Crafter

|-
| WOODCUTTING
| Wood Cutter

|}

===Medical Skills===
{| {{prettytable}}
|- bgcolor="#dddddd"
! Token
! Skill

|-
| CRUTCH_WALK
| Crutch-Walker

|-
| DIAGNOSE
| Diagnostician

|-
| DRESS_WOUNDS
| Wound Dresser

|-
| SET_BONE
| Bone Doctor

|-
| SURGERY
| Surgeon

|-
| SUTURE
| Suturer

|}

===Social Skills===
{| {{prettytable}}
|- bgcolor="#dddddd"
! Token
! Skill

|-
| APPRAISAL
| Appraiser

|-
| COMEDY
| Comedian

|-
| CONSOLE
| Consoler

|-
| FLATTERY
| Flatterer

|-
| INTIMIDATION
| Intimidator

|-
| JUDGING_INTENT
| Judge of Intent

|-
| KNOWLEDGE_ACQUISITION
| Student

|-
| LYING
| Liar

|-
| NEGOTIATION
| Negotiator

|-
| PACIFY
| Pacifier

|-
| PERSUASION
| Persuader

|-
| TEACHING
| Teacher

|}

===Administrative Skills===
{| {{prettytable}}
|- bgcolor="#dddddd"
! Token
! Skill

|-
| APPRAISAL
| Appraiser

|-
| DESIGNBUILDING
| Building Designer

|-
| LEADERSHIP
| Leader

|-
| ORGANIAZATION
| Organizer

|-
| RECORD_KEEPING
| Record Keeper

|}

===Military Skills===
{| {{prettytable}}
|- bgcolor="#dddddd"
! Token
! Skill

|-
| ARMOR
| Armor User

|-
| AXE
| Axeman

|-
| BITE
| Biter

|-
| BLOWGUN
| Blowgunner

|-
| BOW
| Bowman

|-
| CROSSBOW
| Crossbowman

|-
| DAGGER
| Knife User

|-
| DODGING
| Dodger

|-
| GRASP_STRIKE
| Striker

|-
| HAMMER
| Hammerman

|-
| MACE
| Maceman

|-
| MELEE_COMBAT
| Fighter

|-
| MILITARY_TACTICS
| Military Tactics

|-
| MISC_WEAPON
| Misc. Object User

|-
| PIKE
| Pikeman

|-
| RANGED_COMBAT
| Archer

|-
| SHIELD
| Shield user

|-
| SIEGEOPERATE
| Siege Operator

|-
| SITUATIONAL_AWARENESS
| Observer

|-
| SNEAK
| Ambusher

|-
| SPEAR
| Spearman

|-
| STANCE_STRIKE
| Kicker

|-
| SWORD
| Swordsman

|-
| THROW
| Thrower

|-
| WHIP
| Lasher

|-
| WRESTLING
| Wrestler

|}

===Other===
{| {{prettytable}}
|- bgcolor="#dddddd"
! Token
! Skill

|-
| ALCHEMY
| Alchemist

|-
| CONCENTRATION
| Concentration

|-
| CRUTCH_WALK
| Crutch-Walker

|-
| KNAPPING
| Knapper

|-
| KNOWLEDGE_ACQUISITION
| Student

|-
| LEADERSHIP
| Leader

|-
| MAGIC_NATURE
| Druid

|-
| MILITARY_TACTICS
| Military Tactics

|-
| SITUATIONAL_AWARENESS
| Observer

|-
| SNEAK
| Ambusher

|-
| SWIMMING
| Swimmer

|-
| TEACHING
| Teacher

|}

==Complete List==
A list of all skill tokens, generally used in {{L|reaction}}s.

{| {{prettytable}} class="sortable"
|- style='background-color:#ddd'
! #
! Token
! Skill
|-
|0||MINING||Miner
|-
|1||WOODCUTTING||Wood Cutter
|-
|2||CARPENTRY||Carpenter
|-
|3||DETAILSTONE||Engraver
|-
|4||MASONRY||Mason
|-
|5||ANIMALTRAIN||Animal Trainer
|-
|6||ANIMALCARE||Animal Caretaker
|-
|7||DISSECT_FISH||Fish Dissector
|-
|8||DISSECT_VERMIN||Animal Dissector
|-
|9||PROCESSFISH||Fish Cleaner
|-
|10||BUTCHER||Butcher
|-
|11||TRAPPING||Trapper
|-
|12||TANNER||Tanner
|-
|13||WEAVING||Weaver
|-
|14||BREWING||Brewer
|-
|15||ALCHEMY||Alchemist
|-
|16||CLOTHESMAKING||Clothier
|-
|17||MILLING||Miller
|-
|18||PROCESSPLANTS||Thresher
|-
|19||CHEESEMAKING||Cheese Maker
|-
|20||MILK||Milker
|-
|21||COOK||Cook
|-
|22||PLANT||Grower
|-
|23||HERBALISM||Herbalist
|-
|24||FISH||Fisherman
|-
|25||SMELT||Furnace Operator
|-
|26||EXTRACT_STRAND||Strand Extractor
|-
|27||FORGE_WEAPON||Weaponsmith
|-
|28||FORGE_ARMOR||Armorsmith
|-
|29||FORGE_FURNITURE||Metalsmith
|-
|30||CUTGEM||Gem Cutter
|-
|31||ENCRUSTGEM||Gem Setter
|-
|32||WOODCRAFT||Wood Crafter
|-
|33||STONECRAFT||Stone Crafter
|-
|34||METALCRAFT||Metal Crafter
|-
|35||GLASSMAKER||Glassmaker
|-
|36||LEATHERWORK||Leatherworker
|-
|37||BONECARVE||Bone Carver
|-
|38||AXE||Axeman
|-
|39||SWORD||Swordsman
|-
|40||DAGGER||Knife User
|-
|41||MACE||Maceman
|-
|42||HAMMER||Hammerman
|-
|43||SPEAR||Spearman
|-
|44||CROSSBOW||Crossbowman
|-
|45||SHIELD||Shield User
|-
|46||ARMOR||Armor User
|-
|47||SIEGECRAFT||Siege Engineer
|-
|48||SIEGEOPERATE||Siege Operator
|-
|49||BOWYER||Bowyer
|-
|50||PIKE||Pikeman
|-
|51||WHIP||Lasher
|-
|52||BOW||Bowman
|-
|53||BLOWGUN||Blowgunner
|-
|54||THROW||Thrower
|-
|55||MECHANICS||Mechanic
|-
|56||MAGIC_NATURE||Druid
|-
|57||SNEAK||Ambusher
|-
|58||DESIGNBUILDING||Building Designer
|-
|59||DRESS_WOUNDS||Wound Dresser
|-
|60||DIAGNOSE||Diagnostician
|-
|61||SURGERY||Surgeon
|-
|62||SET_BONE||Bone Doctor
|-
|63||SUTURE||Suturer
|-
|64||CRUTCH_WALK||Crutch-walker
|-
|65||WOOD_BURNING||Wood Burner
|-
|66||LYE_MAKING||Lye Maker
|-
|67||SOAP_MAKING||Soaper
|-
|68||POTASH_MAKING||Potash Maker
|-
|69||DYER||Dyer
|-
|70||OPERATE_PUMP||Pump Operator
|-
|71||SWIMMING||Swimmer
|-
|72||PERSUASION||Persuader
|-
|73||NEGOTIATION||Negotiator
|-
|74||JUDGING_INTENT||Judge of Intent
|-
|75||APPRAISAL||Appraiser
|-
|76||ORGANIZATION||Organizer
|-
|77||RECORD_KEEPING||Record Keeper
|-
|78||LYING||Liar
|-
|79||INTIMIDATION||Intimidator
|-
|80||CONVERSATION||Conversationalist
|-
|81||COMEDY||Comedian
|-
|82||FLATTERY||Flatterer
|-
|83||CONSOLE||Consoler
|-
|84||PACIFY||Pacifier
|-
|85||TRACKING||Tracker
|-
|86||KNOWLEDGE_ACQUISITION||Student
|-
|87||CONCENTRATION||Concentration
|-
|88||DISCIPLINE||Discipline
|-
|89||SITUATIONAL_AWARENESS||Observer
|-
|90||WRITING||Wordsmith
|-
|91||PROSE||Writer
|-
|92||POETRY||Poet
|-
|93||READING||Reader
|-
|94||SPEAKING||Speaker
|-
|95||COORDINATION||Coordination
|-
|96||BALANCE||Balance
|-
|97||LEADERSHIP||Leader
|-
|98||TEACHING||Teacher
|-
|99||MELEE_COMBAT||Fighter
|-
|100||RANGED_COMBAT||Archer
|-
|101||WRESTLING||Wrestler
|-
|102||BITE||Biter
|-
|103||GRASP_STRIKE||Striker
|-
|104||STANCE_STRIKE||Kicker
|-
|105||DODGING||Dodger
|-
|106||MISC_WEAPON||Misc. Object User
|-
|107||KNAPPING||Knapper
|-
|108||MILITARY_TACTICS||Military Tactics
|-
|109||SHEARING||Shearer
|-
|110||SPINNING||Spinner
|-
|111||POTTERY||Potter
|-
|112||GLAZING||Glazer
|-
|113||PRESSING||Presser
|-
|114||BEEKEEPING||Beekeeper
|-
|115||WAX_WORKING||Wax Worker
|}

{{Skills}}
{{Category|Modding}}{{Category|Skills}}

v0.31:Reactions

2011-03-13T04:55:55Z

Bohandas: Added full token list

{{quality|Fine|09:41, 6 October 2010 (UTC)}}
{{av}}

Reactions are modular, editable formulas that take specific ingredients, or reagents, and use them to produce a desired item. A lot of reactions are hardcoded - building beds or creating glass, for example -- but a few are freely editable, and it's quite simple to add additional ones.

== Reaction differences between modes ==
In [[Fortress mode]], reactions are linked to specific buildings, and must be added to a civilization's [[Entities|entity file]] to be usable by that civilization. This has the useful effect of limiting new items and materials (such as special [[wood]] or [[metal]]) to civilizations that have the requisite reaction -- so that if you give your custom civilization a reaction to produce star metal or some other custom material, only they will be able to use it.

In [[Adventure mode]], reactions are freely available via x > create, and any adventurer character can make free use of them. Reagents may be held in the hands or dropped on the ground, but cannot be used within a backpack or quiver. As of .10, there are several bugs with Adventure mode reactions, chief of which is the fact that the [HAS_MATERIAL_REACTION_PRODUCT] token is completely ignored, leading to dragon eye tissue tanned hides, among other things.

Prior to version 31.10, a reaction could only result in an object of base [[quality]]. However, in .10 items produced via reactions have been observed to have quality modifiers. The way skill factors into them has yet is the same as for normal items{{version|0.31.21}}.

==Anatomy of a reaction==

Reactions are found within reaction_x files (such as reaction_smelter or reaction_other). Generally speaking they adhere to the following structure:

[REACTION:<identifier>]
[NAME:<name>]
[BUILDING:<BUILDING NAME>:<BUILDING KEY>]
[REAGENT:A:150:BAR:NONE:POTASH:NONE]
[PRODUCT:100:1:BAR:NONE:PEARLASH:NONE][PRODUCT_DIMENSION:150]
[FUEL]
[SKILL:<SKILL TOKEN>]
[AUTOMATIC]
[ADVENTURE_MODE_ENABLED]
* ''[[#Reaction identifier|identifier]]'': The internal ID of the reaction.
* ''[[#Reaction name|name]]'': The name of the reaction, visible to the player in the Fortress mode or Adventure mode menus.
* ''[[#Building|building]]'': The building ID that the reaction uses, and the relevant keyboard shortcut.
* ''[[#Reagents|...reagents...]]'': Zero or more reagents (ingredients) that are required to be in stock for the reaction to be possible.
* ''[[#Products|...products...]]'': Zero or more products that are created from the reaction.
* ''[[#fuel|fuel]]'': (optional) If present, the reaction requires charcoal, coke or a magma-powered workshop.
* ''[[#skill|skill]]'': (optional) The skill required and trained by the reaction.
* ''[[#automatic|automatic]]'': (optional) If present, the reaction will automatically be enqueued whenever it can possibly be performed.
* ''[[#adventure mode|adventure mode]]'': (optional) If present, the reaction is used by the player in Adventure mode instead.

=== Reaction identifier ===

The reaction identifier may be anything, so long as it is unique within the raw data files. A good habit to get into is to append a short prefix or suffix to each name related to the name of your mod, to ensure nobody else is going to make an identical reaction and thereby mess up the game if their mod is run alongside yours.

=== Reaction name ===

This can be anything at all, and is usually used to describe the reaction. '''Tan a hide''', for example, is the name of the default leather-producing reaction. Generally this should be written as a small descriptive verb phrase, with the first letter capitalised, for consistency with the existing reactions.

=== Building ===

[BUILDING:<BUILDING NAME>:<BUILDING KEY>]
* ''name'': The ID of the building where this reaction will appear in the tasks menu.
* ''key'': The keyboard shortcut used to queue up the reaction.

The BUILDING NAME is the name of the building that will house this reaction, and the building key is the keyboard shortcut that will queue up the reaction. If two reactions have the same key, then one of them will be assigned a different key, the first alphabetically available at the building.

=== Reagents ===
REAGENTs are a little bit complicated. They are the ingredients that the reaction will use. You can define as many as you like within a reaction.

[REAGENT:<name>:<quantity>:<item token>:<material token>][...modifiers...]
* ''[[#name|name]]'': The name of the reagent, local to the reaction.
* ''[[#quantity|quantity]]'': The amount of the item that will be used in the reaction.
* ''[[#item_token|item token]]'': The type of the item you require.
* ''[[#material_token|material token]]'': The material the item should be made of.
* ''[[#Modifiers|...modifiers...]]'': Zero or more tokens which further clarify the acceptable types when the item type and material types are insufficient to distinguish them.

==== name ====
The name field is a small string used to identify the reagent within the reaction. The name is not visible to the player. It is local to the reaction and does not need to be unique across all of the reactions, so you can reuse the same names over and over, although each reagent within the same individual reaction must have a different name.

Most reactions are simply named '''A''', '''B''', and so forth in default reactions, although names such as '''TOOLSTONE''' or '''FLUX''' will also work equally well. The PRODUCT may make reference to this name — for instance, if a container '''B''' is specified as a reagent, PRODUCT_TO_CONTAINER:B specifies that container.

==== quantity ====
The quantity differs between item types. Generally speaking, cloth, thread, powder and globs use numbers representing the size of material within one item, and everything else uses a static quantity. While REAGENT:A:'''''10''''':'''''THREAD''''':NONE:NONE:NONE thread is an extremely tiny portion of a random spool of thread, REAGENT:A:'''''10''''':'''''TOY''''':NONE:NONE:NONE is ten unique, solid toy items.

Sometimes the quantity of product is directly connected with the quantity of reagent; it seems to be 150 / REAGENT <quantity> (rounding down) so that Reagent <quantity> of 3 gives 50 product and a <quantity> of 4 gives 37. (150/4=37.5) [List of item types this applies to? Bars, for instance.]

==== item token ====
Item tokens are of the form ITEM_TYPE:ITEM_SUBTYPE.

The item type is the sort of item you require; WEAPON, TOY or SKIN_TANNED, for example. A {{L|item token|full list}} is available.

*For reagents, the item type can also be set to ANY_RAW_MATERIAL (to permit POWDER_MISC, BAR, BOULDER, or GLOB{{verify}}) or ANY_CRAFT (to permit FIGURINE, AMULET, SCEPTER, CROWN, RING, EARRING, or BRACELET).
*For products, the item type can also be set to CRAFTS to randomly pick a type of {{L|craft}} (and possibly produce more than one{{verify}}).

The item subtype is name of the exact item that you require. Examples are ITEM_WEAPON_SPEAR or ITEM_TOY_PUZZLEBOX. Some items, like quivers or backpacks, or chunks of stone or metal, only require the item token to be filled in, so if you're asking for those you should set the subtype to NONE. Subtypes are the entities defined within the local raw data files and their exact names can be referenced by looking at the corresponding file.

==== material token ====
Material tokens come in several forms - see {{L|material token|here}} for a full list. For reagents, this will typically be INORGANIC:MATERIAL_ID, whereas products will typically use GET_MATERIAL_FROM_REAGENT:REAGENT_ID:REACTION_PRODUCT_ID.

==== Modifiers ====
Reagents may also have extra tokens added on afterwards, placed just after the REAGENT tag.

A list of them follows:

{| {{prettytable}}
|- bgcolor="#dddddd"
! Token
! Meaning
|-
| [PRESERVE_REAGENT]
| Reagent is not destroyed, which is the normal effect, at the completion of the reaction. Typically used for containers.
|-
| [REACTION_CLASS:X]
| Detailed below the reaction anatomy section.
|-
| [HAS_MATERIAL_REACTION_PRODUCT:X]
| Detailed below the reaction anatomy section.
|-
| [CONTAINS:X]
| Reagent is a container that holds the specified reagent.
|-
| [UNROTTEN]
| Reagent must not be rotten, mainly for organic materials.
|-
| [BUILDMAT]
| Reagent is able to be used to build structures (Stone, Wood, Blocks, Bars?).
|-
| [GLASS_MATERIAL]
| Reagent is made of one of the 3 types of glass.
|-
| [WORTHLESS_STONE_ONLY]
| Reagent is not made of an economic stone.
|-
| [FIRE_BUILD_SAFE]
| Reagent must be considered fire safe - ie. not wood, and not coal.
|-
| [MAGMA_BUILD_SAFE]
| Reagent must have a melting point greater than the temperature of Magma.
|-
| [CAN_USE_ARTIFACT]
| Reagent can be an Artifact. Using [PRESERVE_REAGENT] with this is strongly advised.
|-
| [ANY_PLANT_MATERIAL]
| Reagent material must have any of the [STRUCTURAL_PLANT_MAT], [SEED_MAT], or [LEAF_MAT] tokens.{{verify}}
|-
| [ANY_SILK_MATERIAL]
| Reagent material must have the [SILK] token.
|-
| [ANY_YARN_MATERIAL]
| Reagent material must have the [YARN] token.
|-
| [ANY_SOAP_MATERIAL]
| Reagent material must have the [SOAP] token.
|-
| [ANY_LEATHER_MATERIAL]
| Reagent material must have the [LEATHER] token.
|-
| [ANY_BONE_MATERIAL]
| Reagent material must have the [BONE] token.
|-
| [ANY_STRAND_TISSUE]
| Unknown
|-
| [ANY_SHELL_MATERIAL]
| Reagent material must have the [SHELL] token.
|-
| [ANY_TOOTH_MATERIAL]
| Reagent material must have the [TOOTH] token.
|-
| [ANY_HORN_MATERIAL]
| Reagent material must have the [HORN] token.
|-
| [ANY_PEARL_MATERIAL]
| Reagent material must have the [PEARL] token.
|-
| [USE_BODY_COMPONENT]
| Reagent material must come off a creature's body.
|-
| [NO_EDGE_ALLOWED]
| Reagent must not be sharpened (used for knapping).
|-
| [NOT_ENGRAVED]
| ?
|-
| [NOT_IMPROVED]
| Reagent has not been decorated.
|-
| [DOES_NOT_ABSORB]
| Reagent material must have [ABSORPTION:0]
|-
| [NOT_PRESSED]
| Reagent must not be in the SOLID_PRESSED state.
|-
| [METAL_ORE]
| Reagent material must be a metal ore.
|-
| [NOT_WEB]
| States that the material cannot be a web (For making only plant/adamantine thread?).
|-
| [WEB_ONLY]
| States that the material has to be a web (For making only silk thread?).
|-
| [POTASHABLE]
| The reagent must be able to be turned into potash - thus, it must be either ASH or LYE.
|-
| [EMPTY]
| If the reagent is a container, it must be empty.
|-
| [CONTAINS_LYE]
| If the reagent is a container, it must contain LYE. No longer used - instead, use one reagent for the LYE itself and another reagent with [CONTAINS:lye_reagent].
|-
| [NOT_CONTAIN_BARREL_ITEM]
| If the reagent is a Barrel, it must not contain an item that has to reside in a barrel. Barrel items appear to be lye and milk. Alcohol appears to be covered as part of [EMPTY]. A reaction which places an item in a barrel should probably have both tags.
|-
| [BAG]
| Reagent has to be a bag. Intended to be used with an item type of BOX, to prevent chests, coffers, and other containers from being used instead.
|-
| [MIN_DIMENSION]
| ?
|-
| [HAS_TOOL_USE:X]
| Reagent must be a {{L|tool}} with the specific TOOL_USE value. The reagent's item type must be TOOL:NONE for this to make any sense.
|-
| [DOES_NOT_DETERMINE_PRODUCT_AMOUNT]
| ?
|}

Generally speaking, if you set a field in a reagent to NONE, the reaction won't discriminate when it comes to that particular field. For example, if you require a BOULDER reagent but leave the material as NONE:NONE, it will grab any available BOULDER-type item regardless of material.

===Products===
Products are the end product of the reaction. A reaction can have as many products as it likes.

Products are almost identical to reagents, except that they do not need to be named, can't have fields undefined, and don't use the quantity field to determine the product size. Instead, the token PRODUCT_DIMENSION:X is tacked on after the PRODUCT token, determining the size of the product.

Products can be produced directly to a container using the [PRODUCT_TO_CONTAINER:<IDENTIFIER>] token, where the IDENTIFIER is the name of a reagent. This requires the reagent to have the PRESERVE_REAGENT token.

Restating this in the above style, we have:
[PRODUCT:<probability>:<quantity>:<item token>:<material token>][...modifiers...][PRODUCT_DIMENSION:X][PRODUCT_TO_CONTAINER:<IDENTIFIER>]

====probability====
The percentage chance the product will be produced when the reaction is completed.

====quantity====
Determines how many of the product will be produced.

====item token====
The {{L|item token}} and subtype of the item you produce.

====material token====
A {{L|material token}} describing what the product will be made of.

====Product modifiers====
Zero or more tokens which further clarify the acceptable types when the item type and material types are insufficient to distinguish them.

{| {{prettytable}}
|- bgcolor="#dddddd"
! Token
! Meaning
|-
| [FORCE_EDGE]
| Product is given a sharp edge. Used for knapping.
|-
| [PRODUCT_PASTE]
| Product is created in the SOLID_PASTE state.
|-
| [PRODUCT_PRESSED]
| Product is created in the SOLID_PRESSED state.
|-
| [PRODUCT_DIMENSION:<size>]
| Specifies the size of the product. A size of 150 is typical for BAR, POWDER_MISC, LIQUID_MISC, and DRINK. A size of 15000 is typical for THREAD, and a size of 10000 is typical for CLOTH.
|-
| [PRODUCT_TO_CONTAINER:<id>]
| Places the product in a container; <id> must be the name of a reagent with the PRESERVE_REAGENT token and a container item type.

|}

===Improvements===
Improvements are applied to existing reagents. A reaction can have as many improvements as it likes.

Restating this in the above style, we have:
[IMPROVEMENT:<probability>:<reagent name>:<improvement type>:<material token>]

====probability====
The percentage chance the improvement will be applied to the reagent when the reaction is completed.

====reagent name====
The name of the reagent that will be improved. In order to be meaningful, this reagent must have [PRESERVE_REAGENT].

====improvement type====
The following improvement types can be used:
{| {{prettytable}}
|- bgcolor="#dddddd"
! Token
! Meaning
|-
| COVERED
| Item is encrusted/studded/decorated with <material>.
|-
| GLAZED
| Item is glazed with <material>.
|-
| RINGS_HANGING
| Item is adorned with hanging rings of <material>.
|-
| BANDS
| Item is encircled with bands of <material>.
|-
| SPIKES
| Item menaces with spikes of <material>.
|}

All other item improvement tokens (ART_IMAGE, ITEMSPECIFIC, THREAD, CLOTH, and SEWN_IMAGE) are ignored.

====material token====
A {{L|material token}} describing what the decoration will be made of.

===Other tokens===

==== fuel ====
The FUEL token means that the reaction requires coke or charcoal to be performed, or magma in magma workshops.

==== skill ====
The SKILL token determines what [[Skill tokens|skill]] the reaction requires and what skill it trains. Multiple skills can be listed but only one will be used.

==== automatic ====
The AUTOMATIC token means that the reaction will be queued automatically if the reaction reagents are all present.

==== adventure mode enabled ====
The ADVENTURE_MODE_ENABLED token means that this version of the reaction is not used by dwarves at home in a fortress, but rather the wanderers of Adventure Mode. When using this token, it will be allowed for adventurers of any race, without editing Entity files.

==Material reaction products and reaction classes==

You can get a certain measure of control over very specific materials using reaction classes and material reaction products - the tokens look like this:

[REACTION_CLASS:FAT]
[HAS_MATERIAL_REACTION_PRODUCT:RENDER_MAT]

Reaction classes represent different classes of material - basically, the material of the reagent must have a REACTION_CLASS the same as the one in the reaction.

Material reaction products are similar, but are generally used more for things like different kinds of creature materials than universal materials like stone. This token is how skin can be tanned into leather, which are two separate materials - the skin material has leather as a MATERIAL_REACTION_PRODUCT.

In short, they require the material to have a token such as
[MATERIAL_REACTION_PRODUCT:X:Y]
...where X is the name of the reaction product that will be referred to in the reaction (RENDER_MAT, in the reaction class example, or TAN_MAT for leather) and Y is a {{L|material token}} indicating the material of the desired product (such as LOCAL_CREATURE_MAT:LEATHER]).

==Reactions and world generation==

There are several things to keep in mind when you're adding reactions to a game that already exists.

* Most entity changes require a regen, but adding PERMITTED_REACTION tokens for reactions that existed at the time of world generation to the entity file in the save directory do not.
* Adding reactions to the raws in a save directory requires you to regen the world.
* You can alter an existing reaction in any way you like without regenning the world, so long as you don't alter the reaction identifier.

==Full Token List==
For the sake of convenience and readability this is a complete compilation of the previously listed reaction tokens

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

|-
| ADVENTURE_MODE_ENABLED
|
| this version of the reaction is not used by dwarves at home in a fortress, but rather the wanderers of Adventure Mode. When using this token, it will be allowed for adventurers of any race, without editing Entity files

|-
| ANY_BONE_MATERIAL
|
| Reagent material must have the [BONE] token.

|-
| ANY_HORN_MATERIAL
|
| Reagent material must have the [HORN] token.

|-
| ANY_LEATHER_MATERIAL
|
| Reagent material must have the [LEATHER] token.

|-
| ANY_PEARL_MATERIAL
|
| Reagent material must have the [PEARL] token.

|-
| ANY_PLANT_MATERIAL
|
| Reagent material must have any of the [STRUCTURAL_PLANT_MAT], [SEED_MAT], or [LEAF_MAT] tokens.{{verify}}

|-
| ANY_SHELL_MATERIAL
|
| Reagent material must have the [SHELL] token.

|-
| ANY_SILK_MATERIAL
|
| Reagent material must have the [SILK] token.

|-
| ANY_SOAP_MATERIAL
|
| Reagent material must have the [SOAP] token.

|-
| ANY_STRAND_TISSUE
|
| Unknown

|-
| ANY_TOOTH_MATERIAL
|
| Reagent material must have the [TOOTH] token.

|-
| ANY_YARN_MATERIAL
|
| Reagent material must have the [YARN] token.

|-
| AUTOMATIC
|
| the reaction will be queued automatically if the reaction reagents are all present.

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

|-
| BUILDING
|
* Building name
* in-building reaction hotkey
| Sets the building that the reaction will be performed in, and the button used to queue the reaction once that building's menu is accessed in-game

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

|-
| CAN_USE_ARTIFACT
|
| Reagent can be an Artifact. Using [PRESERVE_REAGENT] with this is strongly advised.

|-
| CONTAINS
| required content
| Reagent is a container that holds the specified reagent.

|-
| CONTAINS_LYE
|
| If the reagent is a container, it must contain LYE. No longer used - instead, use one reagent for the LYE itself and another reagent with [CONTAINS:lye_reagent].

|-
| DOES_NOT_ABSORB
|
| Reagent material must have [ABSORPTION:0]

|-
| DOES_NOT_DETERMINE_PRODUCT_AMOUNT
|
| ?

|-
| EMPTY
|
| If the reagent is a container, it must be empty.

|-
| FIRE_BUILD_SAFE
|
| Reagent must be considered fire safe - ie. not wood, and not coal.

|-
| FORCE_EDGE
|
| Product is given a sharp edge. Used for knapping.

|-
| FUEL
|
| Requires that the reaction either use up a unit of coal or charcoal or else be performed at a magma workshop

|-
| GLASS_MATERIAL
|
| Reagent is made of one of the 3 types of glass. (Or another material with the IS_GLASS token in its definition???)

|-
| HAS_MATERIAL_REACTION_PRODUCT
| required reaction product
|

|-
| HAS_TOOL_USE
| Tool-use token
| Reagent must be a {{L|tool}} with the specific TOOL_USE value. The reagent's item type must be TOOL:NONE for this to make any sense.

|-
| IMPROVEMENT
|
* Probability
* Reagent Name
* Improvement type
* Material Token
| Improvement types include BANDS, COVERED, GLAZED, RINGS_HANGING, and SPIKES

|-
| MAGMA_BUILD_SAFE
|
| Reagent must have a melting point greater than the temperature of Magma.

|-
| METAL_ORE
|
| Reagent material must be a metal ore.

|-
| MIN_DIMENSION
|
| ?

|-
| NAME
| name
| defines the name used by the reaction in-game

|-
| NO_EDGE_ALLOWED
|
| Reagent must not be sharpened (used for knapping).

|-
| NOT_CONTAIN_BARREL_ITEM
|
| If the reagent is a Barrel, it must not contain an item that has to reside in a barrel. Barrel items appear to be lye and milk. Alcohol appears to be covered as part of [EMPTY]. A reaction which places an item in a barrel should probably have both tags.

|-
| NOT_ENGRAVED
|
| Reagent must not be engraved?

|-
| NOT_IMPROVED
|
| Reagent has not been decorated.

|-
| NOT_PRESSED
|
| Reagent must not be in the SOLID_PRESSED state.

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

|-
| POTASHABLE
|
| The reagent must be able to be turned into potash - thus, it must be either ASH or LYE.

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

|-
| PRODUCT
|
*Probability
*Quantity
*Item Token
*Material Token
| Defines one of the products to be outputted by the reaction

|-
| PRODUCT_DIMENSION
| size
| Specifies the size of the product. A size of 150 is typical for BAR, POWDER_MISC, LIQUID_MISC, and DRINK. A size of 15000 is typical for THREAD, and a size of 10000 is typical for CLOTH.

|-
| PRODUCT_PASTE
|
| Product is created in the SOLID_PASTE state.

|-
| PRODUCT_PRESSED
|
| Product is created in the SOLID_PRESSED state.

|-
| PRODUCT_TO_CONTAINER
| Reagent ID
| Places the product in a container; <id> must be the name of a reagent with the PRESERVE_REAGENT token and a container item type.

|-
| REACTION
| Identifier
| defines a new reaction

|-
| REACTION_CLASS
|
|

|-
|REAGENT
|
* name/id
* quantity
* item token (and subtoken)
* material token (and subtoken)
| Requires a given reagent as an input for a reaction

|-
| SKILL
| Skill Token
| Skill used by the reaction

|-
| UNROTTEN
|
| Reagent must not be rotten, mainly for organic materials.

|-
| USE_BODY_COMPONENT
|
| Reagent material must come off a creature's body.

|-
| WEB_ONLY
|
| States that the material has to be a web (For making only silk thread?).

|-
| WORTHLESS_STONE_ONLY
|
| Reagent is not made of an economic stone.

|}

[[Category:DF2010:Modding]]

v0.31:Entity token

2011-03-12T20:00:54Z

Bohandas: Added BANDITRY and LOCAL_BANDITRY tags to list. Someone still needs to provide the explanations for them though.

{{av}}
These tokens define entities, or civilizations, in entity_*.txt files.

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

|-
| ADVENTURE_TIER
| order
| Allows adventure mode. Dwarfs, Elves, and Humans take up tier 3, 2, and 1 respectively. It seems that the best way to use this is to put your entity in the same order as the other tiers. The tiers are in descending order. So you should put a new adventure entity above the Dwarves. Not at the end of the file.
[ADVENTURE_TIER:4]

|-
| INDIV_CONTROLLABLE
|
| Allows the "Play Now!" option adventure mode. Not having this specified in one of the entities will cause the Adventure mode option to disappear.

|-
| 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). At least one civilization must have this token.

|-
| CREATURE
| creature
|The type of creature that will inhabit the civilization. Multiple entries will be chosen from at random for each civilization.
[CREATURE:DWARF]

|}

== Placement ==

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

|-
| BIOME_SUPPORT
|
* {{L|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]

|-
| START_BIOME
| {{L|Biome token|biome}}
| Birth of the civilization can be performed on this biome.
[START_BIOME:MOUNTAIN]

|-
| DEFAULT_SITE_TYPE
| site type
| Also determines symbol used when selecting civilization. CAVE uses no symbol. Options are: CITY, TREE_CITY, DARK_FORTRESS, CAVE, CAVE_DETAILED, (in 40d also RUIN)
[DEFAULT_SITE_TYPE:CAVE_DETAILED]

|-
| LIKES_SITE
| site type
| Most residents will try to move to this site type, unless already at one.
[LIKES_SITE:CAVE_DETAILED]

|-
| TOLERATES_SITE
| site type
| Some residents will try to move to this site type, unless already at one.
[TOLERATES_SITE:CITY]

|-
| WORLD_CONSTRUCTION
| construction
| Controls which constructions the civ will build on the world map.
[WORLD_CONSTRUCTION:BRIDGE]
[WORLD_CONSTRUCTION:ROAD]
[WORLD_CONSTRUCTION:TUNNEL]
[WORLD_CONSTRUCTION:WALL]

|}

== Population ==

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

|-
| START_GROUP_NUMBER
| number
| Number of breeding couples to start with per entity. Note that single-gender (eg. [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]

|-
| MAX_POP_NUMBER
| number
| Max population *per entity*, multiply this by max starting civ to get the total population of the species.
[MAX_POP_NUMBER:500]

|-
| MAX_SITE_POP_NUMBER
| number
| Max population per individual site.
[MAX_SITE_POP_NUMBER:200]

|-
| MAX_STARTING_CIV_NUMBER
| number
| Max number of entities to spawn at world generation.
[MAX_STARTING_CIV_NUMBER:3]

|}

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

|-
| PERMITTED_BUILDING
| building name
| The named, custom building can be built by a civilization in Fortress Mode.
[PERMITTED_BUILDING:SOAP_MAKER]

|-
| PERMITTED_JOB
| {{L|Unit type token|profession}}
| Allows this job type to be selected. This applies to worldgen creatures, in the embark screen, and in play.
[PERMITTED_JOB:MINER]

|-
| PERMITTED_REACTION
| reaction name
| Allows this reaction to be used by a civilization. It is used primarily in Fortress Mode. 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]

|-
| CURRENCY_BY_YEAR
|
| Causes the civ's currency to be numbered with the year it was minted.

|-
| CURRENCY
|
* metal token
* value
| What kind of metals the civ uses for coin minting as well as the value of the coin.
[CURRENCY:SILVER:5]

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

|-
| ART_IMAGE_ELEMENT_MODIFIER
|
* item
* number
| CREATURE, PLANT, TREE, SHAPE, ITEM
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]

|-
| ITEM_IMPROVEMENT_MODIFIER
|
* item
* number
| ART_IMAGE, COVERED, RINGS_HANGING, BANDS, SPIKES, ITEMSPECIFIC, THREAD, CLOTH, SEWN_IMAGE: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.

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

|-
| CULL_SYMBOL
|
* noun
* symbol
| ALL, CIV, SITE
Causes the entity to not use the words in these SYM sets.
[CULL_SYMBOL:ALL:UGLY]

|-
| SELECT_SYMBOL
|
* noun
* symbol
| Causes the entity to more often use these symbols in the particular SYM set.
[SELECT_SYMBOL:ALL:PEACE]

|-
| FRIENDLY_COLOR
| see {{L|color}}
|
The color of this entity's civilization settlements in the world gen and embark screens
[FRIENDLY_COLOR:1:0:1]

|}

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

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

|-
| RELIGION_SPHERE
| sphere
| Can by any available {{L|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]

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

|-
| 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 {{l|Position token}}.

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

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

|-
| [[Ethics|ETHIC]]
|
*behavior
*reaction
| Sets the civ's view of 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]

|-
| WILL_ACCEPT_TRIBUTE
|
| Makes the civ's traders accept offered goods.

|-
| WANDERER, BEAST_HUNTER, SCOUT
|
| The civ will send out these sorts of adventurers in worldgen.

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

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

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

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

|-
| 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 history gen, allowing them to become part of the civ if they do not escape.

Note: If playable civ in Fortress Mode has this tag (ie. 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.

|-
| BANDITRY
| percentage/level???
|

|-
| DIPLOMAT
|
| Presumably causes the civilization to send a diplomat once your fortress reaches a certain state.

|-
| DIPLOMAT_BODYGUARDS
|
| Effect unknown.

|-
| INVADERS_IGNORE_NEUTRALS
|
|

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

|-
| LOCAL_BANDITRY
|
| ???

|-
| MERCHANT_BODYGUARDS
|
| Merchants have bodyguards and wagons. Wagons allow for a lot more variety in their goods.

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

|-
| 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. 0 corresponds to no population requirement necessary for interaction. 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.

|-
| 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. Progress triggers may be changed, added, or deleted for a currently active fort.

|-
| 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. Progress triggers may be changed, added, or deleted for a currently active fort.

|-
| 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. 0 corresponds to no population requirement necessary for interaction. 1 corresponds to 20 dwarves, 2 to 50 dwarves, 3 to 80, 4 to 110, and 5 to 140.

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

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

|-
| SIEGER
|
| Will wait around at the edge of your map for a month or two, before charging.

|-
| SKULKING
|
| This makes the severity of attacks depend on the extent of item/baby thievery rather than the passage of time.

|-
| TREE_CAP_DIPLOMACY
|
| Makes the entity angry if you cut down too many trees. They will send a warning first.

|-
| LAYER_LINKED
|
| Defines if a civilization is a hidden subterranean entity, such as batman civilizations.

|}

== Items and Animals Used ==
{| {{prettytable}}
|- bgcolor="#ddd"
! Token
! Arguments
! Description

|-
| AMMO
| item token
|
[AMMO:ITEM_AMMO_BOLTS]

|-
| ARMOR
|
* item token
* rarity
|Rarity is optional. Permitted rarity values include RARE, UNCOMMON, COMMON, and FORCED.
[ARMOR:ITEM_ARMOR_PLATEMAIL:COMMON]

|-
| DIGGER
| item token
|
[DIGGER:ITEM_WEAPON_PICK]

|-
| GLOVES
|
* item token
* rarity
| Rarity is optional. Permitted rarity values include RARE, UNCOMMON, COMMON, and FORCED.
[GLOVES:ITEM_GLOVES_GLOVES:COMMON]

|-
| HELM
|
* item token
* rarity
| Rarity is optional. Permitted rarity values include RARE, UNCOMMON, COMMON, and FORCED.
[HELM:ITEM_HELM_HELM:COMMON]

|-
| INSTRUMENT
| item token
|
[INSTRUMENT:ITEM_INSTRUMENT_FLUTE]

|-
| PANTS
|
* item token
* rarity
| Rarity is optional. Permitted rarity values include RARE, UNCOMMON, COMMON, and FORCED.
[PANTS:ITEM_PANTS_PANTS:COMMON]

|-
| SHIELD
| item token
|
[SHIELD:ITEM_SHIELD_SHIELD]

|-
| SHOES
|
* item token
* rarity
| Rarity is optional. Permitted rarity values include RARE, UNCOMMON, COMMON, and FORCED.
[SHOES:ITEM_SHOES_SHOES:COMMON]

|-
| SIEGEAMMO
| item token
|
[SIEGEAMMO:ITEM_SIEGEAMMO_BALLISTA]

|-
| TOY
| item token
|
[TOY:ITEM_TOY_PUZZLEBOX]

|-
| TRAPCOMP
| item token
|
[TRAPCOMP:ITEM_TRAPCOMP_GIANTAXEBLADE]

|-
| WEAPON
| item token
|
[WEAPON:ITEM_WEAPON_AXE_BATTLE]

|-
| USE_ANIMAL_PRODUCTS
|
|

|-
| USE_ANY_PET_RACE
|
| Assuming it passes other checks, any creature in their list of usables (from common domestic if they have that or 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 (next time, it'll let them use mounts/pullers/pack animals of any kind as well, but I'm not sure this matters in the stock raws). 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.

|-
| USE_CAVE_ANIMALS
|
| If they don't have it, creatures with exclusively subterranean biomes are skipped.

|-
| USE_EVIL_ANIMALS
|
| Don't have it -> EVIL creatures skipped.

|-
| USE_EVIL_PLANTS
|
| As EVIL creatures for all uses of plants.

|-
| USE_EVIL_WOOD
|
| As EVIL creatures for all uses of wood.

|-
| USE_GOOD_ANIMALS
|
| Don't have it -> GOOD creatures skipped.

|-
| USE_GOOD_PLANTS
|
| As GOOD creatures for all uses of plants.

|-
| USE_GOOD_WOOD
|
| As GOOD creatures for all uses of wood.

|-
| USE_MISC_PROCESSED_WOOD_PRODUCTS
|
| If wood is available locally, and the relevant professions are permitted, controls availability of lye, charcoal, potash and pearlash.

|-
| COMMON_DOMESTIC_MOUNT
|
| If a creature has PET and the relevant COMMON_DOMESTIC_x tag (or COMMON_DOMESTIC for pets), it will be allowed if it passes the other checks.

|-
| COMMON_DOMESTIC_PACK
|
| If a creature has PET and the relevant COMMON_DOMESTIC_x tag (or COMMON_DOMESTIC for pets), it will be allowed if it passes the other checks. Also seems to be required currently for trading to occur.

|-
| COMMON_DOMESTIC_PET
|
| If a creature has PET and the relevant COMMON_DOMESTIC_x tag (or COMMON_DOMESTIC for pets), it will be allowed if it passes the other checks. Also seems to be required to have any animals at all, including those used in trading.

|-
| COMMON_DOMESTIC_PULL
|
| If a creature has PET and the relevant COMMON_DOMESTIC_x tag (or COMMON_DOMESTIC for pets), it will be allowed if it passes the other checks.

|-
| RIVER_PRODUCTS
|
| Allow civ to use river products in the goods it has available for trade.

|-
| OCEAN_PRODUCTS
|
| Allow civ to use ocean products in the goods it has available for trade.

|-
| INDOOR_FARMING
|
| Allow civ to use underground plant products in the goods it has available for trade.

|-
| OUTDOOR_FARMING
|
| Allow civ to use outdoor plant products in the goods it has available for trade.

|-
| CLOTHING
|
| Civ members will attempt to wear clothing.

|-
| SUBTERRANEAN_CLOTHING
|
| Will wear things made of spider silk and other subterranean materials.

|-
| EQUIPMENT_IMPROVEMENTS
|
| Adds decorations to equipment based on the level of the generated unit. Also improves item quality.

|-
| IMPROVED_BOWS
|
| Adds decorations to weapons generated for bowman and master bowman. An elf hack.

|-
| METAL_PREF
|
| Allows the entity to use the metal with the highest values for DAMAGE_PERC or BLOCK_PERC without DEEP. Currently only dwarves have this token. Without this token, the entity will use the best metal below or equal to 100%.

|-
| STONE_PREF
|
| Enables creatures of this entity to bring stones in trade. Also seems to enable the use of metals smelted from ore, such as iron or copper.

|-
| WOOD_WEAPONS
|
| Causes members to be able to use wooden weapons.

|-
| WOOD_ARMOR
|
| Causes members to be able to use wooden armor.

|-
| GEM_PREF
|
| Enables creatures of this entity to bring gems in trade.

|-
| INDOOR_WOOD
|
| Allow civ to trade subterranean wood types, such as tower-cap and fungiwood logs.

|-
| OUTDOOR_WOOD
|
| Allow civ to use outdoor wood types, such as mangrove and oak.

|}

== Tissue Styling Related Tokens ==
{| {{prettytable}}
|- bgcolor="#ddd"
! Token
! Arguments
! Description

|-
| TISSUE_STYLE
|
*tissue???
| Presumably selects tissue to set cultural style parameters for. Needs testing.

|-
| TS_MAINTAIN_LENGTH
|
*length?
*???
| Presumably sets culturally preferred tissue length for selected tissue. Needs testing.

|-
| TS_PREFERRED_SHAPING
| ???
| Presumably sets culturally preferred tissue shapings for selected tissue. Needs testing.

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

v0.31:Tool

2011-03-05T20:20:41Z

Bohandas: Added See Also section

{{av}}

'''Tools''' are objects used for mundane purposes by civilians and {{L|night creature}}s. Some tools can also be used as {{L|weapon}}s, and others can be used by your dwarves in Fortress mode.

==Tools Usable as Weapons==
{| class="wikitable" border="border"
! Type
! Size
! Attack
! {{L|Attack Type}}
! Contact Area
! Penetration
! Velocity
! Skill Used
|- valign="top"
|rowspan="3"| Carving knife
|rowspan="3"| 150
| Slash || Edge || 800 || 600 || 1.25x
|rowspan="3"| Dagger
|-
| Stab || Edge || 4 || 800 || 1x
|-
| Handle strike || Blunt || 15 || (400) || 1x
|- valign="top"
|rowspan="3"| Boning knife
|rowspan="3"| 50
| Slash || Edge || 500 || 300 || 1.25x
|rowspan="3"| Dagger
|-
| Stab || Edge || 2 || 400 || 1x
|-
| Handle strike || Blunt || 10 || (200) || 1x
|- valign="top"
|rowspan="3"| Slicing knife
|rowspan="3"| 150
| Slash || Edge || 900 || 700 || 1.25x
|rowspan="3"| Dagger
|-
| Stab || Edge || 3 || 900 || 1x
|-
| Handle strike || Blunt || 15 || (400) || 1x
|- valign="top"
|rowspan="3"| Meat cleaver
|rowspan="3"| 300
| Hack || Edge || 800 || 400 || 1.25x
|rowspan="3"| Axe
|-
| Flat slap || Blunt || 800 || (400) || 1.25x
|-
| Handle strike || Blunt || 20 || (400) || 1x
|- valign="top"
|rowspan="2"| Carving fork
|rowspan="2"| 150
| Stab || Edge || 1 || 100 || 1x
|rowspan="2"| Dagger
|-
| Handle strike || Blunt || 15 || 400 || 1x
|}

==Other Tools==

{| class="wikitable" border="border"
|-
! Type
! Tile
! Size
! Material
! Capacity
! Usage
|-
| Cauldron || {{Tile|ô|7:1}} || 4000 || Metal || 100000 || Liquid cooking
|-
| Ladle || {{Tile|♪|7:1}} || 100 || Metal || n/a || Liquid scoop
|-
| Bowl || {{Tile|°|7:1}} || 100 || Stone || 3000 || Meal container
|-
| Mortar || {{Tile|°|7:1}} || 100 || Stone || 1000 || Grind powder, receptacle
|-
| Pestle || {{Tile|/|7:1}} || 20 || Stone || n/a || Grind powder, grinder
|-
| Nest box || {{Tile|◘|7:1}} || 1000 || Any Hard || 2000 || Nest box
|-
| Jug || {{Tile|σ|7:1}} || 300 || Any Hard || 10000 || Liquid container
|-
| Large pot || {{Tile|Φ|7:1}} || 5000 || Any Hard || 60000 || Food storage
|-
| Hive || {{Tile|▬|7:1}} || 2000 || Any Hard || 5000 || Hive
|-
| Honeycomb || {{Tile|∞|7:1}} || 1000 || n/a || n/a || n/a
|}

Hard materials include stone, metal, wood, and glass.

==See Also==
* [[DF2010:Tool token]]

v0.31:Creature variation token

2011-03-01T20:10:44Z

Bohandas: Added to Modding and Token categories.

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

|-
| CREATURE_VARIATION
| ?
| ?

|-
| CV_ADD_TAG
| ?
| ?

|-
| CV_CONVERT_TAG
| ?
| ?

|-
| CV_REMOVE_TAG
| ?
| ?

|-
| CV_NEW_TAG
| ?
| ?

|-
| CVCT_MASTER
| ?
| ?

|-
| CVCT_REPLACEMENT
| ?
| ?

|-
| CVCT_TARGET
| ?
| ?

|}

This article is a stub. You can help Magmawiki by expanding it.

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

v0.31:Creature variation token

2011-03-01T20:08:54Z

Bohandas: Created page. Created Table. Listed tokens from string dump (list may be out of date because string dump is out of date).

v0.31:Skill token

2011-03-01T19:48:28Z

Bohandas: Added the 31.19 skill tokens. Put them in a new table because it is unclear what order, if any, the current table is in (BTW, someone should reorganize the skill list into more sensible order)

{{av}}

A list of all skill tokens, generally used in {{L|reaction}}s.

{| {{prettytable}}
|- style='background-color:#ddd'
! ID
! Token
! Skill
|-
|0||MINING||Miner
|-
|1||WOODCUTTING||Wood Cutter
|-
|2||CARPENTRY||Carpenter
|-
|3||DETAILSTONE||Engraver
|-
|4||MASONRY||Mason
|-
|5||ANIMALTRAIN||Animal Trainer
|-
|6||ANIMALCARE||Animal Caretaker
|-
|7||DISSECT_FISH||Fish Dissector
|-
|8||DISSECT_VERMIN||Animal Dissector
|-
|9||PROCESSFISH||Fish Cleaner
|-
|10||BUTCHER||Butcher
|-
|11||TRAPPING||Trapper
|-
|12||TANNER||Tanner
|-
|13||WEAVING||Weaver
|-
|14||BREWING||Brewer
|-
|15||ALCHEMY||Alchemist
|-
|16||CLOTHESMAKING||Clothier
|-
|17||MILLING||Miller
|-
|18||PROCESSPLANTS||Thresher
|-
|19||CHEESEMAKING||Cheese Maker
|-
|20||MILK||Milker
|-
|21||COOK||Cook
|-
|22||PLANT||Grower
|-
|23||HERBALISM||Herbalist
|-
|24||FISH||Fisherman
|-
|25||SMELT||Furnace Operator
|-
|26||EXTRACT_STRAND||Strand Extractor
|-
|27||FORGE_WEAPON||Weaponsmith
|-
|28||FORGE_ARMOR||Armorsmith
|-
|29||FORGE_FURNITURE||Metalsmith
|-
|30||CUTGEM||Gem Cutter
|-
|31||ENCRUSTGEM||Gem Setter
|-
|32||WOODCRAFT||Wood Crafter
|-
|33||STONECRAFT||Stone Crafter
|-
|34||METALCRAFT||Metal Crafter
|-
|35||GLASSMAKER||Glassmaker
|-
|36||LEATHERWORK||Leatherworker
|-
|37||BONECARVE||Bone Carver
|-
|38||AXE||Axeman
|-
|39||SWORD||Swordsman
|-
|40||DAGGER||Knife User
|-
|41||MACE||Maceman
|-
|42||HAMMER||Hammerman
|-
|43||SPEAR||Spearman
|-
|44||CROSSBOW||Crossbowman
|-
|45||SHIELD||Shield User
|-
|46||ARMOR||Armor User
|-
|47||SIEGECRAFT||Siege Engineer
|-
|48||SIEGEOPERATE||Siege Operator
|-
|49||BOWYER||Bowyer
|-
|50||PIKE||Pikeman
|-
|51||WHIP||Lasher
|-
|52||BOW||Bowman
|-
|53||BLOWGUN||Blowgunner
|-
|54||THROW||Thrower
|-
|55||MECHANICS||Mechanic
|-
|56||MAGIC_NATURE||Druid
|-
|57||SNEAK||Ambusher
|-
|58||DESIGNBUILDING||Building Designer
|-
|59||DRESS_WOUNDS||Wound Dresser
|-
|60||DIAGNOSE||Diagnostician
|-
|61||SURGERY||Surgeon
|-
|62||SET_BONE||Bone Doctor
|-
|63||SUTURE||Suturer
|-
|64||CRUTCH_WALK||Crutch-walker
|-
|65||WOOD_BURNING||Wood Burner
|-
|66||LYE_MAKING||Lye Maker
|-
|67||SOAP_MAKING||Soaper
|-
|68||POTASH_MAKING||Potash Maker
|-
|69||DYER||Dyer
|-
|70||OPERATE_PUMP||Pump Operator
|-
|71||SWIMMING||Swimmer
|-
|72||PERSUASION||Persuader
|-
|73||NEGOTIATION||Negotiator
|-
|74||JUDGING_INTENT||Judge of Intent
|-
|75||APPRAISAL||Appraiser
|-
|76||ORGANIZATION||Organizer
|-
|77||RECORD_KEEPING||Record Keeper
|-
|78||LYING||Liar
|-
|79||INTIMIDATION||Intimidator
|-
|80||CONVERSATION||Conversationalist
|-
|81||COMEDY||Comedian
|-
|82||FLATTERY||Flatterer
|-
|83||CONSOLE||Consoler
|-
|84||PACIFY||Pacifier
|-
|85||TRACKING||Tracker
|-
|86||KNOWLEDGE_ACQUISITION||Student
|-
|87||CONCENTRATION||Concentration
|-
|88||DISCIPLINE||Discipline
|-
|89||SITUATIONAL_AWARENESS||Observer
|-
|90||WRITING||Wordsmith
|-
|91||PROSE||Writer
|-
|92||POETRY||Poet
|-
|93||READING||Reader
|-
|94||SPEAKING||Speaker
|-
|95||COORDINATION||Coordination
|-
|96||BALANCE||Balance
|-
|97||LEADERSHIP||Leader
|-
|98||TEACHING||Teacher
|-
|99||MELEE_COMBAT||Fighter
|-
|100||RANGED_COMBAT||Archer
|-
|101||WRESTLING||Wrestler
|-
|102||BITE||Biter
|-
|103||GRASP_STRIKE||Striker
|-
|104||STANCE_STRIKE||Kicker
|-
|105||DODGING||Dodger
|-
|106||MISC_WEAPON||Misc. Object User
|-
|107||KNAPPING||Knapper
|-
|108||MILITARY_TACTICS||Military Tactics
|}

==DF v31.19 New Skills==
(in a seperate table because the ordering of the existing table is unclear)
{| {{prettytable}}
|- style='background-color:#ddd'
! Token
! Skill

|-
|BEEKEEPING||beekeeper(?)
|-
|GLAZING||glazer(?)
|-
|POTTERY||potter(?)
|-
|SHEARING||shearer(?)
|-
|SPINNING||spinner(?)
|-
|WAX_WORKING||waxworker(?)
|}

{{Category|Modding}}

v0.31:Tissue definition token

2011-03-01T02:40:38Z

Bohandas: Added See Also section

{{quality|Fine|21:41, 22 February 2011 (UTC)}}{{av}}

__TOC__

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

|-
| TISSUE_NAME
|
*name
*value
|name = name.
value = plural name, NP (No Plural) or STP (Standard Plural, adds an 's' on the end).

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

|-
| RELATIVE_THICKNESS
|
*value
| The thickness of the tissue. A higher thickness is harder to penetrate.

|-
| HEALING_RATE
|
*value
| Lower is faster. Omitting the token will result in a tissue that never heals.

|-
| VASCULAR
|
*value
| Related to how much said tissue bleeds. Higher = More bleeding
(Which is why the heart has the highest value.)

|-
| PAIN_RECEPTORS
|
*value
| Related to how much pain your character will suffer when said tissue is damaged. Higher = More pain when damaged
(Which is why the bone tissue has a much higher value than other tissues. A broken bone hurts a lot more than a cut.)

|-
| THICKENS_ON_STRENGTH
| N/A
| The thickness of the tissue increases when character strength increases.

|-
| THICKENS_ON_ENERGY_STORAGE
| N/A
| Thickness of said tissue increases when the character eats?

|-
| ARTERIES
| N/A
| The tissue contains arteries

|-
| SCARS
| N/A
| Simply whether or not the tissue will be scarred once healed.

|-
| STRUCTURAL
| N/A
|

|-
| CONNECTIVE_TISSUE_ANCHOR
| N/A
|

|-
| SETTABLE
| N/A
| The tissue can be set if broken.

|-
| SPLINTABLE
| N/A
| The tissue can be wrapped in a splint if broken.

|-
| FUNCTIONAL
|
|

|-
| NERVOUS
|
|

|-
| THOUGHT
|
|

|-
| MUSCULAR
| N/A
|

|-
| SMELL
|
|

|-
| HEAR
|
|

|-
| FLIGHT
|
|

|-
| BREATHE
|
|

|-
| SIGHT
|
|

|-
| CONNECTS
|
|

|-
| MAJOR_ARTERIES
|
|

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

|-
| COSMETIC
|
|

|-
| STYLEABLE
| N/A
| The tissue can be styled as per a tissue style (defined in an {{L|Entity_token|entity}} entry)

|-
| TISSUE_SHAPE
|
*value
| Value can be LAYER, STRANDS or FEATHERS.

|-
| SUBORDINATE_TO_TISSUE
|
*value
|

|-
| TISSUE_MAT_STATE
|
*SOLID, LIQUID, or GAS
(possibly others, such as POWDER as well. Needs testing.)
| Apparently sets/forces default material state for the selected tissue.

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

|}

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

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

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

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

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

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

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

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

|}

==Defaults==
Default values (as of 0.31.14)
{| {{prettytable}} style="margin: 1em 1em 1em 0; background: #f9f9f9; border: 1px #aaa solid; border-collapse: collapse; font-size: 70%;"
|- bgcolor="#999999"
! style="font-size: 150%;"| TISSUE_TEMPLATE !! TISSUE_NAME !! TISSUE_MATERIAL !! TISSUE_MAT_STATE !! RELATIVE_THICKNESS !! HEALING_RATE !! VASCULAR !! PAIN_RECEPTORS !! SUBORDINATE_TO_TISSUE !! INSULATION !! TISSUE_SHAPE
|-
| SKIN_TEMPLATE || skin:NP || LOCAL_CREATURE_MAT:SKIN || || 1 || 100 || 1 || 5 || || || LAYER
|-
| FAT_TEMPLATE || fat:NP || LOCAL_CREATURE_MAT:FAT || || 1 || 100 || 3 || 5 || || 100 || LAYER
|-
| MUSCLE_TEMPLATE || muscle:muscles || LOCAL_CREATURE_MAT:MUSCLE || || 3 || 100 || 5 || 5 || || || LAYER
|-
| BONE_TEMPLATE || bone:NP || LOCAL_CREATURE_MAT:BONE || || 2 || 1000 || 3 || 50 || || || LAYER
|-
| SHELL_TEMPLATE || shell:NP || LOCAL_CREATURE_MAT:SHELL || || 2 || 1000 || || || || || LAYER
|-
| HORN_TEMPLATE || horn:NP || LOCAL_CREATURE_MAT:HORN || || 2 || || || || || || LAYER
|-
| HOOF_TEMPLATE || hoof:NP || LOCAL_CREATURE_MAT:HOOF || || 2 || || || || || || LAYER
|-
| CARTILAGE_TEMPLATE || cartilage:NP || LOCAL_CREATURE_MAT:CARTILAGE || || 2 || || || || || || LAYER
|-
| HAIR_TEMPLATE || hair:NP || LOCAL_CREATURE_MAT:HAIR || || 1 || || || || SKIN || 100 || STRANDS
|-
| CHEEK_WHISKERS_TEMPLATE || cheek whisker:STP || LOCAL_CREATURE_MAT:HAIR || || 2 || || || || SKIN || || STRANDS
|-
| CHIN_WHISKERS_TEMPLATE || chin whisker:STP || LOCAL_CREATURE_MAT:HAIR || || 2 || || || || SKIN || || STRANDS
|-
| MOUSTACHE_TEMPLATE || moustache:NP || LOCAL_CREATURE_MAT:HAIR || || 2 || || || || SKIN || || STRANDS
|-
| SIDEBURNS_TEMPLATE || sideburns:NP || LOCAL_CREATURE_MAT:HAIR || || 2 || || || || SKIN || || STRANDS
|-
| EYEBROW_TEMPLATE || eyebrow:NP || LOCAL_CREATURE_MAT:HAIR || || 2 || || || || SKIN || || STRANDS
|-
| EYELASH_TEMPLATE || eyelash:eyelashes || LOCAL_CREATURE_MAT:HAIR || || 2 || || || || SKIN || || STRANDS
|-
| FEATHER_TEMPLATE || feather:STP || LOCAL_CREATURE_MAT:FEATHER || || 2 || || || || SKIN || 100 || FEATHERS
|-
| SCALE_TEMPLATE || scale:STP || LOCAL_CREATURE_MAT:SCALE || || 1 || 100 || 1 || 5 || || || SCALES
|-
| NAIL_TEMPLATE || nail:NP || LOCAL_CREATURE_MAT:NAIL || || 2 || || || || || || LAYER
|-
| CLAW_TEMPLATE || claw:NP || LOCAL_CREATURE_MAT:CLAW || || 2 || || || || || || LAYER
|-
| TALON_TEMPLATE || talon:NP || LOCAL_CREATURE_MAT:TALON || || 2 || || || || || || LAYER
|-
| TOOTH_TEMPLATE || tooth:NP || LOCAL_CREATURE_MAT:TOOTH || || 2 || || || || || || LAYER
|-
| IVORY_TEMPLATE || ivory:NP || LOCAL_CREATURE_MAT:IVORY || || 2 || || || || || || LAYER
|-
| EYE_TEMPLATE || eye tissue:NP || LOCAL_CREATURE_MAT:EYE || || 1 || 100 || 3 || 5 || || || LAYER
|-
| NERVE_TEMPLATE || nervous tissue:NP || LOCAL_CREATURE_MAT:NERVE || || 1 || || 3 || || || || LAYER
|-
| BRAIN_TEMPLATE || brain tissue:NP || LOCAL_CREATURE_MAT:BRAIN || || 1 || || 3 || || || || LAYER
|-
| LUNG_TEMPLATE || lung tissue:NP || LOCAL_CREATURE_MAT:LUNG || || 1 || 100 || 8 || 5 || || || LAYER
|-
| HEART_TEMPLATE || heart tissue:NP || LOCAL_CREATURE_MAT:HEART || || 1 || 100 || 10 || 5 || || || LAYER
|-
| LIVER_TEMPLATE || liver tissue:NP || LOCAL_CREATURE_MAT:LIVER || || 1 || 100 || 8 || 5 || || || LAYER
|-
| GUT_TEMPLATE || gut:NP || LOCAL_CREATURE_MAT:GUT || || 1 || 100 || 3 || 5 || || || LAYER
|-
| STOMACH_TEMPLATE || stomach tissue:NP || LOCAL_CREATURE_MAT:STOMACH || || 1 || 100 || 3 || 5 || || || LAYER
|-
| PANCREAS_TEMPLATE || pancreatic tissue:NP || LOCAL_CREATURE_MAT:PANCREAS || || 1 || 100 || 3 || 5 || || || LAYER
|-
| SPLEEN_TEMPLATE || spleen tissue:NP || LOCAL_CREATURE_MAT:SPLEEN || || 1 || 100 || 5 || 5 || || || LAYER
|-
| KIDNEY_TEMPLATE || kidney tissue:NP || LOCAL_CREATURE_MAT:KIDNEY || || 1 || 100 || 8 || 5 || || || LAYER
|-
| FLAME_TEMPLATE || flames:NP || LOCAL_CREATURE_MAT:FLAME || GAS || 1 || || || || || || LAYER
|-
| CHITIN_TEMPLATE || chitin:NP || LOCAL_CREATURE_MAT:CHITIN || || 1 || 100 || 1 || 5 || || || LAYER
|- bgcolor="#999999"
! style="font-size: 150%;"| TISSUE_TEMPLATE !! TISSUE_NAME !! TISSUE_MATERIAL !! TISSUE_MAT_STATE !! RELATIVE_THICKNESS !! HEALING_RATE !! VASCULAR !! PAIN_RECEPTORS !! SUBORDINATE_TO_TISSUE !! INSULATION !! TISSUE_SHAPE
|}

Default flags (as of 0.31.14)
{| {{prettytable}}
|- bgcolor="#999999" style="font-size: 70%;"
! style="font-size: 150%;"| TISSUE_TEMPLATE !! THICKENS_ON_ENERGY_STORAGE !! THICKENS_ON_STRENGTH !! ARTERIES !! SCARS !! MUSCULAR !! FUNCTIONAL !! STRUCTURAL !! CONNECTIVE_TISSUE_ANCHOR !! CONNECTS !! SETTABLE !! SPLINTABLE !! COSMETIC !! STYLEABLE
|-
| SKIN_TEMPLATE || || || || X || || || || || X || || || ||
|-
| FAT_TEMPLATE || X || || || X || || || || || X || || || ||
|-
| MUSCLE_TEMPLATE || || X || X || X || X || || || || X || || ||
|-
| BONE_TEMPLATE || || || || || || || X || X || X || X || X || ||
|-
| SHELL_TEMPLATE || || || || || || || X || || X || X || X || ||
|-
| HORN_TEMPLATE || || || || || || || X || || X || || ||
|-
| HOOF_TEMPLATE || || || || || || || X || || X || || ||
|-
| CARTILAGE_TEMPLATE || || || || || || || X || || X || || ||
|-
| HAIR_TEMPLATE || || || || || || || || || || || || X || X
|-
| CHEEK_WHISKERS_TEMPLATE || || || || || || || || || || || || X || X
|-
| CHIN_WHISKERS_TEMPLATE || || || || || || || || || || || || X || X
|-
| MOUSTACHE_TEMPLATE || || || || || || || || || || || || X || X
|-
| SIDEBURNS_TEMPLATE || || || || || || || || || || || || X || X
|-
| EYEBROW_TEMPLATE || || || || || || || || || || || || X || X
|-
| EYELASH_TEMPLATE || || || || || || || || || || || || X || X
|-
| FEATHER_TEMPLATE || || || || || || || || || || || ||
|-
| SCALE_TEMPLATE || || || || X || || || || || X || || || ||
|-
| NAIL_TEMPLATE || || || || || || || X || || X || || || ||
|-
| CLAW_TEMPLATE || || || || || || || X || || X || || || ||
|-
| TALON_TEMPLATE || || || || || || || X || || X || || || ||
|-
| TOOTH_TEMPLATE || || || || || || || X || || X || || || ||
|-
| IVORY_TEMPLATE || || || || || || || X || || X || || || ||
|-
| EYE_TEMPLATE || || || || X || X || X || X || || || || ||
|-
| NERVE_TEMPLATE || || || || X || || X || X || || || || ||
|-
| BRAIN_TEMPLATE || || || || X || X || X || X || || || || ||
|-
| LUNG_TEMPLATE || || || || X || X || X || X || || || || ||
|-
| HEART_TEMPLATE || || || || X || X || X || X || || || || ||
|-
| LIVER_TEMPLATE || || || || X || X || X || X || || || || ||
|-
| GUT_TEMPLATE || || || || X || X || X || X || || || || ||
|-
| STOMACH_TEMPLATE || || || || X || X || X || X || || || || ||
|-
| PANCREAS_TEMPLATE || || || || X || X || X || X || || || || ||
|-
| SPLEEN_TEMPLATE || || || || X || X || X || X || || || || ||
|-
| KIDNEY_TEMPLATE || || || || X || X || X || X || || || || ||
|-
| FLAME_TEMPLATE || || || || || X || X || X || || X || || ||
|-
| CHITIN_TEMPLATE || || || || X || || || X || X || X || X || X || ||

|- bgcolor="#999999" style="font-size: 70%;"
! style="font-size: 150%;"| TISSUE_TEMPLATE !! THICKENS_ON_ENERGY_STORAGE !! THICKENS_ON_STRENGTH !! ARTERIES !! SCARS !! MUSCULAR !! FUNCTIONAL !! STRUCTURAL !! CONNECTIVE_TISSUE_ANCHOR !! CONNECTS !! SETTABLE !! SPLINTABLE !! COSMETIC !! STYLEABLE
|}

==See Also==
*Material definition token

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

v0.31:Inorganic material definition token

2011-03-01T02:39:38Z

Bohandas: Added See Also section

{{av}}

The following tokens can be used in inorganic material definitions, generally those for stones, gems, and metals. They cannot be used with materials attached to plants or creatures.

{| {{prettytable}}
|- style='background-color:#ddd'
! Token
! Description
|-
|[METAL_ORE:metal:chance]||Allows the ore to be {{L|smelter|smelted}} into metal. Multiple tokens allow multiple types of metal to be smelted from a single ore.
|-
|[THREAD_METAL:metal:chance]||Allows strands to be extracted from the metal at a {{L|craftsdwarf's workshop}}.
|-
|[DEEP_SURFACE]||Causes the stone to line the landscape of {{L|Hell}}. Used for {{L|slade}}.
|-
|[DEEP_SPECIAL]||Causes the stone to form hollow tubes leading to Hell. Used for {{L|raw adamantine}}
|-
|[AQUIFER]||Allows the stone to support an {{L|aquifer}}.
|-
|[METAMORPHIC]||Classifies the stone as a {{L|metamorphic layer}}.
|-
|[SEDIMENTARY]||Classifies the stone as a {{L|sedimentary layer}}.
|-
|[SOIL]||Classifies the material as a {{L|soil}} layer, allowing it to appear in (almost) any biome. Mining is faster and produces no stones.
|-
|[SOIL_OCEAN]||Classifies the material as a {{L|soil|pelagic sediment}} layer. Mining is faster and produces no stones.
|-
|[SOIL_SAND]||Classifies the material as a {{L|sand}} layer, allowing it to appear in {{L|sand desert}}s and {{L|ocean}}s. Mining is faster and produces no stones. Sand layers can also be used used for making {{L|glass}}. Can be combined with [SOIL].
|-
|[SEDIMENTARY_OCEAN_SHALLOW]||Allows an already [SEDIMENTARY] stone layer to appear underneath shallow ocean regions.
|-
|[SEDIMENTARY_OCEAN_DEEP]||Allows an already [SEDIMENTARY] stone layer to appear underneath deep ocean regions.
|-
|[IGNEOUS_INTRUSIVE]||Classifies the stone as an {{L|igneous intrusive layer}}.
|-
|[IGNEOUS_EXTRUSIVE]||Classifies the stone as an {{L|igneous extrusive layer}}.
|-
|[ENVIRONMENT:class:type:freq]||Specifies what types of layers will contain this mineral. See below.
|-
|[ENVIRONMENT_SPEC:stone:type:freq]||Specifies which specific minerals will contain this mineral. See below.
|-
|[LAVA]||Causes the stone to line the edges of {{L|magma}} pools and volcanoes, and causes the stone to be formed when {{L|water}} and {{L|magma}} are mixed.
|-
|[WAFERS]||Used on metals, causes the metal to be made into wafers instead of {{L|bar}}s.
|-
|[UNDIGGABLE]||Prevents the stone from being mined out.
|}

==ENVIROMENT and ENVIRONMENT_SPEC==

Format:
* [ENVIRONMENT:<class>:<inclusion type>:<frequency>]
** Class may be ALL_STONE, IGNEOUS_ALL, SOIL, SOIL_OCEAN, SOIL_SAND, METAMORPHIC, SEDIMENTARY, IGNEOUS_INTRUSIVE, IGNEOUS_EXTRUSIVE, or ALLUVIAL.
*** ALL_STONE is equivalent to METAMORPHIC, SEDIMENTARY, IGNEOUS_INTRUSIVE, IGNEOUS_EXTRUSIVE, and ALLUVIAL.
*** IGNEOUS_ALL is equivalent to IGNEOUS_INTRUSIVE and IGNEOUS_EXTRUSIVE.
* [ENVIRONMENT_SPEC:<id>:<inclusion type>:<frequency>]

The inclusion type can be CLUSTER, CLUSTER_SMALL, CLUSTER_ONE, or VEIN. CLUSTERs are large ovoids that occupy their entire local map tile if present. CLUSTER_SMALL inclusions are blobs of 3-9 tiles; CLUSTER_ONE inclusions are single tiles; and VEINs are large streaks.

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

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

v0.31:Material definition token

2011-03-01T02:38:11Z

Bohandas: Added See Also section

{{av}}

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

|-
| ABSORPTION
|
*value
| The material's tendency to absorb liquids. Containers made of materials with nonzero absorption cannot hold liquids unless they have been glazed.

|-
| ITEMS_HARD
|
|

|-
| ITEMS_QUERN
|
| Querns and millstones can be made out of this material.{{verify}}

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

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

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

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

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

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

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

|-
| ITEMS_BARRED
|
| {{L|Bone}} items (clothes with [BARRED]) can be made from this material.

|-
| ITEMS_SCALED
|
| {{L|Shell}} items (clothes with [SCALED]) can be made from this material.

|-
| ITEMS_LEATHER
|
| {{L|Leather}} items (clothes with [LEATHER]) can be made from this material.

|-
| ITEMS_SOFT
|
|

|-
| ITEMS_DELICATE
|
| Used internally by amber and coral

|-
| ITEMS_METAL
|
|

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

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

|-
| IS_GLASS
|
| Used internally by green glass, clear glass, and crystal glass

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

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

|-
| ALCOHOL_PLANT
|
| Classifies the material as plant alcohol, allowing it to be stored in food stockpiles under "Drink (Plant)".

|-
| ALCOHOL_CREATURE
|
| Classifies the material as creature alcohol, allowing it to be stored in food stockpiles under "Drink (Animal)".

|-
| CHEESE_PLANT
|
| Classifies the material as plant cheese, allowing it to be stored in food stockpiles under "Cheese (Plant)".

|-
| CHEESE_CREATURE
|
| Classifies the material as creature cheese, allowing it to be stored in food stockpiles under "Cheese (Animal)".

|-
| POWDER_MISC_PLANT
|
| Classifies the material as plant powder, allowing it to be stored in food stockpiles under "Milled Plant".

|-
| POWDER_MISC_CREATURE
|
| Classifies the material as creature powder, allowing it to be stored in food stockpiles under "Bone Meal".

|-
| STOCKPILE_GLOB
|
| Permits globs of the material in solid form to be stored in food stockpiles under "Fat" - without it, dwarves will come by and "clean" the items, destroying them.

|-
| STOCKPILE_GLOB_PASTE
|
| Permits globs of the material in paste form to be stored in food stockpiles under "Paste".

|-
| STOCKPILE_GLOB_PRESSED
|
| Permits globs of the material in pressed form to be stored in food stockpiles under "Pressed Material".

|-
| LIQUID_MISC_PLANT
|
| Classifies the material as a plant extract, allowing it to be stored in food stockpiles under "Extract (Plant)".

|-
| LIQUID_MISC_CREATURE
|
| Classifies the material as a creature extract, allowing it to be stored in food stockpiles under "Extract (Animal)".

|-
| LIQUID_MISC_OTHER
|
| Classifies the material as a miscellaneous liquid, allowing it to be stored in food stockpiles under "Misc. Liquid".

|-
| STRUCTURAL_PLANT_MAT
|
| Classifies the material as plant, allowing it to be stored in food stockpiles under "Plants".

|-
| SEED_MAT
|
| Classifies the material as plant seed, allowing it to be stored in food stockpiles under "Seeds".{{verify}}

|-
| LEAF_MAT
|
| Classifies the material as plant leaf, allowing it to be stored in food stockpiles under "Leaves".{{verify}}

|-
| BONE
|
| Classifies the material as bone, allowing it to be used by craftsdwarves.{{verify}}

|-
| THREAD_PLANT
|
| Classifies the material as plant fiber, weavable into cloth.{{verify}}

|-
| TOOTH
|
| Classifies the material as tooth, allowing it to be used by craftsdwarves.{{verify}}

|-
| PEARL
|
| Classifies the material as pearl, allowing it to be used by craftsdwarves.{{verify}}

|-
| HORN
|
| Classifies the material as horn, allowing it to be used by craftsdwarves.{{verify}}

|-
| SHELL
|
| Classifies the material as shell, allowing it to be used by craftsdwarves.{{verify}}

|-
| LEATHER
|
| Classifies the material as leather, allowing it to be used by craftsdwarves.{{verify}}

|-
| SILK
|
| Classifies the material as silk, weavable into cloth.{{verify}}

|-
| WOOD
|
| Classifies the material as wood, allowing it to be used by carpenters.{{verify}} May also make elves angry if you try to trade it to them.

|-
| SOAP
|
| Classifies the material as soap, permitting it to be stored in Bar/Block stockpiles with Soap enabled.{{verify}}

|-
| MEAT
|
| Classifies the material as edible meat.{{verify}}

|-
| GENERATES_MIASMA
|
|

|-
| ROTS
|
|

|-
| BLOOD_MAP_DESCRIPTOR
|
|

|-
| ICHOR_MAP_DESCRIPTOR
|
|

|-
| GOO_MAP_DESCRIPTOR
|
|

|-
| SLIME_MAP_DESCRIPTOR
|
|

|-
| PUS_MAP_DESCRIPTOR
|
|

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

|-
| EDIBLE_RAW
|
| Can be eaten raw.

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

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

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

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

|-
| TEMP_DIET_INFO
|
|

|-
| SLIME
|
|

|-
| ICHOR
|
|

|-
| GOO
|
|

|-
| FILTH
|
|

|-
| POWDER_DYE
|
|

|-
| ITEM_SYMBOL
|
|

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

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

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

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

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

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

|-
| EXTRACT_STORAGE
|
|

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

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

|-
| BLOCK_NAME
|
*singular
*plural
| When blocks are made of this material, they will be named via this token.

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

|-
| MATERIAL_REACTION_PRODUCT
|
*reaction reference
*{{L|material token}}
| Used with reaction raws to preserve material source from reagent to product. The first argument is used by HAS_MATERIAL_REACTION_PRODUCT and GET_MATERIAL_FROM_REAGENT in reaction raws. The remainder is a material reference, generally LOCAL_CREATURE_MAT:SUBTYPE or LOCAL_PLANT_MAT:SUBTYPE or INORGANIC:STONETYPE.
[MATERIAL_REACTION_PRODUCT:TAN_MAT:LOCAL_CREATURE_MAT:LEATHER]

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

|-
| SOAP_LEVEL
|
*value
|

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

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

|-
| UNDIGGABLE
|
| Used for a stone that cannot be dug into.

|-
| DISPLAY_UNGLAZED
|
|

|-
| YARN
|
| Classifies the material as yarn, weavable into cloth.{{verify}}
|}

==Syndrome tokens==

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

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

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

|-
| SYN_IMMUNE_CLASS
|
| makes the class of creatures immune to the syndrome

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

|-
| SYN_IMMUNE_CREATURE
| creature
| makes the creature immune to the syndrome

|-
| SYN_CONTACT
|
| syndrome can be contracted on contact (e.g. poison dust or liquid)

|-
| SYN_INHALED
|
| syndrome can be contracted by inhalation (e.g. poison vapor or gas)

|-
| SYN_INJECTED
|
| syndrome can be contracted by injection (by a creature)

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

|}

==See Also==
* [[Inorganic material definition token]]
* [[Syndrome]]
* [[Tissue definition token]]

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

v0.31:Tissue definition token

2011-02-26T04:54:23Z

Bohandas: fixed attempt to add TOC

v0.31:Tissue definition token

2011-02-26T04:53:11Z

Bohandas: Added Table of Contents and information regarding the TISSUE_LEAKS, and TISSUE_MAT_STATE tokens

{{quality|Fine|21:41, 22 February 2011 (UTC)}}{{av}}

__FORCETOC__

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

|-
| TISSUE_NAME
|
*name
*value
|name = name.
value = plural name, NP (No Plural) or STP (Standard Plural, adds an 's' on the end).

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

|-
| RELATIVE_THICKNESS
|
*value
| The thickness of the tissue. A higher thickness is harder to penetrate.

|-
| HEALING_RATE
|
*value
| Lower is faster. Omitting the token will result in a tissue that never heals.

|-
| VASCULAR
|
*value
| Related to how much said tissue bleeds. Higher = More bleeding
(Which is why the heart has the highest value.)

|-
| PAIN_RECEPTORS
|
*value
| Related to how much pain your character will suffer when said tissue is damaged. Higher = More pain when damaged
(Which is why the bone tissue has a much higher value than other tissues. A broken bone hurts a lot more than a cut.)

|-
| THICKENS_ON_STRENGTH
| N/A
| The thickness of the tissue increases when character strength increases.

|-
| THICKENS_ON_ENERGY_STORAGE
| N/A
| Thickness of said tissue increases when the character eats?

|-
| ARTERIES
| N/A
| The tissue contains arteries

|-
| SCARS
| N/A
| Simply whether or not the tissue will be scarred once healed.

|-
| STRUCTURAL
| N/A
|

|-
| CONNECTIVE_TISSUE_ANCHOR
| N/A
|

|-
| SETTABLE
| N/A
| The tissue can be set if broken.

|-
| SPLINTABLE
| N/A
| The tissue can be wrapped in a splint if broken.

|-
| FUNCTIONAL
|
|

|-
| NERVOUS
|
|

|-
| THOUGHT
|
|

|-
| MUSCULAR
| N/A
|

|-
| SMELL
|
|

|-
| HEAR
|
|

|-
| FLIGHT
|
|

|-
| BREATHE
|
|

|-
| SIGHT
|
|

|-
| CONNECTS
|
|

|-
| MAJOR_ARTERIES
|
|

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

|-
| COSMETIC
|
|

|-
| STYLEABLE
| N/A
| The tissue can be styled as per a tissue style (defined in an {{L|Entity_token|entity}} entry)

|-
| TISSUE_SHAPE
|
*value
| Value can be LAYER, STRANDS or FEATHERS.

|-
| SUBORDINATE_TO_TISSUE
|
*value
|

|-
| TISSUE_MAT_STATE
|
*SOLID, LIQUID, or GAS
(possibly others, such as POWDER as well. Needs testing.)
| Apparently sets/forces default material state for the selected tissue.

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

|}

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

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

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

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

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

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

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

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

|}

==Defaults==
Default values (as of 0.31.14)
{| {{prettytable}} style="margin: 1em 1em 1em 0; background: #f9f9f9; border: 1px #aaa solid; border-collapse: collapse; font-size: 70%;"
|- bgcolor="#999999"
! style="font-size: 150%;"| TISSUE_TEMPLATE !! TISSUE_NAME !! TISSUE_MATERIAL !! TISSUE_MAT_STATE !! RELATIVE_THICKNESS !! HEALING_RATE !! VASCULAR !! PAIN_RECEPTORS !! SUBORDINATE_TO_TISSUE !! INSULATION !! TISSUE_SHAPE
|-
| SKIN_TEMPLATE || skin:NP || LOCAL_CREATURE_MAT:SKIN || || 1 || 100 || 1 || 5 || || || LAYER
|-
| FAT_TEMPLATE || fat:NP || LOCAL_CREATURE_MAT:FAT || || 1 || 100 || 3 || 5 || || 100 || LAYER
|-
| MUSCLE_TEMPLATE || muscle:muscles || LOCAL_CREATURE_MAT:MUSCLE || || 3 || 100 || 5 || 5 || || || LAYER
|-
| BONE_TEMPLATE || bone:NP || LOCAL_CREATURE_MAT:BONE || || 2 || 1000 || 3 || 50 || || || LAYER
|-
| SHELL_TEMPLATE || shell:NP || LOCAL_CREATURE_MAT:SHELL || || 2 || 1000 || || || || || LAYER
|-
| HORN_TEMPLATE || horn:NP || LOCAL_CREATURE_MAT:HORN || || 2 || || || || || || LAYER
|-
| HOOF_TEMPLATE || hoof:NP || LOCAL_CREATURE_MAT:HOOF || || 2 || || || || || || LAYER
|-
| CARTILAGE_TEMPLATE || cartilage:NP || LOCAL_CREATURE_MAT:CARTILAGE || || 2 || || || || || || LAYER
|-
| HAIR_TEMPLATE || hair:NP || LOCAL_CREATURE_MAT:HAIR || || 1 || || || || SKIN || 100 || STRANDS
|-
| CHEEK_WHISKERS_TEMPLATE || cheek whisker:STP || LOCAL_CREATURE_MAT:HAIR || || 2 || || || || SKIN || || STRANDS
|-
| CHIN_WHISKERS_TEMPLATE || chin whisker:STP || LOCAL_CREATURE_MAT:HAIR || || 2 || || || || SKIN || || STRANDS
|-
| MOUSTACHE_TEMPLATE || moustache:NP || LOCAL_CREATURE_MAT:HAIR || || 2 || || || || SKIN || || STRANDS
|-
| SIDEBURNS_TEMPLATE || sideburns:NP || LOCAL_CREATURE_MAT:HAIR || || 2 || || || || SKIN || || STRANDS
|-
| EYEBROW_TEMPLATE || eyebrow:NP || LOCAL_CREATURE_MAT:HAIR || || 2 || || || || SKIN || || STRANDS
|-
| EYELASH_TEMPLATE || eyelash:eyelashes || LOCAL_CREATURE_MAT:HAIR || || 2 || || || || SKIN || || STRANDS
|-
| FEATHER_TEMPLATE || feather:STP || LOCAL_CREATURE_MAT:FEATHER || || 2 || || || || SKIN || 100 || FEATHERS
|-
| SCALE_TEMPLATE || scale:STP || LOCAL_CREATURE_MAT:SCALE || || 1 || 100 || 1 || 5 || || || SCALES
|-
| NAIL_TEMPLATE || nail:NP || LOCAL_CREATURE_MAT:NAIL || || 2 || || || || || || LAYER
|-
| CLAW_TEMPLATE || claw:NP || LOCAL_CREATURE_MAT:CLAW || || 2 || || || || || || LAYER
|-
| TALON_TEMPLATE || talon:NP || LOCAL_CREATURE_MAT:TALON || || 2 || || || || || || LAYER
|-
| TOOTH_TEMPLATE || tooth:NP || LOCAL_CREATURE_MAT:TOOTH || || 2 || || || || || || LAYER
|-
| IVORY_TEMPLATE || ivory:NP || LOCAL_CREATURE_MAT:IVORY || || 2 || || || || || || LAYER
|-
| EYE_TEMPLATE || eye tissue:NP || LOCAL_CREATURE_MAT:EYE || || 1 || 100 || 3 || 5 || || || LAYER
|-
| NERVE_TEMPLATE || nervous tissue:NP || LOCAL_CREATURE_MAT:NERVE || || 1 || || 3 || || || || LAYER
|-
| BRAIN_TEMPLATE || brain tissue:NP || LOCAL_CREATURE_MAT:BRAIN || || 1 || || 3 || || || || LAYER
|-
| LUNG_TEMPLATE || lung tissue:NP || LOCAL_CREATURE_MAT:LUNG || || 1 || 100 || 8 || 5 || || || LAYER
|-
| HEART_TEMPLATE || heart tissue:NP || LOCAL_CREATURE_MAT:HEART || || 1 || 100 || 10 || 5 || || || LAYER
|-
| LIVER_TEMPLATE || liver tissue:NP || LOCAL_CREATURE_MAT:LIVER || || 1 || 100 || 8 || 5 || || || LAYER
|-
| GUT_TEMPLATE || gut:NP || LOCAL_CREATURE_MAT:GUT || || 1 || 100 || 3 || 5 || || || LAYER
|-
| STOMACH_TEMPLATE || stomach tissue:NP || LOCAL_CREATURE_MAT:STOMACH || || 1 || 100 || 3 || 5 || || || LAYER
|-
| PANCREAS_TEMPLATE || pancreatic tissue:NP || LOCAL_CREATURE_MAT:PANCREAS || || 1 || 100 || 3 || 5 || || || LAYER
|-
| SPLEEN_TEMPLATE || spleen tissue:NP || LOCAL_CREATURE_MAT:SPLEEN || || 1 || 100 || 5 || 5 || || || LAYER
|-
| KIDNEY_TEMPLATE || kidney tissue:NP || LOCAL_CREATURE_MAT:KIDNEY || || 1 || 100 || 8 || 5 || || || LAYER
|-
| FLAME_TEMPLATE || flames:NP || LOCAL_CREATURE_MAT:FLAME || GAS || 1 || || || || || || LAYER
|-
| CHITIN_TEMPLATE || chitin:NP || LOCAL_CREATURE_MAT:CHITIN || || 1 || 100 || 1 || 5 || || || LAYER
|- bgcolor="#999999"
! style="font-size: 150%;"| TISSUE_TEMPLATE !! TISSUE_NAME !! TISSUE_MATERIAL !! TISSUE_MAT_STATE !! RELATIVE_THICKNESS !! HEALING_RATE !! VASCULAR !! PAIN_RECEPTORS !! SUBORDINATE_TO_TISSUE !! INSULATION !! TISSUE_SHAPE
|}

Default flags (as of 0.31.14)
{| {{prettytable}}
|- bgcolor="#999999" style="font-size: 70%;"
! style="font-size: 150%;"| TISSUE_TEMPLATE !! THICKENS_ON_ENERGY_STORAGE !! THICKENS_ON_STRENGTH !! ARTERIES !! SCARS !! MUSCULAR !! FUNCTIONAL !! STRUCTURAL !! CONNECTIVE_TISSUE_ANCHOR !! CONNECTS !! SETTABLE !! SPLINTABLE !! COSMETIC !! STYLEABLE
|-
| SKIN_TEMPLATE || || || || X || || || || || X || || || ||
|-
| FAT_TEMPLATE || X || || || X || || || || || X || || || ||
|-
| MUSCLE_TEMPLATE || || X || X || X || X || || || || X || || ||
|-
| BONE_TEMPLATE || || || || || || || X || X || X || X || X || ||
|-
| SHELL_TEMPLATE || || || || || || || X || || X || X || X || ||
|-
| HORN_TEMPLATE || || || || || || || X || || X || || ||
|-
| HOOF_TEMPLATE || || || || || || || X || || X || || ||
|-
| CARTILAGE_TEMPLATE || || || || || || || X || || X || || ||
|-
| HAIR_TEMPLATE || || || || || || || || || || || || X || X
|-
| CHEEK_WHISKERS_TEMPLATE || || || || || || || || || || || || X || X
|-
| CHIN_WHISKERS_TEMPLATE || || || || || || || || || || || || X || X
|-
| MOUSTACHE_TEMPLATE || || || || || || || || || || || || X || X
|-
| SIDEBURNS_TEMPLATE || || || || || || || || || || || || X || X
|-
| EYEBROW_TEMPLATE || || || || || || || || || || || || X || X
|-
| EYELASH_TEMPLATE || || || || || || || || || || || || X || X
|-
| FEATHER_TEMPLATE || || || || || || || || || || || ||
|-
| SCALE_TEMPLATE || || || || X || || || || || X || || || ||
|-
| NAIL_TEMPLATE || || || || || || || X || || X || || || ||
|-
| CLAW_TEMPLATE || || || || || || || X || || X || || || ||
|-
| TALON_TEMPLATE || || || || || || || X || || X || || || ||
|-
| TOOTH_TEMPLATE || || || || || || || X || || X || || || ||
|-
| IVORY_TEMPLATE || || || || || || || X || || X || || || ||
|-
| EYE_TEMPLATE || || || || X || X || X || X || || || || ||
|-
| NERVE_TEMPLATE || || || || X || || X || X || || || || ||
|-
| BRAIN_TEMPLATE || || || || X || X || X || X || || || || ||
|-
| LUNG_TEMPLATE || || || || X || X || X || X || || || || ||
|-
| HEART_TEMPLATE || || || || X || X || X || X || || || || ||
|-
| LIVER_TEMPLATE || || || || X || X || X || X || || || || ||
|-
| GUT_TEMPLATE || || || || X || X || X || X || || || || ||
|-
| STOMACH_TEMPLATE || || || || X || X || X || X || || || || ||
|-
| PANCREAS_TEMPLATE || || || || X || X || X || X || || || || ||
|-
| SPLEEN_TEMPLATE || || || || X || X || X || X || || || || ||
|-
| KIDNEY_TEMPLATE || || || || X || X || X || X || || || || ||
|-
| FLAME_TEMPLATE || || || || || X || X || X || || X || || ||
|-
| CHITIN_TEMPLATE || || || || X || || || X || X || X || X || X || ||

|- bgcolor="#999999" style="font-size: 70%;"
! style="font-size: 150%;"| TISSUE_TEMPLATE !! THICKENS_ON_ENERGY_STORAGE !! THICKENS_ON_STRENGTH !! ARTERIES !! SCARS !! MUSCULAR !! FUNCTIONAL !! STRUCTURAL !! CONNECTIVE_TISSUE_ANCHOR !! CONNECTS !! SETTABLE !! SPLINTABLE !! COSMETIC !! STYLEABLE
|}

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

v0.31:Creature token

2011-02-26T04:44:15Z

Bohandas: Eliminated some redundancies from my previous edit

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

Tentative at best in some cases.

__NOTOC__

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

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

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

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

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

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

|-
| APP_MOD_DESC_RANGE
| ?
| ?

|-
| APP_MOD_GENETIC_MODEL
|
|

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

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

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

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

|-
| APPLY_CURRENT_CREATURE_VARIATION
|
| Applies loaded Creature Variation

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

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

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

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

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

|}

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

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

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

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

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

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

|-
| BLOOD, PUS, OTHER MATERIAL state definition
|
* {{L|material token}}
*matter state (LIQUID, GAS, SOLID)
| Controls bleeding behaviour

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

|-
| CASTE
|
*name
| defines a caste

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

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

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

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

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

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

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

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

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

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

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

|-
| CHANGE_BODY_SIZE_PERC
|
|

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

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

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

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

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

|-
| COLONY_EXTERNAL
|
| Caste hovers around colony.

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

|-
| FEATURE_ATTACK_GROUP
|
| Found on subterranean animalmen.

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

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

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

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

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

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

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

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

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

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

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

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

|-
| GENERATED
|
| Found on procedurally generated creatures like {{L|Forgotten beast}}s, (biome name) {{L|titan}}s, {{L|Demon}}s, and {{L|night creature}}s.

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

|-
| LAYS_UNUSUAL_EGGS
|
* {{L|item token}}
* {{L|material token}}
| Creature lays a particular item instead of regular eggs. As of v0.31.19, this tag only makes the game crash.

|-
| LIGAMENTS
|
* {{L|material token}}
*healing rate
| Defines the material and healing rate of ligaments.

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

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

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

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

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

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

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

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

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

|-
| MALE
|
| all male

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

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

|-
| MATERIAL_BREATH_ATTACK
|
* {{L|material token}}
* breath attack type (TRAILING_DUST_FLOW, TRAILING_VAPOR_FLOW, TRAILING_GAS_FLOW, SOLID_GLOB, LIQUID_GLOB, UNDIRECTED_GAS, UNDIRECTED_VAPOR, UNDIRECTED_DUST)
| Creates an attack referencing a material, using a given type of breath attack.

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

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

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

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

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

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

|-
| MILKABLE
|
* {{L|material token}}
* frequency
| Allows the creature to be milked.

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

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

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

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

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

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

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

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

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

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

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

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

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

|-
| NO_DIZZINESS
|
| Creature cannot become dizzy

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

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

|-
| NO_FEVERS
|
| Creature cannot suffer fevers

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

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

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

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

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

|-
| NOBONES
|
| Creature has no bones.

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

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

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

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

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

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

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

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

|-
| NORMAL
| ???
| Unknown. Found in string dump.

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

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

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

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

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

|-
| NOT_BUTCHERABLE
|
| Cannot be butchered

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

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

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

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

|-
| PATTERNFLIER
|
|

|-
| PEARL
|
| Creature will generate pearls.

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

|-
| PERSONALITY
|
*ATTRIBUTE
*lowest:median:highest
| Determines the range and chance of personality traits. Standard is 0:50:100. See [[DF2010:Personality_trait|Personality traits]] for more info.

|-
| PET
|
| Allows the creature to be tamed.

|-
| PET_EXOTIC
|
| You need a Dungeon master noble in your fortress for the creature to be tamable (but any Animal trainer can do the taming).

|-
| PETVALUE
| value
| How valuable a tamed animal/pet is. Actual cost in points in the embarking screen is (PETVALUE/2)+1 for an untrained animal, PETVALUE+1 for a trained(War or Hunting) one. Note that for an animal to be selectable in this screen, it must have the COMMON_DOMESTIC token.

|-
|PHYS_ATT_CAP_PERC
|
*ATTRIBUTE Token
*Cap %
|Default is 200. This means you can increase your attribute to 200% of its starting value (or the average value + your starting value if that is higher).

|-
| PHYS_ATT_RANGE
|
*ATTRIBUTE
*lowest
*lower
*low
*median
*high
*higher
*highest
| sets up a physical attribute's range of values. Max of 5000.

|-
| PHYS_ATT_RATES
|
*ATTRIBUTE Token
*cost to improve
*unused counter rate
*rust counter rate
*demotion counter rate
| Attribute gain/decay rates. Defaults for are 500:2:3:2, except for RECUPERATION and DISEASE_RESISTANCE that don't have change rates. The last three slots may be replaced by NONE.

|-
| PLUS_BP_GROUP
|
*BY_TYPE, BY_CATEGORY, or BY_TOKEN
*body type, category, or token
| Adds a body part group to selected body part group.

|-
| PLUS_MATERIAL
|
*material
| Adds a material to selected materials.

|-
| PLUS_TISSUE_LAYER
|
*TISSUE
*BY_CATEGORY, BY_TYPE, BY_TOKEN
*Location - category, type, or token
| Adds a tissue to those selected

|-
| PLUS_TL_GROUP
|
*TISSUE
*BY_CATEGORY, BY_TYPE, BY_TOKEN
*Location - category, type, or token
*tissue
| continues a selection of tissue layers

|-
| POP_RATIO
|
| Weighted population of caste; Lower is rarer. Not to be confused with FREQUENCY.

|-
| POPULATION_NUMBER
| min:max
| The minimum/maximum numbers of how many of these creatures can show up on a map per year.

|-
|POWER
|
|Allows the being to represent itself as a deity. Requires CAN_SPEAK to actually do anything more than settle at a location.

|-
| PREFSTRING
| string
| Sets what other creatures like about this creature. "Urist likes dwarves for their beards." Multiple entries will be chosen from at random

|-
| PROFESSION_NAME
|
*Profession
*singular
*plural
| The generic name for members of this profession, at the creature level. In order to give members of specific castes different names for professions, use CASTE_PROFESSION_NAME instead.
|}

<div align="center">
{{alphabetical TOC}}
</div>

==R==
{| {{prettytable}}
|- bgcolor="#ddd"
! width="20%" | Token
! width="20%" | Arguments
! width="60%" | Description
|-
| RELSIZE
|
*BY_CATEGORY, BY_TYPE, BY_TOKEN
*body category, type, or token
*Relsize
| Specifies a new relative size for a part than what is stated in the body plan. For example, Dwarves have larger livers.

|-
| REMAINS_COLOR
|
|

|-
| REMAINS_ON_VERMIN_BITE_DEATH
|
| Leaves remains when its attack causes it to die? Seems to go with DIE_WHEN_VERMIN_BITE.

|-
| REMAINS_UNDETERMINED
|
|

|-
| REMOVE_MATERIAL
|
*material token
| Removes a material from a creature

|-
| REMOVE_TISSUE
|
*material token
| Removes a tissue from a creature.
|}

<div align="center">
{{alphabetical TOC}}
</div>

==S==
{| {{prettytable}}
|- bgcolor="#ddd"
! width="20%" | Token
! width="20%" | Arguments
! width="60%" | Description
|-
| SAVAGE
|
| Allows creature to show up on (and limits it to) "savage" maps.

|-
| SECRETION
|
* {{L|material token}}
*Material State
*location secreted from (by_type, by_category, by_token)
*body part
*tissue layer
| creates a secreted material on given tissue on a given part of the body.

|-
| SELECT_ADDITIONAL_CASTE
|
*caste name
| adds an additional previously defined caste to the selection

|-
| SELECT_CASTE
|
*caste name, or ALL
| selects a previously defined caste

|-
| SELECT_MATERIAL
|
*MATERIAL NAME
| Selects the material. Can be ALL.

|-
| SELECT_TISSUE
|
*tissue token
| Selects a tissue for editing.

|-
| SELECT_TISSUE_LAYER
|
*TISSUE
*BY_CATEGORY, BY_TYPE, BY_TOKEN
*Location - category, type, or token | Selects a tissue at a location
* (optional) FRONT, BACK, LEFT, RIGHT, TOP, BOTTOM, AROUND.
| Selects a tissue layer for descriptor and cosmetic purposes.

|-
| SEMIMEGABEAST
|
| Appears as boss creature in quests. Makes history by rampaging around towns. Possibly inhabits non-mountain caves.

|-
| SET_BP_GROUP
|
*selection criteria BY_TYPE, BY_CATEGORY, BY_TOKEN
*category, type, or token
| selection token"

|-
| SET_TL_GROUP
|
*TISSUE
*BY_CATEGORY, BY_TYPE, BY_TOKEN
*Location - category, type, or token
*tissue
| begins a selection of tissue layers

|-
| SHEARABLE_TISSUE_LAYER
| ?
| Can be sheared for wool?

|-
| SKILL_LEARN_RATE
| {{L|skill_token}}:percentage
| The rate at which this creature learns this skill.

|-
| SKILL_LEARN_RATES
| percentage
| The rate at which this creature learns all skills.

|-
| SKILL_RATE
| {{L|skill_token}}:percentage:value:value:value
| As SKILL_RATES for individual skills.

|-
| SKILL_RATES
|
*% of improvement points you get
*unused counter rate
*rust counter rate
*demotion counter rate
| Affects skill gain and decay. Lower numbers in the last three slots make decay occur faster ([SKILL_RATES:100:1:1:1] would cause rapid decay). The counter rates may also be replaced with NONE.
Default is [SKILL_RATES:100:8:8:16]. [SLOW_LEARNER] changes the 100 to a 50.

|-
| SKILL_RUST_RATE
| {{L|skill_token}}:value:value:value
| The rate at which this skill decays. Lower values cause the skill to decay faster.

|-
| SKILL_RUST_RATES
| {{L|skill_token}}:value:value:value
| The rate at which all skills decay. Lower values cause the skills to decay faster.

|-
| SLOW_LEARNER
|
| Similar to [CAN_LEARN], but slower; skills are gained at a fraction of the rate. Present in the entries for ogres and giants; can be applied to civ or player races.

|-
| SMALL_REMAINS
|
| If a creature has this token, it'll leave "remains" instead of a corpse.

|-
| SOLDIER_ALTTILE
| 'character' or tile number
| If this creature is active in its civilization's military, it will blink between its default tile and this one.

|-
| SPEECH
| speech file
| Boasting speeches relating to killing this creature. Examples include dwarf.txt and elf.txt in the Speech folder in Data.u

|-
| SPEED
| value
| Sets the creatures' movement and work speed, 1000/[100 + SPEED X] is the resulting effect on creatures movement and work rates from default. See [http://df.magmawiki.com/index.php/Speed/ Speed] for more information.

|-
| SPHERE
|
*sphere name
| Sets what religious spheres the creature is aligned to, for purposes of being worshipped via the [POWER] token. Also affects the layout of hidden fun stuff, and the creature's name.

|-
| SPOUSE_CONVERSION_TARGET
|
| This creature can be converted by a night creature with SPOUSE_CONVERTED.

|-
| SPOUSE_CONVERTER
|
| Enables the creature to convert SPOUSE_CONVERSION_TARGETs into CONVERTED_SPOUSE castes of its species. The creature won't actually actively do this unless it also has NIGHT_CREATURE_HUNTER, however.

|-
| SWIM_SPEED
|
*speed
| How fast the creature swims. Typically 2500 (0.38 times the default speed).

|-
| SWIMS_INNATE
|
| The creature naturally knows how to swim, as opposed to [SWIMS_LEARNED] below. Currently, an AI bug prevents this from being useful on PC races in fortress mode.

|-
| SWIMS_LEARNED
|
| The creature doesn't know how to swim unless it has learned the skill. Requires [CAN_LEARN], obviously.

|}

<div align="center">
{{alphabetical TOC}}
</div>

==T==
{| {{prettytable}}
|- bgcolor="#ddd"
! width="20%" | Token
! width="20%" | Arguments
! width="60%" | Description
|-
| TENDONS
|
* {{L|material token}}
*healing rate
| Defines the material and healing rare of tendons.

|-
| THICKWEB
|
| The creature's webs can catch larger creatures. May imply [AMBUSHPREDATOR].

|-
| TISSUE
| name
| Begins defining a tissue in the creature file.

|-
| TISSUE_LAYER
|
*BY_TYPE, BY_CATEGORY, BY_TOKEN
*TYPE,CATEGORY, or TOKEN
*TISSUE
*LOCATION
| Adds the tissue layer to wherever it is required.
Non-argument Locations can be FRONT, RIGHT, LEFT, TOP, BOTTOM. Argument locations are AROUND and CLEANS, requiring a further body part and a % of coverage/cleansing

|-
| TISSUE_LAYER_OVER
|
*BY_TYPE, BY_CATEGORY, BY_TOKEN
*TYPE,CATEGORY, or TOKEN
*TISSUE
*LOCATION
| Presumably a counterpart to TISSUE_LAYER_UNDER (see below).

|-
| TISSUE_LAYER_UNDER
|
*BY_TYPE, BY_CATEGORY, BY_TOKEN
*TYPE,CATEGORY, or TOKEN
*TISSUE
| Adds the tissue layer under a given part.
See Important Related Tokens, below, for more information.

|-
| TISSUE_LAYER_APPEARANCE_MODIFIER
|
*QUALITY
*lowest:lower:low:median:high:higher:highest
| sets the range of qualities, including LENGTH, DENSE, HIGH_POSITION, CURLY, GREASY, WRINKLY

|-
| TISSUE_STYLE_UNIT
|
*tissue
*shaping
| sets tissue to be in a certain shape, mostly used with tissues HAIR, BEARD, MOUSTACHE, SIDEBURNS.

|-
| TL_COLOR_MODIFIER
| COLOR:freq:COLOR:freq etc
| Creates a list of color patterns, giving each a frequency.

|-
| TLCM_GENETIC_MODEL
|
| tissue layer color modifier is passed to offspring genetically?

|-
| TLCM_IMPORTANCE
|
*number
| Presumably modifies the importance of the tissue layer color modifier, for description purposes.
HOWEVER using this appears to remove all mention of colour from creature descriptions. It does not appear in any default creatures.

|-
| TLCM_NOUN
|
*name
*SINGULAR or PLURAL
| names the tissue layer color modifier, and determines the noun

|-
| TLCM_TIMING
|
*ROOT
*start change window years:days:end change window years:days
| determines the point in the creature's life where the color change begins

|-
| TRADE_CAPACITY
|
| How much the creature can carry when used by merchants.

|-
| TRAINABLE
|
| Implies both [TRAINABLE_HUNTING] and [TRAINABLE_WAR].

|-
| TRAINABLE_HUNTING
|
| Can be trained as hunting beasts by way of kennels.

|-
| TRAINABLE_WAR
|
| Can be trained as war beasts by way of kennels.

|-
| TRANCES
|
| Allows the creature to go into martial trances.

|-
| TRAPAVOID
|
| The creature is immune to traps. Probably every procedurally generated megabeast has this.

|-
| TRIGGERABLE_GROUP
| min:max
| A large swarm of vermin can be disturbed, usually in Adventure mode.{{verify}}

|-
| TSU_NOUN
|
*noun
*SINGULAR or PLURAL
| Noun for the TISSUE_STYLE_UNIT, used in the description of the tissue layer's style.
|}

<div align="center">
{{alphabetical TOC}}
</div>

==U==
{| {{prettytable}}
|- bgcolor="#ddd"
! width="20%" | Token
! width="20%" | Arguments
! width="60%" | Description

|-
| UBIQUITOUS
|
| Creature will occur in every region with the correct biome. Does not apply to evil/good tags.

|-
| UNDERGROUND_DEPTH
|
*mindepth
*maxdepth
| Depth the creature appears underground. Numbers can be from 1 to 5. Only magma creatures use 4 or 5 in the default raws. A single argument may be used instead of min and max. Dwarven civilizations will only export (via the embark screen or caravans) things that available at depth 1.

|-
| UNDERSWIM
|
| Creature swims under the water and can't be seen.{{verify}}

|-
| UNIQUE_DEMON
|
| Typically found on genned [[demon]]s; sets the creature as capable of "emerging from the underworld" and taking over during worldgen.

|-
| USE_CASTE
|
*caste token
|

|-
| USE_MATERIAL
|
*new material token
*old material id
| Uses a local creature mat to define a new material?{{verify}}

|-
| USE_MATERIAL_TEMPLATE
|
*new material token
*material template
| Loads a material, and gives it a shortname for later reference

|-
| USE_TISSUE
|
*new tissue token
*old tissue id
| Uses a local creature mat to define a new material?{{verify}}

|-
| USE_TISSUE_TEMPLATE
|
*new tissue token
*tissue template
| Loads a tissue template listed in OBJECT:TISSUE_TEMPLATE files, such as tissue_template_default.txt.

|-
| UTTERANCES
|
| Changes the language of the creature into an unintelligible mess.
|}

<div align="center">
{{alphabetical TOC}}
</div>

==V==
{| {{prettytable}}
|- bgcolor="#ddd"
! width="20%" | Token
! width="20%" | Arguments
! width="60%" | Description
|-
| VEGETATION
|
| unknown

|-
| VIEWRANGE
| value
| Value should determine how close you have to get to a critter before it attacks (or prevents adv mode travel etc.) Default is 20.

|-
| VERMIN_BITE
|
*amount
*verb (bitten, stung)
* {{L|material token}}
| vermin bites, and injects something.

|-
| VERMIN_EATER
|
| Vermin can nibble food?{{verify}}

|-
| VERMIN_FISH
|
| Acts like a fish

|-
| VERMIN_GROUNDER
|
| The creature can be picked up if you stand over it. (Requires confirmation)
'I think this is a habitat flag like VERMIN_SOIL, VERMIN_CHASM, etc. It seems to appear on creatures that don't otherwise have one. – Peristarkawan 17:27, 24 May 2007 (EDT)'

|-
| VERMIN_HATEABLE
|
| Some dwarves will hate the creature and get unhappy thoughts when around it.

|-
| VERMIN_MICRO
|
| This makes the creature move in a swarm of creatures of the same race as it. I.E. Swarm of flies, swarm of ants, etc.

|-
| VERMIN_NOFISH
|
| The creature cannot be caught by fishing.

|-
| VERMIN_NOROAM
|
| The creature will not be observed randomly roaming about the map.

|-
| VERMIN_NOTRAP
|
| The creature cannot be caught in baited animal traps; however, a "catch live land animal" task may still be able to capture one if a dwarf finds one roaming around.

|-
| VERMIN_ROTTER
|
| Present on flies, knuckle worms, acorn flies, and blood gnats. Probably means either the creature is attracted to rot, the creature speeds rotting, or both.

|-
| VERMIN_SOIL
|
| The creature randomly appears near dirt or mud.

|-
| VERMIN_SOIL_COLONY
|
| The vermin will appear in a single tile cluster of many vermin, such as a colony of ants.

|-
| VERMINHUNTER
|
| A creature with this tag will hunt down vermin and kill them. Sometimes they will eat the vermin, but most of the time they will bring it to their owner. This tag also makes impossible to assign an owner to the animal. The animal chooses it's own owner instead (like a cat). If assigned to a playable race, members of that race will ONLY be able to eat vermin.

|-
| VESPERTINE
|
| Sets if the creature is active in evening.
|}

<div align="center">
{{alphabetical TOC}}
</div>

==W==
{| {{prettytable}}
|- bgcolor="#ddd"
! width="20%" | Token
! width="20%" | Arguments
! width="60%" | Description
|-
| WAGON_PULLER
|
| Allows the creature to pull caravan wagons.

|-
| WEBBER
|
* {{L|material token}}
| allows the creature to web, and defines what the webs are made of.

|-
| WEBIMMUNE
|
| The creature will not get caught in thick webs.
|}

==Attack Tokens==
{| {{prettytable}}
|- bgcolor="#ddd"
! width="20%" | Token
! width="20%" | Arguments
! width="60%" | Description

|-
| ATTACK_SKILL
|
*skill used ({{L|Skill tokens}})
| defines the attack skill used

|-
| ATTACK_VERB
| 2nd person:3rd person
| descriptive text for the attack

|-
| ATTACK_CONTACT_PERC
|
*% value
| amount of available tissue used in attack

|-
| ATTACK_PENETRATION_PERC
|
*% value
| probably amount of material that makes contact when penetration is done

|-
| ATTACK_FLAG_EDGE
|
| attack type

|-
| ATTACK_FLAG_WITH
|
| In adventure mode, displays the name of the body part used by an attack when announcing the attack.

|-
| ATTACK_PRIORITY
|
*MAIN or SECOND
| use of the attack in combat. Secondary attacks are only used if main attacks are impossible.

|-
| ATTACK_FLAG_CANLATCH
|
| Enables an attacker to occasionally latch on with the bodypart used by an attack when an attack with this flag in it's definition is made.

|-
| ATTACK_VELOCITY_MODIFIER
| number
| Modifies the attack velocity. Believed to be percent based (so 100 would be "normal"). May be on same scale as weapon velocity (where 1000 is "normal").

|-
| SPECIALATTACK_INJECT_EXTRACT
|
* {{L|material token}}
*state (SOLID, LIQUID, GAS)
*min:max
| attack type addition that injects a material into the victim.

|-
| SPECIALATTACK_SUCK_BLOOD
| min:max
| Successful attack draws out an amount of blood randomized between the min and max value.
|}

==Important Related Tokens==
These next groups of tokens include several tokens that are not technically classified as creature tokens in string dump, but bear mentioning in this as they are used frequently in creature raws. (Some regular creature tokens may also be reprinted for the sake of ease of navigation)

===Tissue Modification===
This next group of tokens deals setting and modifying tissue properties. (See also [[DF2010:Tissue definition token]])

{| {{prettytable}}
|- bgcolor="#ddd"
! width="20%" | Token
! width="20%" | Arguments
! width="60%" | Description

|-
| INSULATION
|
*value
| Tissue supplies the creature with heat insulation. Higher values result in more insulation.

|-
| PLUS_TISSUE_LAYER
|
*TISSUE
*BY_CATEGORY, BY_TYPE, BY_TOKEN
*Location - category, type, or token
| Adds a tissue to those selected

|-
| PLUS_TL_GROUP
|
*TISSUE
*BY_CATEGORY, BY_TYPE, BY_TOKEN
*Location - category, type, or token
*tissue
| continues a selection of tissue layers

|-
| SELECT_TISSUE
|
*tissue token
| Selects a tissue for editing.

|-
| SELECT_TISSUE_LAYER
|
*TISSUE
*BY_CATEGORY, BY_TYPE, BY_TOKEN
*Location - category, type, or token | Selects a tissue at a location
* (optional) FRONT, BACK, LEFT, RIGHT, TOP, BOTTOM, AROUND.
| Selects a tissue layer for descriptor and cosmetic purposes.

|-
| SET_LAYER_TISSUE
|
| Sets a tissue layer to be made of a different tissue.

|-
| TISSUE_LAYER
|
*BY_TYPE, BY_CATEGORY, BY_TOKEN
*TYPE,CATEGORY, or TOKEN
*TISSUE
*LOCATION
| Adds the tissue layer to wherever it is required.
Non-argument Locations can be FRONT, RIGHT, LEFT, TOP, BOTTOM. Argument locations are AROUND and CLEANS, requiring a further body part and a % of coverage/cleansing

|-
| TISSUE_LAYER_OVER
|
*BY_TYPE, BY_CATEGORY, BY_TOKEN
*TYPE,CATEGORY, or TOKEN
*TISSUE
*LOCATION
| Presumably a counterpart to TISSUE_LAYER_UNDER (see below).

|-
| TISSUE_LAYER_UNDER
|
*BY_TYPE, BY_CATEGORY, BY_TOKEN
*TYPE,CATEGORY, or TOKEN
*TISSUE
| Adds the tissue layer under a given part.
For example an Iron Man has a gaseous poison within and this tissue (GAS is its name) has the token [TISSUE_LEAKS] and its state is GAS so when you puncture the iron outside and damage this tissue it leaks gas (can have a syndrome by using a previous one in the creature sample.) [TISSUE_LAYER_UNDER:BY_CATEGORY:ALL:{tissue}] {tissue} is what will be under the TISSUE_LAYER here is an example Tissue from Iron Man
[TISSUE:GAS]
[TISSUE_NAME:gas:NP] [TISSUE_MATERIAL:LOCAL_CREATURE_MAT:GAS] [TISSUE_MAT_STATE:GAS] [RELATIVE_THICKNESS:50] [TISSUE_LEAKS] [TISSUE_SHAPE:LAYER]

|-
| TISSUE_LAYER_APPEARANCE_MODIFIER
|
*QUALITY
*lowest:lower:low:median:high:higher:highest
| sets the range of qualities, including LENGTH, DENSE, HIGH_POSITION, CURLY, GREASY, WRINKLY

|-
| TISSUE_LEAKS
|
| The selected tissue leaks out of the creature when the layers above it are pierced. As per an iron man's internal poison gas.

|-
| TISSUE_MATERIAL
|
*VALUE (material)
*MATERIAL (material subtype)
| Defines the tissue material. VALUE can be LOCAL_CREATURE_MAT, INORGANIC etc. MATERIAL is a subtype of the material, e.g. [TISSUE_MATERIAL:INORGANIC:BRONZE]

|-
| TISSUE_STYLE_UNIT
|
*tissue
*shaping
| sets tissue to be in a certain shape, mostly used with tissues HAIR, BEARD, MOUSTACHE, SIDEBURNS.

|-
| TL_COLOR_MODIFIER
| COLOR:freq:COLOR:freq etc
| Creates a list of color patterns, giving each a frequency.

|-
|TL_CONNECTS
|
| Presumably gives the CONNECTS attribute to selected layers.

|-
|TL_HEALING_RATE
|
| Presumably changes the HEALING_RATE of the selected tissue layers.

|-
|TL_MAJOR_ARTERIES
|
| Gives Major Artery attribute to selected layers.

|-
|TL_PAIN_RECEPTORS
|
| Seems to set new number of pain receptors for selected tissue layers.

|-
|TL_RELATIVE_THICKNESS
|
| Seems to set new relative thickness for selected tissue layers.

|-
|TL_VASCULAR
|
| Seems to set new a VASCULAR value (which modulates bleeding) for selected tissue layers.

|}

==See Also==
*[[DF2010:Body detail plan token]]
*[[DF2010:Body token]]
*[[DF2010:Material definition token]]
*[[DF2010:Syndrome]]
*[[DF2010:Tissue definition token]]

{{Category|Modding}}
{{Category|Tokens}}

v0.31:Creature token

2011-02-26T04:23:45Z

Bohandas: Added some relevant information related to in-creature creature tissue editing

{{av}}{{Quality|Exceptional}}

Tentative at best in some cases.

__NOTOC__

<div align="center">
{{alphabetical TOC}}
</div>

==A==
{| {{prettytable}}
|- bgcolor="#ddd"
! width="20%" | Token
! width="20%" | Arguments
! width="60%" | Description
|-
| ALCOHOL_DEPENDENT
|
| Creature needs alcohol to get through the working day.

|-
| ALL_ACTIVE
|
| Sets if the creature is active in day, night, and twilight. Seems to be a separate value from DIURNAL/NOCTURNAL/CREPUSCULAR, rather than implying them.

|-
| ALTTILE
|
| If set, the creature will blink between its [TILE] and its [ALTTILE].

|-
| AMBUSHPREDATOR
|
| Makes the creature start out hidden. Used by {{L|giant cave spider}}s. May make {{L|web}}s hidden too.

|-
| AMPHIBIOUS
|
| Allows a creature to breathe with or without {{L| water}}. Implies [AQUATIC].

|-
| APP_MOD_DESC_RANGE
| ?
| ?

|-
| APP_MOD_GENETIC_MODEL
|
|

|-
| APP_MOD_IMPORTANCE
|
*number
| Determines how important the appearance modifier is, for determining whether it shows up in the creature description.{{verify}}

|-
| APP_MOD_NOUN
|
*noun
*SINGULAR or PLURAL
| creates a noun for the appearance and whether it is singular or plural

|-
| APP_MOD_RATE
|
*Rate (integer)
*Scale (DAILY, YEARLY)
*min:max of growth
*start year:start day
*end year:end day
| setting the growth rate of the modifier. The last two tokens can be replaced by NO_END to have growth continue indefinitely.

|-
| APPLY_CREATURE_VARIATION
|
*CV TEMPLATE NAME
| Loads the Creature Variation Template specified.

|-
| APPLY_CURRENT_CREATURE_VARIATION
|
| Applies loaded Creature Variation

|-
| AQUATIC
|
| Allows a creature to breathe underwater, but causes it to "drown" out of {{L| water}}.

|-
| ARENA_RESTRICTED
|
| Does not appear in arena mode list

|-
| ARTIFICIAL_HIVEABLE
|
| Can be kept in artificial hives by beekeepers.

|-
| ATTACK
|
*token
*bodypart
*selection criteria
*location
| Defines the attack name, and the body part used. See [[#Attack Tokens|below]] for valid subtokens
'''Example:'''<br />
[ATTACK:GORE:BODYPART:BY_CATEGORY:HORN]<br />
''GORE'' : name of the attack<br />
''BODYPART:BY_CATEGORY:HORN'' : the horn is used to attack (presuming the creature has one)

|-
| ATTACK_TRIGGER
| pop:exported wealth:created wealth
| stages when a megabeast will attack a site

|}

<div align="center">
{{alphabetical TOC}}
</div>

==B==
{| {{prettytable}}
|- bgcolor="#ddd"
! width="20%" | Token
! width="20%" | Arguments
! width="60%" | Description
|-
| BABY
| integer
| age at which creature is considered a child. Default is zero. One can think of this as the duration of the baby stage.

|-
| BABYNAME
| singular:plural
| name at caste level

|-
| BEACH_FREQUENCY
|
| {{L|Whale}}s and {{L|Sea nettle jellyfish|jellyfish}} have this. Controls the beaching frequency of the creature.

|-
| BENIGN
|
| Determines whether creature can show up on "tame" maps (includes {{L|elephants}}), which will generally avoid dwarves, although they may chase and/or attack them if they get too close).

|-
| BIOME
|
* biome token
| Select a {{L|Biome}} the creature may appear in.

|-
| BLOOD, PUS, OTHER MATERIAL state definition
|
* {{L|material token}}
*matter state (LIQUID, GAS, SOLID)
| Controls bleeding behaviour

|-
| BODY
| body parts
| Draws body parts from OBJECT:BODY files (such as body_default.txt)
'''Example:'''<br />
[BODY:BODY_WITH_HEAD_FLAG:HEART:GUTS:BRAIN:MOUTH] <br />
This is the body from a {{L|Purring maggot}}. It creates a body with head, a heart, some guts, a brain, and a mouth. Thats all a maggot needs.

|-
| BODY_APPEARANCE_MODIFIER
|
*ATTRIBUTE
*lowest:lower:low:median:high:higher:highest
| These body modifiers give individual creatures different characteristics. In the case of HEIGHT, BROADNESS and LENGTH, the modifier is also a percentage change to the BODY_SIZE of the individual creature. The seven numbers afterward give a distribution of ranges. Each interval has an equal chance of occurring.
'''Example:'''<br />
[BODY_APPEARANCE_MODIFIER:LENGTH:90:95:98:100:102:105:110] <br />
''HEIGHT'' : marks the height to be changed <br />
''90:95:98:100:102:105:110'' : sets the range from the shortest (90% of the average height) to the tallest (110% of the average height) creature variation.

|-
| BODY_DETAIL_PLAN
| PlanName, PlanName:type:type:type:etc
| loads a plan listed OBJECT:BODY_DETAIL_PLAN files, such as b_detail_plan_default.txt. Mass applies USE_MATERIAL_TEMPLATE, mass alters RELSIZE, alters body part positions, and will allow tissue layers to be defined. Tissue layers are defined in order of skin to bone here.
'''Example:'''<br />
[BODY_DETAIL_PLAN:VERTEBRATE_TISSUE_LAYERS:SKIN:FAT:MUSCLE:BONE:CARTILAGE] <br />
This creates the detailed body of a {{L|fox}}, the skin, fat, muscle, bones and cartilage out of the vertebrate tissues.<br />
A {{L|Purring maggot|maggot}} would only need:<br />
''[BODY_DETAIL_PLAN:EXOSKELETON_TISSUE_LAYERS:SKIN:FAT:MUSCLE]''

|-
| BODY_SIZE
| years:days:size
| sets up size at a given time. Size is roughly equal to the creature's average weight in grams.
'''Example:'''<br />
[BODY_SIZE:0:0:10000]<br />
[BODY_SIZE:1:168:50000]<br />
[BODY_SIZE:12:0:220000]<br />
This describes the size of a {{L|minotaur}}. His birth size would be 10000 (~10 kg). With 1 year and 168 days he would be 50000 tall (~50 kg). As an adult (with 12 years) he would weight roughly 220 kg

|-
| BODYGLOSS
| gloss
| Substitutes body part text with replacement text. Draws gloss information from OBJECT:BODY files (such as body_default.txt)

|-
| BONECARN
|
| Creature 'eats' bones. Eating bones makes their happiness go up, but can cause death (suffocation){{verify}}. Implies CARNIVORE.

|-
| BP_APPEARANCE_MODIFIER
|
*QUALITY
*lowest:lower:low:median:high:higher:highest
| sets up the breadth of possibilities for appearance qualities for a selected BP group. EG. Eyes (CLOSE_SET, DEEP_SET, ROUND_VS_NARROW, LARGE_IRIS),Lips (THICKNESS), Nose (BROADNESS, LENGTH, UPTURNED, CONVEX), Ear (SPLAYED_OUT, HANGING_LOBES, BROADNESS, HEIGHT), Tooth (GAPS), Skull (HIGH_CHEEKBONES, BROAD_CHIN, JUTTING CHIN, SQUARE_CHIN), Neck (DEEP_VOICE, RASPY_VOICE), Head (BROADNESS, HEIGHT)

|-
| BUILDINGDESTROYER
| 1 or 2
| Allows a creature to destroy furniture and buildings. Value [1] targets mostly doors, hatches, furniture and the like. Value [2] targets anything not made with the b + C commands.
|}

<div align="center">
{{alphabetical TOC}}
</div>

==C==
{| {{prettytable}}
|- bgcolor="#ddd"
! width="20%" | Token
! width="20%" | Arguments
! width="60%" | Description

|-
| CAN_LEARN
|
| The creature gets skills and professions. Note that this token makes the creature unable to be butchered by an adventurer so it is not recommended for uncivilized monsters. Adventurers lacking this token can allocate but not increase attributes and skills. skills allocated will disappear on start.

|-
| CAN_SPEAK
|
| Can talk. Note that it is not necessary for a creature to gain social skills.

|-
| CANNOT_UNDEAD
|
| Cannot be turned into a zombie or skeletal undead

|-
| CANOPENDOORS
|
| Allows the creature to open doors.

|-
| CARNIVORE
|
| Creature ''only'' eats meat

|-
| CASTE
|
*name
| defines a caste

|-
| CASTE_ALTTILE
|
*tile number or "letter"
| Caste-specific alternate tile. Expects CASTE_TILE

|-
| CASTE_COLOR
|
*fg
*bg
*brightness
| Creature tile color of the caste.

|-
| CASTE_GLOWCOLOR
|
*fg
*bg
*brightness
| GLOWTILE color of the caste.

|-
| CASTE_GLOWTILE
|
*tile value or "letter"
| Caste-specific glowtile

|-
| CASTE_NAME
| singular:plural:adjective
| The name of the caste of the creature in the game.

|-
| CASTE_PROFESSION_NAME
|
*Profession
*singular
*plural
| alters the name of the given profession, caste-specific

|-
| CASTE_SOLDIER_ALTTILE
| 'character' or tile number
| Creatures of this caste active in their civilization's military will blink between their default tile and this one.

|-
| CASTE_SOLDIER_TILE
| 'character' or tile number
| Creatures of this caste active in their civilization's military will use this tile instead.

|-
| CASTE_SPEECH
| speech file?
| Possibly a caste-specific instance of the SPEECH token

|-
| CASTE_TILE
|
* tile number or "letter"
| Caste-specific creature tile.

|-
| CAVE_ADAPT
|
| Gives the creature a bonus in caves. Also causes [[Cave adaptation]].

|-
| CHANGE_BODY_SIZE_PERC
|
|

|-
| CHILD
| integer
| age at which creature is considered an adult. One can think of this as the duration of the child stage. Without this token, a creature will not reproduce in Fortress mode.

|-
| CHILD_BODYPART_GROUP
|
*master selection, BY_CATEGORY, BY_TYPE, BY_TOKEN.
*master location
*specific selection, BY_CATEGORY, BY_TYPE, BY_TOKEN.
*specific location
| selects all parts of a group to be used.

|-
| CHILDNAME
| singular:plural
| name at caste level

|-
| CLUSTER_NUMBER
|
*min
*max
| The minimum/maximum numbers of how many creatures per spawned cluster. Certain vermin fish use this token in combination with temperate ocean and river biome tokens to perform seasonal migrations.
e.g. [CLUSTER_NUMBER:1:3]

|-
|CLUTCH_SIZE
|
*min
*max
|Number of eggs laid in one sitting.

|-
| COLONY_EXTERNAL
|
| Caste hovers around colony.

|-
| COLOR
| foreground:background:brightness
| Color of the creature's tile.

|-
| COMMON_DOMESTIC
|
| Allows the creature to be brought with immigrants and when creating a new fortress, as long as the creature also includes at least one of the following tokens: PET, PACK_ANIMAL, WAGON_PULLER, MOUNT. In addition, the creature must be NATURAL rather than FANCIFUL

|-
| CONVERTED_SPOUSE
|
| Found only at caste level. Creatures of this caste's species with the SPOUSE_CONVERTER and NIGHT_CREATURE_HUNTER tokens will kidnap SPOUSE_CONVERSION_TARGETs of an appropriate sex and convert them into castes with CONVERTED_SPOUSE.

|-
| COOKABLE_LIVE
|
| Set this to allow the creature to be cooked in meals without first being butchered / fishcleaned.

|-
| COPY_TAGS_FROM
|
*CREATURE NAME
| Copies tags from another specified creature.

|-
| CREATURE
| name
| begins defining a new creature with the specified name.

|-
| CREATURE_CLASS
|
*classname
| Creature class. Can be anything, but only existing use is GENERAL_POISON. Appears to only be used for Syndromes. Supposedly can also be used for entity positions.

|-
| CREATURE_SOLDIER_TILE
| 'character' or tile number
| Creatures active in their civilization's military will use this tile instead.

|-
| CREATURE_TILE
| 'character' or tile number
| The symbol of the creature in ASCII mode.

|-
| CREPUSCULAR
|
| Sets if the creature is active at twilight. This tag functions as a combination of the two tags VESPERTINE and MATUTINAL.

|-
| CURIOUSBEAST_EATER
|
| Allows a creature to steal and eat edible items from a site.

|-
| CURIOUSBEAST_GUZZLER
|
| Allows a creature to (very quickly) drink your alcohol. Or spill the barrel to the ground. Also affects undead versions of the creature.

|-
| CURIOUSBEAST_ITEM
|
| Allows a creature to steal things (apparently the highest value it can find). Semimegabeast thievery is in Legends mode. Lightweight creatures can probably steal heavy items.

|-
| CV_ADD_TAG
|
*TAG NAME
| Adds a tag. Used in conjunction with creature variation templates.

|-
| CV_REMOVE_TAG
|
*TAG NAME
| Removes a tag. Used in conjunction with creature variation templates.
|}

<div align="center">
{{alphabetical TOC}}
</div>

==D==
{| {{prettytable}}
|- bgcolor="#ddd"
! width="20%" | Token
! width="20%" | Arguments
! width="60%" | Description

|-
| DEMON
|
| Typically found on genned [[demon]]s; sets the creature as a potential spawn for [[Hidden Fun Stuff]]

|-
| DESCRIPTION
| text
| A brief description of the creature type.

|-
| DIE_WHEN_VERMIN_BITE
|
| Dies upon attacking. Used for bee stings.

|-
| DIFFICULTY
| integer
| Toady: "Difficulty determines how deep it places them in adventure mode/reclaim caves, and the chance that they are wounded the first few river attacks." Also increases experience gain during adventure mode.

|-
| DIURNAL
|
| Sets if the creature is active in day.

|-
| DOES_NOT_EXIST
|
| Creature does not actually exist; used for fanciful creatures.

|-
| DRAGONFIREBREATH
|
| Creature breathes fire in a cone.
|}

<div align="center">
{{alphabetical TOC}}
</div>

==E==
{| {{prettytable}}
|- bgcolor="#ddd"
! width="20%" | Token
! width="20%" | Arguments
! width="60%" | Description

|-
| EGG_MATERIAL
|
* {{L|material token}}
*state (SOLID, LIQUID, or GAS)
| Egg material. Egg-laying creatures will define this 3 times, using LOCAL_CREATURE_MAT:EGGSHELL, LOCAL_CREATURE_MAT:EGG_WHITE, and then LOCAL_CREATURE_MAT:EGG_YOLK. Eggs will be made out of eggshell. Edibility is determined by tags on whites or yolk, but they otherwise do not exist.

|-
| EGG_SIZE
|
*size
| Size of creature's egg?

|-
| EQUIPMENT_WAGON
|
| Makes the creature into a large 3x3 creature responsible for carrying trade goods, pulled by two [WAGON_PULLER]s and driven by a merchant.

|-
| EQUIPS
|
| Allows the creature to wear or wield items.

|-
| EVIL
|
| Determines whether creature can show up on "evil" maps

|-
| EXTRAVISION
|
| Creature can see regardless of whether it has working eyes.
|}

<div align="center">
{{alphabetical TOC}}
</div>

==F==
{| {{prettytable}}
|- bgcolor="#ddd"
! width="20%" | Token
! width="20%" | Arguments
! width="60%" | Description
|-
| FANCIFUL
|
| Makes every civilization know about the creature. The creature won't occur in regular material preference lists. The tag also adds some art value modifiers. Used for things like dragons and other legendary creatures.

|-
| FEATURE_ATTACK_GROUP
|
| Found on subterranean animalmen.

|-
| FEMALE
|
| Inside a female caste, sets femaleness. Outside of a caste, sets all individuals female unless overridden by caste.

|-
| FIREBREATH
|
| The creature breathes fire projectiles (as opposed to DRAGONFIREBREATH, which is in a cone).

|-
| FIREIMMUNE
|
| As of version v0.28.181.40d, the FIREIMMUNE token had no effect on a creature's resistance to flame or heat. However, it did affect ability to swim in magma in adventure mode, as well as display of "You are caught in a pool of magma!" warning messages. It is unknown if these effects persist in DF 2010.

|-
| FIREIMMUNE_SUPER
|
| The creature is immune to DRAGONFIREBREATH. Implies FIREIMMUNE.

|-
| FISHITEM
|
| Needs to be cleaned at a fishery

|-
| FIXED_TEMP
| temperature
| The natural heat generated by the creature.

|-
| FLEEQUICK
|
| Determines how soon a creature flees in a losing battle.

|-
| FLIER
|
| Allows a creature to fly. Fortress Mode pathfinding only partially incorporates pathfinding - flying dwarves need a land path to exist between them and an area in order to access it, but as long as one such path exists, they do not need to use it, instead being able to fly over intervening obstacles.

|-
| FREQUENCY
|
*number, max 100
| Determines the time between creature spawns in Fortress Mode. Higher is more occurrences per time unit. Creatures without a frequency statement default to 50. Almost all others have either [FREQUENCY:5] or [FREQUENCY:100]. Not to be confused with POP_RATIO
|}

<div align="center">
{{alphabetical TOC}}
</div>

==G==
{| {{prettytable}}
|- bgcolor="#ddd"
! width="20%" | Token
! width="20%" | Arguments
! width="60%" | Description
|-
| GENERAL_BABY_NAME
| singular:plural
| name at creature level

|-
| GENERAL_CHILD_NAME
| singular:plural
| name at creature level

|-
| GENERATED
|
| Found on procedurally generated creatures like {{L|Forgotten beast}}s, (biome name) {{L|titan}}s, {{L|Demon}}s, and {{L|night creature}}s.

|-
| GETS_INFECTIONS_FROM_ROT
|
| creature can be infected by rot

|-
| GETS_WOUND_INFECTIONS
|
| creature can get infections from wounds

|-
| GLOWCOLOR
|
*foreground
*background
*brightness
| The colour of the GLOWTILE of the creature.

|-
| GLOWTILE
| ascii character
| If present, the being glows in the dark (generally used for Adventure Mode). The tile is what replaces the being's current tile when it is obscured from your sight by darkness. The default setting for kobolds (a yellow quotation mark) provides a nice "glowing eyes" effect. The game is also hardcoded to automatically convert quotation mark GLOWTILES into apostrophes if the creature has lost one eye. This works at the generic creature level - for caste-specific glow tiles, use CASTE_GLOWTILE instead.

|-
| GNAWER
| verb (gnawed)
| The creature chews on food barrels and bags.

|-
| GO_TO_END
|
| uncertain use, definitely refers to Creature Variants template

|-
| GO_TO_START
|
| uncertain use, definitely refers to Creature Variants template

|-
| GOOD
|
| Determines whether creature can show up on "good" areas. Eg. unicorn.

|-
| GRASSTRAMPLE
| value
| Determines the percentage chance of trampling and killing grass when a creature steps on it. Set [GRASSTRAMPLE:0] to make grass never trampled by the creature.

|-
| GRAVITATE_BODY_SIZE
|
| Creature Variants template command, alter body size.

|-
| GRAZER
|
*number
| Animals is a grazer. The higher the number, the less grass it needs.
|}

<div align="center">
{{alphabetical TOC}}
</div>

==H==
{| {{prettytable}}
|- bgcolor="#ddd"
! width="20%" | Token
! width="20%" | Arguments
! width="60%" | Description
|-
| HABIT
| type:probability
| Defines certain behaviors for the creature. The habit types are COLLECT_TROPHIES, COOK_PEOPLE, COOK_VERMIN, GRIND_VERMIN, COOK_BLOOD, GRIND_BONE_MEAL, EAT_BONE_PORRIDGE, USE_ANY_MELEE_WEAPON, GIANT_NEST, and COLLECT_WEALTH. These may require the creature to have a lair to work properly.

|-
| HABIT_NUM
| number or TEST_ALL
| Unknown. All lists of HABITs are preceded by [HABIT_NUM:TEST_ALL]

|-
| HAS_NERVES
|
| This makes the creature susceptible to severed motor and sensory nerves when muscles are torn in limb, grasp and stance parts. Some butchering yields nervous tissue.

|-
| HIVE_PRODUCT
|
*number
*time
*item tokens
| What product is harvested from beekeeping.

|-
| HOMEOTHERM
|
| Default 'NONE'. The creature's normal body {{L|temperature}}
|}

<div align="center">
{{alphabetical TOC}}
</div>

==I==
{| {{prettytable}}
|- bgcolor="#ddd"
! width="20%" | Token
! width="20%" | Arguments
! width="60%" | Description

|-
| IMMOBILE_LAND
|
| The creature is immobile while on land. Only works on AQUATIC creatures which can't breath on land.

|-
| IMMOLATE
|
| Will ignite, and potentially completely destroy, items the creature is standing on. Keep booze away from critters with this tag.

|-
| INTELLIGENT
|
| Implies CAN_SPEAK and CAN_LEARN. CAN_LEARN probably means the creature gets skills and professions. Not recommended for uncivilized monsters.

|-
| ITEMCORPSE
|
* {{L|item token}}:subtype
* {{L|material token}}
| Determines if the creature leaves behind a non-standard corpse (i.e. wood, statue, bars, ash from ghost etc).

|-
| ITEMCORPSE_QUALITY
|
| The quality of an item-type corpse left behind; 5 is masterpiece-level.
|}

<div align="center">
{{alphabetical TOC}}
</div>

==L==
{| {{prettytable}}
|- bgcolor="#ddd"
! width="20%" | Token
! width="20%" | Arguments
! width="60%" | Description
|-
| LAIR
| type:probability
| Found on megabeasts, semimegabeasts, and night creatues. The creature will seek out sites of this type and take them as lairs. The lair types are SIMPLE_BURROW, SIMPLE_MOUND, WILDERNESS_LOCATION, SHRINE, and LABYRINTH.

|-
| LAIR_CHARACTERISTIC
| characteristic:probability
| Defines certain features of the creature's lair. The only known valid characteristic is HAS_DOORS.

|-
| LAIR_HUNTER
|
| This creature will actively hunt adventurers in its lair.

|-
| LAIR_HUNTER_SPEECH
| speech file
| What this creature says while hunting adventurers in its lair.

|-
| LARGE_PREDATOR
|
| Will attack things that are smaller than it (like dwarves). Only one group of "large predators" will appear on any given map (possibly two groups on "savage" maps). In adventure mode, large predators will try to ambush and attack you (and your party will attack them back). Also, they can be mentioned in the intro paragraph when starting a fortress e.g. "ere the wolves get hungry."

|-
| LARGE_ROAMING
|
| In Fortress Mode, spawns outdoors and is not a vermin creature.

|-
| LAYS_EGGS
|
| Creature lays eggs instead of giving birth to live young.

|-
| LAYS_UNUSUAL_EGGS
|
* {{L|item token}}
* {{L|material token}}
| Creature lays a particular item instead of regular eggs. As of v0.31.19, this tag only makes the game crash.

|-
| LIGAMENTS
|
* {{L|material token}}
*healing rate
| Defines the material and healing rate of ligaments.

|-
| LIGHT_GEN
|
| The creature will generate light, such as in adventurer mode at night.

|-
| LIKES_FIGHTING
|
| The creature will attack enemies rather than flee from them. This tag has the same effect on player-controlled creatures - included modded dwarves.

|-
| LISP
|
| Creature multiplies 'S' when talking. Ex: "My name isss Recisssiz."

|-
| LITTERSIZE
|
* minumum
* maximum
| Determines the random chance of how many creatures are generated when giving birth. [LITTERSIZE:1:2]

|-
| LOCKPICKER
|
| Lets a creature open doors that are set to forbidden in Fortress Mode.

|-
| LOOSE_CLUSTERS
|
| The creatures will scatter if they have this tag, or form tight packs if they don't.
|}

<div align="center">
{{alphabetical TOC}}
</div>

==M==
{| {{prettytable}}
|- bgcolor="#ddd"
! width="20%" | Token
! width="20%" | Arguments
! width="60%" | Description

|-
| MAGMA_VISION
|
| Creature's able to see while covered in magma.

|-
| MALE
|
| all male

|-
| MANNERISM_??
|
*occassionally body part
| Adds a possible mannerism to the creature's profile.
Refer to {{L|Creature Token Mannerisms|Mannerisms}}

|-
| MATERIAL
|
*material id
| Begins defining a new material.{{verify}}

|-
| MATERIAL_BREATH_ATTACK
|
* {{L|material token}}
* breath attack type (TRAILING_DUST_FLOW, TRAILING_VAPOR_FLOW, TRAILING_GAS_FLOW, SOLID_GLOB, LIQUID_GLOB, UNDIRECTED_GAS, UNDIRECTED_VAPOR, UNDIRECTED_DUST)
| Creates an attack referencing a material, using a given type of breath attack.

|-
| MAXAGE
| min:max
| range of time in which death from old age may occur

|-
| MEANDERER
|
| Gives a creature random movement.

|-
| MEGABEAST
|
| Appears on fortress territory in Fortress Mode occasionally. Implies SEMIMEGABEAST. Also can be worshipped

|-
|MENT_ATT_CAP_PERC
|
*ATTRIBUTE Token
*Cap %
|Default is 200. This means you can increase your attribute to 200% of its starting value (or the average value + your starting value if that is higher).

|-
| MENT_ATT_RANGE
|
*ATTRIBUTE
*lowest:lower:low:median:high:higher:highest | sets up a mental attribute's range of values. Max of 5000.

|-
| MENT_ATT_RATES
|
*ATTRIBUTE Token
*cost to improve
*unused counter rate
*rust counter rate
*demotion counter rate
| Attribute gain/decay rates. Defaults for are 500:2:3:2, except for RECUPERATION and DISEASE_RESISTANCE that don't have change rates. The last three slots may be replaced by NONE.

|-
| MILKABLE
|
* {{L|material token}}
* frequency
| Allows the creature to be milked.

|-
| MISCHIEVIOUS
|
| Will pull any levers it comes across. Also makes creature spawn invisible and with several ranks in Ambusher. "They go on little missions to mess with various fortress buildings, not just levers."

|-
| MOUNT
|
| Creature may be used as a mount

|-
| MOUNT_EXOTIC
|
| You need the Dungeon master noble to mount the creature.

|-
| MULTIPLE_LITTER_RARE
|
| Makes litters with more than one offspring rare.

|-
| MULTIPLY_VALUE
|
*Multiplier
| multiplies value of materials

|-
| MUNDANE
|
| Marks if the creature is an actual real-life creature. Only used for age-names at present.
|}

<div align="center">
{{alphabetical TOC}}
</div>

==N==
{| {{prettytable}}
|- bgcolor="#ddd"
! width="20%" | Token
! width="20%" | Arguments
! width="60%" | Description
|-
| NAME
| singular:plural:adjective
| The generic name for any creature of this type - will be used when distinctions between caste are unimportant. For names for specific castes, use CASTE_NAME instead.

|-
| NATURAL
|
| Animal is considered to be natural.

|-
| NATURAL_SKILL
| skill:value
| The creature possesses this skill at this level inherently. It begins with this skill at this level, and the skill may never rust below this level.

|-
| NIGHT_CREATURE_BOGEYMAN
|
| Found on bogeymen. Presumably makes the creature attack the player at night in hordes like bogeymen do.

|-
| NIGHT_CREATURE_HUNTER
|
| If this creature has SPOUSE_CONVERTER, it will actively attempt to seek out potential conversion targets, abduct them, and convert them. Night creatures will seek out one SPOUSE_CONVERSION_TARGET of the opposite sex, convert them, and then have children with them. NIGHT_CREATURE_HUNTERs without SPOUSE_CONVERTER will not be placed.

|-
| NO_AUTUMN
|
| does not appear this season.

|-
| NO_DIZZINESS
|
| Creature cannot become dizzy

|-
| NO_DRINK
|
| Creature does not need to drink.

|-
| NO_EAT
|
| Creature does not need to eat.

|-
| NO_FEVERS
|
| Creature cannot suffer fevers

|-
| NO_SLEEP
|
| Creature does not need to sleep.

|-
| NO_SPRING
|
| does not appear this season.

|-
| NO_SUMMER
|
| does not appear this season.

|-
| NO_THOUGHT_CENTER_FOR_MOVEMENT
|
| Probably shorthand for movement being unaffected by damage in general.

|-
| NO_WINTER
|
| does not appear this season.

|-
| NOBONES
|
| Creature has no bones.

|-
| NOBREATHE
|
| Creature doesn't need to breathe or have [BREATHE] parts in body. Cannot drown or be strangled.

|-
| NOCTURNAL
|
| Sets if the creature is active in night.

|-
| NOEMOTION
|
| The creature has no emotions, and does not rage.

|-
| NOEXERT
|
| Creature can't become tired or over-exerted.

|-
| NOFEAR
|
| Creature doesn't feel fear and will never run away from battle.

|-
| NOMEAT
|
| Creature will not drop meat on butcher.

|-
| NONAUSEA
|
| Creature can't vomit.

|-
| NOPAIN
|
| Creature doesn't feel pain.

|-
| NORMAL
| ???
| Unknown. Found in string dump.

|-
| NOSKIN
|
| Creature will not drop skin on butcher.

|-
| NOSKULL
|
| Creature will not drop skull on butcher, rot, or decay of severed head.

|-
| NOSMELLYROT
|
| Does not produce miasma when rotting

|-
| NOSTUCKINS
|
| Weapons can't be stuck in creature.

|-
| NOSTUN
|
| Creature can't be stunned. Evidence suggests creatures with this tag never wake up from sleep in Fortress Mode.

|-
| NOT_BUTCHERABLE
|
| Cannot be butchered

|-
| NOTHOUGHT
|
| Creature doesn't think, or doesn't require a [BRAIN] body part.
|}

<div align="center">
{{alphabetical TOC}}
</div>

==P==
{| {{prettytable}}
|- bgcolor="#ddd"
! width="20%" | Token
! width="20%" | Arguments
! width="60%" | Description
|-
| PACK_ANIMAL
|
| Allows the creature to be used as a pack animal. Currently only used by merchants.

|-
| PARALYZEIMMUNE
|
| The creature is immune to all paralyzing special attacks.

|-
| PATTERNFLIER
|
|

|-
| PEARL
|
| Creature will generate pearls.

|-
| PENETRATEPOWER
| value
| Controls the ability of vermin to find a way into containers when they are eating food from your stockpiles. Wood and cloth objects roll a 0-9 and if it's greater than the penetrate power, their contents escape for the time being. Other objects roll a 0-99.

|-
| PERSONALITY
|
*ATTRIBUTE
*lowest:median:highest
| Determines the range and chance of personality traits. Standard is 0:50:100. See [[DF2010:Personality_trait|Personality traits]] for more info.

|-
| PET
|
| Allows the creature to be tamed.

|-
| PET_EXOTIC
|
| You need a Dungeon master noble in your fortress for the creature to be tamable (but any Animal trainer can do the taming).

|-
| PETVALUE
| value
| How valuable a tamed animal/pet is. Actual cost in points in the embarking screen is (PETVALUE/2)+1 for an untrained animal, PETVALUE+1 for a trained(War or Hunting) one. Note that for an animal to be selectable in this screen, it must have the COMMON_DOMESTIC token.

|-
|PHYS_ATT_CAP_PERC
|
*ATTRIBUTE Token
*Cap %
|Default is 200. This means you can increase your attribute to 200% of its starting value (or the average value + your starting value if that is higher).

|-
| PHYS_ATT_RANGE
|
*ATTRIBUTE
*lowest
*lower
*low
*median
*high
*higher
*highest
| sets up a physical attribute's range of values. Max of 5000.

|-
| PHYS_ATT_RATES
|
*ATTRIBUTE Token
*cost to improve
*unused counter rate
*rust counter rate
*demotion counter rate
| Attribute gain/decay rates. Defaults for are 500:2:3:2, except for RECUPERATION and DISEASE_RESISTANCE that don't have change rates. The last three slots may be replaced by NONE.

|-
| PLUS_BP_GROUP
|
*BY_TYPE, BY_CATEGORY, or BY_TOKEN
*body type, category, or token
| Adds a body part group to selected body part group.

|-
| PLUS_MATERIAL
|
*material
| Adds a material to selected materials.

|-
| PLUS_TISSUE_LAYER
|
*TISSUE
*BY_CATEGORY, BY_TYPE, BY_TOKEN
*Location - category, type, or token
| Adds a tissue to those selected

|-
| PLUS_TL_GROUP
|
*TISSUE
*BY_CATEGORY, BY_TYPE, BY_TOKEN
*Location - category, type, or token
*tissue
| continues a selection of tissue layers

|-
| POP_RATIO
|
| Weighted population of caste; Lower is rarer. Not to be confused with FREQUENCY.

|-
| POPULATION_NUMBER
| min:max
| The minimum/maximum numbers of how many of these creatures can show up on a map per year.

|-
|POWER
|
|Allows the being to represent itself as a deity. Requires CAN_SPEAK to actually do anything more than settle at a location.

|-
| PREFSTRING
| string
| Sets what other creatures like about this creature. "Urist likes dwarves for their beards." Multiple entries will be chosen from at random

|-
| PROFESSION_NAME
|
*Profession
*singular
*plural
| The generic name for members of this profession, at the creature level. In order to give members of specific castes different names for professions, use CASTE_PROFESSION_NAME instead.
|}

<div align="center">
{{alphabetical TOC}}
</div>

==R==
{| {{prettytable}}
|- bgcolor="#ddd"
! width="20%" | Token
! width="20%" | Arguments
! width="60%" | Description
|-
| RELSIZE
|
*BY_CATEGORY, BY_TYPE, BY_TOKEN
*body category, type, or token
*Relsize
| Specifies a new relative size for a part than what is stated in the body plan. For example, Dwarves have larger livers.

|-
| REMAINS_COLOR
|
|

|-
| REMAINS_ON_VERMIN_BITE_DEATH
|
| Leaves remains when its attack causes it to die? Seems to go with DIE_WHEN_VERMIN_BITE.

|-
| REMAINS_UNDETERMINED
|
|

|-
| REMOVE_MATERIAL
|
*material token
| Removes a material from a creature

|-
| REMOVE_TISSUE
|
*material token
| Removes a tissue from a creature.
|}

<div align="center">
{{alphabetical TOC}}
</div>

==S==
{| {{prettytable}}
|- bgcolor="#ddd"
! width="20%" | Token
! width="20%" | Arguments
! width="60%" | Description
|-
| SAVAGE
|
| Allows creature to show up on (and limits it to) "savage" maps.

|-
| SECRETION
|
* {{L|material token}}
*Material State
*location secreted from (by_type, by_category, by_token)
*body part
*tissue layer
| creates a secreted material on given tissue on a given part of the body.

|-
| SELECT_ADDITIONAL_CASTE
|
*caste name
| adds an additional previously defined caste to the selection

|-
| SELECT_CASTE
|
*caste name, or ALL
| selects a previously defined caste

|-
| SELECT_MATERIAL
|
*MATERIAL NAME
| Selects the material. Can be ALL.

|-
| SELECT_TISSUE
|
*tissue token
| Selects a tissue for editing.

|-
| SELECT_TISSUE_LAYER
|
*TISSUE
*BY_CATEGORY, BY_TYPE, BY_TOKEN
*Location - category, type, or token | Selects a tissue at a location
* (optional) FRONT, BACK, LEFT, RIGHT, TOP, BOTTOM, AROUND.
| Selects a tissue layer for descriptor and cosmetic purposes.

|-
| SEMIMEGABEAST
|
| Appears as boss creature in quests. Makes history by rampaging around towns. Possibly inhabits non-mountain caves.

|-
| SET_BP_GROUP
|
*selection criteria BY_TYPE, BY_CATEGORY, BY_TOKEN
*category, type, or token
| selection token"

|-
| SET_TL_GROUP
|
*TISSUE
*BY_CATEGORY, BY_TYPE, BY_TOKEN
*Location - category, type, or token
*tissue
| begins a selection of tissue layers

|-
| SHEARABLE_TISSUE_LAYER
| ?
| Can be sheared for wool?

|-
| SKILL_LEARN_RATE
| {{L|skill_token}}:percentage
| The rate at which this creature learns this skill.

|-
| SKILL_LEARN_RATES
| percentage
| The rate at which this creature learns all skills.

|-
| SKILL_RATE
| {{L|skill_token}}:percentage:value:value:value
| As SKILL_RATES for individual skills.

|-
| SKILL_RATES
|
*% of improvement points you get
*unused counter rate
*rust counter rate
*demotion counter rate
| Affects skill gain and decay. Lower numbers in the last three slots make decay occur faster ([SKILL_RATES:100:1:1:1] would cause rapid decay). The counter rates may also be replaced with NONE.
Default is [SKILL_RATES:100:8:8:16]. [SLOW_LEARNER] changes the 100 to a 50.

|-
| SKILL_RUST_RATE
| {{L|skill_token}}:value:value:value
| The rate at which this skill decays. Lower values cause the skill to decay faster.

|-
| SKILL_RUST_RATES
| {{L|skill_token}}:value:value:value
| The rate at which all skills decay. Lower values cause the skills to decay faster.

|-
| SLOW_LEARNER
|
| Similar to [CAN_LEARN], but slower; skills are gained at a fraction of the rate. Present in the entries for ogres and giants; can be applied to civ or player races.

|-
| SMALL_REMAINS
|
| If a creature has this token, it'll leave "remains" instead of a corpse.

|-
| SOLDIER_ALTTILE
| 'character' or tile number
| If this creature is active in its civilization's military, it will blink between its default tile and this one.

|-
| SPEECH
| speech file
| Boasting speeches relating to killing this creature. Examples include dwarf.txt and elf.txt in the Speech folder in Data.u

|-
| SPEED
| value
| Sets the creatures' movement and work speed, 1000/[100 + SPEED X] is the resulting effect on creatures movement and work rates from default. See [http://df.magmawiki.com/index.php/Speed/ Speed] for more information.

|-
| SPHERE
|
*sphere name
| Sets what religious spheres the creature is aligned to, for purposes of being worshipped via the [POWER] token. Also affects the layout of hidden fun stuff, and the creature's name.

|-
| SPOUSE_CONVERSION_TARGET
|
| This creature can be converted by a night creature with SPOUSE_CONVERTED.

|-
| SPOUSE_CONVERTER
|
| Enables the creature to convert SPOUSE_CONVERSION_TARGETs into CONVERTED_SPOUSE castes of its species. The creature won't actually actively do this unless it also has NIGHT_CREATURE_HUNTER, however.

|-
| SWIM_SPEED
|
*speed
| How fast the creature swims. Typically 2500 (0.38 times the default speed).

|-
| SWIMS_INNATE
|
| The creature naturally knows how to swim, as opposed to [SWIMS_LEARNED] below. Currently, an AI bug prevents this from being useful on PC races in fortress mode.

|-
| SWIMS_LEARNED
|
| The creature doesn't know how to swim unless it has learned the skill. Requires [CAN_LEARN], obviously.

|}

<div align="center">
{{alphabetical TOC}}
</div>

==T==
{| {{prettytable}}
|- bgcolor="#ddd"
! width="20%" | Token
! width="20%" | Arguments
! width="60%" | Description
|-
| TENDONS
|
* {{L|material token}}
*healing rate
| Defines the material and healing rare of tendons.

|-
| THICKWEB
|
| The creature's webs can catch larger creatures. May imply [AMBUSHPREDATOR].

|-
| TISSUE
| name
| Begins defining a tissue in the creature file.

|-
| TISSUE_LAYER
|
*BY_TYPE, BY_CATEGORY, BY_TOKEN
*TYPE,CATEGORY, or TOKEN
*TISSUE
*LOCATION
| Adds the tissue layer to wherever it is required.
Non-argument Locations can be FRONT, RIGHT, LEFT, TOP, BOTTOM. Argument locations are AROUND and CLEANS, requiring a further body part and a % of coverage/cleansing

|-
| TISSUE_LAYER_OVER
|
*BY_TYPE, BY_CATEGORY, BY_TOKEN
*TYPE,CATEGORY, or TOKEN
*TISSUE
*LOCATION
| Presumably a counterpart to TISSUE_LAYER_UNDER (see below).

|-
| TISSUE_LAYER_UNDER
|
*BY_TYPE, BY_CATEGORY, BY_TOKEN
*TYPE,CATEGORY, or TOKEN
*TISSUE
| Adds the tissue layer under a given part.
For example an Iron Man has a gaseous poison within and this tissue (GAS is its name) has the token [TISSUE_LEAKS] and its state is GAS so when you puncture the iron outside and damage this tissue it leaks gas (can have a syndrome by using a previous one in the creature sample.) [TISSUE_LAYER_UNDER:BY_CATEGORY:ALL:{tissue}] {tissue} is what will be under the TISSUE_LAYER here is an example Tissue from Iron Man
[TISSUE:GAS]
[TISSUE_NAME:gas:NP] [TISSUE_MATERIAL:LOCAL_CREATURE_MAT:GAS] [TISSUE_MAT_STATE:GAS] [RELATIVE_THICKNESS:50] [TISSUE_LEAKS] [TISSUE_SHAPE:LAYER]

|-
| TISSUE_LAYER_APPEARANCE_MODIFIER
|
*QUALITY
*lowest:lower:low:median:high:higher:highest
| sets the range of qualities, including LENGTH, DENSE, HIGH_POSITION, CURLY, GREASY, WRINKLY

|-
| TISSUE_STYLE_UNIT
|
*tissue
*shaping
| sets tissue to be in a certain shape, mostly used with tissues HAIR, BEARD, MOUSTACHE, SIDEBURNS.

|-
| TL_COLOR_MODIFIER
| COLOR:freq:COLOR:freq etc
| Creates a list of color patterns, giving each a frequency.

|-
| TLCM_GENETIC_MODEL
|
| tissue layer color modifier is passed to offspring genetically?

|-
| TLCM_IMPORTANCE
|
*number
| Presumably modifies the importance of the tissue layer color modifier, for description purposes.
HOWEVER using this appears to remove all mention of colour from creature descriptions. It does not appear in any default creatures.

|-
| TLCM_NOUN
|
*name
*SINGULAR or PLURAL
| names the tissue layer color modifier, and determines the noun

|-
| TLCM_TIMING
|
*ROOT
*start change window years:days:end change window years:days
| determines the point in the creature's life where the color change begins

|-
| TRADE_CAPACITY
|
| How much the creature can carry when used by merchants.

|-
| TRAINABLE
|
| Implies both [TRAINABLE_HUNTING] and [TRAINABLE_WAR].

|-
| TRAINABLE_HUNTING
|
| Can be trained as hunting beasts by way of kennels.

|-
| TRAINABLE_WAR
|
| Can be trained as war beasts by way of kennels.

|-
| TRANCES
|
| Allows the creature to go into martial trances.

|-
| TRAPAVOID
|
| The creature is immune to traps. Probably every procedurally generated megabeast has this.

|-
| TRIGGERABLE_GROUP
| min:max
| A large swarm of vermin can be disturbed, usually in Adventure mode.{{verify}}

|-
| TSU_NOUN
|
*noun
*SINGULAR or PLURAL
| Noun for the TISSUE_STYLE_UNIT, used in the description of the tissue layer's style.
|}

<div align="center">
{{alphabetical TOC}}
</div>

==U==
{| {{prettytable}}
|- bgcolor="#ddd"
! width="20%" | Token
! width="20%" | Arguments
! width="60%" | Description

|-
| UBIQUITOUS
|
| Creature will occur in every region with the correct biome. Does not apply to evil/good tags.

|-
| UNDERGROUND_DEPTH
|
*mindepth
*maxdepth
| Depth the creature appears underground. Numbers can be from 1 to 5. Only magma creatures use 4 or 5 in the default raws. A single argument may be used instead of min and max. Dwarven civilizations will only export (via the embark screen or caravans) things that available at depth 1.

|-
| UNDERSWIM
|
| Creature swims under the water and can't be seen.{{verify}}

|-
| UNIQUE_DEMON
|
| Typically found on genned [[demon]]s; sets the creature as capable of "emerging from the underworld" and taking over during worldgen.

|-
| USE_CASTE
|
*caste token
|

|-
| USE_MATERIAL
|
*new material token
*old material id
| Uses a local creature mat to define a new material?{{verify}}

|-
| USE_MATERIAL_TEMPLATE
|
*new material token
*material template
| Loads a material, and gives it a shortname for later reference

|-
| USE_TISSUE
|
*new tissue token
*old tissue id
| Uses a local creature mat to define a new material?{{verify}}

|-
| USE_TISSUE_TEMPLATE
|
*new tissue token
*tissue template
| Loads a tissue template listed in OBJECT:TISSUE_TEMPLATE files, such as tissue_template_default.txt.

|-
| UTTERANCES
|
| Changes the language of the creature into an unintelligible mess.
|}

<div align="center">
{{alphabetical TOC}}
</div>

==V==
{| {{prettytable}}
|- bgcolor="#ddd"
! width="20%" | Token
! width="20%" | Arguments
! width="60%" | Description
|-
| VEGETATION
|
| unknown

|-
| VIEWRANGE
| value
| Value should determine how close you have to get to a critter before it attacks (or prevents adv mode travel etc.) Default is 20.

|-
| VERMIN_BITE
|
*amount
*verb (bitten, stung)
* {{L|material token}}
| vermin bites, and injects something.

|-
| VERMIN_EATER
|
| Vermin can nibble food?{{verify}}

|-
| VERMIN_FISH
|
| Acts like a fish

|-
| VERMIN_GROUNDER
|
| The creature can be picked up if you stand over it. (Requires confirmation)
'I think this is a habitat flag like VERMIN_SOIL, VERMIN_CHASM, etc. It seems to appear on creatures that don't otherwise have one. – Peristarkawan 17:27, 24 May 2007 (EDT)'

|-
| VERMIN_HATEABLE
|
| Some dwarves will hate the creature and get unhappy thoughts when around it.

|-
| VERMIN_MICRO
|
| This makes the creature move in a swarm of creatures of the same race as it. I.E. Swarm of flies, swarm of ants, etc.

|-
| VERMIN_NOFISH
|
| The creature cannot be caught by fishing.

|-
| VERMIN_NOROAM
|
| The creature will not be observed randomly roaming about the map.

|-
| VERMIN_NOTRAP
|
| The creature cannot be caught in baited animal traps; however, a "catch live land animal" task may still be able to capture one if a dwarf finds one roaming around.

|-
| VERMIN_ROTTER
|
| Present on flies, knuckle worms, acorn flies, and blood gnats. Probably means either the creature is attracted to rot, the creature speeds rotting, or both.

|-
| VERMIN_SOIL
|
| The creature randomly appears near dirt or mud.

|-
| VERMIN_SOIL_COLONY
|
| The vermin will appear in a single tile cluster of many vermin, such as a colony of ants.

|-
| VERMINHUNTER
|
| A creature with this tag will hunt down vermin and kill them. Sometimes they will eat the vermin, but most of the time they will bring it to their owner. This tag also makes impossible to assign an owner to the animal. The animal chooses it's own owner instead (like a cat). If assigned to a playable race, members of that race will ONLY be able to eat vermin.

|-
| VESPERTINE
|
| Sets if the creature is active in evening.
|}

<div align="center">
{{alphabetical TOC}}
</div>

==W==
{| {{prettytable}}
|- bgcolor="#ddd"
! width="20%" | Token
! width="20%" | Arguments
! width="60%" | Description
|-
| WAGON_PULLER
|
| Allows the creature to pull caravan wagons.

|-
| WEBBER
|
* {{L|material token}}
| allows the creature to web, and defines what the webs are made of.

|-
| WEBIMMUNE
|
| The creature will not get caught in thick webs.
|}

==Attack Tokens==
{| {{prettytable}}
|- bgcolor="#ddd"
! width="20%" | Token
! width="20%" | Arguments
! width="60%" | Description

|-
| ATTACK_SKILL
|
*skill used ({{L|Skill tokens}})
| defines the attack skill used

|-
| ATTACK_VERB
| 2nd person:3rd person
| descriptive text for the attack

|-
| ATTACK_CONTACT_PERC
|
*% value
| amount of available tissue used in attack

|-
| ATTACK_PENETRATION_PERC
|
*% value
| probably amount of material that makes contact when penetration is done

|-
| ATTACK_FLAG_EDGE
|
| attack type

|-
| ATTACK_FLAG_WITH
|
| In adventure mode, displays the name of the body part used by an attack when announcing the attack.

|-
| ATTACK_PRIORITY
|
*MAIN or SECOND
| use of the attack in combat. Secondary attacks are only used if main attacks are impossible.

|-
| ATTACK_FLAG_CANLATCH
|
| Enables an attacker to occasionally latch on with the bodypart used by an attack when an attack with this flag in it's definition is made.

|-
| ATTACK_VELOCITY_MODIFIER
| number
| Modifies the attack velocity. Believed to be percent based (so 100 would be "normal"). May be on same scale as weapon velocity (where 1000 is "normal").

|-
| SPECIALATTACK_INJECT_EXTRACT
|
* {{L|material token}}
*state (SOLID, LIQUID, GAS)
*min:max
| attack type addition that injects a material into the victim.

|-
| SPECIALATTACK_SUCK_BLOOD
| min:max
| Successful attack draws out an amount of blood randomized between the min and max value.
|}

==Important Related Tokens==
These next groups of tokens include several tokens that are not technically classified as creature tokens in string dump, but bear mentioning in this as they are used frequently in creature raws. (Some regular creature tokens may also be reprinted for the sake of ease of navigation)

===Tissue Modification===
This next group of tokens deals setting and modifying tissue properties. (See also [[DF2010:Tissue definition token]])

{| {{prettytable}}
|- bgcolor="#ddd"
! width="20%" | Token
! width="20%" | Arguments
! width="60%" | Description

|-
| INSULATION
|
*value
| Tissue supplies the creature with heat insulation. Higher values result in more insulation.

|-
| PLUS_TISSUE_LAYER
|
*TISSUE
*BY_CATEGORY, BY_TYPE, BY_TOKEN
*Location - category, type, or token
| Adds a tissue to those selected

|-
| PLUS_TL_GROUP
|
*TISSUE
*BY_CATEGORY, BY_TYPE, BY_TOKEN
*Location - category, type, or token
*tissue
| continues a selection of tissue layers

|-
| SELECT_TISSUE
|
*tissue token
| Selects a tissue for editing.

|-
| SELECT_TISSUE_LAYER
|
*TISSUE
*BY_CATEGORY, BY_TYPE, BY_TOKEN
*Location - category, type, or token | Selects a tissue at a location
* (optional) FRONT, BACK, LEFT, RIGHT, TOP, BOTTOM, AROUND.
| Selects a tissue layer for descriptor and cosmetic purposes.

|-
| SET_LAYER_TISSUE
|
| Sets a tissue layer to be made of a different tissue.

|-
| TISSUE_LAYER
|
*BY_TYPE, BY_CATEGORY, BY_TOKEN
*TYPE,CATEGORY, or TOKEN
*TISSUE
*LOCATION
| Adds the tissue layer to wherever it is required.
Non-argument Locations can be FRONT, RIGHT, LEFT, TOP, BOTTOM. Argument locations are AROUND and CLEANS, requiring a further body part and a % of coverage/cleansing

|-
| TISSUE_LAYER_OVER
|
*BY_TYPE, BY_CATEGORY, BY_TOKEN
*TYPE,CATEGORY, or TOKEN
*TISSUE
*LOCATION
| Presumably a counterpart to TISSUE_LAYER_UNDER (see below).

|-
| TISSUE_LAYER_UNDER
|
*BY_TYPE, BY_CATEGORY, BY_TOKEN
*TYPE,CATEGORY, or TOKEN
*TISSUE
| Adds the tissue layer under a given part.
For example an Iron Man has a gaseous poison within and this tissue (GAS is its name) has the token [TISSUE_LEAKS] and its state is GAS so when you puncture the iron outside and damage this tissue it leaks gas (can have a syndrome by using a previous one in the creature sample.) [TISSUE_LAYER_UNDER:BY_CATEGORY:ALL:{tissue}] {tissue} is what will be under the TISSUE_LAYER here is an example Tissue from Iron Man
[TISSUE:GAS]
[TISSUE_NAME:gas:NP] [TISSUE_MATERIAL:LOCAL_CREATURE_MAT:GAS] [TISSUE_MAT_STATE:GAS] [RELATIVE_THICKNESS:50] [TISSUE_LEAKS] [TISSUE_SHAPE:LAYER]

|-
| TISSUE_LAYER_APPEARANCE_MODIFIER
|
*QUALITY
*lowest:lower:low:median:high:higher:highest
| sets the range of qualities, including LENGTH, DENSE, HIGH_POSITION, CURLY, GREASY, WRINKLY

|-
| TISSUE_LEAKS
|
| The selected tissue leaks out of the creature when the layers above it are pierced. As per an iron man's internal poison gas.

|-
| TISSUE_MATERIAL
|
*VALUE (material)
*MATERIAL (material subtype)
| Defines the tissue material. VALUE can be LOCAL_CREATURE_MAT, INORGANIC etc. MATERIAL is a subtype of the material, e.g. [TISSUE_MATERIAL:INORGANIC:BRONZE]

|-
| TISSUE_STYLE_UNIT
|
*tissue
*shaping
| sets tissue to be in a certain shape, mostly used with tissues HAIR, BEARD, MOUSTACHE, SIDEBURNS.

|-
| TL_COLOR_MODIFIER
| COLOR:freq:COLOR:freq etc
| Creates a list of color patterns, giving each a frequency.

|-
|TL_CONNECTS
|
| Presumably gives the CONNECTS attribute to selected layers.

|-
|TL_HEALING_RATE
|
| Presumably changes the HEALING_RATE of the selected tissue layers.

|-
|TL_MAJOR_ARTERIES
|
| Gives Major Artery attribute to selected layers.

|-
|TL_PAIN_RECEPTORS
|
| Seems to set new number of pain receptors for selected tissue layers.

|-
|TL_RELATIVE_THICKNESS
|
| Seems to set new relative thickness for selected tissue layers.

|-
|TL_VASCULAR
|
| Seems to set new a VASCULAR value (which modulates bleeding) for selected tissue layers.

|}

==See Also==
*[[DF2010:Body detail plan token]]
*[[DF2010:Body token]]
*[[DF2010:Material definition token]]
*[[DF2010:Syndrome]]
*[[DF2010:Tissue definition token]]

{{Category|Modding}}
{{Category|Tokens}}

v0.31:Creature token

2011-02-23T04:59:10Z

Bohandas: fixed format of see also section

{{av}}{{Quality|Exceptional}}

Tentative at best in some cases.

__NOTOC__

<div align="center">
{{alphabetical TOC}}
</div>

==A==
{| {{prettytable}}
|- bgcolor="#ddd"
! width="20%" | Token
! width="20%" | Arguments
! width="60%" | Description
|-
| ALCOHOL_DEPENDENT
|
| Creature needs alcohol to get through the working day.

|-
| ALL_ACTIVE
|
| Sets if the creature is active in day, night, and twilight. Seems to be a separate value from DIURNAL/NOCTURNAL/CREPUSCULAR, rather than implying them.

|-
| ALTTILE
|
| If set, the creature will blink between its [TILE] and its [ALTTILE].

|-
| AMBUSHPREDATOR
|
| Makes the creature start out hidden. Used by {{L|giant cave spider}}s. May make {{L|web}}s hidden too.

|-
| AMPHIBIOUS
|
| Allows a creature to breathe with or without {{L| water}}. Implies [AQUATIC].

|-
| APP_MOD_DESC_RANGE
| ?
| ?

|-
| APP_MOD_GENETIC_MODEL
|
|

|-
| APP_MOD_IMPORTANCE
|
*number
| Determines how important the appearance modifier is, for determining whether it shows up in the creature description.{{verify}}

|-
| APP_MOD_NOUN
|
*noun
*SINGULAR or PLURAL
| creates a noun for the appearance and whether it is singular or plural

|-
| APP_MOD_RATE
|
*Rate (integer)
*Scale (DAILY, YEARLY)
*min:max of growth
*start year:start day
*end year:end day
| setting the growth rate of the modifier. The last two tokens can be replaced by NO_END to have growth continue indefinitely.

|-
| APPLY_CREATURE_VARIATION
|
*CV TEMPLATE NAME
| Loads the Creature Variation Template specified.

|-
| APPLY_CURRENT_CREATURE_VARIATION
|
| Applies loaded Creature Variation

|-
| AQUATIC
|
| Allows a creature to breathe underwater, but causes it to "drown" out of {{L| water}}.

|-
| ARENA_RESTRICTED
|
| Does not appear in arena mode list

|-
| ARTIFICIAL_HIVEABLE
|
| Can be kept in artificial hives by beekeepers.

|-
| ATTACK
|
*token
*bodypart
*selection criteria
*location
| Defines the attack name, and the body part used. See [[#Attack Tokens|below]] for valid subtokens
'''Example:'''<br />
[ATTACK:GORE:BODYPART:BY_CATEGORY:HORN]<br />
''GORE'' : name of the attack<br />
''BODYPART:BY_CATEGORY:HORN'' : the horn is used to attack (presuming the creature has one)

|-
| ATTACK_TRIGGER
| pop:exported wealth:created wealth
| stages when a megabeast will attack a site

|}

<div align="center">
{{alphabetical TOC}}
</div>

==B==
{| {{prettytable}}
|- bgcolor="#ddd"
! width="20%" | Token
! width="20%" | Arguments
! width="60%" | Description
|-
| BABY
| integer
| age at which creature is considered a child. Default is zero. One can think of this as the duration of the baby stage.

|-
| BABYNAME
| singular:plural
| name at caste level

|-
| BEACH_FREQUENCY
|
| {{L|Whale}}s and {{L|Sea nettle jellyfish|jellyfish}} have this. Controls the beaching frequency of the creature.

|-
| BENIGN
|
| Determines whether creature can show up on "tame" maps (includes {{L|elephants}}), which will generally avoid dwarves, although they may chase and/or attack them if they get too close).

|-
| BIOME
|
* biome token
| Select a {{L|Biome}} the creature may appear in.

|-
| BLOOD, PUS, OTHER MATERIAL state definition
|
* {{L|material token}}
*matter state (LIQUID, GAS, SOLID)
| Controls bleeding behaviour

|-
| BODY
| body parts
| Draws body parts from OBJECT:BODY files (such as body_default.txt)
'''Example:'''<br />
[BODY:BODY_WITH_HEAD_FLAG:HEART:GUTS:BRAIN:MOUTH] <br />
This is the body from a {{L|Purring maggot}}. It creates a body with head, a heart, some guts, a brain, and a mouth. Thats all a maggot needs.

|-
| BODY_APPEARANCE_MODIFIER
|
*ATTRIBUTE
*lowest:lower:low:median:high:higher:highest
| These body modifiers give individual creatures different characteristics. In the case of HEIGHT, BROADNESS and LENGTH, the modifier is also a percentage change to the BODY_SIZE of the individual creature. The seven numbers afterward give a distribution of ranges. Each interval has an equal chance of occurring.
'''Example:'''<br />
[BODY_APPEARANCE_MODIFIER:LENGTH:90:95:98:100:102:105:110] <br />
''HEIGHT'' : marks the height to be changed <br />
''90:95:98:100:102:105:110'' : sets the range from the shortest (90% of the average height) to the tallest (110% of the average height) creature variation.

|-
| BODY_DETAIL_PLAN
| PlanName, PlanName:type:type:type:etc
| loads a plan listed OBJECT:BODY_DETAIL_PLAN files, such as b_detail_plan_default.txt. Mass applies USE_MATERIAL_TEMPLATE, mass alters RELSIZE, alters body part positions, and will allow tissue layers to be defined. Tissue layers are defined in order of skin to bone here.
'''Example:'''<br />
[BODY_DETAIL_PLAN:VERTEBRATE_TISSUE_LAYERS:SKIN:FAT:MUSCLE:BONE:CARTILAGE] <br />
This creates the detailed body of a {{L|fox}}, the skin, fat, muscle, bones and cartilage out of the vertebrate tissues.<br />
A {{L|Purring maggot|maggot}} would only need:<br />
''[BODY_DETAIL_PLAN:EXOSKELETON_TISSUE_LAYERS:SKIN:FAT:MUSCLE]''

|-
| BODY_SIZE
| years:days:size
| sets up size at a given time. Size is roughly equal to the creature's average weight in grams.
'''Example:'''<br />
[BODY_SIZE:0:0:10000]<br />
[BODY_SIZE:1:168:50000]<br />
[BODY_SIZE:12:0:220000]<br />
This describes the size of a {{L|minotaur}}. His birth size would be 10000 (~10 kg). With 1 year and 168 days he would be 50000 tall (~50 kg). As an adult (with 12 years) he would weight roughly 220 kg

|-
| BODYGLOSS
| gloss
| Substitutes body part text with replacement text. Draws gloss information from OBJECT:BODY files (such as body_default.txt)

|-
| BONECARN
|
| Creature 'eats' bones. Eating bones makes their happiness go up, but can cause death (suffocation){{verify}}. Implies CARNIVORE.

|-
| BP_APPEARANCE_MODIFIER
|
*QUALITY
*lowest:lower:low:median:high:higher:highest
| sets up the breadth of possibilities for appearance qualities for a selected BP group. EG. Eyes (CLOSE_SET, DEEP_SET, ROUND_VS_NARROW, LARGE_IRIS),Lips (THICKNESS), Nose (BROADNESS, LENGTH, UPTURNED, CONVEX), Ear (SPLAYED_OUT, HANGING_LOBES, BROADNESS, HEIGHT), Tooth (GAPS), Skull (HIGH_CHEEKBONES, BROAD_CHIN, JUTTING CHIN, SQUARE_CHIN), Neck (DEEP_VOICE, RASPY_VOICE), Head (BROADNESS, HEIGHT)

|-
| BUILDINGDESTROYER
| 1 or 2
| Allows a creature to destroy furniture and buildings. Value [1] targets mostly doors, hatches, furniture and the like. Value [2] targets anything not made with the b + C commands.
|}

<div align="center">
{{alphabetical TOC}}
</div>

==C==
{| {{prettytable}}
|- bgcolor="#ddd"
! width="20%" | Token
! width="20%" | Arguments
! width="60%" | Description

|-
| CAN_LEARN
|
| The creature gets skills and professions. Note that this token makes the creature unable to be butchered by an adventurer so it is not recommended for uncivilized monsters. Adventurers lacking this token can allocate but not increase attributes and skills. skills allocated will disappear on start.

|-
| CAN_SPEAK
|
| Can talk. Note that it is not necessary for a creature to gain social skills.

|-
| CANNOT_UNDEAD
|
| Cannot be turned into a zombie or skeletal undead

|-
| CANOPENDOORS
|
| Allows the creature to open doors.

|-
| CARNIVORE
|
| Creature ''only'' eats meat

|-
| CASTE
|
*name
| defines a caste

|-
| CASTE_ALTTILE
|
*tile number or "letter"
| Caste-specific alternate tile. Expects CASTE_TILE

|-
| CASTE_COLOR
|
*fg
*bg
*brightness
| Creature tile color of the caste.

|-
| CASTE_GLOWCOLOR
|
*fg
*bg
*brightness
| GLOWTILE color of the caste.

|-
| CASTE_GLOWTILE
|
*tile value or "letter"
| Caste-specific glowtile

|-
| CASTE_NAME
| singular:plural:adjective
| The name of the caste of the creature in the game.

|-
| CASTE_PROFESSION_NAME
|
*Profession
*singular
*plural
| alters the name of the given profession, caste-specific

|-
| CASTE_SOLDIER_ALTTILE
| 'character' or tile number
| Creatures of this caste active in their civilization's military will blink between their default tile and this one.

|-
| CASTE_SOLDIER_TILE
| 'character' or tile number
| Creatures of this caste active in their civilization's military will use this tile instead.

|-
| CASTE_SPEECH
| speech file?
| Possibly a caste-specific instance of the SPEECH token

|-
| CASTE_TILE
|
* tile number or "letter"
| Caste-specific creature tile.

|-
| CAVE_ADAPT
|
| Gives the creature a bonus in caves. Also causes [[Cave adaptation]].

|-
| CHANGE_BODY_SIZE_PERC
|
|

|-
| CHILD
| integer
| age at which creature is considered an adult. One can think of this as the duration of the child stage. Without this token, a creature will not reproduce in Fortress mode.

|-
| CHILD_BODYPART_GROUP
|
*master selection, BY_CATEGORY, BY_TYPE, BY_TOKEN.
*master location
*specific selection, BY_CATEGORY, BY_TYPE, BY_TOKEN.
*specific location
| selects all parts of a group to be used.

|-
| CHILDNAME
| singular:plural
| name at caste level

|-
| CLUSTER_NUMBER
|
*min
*max
| The minimum/maximum numbers of how many creatures per spawned cluster. Certain vermin fish use this token in combination with temperate ocean and river biome tokens to perform seasonal migrations.
e.g. [CLUSTER_NUMBER:1:3]

|-
|CLUTCH_SIZE
|
*min
*max
|Number of eggs laid in one sitting.

|-
| COLONY_EXTERNAL
|
| Caste hovers around colony.

|-
| COLOR
| foreground:background:brightness
| Color of the creature's tile.

|-
| COMMON_DOMESTIC
|
| Allows the creature to be brought with immigrants and when creating a new fortress, as long as the creature also includes at least one of the following tokens: PET, PACK_ANIMAL, WAGON_PULLER, MOUNT. In addition, the creature must be NATURAL rather than FANCIFUL

|-
| CONVERTED_SPOUSE
|
| Found only at caste level. Creatures of this caste's species with the SPOUSE_CONVERTER and NIGHT_CREATURE_HUNTER tokens will kidnap SPOUSE_CONVERSION_TARGETs of an appropriate sex and convert them into castes with CONVERTED_SPOUSE.

|-
| COOKABLE_LIVE
|
| Set this to allow the creature to be cooked in meals without first being butchered / fishcleaned.

|-
| COPY_TAGS_FROM
|
*CREATURE NAME
| Copies tags from another specified creature.

|-
| CREATURE
| name
| begins defining a new creature with the specified name.

|-
| CREATURE_CLASS
|
*classname
| Creature class. Can be anything, but only existing use is GENERAL_POISON. Appears to only be used for Syndromes. Supposedly can also be used for entity positions.

|-
| CREATURE_SOLDIER_TILE
| 'character' or tile number
| Creatures active in their civilization's military will use this tile instead.

|-
| CREATURE_TILE
| 'character' or tile number
| The symbol of the creature in ASCII mode.

|-
| CREPUSCULAR
|
| Sets if the creature is active at twilight. This tag functions as a combination of the two tags VESPERTINE and MATUTINAL.

|-
| CURIOUSBEAST_EATER
|
| Allows a creature to steal and eat edible items from a site.

|-
| CURIOUSBEAST_GUZZLER
|
| Allows a creature to (very quickly) drink your alcohol. Or spill the barrel to the ground. Also affects undead versions of the creature.

|-
| CURIOUSBEAST_ITEM
|
| Allows a creature to steal things (apparently the highest value it can find). Semimegabeast thievery is in Legends mode. Lightweight creatures can probably steal heavy items.

|-
| CV_ADD_TAG
|
*TAG NAME
| Adds a tag. Used in conjunction with creature variation templates.

|-
| CV_REMOVE_TAG
|
*TAG NAME
| Removes a tag. Used in conjunction with creature variation templates.
|}

<div align="center">
{{alphabetical TOC}}
</div>

==D==
{| {{prettytable}}
|- bgcolor="#ddd"
! width="20%" | Token
! width="20%" | Arguments
! width="60%" | Description

|-
| DEMON
|
| Typically found on genned [[demon]]s; sets the creature as a potential spawn for [[Hidden Fun Stuff]]

|-
| DESCRIPTION
| text
| A brief description of the creature type.

|-
| DIE_WHEN_VERMIN_BITE
|
| Dies upon attacking. Used for bee stings.

|-
| DIFFICULTY
| integer
| Toady: "Difficulty determines how deep it places them in adventure mode/reclaim caves, and the chance that they are wounded the first few river attacks." Also increases experience gain during adventure mode.

|-
| DIURNAL
|
| Sets if the creature is active in day.

|-
| DOES_NOT_EXIST
|
| Creature does not actually exist; used for fanciful creatures.

|-
| DRAGONFIREBREATH
|
| Creature breathes fire in a cone.
|}

<div align="center">
{{alphabetical TOC}}
</div>

==E==
{| {{prettytable}}
|- bgcolor="#ddd"
! width="20%" | Token
! width="20%" | Arguments
! width="60%" | Description

|-
| EGG_MATERIAL
|
* {{L|material token}}
*state (SOLID, LIQUID, or GAS)
| Egg material. Egg-laying creatures will define this 3 times, using LOCAL_CREATURE_MAT:EGGSHELL, LOCAL_CREATURE_MAT:EGG_WHITE, and then LOCAL_CREATURE_MAT:EGG_YOLK. Eggs will be made out of eggshell. Edibility is determined by tags on whites or yolk, but they otherwise do not exist.

|-
| EGG_SIZE
|
*size
| Size of creature's egg?

|-
| EQUIPMENT_WAGON
|
| Makes the creature into a large 3x3 creature responsible for carrying trade goods, pulled by two [WAGON_PULLER]s and driven by a merchant.

|-
| EQUIPS
|
| Allows the creature to wear or wield items.

|-
| EVIL
|
| Determines whether creature can show up on "evil" maps

|-
| EXTRAVISION
|
| Creature can see regardless of whether it has working eyes.
|}

<div align="center">
{{alphabetical TOC}}
</div>

==F==
{| {{prettytable}}
|- bgcolor="#ddd"
! width="20%" | Token
! width="20%" | Arguments
! width="60%" | Description
|-
| FANCIFUL
|
| Makes every civilization know about the creature. The creature won't occur in regular material preference lists. The tag also adds some art value modifiers. Used for things like dragons and other legendary creatures.

|-
| FEATURE_ATTACK_GROUP
|
| Found on subterranean animalmen.

|-
| FEMALE
|
| Inside a female caste, sets femaleness. Outside of a caste, sets all individuals female unless overridden by caste.

|-
| FIREBREATH
|
| The creature breathes fire projectiles (as opposed to DRAGONFIREBREATH, which is in a cone).

|-
| FIREIMMUNE
|
| As of version v0.28.181.40d, the FIREIMMUNE token had no effect on a creature's resistance to flame or heat. However, it did affect ability to swim in magma in adventure mode, as well as display of "You are caught in a pool of magma!" warning messages. It is unknown if these effects persist in DF 2010.

|-
| FIREIMMUNE_SUPER
|
| The creature is immune to DRAGONFIREBREATH. Implies FIREIMMUNE.

|-
| FISHITEM
|
| Needs to be cleaned at a fishery

|-
| FIXED_TEMP
| temperature
| The natural heat generated by the creature.

|-
| FLEEQUICK
|
| Determines how soon a creature flees in a losing battle.

|-
| FLIER
|
| Allows a creature to fly. Fortress Mode pathfinding only partially incorporates pathfinding - flying dwarves need a land path to exist between them and an area in order to access it, but as long as one such path exists, they do not need to use it, instead being able to fly over intervening obstacles.

|-
| FREQUENCY
|
*number, max 100
| Determines the time between creature spawns in Fortress Mode. Higher is more occurrences per time unit. Creatures without a frequency statement default to 50. Almost all others have either [FREQUENCY:5] or [FREQUENCY:100]. Not to be confused with POP_RATIO
|}

<div align="center">
{{alphabetical TOC}}
</div>

==G==
{| {{prettytable}}
|- bgcolor="#ddd"
! width="20%" | Token
! width="20%" | Arguments
! width="60%" | Description
|-
| GENERAL_BABY_NAME
| singular:plural
| name at creature level

|-
| GENERAL_CHILD_NAME
| singular:plural
| name at creature level

|-
| GENERATED
|
| Found on procedurally generated creatures like {{L|Forgotten beast}}s, (biome name) {{L|titan}}s, {{L|Demon}}s, and {{L|night creature}}s.

|-
| GETS_INFECTIONS_FROM_ROT
|
| creature can be infected by rot

|-
| GETS_WOUND_INFECTIONS
|
| creature can get infections from wounds

|-
| GLOWCOLOR
|
*foreground
*background
*brightness
| The colour of the GLOWTILE of the creature.

|-
| GLOWTILE
| ascii character
| If present, the being glows in the dark (generally used for Adventure Mode). The tile is what replaces the being's current tile when it is obscured from your sight by darkness. The default setting for kobolds (a yellow quotation mark) provides a nice "glowing eyes" effect. The game is also hardcoded to automatically convert quotation mark GLOWTILES into apostrophes if the creature has lost one eye. This works at the generic creature level - for caste-specific glow tiles, use CASTE_GLOWTILE instead.

|-
| GNAWER
| verb (gnawed)
| The creature chews on food barrels and bags.

|-
| GO_TO_END
|
| uncertain use, definitely refers to Creature Variants template

|-
| GO_TO_START
|
| uncertain use, definitely refers to Creature Variants template

|-
| GOOD
|
| Determines whether creature can show up on "good" areas. Eg. unicorn.

|-
| GRASSTRAMPLE
| value
| Determines the percentage chance of trampling and killing grass when a creature steps on it. Set [GRASSTRAMPLE:0] to make grass never trampled by the creature.

|-
| GRAVITATE_BODY_SIZE
|
| Creature Variants template command, alter body size.

|-
| GRAZER
|
*number
| Animals is a grazer. The higher the number, the less grass it needs.
|}

<div align="center">
{{alphabetical TOC}}
</div>

==H==
{| {{prettytable}}
|- bgcolor="#ddd"
! width="20%" | Token
! width="20%" | Arguments
! width="60%" | Description
|-
| HABIT
| type:probability
| Defines certain behaviors for the creature. The habit types are COLLECT_TROPHIES, COOK_PEOPLE, COOK_VERMIN, GRIND_VERMIN, COOK_BLOOD, GRIND_BONE_MEAL, EAT_BONE_PORRIDGE, USE_ANY_MELEE_WEAPON, and COLLECT_WEALTH. These may require the creature to have a lair to work properly.

|-
| HABIT_NUM
| number or TEST_ALL
| Unknown. All lists of HABITs are preceded by [HABIT_NUM:TEST_ALL]

|-
| HAS_NERVES
|
| This makes the creature susceptible to severed motor and sensory nerves when muscles are torn in limb, grasp and stance parts. Some butchering yields nervous tissue.

|-
| HIVE_PRODUCT
|
*number
*time
*item tokens
| What product is harvested from beekeeping.

|-
| HOMEOTHERM
|
| Default 'NONE'. The creature's normal body {{L|temperature}}
|}

<div align="center">
{{alphabetical TOC}}
</div>

==I==
{| {{prettytable}}
|- bgcolor="#ddd"
! width="20%" | Token
! width="20%" | Arguments
! width="60%" | Description

|-
| IMMOBILE_LAND
|
| The creature is immobile while on land. Only works on AQUATIC creatures which can't breath on land.

|-
| IMMOLATE
|
| Will ignite, and potentially completely destroy, items the creature is standing on. Keep booze away from critters with this tag.

|-
| INTELLIGENT
|
| Implies CAN_SPEAK and CAN_LEARN. CAN_LEARN probably means the creature gets skills and professions. Not recommended for uncivilized monsters.

|-
| ITEMCORPSE
|
* {{L|item token}}:subtype
* {{L|material token}}
| Determines if the creature leaves behind a non-standard corpse (i.e. wood, statue, bars, ash from ghost etc).

|-
| ITEMCORPSE_QUALITY
|
| The quality of an item-type corpse left behind; 5 is masterpiece-level.
|}

<div align="center">
{{alphabetical TOC}}
</div>

==L==
{| {{prettytable}}
|- bgcolor="#ddd"
! width="20%" | Token
! width="20%" | Arguments
! width="60%" | Description
|-
| LAIR
| type:probability
| Found on megabeasts, semimegabeasts, and night creatues. The creature will seek out sites of this type and take them as lairs. The lair types are SIMPLE_BURROW, SIMPLE_MOUND, SHRINE, and LABYRINTH.

|-
| LAIR_CHARACTERISTIC
| characteristic:probability
| Defines certain features of the creature's lair. The only known valid characteristic is HAS_DOORS.

|-
| LAIR_HUNTER
|
| This creature will actively hunt adventurers in its lair.

|-
| LAIR_HUNTER_SPEECH
| speech file
| What this creature says while hunting adventurers in its lair.

|-
| LARGE_PREDATOR
|
| Will attack things that are smaller than it (like dwarves). Only one group of "large predators" will appear on any given map (possibly two groups on "savage" maps). In adventure mode, large predators will try to ambush and attack you (and your party will attack them back). Also, they can be mentioned in the intro paragraph when starting a fortress e.g. "ere the wolves get hungry."

|-
| LARGE_ROAMING
|
| In Fortress Mode, spawns outdoors and is not a vermin creature.

|-
| LAYS_EGGS
|
| Creature lays eggs instead of giving birth to live young.

|-
| LAYS_UNUSUAL_EGGS
|
* {{L|item token}}
* {{L|material token}}
| Creature lays a particular item instead of regular eggs. As of v0.31.19, this tag only makes the game crash.

|-
| LIGAMENTS
|
* {{L|material token}}
*healing rate
| Defines the material and healing rate of ligaments.

|-
| LIGHT_GEN
|
| The creature will generate light, such as in adventurer mode at night.

|-
| LIKES_FIGHTING
|
| The creature will attack enemies rather than flee from them. This tag has the same effect on player-controlled creatures - included modded dwarves.

|-
| LISP
|
| Creature multiplies 'S' when talking. Ex: "My name isss Recisssiz."

|-
| LITTERSIZE
|
* minumum
* maximum
| Determines the random chance of how many creatures are generated when giving birth. [LITTERSIZE:1:2]

|-
| LOCKPICKER
|
| Lets a creature open doors that are set to forbidden in Fortress Mode.

|-
| LOOSE_CLUSTERS
|
| The creatures will scatter if they have this tag, or form tight packs if they don't.
|}

<div align="center">
{{alphabetical TOC}}
</div>

==M==
{| {{prettytable}}
|- bgcolor="#ddd"
! width="20%" | Token
! width="20%" | Arguments
! width="60%" | Description

|-
| MAGMA_VISION
|
| Creature's able to see while covered in magma.

|-
| MALE
|
| all male

|-
| MANNERISM_??
|
*occassionally body part
| Adds a possible mannerism to the creature's profile.
Refer to {{L|Creature Token Mannerisms|Mannerisms}}

|-
| MATERIAL
|
*material id
| Begins defining a new material.{{verify}}

|-
| MATERIAL_BREATH_ATTACK
|
* {{L|material token}}
* breath attack type (TRAILING_DUST_FLOW, TRAILING_VAPOR_FLOW, TRAILING_GAS_FLOW, SOLID_GLOB, LIQUID_GLOB, UNDIRECTED_GAS, UNDIRECTED_VAPOR, UNDIRECTED_DUST)
| Creates an attack referencing a material, using a given type of breath attack.

|-
| MAXAGE
| min:max
| range of time in which death from old age may occur

|-
| MEANDERER
|
| Gives a creature random movement.

|-
| MEGABEAST
|
| Appears on fortress territory in Fortress Mode occasionally. Implies SEMIMEGABEAST. Also can be worshipped

|-
|MENT_ATT_CAP_PERC
|
*ATTRIBUTE Token
*Cap %
|Default is 200. This means you can increase your attribute to 200% of its starting value (or the average value + your starting value if that is higher).

|-
| MENT_ATT_RANGE
|
*ATTRIBUTE
*lowest:lower:low:median:high:higher:highest | sets up a mental attribute's range of values. Max of 5000.

|-
| MENT_ATT_RATES
|
*ATTRIBUTE Token
*cost to improve
*unused counter rate
*rust counter rate
*demotion counter rate
| Attribute gain/decay rates. Defaults for are 500:2:3:2, except for RECUPERATION and DISEASE_RESISTANCE that don't have change rates. The last three slots may be replaced by NONE.

|-
| MILKABLE
|
* {{L|material token}}
* frequency
| Allows the creature to be milked.

|-
| MISCHIEVIOUS
|
| Will pull any levers it comes across. Also makes creature spawn invisible and with several ranks in Ambusher. "They go on little missions to mess with various fortress buildings, not just levers."

|-
| MOUNT
|
| Creature may be used as a mount

|-
| MOUNT_EXOTIC
|
| You need the Dungeon master noble to mount the creature.

|-
| MULTIPLE_LITTER_RARE
|
| Makes litters with more than one offspring rare.

|-
| MULTIPLY_VALUE
|
*Multiplier
| multiplies value of materials

|-
| MUNDANE
|
| Marks if the creature is an actual real-life creature. Only used for age-names at present.
|}

<div align="center">
{{alphabetical TOC}}
</div>

==N==
{| {{prettytable}}
|- bgcolor="#ddd"
! width="20%" | Token
! width="20%" | Arguments
! width="60%" | Description
|-
| NAME
| singular:plural:adjective
| The generic name for any creature of this type - will be used when distinctions between caste are unimportant. For names for specific castes, use CASTE_NAME instead.

|-
| NATURAL
|
| Animal is considered to be natural.

|-
| NATURAL_SKILL
| skill:value
| The creature possesses this skill at this level inherently. It begins with this skill at this level, and the skill may never rust below this level.

|-
| NIGHT_CREATURE_BOGEYMAN
|
| Found on bogeymen. Presumably makes the creature attack the player at night in hordes like bogeymen do.

|-
| NIGHT_CREATURE_HUNTER
|
| If this creature has SPOUSE_CONVERTER, it will actively attempt to seek out potential conversion targets, abduct them, and convert them. Night creatures will seek out one SPOUSE_CONVERSION_TARGET of the opposite sex, convert them, and then have children with them. NIGHT_CREATURE_HUNTERs without SPOUSE_CONVERTER will not be placed.

|-
| NO_AUTUMN
|
| does not appear this season.

|-
| NO_DIZZINESS
|
| Creature cannot become dizzy

|-
| NO_DRINK
|
| Creature does not need to drink.

|-
| NO_EAT
|
| Creature does not need to eat.

|-
| NO_FEVERS
|
| Creature cannot suffer fevers

|-
| NO_SLEEP
|
| Creature does not need to sleep.

|-
| NO_SPRING
|
| does not appear this season.

|-
| NO_SUMMER
|
| does not appear this season.

|-
| NO_THOUGHT_CENTER_FOR_MOVEMENT
|
| Probably shorthand for movement being unaffected by damage in general.

|-
| NO_WINTER
|
| does not appear this season.

|-
| NOBONES
|
| Creature has no bones.

|-
| NOBREATHE
|
| Creature doesn't need to breathe or have [BREATHE] parts in body. Cannot drown or be strangled.

|-
| NOCTURNAL
|
| Sets if the creature is active in night.

|-
| NOEMOTION
|
| The creature has no emotions, and does not rage.

|-
| NOEXERT
|
| Creature can't become tired or over-exerted.

|-
| NOFEAR
|
| Creature doesn't feel fear and will never run away from battle.

|-
| NOMEAT
|
| Creature will not drop meat on butcher.

|-
| NONAUSEA
|
| Creature can't vomit.

|-
| NOPAIN
|
| Creature doesn't feel pain.

|-
| NORMAL
| ???
| Unknown. Found in string dump.

|-
| NOSKIN
|
| Creature will not drop skin on butcher.

|-
| NOSKULL
|
| Creature will not drop skull on butcher, rot, or decay of severed head.

|-
| NOSMELLYROT
|
| Does not produce miasma when rotting

|-
| NOSTUCKINS
|
| Weapons can't be stuck in creature.

|-
| NOSTUN
|
| Creature can't be stunned. Evidence suggests creatures with this tag never wake up from sleep in Fortress Mode.

|-
| NOT_BUTCHERABLE
|
| Cannot be butchered

|-
| NOTHOUGHT
|
| Creature doesn't think, or doesn't require a [BRAIN] body part.
|}

<div align="center">
{{alphabetical TOC}}
</div>

==P==
{| {{prettytable}}
|- bgcolor="#ddd"
! width="20%" | Token
! width="20%" | Arguments
! width="60%" | Description
|-
| PACK_ANIMAL
|
| Allows the creature to be used as a pack animal. Currently only used by merchants.

|-
| PARALYZEIMMUNE
|
| The creature is immune to all paralyzing special attacks.

|-
| PATTERNFLIER
|
|

|-
| PEARL
|
| Creature will generate pearls.

|-
| PENETRATEPOWER
| value
| Controls the ability of vermin to find a way into containers when they are eating food from your stockpiles. Wood and cloth objects roll a 0-9 and if it's greater than the penetrate power, their contents escape for the time being. Other objects roll a 0-99.

|-
| PERSONALITY
|
*ATTRIBUTE
*lowest:median:highest
| Determines the range and chance of personality traits. Standard is 0:50:100. See [[DF2010:Personality_trait|Personality traits]] for more info.

|-
| PET
|
| Allows the creature to be tamed.

|-
| PET_EXOTIC
|
| You need a Dungeon master noble in your fortress for the creature to be tamable (but any Animal trainer can do the taming).

|-
| PETVALUE
| value
| How valuable a tamed animal/pet is. Actual cost in points in the embarking screen is (PETVALUE/2)+1 for an untrained animal, PETVALUE+1 for a trained(War or Hunting) one. Note that for an animal to be selectable in this screen, it must have the COMMON_DOMESTIC token.

|-
|PHYS_ATT_CAP_PERC
|
*ATTRIBUTE Token
*Cap %
|Default is 200. This means you can increase your attribute to 200% of its starting value (or the average value + your starting value if that is higher).

|-
| PHYS_ATT_RANGE
|
*ATTRIBUTE
*lowest
*lower
*low
*median
*high
*higher
*highest
| sets up a physical attribute's range of values. Max of 5000.

|-
| PHYS_ATT_RATES
|
*ATTRIBUTE Token
*cost to improve
*unused counter rate
*rust counter rate
*demotion counter rate
| Attribute gain/decay rates. Defaults for are 500:2:3:2, except for RECUPERATION and DISEASE_RESISTANCE that don't have change rates. The last three slots may be replaced by NONE.

|-
| PLUS_BP_GROUP
|
*BY_TYPE, BY_CATEGORY, or BY_TOKEN
*body type, category, or token
| Adds a body part group to selected body part group.

|-
| PLUS_MATERIAL
|
*material
| Adds a material to selected materials.

|-
| PLUS_TISSUE_LAYER
|
*TISSUE
*BY_CATEGORY, BY_TYPE, BY_TOKEN
*Location - category, type, or token
| Adds a tissue to those selected

|-
| PLUS_TL_GROUP
|
*TISSUE
*BY_CATEGORY, BY_TYPE, BY_TOKEN
*Location - category, type, or token
*tissue
| continues a selection of tissue layers

|-
| POP_RATIO
|
| Weighted population of caste; Lower is rarer. Not to be confused with FREQUENCY.

|-
| POPULATION_NUMBER
| min:max
| The minimum/maximum numbers of how many of these creatures can show up on a map per year.

|-
|POWER
|
|Allows the being to represent itself as a deity. Requires CAN_SPEAK to actually do anything more than settle at a location.

|-
| PREFSTRING
| string
| Sets what other creatures like about this creature. "Urist likes dwarves for their beards." Multiple entries will be chosen from at random

|-
| PROFESSION_NAME
|
*Profession
*singular
*plural
| The generic name for members of this profession, at the creature level. In order to give members of specific castes different names for professions, use CASTE_PROFESSION_NAME instead.
|}

<div align="center">
{{alphabetical TOC}}
</div>

==R==
{| {{prettytable}}
|- bgcolor="#ddd"
! width="20%" | Token
! width="20%" | Arguments
! width="60%" | Description
|-
| RELSIZE
|
*BY_CATEGORY, BY_TYPE, BY_TOKEN
*body category, type, or token
*Relsize
| Specifies a new relative size for a part than what is stated in the body plan. For example, Dwarves have larger livers.

|-
| REMAINS_COLOR
|
|

|-
| REMAINS_ON_VERMIN_BITE_DEATH
|
| Leaves remains when its attack causes it to die? Seems to go with DIE_WHEN_VERMIN_BITE.

|-
| REMAINS_UNDETERMINED
|
|

|-
| REMOVE_MATERIAL
|
*material token
| Removes a material from a creature

|-
| REMOVE_TISSUE
|
*material token
| Removes a tissue from a creature.
|}

<div align="center">
{{alphabetical TOC}}
</div>

==S==
{| {{prettytable}}
|- bgcolor="#ddd"
! width="20%" | Token
! width="20%" | Arguments
! width="60%" | Description
|-
| SAVAGE
|
| Allows creature to show up on (and limits it to) "savage" maps.

|-
| SECRETION
|
* {{L|material token}}
*Material State
*location secreted from (by_type, by_category, by_token)
*body part
*tissue layer
| creates a secreted material on given tissue on a given part of the body.

|-
| SELECT_ADDITIONAL_CASTE
|
*caste name
| adds an additional previously defined caste to the selection

|-
| SELECT_CASTE
|
*caste name, or ALL
| selects a previously defined caste

|-
| SELECT_MATERIAL
|
*MATERIAL NAME
| Selects the material. Can be ALL.

|-
| SELECT_TISSUE
|
*tissue token
| Selects a tissue for editing.

|-
| SELECT_TISSUE_LAYER
|
*TISSUE
*BY_CATEGORY, BY_TYPE, BY_TOKEN
*Location - category, type, or token | Selects a tissue at a location
* (optional) FRONT, BACK, LEFT, RIGHT, TOP, BOTTOM, AROUND.
| Selects a tissue layer for descriptor and cosmetic purposes.

|-
| SEMIMEGABEAST
|
| Appears as boss creature in quests. Makes history by rampaging around towns. Possibly inhabits non-mountain caves.

|-
| SET_BP_GROUP
|
*selection criteria BY_TYPE, BY_CATEGORY, BY_TOKEN
*category, type, or token
| selection token"

|-
| SET_TL_GROUP
|
*TISSUE
*BY_CATEGORY, BY_TYPE, BY_TOKEN
*Location - category, type, or token
*tissue
| begins a selection of tissue layers

|-
| SHEARABLE_TISSUE_LAYER
| ?
| Can be sheared for wool?

|-
| SKILL_LEARN_RATE
| {{L|skill_token}}:percentage
| The rate at which this creature learns this skill.

|-
| SKILL_LEARN_RATES
| percentage
| The rate at which this creature learns all skills.

|-
| SKILL_RATE
| {{L|skill_token}}:percentage:value:value:value
| As SKILL_RATES for individual skills.

|-
| SKILL_RATES
|
*% of improvement points you get
*unused counter rate
*rust counter rate
*demotion counter rate
| Affects skill gain and decay. Lower numbers in the last three slots make decay occur faster ([SKILL_RATES:100:1:1:1] would cause rapid decay). The counter rates may also be replaced with NONE.
Default is [SKILL_RATES:100:8:8:16]. [SLOW_LEARNER] changes the 100 to a 50.

|-
| SKILL_RUST_RATE
| {{L|skill_token}}:value:value:value
| The rate at which this skill decays. Lower values cause the skill to decay faster.

|-
| SKILL_RUST_RATES
| {{L|skill_token}}:value:value:value
| The rate at which all skills decay. Lower values cause the skills to decay faster.

|-
| SLOW_LEARNER
|
| Similar to [CAN_LEARN], but slower; skills are gained at a fraction of the rate. Present in the entries for ogres and giants; can be applied to civ or player races.

|-
| SMALL_REMAINS
|
| If a creature has this token, it'll leave "remains" instead of a corpse.

|-
| SOLDIER_ALTTILE
| 'character' or tile number
| If this creature is active in its civilization's military, it will blink between its default tile and this one.

|-
| SPEECH
| speech file
| Boasting speeches relating to killing this creature. Examples include dwarf.txt and elf.txt in the Speech folder in Data.u

|-
| SPEED
| value
| Sets the creatures' movement and work speed, 1000/[100 + SPEED X] is the resulting effect on creatures movement and work rates from default. See [http://df.magmawiki.com/index.php/Speed/ Speed] for more information.

|-
| SPHERE
|
*sphere name
| Sets what religious spheres the creature is aligned to, for purposes of being worshipped via the [POWER] token. Also affects the layout of hidden fun stuff, and the creature's name.

|-
| SPOUSE_CONVERSION_TARGET
|
| This creature can be converted by a night creature with SPOUSE_CONVERTED.

|-
| SPOUSE_CONVERTER
|
| Enables the creature to convert SPOUSE_CONVERSION_TARGETs into CONVERTED_SPOUSE castes of its species. The creature won't actually actively do this unless it also has NIGHT_CREATURE_HUNTER, however.

|-
| SWIM_SPEED
|
*speed
| How fast the creature swims. Typically 2500 (0.38 times the default speed).

|-
| SWIMS_INNATE
|
| The creature naturally knows how to swim, as opposed to [SWIMS_LEARNED] below. Currently, an AI bug prevents this from being useful on PC races in fortress mode.

|-
| SWIMS_LEARNED
|
| The creature doesn't know how to swim unless it has learned the skill. Requires [CAN_LEARN], obviously.

|}

<div align="center">
{{alphabetical TOC}}
</div>

==T==
{| {{prettytable}}
|- bgcolor="#ddd"
! width="20%" | Token
! width="20%" | Arguments
! width="60%" | Description
|-
| TENDONS
|
* {{L|material token}}
*healing rate
| Defines the material and healing rare of tendons.

|-
| THICKWEB
|
| The creature's webs can catch larger creatures. May imply [AMBUSHPREDATOR].

|-
| TISSUE
| name
| Begins defining a tissue in the creature file.

|-
| TISSUE_LAYER
|
*BY_TYPE, BY_CATEGORY, BY_TOKEN
*TYPE,CATEGORY, or TOKEN
*TISSUE
*LOCATION
| Adds the tissue layer to wherever it is required.
Non-argument Locations can be FRONT, RIGHT, LEFT, TOP, BOTTOM. Argument locations are AROUND and CLEANS, requiring a further body part and a % of coverage/cleansing

|-
| TISSUE_LAYER_OVER
|
*BY_TYPE, BY_CATEGORY, BY_TOKEN
*TYPE,CATEGORY, or TOKEN
*TISSUE
*LOCATION
| Presumably a counterpart to TISSUE_LAYER_UNDER (see below).

|-
| TISSUE_LAYER_UNDER
|
*BY_TYPE, BY_CATEGORY, BY_TOKEN
*TYPE,CATEGORY, or TOKEN
*TISSUE
| Adds the tissue layer under a given part.

|-
| TISSUE_LAYER_APPEARANCE_MODIFIER
|
*QUALITY
*lowest:lower:low:median:high:higher:highest
| sets the range of qualities, including LENGTH, DENSE, HIGH_POSITION, CURLY, GREASY, WRINKLY

|-
| TISSUE_STYLE_UNIT
|
*tissue
*shaping
| sets tissue to be in a certain shape, mostly used with tissues HAIR, BEARD, MOUSTACHE, SIDEBURNS.

|-
| TL_COLOR_MODIFIER
| COLOR:freq:COLOR:freq etc
| Creates a list of color patterns, giving each a frequency.

|-
| TLCM_GENETIC_MODEL
|
| tissue layer color modifier is passed to offspring genetically?

|-
| TLCM_IMPORTANCE
|
*number
| Presumably modifies the importance of the tissue layer color modifier, for description purposes.
HOWEVER using this appears to remove all mention of colour from creature descriptions. It does not appear in any default creatures.

|-
| TLCM_NOUN
|
*name
*SINGULAR or PLURAL
| names the tissue layer color modifier, and determines the noun

|-
| TLCM_TIMING
|
*ROOT
*start change window years:days:end change window years:days
| determines the point in the creature's life where the color change begins

|-
| TRADE_CAPACITY
|
| How much the creature can carry when used by merchants.

|-
| TRAINABLE
|
| Implies both [TRAINABLE_HUNTING] and [TRAINABLE_WAR].

|-
| TRAINABLE_HUNTING
|
| Can be trained as hunting beasts by way of kennels.

|-
| TRAINABLE_WAR
|
| Can be trained as war beasts by way of kennels.

|-
| TRANCES
|
| Allows the creature to go into martial trances.

|-
| TRAPAVOID
|
| The creature is immune to traps. Probably every procedurally generated megabeast has this.

|-
| TRIGGERABLE_GROUP
| min:max
| A large swarm of vermin can be disturbed, usually in Adventure mode.{{verify}}

|-
| TSU_NOUN
|
*noun
*SINGULAR or PLURAL
| Noun for the TISSUE_STYLE_UNIT, used in the description of the tissue layer's style.
|}

<div align="center">
{{alphabetical TOC}}
</div>

==U==
{| {{prettytable}}
|- bgcolor="#ddd"
! width="20%" | Token
! width="20%" | Arguments
! width="60%" | Description

|-
| UBIQUITOUS
|
| Creature will occur in every region with the correct biome. Does not apply to evil/good tags.

|-
| UNDERGROUND_DEPTH
|
*mindepth
*maxdepth
| Depth the creature appears underground. Numbers can be from 1 to 5. Only magma creatures use 4 or 5 in the default raws. A single argument may be used instead of min and max. Dwarven civilizations will only export (via the embark screen or caravans) things that available at depth 1.

|-
| UNDERSWIM
|
| Creature swims under the water and can't be seen.{{verify}}

|-
| UNIQUE_DEMON
|
| Typically found on genned [[demon]]s; sets the creature as capable of "emerging from the underworld" and taking over during worldgen.

|-
| USE_CASTE
|
*caste token
|

|-
| USE_MATERIAL
|
*new material token
*old material id
| Uses a local creature mat to define a new material?{{verify}}

|-
| USE_MATERIAL_TEMPLATE
|
*new material token
*material template
| Loads a material, and gives it a shortname for later reference

|-
| USE_TISSUE
|
*new tissue token
*old tissue id
| Uses a local creature mat to define a new material?{{verify}}

|-
| USE_TISSUE_TEMPLATE
|
*new tissue token
*tissue template
| Loads a tissue template listed in OBJECT:TISSUE_TEMPLATE files, such as tissue_template_default.txt.

|-
| UTTERANCES
|
| Changes the language of the creature into an unintelligible mess.
|}

<div align="center">
{{alphabetical TOC}}
</div>

==V==
{| {{prettytable}}
|- bgcolor="#ddd"
! width="20%" | Token
! width="20%" | Arguments
! width="60%" | Description
|-
| VEGETATION
|
| unknown

|-
| VIEWRANGE
| value
| Value should determine how close you have to get to a critter before it attacks (or prevents adv mode travel etc.) Default is 20.

|-
| VERMIN_BITE
|
*amount
*verb (bitten, stung)
* {{L|material token}}
| vermin bites, and injects something.

|-
| VERMIN_EATER
|
| Vermin can nibble food?{{verify}}

|-
| VERMIN_FISH
|
| Acts like a fish

|-
| VERMIN_GROUNDER
|
| The creature can be picked up if you stand over it. (Requires confirmation)
'I think this is a habitat flag like VERMIN_SOIL, VERMIN_CHASM, etc. It seems to appear on creatures that don't otherwise have one. – Peristarkawan 17:27, 24 May 2007 (EDT)'

|-
| VERMIN_HATEABLE
|
| Some dwarves will hate the creature and get unhappy thoughts when around it.

|-
| VERMIN_MICRO
|
| This makes the creature move in a swarm of creatures of the same race as it. I.E. Swarm of flies, swarm of ants, etc.

|-
| VERMIN_NOFISH
|
| The creature cannot be caught by fishing.

|-
| VERMIN_NOROAM
|
| The creature will not be observed randomly roaming about the map.

|-
| VERMIN_NOTRAP
|
| The creature cannot be caught in baited animal traps; however, a "catch live land animal" task may still be able to capture one if a dwarf finds one roaming around.

|-
| VERMIN_ROTTER
|
| Present on flies, knuckle worms, acorn flies, and blood gnats. Probably means either the creature is attracted to rot, the creature speeds rotting, or both.

|-
| VERMIN_SOIL
|
| The creature randomly appears near dirt or mud.

|-
| VERMIN_SOIL_COLONY
|
| The vermin will appear in a single tile cluster of many vermin, such as a colony of ants.

|-
| VERMINHUNTER
|
| A creature with this tag will hunt down vermin and kill them. Sometimes they will eat the vermin, but most of the time they will bring it to their owner. This tag also makes impossible to assign an owner to the animal. The animal chooses it's own owner instead (like a cat). If assigned to a playable race, members of that race will ONLY be able to eat vermin.

|-
| VESPERTINE
|
| Sets if the creature is active in evening.
|}

<div align="center">
{{alphabetical TOC}}
</div>

==W==
{| {{prettytable}}
|- bgcolor="#ddd"
! width="20%" | Token
! width="20%" | Arguments
! width="60%" | Description
|-
| WAGON_PULLER
|
| Allows the creature to pull caravan wagons.

|-
| WEBBER
|
* {{L|material token}}
| allows the creature to web, and defines what the webs are made of.

|-
| WEBIMMUNE
|
| The creature will not get caught in thick webs.
|}

==Attack Tokens==
{| {{prettytable}}
|- bgcolor="#ddd"
! width="20%" | Token
! width="20%" | Arguments
! width="60%" | Description

|-
| ATTACK_SKILL
|
*skill used ({{L|Skill tokens}})
| defines the attack skill used

|-
| ATTACK_VERB
| 2nd person:3rd person
| descriptive text for the attack

|-
| ATTACK_CONTACT_PERC
|
*% value
| amount of available tissue used in attack

|-
| ATTACK_PENETRATION_PERC
|
*% value
| probably amount of material that makes contact when penetration is done

|-
| ATTACK_FLAG_EDGE
|
| attack type

|-
| ATTACK_FLAG_WITH
|
| In adventure mode, displays the name of the body part used by an attack when announcing the attack.

|-
| ATTACK_PRIORITY
|
*MAIN or SECOND
| use of the attack in combat. Secondary attacks are only used if main attacks are impossible.

|-
| ATTACK_FLAG_CANLATCH
|
| Enables an attacker to occasionally latch on with the bodypart used by an attack when an attack with this flag in it's definition is made.

|-
| ATTACK_VELOCITY_MODIFIER
| number
| Modifies the attack velocity. Believed to be percent based (so 100 would be "normal"). May be on same scale as weapon velocity (where 1000 is "normal").

|-
| SPECIALATTACK_INJECT_EXTRACT
|
* {{L|material token}}
*state (SOLID, LIQUID, GAS)
*min:max
| attack type addition that injects a material into the victim.

|-
| SPECIALATTACK_SUCK_BLOOD
| min:max
| Successful attack draws out an amount of blood randomized between the min and max value.
|}

==Important Related Tokens==
These next groups of tokens include several tokens that are not technically classified as creature tokens in string dump, but bear mentioning in this as they are used frequently in creature raws. (Some regular creature tokens may also be reprinted for the sake of ease of navigation)

===Tissue Modification===
This next group of tokens deals setting and modifying tissue properties. (See also [[DF2010:Tissue definition token]])

{| {{prettytable}}
|- bgcolor="#ddd"
! width="20%" | Token
! width="20%" | Arguments
! width="60%" | Description

|-
| INSULATION
|
*value
| Tissue supplies the creature with heat insulation. Higher values result in more insulation.

|-
| PLUS_TISSUE_LAYER
|
*TISSUE
*BY_CATEGORY, BY_TYPE, BY_TOKEN
*Location - category, type, or token
| Adds a tissue to those selected

|-
| PLUS_TL_GROUP
|
*TISSUE
*BY_CATEGORY, BY_TYPE, BY_TOKEN
*Location - category, type, or token
*tissue
| continues a selection of tissue layers

|-
| SELECT_TISSUE
|
*tissue token
| Selects a tissue for editing.

|-
| SELECT_TISSUE_LAYER
|
*TISSUE
*BY_CATEGORY, BY_TYPE, BY_TOKEN
*Location - category, type, or token | Selects a tissue at a location
* (optional) FRONT, BACK, LEFT, RIGHT, TOP, BOTTOM, AROUND.
| Selects a tissue layer for descriptor and cosmetic purposes.

|-
| SET_LAYER_TISSUE
|
| Sets a tissue layer to be made of a different tissue.

|-
| TISSUE_MATERIAL
|
*VALUE (material)
*MATERIAL (material subtype)
| Defines the tissue material. VALUE can be LOCAL_CREATURE_MAT, INORGANIC etc. MATERIAL is a subtype of the material, e.g. [TISSUE_MATERIAL:INORGANIC:BRONZE]

|-
| TL_COLOR_MODIFIER
| COLOR:freq:COLOR:freq etc
| Creates a list of color patterns, giving each a frequency.

|-
|TL_CONNECTS
|
| Presumably gives the CONNECTS attribute to selected layers.

|-
|TL_HEALING_RATE
|
| Presumably changes the HEALING_RATE of the selected tissue layers.

|-
|TL_MAJOR_ARTERIES
|
| Gives Major Artery attribute to selected layers.

|-
|TL_PAIN_RECEPTORS
|
| Seems to set new number of pain receptors for selected tissue layers.

|-
|TL_RELATIVE_THICKNESS
|
| Seems to set new relative thickness for selected tissue layers.

|-
|TL_VASCULAR
|
| Seems to set new a VASCULAR value (which modulates bleeding) for selected tissue layers.

|}

==See Also==
*[[DF2010:Body detail plan token]]
*[[DF2010:Body token]]
*[[DF2010:Material definition token]]
*[[DF2010:Syndrome]]
*[[DF2010:Tissue definition token]]

{{Category|Modding}}
{{Category|Tokens}}

v0.31:Creature token

2011-02-23T04:56:47Z

Bohandas: Added "Important Related Tokens" section to rectify Quietust's valid concerns regarding correct token categorization with issues of practicality

{{av}}{{Quality|Exceptional}}

Tentative at best in some cases.

__NOTOC__

<div align="center">
{{alphabetical TOC}}
</div>

==A==
{| {{prettytable}}
|- bgcolor="#ddd"
! width="20%" | Token
! width="20%" | Arguments
! width="60%" | Description
|-
| ALCOHOL_DEPENDENT
|
| Creature needs alcohol to get through the working day.

|-
| ALL_ACTIVE
|
| Sets if the creature is active in day, night, and twilight. Seems to be a separate value from DIURNAL/NOCTURNAL/CREPUSCULAR, rather than implying them.

|-
| ALTTILE
|
| If set, the creature will blink between its [TILE] and its [ALTTILE].

|-
| AMBUSHPREDATOR
|
| Makes the creature start out hidden. Used by {{L|giant cave spider}}s. May make {{L|web}}s hidden too.

|-
| AMPHIBIOUS
|
| Allows a creature to breathe with or without {{L| water}}. Implies [AQUATIC].

|-
| APP_MOD_DESC_RANGE
| ?
| ?

|-
| APP_MOD_GENETIC_MODEL
|
|

|-
| APP_MOD_IMPORTANCE
|
*number
| Determines how important the appearance modifier is, for determining whether it shows up in the creature description.{{verify}}

|-
| APP_MOD_NOUN
|
*noun
*SINGULAR or PLURAL
| creates a noun for the appearance and whether it is singular or plural

|-
| APP_MOD_RATE
|
*Rate (integer)
*Scale (DAILY, YEARLY)
*min:max of growth
*start year:start day
*end year:end day
| setting the growth rate of the modifier. The last two tokens can be replaced by NO_END to have growth continue indefinitely.

|-
| APPLY_CREATURE_VARIATION
|
*CV TEMPLATE NAME
| Loads the Creature Variation Template specified.

|-
| APPLY_CURRENT_CREATURE_VARIATION
|
| Applies loaded Creature Variation

|-
| AQUATIC
|
| Allows a creature to breathe underwater, but causes it to "drown" out of {{L| water}}.

|-
| ARENA_RESTRICTED
|
| Does not appear in arena mode list

|-
| ARTIFICIAL_HIVEABLE
|
| Can be kept in artificial hives by beekeepers.

|-
| ATTACK
|
*token
*bodypart
*selection criteria
*location
| Defines the attack name, and the body part used. See [[#Attack Tokens|below]] for valid subtokens
'''Example:'''<br />
[ATTACK:GORE:BODYPART:BY_CATEGORY:HORN]<br />
''GORE'' : name of the attack<br />
''BODYPART:BY_CATEGORY:HORN'' : the horn is used to attack (presuming the creature has one)

|-
| ATTACK_TRIGGER
| pop:exported wealth:created wealth
| stages when a megabeast will attack a site

|}

<div align="center">
{{alphabetical TOC}}
</div>

==B==
{| {{prettytable}}
|- bgcolor="#ddd"
! width="20%" | Token
! width="20%" | Arguments
! width="60%" | Description
|-
| BABY
| integer
| age at which creature is considered a child. Default is zero. One can think of this as the duration of the baby stage.

|-
| BABYNAME
| singular:plural
| name at caste level

|-
| BEACH_FREQUENCY
|
| {{L|Whale}}s and {{L|Sea nettle jellyfish|jellyfish}} have this. Controls the beaching frequency of the creature.

|-
| BENIGN
|
| Determines whether creature can show up on "tame" maps (includes {{L|elephants}}), which will generally avoid dwarves, although they may chase and/or attack them if they get too close).

|-
| BIOME
|
* biome token
| Select a {{L|Biome}} the creature may appear in.

|-
| BLOOD, PUS, OTHER MATERIAL state definition
|
* {{L|material token}}
*matter state (LIQUID, GAS, SOLID)
| Controls bleeding behaviour

|-
| BODY
| body parts
| Draws body parts from OBJECT:BODY files (such as body_default.txt)
'''Example:'''<br />
[BODY:BODY_WITH_HEAD_FLAG:HEART:GUTS:BRAIN:MOUTH] <br />
This is the body from a {{L|Purring maggot}}. It creates a body with head, a heart, some guts, a brain, and a mouth. Thats all a maggot needs.

|-
| BODY_APPEARANCE_MODIFIER
|
*ATTRIBUTE
*lowest:lower:low:median:high:higher:highest
| These body modifiers give individual creatures different characteristics. In the case of HEIGHT, BROADNESS and LENGTH, the modifier is also a percentage change to the BODY_SIZE of the individual creature. The seven numbers afterward give a distribution of ranges. Each interval has an equal chance of occurring.
'''Example:'''<br />
[BODY_APPEARANCE_MODIFIER:LENGTH:90:95:98:100:102:105:110] <br />
''HEIGHT'' : marks the height to be changed <br />
''90:95:98:100:102:105:110'' : sets the range from the shortest (90% of the average height) to the tallest (110% of the average height) creature variation.

|-
| BODY_DETAIL_PLAN
| PlanName, PlanName:type:type:type:etc
| loads a plan listed OBJECT:BODY_DETAIL_PLAN files, such as b_detail_plan_default.txt. Mass applies USE_MATERIAL_TEMPLATE, mass alters RELSIZE, alters body part positions, and will allow tissue layers to be defined. Tissue layers are defined in order of skin to bone here.
'''Example:'''<br />
[BODY_DETAIL_PLAN:VERTEBRATE_TISSUE_LAYERS:SKIN:FAT:MUSCLE:BONE:CARTILAGE] <br />
This creates the detailed body of a {{L|fox}}, the skin, fat, muscle, bones and cartilage out of the vertebrate tissues.<br />
A {{L|Purring maggot|maggot}} would only need:<br />
''[BODY_DETAIL_PLAN:EXOSKELETON_TISSUE_LAYERS:SKIN:FAT:MUSCLE]''

|-
| BODY_SIZE
| years:days:size
| sets up size at a given time. Size is roughly equal to the creature's average weight in grams.
'''Example:'''<br />
[BODY_SIZE:0:0:10000]<br />
[BODY_SIZE:1:168:50000]<br />
[BODY_SIZE:12:0:220000]<br />
This describes the size of a {{L|minotaur}}. His birth size would be 10000 (~10 kg). With 1 year and 168 days he would be 50000 tall (~50 kg). As an adult (with 12 years) he would weight roughly 220 kg

|-
| BODYGLOSS
| gloss
| Substitutes body part text with replacement text. Draws gloss information from OBJECT:BODY files (such as body_default.txt)

|-
| BONECARN
|
| Creature 'eats' bones. Eating bones makes their happiness go up, but can cause death (suffocation){{verify}}. Implies CARNIVORE.

|-
| BP_APPEARANCE_MODIFIER
|
*QUALITY
*lowest:lower:low:median:high:higher:highest
| sets up the breadth of possibilities for appearance qualities for a selected BP group. EG. Eyes (CLOSE_SET, DEEP_SET, ROUND_VS_NARROW, LARGE_IRIS),Lips (THICKNESS), Nose (BROADNESS, LENGTH, UPTURNED, CONVEX), Ear (SPLAYED_OUT, HANGING_LOBES, BROADNESS, HEIGHT), Tooth (GAPS), Skull (HIGH_CHEEKBONES, BROAD_CHIN, JUTTING CHIN, SQUARE_CHIN), Neck (DEEP_VOICE, RASPY_VOICE), Head (BROADNESS, HEIGHT)

|-
| BUILDINGDESTROYER
| 1 or 2
| Allows a creature to destroy furniture and buildings. Value [1] targets mostly doors, hatches, furniture and the like. Value [2] targets anything not made with the b + C commands.
|}

<div align="center">
{{alphabetical TOC}}
</div>

==C==
{| {{prettytable}}
|- bgcolor="#ddd"
! width="20%" | Token
! width="20%" | Arguments
! width="60%" | Description

|-
| CAN_LEARN
|
| The creature gets skills and professions. Note that this token makes the creature unable to be butchered by an adventurer so it is not recommended for uncivilized monsters. Adventurers lacking this token can allocate but not increase attributes and skills. skills allocated will disappear on start.

|-
| CAN_SPEAK
|
| Can talk. Note that it is not necessary for a creature to gain social skills.

|-
| CANNOT_UNDEAD
|
| Cannot be turned into a zombie or skeletal undead

|-
| CANOPENDOORS
|
| Allows the creature to open doors.

|-
| CARNIVORE
|
| Creature ''only'' eats meat

|-
| CASTE
|
*name
| defines a caste

|-
| CASTE_ALTTILE
|
*tile number or "letter"
| Caste-specific alternate tile. Expects CASTE_TILE

|-
| CASTE_COLOR
|
*fg
*bg
*brightness
| Creature tile color of the caste.

|-
| CASTE_GLOWCOLOR
|
*fg
*bg
*brightness
| GLOWTILE color of the caste.

|-
| CASTE_GLOWTILE
|
*tile value or "letter"
| Caste-specific glowtile

|-
| CASTE_NAME
| singular:plural:adjective
| The name of the caste of the creature in the game.

|-
| CASTE_PROFESSION_NAME
|
*Profession
*singular
*plural
| alters the name of the given profession, caste-specific

|-
| CASTE_SOLDIER_ALTTILE
| 'character' or tile number
| Creatures of this caste active in their civilization's military will blink between their default tile and this one.

|-
| CASTE_SOLDIER_TILE
| 'character' or tile number
| Creatures of this caste active in their civilization's military will use this tile instead.

|-
| CASTE_SPEECH
| speech file?
| Possibly a caste-specific instance of the SPEECH token

|-
| CASTE_TILE
|
* tile number or "letter"
| Caste-specific creature tile.

|-
| CAVE_ADAPT
|
| Gives the creature a bonus in caves. Also causes [[Cave adaptation]].

|-
| CHANGE_BODY_SIZE_PERC
|
|

|-
| CHILD
| integer
| age at which creature is considered an adult. One can think of this as the duration of the child stage. Without this token, a creature will not reproduce in Fortress mode.

|-
| CHILD_BODYPART_GROUP
|
*master selection, BY_CATEGORY, BY_TYPE, BY_TOKEN.
*master location
*specific selection, BY_CATEGORY, BY_TYPE, BY_TOKEN.
*specific location
| selects all parts of a group to be used.

|-
| CHILDNAME
| singular:plural
| name at caste level

|-
| CLUSTER_NUMBER
|
*min
*max
| The minimum/maximum numbers of how many creatures per spawned cluster. Certain vermin fish use this token in combination with temperate ocean and river biome tokens to perform seasonal migrations.
e.g. [CLUSTER_NUMBER:1:3]

|-
|CLUTCH_SIZE
|
*min
*max
|Number of eggs laid in one sitting.

|-
| COLONY_EXTERNAL
|
| Caste hovers around colony.

|-
| COLOR
| foreground:background:brightness
| Color of the creature's tile.

|-
| COMMON_DOMESTIC
|
| Allows the creature to be brought with immigrants and when creating a new fortress, as long as the creature also includes at least one of the following tokens: PET, PACK_ANIMAL, WAGON_PULLER, MOUNT. In addition, the creature must be NATURAL rather than FANCIFUL

|-
| CONVERTED_SPOUSE
|
| Found only at caste level. Creatures of this caste's species with the SPOUSE_CONVERTER and NIGHT_CREATURE_HUNTER tokens will kidnap SPOUSE_CONVERSION_TARGETs of an appropriate sex and convert them into castes with CONVERTED_SPOUSE.

|-
| COOKABLE_LIVE
|
| Set this to allow the creature to be cooked in meals without first being butchered / fishcleaned.

|-
| COPY_TAGS_FROM
|
*CREATURE NAME
| Copies tags from another specified creature.

|-
| CREATURE
| name
| begins defining a new creature with the specified name.

|-
| CREATURE_CLASS
|
*classname
| Creature class. Can be anything, but only existing use is GENERAL_POISON. Appears to only be used for Syndromes. Supposedly can also be used for entity positions.

|-
| CREATURE_SOLDIER_TILE
| 'character' or tile number
| Creatures active in their civilization's military will use this tile instead.

|-
| CREATURE_TILE
| 'character' or tile number
| The symbol of the creature in ASCII mode.

|-
| CREPUSCULAR
|
| Sets if the creature is active at twilight. This tag functions as a combination of the two tags VESPERTINE and MATUTINAL.

|-
| CURIOUSBEAST_EATER
|
| Allows a creature to steal and eat edible items from a site.

|-
| CURIOUSBEAST_GUZZLER
|
| Allows a creature to (very quickly) drink your alcohol. Or spill the barrel to the ground. Also affects undead versions of the creature.

|-
| CURIOUSBEAST_ITEM
|
| Allows a creature to steal things (apparently the highest value it can find). Semimegabeast thievery is in Legends mode. Lightweight creatures can probably steal heavy items.

|-
| CV_ADD_TAG
|
*TAG NAME
| Adds a tag. Used in conjunction with creature variation templates.

|-
| CV_REMOVE_TAG
|
*TAG NAME
| Removes a tag. Used in conjunction with creature variation templates.
|}

<div align="center">
{{alphabetical TOC}}
</div>

==D==
{| {{prettytable}}
|- bgcolor="#ddd"
! width="20%" | Token
! width="20%" | Arguments
! width="60%" | Description

|-
| DEMON
|
| Typically found on genned [[demon]]s; sets the creature as a potential spawn for [[Hidden Fun Stuff]]

|-
| DESCRIPTION
| text
| A brief description of the creature type.

|-
| DIE_WHEN_VERMIN_BITE
|
| Dies upon attacking. Used for bee stings.

|-
| DIFFICULTY
| integer
| Toady: "Difficulty determines how deep it places them in adventure mode/reclaim caves, and the chance that they are wounded the first few river attacks." Also increases experience gain during adventure mode.

|-
| DIURNAL
|
| Sets if the creature is active in day.

|-
| DOES_NOT_EXIST
|
| Creature does not actually exist; used for fanciful creatures.

|-
| DRAGONFIREBREATH
|
| Creature breathes fire in a cone.
|}

<div align="center">
{{alphabetical TOC}}
</div>

==E==
{| {{prettytable}}
|- bgcolor="#ddd"
! width="20%" | Token
! width="20%" | Arguments
! width="60%" | Description

|-
| EGG_MATERIAL
|
* {{L|material token}}
*state (SOLID, LIQUID, or GAS)
| Egg material. Egg-laying creatures will define this 3 times, using LOCAL_CREATURE_MAT:EGGSHELL, LOCAL_CREATURE_MAT:EGG_WHITE, and then LOCAL_CREATURE_MAT:EGG_YOLK. Eggs will be made out of eggshell. Edibility is determined by tags on whites or yolk, but they otherwise do not exist.

|-
| EGG_SIZE
|
*size
| Size of creature's egg?

|-
| EQUIPMENT_WAGON
|
| Makes the creature into a large 3x3 creature responsible for carrying trade goods, pulled by two [WAGON_PULLER]s and driven by a merchant.

|-
| EQUIPS
|
| Allows the creature to wear or wield items.

|-
| EVIL
|
| Determines whether creature can show up on "evil" maps

|-
| EXTRAVISION
|
| Creature can see regardless of whether it has working eyes.
|}

<div align="center">
{{alphabetical TOC}}
</div>

==F==
{| {{prettytable}}
|- bgcolor="#ddd"
! width="20%" | Token
! width="20%" | Arguments
! width="60%" | Description
|-
| FANCIFUL
|
| Makes every civilization know about the creature. The creature won't occur in regular material preference lists. The tag also adds some art value modifiers. Used for things like dragons and other legendary creatures.

|-
| FEATURE_ATTACK_GROUP
|
| Found on subterranean animalmen.

|-
| FEMALE
|
| Inside a female caste, sets femaleness. Outside of a caste, sets all individuals female unless overridden by caste.

|-
| FIREBREATH
|
| The creature breathes fire projectiles (as opposed to DRAGONFIREBREATH, which is in a cone).

|-
| FIREIMMUNE
|
| As of version v0.28.181.40d, the FIREIMMUNE token had no effect on a creature's resistance to flame or heat. However, it did affect ability to swim in magma in adventure mode, as well as display of "You are caught in a pool of magma!" warning messages. It is unknown if these effects persist in DF 2010.

|-
| FIREIMMUNE_SUPER
|
| The creature is immune to DRAGONFIREBREATH. Implies FIREIMMUNE.

|-
| FISHITEM
|
| Needs to be cleaned at a fishery

|-
| FIXED_TEMP
| temperature
| The natural heat generated by the creature.

|-
| FLEEQUICK
|
| Determines how soon a creature flees in a losing battle.

|-
| FLIER
|
| Allows a creature to fly. Fortress Mode pathfinding only partially incorporates pathfinding - flying dwarves need a land path to exist between them and an area in order to access it, but as long as one such path exists, they do not need to use it, instead being able to fly over intervening obstacles.

|-
| FREQUENCY
|
*number, max 100
| Determines the time between creature spawns in Fortress Mode. Higher is more occurrences per time unit. Creatures without a frequency statement default to 50. Almost all others have either [FREQUENCY:5] or [FREQUENCY:100]. Not to be confused with POP_RATIO
|}

<div align="center">
{{alphabetical TOC}}
</div>

==G==
{| {{prettytable}}
|- bgcolor="#ddd"
! width="20%" | Token
! width="20%" | Arguments
! width="60%" | Description
|-
| GENERAL_BABY_NAME
| singular:plural
| name at creature level

|-
| GENERAL_CHILD_NAME
| singular:plural
| name at creature level

|-
| GENERATED
|
| Found on procedurally generated creatures like {{L|Forgotten beast}}s, (biome name) {{L|titan}}s, {{L|Demon}}s, and {{L|night creature}}s.

|-
| GETS_INFECTIONS_FROM_ROT
|
| creature can be infected by rot

|-
| GETS_WOUND_INFECTIONS
|
| creature can get infections from wounds

|-
| GLOWCOLOR
|
*foreground
*background
*brightness
| The colour of the GLOWTILE of the creature.

|-
| GLOWTILE
| ascii character
| If present, the being glows in the dark (generally used for Adventure Mode). The tile is what replaces the being's current tile when it is obscured from your sight by darkness. The default setting for kobolds (a yellow quotation mark) provides a nice "glowing eyes" effect. The game is also hardcoded to automatically convert quotation mark GLOWTILES into apostrophes if the creature has lost one eye. This works at the generic creature level - for caste-specific glow tiles, use CASTE_GLOWTILE instead.

|-
| GNAWER
| verb (gnawed)
| The creature chews on food barrels and bags.

|-
| GO_TO_END
|
| uncertain use, definitely refers to Creature Variants template

|-
| GO_TO_START
|
| uncertain use, definitely refers to Creature Variants template

|-
| GOOD
|
| Determines whether creature can show up on "good" areas. Eg. unicorn.

|-
| GRASSTRAMPLE
| value
| Determines the percentage chance of trampling and killing grass when a creature steps on it. Set [GRASSTRAMPLE:0] to make grass never trampled by the creature.

|-
| GRAVITATE_BODY_SIZE
|
| Creature Variants template command, alter body size.

|-
| GRAZER
|
*number
| Animals is a grazer. The higher the number, the less grass it needs.
|}

<div align="center">
{{alphabetical TOC}}
</div>

==H==
{| {{prettytable}}
|- bgcolor="#ddd"
! width="20%" | Token
! width="20%" | Arguments
! width="60%" | Description
|-
| HABIT
| type:probability
| Defines certain behaviors for the creature. The habit types are COLLECT_TROPHIES, COOK_PEOPLE, COOK_VERMIN, GRIND_VERMIN, COOK_BLOOD, GRIND_BONE_MEAL, EAT_BONE_PORRIDGE, USE_ANY_MELEE_WEAPON, and COLLECT_WEALTH. These may require the creature to have a lair to work properly.

|-
| HABIT_NUM
| number or TEST_ALL
| Unknown. All lists of HABITs are preceded by [HABIT_NUM:TEST_ALL]

|-
| HAS_NERVES
|
| This makes the creature susceptible to severed motor and sensory nerves when muscles are torn in limb, grasp and stance parts. Some butchering yields nervous tissue.

|-
| HIVE_PRODUCT
|
*number
*time
*item tokens
| What product is harvested from beekeeping.

|-
| HOMEOTHERM
|
| Default 'NONE'. The creature's normal body {{L|temperature}}
|}

<div align="center">
{{alphabetical TOC}}
</div>

==I==
{| {{prettytable}}
|- bgcolor="#ddd"
! width="20%" | Token
! width="20%" | Arguments
! width="60%" | Description

|-
| IMMOBILE_LAND
|
| The creature is immobile while on land. Only works on AQUATIC creatures which can't breath on land.

|-
| IMMOLATE
|
| Will ignite, and potentially completely destroy, items the creature is standing on. Keep booze away from critters with this tag.

|-
| INTELLIGENT
|
| Implies CAN_SPEAK and CAN_LEARN. CAN_LEARN probably means the creature gets skills and professions. Not recommended for uncivilized monsters.

|-
| ITEMCORPSE
|
* {{L|item token}}:subtype
* {{L|material token}}
| Determines if the creature leaves behind a non-standard corpse (i.e. wood, statue, bars, ash from ghost etc).

|-
| ITEMCORPSE_QUALITY
|
| The quality of an item-type corpse left behind; 5 is masterpiece-level.
|}

<div align="center">
{{alphabetical TOC}}
</div>

==L==
{| {{prettytable}}
|- bgcolor="#ddd"
! width="20%" | Token
! width="20%" | Arguments
! width="60%" | Description
|-
| LAIR
| type:probability
| Found on megabeasts, semimegabeasts, and night creatues. The creature will seek out sites of this type and take them as lairs. The lair types are SIMPLE_BURROW, SIMPLE_MOUND, SHRINE, and LABYRINTH.

|-
| LAIR_CHARACTERISTIC
| characteristic:probability
| Defines certain features of the creature's lair. The only known valid characteristic is HAS_DOORS.

|-
| LAIR_HUNTER
|
| This creature will actively hunt adventurers in its lair.

|-
| LAIR_HUNTER_SPEECH
| speech file
| What this creature says while hunting adventurers in its lair.

|-
| LARGE_PREDATOR
|
| Will attack things that are smaller than it (like dwarves). Only one group of "large predators" will appear on any given map (possibly two groups on "savage" maps). In adventure mode, large predators will try to ambush and attack you (and your party will attack them back). Also, they can be mentioned in the intro paragraph when starting a fortress e.g. "ere the wolves get hungry."

|-
| LARGE_ROAMING
|
| In Fortress Mode, spawns outdoors and is not a vermin creature.

|-
| LAYS_EGGS
|
| Creature lays eggs instead of giving birth to live young.

|-
| LAYS_UNUSUAL_EGGS
|
* {{L|item token}}
* {{L|material token}}
| Creature lays a particular item instead of regular eggs. As of v0.31.19, this tag only makes the game crash.

|-
| LIGAMENTS
|
* {{L|material token}}
*healing rate
| Defines the material and healing rate of ligaments.

|-
| LIGHT_GEN
|
| The creature will generate light, such as in adventurer mode at night.

|-
| LIKES_FIGHTING
|
| The creature will attack enemies rather than flee from them. This tag has the same effect on player-controlled creatures - included modded dwarves.

|-
| LISP
|
| Creature multiplies 'S' when talking. Ex: "My name isss Recisssiz."

|-
| LITTERSIZE
|
* minumum
* maximum
| Determines the random chance of how many creatures are generated when giving birth. [LITTERSIZE:1:2]

|-
| LOCKPICKER
|
| Lets a creature open doors that are set to forbidden in Fortress Mode.

|-
| LOOSE_CLUSTERS
|
| The creatures will scatter if they have this tag, or form tight packs if they don't.
|}

<div align="center">
{{alphabetical TOC}}
</div>

==M==
{| {{prettytable}}
|- bgcolor="#ddd"
! width="20%" | Token
! width="20%" | Arguments
! width="60%" | Description

|-
| MAGMA_VISION
|
| Creature's able to see while covered in magma.

|-
| MALE
|
| all male

|-
| MANNERISM_??
|
*occassionally body part
| Adds a possible mannerism to the creature's profile.
Refer to {{L|Creature Token Mannerisms|Mannerisms}}

|-
| MATERIAL
|
*material id
| Begins defining a new material.{{verify}}

|-
| MATERIAL_BREATH_ATTACK
|
* {{L|material token}}
* breath attack type (TRAILING_DUST_FLOW, TRAILING_VAPOR_FLOW, TRAILING_GAS_FLOW, SOLID_GLOB, LIQUID_GLOB, UNDIRECTED_GAS, UNDIRECTED_VAPOR, UNDIRECTED_DUST)
| Creates an attack referencing a material, using a given type of breath attack.

|-
| MAXAGE
| min:max
| range of time in which death from old age may occur

|-
| MEANDERER
|
| Gives a creature random movement.

|-
| MEGABEAST
|
| Appears on fortress territory in Fortress Mode occasionally. Implies SEMIMEGABEAST. Also can be worshipped

|-
|MENT_ATT_CAP_PERC
|
*ATTRIBUTE Token
*Cap %
|Default is 200. This means you can increase your attribute to 200% of its starting value (or the average value + your starting value if that is higher).

|-
| MENT_ATT_RANGE
|
*ATTRIBUTE
*lowest:lower:low:median:high:higher:highest | sets up a mental attribute's range of values. Max of 5000.

|-
| MENT_ATT_RATES
|
*ATTRIBUTE Token
*cost to improve
*unused counter rate
*rust counter rate
*demotion counter rate
| Attribute gain/decay rates. Defaults for are 500:2:3:2, except for RECUPERATION and DISEASE_RESISTANCE that don't have change rates. The last three slots may be replaced by NONE.

|-
| MILKABLE
|
* {{L|material token}}
* frequency
| Allows the creature to be milked.

|-
| MISCHIEVIOUS
|
| Will pull any levers it comes across. Also makes creature spawn invisible and with several ranks in Ambusher. "They go on little missions to mess with various fortress buildings, not just levers."

|-
| MOUNT
|
| Creature may be used as a mount

|-
| MOUNT_EXOTIC
|
| You need the Dungeon master noble to mount the creature.

|-
| MULTIPLE_LITTER_RARE
|
| Makes litters with more than one offspring rare.

|-
| MULTIPLY_VALUE
|
*Multiplier
| multiplies value of materials

|-
| MUNDANE
|
| Marks if the creature is an actual real-life creature. Only used for age-names at present.
|}

<div align="center">
{{alphabetical TOC}}
</div>

==N==
{| {{prettytable}}
|- bgcolor="#ddd"
! width="20%" | Token
! width="20%" | Arguments
! width="60%" | Description
|-
| NAME
| singular:plural:adjective
| The generic name for any creature of this type - will be used when distinctions between caste are unimportant. For names for specific castes, use CASTE_NAME instead.

|-
| NATURAL
|
| Animal is considered to be natural.

|-
| NATURAL_SKILL
| skill:value
| The creature possesses this skill at this level inherently. It begins with this skill at this level, and the skill may never rust below this level.

|-
| NIGHT_CREATURE_BOGEYMAN
|
| Found on bogeymen. Presumably makes the creature attack the player at night in hordes like bogeymen do.

|-
| NIGHT_CREATURE_HUNTER
|
| If this creature has SPOUSE_CONVERTER, it will actively attempt to seek out potential conversion targets, abduct them, and convert them. Night creatures will seek out one SPOUSE_CONVERSION_TARGET of the opposite sex, convert them, and then have children with them. NIGHT_CREATURE_HUNTERs without SPOUSE_CONVERTER will not be placed.

|-
| NO_AUTUMN
|
| does not appear this season.

|-
| NO_DIZZINESS
|
| Creature cannot become dizzy

|-
| NO_DRINK
|
| Creature does not need to drink.

|-
| NO_EAT
|
| Creature does not need to eat.

|-
| NO_FEVERS
|
| Creature cannot suffer fevers

|-
| NO_SLEEP
|
| Creature does not need to sleep.

|-
| NO_SPRING
|
| does not appear this season.

|-
| NO_SUMMER
|
| does not appear this season.

|-
| NO_THOUGHT_CENTER_FOR_MOVEMENT
|
| Probably shorthand for movement being unaffected by damage in general.

|-
| NO_WINTER
|
| does not appear this season.

|-
| NOBONES
|
| Creature has no bones.

|-
| NOBREATHE
|
| Creature doesn't need to breathe or have [BREATHE] parts in body. Cannot drown or be strangled.

|-
| NOCTURNAL
|
| Sets if the creature is active in night.

|-
| NOEMOTION
|
| The creature has no emotions, and does not rage.

|-
| NOEXERT
|
| Creature can't become tired or over-exerted.

|-
| NOFEAR
|
| Creature doesn't feel fear and will never run away from battle.

|-
| NOMEAT
|
| Creature will not drop meat on butcher.

|-
| NONAUSEA
|
| Creature can't vomit.

|-
| NOPAIN
|
| Creature doesn't feel pain.

|-
| NORMAL
| ???
| Unknown. Found in string dump.

|-
| NOSKIN
|
| Creature will not drop skin on butcher.

|-
| NOSKULL
|
| Creature will not drop skull on butcher, rot, or decay of severed head.

|-
| NOSMELLYROT
|
| Does not produce miasma when rotting

|-
| NOSTUCKINS
|
| Weapons can't be stuck in creature.

|-
| NOSTUN
|
| Creature can't be stunned. Evidence suggests creatures with this tag never wake up from sleep in Fortress Mode.

|-
| NOT_BUTCHERABLE
|
| Cannot be butchered

|-
| NOTHOUGHT
|
| Creature doesn't think, or doesn't require a [BRAIN] body part.
|}

<div align="center">
{{alphabetical TOC}}
</div>

==P==
{| {{prettytable}}
|- bgcolor="#ddd"
! width="20%" | Token
! width="20%" | Arguments
! width="60%" | Description
|-
| PACK_ANIMAL
|
| Allows the creature to be used as a pack animal. Currently only used by merchants.

|-
| PARALYZEIMMUNE
|
| The creature is immune to all paralyzing special attacks.

|-
| PATTERNFLIER
|
|

|-
| PEARL
|
| Creature will generate pearls.

|-
| PENETRATEPOWER
| value
| Controls the ability of vermin to find a way into containers when they are eating food from your stockpiles. Wood and cloth objects roll a 0-9 and if it's greater than the penetrate power, their contents escape for the time being. Other objects roll a 0-99.

|-
| PERSONALITY
|
*ATTRIBUTE
*lowest:median:highest
| Determines the range and chance of personality traits. Standard is 0:50:100. See [[DF2010:Personality_trait|Personality traits]] for more info.

|-
| PET
|
| Allows the creature to be tamed.

|-
| PET_EXOTIC
|
| You need a Dungeon master noble in your fortress for the creature to be tamable (but any Animal trainer can do the taming).

|-
| PETVALUE
| value
| How valuable a tamed animal/pet is. Actual cost in points in the embarking screen is (PETVALUE/2)+1 for an untrained animal, PETVALUE+1 for a trained(War or Hunting) one. Note that for an animal to be selectable in this screen, it must have the COMMON_DOMESTIC token.

|-
|PHYS_ATT_CAP_PERC
|
*ATTRIBUTE Token
*Cap %
|Default is 200. This means you can increase your attribute to 200% of its starting value (or the average value + your starting value if that is higher).

|-
| PHYS_ATT_RANGE
|
*ATTRIBUTE
*lowest
*lower
*low
*median
*high
*higher
*highest
| sets up a physical attribute's range of values. Max of 5000.

|-
| PHYS_ATT_RATES
|
*ATTRIBUTE Token
*cost to improve
*unused counter rate
*rust counter rate
*demotion counter rate
| Attribute gain/decay rates. Defaults for are 500:2:3:2, except for RECUPERATION and DISEASE_RESISTANCE that don't have change rates. The last three slots may be replaced by NONE.

|-
| PLUS_BP_GROUP
|
*BY_TYPE, BY_CATEGORY, or BY_TOKEN
*body type, category, or token
| Adds a body part group to selected body part group.

|-
| PLUS_MATERIAL
|
*material
| Adds a material to selected materials.

|-
| PLUS_TISSUE_LAYER
|
*TISSUE
*BY_CATEGORY, BY_TYPE, BY_TOKEN
*Location - category, type, or token
| Adds a tissue to those selected

|-
| PLUS_TL_GROUP
|
*TISSUE
*BY_CATEGORY, BY_TYPE, BY_TOKEN
*Location - category, type, or token
*tissue
| continues a selection of tissue layers

|-
| POP_RATIO
|
| Weighted population of caste; Lower is rarer. Not to be confused with FREQUENCY.

|-
| POPULATION_NUMBER
| min:max
| The minimum/maximum numbers of how many of these creatures can show up on a map per year.

|-
|POWER
|
|Allows the being to represent itself as a deity. Requires CAN_SPEAK to actually do anything more than settle at a location.

|-
| PREFSTRING
| string
| Sets what other creatures like about this creature. "Urist likes dwarves for their beards." Multiple entries will be chosen from at random

|-
| PROFESSION_NAME
|
*Profession
*singular
*plural
| The generic name for members of this profession, at the creature level. In order to give members of specific castes different names for professions, use CASTE_PROFESSION_NAME instead.
|}

<div align="center">
{{alphabetical TOC}}
</div>

==R==
{| {{prettytable}}
|- bgcolor="#ddd"
! width="20%" | Token
! width="20%" | Arguments
! width="60%" | Description
|-
| RELSIZE
|
*BY_CATEGORY, BY_TYPE, BY_TOKEN
*body category, type, or token
*Relsize
| Specifies a new relative size for a part than what is stated in the body plan. For example, Dwarves have larger livers.

|-
| REMAINS_COLOR
|
|

|-
| REMAINS_ON_VERMIN_BITE_DEATH
|
| Leaves remains when its attack causes it to die? Seems to go with DIE_WHEN_VERMIN_BITE.

|-
| REMAINS_UNDETERMINED
|
|

|-
| REMOVE_MATERIAL
|
*material token
| Removes a material from a creature

|-
| REMOVE_TISSUE
|
*material token
| Removes a tissue from a creature.
|}

<div align="center">
{{alphabetical TOC}}
</div>

==S==
{| {{prettytable}}
|- bgcolor="#ddd"
! width="20%" | Token
! width="20%" | Arguments
! width="60%" | Description
|-
| SAVAGE
|
| Allows creature to show up on (and limits it to) "savage" maps.

|-
| SECRETION
|
* {{L|material token}}
*Material State
*location secreted from (by_type, by_category, by_token)
*body part
*tissue layer
| creates a secreted material on given tissue on a given part of the body.

|-
| SELECT_ADDITIONAL_CASTE
|
*caste name
| adds an additional previously defined caste to the selection

|-
| SELECT_CASTE
|
*caste name, or ALL
| selects a previously defined caste

|-
| SELECT_MATERIAL
|
*MATERIAL NAME
| Selects the material. Can be ALL.

|-
| SELECT_TISSUE
|
*tissue token
| Selects a tissue for editing.

|-
| SELECT_TISSUE_LAYER
|
*TISSUE
*BY_CATEGORY, BY_TYPE, BY_TOKEN
*Location - category, type, or token | Selects a tissue at a location
* (optional) FRONT, BACK, LEFT, RIGHT, TOP, BOTTOM, AROUND.
| Selects a tissue layer for descriptor and cosmetic purposes.

|-
| SEMIMEGABEAST
|
| Appears as boss creature in quests. Makes history by rampaging around towns. Possibly inhabits non-mountain caves.

|-
| SET_BP_GROUP
|
*selection criteria BY_TYPE, BY_CATEGORY, BY_TOKEN
*category, type, or token
| selection token"

|-
| SET_TL_GROUP
|
*TISSUE
*BY_CATEGORY, BY_TYPE, BY_TOKEN
*Location - category, type, or token
*tissue
| begins a selection of tissue layers

|-
| SHEARABLE_TISSUE_LAYER
| ?
| Can be sheared for wool?

|-
| SKILL_LEARN_RATE
| {{L|skill_token}}:percentage
| The rate at which this creature learns this skill.

|-
| SKILL_LEARN_RATES
| percentage
| The rate at which this creature learns all skills.

|-
| SKILL_RATE
| {{L|skill_token}}:percentage:value:value:value
| As SKILL_RATES for individual skills.

|-
| SKILL_RATES
|
*% of improvement points you get
*unused counter rate
*rust counter rate
*demotion counter rate
| Affects skill gain and decay. Lower numbers in the last three slots make decay occur faster ([SKILL_RATES:100:1:1:1] would cause rapid decay). The counter rates may also be replaced with NONE.
Default is [SKILL_RATES:100:8:8:16]. [SLOW_LEARNER] changes the 100 to a 50.

|-
| SKILL_RUST_RATE
| {{L|skill_token}}:value:value:value
| The rate at which this skill decays. Lower values cause the skill to decay faster.

|-
| SKILL_RUST_RATES
| {{L|skill_token}}:value:value:value
| The rate at which all skills decay. Lower values cause the skills to decay faster.

|-
| SLOW_LEARNER
|
| Similar to [CAN_LEARN], but slower; skills are gained at a fraction of the rate. Present in the entries for ogres and giants; can be applied to civ or player races.

|-
| SMALL_REMAINS
|
| If a creature has this token, it'll leave "remains" instead of a corpse.

|-
| SOLDIER_ALTTILE
| 'character' or tile number
| If this creature is active in its civilization's military, it will blink between its default tile and this one.

|-
| SPEECH
| speech file
| Boasting speeches relating to killing this creature. Examples include dwarf.txt and elf.txt in the Speech folder in Data.u

|-
| SPEED
| value
| Sets the creatures' movement and work speed, 1000/[100 + SPEED X] is the resulting effect on creatures movement and work rates from default. See [http://df.magmawiki.com/index.php/Speed/ Speed] for more information.

|-
| SPHERE
|
*sphere name
| Sets what religious spheres the creature is aligned to, for purposes of being worshipped via the [POWER] token. Also affects the layout of hidden fun stuff, and the creature's name.

|-
| SPOUSE_CONVERSION_TARGET
|
| This creature can be converted by a night creature with SPOUSE_CONVERTED.

|-
| SPOUSE_CONVERTER
|
| Enables the creature to convert SPOUSE_CONVERSION_TARGETs into CONVERTED_SPOUSE castes of its species. The creature won't actually actively do this unless it also has NIGHT_CREATURE_HUNTER, however.

|-
| SWIM_SPEED
|
*speed
| How fast the creature swims. Typically 2500 (0.38 times the default speed).

|-
| SWIMS_INNATE
|
| The creature naturally knows how to swim, as opposed to [SWIMS_LEARNED] below. Currently, an AI bug prevents this from being useful on PC races in fortress mode.

|-
| SWIMS_LEARNED
|
| The creature doesn't know how to swim unless it has learned the skill. Requires [CAN_LEARN], obviously.

|}

<div align="center">
{{alphabetical TOC}}
</div>

==T==
{| {{prettytable}}
|- bgcolor="#ddd"
! width="20%" | Token
! width="20%" | Arguments
! width="60%" | Description
|-
| TENDONS
|
* {{L|material token}}
*healing rate
| Defines the material and healing rare of tendons.

|-
| THICKWEB
|
| The creature's webs can catch larger creatures. May imply [AMBUSHPREDATOR].

|-
| TISSUE
| name
| Begins defining a tissue in the creature file.

|-
| TISSUE_LAYER
|
*BY_TYPE, BY_CATEGORY, BY_TOKEN
*TYPE,CATEGORY, or TOKEN
*TISSUE
*LOCATION
| Adds the tissue layer to wherever it is required.
Non-argument Locations can be FRONT, RIGHT, LEFT, TOP, BOTTOM. Argument locations are AROUND and CLEANS, requiring a further body part and a % of coverage/cleansing

|-
| TISSUE_LAYER_OVER
|
*BY_TYPE, BY_CATEGORY, BY_TOKEN
*TYPE,CATEGORY, or TOKEN
*TISSUE
*LOCATION
| Presumably a counterpart to TISSUE_LAYER_UNDER (see below).

|-
| TISSUE_LAYER_UNDER
|
*BY_TYPE, BY_CATEGORY, BY_TOKEN
*TYPE,CATEGORY, or TOKEN
*TISSUE
| Adds the tissue layer under a given part.

|-
| TISSUE_LAYER_APPEARANCE_MODIFIER
|
*QUALITY
*lowest:lower:low:median:high:higher:highest
| sets the range of qualities, including LENGTH, DENSE, HIGH_POSITION, CURLY, GREASY, WRINKLY

|-
| TISSUE_STYLE_UNIT
|
*tissue
*shaping
| sets tissue to be in a certain shape, mostly used with tissues HAIR, BEARD, MOUSTACHE, SIDEBURNS.

|-
| TL_COLOR_MODIFIER
| COLOR:freq:COLOR:freq etc
| Creates a list of color patterns, giving each a frequency.

|-
| TLCM_GENETIC_MODEL
|
| tissue layer color modifier is passed to offspring genetically?

|-
| TLCM_IMPORTANCE
|
*number
| Presumably modifies the importance of the tissue layer color modifier, for description purposes.
HOWEVER using this appears to remove all mention of colour from creature descriptions. It does not appear in any default creatures.

|-
| TLCM_NOUN
|
*name
*SINGULAR or PLURAL
| names the tissue layer color modifier, and determines the noun

|-
| TLCM_TIMING
|
*ROOT
*start change window years:days:end change window years:days
| determines the point in the creature's life where the color change begins

|-
| TRADE_CAPACITY
|
| How much the creature can carry when used by merchants.

|-
| TRAINABLE
|
| Implies both [TRAINABLE_HUNTING] and [TRAINABLE_WAR].

|-
| TRAINABLE_HUNTING
|
| Can be trained as hunting beasts by way of kennels.

|-
| TRAINABLE_WAR
|
| Can be trained as war beasts by way of kennels.

|-
| TRANCES
|
| Allows the creature to go into martial trances.

|-
| TRAPAVOID
|
| The creature is immune to traps. Probably every procedurally generated megabeast has this.

|-
| TRIGGERABLE_GROUP
| min:max
| A large swarm of vermin can be disturbed, usually in Adventure mode.{{verify}}

|-
| TSU_NOUN
|
*noun
*SINGULAR or PLURAL
| Noun for the TISSUE_STYLE_UNIT, used in the description of the tissue layer's style.
|}

<div align="center">
{{alphabetical TOC}}
</div>

==U==
{| {{prettytable}}
|- bgcolor="#ddd"
! width="20%" | Token
! width="20%" | Arguments
! width="60%" | Description

|-
| UBIQUITOUS
|
| Creature will occur in every region with the correct biome. Does not apply to evil/good tags.

|-
| UNDERGROUND_DEPTH
|
*mindepth
*maxdepth
| Depth the creature appears underground. Numbers can be from 1 to 5. Only magma creatures use 4 or 5 in the default raws. A single argument may be used instead of min and max. Dwarven civilizations will only export (via the embark screen or caravans) things that available at depth 1.

|-
| UNDERSWIM
|
| Creature swims under the water and can't be seen.{{verify}}

|-
| UNIQUE_DEMON
|
| Typically found on genned [[demon]]s; sets the creature as capable of "emerging from the underworld" and taking over during worldgen.

|-
| USE_CASTE
|
*caste token
|

|-
| USE_MATERIAL
|
*new material token
*old material id
| Uses a local creature mat to define a new material?{{verify}}

|-
| USE_MATERIAL_TEMPLATE
|
*new material token
*material template
| Loads a material, and gives it a shortname for later reference

|-
| USE_TISSUE
|
*new tissue token
*old tissue id
| Uses a local creature mat to define a new material?{{verify}}

|-
| USE_TISSUE_TEMPLATE
|
*new tissue token
*tissue template
| Loads a tissue template listed in OBJECT:TISSUE_TEMPLATE files, such as tissue_template_default.txt.

|-
| UTTERANCES
|
| Changes the language of the creature into an unintelligible mess.
|}

<div align="center">
{{alphabetical TOC}}
</div>

==V==
{| {{prettytable}}
|- bgcolor="#ddd"
! width="20%" | Token
! width="20%" | Arguments
! width="60%" | Description
|-
| VEGETATION
|
| unknown

|-
| VIEWRANGE
| value
| Value should determine how close you have to get to a critter before it attacks (or prevents adv mode travel etc.) Default is 20.

|-
| VERMIN_BITE
|
*amount
*verb (bitten, stung)
* {{L|material token}}
| vermin bites, and injects something.

|-
| VERMIN_EATER
|
| Vermin can nibble food?{{verify}}

|-
| VERMIN_FISH
|
| Acts like a fish

|-
| VERMIN_GROUNDER
|
| The creature can be picked up if you stand over it. (Requires confirmation)
'I think this is a habitat flag like VERMIN_SOIL, VERMIN_CHASM, etc. It seems to appear on creatures that don't otherwise have one. – Peristarkawan 17:27, 24 May 2007 (EDT)'

|-
| VERMIN_HATEABLE
|
| Some dwarves will hate the creature and get unhappy thoughts when around it.

|-
| VERMIN_MICRO
|
| This makes the creature move in a swarm of creatures of the same race as it. I.E. Swarm of flies, swarm of ants, etc.

|-
| VERMIN_NOFISH
|
| The creature cannot be caught by fishing.

|-
| VERMIN_NOROAM
|
| The creature will not be observed randomly roaming about the map.

|-
| VERMIN_NOTRAP
|
| The creature cannot be caught in baited animal traps; however, a "catch live land animal" task may still be able to capture one if a dwarf finds one roaming around.

|-
| VERMIN_ROTTER
|
| Present on flies, knuckle worms, acorn flies, and blood gnats. Probably means either the creature is attracted to rot, the creature speeds rotting, or both.

|-
| VERMIN_SOIL
|
| The creature randomly appears near dirt or mud.

|-
| VERMIN_SOIL_COLONY
|
| The vermin will appear in a single tile cluster of many vermin, such as a colony of ants.

|-
| VERMINHUNTER
|
| A creature with this tag will hunt down vermin and kill them. Sometimes they will eat the vermin, but most of the time they will bring it to their owner. This tag also makes impossible to assign an owner to the animal. The animal chooses it's own owner instead (like a cat). If assigned to a playable race, members of that race will ONLY be able to eat vermin.

|-
| VESPERTINE
|
| Sets if the creature is active in evening.
|}

<div align="center">
{{alphabetical TOC}}
</div>

==W==
{| {{prettytable}}
|- bgcolor="#ddd"
! width="20%" | Token
! width="20%" | Arguments
! width="60%" | Description
|-
| WAGON_PULLER
|
| Allows the creature to pull caravan wagons.

|-
| WEBBER
|
* {{L|material token}}
| allows the creature to web, and defines what the webs are made of.

|-
| WEBIMMUNE
|
| The creature will not get caught in thick webs.
|}

==Attack Tokens==
{| {{prettytable}}
|- bgcolor="#ddd"
! width="20%" | Token
! width="20%" | Arguments
! width="60%" | Description

|-
| ATTACK_SKILL
|
*skill used ({{L|Skill tokens}})
| defines the attack skill used

|-
| ATTACK_VERB
| 2nd person:3rd person
| descriptive text for the attack

|-
| ATTACK_CONTACT_PERC
|
*% value
| amount of available tissue used in attack

|-
| ATTACK_PENETRATION_PERC
|
*% value
| probably amount of material that makes contact when penetration is done

|-
| ATTACK_FLAG_EDGE
|
| attack type

|-
| ATTACK_FLAG_WITH
|
| In adventure mode, displays the name of the body part used by an attack when announcing the attack.

|-
| ATTACK_PRIORITY
|
*MAIN or SECOND
| use of the attack in combat. Secondary attacks are only used if main attacks are impossible.

|-
| ATTACK_FLAG_CANLATCH
|
| Enables an attacker to occasionally latch on with the bodypart used by an attack when an attack with this flag in it's definition is made.

|-
| ATTACK_VELOCITY_MODIFIER
| number
| Modifies the attack velocity. Believed to be percent based (so 100 would be "normal"). May be on same scale as weapon velocity (where 1000 is "normal").

|-
| SPECIALATTACK_INJECT_EXTRACT
|
* {{L|material token}}
*state (SOLID, LIQUID, GAS)
*min:max
| attack type addition that injects a material into the victim.

|-
| SPECIALATTACK_SUCK_BLOOD
| min:max
| Successful attack draws out an amount of blood randomized between the min and max value.
|}

==Important Related Tokens==
These next groups of tokens include several tokens that are not technically classified as creature tokens in string dump, but bear mentioning in this as they are used frequently in creature raws. (Some regular creature tokens may also be reprinted for the sake of ease of navigation)

===Tissue Modification===
This next group of tokens deals setting and modifying tissue properties. (See also [[DF2010:Tissue definition token]])

{| {{prettytable}}
|- bgcolor="#ddd"
! width="20%" | Token
! width="20%" | Arguments
! width="60%" | Description

|-
| INSULATION
|
*value
| Tissue supplies the creature with heat insulation. Higher values result in more insulation.

|-
| PLUS_TISSUE_LAYER
|
*TISSUE
*BY_CATEGORY, BY_TYPE, BY_TOKEN
*Location - category, type, or token
| Adds a tissue to those selected

|-
| PLUS_TL_GROUP
|
*TISSUE
*BY_CATEGORY, BY_TYPE, BY_TOKEN
*Location - category, type, or token
*tissue
| continues a selection of tissue layers

|-
| SELECT_TISSUE
|
*tissue token
| Selects a tissue for editing.

|-
| SELECT_TISSUE_LAYER
|
*TISSUE
*BY_CATEGORY, BY_TYPE, BY_TOKEN
*Location - category, type, or token | Selects a tissue at a location
* (optional) FRONT, BACK, LEFT, RIGHT, TOP, BOTTOM, AROUND.
| Selects a tissue layer for descriptor and cosmetic purposes.

|-
| SET_LAYER_TISSUE
|
| Sets a tissue layer to be made of a different tissue.

|-
| TISSUE_MATERIAL
|
*VALUE (material)
*MATERIAL (material subtype)
| Defines the tissue material. VALUE can be LOCAL_CREATURE_MAT, INORGANIC etc. MATERIAL is a subtype of the material, e.g. [TISSUE_MATERIAL:INORGANIC:BRONZE]

|-
| TL_COLOR_MODIFIER
| COLOR:freq:COLOR:freq etc
| Creates a list of color patterns, giving each a frequency.

|-
|TL_CONNECTS
|
| Presumably gives the CONNECTS attribute to selected layers.

|-
|TL_HEALING_RATE
|
| Presumably changes the HEALING_RATE of the selected tissue layers.

|-
|TL_MAJOR_ARTERIES
|
| Gives Major Artery attribute to selected layers.

|-
|TL_PAIN_RECEPTORS
|
| Seems to set new number of pain receptors for selected tissue layers.

|-
|TL_RELATIVE_THICKNESS
|
| Seems to set new relative thickness for selected tissue layers.

|-
|TL_VASCULAR
|
| Seems to set new a VASCULAR value (which modulates bleeding) for selected tissue layers.

|}

==See Also==
[[DF2010:Body detail plan token]]
[[DF2010:Body token]]
[[DF2010:Material definition token]]
[[DF2010:Syndrome]]
[[DF2010:Tissue definition token]]

{{Category|Modding}}
{{Category|Tokens}}

v0.31 Talk:Tissue definition token

2011-02-23T04:20:59Z

Bohandas: Tissue Layer Tokens

== Tissue Layer Tokens ==

As far as i can tell the tokens listed under the Tissue Layer Tokens heading are only ever used in creature raws and therefore, for simplicity's sake, this section should either be merged with or copied to the Creature Token article

v0.31:Body detail plan token

2011-02-23T03:12:02Z

Bohandas: Created page. Created table. Listed tokens. Listed info for some tokens.

{| {{prettytable}}
|- bgcolor="#ddd"
! width="20%" | Token
! width="20%" | Arguments
! width="60%" | Description

|-
| ADD_MATERIAL
|
|

|-
| ADD_TISSUE
|
|

|-
| BODY_DETAIL_PLAN
|
| Begins defining a body detail plan for use in creature raws

|-
| BP_LAYERS
|
*BY_CATEGORY (or, presumably, BY_TYPE or BY_TOKEN)
*body part
*tissue name or tissue ARG# for innermost tissue
*tissue thickness
*tissue name or tissue ARG# for second innermost tissue
*tissue thickness
*tissue name or tissue ARG# for second innermost tissue
*tissue thickness
etc...
| Sets up infrastructure to allow the tissues used in a given body part to be defined in creature raws

|-
| BP_LAYERS_OVER
|
|

|-
| BP_LAYERS_UNDER
|
|

|-
| BP_POSITION
|
|

|-
| BP_RELATION
|
|

|-
| BP_RELSIZE
|
*BY_CATEGORY (or, presumably, BY_TYPE or BY_TOKEN)
*body part
*relsize
| Defines a relsize for the selected body part for the current body detail plan

v0.31:Entity token

2011-02-22T04:36:36Z

Bohandas: Minor change to title of section added in previous edit

{{av}}
These tokens define entities, or civilizations, in entity_*.txt files.

== Gameplay ==
{| {{prettytable}}
|- bgcolor="#ddd"
! Token
! Arguments
! Description

|-
| ADVENTURE_TIER
| order
| Allows adventure mode. Dwarfs, Elves, and Humans take up tier 3, 2, and 1 respectively. It seems that the best way to use this is to put your entity in the same order as the other tiers. The tiers are in descending order. So you should put a new adventure entity above the Dwarves. Not at the end of the file.
[ADVENTURE_TIER:4]

|-
| INDIV_CONTROLLABLE
|
| Allows the "Play Now!" option adventure mode. Not having this specified in one of the entities will cause the Adventure mode option to disappear.

|-
| 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). At least one civilization must have this token.

|-
| CREATURE
| creature
|The type of creature that will inhabit the civilization. Multiple entries will be chosen from at random for each civilization.
[CREATURE:DWARF]

|}

== Placement ==

{| {{prettytable}}
|- bgcolor="#ddd"
! Token
! Arguments
! Description

|-
| BIOME_SUPPORT
|
* {{L|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]

|-
| START_BIOME
| {{L|Biome token|biome}}
| Birth of the civilization can be performed on this biome.
[START_BIOME:MOUNTAIN]

|-
| DEFAULT_SITE_TYPE
| site type
| Also determines symbol used when selecting civilization. CAVE uses no symbol. Options are: CITY, TREE_CITY, DARK_FORTRESS, CAVE, CAVE_DETAILED, (in 40d also RUIN)
[DEFAULT_SITE_TYPE:CAVE_DETAILED]

|-
| LIKES_SITE
| site type
| Most residents will try to move to this site type, unless already at one.
[LIKES_SITE:CAVE_DETAILED]

|-
| TOLERATES_SITE
| site type
| Some residents will try to move to this site type, unless already at one.
[TOLERATES_SITE:CITY]

|-
| WORLD_CONSTRUCTION
| construction
| Controls which constructions the civ will build on the world map.
[WORLD_CONSTRUCTION:BRIDGE]
[WORLD_CONSTRUCTION:ROAD]
[WORLD_CONSTRUCTION:TUNNEL]
[WORLD_CONSTRUCTION:WALL]

|}

== Population ==

{| {{prettytable}}
|- bgcolor="#ddd"
! Token
! Arguments
! Description

|-
| START_GROUP_NUMBER
| number
| Number of breeding couples to start with per entity. Note that single-gender (eg. [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]

|-
| MAX_POP_NUMBER
| number
| Max population *per entity*, multiply this by max starting civ to get the total population of the species.
[MAX_POP_NUMBER:500]

|-
| MAX_SITE_POP_NUMBER
| number
| Max population per individual site.
[MAX_SITE_POP_NUMBER:200]

|-
| MAX_STARTING_CIV_NUMBER
| number
| Max number of entities to spawn at world generation.
[MAX_STARTING_CIV_NUMBER:3]

|}

== Flavor ==
{| {{prettytable}}
|- bgcolor="#ddd"
! Token
! Arguments
! Description

|-
| PERMITTED_BUILDING
| building name
| The named, custom building can be built by a civilization in Fortress Mode.
[PERMITTED_BUILDING:SOAP_MAKER]

|-
| PERMITTED_JOB
| {{L|Unit type token|profession}}
| Allows this job type to be selected. This applies to worldgen creatures, in the embark screen, and in play.
[PERMITTED_JOB:MINER]

|-
| PERMITTED_REACTION
| reaction name
| Allows this reaction to be used by a civilization. It is used primarily in Fortress Mode. 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]

|-
| CURRENCY_BY_YEAR
|
| Causes the civ's currency to be numbered with the year it was minted.

|-
| CURRENCY
|
* metal token
* value
| What kind of metals the civ uses for coin minting as well as the value of the coin.
[CURRENCY:SILVER:5]

|-
| 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]

|-
| ART_IMAGE_ELEMENT_MODIFIER
|
* item
* number
| CREATURE, PLANT, TREE, SHAPE, ITEM
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]

|-
| ITEM_IMPROVEMENT_MODIFIER
|
* item
* number
| ART_IMAGE, COVERED, RINGS_HANGING, BANDS, SPIKES, ITEMSPECIFIC, THREAD, CLOTH, SEWN_IMAGE: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.

|-
| 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]

|-
| CULL_SYMBOL
|
* noun
* symbol
| ALL, CIV, SITE
Causes the entity to not use the words in these SYM sets.
[CULL_SYMBOL:ALL:UGLY]

|-
| SELECT_SYMBOL
|
* noun
* symbol
| Causes the entity to more often use these symbols in the particular SYM set.
[SELECT_SYMBOL:ALL:PEACE]

|-
| FRIENDLY_COLOR
| see {{L|color}}
|
The color of this entity's civilization settlements in the world gen and embark screens
[FRIENDLY_COLOR:1:0:1]

|}

== Religion ==
{| {{prettytable}}
|- bgcolor="#ddd"
! Token
! Arguments
! Description

|-
| 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]

|-
| RELIGION_SPHERE
| sphere
| Can by any available {{L|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]

|-
| 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

|-
| 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 {{l|Position token}}.

|-
| 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.

|-
| 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

|-
| [[Ethics|ETHIC]]
|
*behavior
*reaction
| Sets the civ's view of 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]

|-
| WILL_ACCEPT_TRIBUTE
|
| Makes the civ's traders accept offered goods.

|-
| WANDERER, BEAST_HUNTER, SCOUT
|
| The civ will send out these sorts of adventurers in worldgen.

|-
| 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.

|-
| 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]

|-
| 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.

|-
| 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.

|-
| 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 history gen, allowing them to become part of the civ if they do not escape.

Note: If playable civ in Fortress Mode has this tag (ie. 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.

|-
| DIPLOMAT
|
| Presumably causes the civilization to send a diplomat once your fortress reaches a certain state.

|-
| DIPLOMAT_BODYGUARDS
|
| Effect unknown.

|-
| INVADERS_IGNORE_NEUTRALS
|
|

|-
| 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.

|-
| MERCHANT_BODYGUARDS
|
| Merchants have bodyguards and wagons. Wagons allow for a lot more variety in their goods.

|-
| 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.

|-
| 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. 0 corresponds to no population requirement necessary for interaction. 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.

|-
| 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. Progress triggers may be changed, added, or deleted for a currently active fort.

|-
| 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. Progress triggers may be changed, added, or deleted for a currently active fort.

|-
| 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. 0 corresponds to no population requirement necessary for interaction. 1 corresponds to 20 dwarves, 2 to 50 dwarves, 3 to 80, 4 to 110, and 5 to 140.

|-
| 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.

|-
| 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.

|-
| SIEGER
|
| Will wait around at the edge of your map for a month or two, before charging.

|-
| SKULKING
|
| This makes the severity of attacks depend on the extent of item/baby thievery rather than the passage of time.

|-
| TREE_CAP_DIPLOMACY
|
| Makes the entity angry if you cut down too many trees. They will send a warning first.

|-
| LAYER_LINKED
|
| Defines if a civilization is a hidden subterranean entity, such as batman civilizations.

|}

== Items and Animals Used ==
{| {{prettytable}}
|- bgcolor="#ddd"
! Token
! Arguments
! Description

|-
| AMMO
| item token
|
[AMMO:ITEM_AMMO_BOLTS]

|-
| ARMOR
|
* item token
* rarity
|Rarity is optional. Permitted rarity values include RARE, UNCOMMON, COMMON, and FORCED.
[ARMOR:ITEM_ARMOR_PLATEMAIL:COMMON]

|-
| DIGGER
| item token
|
[DIGGER:ITEM_WEAPON_PICK]

|-
| GLOVES
|
* item token
* rarity
| Rarity is optional. Permitted rarity values include RARE, UNCOMMON, COMMON, and FORCED.
[GLOVES:ITEM_GLOVES_GLOVES:COMMON]

|-
| HELM
|
* item token
* rarity
| Rarity is optional. Permitted rarity values include RARE, UNCOMMON, COMMON, and FORCED.
[HELM:ITEM_HELM_HELM:COMMON]

|-
| INSTRUMENT
| item token
|
[INSTRUMENT:ITEM_INSTRUMENT_FLUTE]

|-
| PANTS
|
* item token
* rarity
| Rarity is optional. Permitted rarity values include RARE, UNCOMMON, COMMON, and FORCED.
[PANTS:ITEM_PANTS_PANTS:COMMON]

|-
| SHIELD
| item token
|
[SHIELD:ITEM_SHIELD_SHIELD]

|-
| SHOES
|
* item token
* rarity
| Rarity is optional. Permitted rarity values include RARE, UNCOMMON, COMMON, and FORCED.
[SHOES:ITEM_SHOES_SHOES:COMMON]

|-
| SIEGEAMMO
| item token
|
[SIEGEAMMO:ITEM_SIEGEAMMO_BALLISTA]

|-
| TOY
| item token
|
[TOY:ITEM_TOY_PUZZLEBOX]

|-
| TRAPCOMP
| item token
|
[TRAPCOMP:ITEM_TRAPCOMP_GIANTAXEBLADE]

|-
| WEAPON
| item token
|
[WEAPON:ITEM_WEAPON_AXE_BATTLE]

|-
| USE_ANIMAL_PRODUCTS
|
|

|-
| USE_ANY_PET_RACE
|
| Assuming it passes other checks, any creature in their list of usables (from common domestic if they have that or 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 (next time, it'll let them use mounts/pullers/pack animals of any kind as well, but I'm not sure this matters in the stock raws). 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.

|-
| USE_CAVE_ANIMALS
|
| If they don't have it, creatures with exclusively subterranean biomes are skipped.

|-
| USE_EVIL_ANIMALS
|
| Don't have it -> EVIL creatures skipped.

|-
| USE_EVIL_PLANTS
|
| As EVIL creatures for all uses of plants.

|-
| USE_EVIL_WOOD
|
| As EVIL creatures for all uses of wood.

|-
| USE_GOOD_ANIMALS
|
| Don't have it -> GOOD creatures skipped.

|-
| USE_GOOD_PLANTS
|
| As GOOD creatures for all uses of plants.

|-
| USE_GOOD_WOOD
|
| As GOOD creatures for all uses of wood.

|-
| USE_MISC_PROCESSED_WOOD_PRODUCTS
|
| If wood is available locally, and the relevant professions are permitted, controls availability of lye, charcoal, potash and pearlash.

|-
| COMMON_DOMESTIC_MOUNT
|
| If a creature has PET and the relevant COMMON_DOMESTIC_x tag (or COMMON_DOMESTIC for pets), it will be allowed if it passes the other checks.

|-
| COMMON_DOMESTIC_PACK
|
| If a creature has PET and the relevant COMMON_DOMESTIC_x tag (or COMMON_DOMESTIC for pets), it will be allowed if it passes the other checks. Also seems to be required currently for trading to occur.

|-
| COMMON_DOMESTIC_PET
|
| If a creature has PET and the relevant COMMON_DOMESTIC_x tag (or COMMON_DOMESTIC for pets), it will be allowed if it passes the other checks. Also seems to be required to have any animals at all, including those used in trading.

|-
| COMMON_DOMESTIC_PULL
|
| If a creature has PET and the relevant COMMON_DOMESTIC_x tag (or COMMON_DOMESTIC for pets), it will be allowed if it passes the other checks.

|-
| RIVER_PRODUCTS
|
| Allow civ to use river products in the goods it has available for trade.

|-
| OCEAN_PRODUCTS
|
| Allow civ to use ocean products in the goods it has available for trade.

|-
| INDOOR_FARMING
|
| Allow civ to use underground plant products in the goods it has available for trade.

|-
| OUTDOOR_FARMING
|
| Allow civ to use outdoor plant products in the goods it has available for trade.

|-
| CLOTHING
|
| Civ members will attempt to wear clothing.

|-
| SUBTERRANEAN_CLOTHING
|
| Will wear things made of spider silk and other subterranean materials.

|-
| EQUIPMENT_IMPROVEMENTS
|
| Adds decorations to equipment based on the level of the generated unit. Also improves item quality.

|-
| IMPROVED_BOWS
|
| Adds decorations to weapons generated for bowman and master bowman. An elf hack.

|-
| METAL_PREF
|
| Allows the entity to use the metal with the highest values for DAMAGE_PERC or BLOCK_PERC without DEEP. Currently only dwarves have this token. Without this token, the entity will use the best metal below or equal to 100%.

|-
| STONE_PREF
|
| Enables creatures of this entity to bring stones in trade. Also seems to enable the use of metals smelted from ore, such as iron or copper.

|-
| WOOD_WEAPONS
|
| Causes members to be able to use wooden weapons.

|-
| WOOD_ARMOR
|
| Causes members to be able to use wooden armor.

|-
| GEM_PREF
|
| Enables creatures of this entity to bring gems in trade.

|-
| INDOOR_WOOD
|
| Allow civ to trade subterranean wood types, such as tower-cap and fungiwood logs.

|-
| OUTDOOR_WOOD
|
| Allow civ to use outdoor wood types, such as mangrove and oak.

|}

== Tissue Styling Related Tokens ==
{| {{prettytable}}
|- bgcolor="#ddd"
! Token
! Arguments
! Description

|-
| TISSUE_STYLE
|
*tissue???
| Presumably selects tissue to set cultural style parameters for. Needs testing.

|-
| TS_MAINTAIN_LENGTH
|
*length?
*???
| Presumably sets culturally preferred tissue length for selected tissue. Needs testing.

|-
| TS_PREFERRED_SHAPING
| ???
| Presumably sets culturally preferred tissue shapings for selected tissue. Needs testing.

{{Category|Modding}}
{{Category|Tokens}}

v0.31:Entity token

2011-02-22T04:35:31Z

Bohandas: Added section for the minor tissue styling related tokens

{{av}}
These tokens define entities, or civilizations, in entity_*.txt files.

== Gameplay ==
{| {{prettytable}}
|- bgcolor="#ddd"
! Token
! Arguments
! Description

|-
| ADVENTURE_TIER
| order
| Allows adventure mode. Dwarfs, Elves, and Humans take up tier 3, 2, and 1 respectively. It seems that the best way to use this is to put your entity in the same order as the other tiers. The tiers are in descending order. So you should put a new adventure entity above the Dwarves. Not at the end of the file.
[ADVENTURE_TIER:4]

|-
| INDIV_CONTROLLABLE
|
| Allows the "Play Now!" option adventure mode. Not having this specified in one of the entities will cause the Adventure mode option to disappear.

|-
| 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). At least one civilization must have this token.

|-
| CREATURE
| creature
|The type of creature that will inhabit the civilization. Multiple entries will be chosen from at random for each civilization.
[CREATURE:DWARF]

|}

== Placement ==

{| {{prettytable}}
|- bgcolor="#ddd"
! Token
! Arguments
! Description

|-
| BIOME_SUPPORT
|
* {{L|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]

|-
| START_BIOME
| {{L|Biome token|biome}}
| Birth of the civilization can be performed on this biome.
[START_BIOME:MOUNTAIN]

|-
| DEFAULT_SITE_TYPE
| site type
| Also determines symbol used when selecting civilization. CAVE uses no symbol. Options are: CITY, TREE_CITY, DARK_FORTRESS, CAVE, CAVE_DETAILED, (in 40d also RUIN)
[DEFAULT_SITE_TYPE:CAVE_DETAILED]

|-
| LIKES_SITE
| site type
| Most residents will try to move to this site type, unless already at one.
[LIKES_SITE:CAVE_DETAILED]

|-
| TOLERATES_SITE
| site type
| Some residents will try to move to this site type, unless already at one.
[TOLERATES_SITE:CITY]

|-
| WORLD_CONSTRUCTION
| construction
| Controls which constructions the civ will build on the world map.
[WORLD_CONSTRUCTION:BRIDGE]
[WORLD_CONSTRUCTION:ROAD]
[WORLD_CONSTRUCTION:TUNNEL]
[WORLD_CONSTRUCTION:WALL]

|}

== Population ==

{| {{prettytable}}
|- bgcolor="#ddd"
! Token
! Arguments
! Description

|-
| START_GROUP_NUMBER
| number
| Number of breeding couples to start with per entity. Note that single-gender (eg. [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]

|-
| MAX_POP_NUMBER
| number
| Max population *per entity*, multiply this by max starting civ to get the total population of the species.
[MAX_POP_NUMBER:500]

|-
| MAX_SITE_POP_NUMBER
| number
| Max population per individual site.
[MAX_SITE_POP_NUMBER:200]

|-
| MAX_STARTING_CIV_NUMBER
| number
| Max number of entities to spawn at world generation.
[MAX_STARTING_CIV_NUMBER:3]

|}

== Flavor ==
{| {{prettytable}}
|- bgcolor="#ddd"
! Token
! Arguments
! Description

|-
| PERMITTED_BUILDING
| building name
| The named, custom building can be built by a civilization in Fortress Mode.
[PERMITTED_BUILDING:SOAP_MAKER]

|-
| PERMITTED_JOB
| {{L|Unit type token|profession}}
| Allows this job type to be selected. This applies to worldgen creatures, in the embark screen, and in play.
[PERMITTED_JOB:MINER]

|-
| PERMITTED_REACTION
| reaction name
| Allows this reaction to be used by a civilization. It is used primarily in Fortress Mode. 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]

|-
| CURRENCY_BY_YEAR
|
| Causes the civ's currency to be numbered with the year it was minted.

|-
| CURRENCY
|
* metal token
* value
| What kind of metals the civ uses for coin minting as well as the value of the coin.
[CURRENCY:SILVER:5]

|-
| 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]

|-
| ART_IMAGE_ELEMENT_MODIFIER
|
* item
* number
| CREATURE, PLANT, TREE, SHAPE, ITEM
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]

|-
| ITEM_IMPROVEMENT_MODIFIER
|
* item
* number
| ART_IMAGE, COVERED, RINGS_HANGING, BANDS, SPIKES, ITEMSPECIFIC, THREAD, CLOTH, SEWN_IMAGE: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.

|-
| 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]

|-
| CULL_SYMBOL
|
* noun
* symbol
| ALL, CIV, SITE
Causes the entity to not use the words in these SYM sets.
[CULL_SYMBOL:ALL:UGLY]

|-
| SELECT_SYMBOL
|
* noun
* symbol
| Causes the entity to more often use these symbols in the particular SYM set.
[SELECT_SYMBOL:ALL:PEACE]

|-
| FRIENDLY_COLOR
| see {{L|color}}
|
The color of this entity's civilization settlements in the world gen and embark screens
[FRIENDLY_COLOR:1:0:1]

|}

== Religion ==
{| {{prettytable}}
|- bgcolor="#ddd"
! Token
! Arguments
! Description

|-
| 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]

|-
| RELIGION_SPHERE
| sphere
| Can by any available {{L|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]

|-
| 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

|-
| 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 {{l|Position token}}.

|-
| 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.

|-
| 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

|-
| [[Ethics|ETHIC]]
|
*behavior
*reaction
| Sets the civ's view of 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]

|-
| WILL_ACCEPT_TRIBUTE
|
| Makes the civ's traders accept offered goods.

|-
| WANDERER, BEAST_HUNTER, SCOUT
|
| The civ will send out these sorts of adventurers in worldgen.

|-
| 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.

|-
| 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]

|-
| 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.

|-
| 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.

|-
| 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 history gen, allowing them to become part of the civ if they do not escape.

Note: If playable civ in Fortress Mode has this tag (ie. 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.

|-
| DIPLOMAT
|
| Presumably causes the civilization to send a diplomat once your fortress reaches a certain state.

|-
| DIPLOMAT_BODYGUARDS
|
| Effect unknown.

|-
| INVADERS_IGNORE_NEUTRALS
|
|

|-
| 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.

|-
| MERCHANT_BODYGUARDS
|
| Merchants have bodyguards and wagons. Wagons allow for a lot more variety in their goods.

|-
| 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.

|-
| 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. 0 corresponds to no population requirement necessary for interaction. 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.

|-
| 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. Progress triggers may be changed, added, or deleted for a currently active fort.

|-
| 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. Progress triggers may be changed, added, or deleted for a currently active fort.

|-
| 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. 0 corresponds to no population requirement necessary for interaction. 1 corresponds to 20 dwarves, 2 to 50 dwarves, 3 to 80, 4 to 110, and 5 to 140.

|-
| 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.

|-
| 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.

|-
| SIEGER
|
| Will wait around at the edge of your map for a month or two, before charging.

|-
| SKULKING
|
| This makes the severity of attacks depend on the extent of item/baby thievery rather than the passage of time.

|-
| TREE_CAP_DIPLOMACY
|
| Makes the entity angry if you cut down too many trees. They will send a warning first.

|-
| LAYER_LINKED
|
| Defines if a civilization is a hidden subterranean entity, such as batman civilizations.

|}

== Items and Animals Used ==
{| {{prettytable}}
|- bgcolor="#ddd"
! Token
! Arguments
! Description

|-
| AMMO
| item token
|
[AMMO:ITEM_AMMO_BOLTS]

|-
| ARMOR
|
* item token
* rarity
|Rarity is optional. Permitted rarity values include RARE, UNCOMMON, COMMON, and FORCED.
[ARMOR:ITEM_ARMOR_PLATEMAIL:COMMON]

|-
| DIGGER
| item token
|
[DIGGER:ITEM_WEAPON_PICK]

|-
| GLOVES
|
* item token
* rarity
| Rarity is optional. Permitted rarity values include RARE, UNCOMMON, COMMON, and FORCED.
[GLOVES:ITEM_GLOVES_GLOVES:COMMON]

|-
| HELM
|
* item token
* rarity
| Rarity is optional. Permitted rarity values include RARE, UNCOMMON, COMMON, and FORCED.
[HELM:ITEM_HELM_HELM:COMMON]

|-
| INSTRUMENT
| item token
|
[INSTRUMENT:ITEM_INSTRUMENT_FLUTE]

|-
| PANTS
|
* item token
* rarity
| Rarity is optional. Permitted rarity values include RARE, UNCOMMON, COMMON, and FORCED.
[PANTS:ITEM_PANTS_PANTS:COMMON]

|-
| SHIELD
| item token
|
[SHIELD:ITEM_SHIELD_SHIELD]

|-
| SHOES
|
* item token
* rarity
| Rarity is optional. Permitted rarity values include RARE, UNCOMMON, COMMON, and FORCED.
[SHOES:ITEM_SHOES_SHOES:COMMON]

|-
| SIEGEAMMO
| item token
|
[SIEGEAMMO:ITEM_SIEGEAMMO_BALLISTA]

|-
| TOY
| item token
|
[TOY:ITEM_TOY_PUZZLEBOX]

|-
| TRAPCOMP
| item token
|
[TRAPCOMP:ITEM_TRAPCOMP_GIANTAXEBLADE]

|-
| WEAPON
| item token
|
[WEAPON:ITEM_WEAPON_AXE_BATTLE]

|-
| USE_ANIMAL_PRODUCTS
|
|

|-
| USE_ANY_PET_RACE
|
| Assuming it passes other checks, any creature in their list of usables (from common domestic if they have that or 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 (next time, it'll let them use mounts/pullers/pack animals of any kind as well, but I'm not sure this matters in the stock raws). 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.

|-
| USE_CAVE_ANIMALS
|
| If they don't have it, creatures with exclusively subterranean biomes are skipped.

|-
| USE_EVIL_ANIMALS
|
| Don't have it -> EVIL creatures skipped.

|-
| USE_EVIL_PLANTS
|
| As EVIL creatures for all uses of plants.

|-
| USE_EVIL_WOOD
|
| As EVIL creatures for all uses of wood.

|-
| USE_GOOD_ANIMALS
|
| Don't have it -> GOOD creatures skipped.

|-
| USE_GOOD_PLANTS
|
| As GOOD creatures for all uses of plants.

|-
| USE_GOOD_WOOD
|
| As GOOD creatures for all uses of wood.

|-
| USE_MISC_PROCESSED_WOOD_PRODUCTS
|
| If wood is available locally, and the relevant professions are permitted, controls availability of lye, charcoal, potash and pearlash.

|-
| COMMON_DOMESTIC_MOUNT
|
| If a creature has PET and the relevant COMMON_DOMESTIC_x tag (or COMMON_DOMESTIC for pets), it will be allowed if it passes the other checks.

|-
| COMMON_DOMESTIC_PACK
|
| If a creature has PET and the relevant COMMON_DOMESTIC_x tag (or COMMON_DOMESTIC for pets), it will be allowed if it passes the other checks. Also seems to be required currently for trading to occur.

|-
| COMMON_DOMESTIC_PET
|
| If a creature has PET and the relevant COMMON_DOMESTIC_x tag (or COMMON_DOMESTIC for pets), it will be allowed if it passes the other checks. Also seems to be required to have any animals at all, including those used in trading.

|-
| COMMON_DOMESTIC_PULL
|
| If a creature has PET and the relevant COMMON_DOMESTIC_x tag (or COMMON_DOMESTIC for pets), it will be allowed if it passes the other checks.

|-
| RIVER_PRODUCTS
|
| Allow civ to use river products in the goods it has available for trade.

|-
| OCEAN_PRODUCTS
|
| Allow civ to use ocean products in the goods it has available for trade.

|-
| INDOOR_FARMING
|
| Allow civ to use underground plant products in the goods it has available for trade.

|-
| OUTDOOR_FARMING
|
| Allow civ to use outdoor plant products in the goods it has available for trade.

|-
| CLOTHING
|
| Civ members will attempt to wear clothing.

|-
| SUBTERRANEAN_CLOTHING
|
| Will wear things made of spider silk and other subterranean materials.

|-
| EQUIPMENT_IMPROVEMENTS
|
| Adds decorations to equipment based on the level of the generated unit. Also improves item quality.

|-
| IMPROVED_BOWS
|
| Adds decorations to weapons generated for bowman and master bowman. An elf hack.

|-
| METAL_PREF
|
| Allows the entity to use the metal with the highest values for DAMAGE_PERC or BLOCK_PERC without DEEP. Currently only dwarves have this token. Without this token, the entity will use the best metal below or equal to 100%.

|-
| STONE_PREF
|
| Enables creatures of this entity to bring stones in trade. Also seems to enable the use of metals smelted from ore, such as iron or copper.

|-
| WOOD_WEAPONS
|
| Causes members to be able to use wooden weapons.

|-
| WOOD_ARMOR
|
| Causes members to be able to use wooden armor.

|-
| GEM_PREF
|
| Enables creatures of this entity to bring gems in trade.

|-
| INDOOR_WOOD
|
| Allow civ to trade subterranean wood types, such as tower-cap and fungiwood logs.

|-
| OUTDOOR_WOOD
|
| Allow civ to use outdoor wood types, such as mangrove and oak.

|}

== TISSUE STYLING RELATED TOKENS ==
{| {{prettytable}}
|- bgcolor="#ddd"
! Token
! Arguments
! Description

|-
| TISSUE_STYLE
|
*tissue???
| Presumably selects tissue to set cultural style parameters for. Needs testing.

|-
| TS_MAINTAIN_LENGTH
|
*length?
*???
| Presumably sets culturally preferred tissue length for selected tissue. Needs testing.

|-
| TS_PREFERRED_SHAPING
| ???
| Presumably sets culturally preferred tissue shapings for selected tissue. Needs testing.

{{Category|Modding}}
{{Category|Tokens}}

v0.31:Creature token

2011-02-22T04:06:53Z

Bohandas: Added NORMAL, SET_LAYER_TISSUE, TISSUE_LAYER_OVER, and TISSUE_NAME tags

{{av}}{{Quality|Exceptional}}

Tentative at best in some cases.

__NOTOC__

<div align="center">
{{alphabetical TOC}}
</div>

==A==
{| {{prettytable}}
|- bgcolor="#ddd"
! width="20%" | Token
! width="20%" | Arguments
! width="60%" | Description
|-
| ALCOHOL_DEPENDENT
|
| Creature needs alcohol to get through the working day.

|-
| ALL_ACTIVE
|
| Sets if the creature is active in day, night, and twilight. Seems to be a separate value from DIURNAL/NOCTURNAL/CREPUSCULAR, rather than implying them.

|-
| ALTTILE
|
| If set, the creature will blink between its [TILE] and its [ALTTILE].

|-
| AMBUSHPREDATOR
|
| Makes the creature start out hidden. Used by {{L|giant cave spider}}s. May make {{L|web}}s hidden too.

|-
| AMPHIBIOUS
|
| Allows a creature to breathe with or without {{L| water}}. Implies [AQUATIC].

|-
| APP_MOD_DESC_RANGE
| ?
| ?

|-
| APP_MOD_GENETIC_MODEL
|
|

|-
| APP_MOD_IMPORTANCE
|
*number
| Determines how important the appearance modifier is, for determining whether it shows up in the creature description.{{verify}}

|-
| APP_MOD_NOUN
|
*noun
*SINGULAR or PLURAL
| creates a noun for the appearance and whether it is singular or plural

|-
| APP_MOD_RATE
|
*Rate (integer)
*Scale (DAILY, YEARLY)
*min:max of growth
*start year:start day
*end year:end day
| setting the growth rate of the modifier. The last two tokens can be replaced by NO_END to have growth continue indefinitely.

|-
| APPLY_CREATURE_VARIATION
|
*CV TEMPLATE NAME
| Loads the Creature Variation Template specified.

|-
| APPLY_CURRENT_CREATURE_VARIATION
|
| Applies loaded Creature Variation

|-
| AQUATIC
|
| Allows a creature to breathe underwater, but causes it to "drown" out of {{L| water}}.

|-
| ARENA_RESTRICTED
|
| Does not appear in arena mode list

|-
| ARTIFICIAL_HIVEABLE
|
| Can be kept in artificial hives by beekeepers.

|-
| ATTACK
|
*token
*bodypart
*selection criteria
*location
| Defines the attack name, and the body part used.
'''Example:'''<br />
[ATTACK:GORE:BODYPART:BY_CATEGORY:HORN]<br />
''GORE'' : name of the attack<br />
''BODYPART:BY_CATEGORY:HORN'' : the horn is used to attack (presuming the creature has one)

|-
| ATTACK_CONTACT_PERC
|
*% value
| amount of available tissue used in attack

|-
| ATTACK_FLAG_CANLATCH
|
| Enables an attacker to occasionally latch on with the bodypart used by an attack when an attack with this flag in it's definition is made.

|-
| ATTACK_FLAG_EDGE
|
| attack type

|-
| ATTACK_FLAG_WITH
|
| In adventure mode, displays the name of the body part used by an attack when announcing the attack.

|-
| ATTACK_PENETRATION_PERC
|
*% value
| probably amount of material that makes contact when penetration is done

|-
| ATTACK_PRIORITY
|
*MAIN or SECOND
| use of the attack in combat. Secondary attacks are only used if main attacks are impossible.

|-
| ATTACK_SKILL
|
*skill used ({{L|Skill tokens}})
| defines the attack skill used

|-
| ATTACK_TRIGGER
| pop:exported wealth:created wealth{{verify}}
| stages when a megabeast will attack a site

|-
| ATTACK_VERB
| 2nd person:3rd person
| descriptive text for the attack

|-
| ATTACK_VELOCITY_MODIFIER
| number
| Modifies the attack velocity. Believed to be percent based (so 100 would be "normal"). May be on same scale as weapon velocity (where 1000 is "normal").

|}

<div align="center">
{{alphabetical TOC}}
</div>

==B==
{| {{prettytable}}
|- bgcolor="#ddd"
! width="20%" | Token
! width="20%" | Arguments
! width="60%" | Description
|-
| BABY
| integer
| age at which creature is considered a child. Default is zero. One can think of this as the duration of the baby stage.

|-
| BABYNAME
| singular:plural
| name at caste level

|-
| BEACH_FREQUENCY
|
| {{L|Whale}}s and {{L|Sea nettle jellyfish|jellyfish}} have this. Controls the beaching frequency of the creature.

|-
| BENIGN
|
| Determines whether creature can show up on "tame" maps (includes {{L|elephants}}), which will generally avoid dwarves, although they may chase and/or attack them if they get too close).

|-
| BIOME
|
* biome token
| Select a {{L|Biome}} the creature may appear in.

|-
| BLOOD, PUS, OTHER MATERIAL state definition
|
*selection criteria. Often LOCAL_CREATURE_MAT, although other selection criteria may work too.
*selected material
*matter state (LIQUID, GAS, ALL_SOLID)
| Controls bleeding behaviour

|-
| BODY
| body parts
| Draws body parts from OBJECT:BODY files (such as body_default.txt)
'''Example:'''<br />
[BODY:BODY_WITH_HEAD_FLAG:HEART:GUTS:BRAIN:MOUTH] <br />
This is the body from a {{L|Purring maggot}}. It creates a body with head, a heart, some guts, a brain, and a mouth. Thats all a maggot needs.

|-
| BODY_APPEARANCE_MODIFIER
|
*ATTRIBUTE
*lowest:lower:low:median:high:higher:highest
| These body modifiers give individual creatures different characteristics. In the case of HEIGHT, BROADNESS and LENGTH, the modifier is also a percentage change to the BODY_SIZE of the individual creature. The seven numbers afterward give a distribution of ranges. Each interval has an equal chance of occurring.
'''Example:'''<br />
[BODY_APPEARANCE_MODIFIER:LENGTH:90:95:98:100:102:105:110] <br />
''HEIGHT'' : marks the height to be changed <br />
''90:95:98:100:102:105:110'' : sets the range from the shortest (90% of the average height) to the tallest (110% of the average height) creature variation.

|-
| BODY_DETAIL_PLAN
| PlanName, PlanName:type:type:type:etc
| loads a plan listed OBJECT:BODY_DETAIL_PLAN files, such as b_detail_plan_default.txt. Mass applies USE_MATERIAL_TEMPLATE, mass alters RELSIZE, alters body part positions, and will allow tissue layers to be defined. Tissue layers are defined in order of skin to bone here.
'''Example:'''<br />
[BODY_DETAIL_PLAN:VERTEBRATE_TISSUE_LAYERS:SKIN:FAT:MUSCLE:BONE:CARTILAGE] <br />
This creates the detailed body of a {{L|fox}}, the skin, fat, muscle, bones and cartilage out of the vertebrate tissues.<br />
A {{L|Purring maggot|maggot}} would only need:<br />
''[BODY_DETAIL_PLAN:EXOSKELETON_TISSUE_LAYERS:SKIN:FAT:MUSCLE]''

|-
| BODY_SIZE
| years:days:size
| sets up size at a given time. Size is roughly equal to the creature's average weight in grams.
'''Example:'''<br />
[BODY_SIZE:0:0:10000]<br />
[BODY_SIZE:1:168:50000]<br />
[BODY_SIZE:12:0:220000]<br />
This describes the size of a {{L|minotaur}}. His birth size would be 10000 (~10 kg). With 1 year and 168 days he would be 50000 tall (~50 kg). As an adult (with 12 years) he would weight roughly 220 kg

|-
| BODYGLOSS
| gloss
| Substitutes body part text with replacement text. Draws gloss information from OBJECT:BODY files (such as body_default.txt)

|-
| BONECARN
|
| Creature 'eats' bones. Eating bones makes their happiness go up, but can cause death (suffocation){{verify}}. Implies CARNIVORE.

|-
| BP_APPEARANCE_MODIFIER
|
*QUALITY
*lowest:lower:low:median:high:higher:highest
| sets up the breadth of possibilities for appearance qualities for a selected BP group. EG. Eyes (CLOSE_SET, DEEP_SET, ROUND_VS_NARROW, LARGE_IRIS),Lips (THICKNESS), Nose (BROADNESS, LENGTH, UPTURNED, CONVEX), Ear (SPLAYED_OUT, HANGING_LOBES, BROADNESS, HEIGHT), Tooth (GAPS), Skull (HIGH_CHEEKBONES, BROAD_CHIN, JUTTING CHIN, SQUARE_CHIN), Neck (DEEP_VOICE, RASPY_VOICE), Head (BROADNESS, HEIGHT)

|-
| BUILDINGDESTROYER
| 1 or 2
| Allows a creature to destroy furniture and buildings. Value [1] targets mostly doors, hatches, furniture and the like. Value [2] targets anything not made with the b + C commands.
|}

<div align="center">
{{alphabetical TOC}}
</div>

==C==
{| {{prettytable}}
|- bgcolor="#ddd"
! width="20%" | Token
! width="20%" | Arguments
! width="60%" | Description

|-
| CAN_LEARN
|
| The creature gets skills and professions. Note that this token makes the creature unable to be butchered by an adventurer so it is not recommended for uncivilized monsters. Adventurers lacking this token can allocate but not increase attributes and skills. skills allocated will disappear on start.

|-
| CAN_SPEAK
|
| Can talk. Note that it is not necessary for a creature to gain social skills.

|-
| CANNOT_UNDEAD
|
| Cannot be turned into a zombie or skeletal undead

|-
| CANOPENDOORS
|
| Allows the creature to open doors.

|-
| CARNIVORE
|
| Creature ''only'' eats meat

|-
| CASTE
|
*name
| defines a caste

|-
| CASTE_ALTTILE
|
*tile number or "letter"
| Caste-specific alternate tile. Expects CASTE_TILE

|-
| CASTE_COLOR
|
*fg
*bg
*brightness
| Creature tile color of the caste.

|-
| CASTE_GLOWCOLOR
|
*fg
*bg
*brightness
| GLOWTILE color of the caste.

|-
| CASTE_GLOWTILE
|
*tile value or "letter"
| Caste-specific glowtile

|-
| CASTE_NAME
| singular:plural:adjective
| The name of the caste of the creature in the game.

|-
| CASTE_PROFESSION_NAME
|
*Profession
*singular
*plural
| alters the name of the given profession, caste-specific

|-
| CASTE_SOLDIER_ALTTILE
| 'character' or tile number
| Creatures of this caste active in their civilization's military will blink between their default tile and this one.

|-
| CASTE_SOLDIER_TILE
| 'character' or tile number
| Creatures of this caste active in their civilization's military will use this tile instead.

|-
| CASTE_SPEECH
| speech file?
| Possibly a caste-specific instance of the SPEECH token

|-
| CASTE_TILE
|
* tile number or "letter"
| Caste-specific creature tile.

|-
| CAVE_ADAPT
|
| Gives the creature a bonus in caves. Also causes [[Cave adaptation]].

|-
| CE_X
|
*SEV:<value> (severity, higher is worse)
*PROB:<value(1-100)> (probability)
*RESISTABLE (optional) allows resistance
*SIZE_DILUTES (optional) lessens effect based on size
Place effected:
*LOCALIZED (optional)
*VASCULAR_ONLY (optional)
*MUSCULAR_ONLY (optional)
*BP:(select BY_CATEGORY, BY_TYPE, or BY_TOKEN):category, type or token:tissues affected (specific or ALL) (optional)
Timeline:
*Start:effect start time
*Peak:effect peak time
*End:effect end time
| Specifies the way that a syndrome affects a creature -- more detail can be found on the [[Syndrome#Creature effect tokens|Syndromes page]]

|-
| CHANGE_BODY_SIZE_PERC
|
|

|-
| CHILD
| integer
| age at which creature is considered an adult. One can think of this as the duration of the child stage. Without this token, a creature will not reproduce in Fortress mode.

|-
| CHILD_BODYPART_GROUP
|
*master selection, BY_CATEGORY, BY_TYPE, BY_TOKEN.
*master location
*specific selection, BY_CATEGORY, BY_TYPE, BY_TOKEN.
*specific location
| selects all parts of a group to be used.

|-
| CHILDNAME
| singular:plural
| name at caste level

|-
| CLUSTER_NUMBER
|
*min
*max
| The minimum/maximum numbers of how many creatures per spawned cluster. Certain vermin fish use this token in combination with temperate ocean and river biome tokens to perform seasonal migrations.
e.g. [CLUSTER_NUMBER:1:3]

|-
|CLUTCH_SIZE
|
*min
*max
|Number of eggs laid in one sitting.

|-
| COLDDAM_POINT
| value
| The minimum temperature limit before the currently selected material will start receiving damage from freezing. Used mostly in material templates.

|-
| COLONY_EXTERNAL
|
| Caste hovers around colony.

|-
| COLOR
| foreground:background:brightness
| Color of the creature's tile.

|-
| COMMON_DOMESTIC
|
| Allows the creature to be brought with immigrants and when creating a new fortress, as long as the creature also includes at least one of the following tokens: PET, PACK_ANIMAL, WAGON_PULLER, MOUNT. In addition, the creature must be NATURAL rather than FANCIFUL

|-
| CONVERTED_SPOUSE
|
| Found only at caste level. Creatures of this caste's species with the SPOUSE_CONVERTER and NIGHT_CREATURE_HUNTER tokens will kidnap SPOUSE_CONVERSION_TARGETs of an appropriate sex and convert them into castes with CONVERTED_SPOUSE.

|-
| COOKABLE_LIVE
|
| Set this to allow the creature to be cooked in meals without first being butchered / fishcleaned.

|-
| COPY_TAGS_FROM
|
*CREATURE NAME
| Copies tags from another specified creature.

|-
| CREATURE
| name
| begins defining a new creature with the specified name.

|-
| CREATURE_CLASS
|
*classname
| Creature class. Can be anything, but only existing use is GENERAL_POISON. Appears to only be used for Syndromes. Supposedly can also be used for entity positions.

|-
| CREATURE_SOLDIER_TILE
| 'character' or tile number
| Creatures active in their civilization's military will use this tile instead.

|-
| CREATURE_TILE
| 'character' or tile number
| The symbol of the creature in ASCII mode.

|-
| CREPUSCULAR
|
| Sets if the creature is active at twilight. This tag functions as a combination of the two tags VESPERTINE and MATUTINAL.

|-
| CURIOUSBEAST_EATER
|
| Allows a creature to steal and eat edible items from a site.

|-
| CURIOUSBEAST_GUZZLER
|
| Allows a creature to (very quickly) drink your alcohol. Or spill the barrel to the ground. Also affects undead versions of the creature.

|-
| CURIOUSBEAST_ITEM
|
| Allows a creature to steal things (apparently the highest value it can find). Semimegabeast thievery is in Legends mode. Lightweight creatures can probably steal heavy items.

|-
| CV_ADD_TAG
|
*TAG NAME
| Adds a tag. Used in conjunction with creature variation templates.

|-
| CV_REMOVE_TAG
|
*TAG NAME
| Removes a tag. Used in conjunction with creature variation templates.
|}

<div align="center">
{{alphabetical TOC}}
</div>

==D==
{| {{prettytable}}
|- bgcolor="#ddd"
! width="20%" | Token
! width="20%" | Arguments
! width="60%" | Description

|-
| DEMON
|
| Typically found on genned [[demon]]s; sets the creature as a potential spawn for [[Hidden Fun Stuff]]

|-
| DESCRIPTION
| text
| A brief description of the creature type.

|-
| DIE_WHEN_VERMIN_BITE
|
| Dies upon attacking. Used for bee stings.

|-
| DIFFICULTY
| integer
| Toady: "Difficulty determines how deep it places them in adventure mode/reclaim caves, and the chance that they are wounded the first few river attacks." Also increases experience gain during adventure mode.

|-
| DIURNAL
|
| Sets if the creature is active in day.

|-
| DOES_NOT_EXIST
|
| Creature does not actually exist; used for fanciful creatures.

|-
| DRAGONFIREBREATH
|
| Creature breathes fire in a cone.
|}

<div align="center">
{{alphabetical TOC}}
</div>

==E==
{| {{prettytable}}
|- bgcolor="#ddd"
! width="20%" | Token
! width="20%" | Arguments
! width="60%" | Description

|-
| EGG_MATERIAL
|
*LOCAL_CREATURE_MAT
*EGGSHELL/EGG_WHITE/EGG_YOLK
*state (solid, liquid, or gas)
| Egg material. Eggs will be made out of eggshell. Edibility is determined by tags on whites or yolk, but they otherwise do not exist.

|-
| EGG_SIZE
|
*size
| Size of creature's egg?

|-
| EQUIPMENT_WAGON
|
| Makes the creature into a large 3x3 creature responsible for carrying trade goods, pulled by two [WAGON_PULLER]s and driven by a merchant.

|-
| EQUIPS
|
| Allows the creature to wear or wield items.

|-
| EVIL
|
| Determines whether creature can show up on "evil" maps

|-
| EXTRAVISION
|
| Creature can see regardless of whether it has working eyes.
|}

<div align="center">
{{alphabetical TOC}}
</div>

==F==
{| {{prettytable}}
|- bgcolor="#ddd"
! width="20%" | Token
! width="20%" | Arguments
! width="60%" | Description
|-
| FANCIFUL
|
| Makes every civilization know about the creature. The creature won't occur in regular material preference lists. The tag also adds some art value modifiers. Used for things like dragons and other legendary creatures.

|-
| FEATURE_ATTACK_GROUP
|
| Found on subterranean animalmen.

|-
| FEMALE
|
| Inside a female caste, sets femaleness. Outside of a caste, sets all individuals female unless overridden by caste.

|-
| FIREBREATH
|
| The creature breathes fire projectiles (as opposed to DRAGONFIREBREATH, which is in a cone).

|-
| FIREIMMUNE
|
| As of version v0.28.181.40d, the FIREIMMUNE token had no effect on a creature's resistance to flame or heat. However, it did affect ability to swim in magma in adventure mode, as well as display of "You are caught in a pool of magma!" warning messages. It is unknown if these effects persist in DF 2010.

|-
| FIREIMMUNE_SUPER
|
| The creature is immune to DRAGONFIREBREATH. Implies FIREIMMUNE.

|-
| FISHITEM
|
| Needs to be cleaned at a fishery

|-
| FIXED_TEMP
| temperature
| The natural heat generated by the creature.

|-
| FLEEQUICK
|
| Determines how soon a creature flees in a losing battle.

|-
| FLIER
|
| Allows a creature to fly. Fortress Mode pathfinding only partially incorporates pathfinding - flying dwarves need a land path to exist between them and an area in order to access it, but as long as one such path exists, they do not need to use it, instead being able to fly over intervening obstacles.

|-
| FREQUENCY
|
*number, max 100
| Determines the time between creature spawns in Fortress Mode. Higher is more occurrences per time unit. Creatures without a frequency statement default to 50. Almost all others have either [FREQUENCY:5] or [FREQUENCY:100]. Not to be confused with POP_RATIO
|}

<div align="center">
{{alphabetical TOC}}
</div>

==G==
{| {{prettytable}}
|- bgcolor="#ddd"
! width="20%" | Token
! width="20%" | Arguments
! width="60%" | Description
|-
| GENERAL_BABY_NAME
| singular:plural
| name at creature level

|-
| GENERAL_CHILD_NAME
| singular:plural
| name at creature level

|-
| GENERATED
|
| Found on procedurally generated creatures like [[Forgotten beast]]s, (biome name) titans and [[Demon]]s.

|-
| GETS_INFECTIONS_FROM_ROT
|
| creature can be infected by rot

|-
| GETS_WOUND_INFECTIONS
|
| creature can get infections from wounds

|-
| GLOWCOLOR
|
*foreground
*background
*brightness
| The colour of the GLOWTILE of the creature.

|-
| GLOWTILE
| ascii character
| If present, the being glows in the dark (generally used for Adventure Mode). The tile is what replaces the being's current tile when it is obscured from your sight by darkness. The default setting for kobolds (a yellow quotation mark) provides a nice "glowing eyes" effect. The game is also hardcoded to automatically convert quotation mark GLOWTILES into apostrophes if the creature has lost one eye. This works at the generic creature level - for caste-specific glow tiles, use CASTE_GLOWTILE instead.

|-
| GNAWER
| verb (gnawed)
| The creature chews on food barrels and bags.

|-
| GO_TO_END
|
| uncertain use, definitely refers to Creature Variants template

|-
| GO_TO_START
|
| uncertain use, definitely refers to Creature Variants template

|-
| GOOD
|
| Determines whether creature can show up on "good" areas. Eg. unicorn.

|-
| GRASSTRAMPLE
| value
| Determines the percentage chance of trampling and killing grass when a creature steps on it. Set [GRASSTRAMPLE:0] to make grass never trampled by the creature.

|-
| GRAVITATE_BODY_SIZE
|
| Creature Variants template command, alter body size.

|-
| GRAZER
|
*number
| Animals is a grazer. The higher the number, the less grass it needs.
|}

<div align="center">
{{alphabetical TOC}}
</div>

==H==
{| {{prettytable}}
|- bgcolor="#ddd"
! width="20%" | Token
! width="20%" | Arguments
! width="60%" | Description
|-
| HABIT
| type:probability
| Defines certain behaviors for the creature. The habit types are COLLECT_TROPHIES, COOK_PEOPLE, COOK_VERMIN, GRIND_VERMIN, COOK_BLOOD, GRIND_BONE_MEAL, EAT_BONE_PORRIDGE, USE_ANY_MELEE_WEAPON, and COLLECT_WEALTH. These may require the creature to have a lair to work properly.

|-
| HABIT_NUM
| number or TEST_ALL
| Unknown. All lists of HABITs are preceded by [HABIT_NUM:TEST_ALL]

|-
| HAS_NERVES
|
| This makes the creature susceptible to severed motor and sensory nerves when muscles are torn in limb, grasp and stance parts. Some butchering yields nervous tissue.

|-
| HEATDAM_POINT
| value
| The maximum temperature limit before the currently selected material will start receiving damage from heat. Used mostly in material templates.

|-
| HIVE_PRODUCT
|
*number
*time
*item tokens
| What product is harvested from beekeeping.

|-
| HOMEOTHERM
|
| Default 'NONE'. The creature's normal body [[DF2010:Temperature |temperature]]
|}

<div align="center">
{{alphabetical TOC}}
</div>

==I==
{| {{prettytable}}
|- bgcolor="#ddd"
! width="20%" | Token
! width="20%" | Arguments
! width="60%" | Description
|-
| IF_EXISTS_SET_BOILING_POINT
| value
| The temperature at which the creature boils into gases.

|-
| IF_EXISTS_SET_MELTING_POINT
| value
| The temperature at which the creature will melt into goo.

|-
| IGNITE_POINT
| value
| The temperature at which the creature will burst into flames.

|-
| IMMOBILE_LAND
|
| The creature is immobile while on land. Only works on AQUATIC creatures which can't breath on land.

|-
| IMMOLATE
|
| Will ignite, and potentially completely destroy, items the creature is standing on. Keep booze away from critters with this tag.

|-
| INSULATION
| value
| increases the insulation of a selected material (usually hair, feathers or skin)

|-
| INTELLIGENT
|
| Implies CAN_SPEAK and CAN_LEARN. CAN_LEARN probably means the creature gets skills and professions. Not recommended for uncivilized monsters.

|-
| ITEMCORPSE
|
* [[Item token]]
* subtype
NO_SUBTYPE
* matgloss token
* NO_RACEGLOSS
USE_RACEGLOSS USE_SHARPSTONE
| Determines if the creature leaves behind a non-standard corpse (i.e. wood, statue, bars, ash from ghost etc). The first parameter determines the item type; the second parameter is the subtype indicated in the raw file (such as WEAPON_WHIP); the third indicates the material type if the item type takes a specific material (e.g. ""IRON"" if the corpse type is ""STATUE""). USE_RACEGLOSS applies if the creature has a material glossary assigned by the ""HAS_RACEGLOSS:"" flag and will select necessary adjectives and material from that glossary.
As of 31_01, RACEGLOSS may no longer be in the game.{{verify}}

|-
| ITEMCORPSE_QUALITY
|
| The quality of an item-type corpse left behind; 5 is masterpiece-level.
|}

<div align="center">
{{alphabetical TOC}}
</div>

==L==
{| {{prettytable}}
|- bgcolor="#ddd"
! width="20%" | Token
! width="20%" | Arguments
! width="60%" | Description
|-
| LAIR
| type:probability
| Found on megabeasts, semimegabeasts, and night creatues. The creature will seek out sites of this type and take them as lairs. The lair types are SIMPLE_BURROW, SIMPLE_MOUND, SHRINE, and LABYRINTH.

|-
| LAIR_CHARACTERISTIC
| characteristic:probability
| Defines certain features of the creature's lair. The only known valid characteristic is HAS_DOORS.

|-
| LAIR_HUNTER
|
| This creature will actively hunt adventurers in its lair.

|-
| LAIR_HUNTER_SPEECH
| speech file
| What this creature says while hunting adventurers in its lair.

|-
| LARGE_PREDATOR
|
| Will attack things that are smaller than it (like dwarves). Only one group of "large predators" will appear on any given map (possibly two groups on "savage" maps). In adventure mode, large predators will try to ambush and attack you (and your party will attack them back). Also, they can be mentioned in the intro paragraph when starting a fortress e.g. "ere the wolves get hungry."

|-
| LARGE_ROAMING
|
| In Fortress Mode, spawns outdoors and is not a vermin creature.

|-
| LAYS_EGGS
|
| Creature lays eggs instead of giving birth to live young.

|-
| LAYS_UNUSUAL_EGGS
| Item tokens
| Creature lays a particular item instead of regular eggs. As of v0.31.19, this tag only makes the game crash.

|-
| LIGAMENTS
|
*selection criteria. Often LOCAL_CREATURE_MAT, although other selection criteria may work too.
*selected material. Almost always SINEW of the creature's materials.
*healing rate
| defines the material and healing rate of ligaments.

|-
| LIGHT_GEN
|
| The creature will generate light, such as in adventurer mode at night.

|-
| LIKES_FIGHTING
|
| The creature will attack enemies rather than flee from them. This tag has the same effect on player-controlled creatures - included modded dwarves.

|-
| LISP
|
| Creature multiplies 'S' when talking. Ex: "My name isss Recisssiz."

|-
| LITTERSIZE
|
* minumum
* maximum
| Determines the random chance of how many creatures are generated when giving birth. [LITTERSIZE:1:2]

|-
| LOCKPICKER
|
| Lets a creature open doors that are set to forbidden in Fortress Mode.

|-
| LOOSE_CLUSTERS
|
| The creatures will scatter if they have this tag, or form tight packs if they don't.
|}

<div align="center">
{{alphabetical TOC}}
</div>

==M==
{| {{prettytable}}
|- bgcolor="#ddd"
! width="20%" | Token
! width="20%" | Arguments
! width="60%" | Description

|-
| MAGMA_VISION
|
| Creature's able to see while covered in magma.

|-
| MALE
|
| all male

|-
| MANNERISM_??
|
*occassionally body part
| Adds a possible mannerism to the creature's profile.
Refer to {{L|Creature Token Mannerisms|Mannerisms}}

|-
| MATERIAL
|
*material id
| Begins defining a new material.{{verify}}

|-
| MATERIAL_BREATH_ATTACK
|
*MATERIAL TYPE (TISSUE, INORGANIC)
*MATERIAL NAME
*MATERIAL STATE (TRAILING_DUST_FLOW, TRAILING_VAPOR_FLOW, TRAILING_GAS_FLOW, SOLID_GLOB, LIQUID_GLOB, UNDIRECTED_GAS, UNDIRECTED_VAPOR, UNDIRECTED_DUST)
| Creates an attack referencing a material, using a given type of breath attack.

|-
| MAXAGE
| min:max
| range of time in which death from old age may occur

|-
| MEANDERER
|
| Gives a creature random movement.

|-
| MEGABEAST
|
| Appears on fortress territory in Fortress Mode occasionally. Implies SEMIMEGABEAST. Also can be worshipped

|-
|MENT_ATT_CAP_PERC
|
*ATTRIBUTE Token
*Cap %
|Default is 200. This means you can increase your attribute to 200% of its starting value (or the average value + your starting value if that is higher).

|-
| MENT_ATT_RANGE
|
*ATTRIBUTE
*lowest:lower:low:median:high:higher:highest | sets up a mental attribute's range of values. Max of 5000.

|-
| MENT_ATT_RATES
|
*ATTRIBUTE Token
*cost to improve
*unused counter rate
*rust counter rate
*demotion counter rate
| Attribute gain/decay rates. Defaults for are 500:2:3:2, except for RECUPERATION and DISEASE_RESISTANCE that don't have change rates. The last three slots may be replaced by NONE.

|-
| MILKABLE
|
*LOCAL_CREATURE_MAT:MILK:amount
| Allows the creature to be milked.

|-
| MISCHIEVIOUS
|
| Will pull any levers it comes across. Also makes creature spawn invisible and with several ranks in Ambusher. "They go on little missions to mess with various fortress buildings, not just levers."

|-
| MOUNT
|
| Creature may be used as a mount

|-
| MOUNT_EXOTIC
|
| You need the Dungeon master noble to mount the creature.

|-
| MULTIPLE_LITTER_RARE
|
| Makes litters with more than one offspring rare.

|-
| MULTIPLY_VALUE
|
*Multiplier
| multiplies value of materials

|-
| MUNDANE
|
| Marks if the creature is an actual real-life creature. Only used for age-names at present.
|}

<div align="center">
{{alphabetical TOC}}
</div>

==N==
{| {{prettytable}}
|- bgcolor="#ddd"
! width="20%" | Token
! width="20%" | Arguments
! width="60%" | Description
|-
| NAME
| singular:plural:adjective
| The generic name for any creature of this type - will be used when distinctions between caste are unimportant. For names for specific castes, use CASTE_NAME instead.

|-
| NATURAL
|
| Animal is considered to be natural.

|-
| NATURAL_SKILL
| skill:value
| The creature possesses this skill at this level inherently. It begins with this skill at this level, and the skill may never rust below this level.

|-
| NIGHT_CREATURE_BOGEYMAN
|
| Found on bogeymen. Presumably makes the creature attack the player at night in hordes like bogeymen do.

|-
| NIGHT_CREATURE_HUNTER
|
| If this creature has SPOUSE_CONVERTER, it will actively attempt to seek out potential conversion targets, abduct them, and convert them. Night creatures will seek out one SPOUSE_CONVERSION_TARGET of the opposite sex, convert them, and then have children with them. NIGHT_CREATURE_HUNTERs without SPOUSE_CONVERTER will not be placed.

|-
| NO_AUTUMN
|
| does not appear this season.

|-
| NO_DIZZINESS
|
| Creature cannot become dizzy

|-
| NO_DRINK
|
| Creature does not need to drink.

|-
| NO_EAT
|
| Creature does not need to eat.

|-
| NO_FEVERS
|
| Creature cannot suffer fevers

|-
| NO_SLEEP
|
| Creature does not need to sleep.

|-
| NO_SPRING
|
| does not appear this season.

|-
| NO_SUMMER
|
| does not appear this season.

|-
| NO_THOUGHT_CENTER_FOR_MOVEMENT
|
| Probably shorthand for movement being unaffected by damage in general.

|-
| NO_WINTER
|
| does not appear this season.

|-
| NOBONES
|
| Creature has no bones.

|-
| NOBREATHE
|
| Creature doesn't need to breathe or have [BREATHE] parts in body. Cannot drown or be strangled.

|-
| NOCTURNAL
|
| Sets if the creature is active in night.

|-
| NOEMOTION
|
| The creature has no emotions, and does not rage.

|-
| NOEXERT
|
| Creature can't become tired or over-exerted.

|-
| NOFEAR
|
| Creature doesn't feel fear and will never run away from battle.

|-
| NOMEAT
|
| Creature will not drop meat on butcher.

|-
| NONAUSEA
|
| Creature can't vomit.

|-
| NOPAIN
|
| Creature doesn't feel pain.

|-
| NORMAL
| ???
| Unknown. Found in string dump.

|-
| NOSKIN
|
| Creature will not drop skin on butcher.

|-
| NOSKULL
|
| Creature will not drop skull on butcher, rot, or decay of severed head.

|-
| NOSMELLYROT
|
| Does not produce miasma when rotting

|-
| NOSTUCKINS
|
| Weapons can't be stuck in creature.

|-
| NOSTUN
|
| Creature can't be stunned. Evidence suggests creatures with this tag never wake up from sleep in Fortress Mode.

|-
| NOT_BUTCHERABLE
|
| Cannot be butchered

|-
| NOTHOUGHT
|
| Creature doesn't think, or doesn't require a [BRAIN] body part.
|}

<div align="center">
{{alphabetical TOC}}
</div>

==P==
{| {{prettytable}}
|- bgcolor="#ddd"
! width="20%" | Token
! width="20%" | Arguments
! width="60%" | Description
|-
| PACK_ANIMAL
|
| Allows the creature to be used as a pack animal. Currently only used by merchants.

|-
| PARALYZEIMMUNE
|
| The creature is immune to all paralyzing special attacks.

|-
| PATTERNFLIER
|
|

|-
| PEARL
|
| Creature will generate pearls.

|-
| PENETRATEPOWER
| value
| Controls the ability of vermin to find a way into containers when they are eating food from your stockpiles. Wood and cloth objects roll a 0-9 and if it's greater than the penetrate power, their contents escape for the time being. Other objects roll a 0-99.

|-
| PERSONALITY
|
*ATTRIBUTE
*lowest:median:highest
| Determines the range and chance of personality traits. Standard is 0:50:100. See [[DF2010:Personality_trait|Personality traits]] for more info.

|-
| PET
|
| Allows the creature to be tamed.

|-
| PET_EXOTIC
|
| You need a Dungeon master noble in your fortress for the creature to be tamable (but any Animal trainer can do the taming).

|-
| PETVALUE
| value
| How valuable a tamed animal/pet is. Actual cost in points in the embarking screen is (PETVALUE/2)+1 for an untrained animal, PETVALUE+1 for a trained(War or Hunting) one. Note that for an animal to be selectable in this screen, it must have the COMMON_DOMESTIC token.

|-
|PHYS_ATT_CAP_PERC
|
*ATTRIBUTE Token
*Cap %
|Default is 200. This means you can increase your attribute to 200% of its starting value (or the average value + your starting value if that is higher).

|-
| PHYS_ATT_RANGE
|
*ATTRIBUTE
*lowest
*lower
*low
*median
*high
*higher
*highest
| sets up a physical attribute's range of values. Max of 5000.

|-
| PHYS_ATT_RATES
|
*ATTRIBUTE Token
*cost to improve
*unused counter rate
*rust counter rate
*demotion counter rate
| Attribute gain/decay rates. Defaults for are 500:2:3:2, except for RECUPERATION and DISEASE_RESISTANCE that don't have change rates. The last three slots may be replaced by NONE.

|-
| PLUS_BP_GROUP
|
*BY_TYPE, BY_CATEGORY, or BY_TOKEN
*body type, category, or token
| Adds a body part group to selected body part group.

|-
| PLUS_MATERIAL
|
*material
| Adds a material to selected materials.

|-
| PLUS_TISSUE_LAYER
|
*TISSUE
*BY_CATEGORY, BY_TYPE, BY_TOKEN
*Location - category, type, or token
| Adds a tissue to those selected

|-
| PLUS_TL_GROUP
|
*TISSUE
*BY_CATEGORY, BY_TYPE, BY_TOKEN
*Location - category, type, or token
*tissue
| continues a selection of tissue layers

|-
| POP_RATIO
|
| Weighted population of caste; Lower is rarer. Not to be confused with FREQUENCY.

|-
| POPULATION_NUMBER
| min:max
| The minimum/maximum numbers of how many of these creatures can show up on a map per year.

|-
|POWER
|
|Allows the being to represent itself as a deity. Requires CAN_SPEAK to actually do anything more than settle at a location.

|-
| PREFSTRING
| string
| Sets what other creatures like about this creature. "Urist likes dwarves for their beards." Multiple entries will be chosen from at random

|-
| PROFESSION_NAME
|
*Profession
*singular
*plural
| The generic name for members of this profession, at the creature level. In order to give members of specific castes different names for professions, use CASTE_PROFESSION_NAME instead.
|}

<div align="center">
{{alphabetical TOC}}
</div>

==R==
{| {{prettytable}}
|- bgcolor="#ddd"
! width="20%" | Token
! width="20%" | Arguments
! width="60%" | Description
|-
| RELSIZE
|
*BY_CATEGORY, BY_TYPE, BY_TOKEN
*body category, type, or token
*Relsize
| Specifies a new relative size for a part than what is stated in the body plan. For example, Dwarves have larger livers.

|-
| REMAINS_COLOR
|
|

|-
| REMAINS_ON_VERMIN_BITE_DEATH
|
| Leaves remains when its attack causes it to die? Seems to go with DIE_WHEN_VERMIN_BITE.

|-
| REMAINS_UNDETERMINED
|
|

|-
| REMOVE_MATERIAL
|
*material token
| Removes a material from a creature

|-
| REMOVE_TISSUE
|
*material token
| Removes a tissue from a creature.
|}

<div align="center">
{{alphabetical TOC}}
</div>

==S==
{| {{prettytable}}
|- bgcolor="#ddd"
! width="20%" | Token
! width="20%" | Arguments
! width="60%" | Description
|-
| SAVAGE
|
| Allows creature to show up on (and limits it to) "savage" maps.

|-
| SECRETION
|
*MATERIAL REF (eg LOCAL_CREATURE_MAT
*Material name
*Material State
*location secreted from (by_type, by_category, by_token)
*body part
*tissue layer
| creates a secreted material on given tissue on a given part of the body."

|-
| SELECT_ADDITIONAL_CASTE
|
*caste name
| adds an additional previously defined caste to the selection

|-
| SELECT_CASTE
|
*caste name, or ALL
| selects a previously defined caste

|-
| SELECT_MATERIAL
|
*MATERIAL NAME
| Selects the material. Can be ALL.

|-
| SELECT_TISSUE
|
*tissue token
| Selects a tissue for editing.

|-
| SELECT_TISSUE_LAYER
|
*TISSUE
*BY_CATEGORY, BY_TYPE, BY_TOKEN
*Location - category, type, or token | Selects a tissue at a location
* (optional) FRONT, BACK, LEFT, RIGHT, TOP, BOTTOM, AROUND.
| Selects a tissue layer for descriptor and cosmetic purposes.

|-
| SEMIMEGABEAST
|
| Appears as boss creature in quests. Makes history by rampaging around towns. Possibly inhabits non-mountain caves.

|-
| SET_BP_GROUP
|
*selection criteria BY_TYPE, BY_CATEGORY, BY_TOKEN
*category, type, or token
| selection token"

|-
| SET_LAYER_TISSUE
| ???
| Unknown. Found in string dump. (Might replace selected tissue layer with different tissue??? Needs testing).
Not to be confused with SELECT_TISSUE_LAYER.

|-
| SET_TL_GROUP
|
*TISSUE
*BY_CATEGORY, BY_TYPE, BY_TOKEN
*Location - category, type, or token
*tissue
| begins a selection of tissue layers

|-
| SHEARABLE_TISSUE_LAYER
| ?
| Can be sheared for wool?

|-
| SKILL_LEARN_RATE
| {{L|skill_token}}:percentage
| The rate at which this creature learns this skill.

|-
| SKILL_LEARN_RATES
| percentage
| The rate at which this creature learns all skills.

|-
| SKILL_RATE
| {{L|skill_token}}:percentage:value:value:value
| As SKILL_RATES for individual skills.

|-
| SKILL_RATES
|
*% of improvement points you get
*unused counter rate
*rust counter rate
*demotion counter rate
| Affects skill gain and decay. Lower numbers in the last three slots make decay occur faster ([SKILL_RATES:100:1:1:1] would cause rapid decay). The counter rates may also be replaced with NONE.
Default is [SKILL_RATES:100:8:8:16]. [SLOW_LEARNER] changes the 100 to a 50.

|-
| SKILL_RUST_RATE
| {{L|skill_token}}:value:value:value
| The rate at which this skill decays. Lower values cause the skill to decay faster.

|-
| SKILL_RUST_RATES
| {{L|skill_token}}:value:value:value
| The rate at which all skills decay. Lower values cause the skills to decay faster.

|-
| SLOW_LEARNER
|
| Similar to [CAN_LEARN], but slower; skills are gained at a fraction of the rate. Present in the entries for ogres and giants; can be applied to civ or player races.

|-
| SMALL_REMAINS
|
| If a creature has this token, it'll leave a small corpse that only rots once, and without miasma.

|-
| SOLDIER_ALTTILE
| 'character' or tile number
| If this creature is active in its civilization's military, it will blink between its default tile and this one.

|-
| SPEC_HEAT
| value
| Amount of energy required for the creature to heat up or cool down.

|-
| SPECIALATTACK_INJECT_EXTRACT
|
*material source, eg. LOCAL_CREATURE_MAT, INORGANIC
*MATERIAL eg.POISON,
*MATTERSTATE (ALL_SOLID, LIQUID, GAS)
*min:max
| attack type addition that injects a material into the victim.

|-
| SPECIALATTACK_SUCK_BLOOD
| min:max
| Successful attack draws out an amount of blood randomized between the min and max value.

|-
| SPEECH
| speech file
| Boasting speeches relating to killing this creature. Examples include dwarf.txt and elf.txt in the Speech folder in Data.u

|-
| SPEED
| value
| Sets the creatures' movement and work speed, 1000/[100 + SPEED X] is the resulting effect on creatures movement and work rates from default. See [http://df.magmawiki.com/index.php/Speed/ Speed] for more information.

|-
| SPHERE
|
*sphere name
| Sets what religious spheres the creature is aligned to, for purposes of being worshipped via the [POWER] token. Also affects the layout of hidden fun stuff, and the creature's name.

|-
| SPOUSE_CONVERSION_TARGET
|
| This creature can be converted by a night creature with SPOUSE_CONVERTED.

|-
| SPOUSE_CONVERTER
|
| Enables the creature to convert SPOUSE_CONVERSION_TARGETs into CONVERTED_SPOUSE castes of its species. The creature won't actually actively do this unless it also has NIGHT_CREATURE_HUNTER, however.

|-
| SWIM_SPEED
|
*speed
| How fast the creature swims. Typically 2500 (0.38 times the default speed).

|-
| SWIMS_INNATE
|
| The creature naturally knows how to swim, as opposed to [SWIMS_LEARNED] below. Currently, an AI bug prevents this from being useful on PC races in fortress mode.

|-
| SWIMS_LEARNED
|
| The creature doesn't know how to swim unless it has learned the skill. Requires [CAN_LEARN], obviously.

|-
| SYN_AFFECTED_CLASS
|
| adds a class of creatures to those affected, such as CREATURE_CLASS:GENERAL_POISON

|-
| SYN_AFFECTED_CREATURE
| Creature Name
| adds a specific creature to those affected.

|-
| SYN_CONTACT
|
| syndrome can be contracted on contact.

|-
| SYN_IMMUNE_CREATURE
|
| creates an exception for the creature so that it not affected by the syndrome.

|-
| SYN_INHALED
|
| syndrome can be contracted by inhalation, eg. poison dust.

|-
| SYN_INJECTED
|
| syndrome can be contracted by injection, eg. snake bite.

|-
| SYN_NAME
| text
| defines the name of the syndrome

|-
| SYNDROME
|
| begins definition of a syndrome for poison use
|}

<div align="center">
{{alphabetical TOC}}
</div>

==T==
{| {{prettytable}}
|- bgcolor="#ddd"
! width="20%" | Token
! width="20%" | Arguments
! width="60%" | Description
|-
| TENDONS
|
*selection criteria. Often LOCAL_CREATURE_MAT, although other selection criteria may work too.
*selected tissue
*healing rate
| Defines the material and healing rare of tendons.

|-
| THICKWEB
|
| The creature's webs can catch larger creatures. May imply [AMBUSHPREDATOR].

|-
| TISSUE
| name
| Begins defining a tissue in the creature file.

|-
| TISSUE_LAYER
|
*BY_TYPE, BY_CATEGORY, BY_TOKEN
*TYPE,CATEGORY, or TOKEN
*TISSUE
*LOCATION
| Adds the tissue layer to wherever it is required.
Non-argument Locations can be FRONT, RIGHT, LEFT, TOP, BOTTOM. Argument locations are AROUND and CLEANS, requiring a further body part and a % of coverage/cleansing

|-
| TISSUE_LAYER_OVER
| Presumably:
*BY_TYPE, BY_CATEGORY, BY_TOKEN
*TYPE,CATEGORY, or TOKEN
*TISSUE
*LOCATION
| Presumably a counterpart to TISSUE_LAYER_UNDER (see below). Found in string dump.

|-
| TISSUE_LAYER_UNDER
|
*BY_TYPE, BY_CATEGORY, BY_TOKEN
*TYPE,CATEGORY, or TOKEN
*TISSUE
*LOCATION
| Adds the tissue layer under a given part ex. is Iron Man he has a gaseous poison within him and this tissue (GAS is its name) has the token [TISSUE_LEAKS] and its state is GAS so when you puncture the iron outside and damage this tissue it leaks gas (can have a syndrome by using a previous one in the creature sample.) [TISSUE_LAYER_UNDER:BY_CATEGORY:ALL:{tissue}] {tissue} is what will be under the TISSUE_LAYER here is an example Tissue from Iron Man
[TISSUE:GAS]
[TISSUE_NAME:gas:NP]
[TISSUE_MATERIAL:LOCAL_CREATURE_MAT:GAS]
[TISSUE_MAT_STATE:GAS]
[RELATIVE_THICKNESS:50]
[TISSUE_LEAKS]
[TISSUE_SHAPE:LAYER]

|-
| TISSUE_LAYER_APPEARANCE_MODIFIER
|
*QUALITY
*lowest:lower:low:median:high:higher:highest
| sets the range of qualities, including LENGTH, DENSE, HIGH_POSITION, CURLY, GREASY, WRINKLY

|-
|TISSUE_NAME
| ???
| Unknown. Found in String Dump. Might change name of selected tissue layer(?). Needs testing.

|-
| TISSUE_STYLE_UNIT
|
*tissue
*shaping
| sets tissue to be in a certain shape, mostly used with tissues HAIR, BEARD, MOUSTACHE, SIDEBURNS.

|-
| TL_COLOR_MODIFIER
| COLOR:freq:COLOR:freq etc
| Creates a list of color patterns, giving each a frequency.

|-
| TL_CONNECTS
|
| Presumably gives the CONNECTS attribute to selected layers. Found in String Dump.

|-
| TL_HEALING_RATE
|
*new tissue healing rate number?
| Presumably changes the HEALING_RATE of the selected tissue layers. Found in String Dump.

|-
| TL_MAJOR_ARTERIES
|
| Gives Major Artery attribute to selected layers.

|-
| TL_PAIN_RECEPTORS
|
*new pain receptor number?
| Seems to set new number of pain receptors for selected tissue layers. Found in String Dump.

|-
| TL_RELATIVE_THICKNESS
|
*new relative thickness?
| Seems to set new relative thickness for selected tissue layers. Found in String Dump.

|-
| TL_VASCULAR
|
*new VASCULAR value?
| Seems to set new a VASCULAR value (which modulates bleeding) for selected tissue layers. Found in String Dump.

|-
| TLCM_GENETIC_MODEL
|
| tissue layer color modifier is passed to offspring genetically?

|-
| TLCM_IMPORTANCE
|
*number
| Presumably modifies the importance of the tissue layer color modifier, for description purposes.
HOWEVER using this appears to remove all mention of colour from creature descriptions. It does not appear in any default creatures.

|-
| TLCM_NOUN
|
*name
*SINGULAR or PLURAL
| names the tissue layer color modifier, and determines the noun

|-
| TLCM_TIMING
|
*ROOT
*start change window years:days:end change window years:days
| determines the point in the creature's life where the color change begins

|-
| TRADE_CAPACITY
|
| How much the creature can carry when used by merchants.

|-
| TRAINABLE
|
| Implies both [TRAINABLE_HUNTING] and [TRAINABLE_WAR].

|-
| TRAINABLE_HUNTING
|
| Can be trained as hunting beasts by way of kennels.

|-
| TRAINABLE_WAR
|
| Can be trained as war beasts by way of kennels.

|-
| TRANCES
|
| Allows the creature to go into martial trances.

|-
| TRAPAVOID
|
| The creature is immune to traps. Probably every procedurally generated megabeast has this.

|-
| TRIGGERABLE_GROUP
| min:max
| A large swarm of vermin can be disturbed, usually in Adventure mode.{{verify}}

|-
| TSU_NOUN
|
*noun
*SINGULAR or PLURAL
| Noun for the TISSUE_STYLE_UNIT, used in the description of the tissue layer's style.
|}

<div align="center">
{{alphabetical TOC}}
</div>

==U==
{| {{prettytable}}
|- bgcolor="#ddd"
! width="20%" | Token
! width="20%" | Arguments
! width="60%" | Description

|-
| UBIQUITOUS
|
| Creature will occur in every region with the correct biome. Does not apply to evil/good tags.

|-
| UNDERGROUND_DEPTH
|
*mindepth
*maxdepth
| Depth the creature appears underground. Numbers can be from 1 to 5. Only magma creatures use 4 or 5 in the default raws. A single argument may be used instead of min and max. Dwarven civilizations will only export (via the embark screen or caravans) things that available at depth 1.

|-
| UNDERSWIM
|
| Creature swims under the water and can't be seen.{{verify}}

|-
| UNIQUE_DEMON
|
| Typically found on genned [[demon]]s; sets the creature as capable of "emerging from the underworld" and taking over during worldgen.

|-
| USE_CASTE
|
*caste token
|

|-
| USE_MATERIAL
|
*new material token
*old material id
| Uses a local creature mat to define a new material?{{verify}}

|-
| USE_MATERIAL_TEMPLATE
|
*new material token
*material template
| Loads a material, and gives it a shortname for later reference

|-
| USE_TISSUE
|
*new tissue token
*old tissue id
| Uses a local creature mat to define a new material?{{verify}}

|-
| USE_TISSUE_TEMPLATE
|
*new tissue token
*tissue template
| Loads a tissue template listed in OBJECT:TISSUE_TEMPLATE files, such as tissue_template_default.txt.

|-
| UTTERANCES
|
| Changes the language of the creature into an unintelligible mess.
|}

<div align="center">
{{alphabetical TOC}}
</div>

==V==
{| {{prettytable}}
|- bgcolor="#ddd"
! width="20%" | Token
! width="20%" | Arguments
! width="60%" | Description
|-
| VEGETATION
|
| unknown

|-
| VIEWRANGE
| value
| Value should determine how close you have to get to a critter before it attacks (or prevents adv mode travel etc.) Default is 20.

|-
| VERMIN_BITE
|
*amount
*verb (bitten, stung)
*LOCAL_CREATURE_MAT
*MATERIAL
| vermin bites, and injects something.

|-
| VERMIN_EATER
|
| Vermin can nibble food?{{verify}}

|-
| VERMIN_FISH
|
| Acts like a fish

|-
| VERMIN_GROUNDER
|
| The creature can be picked up if you stand over it. (Requires confirmation)
'I think this is a habitat flag like VERMIN_SOIL, VERMIN_CHASM, etc. It seems to appear on creatures that don't otherwise have one. – Peristarkawan 17:27, 24 May 2007 (EDT)'

|-
| VERMIN_HATEABLE
|
| Some dwarves will hate the creature and get unhappy thoughts when around it.

|-
| VERMIN_MICRO
|
| This makes the creature move in a swarm of creatures of the same race as it. I.E. Swarm of flies, swarm of ants, etc.

|-
| VERMIN_NOFISH
|
| The creature cannot be caught by fishing.

|-
| VERMIN_NOROAM
|
| The creature will not be observed randomly roaming about the map.

|-
| VERMIN_NOTRAP
|
| The creature cannot be caught by trappers or animal traps. However, this may not work in all cases, as both dragonflies and fairies can be caught by trappers. This is possibly overridden by the VERMIN_GROUNDER token, allowing trappers set to Catch a Live Land Animal to pick up and thus trap the animal. (speculation by Flippantelf 04:45, 15 June 2009 (UTC))

|-
| VERMIN_ROTTER
|
| Present on flies, knuckle worms, acorn flies, and blood gnats. Probably means either the creature is attracted to rot, the creature speeds rotting, or both.

|-
| VERMIN_SOIL
|
| The creature randomly appears near dirt or mud.

|-
| VERMIN_SOIL_COLONY
|
| The vermin will appear in a single tile cluster of many vermin, such as a colony of ants.

|-
| VERMINHUNTER
|
| A creature with this tag will hunt down vermin and kill them. Sometimes they will eat the vermin, but most of the time they will bring it to their owner. This tag also makes impossible to assign an owner to the animal. The animal chooses it's own owner instead (like a cat). If assigned to a playable race, members of that race will ONLY be able to eat vermin.

|-
| VESPERTINE
|
| Sets if the creature is active in evening.
|}

<div align="center">
{{alphabetical TOC}}
</div>

==W==
{| {{prettytable}}
|- bgcolor="#ddd"
! width="20%" | Token
! width="20%" | Arguments
! width="60%" | Description
|-
| WAGON_PULLER
|
| Allows the creature to pull caravan wagons.

|-
| WEBBER
|
*LOCAL_CREATURE_MAT
*MATERIAL (eg SILK)
| allows the creature to web, and defines what the webs are made of.

|-
| WEBIMMUNE
|
| The creature will not get caught in webs.
|}

{{Category|Modding}}
{{Category|Tokens}}

v0.31:Creature token

2011-02-22T03:53:19Z

Bohandas: Added TL_CONNECTS and TL_HEALING_RATE tags and added minor clarifications to tags added in previous edit.

{{av}}{{Quality|Exceptional}}

Tentative at best in some cases.

__NOTOC__

<div align="center">
{{alphabetical TOC}}
</div>

==A==
{| {{prettytable}}
|- bgcolor="#ddd"
! width="20%" | Token
! width="20%" | Arguments
! width="60%" | Description
|-
| ALCOHOL_DEPENDENT
|
| Creature needs alcohol to get through the working day.

|-
| ALL_ACTIVE
|
| Sets if the creature is active in day, night, and twilight. Seems to be a separate value from DIURNAL/NOCTURNAL/CREPUSCULAR, rather than implying them.

|-
| ALTTILE
|
| If set, the creature will blink between its [TILE] and its [ALTTILE].

|-
| AMBUSHPREDATOR
|
| Makes the creature start out hidden. Used by {{L|giant cave spider}}s. May make {{L|web}}s hidden too.

|-
| AMPHIBIOUS
|
| Allows a creature to breathe with or without {{L| water}}. Implies [AQUATIC].

|-
| APP_MOD_DESC_RANGE
| ?
| ?

|-
| APP_MOD_GENETIC_MODEL
|
|

|-
| APP_MOD_IMPORTANCE
|
*number
| Determines how important the appearance modifier is, for determining whether it shows up in the creature description.{{verify}}

|-
| APP_MOD_NOUN
|
*noun
*SINGULAR or PLURAL
| creates a noun for the appearance and whether it is singular or plural

|-
| APP_MOD_RATE
|
*Rate (integer)
*Scale (DAILY, YEARLY)
*min:max of growth
*start year:start day
*end year:end day
| setting the growth rate of the modifier. The last two tokens can be replaced by NO_END to have growth continue indefinitely.

|-
| APPLY_CREATURE_VARIATION
|
*CV TEMPLATE NAME
| Loads the Creature Variation Template specified.

|-
| APPLY_CURRENT_CREATURE_VARIATION
|
| Applies loaded Creature Variation

|-
| AQUATIC
|
| Allows a creature to breathe underwater, but causes it to "drown" out of {{L| water}}.

|-
| ARENA_RESTRICTED
|
| Does not appear in arena mode list

|-
| ARTIFICIAL_HIVEABLE
|
| Can be kept in artificial hives by beekeepers.

|-
| ATTACK
|
*token
*bodypart
*selection criteria
*location
| Defines the attack name, and the body part used.
'''Example:'''<br />
[ATTACK:GORE:BODYPART:BY_CATEGORY:HORN]<br />
''GORE'' : name of the attack<br />
''BODYPART:BY_CATEGORY:HORN'' : the horn is used to attack (presuming the creature has one)

|-
| ATTACK_CONTACT_PERC
|
*% value
| amount of available tissue used in attack

|-
| ATTACK_FLAG_CANLATCH
|
| Enables an attacker to occasionally latch on with the bodypart used by an attack when an attack with this flag in it's definition is made.

|-
| ATTACK_FLAG_EDGE
|
| attack type

|-
| ATTACK_FLAG_WITH
|
| In adventure mode, displays the name of the body part used by an attack when announcing the attack.

|-
| ATTACK_PENETRATION_PERC
|
*% value
| probably amount of material that makes contact when penetration is done

|-
| ATTACK_PRIORITY
|
*MAIN or SECOND
| use of the attack in combat. Secondary attacks are only used if main attacks are impossible.

|-
| ATTACK_SKILL
|
*skill used ({{L|Skill tokens}})
| defines the attack skill used

|-
| ATTACK_TRIGGER
| pop:exported wealth:created wealth{{verify}}
| stages when a megabeast will attack a site

|-
| ATTACK_VERB
| 2nd person:3rd person
| descriptive text for the attack

|-
| ATTACK_VELOCITY_MODIFIER
| number
| Modifies the attack velocity. Believed to be percent based (so 100 would be "normal"). May be on same scale as weapon velocity (where 1000 is "normal").

|}

<div align="center">
{{alphabetical TOC}}
</div>

==B==
{| {{prettytable}}
|- bgcolor="#ddd"
! width="20%" | Token
! width="20%" | Arguments
! width="60%" | Description
|-
| BABY
| integer
| age at which creature is considered a child. Default is zero. One can think of this as the duration of the baby stage.

|-
| BABYNAME
| singular:plural
| name at caste level

|-
| BEACH_FREQUENCY
|
| {{L|Whale}}s and {{L|Sea nettle jellyfish|jellyfish}} have this. Controls the beaching frequency of the creature.

|-
| BENIGN
|
| Determines whether creature can show up on "tame" maps (includes {{L|elephants}}), which will generally avoid dwarves, although they may chase and/or attack them if they get too close).

|-
| BIOME
|
* biome token
| Select a {{L|Biome}} the creature may appear in.

|-
| BLOOD, PUS, OTHER MATERIAL state definition
|
*selection criteria. Often LOCAL_CREATURE_MAT, although other selection criteria may work too.
*selected material
*matter state (LIQUID, GAS, ALL_SOLID)
| Controls bleeding behaviour

|-
| BODY
| body parts
| Draws body parts from OBJECT:BODY files (such as body_default.txt)
'''Example:'''<br />
[BODY:BODY_WITH_HEAD_FLAG:HEART:GUTS:BRAIN:MOUTH] <br />
This is the body from a {{L|Purring maggot}}. It creates a body with head, a heart, some guts, a brain, and a mouth. Thats all a maggot needs.

|-
| BODY_APPEARANCE_MODIFIER
|
*ATTRIBUTE
*lowest:lower:low:median:high:higher:highest
| These body modifiers give individual creatures different characteristics. In the case of HEIGHT, BROADNESS and LENGTH, the modifier is also a percentage change to the BODY_SIZE of the individual creature. The seven numbers afterward give a distribution of ranges. Each interval has an equal chance of occurring.
'''Example:'''<br />
[BODY_APPEARANCE_MODIFIER:LENGTH:90:95:98:100:102:105:110] <br />
''HEIGHT'' : marks the height to be changed <br />
''90:95:98:100:102:105:110'' : sets the range from the shortest (90% of the average height) to the tallest (110% of the average height) creature variation.

|-
| BODY_DETAIL_PLAN
| PlanName, PlanName:type:type:type:etc
| loads a plan listed OBJECT:BODY_DETAIL_PLAN files, such as b_detail_plan_default.txt. Mass applies USE_MATERIAL_TEMPLATE, mass alters RELSIZE, alters body part positions, and will allow tissue layers to be defined. Tissue layers are defined in order of skin to bone here.
'''Example:'''<br />
[BODY_DETAIL_PLAN:VERTEBRATE_TISSUE_LAYERS:SKIN:FAT:MUSCLE:BONE:CARTILAGE] <br />
This creates the detailed body of a {{L|fox}}, the skin, fat, muscle, bones and cartilage out of the vertebrate tissues.<br />
A {{L|Purring maggot|maggot}} would only need:<br />
''[BODY_DETAIL_PLAN:EXOSKELETON_TISSUE_LAYERS:SKIN:FAT:MUSCLE]''

|-
| BODY_SIZE
| years:days:size
| sets up size at a given time. Size is roughly equal to the creature's average weight in grams.
'''Example:'''<br />
[BODY_SIZE:0:0:10000]<br />
[BODY_SIZE:1:168:50000]<br />
[BODY_SIZE:12:0:220000]<br />
This describes the size of a {{L|minotaur}}. His birth size would be 10000 (~10 kg). With 1 year and 168 days he would be 50000 tall (~50 kg). As an adult (with 12 years) he would weight roughly 220 kg

|-
| BODYGLOSS
| gloss
| Substitutes body part text with replacement text. Draws gloss information from OBJECT:BODY files (such as body_default.txt)

|-
| BONECARN
|
| Creature 'eats' bones. Eating bones makes their happiness go up, but can cause death (suffocation){{verify}}. Implies CARNIVORE.

|-
| BP_APPEARANCE_MODIFIER
|
*QUALITY
*lowest:lower:low:median:high:higher:highest
| sets up the breadth of possibilities for appearance qualities for a selected BP group. EG. Eyes (CLOSE_SET, DEEP_SET, ROUND_VS_NARROW, LARGE_IRIS),Lips (THICKNESS), Nose (BROADNESS, LENGTH, UPTURNED, CONVEX), Ear (SPLAYED_OUT, HANGING_LOBES, BROADNESS, HEIGHT), Tooth (GAPS), Skull (HIGH_CHEEKBONES, BROAD_CHIN, JUTTING CHIN, SQUARE_CHIN), Neck (DEEP_VOICE, RASPY_VOICE), Head (BROADNESS, HEIGHT)

|-
| BUILDINGDESTROYER
| 1 or 2
| Allows a creature to destroy furniture and buildings. Value [1] targets mostly doors, hatches, furniture and the like. Value [2] targets anything not made with the b + C commands.
|}

<div align="center">
{{alphabetical TOC}}
</div>

==C==
{| {{prettytable}}
|- bgcolor="#ddd"
! width="20%" | Token
! width="20%" | Arguments
! width="60%" | Description

|-
| CAN_LEARN
|
| The creature gets skills and professions. Note that this token makes the creature unable to be butchered by an adventurer so it is not recommended for uncivilized monsters. Adventurers lacking this token can allocate but not increase attributes and skills. skills allocated will disappear on start.

|-
| CAN_SPEAK
|
| Can talk. Note that it is not necessary for a creature to gain social skills.

|-
| CANNOT_UNDEAD
|
| Cannot be turned into a zombie or skeletal undead

|-
| CANOPENDOORS
|
| Allows the creature to open doors.

|-
| CARNIVORE
|
| Creature ''only'' eats meat

|-
| CASTE
|
*name
| defines a caste

|-
| CASTE_ALTTILE
|
*tile number or "letter"
| Caste-specific alternate tile. Expects CASTE_TILE

|-
| CASTE_COLOR
|
*fg
*bg
*brightness
| Creature tile color of the caste.

|-
| CASTE_GLOWCOLOR
|
*fg
*bg
*brightness
| GLOWTILE color of the caste.

|-
| CASTE_GLOWTILE
|
*tile value or "letter"
| Caste-specific glowtile

|-
| CASTE_NAME
| singular:plural:adjective
| The name of the caste of the creature in the game.

|-
| CASTE_PROFESSION_NAME
|
*Profession
*singular
*plural
| alters the name of the given profession, caste-specific

|-
| CASTE_SOLDIER_ALTTILE
| 'character' or tile number
| Creatures of this caste active in their civilization's military will blink between their default tile and this one.

|-
| CASTE_SOLDIER_TILE
| 'character' or tile number
| Creatures of this caste active in their civilization's military will use this tile instead.

|-
| CASTE_SPEECH
| speech file?
| Possibly a caste-specific instance of the SPEECH token

|-
| CASTE_TILE
|
* tile number or "letter"
| Caste-specific creature tile.

|-
| CAVE_ADAPT
|
| Gives the creature a bonus in caves. Also causes [[Cave adaptation]].

|-
| CE_X
|
*SEV:<value> (severity, higher is worse)
*PROB:<value(1-100)> (probability)
*RESISTABLE (optional) allows resistance
*SIZE_DILUTES (optional) lessens effect based on size
Place effected:
*LOCALIZED (optional)
*VASCULAR_ONLY (optional)
*MUSCULAR_ONLY (optional)
*BP:(select BY_CATEGORY, BY_TYPE, or BY_TOKEN):category, type or token:tissues affected (specific or ALL) (optional)
Timeline:
*Start:effect start time
*Peak:effect peak time
*End:effect end time
| Specifies the way that a syndrome affects a creature -- more detail can be found on the [[Syndrome#Creature effect tokens|Syndromes page]]

|-
| CHANGE_BODY_SIZE_PERC
|
|

|-
| CHILD
| integer
| age at which creature is considered an adult. One can think of this as the duration of the child stage. Without this token, a creature will not reproduce in Fortress mode.

|-
| CHILD_BODYPART_GROUP
|
*master selection, BY_CATEGORY, BY_TYPE, BY_TOKEN.
*master location
*specific selection, BY_CATEGORY, BY_TYPE, BY_TOKEN.
*specific location
| selects all parts of a group to be used.

|-
| CHILDNAME
| singular:plural
| name at caste level

|-
| CLUSTER_NUMBER
|
*min
*max
| The minimum/maximum numbers of how many creatures per spawned cluster. Certain vermin fish use this token in combination with temperate ocean and river biome tokens to perform seasonal migrations.
e.g. [CLUSTER_NUMBER:1:3]

|-
|CLUTCH_SIZE
|
*min
*max
|Number of eggs laid in one sitting.

|-
| COLDDAM_POINT
| value
| The minimum temperature limit before the currently selected material will start receiving damage from freezing. Used mostly in material templates.

|-
| COLONY_EXTERNAL
|
| Caste hovers around colony.

|-
| COLOR
| foreground:background:brightness
| Color of the creature's tile.

|-
| COMMON_DOMESTIC
|
| Allows the creature to be brought with immigrants and when creating a new fortress, as long as the creature also includes at least one of the following tokens: PET, PACK_ANIMAL, WAGON_PULLER, MOUNT. In addition, the creature must be NATURAL rather than FANCIFUL

|-
| CONVERTED_SPOUSE
|
| Found only at caste level. Creatures of this caste's species with the SPOUSE_CONVERTER and NIGHT_CREATURE_HUNTER tokens will kidnap SPOUSE_CONVERSION_TARGETs of an appropriate sex and convert them into castes with CONVERTED_SPOUSE.

|-
| COOKABLE_LIVE
|
| Set this to allow the creature to be cooked in meals without first being butchered / fishcleaned.

|-
| COPY_TAGS_FROM
|
*CREATURE NAME
| Copies tags from another specified creature.

|-
| CREATURE
| name
| begins defining a new creature with the specified name.

|-
| CREATURE_CLASS
|
*classname
| Creature class. Can be anything, but only existing use is GENERAL_POISON. Appears to only be used for Syndromes. Supposedly can also be used for entity positions.

|-
| CREATURE_SOLDIER_TILE
| 'character' or tile number
| Creatures active in their civilization's military will use this tile instead.

|-
| CREATURE_TILE
| 'character' or tile number
| The symbol of the creature in ASCII mode.

|-
| CREPUSCULAR
|
| Sets if the creature is active at twilight. This tag functions as a combination of the two tags VESPERTINE and MATUTINAL.

|-
| CURIOUSBEAST_EATER
|
| Allows a creature to steal and eat edible items from a site.

|-
| CURIOUSBEAST_GUZZLER
|
| Allows a creature to (very quickly) drink your alcohol. Or spill the barrel to the ground. Also affects undead versions of the creature.

|-
| CURIOUSBEAST_ITEM
|
| Allows a creature to steal things (apparently the highest value it can find). Semimegabeast thievery is in Legends mode. Lightweight creatures can probably steal heavy items.

|-
| CV_ADD_TAG
|
*TAG NAME
| Adds a tag. Used in conjunction with creature variation templates.

|-
| CV_REMOVE_TAG
|
*TAG NAME
| Removes a tag. Used in conjunction with creature variation templates.
|}

<div align="center">
{{alphabetical TOC}}
</div>

==D==
{| {{prettytable}}
|- bgcolor="#ddd"
! width="20%" | Token
! width="20%" | Arguments
! width="60%" | Description

|-
| DEMON
|
| Typically found on genned [[demon]]s; sets the creature as a potential spawn for [[Hidden Fun Stuff]]

|-
| DESCRIPTION
| text
| A brief description of the creature type.

|-
| DIE_WHEN_VERMIN_BITE
|
| Dies upon attacking. Used for bee stings.

|-
| DIFFICULTY
| integer
| Toady: "Difficulty determines how deep it places them in adventure mode/reclaim caves, and the chance that they are wounded the first few river attacks." Also increases experience gain during adventure mode.

|-
| DIURNAL
|
| Sets if the creature is active in day.

|-
| DOES_NOT_EXIST
|
| Creature does not actually exist; used for fanciful creatures.

|-
| DRAGONFIREBREATH
|
| Creature breathes fire in a cone.
|}

<div align="center">
{{alphabetical TOC}}
</div>

==E==
{| {{prettytable}}
|- bgcolor="#ddd"
! width="20%" | Token
! width="20%" | Arguments
! width="60%" | Description

|-
| EGG_MATERIAL
|
*LOCAL_CREATURE_MAT
*EGGSHELL/EGG_WHITE/EGG_YOLK
*state (solid, liquid, or gas)
| Egg material. Eggs will be made out of eggshell. Edibility is determined by tags on whites or yolk, but they otherwise do not exist.

|-
| EGG_SIZE
|
*size
| Size of creature's egg?

|-
| EQUIPMENT_WAGON
|
| Makes the creature into a large 3x3 creature responsible for carrying trade goods, pulled by two [WAGON_PULLER]s and driven by a merchant.

|-
| EQUIPS
|
| Allows the creature to wear or wield items.

|-
| EVIL
|
| Determines whether creature can show up on "evil" maps

|-
| EXTRAVISION
|
| Creature can see regardless of whether it has working eyes.
|}

<div align="center">
{{alphabetical TOC}}
</div>

==F==
{| {{prettytable}}
|- bgcolor="#ddd"
! width="20%" | Token
! width="20%" | Arguments
! width="60%" | Description
|-
| FANCIFUL
|
| Makes every civilization know about the creature. The creature won't occur in regular material preference lists. The tag also adds some art value modifiers. Used for things like dragons and other legendary creatures.

|-
| FEATURE_ATTACK_GROUP
|
| Found on subterranean animalmen.

|-
| FEMALE
|
| Inside a female caste, sets femaleness. Outside of a caste, sets all individuals female unless overridden by caste.

|-
| FIREBREATH
|
| The creature breathes fire projectiles (as opposed to DRAGONFIREBREATH, which is in a cone).

|-
| FIREIMMUNE
|
| As of version v0.28.181.40d, the FIREIMMUNE token had no effect on a creature's resistance to flame or heat. However, it did affect ability to swim in magma in adventure mode, as well as display of "You are caught in a pool of magma!" warning messages. It is unknown if these effects persist in DF 2010.

|-
| FIREIMMUNE_SUPER
|
| The creature is immune to DRAGONFIREBREATH. Implies FIREIMMUNE.

|-
| FISHITEM
|
| Needs to be cleaned at a fishery

|-
| FIXED_TEMP
| temperature
| The natural heat generated by the creature.

|-
| FLEEQUICK
|
| Determines how soon a creature flees in a losing battle.

|-
| FLIER
|
| Allows a creature to fly. Fortress Mode pathfinding only partially incorporates pathfinding - flying dwarves need a land path to exist between them and an area in order to access it, but as long as one such path exists, they do not need to use it, instead being able to fly over intervening obstacles.

|-
| FREQUENCY
|
*number, max 100
| Determines the time between creature spawns in Fortress Mode. Higher is more occurrences per time unit. Creatures without a frequency statement default to 50. Almost all others have either [FREQUENCY:5] or [FREQUENCY:100]. Not to be confused with POP_RATIO
|}

<div align="center">
{{alphabetical TOC}}
</div>

==G==
{| {{prettytable}}
|- bgcolor="#ddd"
! width="20%" | Token
! width="20%" | Arguments
! width="60%" | Description
|-
| GENERAL_BABY_NAME
| singular:plural
| name at creature level

|-
| GENERAL_CHILD_NAME
| singular:plural
| name at creature level

|-
| GENERATED
|
| Found on procedurally generated creatures like [[Forgotten beast]]s, (biome name) titans and [[Demon]]s.

|-
| GETS_INFECTIONS_FROM_ROT
|
| creature can be infected by rot

|-
| GETS_WOUND_INFECTIONS
|
| creature can get infections from wounds

|-
| GLOWCOLOR
|
*foreground
*background
*brightness
| The colour of the GLOWTILE of the creature.

|-
| GLOWTILE
| ascii character
| If present, the being glows in the dark (generally used for Adventure Mode). The tile is what replaces the being's current tile when it is obscured from your sight by darkness. The default setting for kobolds (a yellow quotation mark) provides a nice "glowing eyes" effect. The game is also hardcoded to automatically convert quotation mark GLOWTILES into apostrophes if the creature has lost one eye. This works at the generic creature level - for caste-specific glow tiles, use CASTE_GLOWTILE instead.

|-
| GNAWER
| verb (gnawed)
| The creature chews on food barrels and bags.

|-
| GO_TO_END
|
| uncertain use, definitely refers to Creature Variants template

|-
| GO_TO_START
|
| uncertain use, definitely refers to Creature Variants template

|-
| GOOD
|
| Determines whether creature can show up on "good" areas. Eg. unicorn.

|-
| GRASSTRAMPLE
| value
| Determines the percentage chance of trampling and killing grass when a creature steps on it. Set [GRASSTRAMPLE:0] to make grass never trampled by the creature.

|-
| GRAVITATE_BODY_SIZE
|
| Creature Variants template command, alter body size.

|-
| GRAZER
|
*number
| Animals is a grazer. The higher the number, the less grass it needs.
|}

<div align="center">
{{alphabetical TOC}}
</div>

==H==
{| {{prettytable}}
|- bgcolor="#ddd"
! width="20%" | Token
! width="20%" | Arguments
! width="60%" | Description
|-
| HABIT
| type:probability
| Defines certain behaviors for the creature. The habit types are COLLECT_TROPHIES, COOK_PEOPLE, COOK_VERMIN, GRIND_VERMIN, COOK_BLOOD, GRIND_BONE_MEAL, EAT_BONE_PORRIDGE, USE_ANY_MELEE_WEAPON, and COLLECT_WEALTH. These may require the creature to have a lair to work properly.

|-
| HABIT_NUM
| number or TEST_ALL
| Unknown. All lists of HABITs are preceded by [HABIT_NUM:TEST_ALL]

|-
| HAS_NERVES
|
| This makes the creature susceptible to severed motor and sensory nerves when muscles are torn in limb, grasp and stance parts. Some butchering yields nervous tissue.

|-
| HEATDAM_POINT
| value
| The maximum temperature limit before the currently selected material will start receiving damage from heat. Used mostly in material templates.

|-
| HIVE_PRODUCT
|
*number
*time
*item tokens
| What product is harvested from beekeeping.

|-
| HOMEOTHERM
|
| Default 'NONE'. The creature's normal body [[DF2010:Temperature |temperature]]
|}

<div align="center">
{{alphabetical TOC}}
</div>

==I==
{| {{prettytable}}
|- bgcolor="#ddd"
! width="20%" | Token
! width="20%" | Arguments
! width="60%" | Description
|-
| IF_EXISTS_SET_BOILING_POINT
| value
| The temperature at which the creature boils into gases.

|-
| IF_EXISTS_SET_MELTING_POINT
| value
| The temperature at which the creature will melt into goo.

|-
| IGNITE_POINT
| value
| The temperature at which the creature will burst into flames.

|-
| IMMOBILE_LAND
|
| The creature is immobile while on land. Only works on AQUATIC creatures which can't breath on land.

|-
| IMMOLATE
|
| Will ignite, and potentially completely destroy, items the creature is standing on. Keep booze away from critters with this tag.

|-
| INSULATION
| value
| increases the insulation of a selected material (usually hair, feathers or skin)

|-
| INTELLIGENT
|
| Implies CAN_SPEAK and CAN_LEARN. CAN_LEARN probably means the creature gets skills and professions. Not recommended for uncivilized monsters.

|-
| ITEMCORPSE
|
* [[Item token]]
* subtype
NO_SUBTYPE
* matgloss token
* NO_RACEGLOSS
USE_RACEGLOSS USE_SHARPSTONE
| Determines if the creature leaves behind a non-standard corpse (i.e. wood, statue, bars, ash from ghost etc). The first parameter determines the item type; the second parameter is the subtype indicated in the raw file (such as WEAPON_WHIP); the third indicates the material type if the item type takes a specific material (e.g. ""IRON"" if the corpse type is ""STATUE""). USE_RACEGLOSS applies if the creature has a material glossary assigned by the ""HAS_RACEGLOSS:"" flag and will select necessary adjectives and material from that glossary.
As of 31_01, RACEGLOSS may no longer be in the game.{{verify}}

|-
| ITEMCORPSE_QUALITY
|
| The quality of an item-type corpse left behind; 5 is masterpiece-level.
|}

<div align="center">
{{alphabetical TOC}}
</div>

==L==
{| {{prettytable}}
|- bgcolor="#ddd"
! width="20%" | Token
! width="20%" | Arguments
! width="60%" | Description
|-
| LAIR
| type:probability
| Found on megabeasts, semimegabeasts, and night creatues. The creature will seek out sites of this type and take them as lairs. The lair types are SIMPLE_BURROW, SIMPLE_MOUND, SHRINE, and LABYRINTH.

|-
| LAIR_CHARACTERISTIC
| characteristic:probability
| Defines certain features of the creature's lair. The only known valid characteristic is HAS_DOORS.

|-
| LAIR_HUNTER
|
| This creature will actively hunt adventurers in its lair.

|-
| LAIR_HUNTER_SPEECH
| speech file
| What this creature says while hunting adventurers in its lair.

|-
| LARGE_PREDATOR
|
| Will attack things that are smaller than it (like dwarves). Only one group of "large predators" will appear on any given map (possibly two groups on "savage" maps). In adventure mode, large predators will try to ambush and attack you (and your party will attack them back). Also, they can be mentioned in the intro paragraph when starting a fortress e.g. "ere the wolves get hungry."

|-
| LARGE_ROAMING
|
| In Fortress Mode, spawns outdoors and is not a vermin creature.

|-
| LAYS_EGGS
|
| Creature lays eggs instead of giving birth to live young.

|-
| LAYS_UNUSUAL_EGGS
| Item tokens
| Creature lays a particular item instead of regular eggs. As of v0.31.19, this tag only makes the game crash.

|-
| LIGAMENTS
|
*selection criteria. Often LOCAL_CREATURE_MAT, although other selection criteria may work too.
*selected material. Almost always SINEW of the creature's materials.
*healing rate
| defines the material and healing rate of ligaments.

|-
| LIGHT_GEN
|
| The creature will generate light, such as in adventurer mode at night.

|-
| LIKES_FIGHTING
|
| The creature will attack enemies rather than flee from them. This tag has the same effect on player-controlled creatures - included modded dwarves.

|-
| LISP
|
| Creature multiplies 'S' when talking. Ex: "My name isss Recisssiz."

|-
| LITTERSIZE
|
* minumum
* maximum
| Determines the random chance of how many creatures are generated when giving birth. [LITTERSIZE:1:2]

|-
| LOCKPICKER
|
| Lets a creature open doors that are set to forbidden in Fortress Mode.

|-
| LOOSE_CLUSTERS
|
| The creatures will scatter if they have this tag, or form tight packs if they don't.
|}

<div align="center">
{{alphabetical TOC}}
</div>

==M==
{| {{prettytable}}
|- bgcolor="#ddd"
! width="20%" | Token
! width="20%" | Arguments
! width="60%" | Description

|-
| MAGMA_VISION
|
| Creature's able to see while covered in magma.

|-
| MALE
|
| all male

|-
| MANNERISM_??
|
*occassionally body part
| Adds a possible mannerism to the creature's profile.
Refer to {{L|Creature Token Mannerisms|Mannerisms}}

|-
| MATERIAL
|
*material id
| Begins defining a new material.{{verify}}

|-
| MATERIAL_BREATH_ATTACK
|
*MATERIAL TYPE (TISSUE, INORGANIC)
*MATERIAL NAME
*MATERIAL STATE (TRAILING_DUST_FLOW, TRAILING_VAPOR_FLOW, TRAILING_GAS_FLOW, SOLID_GLOB, LIQUID_GLOB, UNDIRECTED_GAS, UNDIRECTED_VAPOR, UNDIRECTED_DUST)
| Creates an attack referencing a material, using a given type of breath attack.

|-
| MAXAGE
| min:max
| range of time in which death from old age may occur

|-
| MEANDERER
|
| Gives a creature random movement.

|-
| MEGABEAST
|
| Appears on fortress territory in Fortress Mode occasionally. Implies SEMIMEGABEAST. Also can be worshipped

|-
|MENT_ATT_CAP_PERC
|
*ATTRIBUTE Token
*Cap %
|Default is 200. This means you can increase your attribute to 200% of its starting value (or the average value + your starting value if that is higher).

|-
| MENT_ATT_RANGE
|
*ATTRIBUTE
*lowest:lower:low:median:high:higher:highest | sets up a mental attribute's range of values. Max of 5000.

|-
| MENT_ATT_RATES
|
*ATTRIBUTE Token
*cost to improve
*unused counter rate
*rust counter rate
*demotion counter rate
| Attribute gain/decay rates. Defaults for are 500:2:3:2, except for RECUPERATION and DISEASE_RESISTANCE that don't have change rates. The last three slots may be replaced by NONE.

|-
| MILKABLE
|
*LOCAL_CREATURE_MAT:MILK:amount
| Allows the creature to be milked.

|-
| MISCHIEVIOUS
|
| Will pull any levers it comes across. Also makes creature spawn invisible and with several ranks in Ambusher. "They go on little missions to mess with various fortress buildings, not just levers."

|-
| MOUNT
|
| Creature may be used as a mount

|-
| MOUNT_EXOTIC
|
| You need the Dungeon master noble to mount the creature.

|-
| MULTIPLE_LITTER_RARE
|
| Makes litters with more than one offspring rare.

|-
| MULTIPLY_VALUE
|
*Multiplier
| multiplies value of materials

|-
| MUNDANE
|
| Marks if the creature is an actual real-life creature. Only used for age-names at present.
|}

<div align="center">
{{alphabetical TOC}}
</div>

==N==
{| {{prettytable}}
|- bgcolor="#ddd"
! width="20%" | Token
! width="20%" | Arguments
! width="60%" | Description
|-
| NAME
| singular:plural:adjective
| The generic name for any creature of this type - will be used when distinctions between caste are unimportant. For names for specific castes, use CASTE_NAME instead.

|-
| NATURAL
|
| Animal is considered to be natural.

|-
| NATURAL_SKILL
| skill:value
| The creature possesses this skill at this level inherently. It begins with this skill at this level, and the skill may never rust below this level.

|-
| NIGHT_CREATURE_BOGEYMAN
|
| Found on bogeymen. Presumably makes the creature attack the player at night in hordes like bogeymen do.

|-
| NIGHT_CREATURE_HUNTER
|
| If this creature has SPOUSE_CONVERTER, it will actively attempt to seek out potential conversion targets, abduct them, and convert them. Night creatures will seek out one SPOUSE_CONVERSION_TARGET of the opposite sex, convert them, and then have children with them. NIGHT_CREATURE_HUNTERs without SPOUSE_CONVERTER will not be placed.

|-
| NO_AUTUMN
|
| does not appear this season.

|-
| NO_DIZZINESS
|
| Creature cannot become dizzy

|-
| NO_DRINK
|
| Creature does not need to drink.

|-
| NO_EAT
|
| Creature does not need to eat.

|-
| NO_FEVERS
|
| Creature cannot suffer fevers

|-
| NO_SLEEP
|
| Creature does not need to sleep.

|-
| NO_SPRING
|
| does not appear this season.

|-
| NO_SUMMER
|
| does not appear this season.

|-
| NO_THOUGHT_CENTER_FOR_MOVEMENT
|
| Probably shorthand for movement being unaffected by damage in general.

|-
| NO_WINTER
|
| does not appear this season.

|-
| NOBONES
|
| Creature has no bones.

|-
| NOBREATHE
|
| Creature doesn't need to breathe or have [BREATHE] parts in body. Cannot drown or be strangled.

|-
| NOCTURNAL
|
| Sets if the creature is active in night.

|-
| NOEMOTION
|
| The creature has no emotions, and does not rage.

|-
| NOEXERT
|
| Creature can't become tired or over-exerted.

|-
| NOFEAR
|
| Creature doesn't feel fear and will never run away from battle.

|-
| NOMEAT
|
| Creature will not drop meat on butcher.

|-
| NONAUSEA
|
| Creature can't vomit.

|-
| NOPAIN
|
| Creature doesn't feel pain.

|-
| NOSKIN
|
| Creature will not drop skin on butcher.

|-
| NOSKULL
|
| Creature will not drop skull on butcher, rot, or decay of severed head.

|-
| NOSMELLYROT
|
| Does not produce miasma when rotting

|-
| NOSTUCKINS
|
| Weapons can't be stuck in creature.

|-
| NOSTUN
|
| Creature can't be stunned. Evidence suggests creatures with this tag never wake up from sleep in Fortress Mode.

|-
| NOT_BUTCHERABLE
|
| Cannot be butchered

|-
| NOTHOUGHT
|
| Creature doesn't think, or doesn't require a [BRAIN] body part.
|}

<div align="center">
{{alphabetical TOC}}
</div>

==P==
{| {{prettytable}}
|- bgcolor="#ddd"
! width="20%" | Token
! width="20%" | Arguments
! width="60%" | Description
|-
| PACK_ANIMAL
|
| Allows the creature to be used as a pack animal. Currently only used by merchants.

|-
| PARALYZEIMMUNE
|
| The creature is immune to all paralyzing special attacks.

|-
| PATTERNFLIER
|
|

|-
| PEARL
|
| Creature will generate pearls.

|-
| PENETRATEPOWER
| value
| Controls the ability of vermin to find a way into containers when they are eating food from your stockpiles. Wood and cloth objects roll a 0-9 and if it's greater than the penetrate power, their contents escape for the time being. Other objects roll a 0-99.

|-
| PERSONALITY
|
*ATTRIBUTE
*lowest:median:highest
| Determines the range and chance of personality traits. Standard is 0:50:100. See [[DF2010:Personality_trait|Personality traits]] for more info.

|-
| PET
|
| Allows the creature to be tamed.

|-
| PET_EXOTIC
|
| You need a Dungeon master noble in your fortress for the creature to be tamable (but any Animal trainer can do the taming).

|-
| PETVALUE
| value
| How valuable a tamed animal/pet is. Actual cost in points in the embarking screen is (PETVALUE/2)+1 for an untrained animal, PETVALUE+1 for a trained(War or Hunting) one. Note that for an animal to be selectable in this screen, it must have the COMMON_DOMESTIC token.

|-
|PHYS_ATT_CAP_PERC
|
*ATTRIBUTE Token
*Cap %
|Default is 200. This means you can increase your attribute to 200% of its starting value (or the average value + your starting value if that is higher).

|-
| PHYS_ATT_RANGE
|
*ATTRIBUTE
*lowest
*lower
*low
*median
*high
*higher
*highest
| sets up a physical attribute's range of values. Max of 5000.

|-
| PHYS_ATT_RATES
|
*ATTRIBUTE Token
*cost to improve
*unused counter rate
*rust counter rate
*demotion counter rate
| Attribute gain/decay rates. Defaults for are 500:2:3:2, except for RECUPERATION and DISEASE_RESISTANCE that don't have change rates. The last three slots may be replaced by NONE.

|-
| PLUS_BP_GROUP
|
*BY_TYPE, BY_CATEGORY, or BY_TOKEN
*body type, category, or token
| Adds a body part group to selected body part group.

|-
| PLUS_MATERIAL
|
*material
| Adds a material to selected materials.

|-
| PLUS_TISSUE_LAYER
|
*TISSUE
*BY_CATEGORY, BY_TYPE, BY_TOKEN
*Location - category, type, or token
| Adds a tissue to those selected

|-
| PLUS_TL_GROUP
|
*TISSUE
*BY_CATEGORY, BY_TYPE, BY_TOKEN
*Location - category, type, or token
*tissue
| continues a selection of tissue layers

|-
| POP_RATIO
|
| Weighted population of caste; Lower is rarer. Not to be confused with FREQUENCY.

|-
| POPULATION_NUMBER
| min:max
| The minimum/maximum numbers of how many of these creatures can show up on a map per year.

|-
|POWER
|
|Allows the being to represent itself as a deity. Requires CAN_SPEAK to actually do anything more than settle at a location.

|-
| PREFSTRING
| string
| Sets what other creatures like about this creature. "Urist likes dwarves for their beards." Multiple entries will be chosen from at random

|-
| PROFESSION_NAME
|
*Profession
*singular
*plural
| The generic name for members of this profession, at the creature level. In order to give members of specific castes different names for professions, use CASTE_PROFESSION_NAME instead.
|}

<div align="center">
{{alphabetical TOC}}
</div>

==R==
{| {{prettytable}}
|- bgcolor="#ddd"
! width="20%" | Token
! width="20%" | Arguments
! width="60%" | Description
|-
| RELSIZE
|
*BY_CATEGORY, BY_TYPE, BY_TOKEN
*body category, type, or token
*Relsize
| Specifies a new relative size for a part than what is stated in the body plan. For example, Dwarves have larger livers.

|-
| REMAINS_COLOR
|
|

|-
| REMAINS_ON_VERMIN_BITE_DEATH
|
| Leaves remains when its attack causes it to die? Seems to go with DIE_WHEN_VERMIN_BITE.

|-
| REMAINS_UNDETERMINED
|
|

|-
| REMOVE_MATERIAL
|
*material token
| Removes a material from a creature

|-
| REMOVE_TISSUE
|
*material token
| Removes a tissue from a creature.
|}

<div align="center">
{{alphabetical TOC}}
</div>

==S==
{| {{prettytable}}
|- bgcolor="#ddd"
! width="20%" | Token
! width="20%" | Arguments
! width="60%" | Description
|-
| SAVAGE
|
| Allows creature to show up on (and limits it to) "savage" maps.

|-
| SECRETION
|
*MATERIAL REF (eg LOCAL_CREATURE_MAT
*Material name
*Material State
*location secreted from (by_type, by_category, by_token)
*body part
*tissue layer
| creates a secreted material on given tissue on a given part of the body."

|-
| SELECT_ADDITIONAL_CASTE
|
*caste name
| adds an additional previously defined caste to the selection

|-
| SELECT_CASTE
|
*caste name, or ALL
| selects a previously defined caste

|-
| SELECT_MATERIAL
|
*MATERIAL NAME
| Selects the material. Can be ALL.

|-
| SELECT_TISSUE
|
*tissue token
| Selects a tissue for editing.

|-
| SELECT_TISSUE_LAYER
|
*TISSUE
*BY_CATEGORY, BY_TYPE, BY_TOKEN
*Location - category, type, or token | Selects a tissue at a location
* (optional) FRONT, BACK, LEFT, RIGHT, TOP, BOTTOM, AROUND.
| Selects a tissue layer for descriptor and cosmetic purposes.

|-
| SEMIMEGABEAST
|
| Appears as boss creature in quests. Makes history by rampaging around towns. Possibly inhabits non-mountain caves.

|-
| SET_BP_GROUP
|
*selection criteria BY_TYPE, BY_CATEGORY, BY_TOKEN
*category, type, or token
| selection token"

|-
| SET_TL_GROUP
|
*TISSUE
*BY_CATEGORY, BY_TYPE, BY_TOKEN
*Location - category, type, or token
*tissue
| begins a selection of tissue layers

|-
| SHEARABLE_TISSUE_LAYER
| ?
| Can be sheared for wool?

|-
| SKILL_LEARN_RATE
| {{L|skill_token}}:percentage
| The rate at which this creature learns this skill.

|-
| SKILL_LEARN_RATES
| percentage
| The rate at which this creature learns all skills.

|-
| SKILL_RATE
| {{L|skill_token}}:percentage:value:value:value
| As SKILL_RATES for individual skills.

|-
| SKILL_RATES
|
*% of improvement points you get
*unused counter rate
*rust counter rate
*demotion counter rate
| Affects skill gain and decay. Lower numbers in the last three slots make decay occur faster ([SKILL_RATES:100:1:1:1] would cause rapid decay). The counter rates may also be replaced with NONE.
Default is [SKILL_RATES:100:8:8:16]. [SLOW_LEARNER] changes the 100 to a 50.

|-
| SKILL_RUST_RATE
| {{L|skill_token}}:value:value:value
| The rate at which this skill decays. Lower values cause the skill to decay faster.

|-
| SKILL_RUST_RATES
| {{L|skill_token}}:value:value:value
| The rate at which all skills decay. Lower values cause the skills to decay faster.

|-
| SLOW_LEARNER
|
| Similar to [CAN_LEARN], but slower; skills are gained at a fraction of the rate. Present in the entries for ogres and giants; can be applied to civ or player races.

|-
| SMALL_REMAINS
|
| If a creature has this token, it'll leave a small corpse that only rots once, and without miasma.

|-
| SOLDIER_ALTTILE
| 'character' or tile number
| If this creature is active in its civilization's military, it will blink between its default tile and this one.

|-
| SPEC_HEAT
| value
| Amount of energy required for the creature to heat up or cool down.

|-
| SPECIALATTACK_INJECT_EXTRACT
|
*material source, eg. LOCAL_CREATURE_MAT, INORGANIC
*MATERIAL eg.POISON,
*MATTERSTATE (ALL_SOLID, LIQUID, GAS)
*min:max
| attack type addition that injects a material into the victim.

|-
| SPECIALATTACK_SUCK_BLOOD
| min:max
| Successful attack draws out an amount of blood randomized between the min and max value.

|-
| SPEECH
| speech file
| Boasting speeches relating to killing this creature. Examples include dwarf.txt and elf.txt in the Speech folder in Data.u

|-
| SPEED
| value
| Sets the creatures' movement and work speed, 1000/[100 + SPEED X] is the resulting effect on creatures movement and work rates from default. See [http://df.magmawiki.com/index.php/Speed/ Speed] for more information.

|-
| SPHERE
|
*sphere name
| Sets what religious spheres the creature is aligned to, for purposes of being worshipped via the [POWER] token. Also affects the layout of hidden fun stuff, and the creature's name.

|-
| SPOUSE_CONVERSION_TARGET
|
| This creature can be converted by a night creature with SPOUSE_CONVERTED.

|-
| SPOUSE_CONVERTER
|
| Enables the creature to convert SPOUSE_CONVERSION_TARGETs into CONVERTED_SPOUSE castes of its species. The creature won't actually actively do this unless it also has NIGHT_CREATURE_HUNTER, however.

|-
| SWIM_SPEED
|
*speed
| How fast the creature swims. Typically 2500 (0.38 times the default speed).

|-
| SWIMS_INNATE
|
| The creature naturally knows how to swim, as opposed to [SWIMS_LEARNED] below. Currently, an AI bug prevents this from being useful on PC races in fortress mode.

|-
| SWIMS_LEARNED
|
| The creature doesn't know how to swim unless it has learned the skill. Requires [CAN_LEARN], obviously.

|-
| SYN_AFFECTED_CLASS
|
| adds a class of creatures to those affected, such as CREATURE_CLASS:GENERAL_POISON

|-
| SYN_AFFECTED_CREATURE
| Creature Name
| adds a specific creature to those affected.

|-
| SYN_CONTACT
|
| syndrome can be contracted on contact.

|-
| SYN_IMMUNE_CREATURE
|
| creates an exception for the creature so that it not affected by the syndrome.

|-
| SYN_INHALED
|
| syndrome can be contracted by inhalation, eg. poison dust.

|-
| SYN_INJECTED
|
| syndrome can be contracted by injection, eg. snake bite.

|-
| SYN_NAME
| text
| defines the name of the syndrome

|-
| SYNDROME
|
| begins definition of a syndrome for poison use
|}

<div align="center">
{{alphabetical TOC}}
</div>

==T==
{| {{prettytable}}
|- bgcolor="#ddd"
! width="20%" | Token
! width="20%" | Arguments
! width="60%" | Description
|-
| TENDONS
|
*selection criteria. Often LOCAL_CREATURE_MAT, although other selection criteria may work too.
*selected tissue
*healing rate
| Defines the material and healing rare of tendons.

|-
| THICKWEB
|
| The creature's webs can catch larger creatures. May imply [AMBUSHPREDATOR].

|-
| TISSUE
| name
| Begins defining a tissue in the creature file.

|-
| TISSUE_LAYER
|
*BY_TYPE, BY_CATEGORY, BY_TOKEN
*TYPE,CATEGORY, or TOKEN
*TISSUE
*LOCATION
| Adds the tissue layer to wherever it is required.
Non-argument Locations can be FRONT, RIGHT, LEFT, TOP, BOTTOM. Argument locations are AROUND and CLEANS, requiring a further body part and a % of coverage/cleansing

|-
| TISSUE_LAYER_UNDER
|
*BY_TYPE, BY_CATEGORY, BY_TOKEN
*TYPE,CATEGORY, or TOKEN
*TISSUE
*LOCATION
| Adds the tissue layer under a given part ex. is Iron Man he has a gaseous poison within him and this tissue (GAS is its name) has the token [TISSUE_LEAKS] and its state is GAS so when you puncture the iron outside and damage this tissue it leaks gas (can have a syndrome by using a previous one in the creature sample.) [TISSUE_LAYER_UNDER:BY_CATEGORY:ALL:{tissue}] {tissue} is what will be under the TISSUE_LAYER here is an example Tissue from Iron Man
[TISSUE:GAS]
[TISSUE_NAME:gas:NP]
[TISSUE_MATERIAL:LOCAL_CREATURE_MAT:GAS]
[TISSUE_MAT_STATE:GAS]
[RELATIVE_THICKNESS:50]
[TISSUE_LEAKS]
[TISSUE_SHAPE:LAYER]

|-
| TISSUE_LAYER_APPEARANCE_MODIFIER
|
*QUALITY
*lowest:lower:low:median:high:higher:highest
| sets the range of qualities, including LENGTH, DENSE, HIGH_POSITION, CURLY, GREASY, WRINKLY

|-
| TISSUE_STYLE_UNIT
|
*tissue
*shaping
| sets tissue to be in a certain shape, mostly used with tissues HAIR, BEARD, MOUSTACHE, SIDEBURNS.

|-
| TL_COLOR_MODIFIER
| COLOR:freq:COLOR:freq etc
| Creates a list of color patterns, giving each a frequency.

|-
| TL_CONNECTS
|
| Presumably gives the CONNECTS attribute to selected layers. Found in String Dump.

|-
| TL_HEALING_RATE
|
*new tissue healing rate number?
| Presumably changes the HEALING_RATE of the selected tissue layers. Found in String Dump.

|-
| TL_MAJOR_ARTERIES
|
| Gives Major Artery attribute to selected layers.

|-
| TL_PAIN_RECEPTORS
|
*new pain receptor number?
| Seems to set new number of pain receptors for selected tissue layers. Found in String Dump.

|-
| TL_RELATIVE_THICKNESS
|
*new relative thickness?
| Seems to set new relative thickness for selected tissue layers. Found in String Dump.

|-
| TL_VASCULAR
|
*new VASCULAR value?
| Seems to set new a VASCULAR value (which modulates bleeding) for selected tissue layers. Found in String Dump.

|-
| TLCM_GENETIC_MODEL
|
| tissue layer color modifier is passed to offspring genetically?

|-
| TLCM_IMPORTANCE
|
*number
| Presumably modifies the importance of the tissue layer color modifier, for description purposes.
HOWEVER using this appears to remove all mention of colour from creature descriptions. It does not appear in any default creatures.

|-
| TLCM_NOUN
|
*name
*SINGULAR or PLURAL
| names the tissue layer color modifier, and determines the noun

|-
| TLCM_TIMING
|
*ROOT
*start change window years:days:end change window years:days
| determines the point in the creature's life where the color change begins

|-
| TRADE_CAPACITY
|
| How much the creature can carry when used by merchants.

|-
| TRAINABLE
|
| Implies both [TRAINABLE_HUNTING] and [TRAINABLE_WAR].

|-
| TRAINABLE_HUNTING
|
| Can be trained as hunting beasts by way of kennels.

|-
| TRAINABLE_WAR
|
| Can be trained as war beasts by way of kennels.

|-
| TRANCES
|
| Allows the creature to go into martial trances.

|-
| TRAPAVOID
|
| The creature is immune to traps. Probably every procedurally generated megabeast has this.

|-
| TRIGGERABLE_GROUP
| min:max
| A large swarm of vermin can be disturbed, usually in Adventure mode.{{verify}}

|-
| TSU_NOUN
|
*noun
*SINGULAR or PLURAL
| Noun for the TISSUE_STYLE_UNIT, used in the description of the tissue layer's style.
|}

<div align="center">
{{alphabetical TOC}}
</div>

==U==
{| {{prettytable}}
|- bgcolor="#ddd"
! width="20%" | Token
! width="20%" | Arguments
! width="60%" | Description

|-
| UBIQUITOUS
|
| Creature will occur in every region with the correct biome. Does not apply to evil/good tags.

|-
| UNDERGROUND_DEPTH
|
*mindepth
*maxdepth
| Depth the creature appears underground. Numbers can be from 1 to 5. Only magma creatures use 4 or 5 in the default raws. A single argument may be used instead of min and max. Dwarven civilizations will only export (via the embark screen or caravans) things that available at depth 1.

|-
| UNDERSWIM
|
| Creature swims under the water and can't be seen.{{verify}}

|-
| UNIQUE_DEMON
|
| Typically found on genned [[demon]]s; sets the creature as capable of "emerging from the underworld" and taking over during worldgen.

|-
| USE_CASTE
|
*caste token
|

|-
| USE_MATERIAL
|
*new material token
*old material id
| Uses a local creature mat to define a new material?{{verify}}

|-
| USE_MATERIAL_TEMPLATE
|
*new material token
*material template
| Loads a material, and gives it a shortname for later reference

|-
| USE_TISSUE
|
*new tissue token
*old tissue id
| Uses a local creature mat to define a new material?{{verify}}

|-
| USE_TISSUE_TEMPLATE
|
*new tissue token
*tissue template
| Loads a tissue template listed in OBJECT:TISSUE_TEMPLATE files, such as tissue_template_default.txt.

|-
| UTTERANCES
|
| Changes the language of the creature into an unintelligible mess.
|}

<div align="center">
{{alphabetical TOC}}
</div>

==V==
{| {{prettytable}}
|- bgcolor="#ddd"
! width="20%" | Token
! width="20%" | Arguments
! width="60%" | Description
|-
| VEGETATION
|
| unknown

|-
| VIEWRANGE
| value
| Value should determine how close you have to get to a critter before it attacks (or prevents adv mode travel etc.) Default is 20.

|-
| VERMIN_BITE
|
*amount
*verb (bitten, stung)
*LOCAL_CREATURE_MAT
*MATERIAL
| vermin bites, and injects something.

|-
| VERMIN_EATER
|
| Vermin can nibble food?{{verify}}

|-
| VERMIN_FISH
|
| Acts like a fish

|-
| VERMIN_GROUNDER
|
| The creature can be picked up if you stand over it. (Requires confirmation)
'I think this is a habitat flag like VERMIN_SOIL, VERMIN_CHASM, etc. It seems to appear on creatures that don't otherwise have one. – Peristarkawan 17:27, 24 May 2007 (EDT)'

|-
| VERMIN_HATEABLE
|
| Some dwarves will hate the creature and get unhappy thoughts when around it.

|-
| VERMIN_MICRO
|
| This makes the creature move in a swarm of creatures of the same race as it. I.E. Swarm of flies, swarm of ants, etc.

|-
| VERMIN_NOFISH
|
| The creature cannot be caught by fishing.

|-
| VERMIN_NOROAM
|
| The creature will not be observed randomly roaming about the map.

|-
| VERMIN_NOTRAP
|
| The creature cannot be caught by trappers or animal traps. However, this may not work in all cases, as both dragonflies and fairies can be caught by trappers. This is possibly overridden by the VERMIN_GROUNDER token, allowing trappers set to Catch a Live Land Animal to pick up and thus trap the animal. (speculation by Flippantelf 04:45, 15 June 2009 (UTC))

|-
| VERMIN_ROTTER
|
| Present on flies, knuckle worms, acorn flies, and blood gnats. Probably means either the creature is attracted to rot, the creature speeds rotting, or both.

|-
| VERMIN_SOIL
|
| The creature randomly appears near dirt or mud.

|-
| VERMIN_SOIL_COLONY
|
| The vermin will appear in a single tile cluster of many vermin, such as a colony of ants.

|-
| VERMINHUNTER
|
| A creature with this tag will hunt down vermin and kill them. Sometimes they will eat the vermin, but most of the time they will bring it to their owner. This tag also makes impossible to assign an owner to the animal. The animal chooses it's own owner instead (like a cat). If assigned to a playable race, members of that race will ONLY be able to eat vermin.

|-
| VESPERTINE
|
| Sets if the creature is active in evening.
|}

<div align="center">
{{alphabetical TOC}}
</div>

==W==
{| {{prettytable}}
|- bgcolor="#ddd"
! width="20%" | Token
! width="20%" | Arguments
! width="60%" | Description
|-
| WAGON_PULLER
|
| Allows the creature to pull caravan wagons.

|-
| WEBBER
|
*LOCAL_CREATURE_MAT
*MATERIAL (eg SILK)
| allows the creature to web, and defines what the webs are made of.

|-
| WEBIMMUNE
|
| The creature will not get caught in webs.
|}

{{Category|Modding}}
{{Category|Tokens}}

v0.31:Creature token

2011-02-22T03:46:45Z

Bohandas: Added some tissue modifying tokens from string dump

{{av}}{{Quality|Exceptional}}

Tentative at best in some cases.

__NOTOC__

<div align="center">
{{alphabetical TOC}}
</div>

==A==
{| {{prettytable}}
|- bgcolor="#ddd"
! width="20%" | Token
! width="20%" | Arguments
! width="60%" | Description
|-
| ALCOHOL_DEPENDENT
|
| Creature needs alcohol to get through the working day.

|-
| ALL_ACTIVE
|
| Sets if the creature is active in day, night, and twilight. Seems to be a separate value from DIURNAL/NOCTURNAL/CREPUSCULAR, rather than implying them.

|-
| ALTTILE
|
| If set, the creature will blink between its [TILE] and its [ALTTILE].

|-
| AMBUSHPREDATOR
|
| Makes the creature start out hidden. Used by {{L|giant cave spider}}s. May make {{L|web}}s hidden too.

|-
| AMPHIBIOUS
|
| Allows a creature to breathe with or without {{L| water}}. Implies [AQUATIC].

|-
| APP_MOD_DESC_RANGE
| ?
| ?

|-
| APP_MOD_GENETIC_MODEL
|
|

|-
| APP_MOD_IMPORTANCE
|
*number
| Determines how important the appearance modifier is, for determining whether it shows up in the creature description.{{verify}}

|-
| APP_MOD_NOUN
|
*noun
*SINGULAR or PLURAL
| creates a noun for the appearance and whether it is singular or plural

|-
| APP_MOD_RATE
|
*Rate (integer)
*Scale (DAILY, YEARLY)
*min:max of growth
*start year:start day
*end year:end day
| setting the growth rate of the modifier. The last two tokens can be replaced by NO_END to have growth continue indefinitely.

|-
| APPLY_CREATURE_VARIATION
|
*CV TEMPLATE NAME
| Loads the Creature Variation Template specified.

|-
| APPLY_CURRENT_CREATURE_VARIATION
|
| Applies loaded Creature Variation

|-
| AQUATIC
|
| Allows a creature to breathe underwater, but causes it to "drown" out of {{L| water}}.

|-
| ARENA_RESTRICTED
|
| Does not appear in arena mode list

|-
| ARTIFICIAL_HIVEABLE
|
| Can be kept in artificial hives by beekeepers.

|-
| ATTACK
|
*token
*bodypart
*selection criteria
*location
| Defines the attack name, and the body part used.
'''Example:'''<br />
[ATTACK:GORE:BODYPART:BY_CATEGORY:HORN]<br />
''GORE'' : name of the attack<br />
''BODYPART:BY_CATEGORY:HORN'' : the horn is used to attack (presuming the creature has one)

|-
| ATTACK_CONTACT_PERC
|
*% value
| amount of available tissue used in attack

|-
| ATTACK_FLAG_CANLATCH
|
| Enables an attacker to occasionally latch on with the bodypart used by an attack when an attack with this flag in it's definition is made.

|-
| ATTACK_FLAG_EDGE
|
| attack type

|-
| ATTACK_FLAG_WITH
|
| In adventure mode, displays the name of the body part used by an attack when announcing the attack.

|-
| ATTACK_PENETRATION_PERC
|
*% value
| probably amount of material that makes contact when penetration is done

|-
| ATTACK_PRIORITY
|
*MAIN or SECOND
| use of the attack in combat. Secondary attacks are only used if main attacks are impossible.

|-
| ATTACK_SKILL
|
*skill used ({{L|Skill tokens}})
| defines the attack skill used

|-
| ATTACK_TRIGGER
| pop:exported wealth:created wealth{{verify}}
| stages when a megabeast will attack a site

|-
| ATTACK_VERB
| 2nd person:3rd person
| descriptive text for the attack

|-
| ATTACK_VELOCITY_MODIFIER
| number
| Modifies the attack velocity. Believed to be percent based (so 100 would be "normal"). May be on same scale as weapon velocity (where 1000 is "normal").

|}

<div align="center">
{{alphabetical TOC}}
</div>

==B==
{| {{prettytable}}
|- bgcolor="#ddd"
! width="20%" | Token
! width="20%" | Arguments
! width="60%" | Description
|-
| BABY
| integer
| age at which creature is considered a child. Default is zero. One can think of this as the duration of the baby stage.

|-
| BABYNAME
| singular:plural
| name at caste level

|-
| BEACH_FREQUENCY
|
| {{L|Whale}}s and {{L|Sea nettle jellyfish|jellyfish}} have this. Controls the beaching frequency of the creature.

|-
| BENIGN
|
| Determines whether creature can show up on "tame" maps (includes {{L|elephants}}), which will generally avoid dwarves, although they may chase and/or attack them if they get too close).

|-
| BIOME
|
* biome token
| Select a {{L|Biome}} the creature may appear in.

|-
| BLOOD, PUS, OTHER MATERIAL state definition
|
*selection criteria. Often LOCAL_CREATURE_MAT, although other selection criteria may work too.
*selected material
*matter state (LIQUID, GAS, ALL_SOLID)
| Controls bleeding behaviour

|-
| BODY
| body parts
| Draws body parts from OBJECT:BODY files (such as body_default.txt)
'''Example:'''<br />
[BODY:BODY_WITH_HEAD_FLAG:HEART:GUTS:BRAIN:MOUTH] <br />
This is the body from a {{L|Purring maggot}}. It creates a body with head, a heart, some guts, a brain, and a mouth. Thats all a maggot needs.

|-
| BODY_APPEARANCE_MODIFIER
|
*ATTRIBUTE
*lowest:lower:low:median:high:higher:highest
| These body modifiers give individual creatures different characteristics. In the case of HEIGHT, BROADNESS and LENGTH, the modifier is also a percentage change to the BODY_SIZE of the individual creature. The seven numbers afterward give a distribution of ranges. Each interval has an equal chance of occurring.
'''Example:'''<br />
[BODY_APPEARANCE_MODIFIER:LENGTH:90:95:98:100:102:105:110] <br />
''HEIGHT'' : marks the height to be changed <br />
''90:95:98:100:102:105:110'' : sets the range from the shortest (90% of the average height) to the tallest (110% of the average height) creature variation.

|-
| BODY_DETAIL_PLAN
| PlanName, PlanName:type:type:type:etc
| loads a plan listed OBJECT:BODY_DETAIL_PLAN files, such as b_detail_plan_default.txt. Mass applies USE_MATERIAL_TEMPLATE, mass alters RELSIZE, alters body part positions, and will allow tissue layers to be defined. Tissue layers are defined in order of skin to bone here.
'''Example:'''<br />
[BODY_DETAIL_PLAN:VERTEBRATE_TISSUE_LAYERS:SKIN:FAT:MUSCLE:BONE:CARTILAGE] <br />
This creates the detailed body of a {{L|fox}}, the skin, fat, muscle, bones and cartilage out of the vertebrate tissues.<br />
A {{L|Purring maggot|maggot}} would only need:<br />
''[BODY_DETAIL_PLAN:EXOSKELETON_TISSUE_LAYERS:SKIN:FAT:MUSCLE]''

|-
| BODY_SIZE
| years:days:size
| sets up size at a given time. Size is roughly equal to the creature's average weight in grams.
'''Example:'''<br />
[BODY_SIZE:0:0:10000]<br />
[BODY_SIZE:1:168:50000]<br />
[BODY_SIZE:12:0:220000]<br />
This describes the size of a {{L|minotaur}}. His birth size would be 10000 (~10 kg). With 1 year and 168 days he would be 50000 tall (~50 kg). As an adult (with 12 years) he would weight roughly 220 kg

|-
| BODYGLOSS
| gloss
| Substitutes body part text with replacement text. Draws gloss information from OBJECT:BODY files (such as body_default.txt)

|-
| BONECARN
|
| Creature 'eats' bones. Eating bones makes their happiness go up, but can cause death (suffocation){{verify}}. Implies CARNIVORE.

|-
| BP_APPEARANCE_MODIFIER
|
*QUALITY
*lowest:lower:low:median:high:higher:highest
| sets up the breadth of possibilities for appearance qualities for a selected BP group. EG. Eyes (CLOSE_SET, DEEP_SET, ROUND_VS_NARROW, LARGE_IRIS),Lips (THICKNESS), Nose (BROADNESS, LENGTH, UPTURNED, CONVEX), Ear (SPLAYED_OUT, HANGING_LOBES, BROADNESS, HEIGHT), Tooth (GAPS), Skull (HIGH_CHEEKBONES, BROAD_CHIN, JUTTING CHIN, SQUARE_CHIN), Neck (DEEP_VOICE, RASPY_VOICE), Head (BROADNESS, HEIGHT)

|-
| BUILDINGDESTROYER
| 1 or 2
| Allows a creature to destroy furniture and buildings. Value [1] targets mostly doors, hatches, furniture and the like. Value [2] targets anything not made with the b + C commands.
|}

<div align="center">
{{alphabetical TOC}}
</div>

==C==
{| {{prettytable}}
|- bgcolor="#ddd"
! width="20%" | Token
! width="20%" | Arguments
! width="60%" | Description

|-
| CAN_LEARN
|
| The creature gets skills and professions. Note that this token makes the creature unable to be butchered by an adventurer so it is not recommended for uncivilized monsters. Adventurers lacking this token can allocate but not increase attributes and skills. skills allocated will disappear on start.

|-
| CAN_SPEAK
|
| Can talk. Note that it is not necessary for a creature to gain social skills.

|-
| CANNOT_UNDEAD
|
| Cannot be turned into a zombie or skeletal undead

|-
| CANOPENDOORS
|
| Allows the creature to open doors.

|-
| CARNIVORE
|
| Creature ''only'' eats meat

|-
| CASTE
|
*name
| defines a caste

|-
| CASTE_ALTTILE
|
*tile number or "letter"
| Caste-specific alternate tile. Expects CASTE_TILE

|-
| CASTE_COLOR
|
*fg
*bg
*brightness
| Creature tile color of the caste.

|-
| CASTE_GLOWCOLOR
|
*fg
*bg
*brightness
| GLOWTILE color of the caste.

|-
| CASTE_GLOWTILE
|
*tile value or "letter"
| Caste-specific glowtile

|-
| CASTE_NAME
| singular:plural:adjective
| The name of the caste of the creature in the game.

|-
| CASTE_PROFESSION_NAME
|
*Profession
*singular
*plural
| alters the name of the given profession, caste-specific

|-
| CASTE_SOLDIER_ALTTILE
| 'character' or tile number
| Creatures of this caste active in their civilization's military will blink between their default tile and this one.

|-
| CASTE_SOLDIER_TILE
| 'character' or tile number
| Creatures of this caste active in their civilization's military will use this tile instead.

|-
| CASTE_SPEECH
| speech file?
| Possibly a caste-specific instance of the SPEECH token

|-
| CASTE_TILE
|
* tile number or "letter"
| Caste-specific creature tile.

|-
| CAVE_ADAPT
|
| Gives the creature a bonus in caves. Also causes [[Cave adaptation]].

|-
| CE_X
|
*SEV:<value> (severity, higher is worse)
*PROB:<value(1-100)> (probability)
*RESISTABLE (optional) allows resistance
*SIZE_DILUTES (optional) lessens effect based on size
Place effected:
*LOCALIZED (optional)
*VASCULAR_ONLY (optional)
*MUSCULAR_ONLY (optional)
*BP:(select BY_CATEGORY, BY_TYPE, or BY_TOKEN):category, type or token:tissues affected (specific or ALL) (optional)
Timeline:
*Start:effect start time
*Peak:effect peak time
*End:effect end time
| Specifies the way that a syndrome affects a creature -- more detail can be found on the [[Syndrome#Creature effect tokens|Syndromes page]]

|-
| CHANGE_BODY_SIZE_PERC
|
|

|-
| CHILD
| integer
| age at which creature is considered an adult. One can think of this as the duration of the child stage. Without this token, a creature will not reproduce in Fortress mode.

|-
| CHILD_BODYPART_GROUP
|
*master selection, BY_CATEGORY, BY_TYPE, BY_TOKEN.
*master location
*specific selection, BY_CATEGORY, BY_TYPE, BY_TOKEN.
*specific location
| selects all parts of a group to be used.

|-
| CHILDNAME
| singular:plural
| name at caste level

|-
| CLUSTER_NUMBER
|
*min
*max
| The minimum/maximum numbers of how many creatures per spawned cluster. Certain vermin fish use this token in combination with temperate ocean and river biome tokens to perform seasonal migrations.
e.g. [CLUSTER_NUMBER:1:3]

|-
|CLUTCH_SIZE
|
*min
*max
|Number of eggs laid in one sitting.

|-
| COLDDAM_POINT
| value
| The minimum temperature limit before the currently selected material will start receiving damage from freezing. Used mostly in material templates.

|-
| COLONY_EXTERNAL
|
| Caste hovers around colony.

|-
| COLOR
| foreground:background:brightness
| Color of the creature's tile.

|-
| COMMON_DOMESTIC
|
| Allows the creature to be brought with immigrants and when creating a new fortress, as long as the creature also includes at least one of the following tokens: PET, PACK_ANIMAL, WAGON_PULLER, MOUNT. In addition, the creature must be NATURAL rather than FANCIFUL

|-
| CONVERTED_SPOUSE
|
| Found only at caste level. Creatures of this caste's species with the SPOUSE_CONVERTER and NIGHT_CREATURE_HUNTER tokens will kidnap SPOUSE_CONVERSION_TARGETs of an appropriate sex and convert them into castes with CONVERTED_SPOUSE.

|-
| COOKABLE_LIVE
|
| Set this to allow the creature to be cooked in meals without first being butchered / fishcleaned.

|-
| COPY_TAGS_FROM
|
*CREATURE NAME
| Copies tags from another specified creature.

|-
| CREATURE
| name
| begins defining a new creature with the specified name.

|-
| CREATURE_CLASS
|
*classname
| Creature class. Can be anything, but only existing use is GENERAL_POISON. Appears to only be used for Syndromes. Supposedly can also be used for entity positions.

|-
| CREATURE_SOLDIER_TILE
| 'character' or tile number
| Creatures active in their civilization's military will use this tile instead.

|-
| CREATURE_TILE
| 'character' or tile number
| The symbol of the creature in ASCII mode.

|-
| CREPUSCULAR
|
| Sets if the creature is active at twilight. This tag functions as a combination of the two tags VESPERTINE and MATUTINAL.

|-
| CURIOUSBEAST_EATER
|
| Allows a creature to steal and eat edible items from a site.

|-
| CURIOUSBEAST_GUZZLER
|
| Allows a creature to (very quickly) drink your alcohol. Or spill the barrel to the ground. Also affects undead versions of the creature.

|-
| CURIOUSBEAST_ITEM
|
| Allows a creature to steal things (apparently the highest value it can find). Semimegabeast thievery is in Legends mode. Lightweight creatures can probably steal heavy items.

|-
| CV_ADD_TAG
|
*TAG NAME
| Adds a tag. Used in conjunction with creature variation templates.

|-
| CV_REMOVE_TAG
|
*TAG NAME
| Removes a tag. Used in conjunction with creature variation templates.
|}

<div align="center">
{{alphabetical TOC}}
</div>

==D==
{| {{prettytable}}
|- bgcolor="#ddd"
! width="20%" | Token
! width="20%" | Arguments
! width="60%" | Description

|-
| DEMON
|
| Typically found on genned [[demon]]s; sets the creature as a potential spawn for [[Hidden Fun Stuff]]

|-
| DESCRIPTION
| text
| A brief description of the creature type.

|-
| DIE_WHEN_VERMIN_BITE
|
| Dies upon attacking. Used for bee stings.

|-
| DIFFICULTY
| integer
| Toady: "Difficulty determines how deep it places them in adventure mode/reclaim caves, and the chance that they are wounded the first few river attacks." Also increases experience gain during adventure mode.

|-
| DIURNAL
|
| Sets if the creature is active in day.

|-
| DOES_NOT_EXIST
|
| Creature does not actually exist; used for fanciful creatures.

|-
| DRAGONFIREBREATH
|
| Creature breathes fire in a cone.
|}

<div align="center">
{{alphabetical TOC}}
</div>

==E==
{| {{prettytable}}
|- bgcolor="#ddd"
! width="20%" | Token
! width="20%" | Arguments
! width="60%" | Description

|-
| EGG_MATERIAL
|
*LOCAL_CREATURE_MAT
*EGGSHELL/EGG_WHITE/EGG_YOLK
*state (solid, liquid, or gas)
| Egg material. Eggs will be made out of eggshell. Edibility is determined by tags on whites or yolk, but they otherwise do not exist.

|-
| EGG_SIZE
|
*size
| Size of creature's egg?

|-
| EQUIPMENT_WAGON
|
| Makes the creature into a large 3x3 creature responsible for carrying trade goods, pulled by two [WAGON_PULLER]s and driven by a merchant.

|-
| EQUIPS
|
| Allows the creature to wear or wield items.

|-
| EVIL
|
| Determines whether creature can show up on "evil" maps

|-
| EXTRAVISION
|
| Creature can see regardless of whether it has working eyes.
|}

<div align="center">
{{alphabetical TOC}}
</div>

==F==
{| {{prettytable}}
|- bgcolor="#ddd"
! width="20%" | Token
! width="20%" | Arguments
! width="60%" | Description
|-
| FANCIFUL
|
| Makes every civilization know about the creature. The creature won't occur in regular material preference lists. The tag also adds some art value modifiers. Used for things like dragons and other legendary creatures.

|-
| FEATURE_ATTACK_GROUP
|
| Found on subterranean animalmen.

|-
| FEMALE
|
| Inside a female caste, sets femaleness. Outside of a caste, sets all individuals female unless overridden by caste.

|-
| FIREBREATH
|
| The creature breathes fire projectiles (as opposed to DRAGONFIREBREATH, which is in a cone).

|-
| FIREIMMUNE
|
| As of version v0.28.181.40d, the FIREIMMUNE token had no effect on a creature's resistance to flame or heat. However, it did affect ability to swim in magma in adventure mode, as well as display of "You are caught in a pool of magma!" warning messages. It is unknown if these effects persist in DF 2010.

|-
| FIREIMMUNE_SUPER
|
| The creature is immune to DRAGONFIREBREATH. Implies FIREIMMUNE.

|-
| FISHITEM
|
| Needs to be cleaned at a fishery

|-
| FIXED_TEMP
| temperature
| The natural heat generated by the creature.

|-
| FLEEQUICK
|
| Determines how soon a creature flees in a losing battle.

|-
| FLIER
|
| Allows a creature to fly. Fortress Mode pathfinding only partially incorporates pathfinding - flying dwarves need a land path to exist between them and an area in order to access it, but as long as one such path exists, they do not need to use it, instead being able to fly over intervening obstacles.

|-
| FREQUENCY
|
*number, max 100
| Determines the time between creature spawns in Fortress Mode. Higher is more occurrences per time unit. Creatures without a frequency statement default to 50. Almost all others have either [FREQUENCY:5] or [FREQUENCY:100]. Not to be confused with POP_RATIO
|}

<div align="center">
{{alphabetical TOC}}
</div>

==G==
{| {{prettytable}}
|- bgcolor="#ddd"
! width="20%" | Token
! width="20%" | Arguments
! width="60%" | Description
|-
| GENERAL_BABY_NAME
| singular:plural
| name at creature level

|-
| GENERAL_CHILD_NAME
| singular:plural
| name at creature level

|-
| GENERATED
|
| Found on procedurally generated creatures like [[Forgotten beast]]s, (biome name) titans and [[Demon]]s.

|-
| GETS_INFECTIONS_FROM_ROT
|
| creature can be infected by rot

|-
| GETS_WOUND_INFECTIONS
|
| creature can get infections from wounds

|-
| GLOWCOLOR
|
*foreground
*background
*brightness
| The colour of the GLOWTILE of the creature.

|-
| GLOWTILE
| ascii character
| If present, the being glows in the dark (generally used for Adventure Mode). The tile is what replaces the being's current tile when it is obscured from your sight by darkness. The default setting for kobolds (a yellow quotation mark) provides a nice "glowing eyes" effect. The game is also hardcoded to automatically convert quotation mark GLOWTILES into apostrophes if the creature has lost one eye. This works at the generic creature level - for caste-specific glow tiles, use CASTE_GLOWTILE instead.

|-
| GNAWER
| verb (gnawed)
| The creature chews on food barrels and bags.

|-
| GO_TO_END
|
| uncertain use, definitely refers to Creature Variants template

|-
| GO_TO_START
|
| uncertain use, definitely refers to Creature Variants template

|-
| GOOD
|
| Determines whether creature can show up on "good" areas. Eg. unicorn.

|-
| GRASSTRAMPLE
| value
| Determines the percentage chance of trampling and killing grass when a creature steps on it. Set [GRASSTRAMPLE:0] to make grass never trampled by the creature.

|-
| GRAVITATE_BODY_SIZE
|
| Creature Variants template command, alter body size.

|-
| GRAZER
|
*number
| Animals is a grazer. The higher the number, the less grass it needs.
|}

<div align="center">
{{alphabetical TOC}}
</div>

==H==
{| {{prettytable}}
|- bgcolor="#ddd"
! width="20%" | Token
! width="20%" | Arguments
! width="60%" | Description
|-
| HABIT
| type:probability
| Defines certain behaviors for the creature. The habit types are COLLECT_TROPHIES, COOK_PEOPLE, COOK_VERMIN, GRIND_VERMIN, COOK_BLOOD, GRIND_BONE_MEAL, EAT_BONE_PORRIDGE, USE_ANY_MELEE_WEAPON, and COLLECT_WEALTH. These may require the creature to have a lair to work properly.

|-
| HABIT_NUM
| number or TEST_ALL
| Unknown. All lists of HABITs are preceded by [HABIT_NUM:TEST_ALL]

|-
| HAS_NERVES
|
| This makes the creature susceptible to severed motor and sensory nerves when muscles are torn in limb, grasp and stance parts. Some butchering yields nervous tissue.

|-
| HEATDAM_POINT
| value
| The maximum temperature limit before the currently selected material will start receiving damage from heat. Used mostly in material templates.

|-
| HIVE_PRODUCT
|
*number
*time
*item tokens
| What product is harvested from beekeeping.

|-
| HOMEOTHERM
|
| Default 'NONE'. The creature's normal body [[DF2010:Temperature |temperature]]
|}

<div align="center">
{{alphabetical TOC}}
</div>

==I==
{| {{prettytable}}
|- bgcolor="#ddd"
! width="20%" | Token
! width="20%" | Arguments
! width="60%" | Description
|-
| IF_EXISTS_SET_BOILING_POINT
| value
| The temperature at which the creature boils into gases.

|-
| IF_EXISTS_SET_MELTING_POINT
| value
| The temperature at which the creature will melt into goo.

|-
| IGNITE_POINT
| value
| The temperature at which the creature will burst into flames.

|-
| IMMOBILE_LAND
|
| The creature is immobile while on land. Only works on AQUATIC creatures which can't breath on land.

|-
| IMMOLATE
|
| Will ignite, and potentially completely destroy, items the creature is standing on. Keep booze away from critters with this tag.

|-
| INSULATION
| value
| increases the insulation of a selected material (usually hair, feathers or skin)

|-
| INTELLIGENT
|
| Implies CAN_SPEAK and CAN_LEARN. CAN_LEARN probably means the creature gets skills and professions. Not recommended for uncivilized monsters.

|-
| ITEMCORPSE
|
* [[Item token]]
* subtype
NO_SUBTYPE
* matgloss token
* NO_RACEGLOSS
USE_RACEGLOSS USE_SHARPSTONE
| Determines if the creature leaves behind a non-standard corpse (i.e. wood, statue, bars, ash from ghost etc). The first parameter determines the item type; the second parameter is the subtype indicated in the raw file (such as WEAPON_WHIP); the third indicates the material type if the item type takes a specific material (e.g. ""IRON"" if the corpse type is ""STATUE""). USE_RACEGLOSS applies if the creature has a material glossary assigned by the ""HAS_RACEGLOSS:"" flag and will select necessary adjectives and material from that glossary.
As of 31_01, RACEGLOSS may no longer be in the game.{{verify}}

|-
| ITEMCORPSE_QUALITY
|
| The quality of an item-type corpse left behind; 5 is masterpiece-level.
|}

<div align="center">
{{alphabetical TOC}}
</div>

==L==
{| {{prettytable}}
|- bgcolor="#ddd"
! width="20%" | Token
! width="20%" | Arguments
! width="60%" | Description
|-
| LAIR
| type:probability
| Found on megabeasts, semimegabeasts, and night creatues. The creature will seek out sites of this type and take them as lairs. The lair types are SIMPLE_BURROW, SIMPLE_MOUND, SHRINE, and LABYRINTH.

|-
| LAIR_CHARACTERISTIC
| characteristic:probability
| Defines certain features of the creature's lair. The only known valid characteristic is HAS_DOORS.

|-
| LAIR_HUNTER
|
| This creature will actively hunt adventurers in its lair.

|-
| LAIR_HUNTER_SPEECH
| speech file
| What this creature says while hunting adventurers in its lair.

|-
| LARGE_PREDATOR
|
| Will attack things that are smaller than it (like dwarves). Only one group of "large predators" will appear on any given map (possibly two groups on "savage" maps). In adventure mode, large predators will try to ambush and attack you (and your party will attack them back). Also, they can be mentioned in the intro paragraph when starting a fortress e.g. "ere the wolves get hungry."

|-
| LARGE_ROAMING
|
| In Fortress Mode, spawns outdoors and is not a vermin creature.

|-
| LAYS_EGGS
|
| Creature lays eggs instead of giving birth to live young.

|-
| LAYS_UNUSUAL_EGGS
| Item tokens
| Creature lays a particular item instead of regular eggs. As of v0.31.19, this tag only makes the game crash.

|-
| LIGAMENTS
|
*selection criteria. Often LOCAL_CREATURE_MAT, although other selection criteria may work too.
*selected material. Almost always SINEW of the creature's materials.
*healing rate
| defines the material and healing rate of ligaments.

|-
| LIGHT_GEN
|
| The creature will generate light, such as in adventurer mode at night.

|-
| LIKES_FIGHTING
|
| The creature will attack enemies rather than flee from them. This tag has the same effect on player-controlled creatures - included modded dwarves.

|-
| LISP
|
| Creature multiplies 'S' when talking. Ex: "My name isss Recisssiz."

|-
| LITTERSIZE
|
* minumum
* maximum
| Determines the random chance of how many creatures are generated when giving birth. [LITTERSIZE:1:2]

|-
| LOCKPICKER
|
| Lets a creature open doors that are set to forbidden in Fortress Mode.

|-
| LOOSE_CLUSTERS
|
| The creatures will scatter if they have this tag, or form tight packs if they don't.
|}

<div align="center">
{{alphabetical TOC}}
</div>

==M==
{| {{prettytable}}
|- bgcolor="#ddd"
! width="20%" | Token
! width="20%" | Arguments
! width="60%" | Description

|-
| MAGMA_VISION
|
| Creature's able to see while covered in magma.

|-
| MALE
|
| all male

|-
| MANNERISM_??
|
*occassionally body part
| Adds a possible mannerism to the creature's profile.
Refer to {{L|Creature Token Mannerisms|Mannerisms}}

|-
| MATERIAL
|
*material id
| Begins defining a new material.{{verify}}

|-
| MATERIAL_BREATH_ATTACK
|
*MATERIAL TYPE (TISSUE, INORGANIC)
*MATERIAL NAME
*MATERIAL STATE (TRAILING_DUST_FLOW, TRAILING_VAPOR_FLOW, TRAILING_GAS_FLOW, SOLID_GLOB, LIQUID_GLOB, UNDIRECTED_GAS, UNDIRECTED_VAPOR, UNDIRECTED_DUST)
| Creates an attack referencing a material, using a given type of breath attack.

|-
| MAXAGE
| min:max
| range of time in which death from old age may occur

|-
| MEANDERER
|
| Gives a creature random movement.

|-
| MEGABEAST
|
| Appears on fortress territory in Fortress Mode occasionally. Implies SEMIMEGABEAST. Also can be worshipped

|-
|MENT_ATT_CAP_PERC
|
*ATTRIBUTE Token
*Cap %
|Default is 200. This means you can increase your attribute to 200% of its starting value (or the average value + your starting value if that is higher).

|-
| MENT_ATT_RANGE
|
*ATTRIBUTE
*lowest:lower:low:median:high:higher:highest | sets up a mental attribute's range of values. Max of 5000.

|-
| MENT_ATT_RATES
|
*ATTRIBUTE Token
*cost to improve
*unused counter rate
*rust counter rate
*demotion counter rate
| Attribute gain/decay rates. Defaults for are 500:2:3:2, except for RECUPERATION and DISEASE_RESISTANCE that don't have change rates. The last three slots may be replaced by NONE.

|-
| MILKABLE
|
*LOCAL_CREATURE_MAT:MILK:amount
| Allows the creature to be milked.

|-
| MISCHIEVIOUS
|
| Will pull any levers it comes across. Also makes creature spawn invisible and with several ranks in Ambusher. "They go on little missions to mess with various fortress buildings, not just levers."

|-
| MOUNT
|
| Creature may be used as a mount

|-
| MOUNT_EXOTIC
|
| You need the Dungeon master noble to mount the creature.

|-
| MULTIPLE_LITTER_RARE
|
| Makes litters with more than one offspring rare.

|-
| MULTIPLY_VALUE
|
*Multiplier
| multiplies value of materials

|-
| MUNDANE
|
| Marks if the creature is an actual real-life creature. Only used for age-names at present.
|}

<div align="center">
{{alphabetical TOC}}
</div>

==N==
{| {{prettytable}}
|- bgcolor="#ddd"
! width="20%" | Token
! width="20%" | Arguments
! width="60%" | Description
|-
| NAME
| singular:plural:adjective
| The generic name for any creature of this type - will be used when distinctions between caste are unimportant. For names for specific castes, use CASTE_NAME instead.

|-
| NATURAL
|
| Animal is considered to be natural.

|-
| NATURAL_SKILL
| skill:value
| The creature possesses this skill at this level inherently. It begins with this skill at this level, and the skill may never rust below this level.

|-
| NIGHT_CREATURE_BOGEYMAN
|
| Found on bogeymen. Presumably makes the creature attack the player at night in hordes like bogeymen do.

|-
| NIGHT_CREATURE_HUNTER
|
| If this creature has SPOUSE_CONVERTER, it will actively attempt to seek out potential conversion targets, abduct them, and convert them. Night creatures will seek out one SPOUSE_CONVERSION_TARGET of the opposite sex, convert them, and then have children with them. NIGHT_CREATURE_HUNTERs without SPOUSE_CONVERTER will not be placed.

|-
| NO_AUTUMN
|
| does not appear this season.

|-
| NO_DIZZINESS
|
| Creature cannot become dizzy

|-
| NO_DRINK
|
| Creature does not need to drink.

|-
| NO_EAT
|
| Creature does not need to eat.

|-
| NO_FEVERS
|
| Creature cannot suffer fevers

|-
| NO_SLEEP
|
| Creature does not need to sleep.

|-
| NO_SPRING
|
| does not appear this season.

|-
| NO_SUMMER
|
| does not appear this season.

|-
| NO_THOUGHT_CENTER_FOR_MOVEMENT
|
| Probably shorthand for movement being unaffected by damage in general.

|-
| NO_WINTER
|
| does not appear this season.

|-
| NOBONES
|
| Creature has no bones.

|-
| NOBREATHE
|
| Creature doesn't need to breathe or have [BREATHE] parts in body. Cannot drown or be strangled.

|-
| NOCTURNAL
|
| Sets if the creature is active in night.

|-
| NOEMOTION
|
| The creature has no emotions, and does not rage.

|-
| NOEXERT
|
| Creature can't become tired or over-exerted.

|-
| NOFEAR
|
| Creature doesn't feel fear and will never run away from battle.

|-
| NOMEAT
|
| Creature will not drop meat on butcher.

|-
| NONAUSEA
|
| Creature can't vomit.

|-
| NOPAIN
|
| Creature doesn't feel pain.

|-
| NOSKIN
|
| Creature will not drop skin on butcher.

|-
| NOSKULL
|
| Creature will not drop skull on butcher, rot, or decay of severed head.

|-
| NOSMELLYROT
|
| Does not produce miasma when rotting

|-
| NOSTUCKINS
|
| Weapons can't be stuck in creature.

|-
| NOSTUN
|
| Creature can't be stunned. Evidence suggests creatures with this tag never wake up from sleep in Fortress Mode.

|-
| NOT_BUTCHERABLE
|
| Cannot be butchered

|-
| NOTHOUGHT
|
| Creature doesn't think, or doesn't require a [BRAIN] body part.
|}

<div align="center">
{{alphabetical TOC}}
</div>

==P==
{| {{prettytable}}
|- bgcolor="#ddd"
! width="20%" | Token
! width="20%" | Arguments
! width="60%" | Description
|-
| PACK_ANIMAL
|
| Allows the creature to be used as a pack animal. Currently only used by merchants.

|-
| PARALYZEIMMUNE
|
| The creature is immune to all paralyzing special attacks.

|-
| PATTERNFLIER
|
|

|-
| PEARL
|
| Creature will generate pearls.

|-
| PENETRATEPOWER
| value
| Controls the ability of vermin to find a way into containers when they are eating food from your stockpiles. Wood and cloth objects roll a 0-9 and if it's greater than the penetrate power, their contents escape for the time being. Other objects roll a 0-99.

|-
| PERSONALITY
|
*ATTRIBUTE
*lowest:median:highest
| Determines the range and chance of personality traits. Standard is 0:50:100. See [[DF2010:Personality_trait|Personality traits]] for more info.

|-
| PET
|
| Allows the creature to be tamed.

|-
| PET_EXOTIC
|
| You need a Dungeon master noble in your fortress for the creature to be tamable (but any Animal trainer can do the taming).

|-
| PETVALUE
| value
| How valuable a tamed animal/pet is. Actual cost in points in the embarking screen is (PETVALUE/2)+1 for an untrained animal, PETVALUE+1 for a trained(War or Hunting) one. Note that for an animal to be selectable in this screen, it must have the COMMON_DOMESTIC token.

|-
|PHYS_ATT_CAP_PERC
|
*ATTRIBUTE Token
*Cap %
|Default is 200. This means you can increase your attribute to 200% of its starting value (or the average value + your starting value if that is higher).

|-
| PHYS_ATT_RANGE
|
*ATTRIBUTE
*lowest
*lower
*low
*median
*high
*higher
*highest
| sets up a physical attribute's range of values. Max of 5000.

|-
| PHYS_ATT_RATES
|
*ATTRIBUTE Token
*cost to improve
*unused counter rate
*rust counter rate
*demotion counter rate
| Attribute gain/decay rates. Defaults for are 500:2:3:2, except for RECUPERATION and DISEASE_RESISTANCE that don't have change rates. The last three slots may be replaced by NONE.

|-
| PLUS_BP_GROUP
|
*BY_TYPE, BY_CATEGORY, or BY_TOKEN
*body type, category, or token
| Adds a body part group to selected body part group.

|-
| PLUS_MATERIAL
|
*material
| Adds a material to selected materials.

|-
| PLUS_TISSUE_LAYER
|
*TISSUE
*BY_CATEGORY, BY_TYPE, BY_TOKEN
*Location - category, type, or token
| Adds a tissue to those selected

|-
| PLUS_TL_GROUP
|
*TISSUE
*BY_CATEGORY, BY_TYPE, BY_TOKEN
*Location - category, type, or token
*tissue
| continues a selection of tissue layers

|-
| POP_RATIO
|
| Weighted population of caste; Lower is rarer. Not to be confused with FREQUENCY.

|-
| POPULATION_NUMBER
| min:max
| The minimum/maximum numbers of how many of these creatures can show up on a map per year.

|-
|POWER
|
|Allows the being to represent itself as a deity. Requires CAN_SPEAK to actually do anything more than settle at a location.

|-
| PREFSTRING
| string
| Sets what other creatures like about this creature. "Urist likes dwarves for their beards." Multiple entries will be chosen from at random

|-
| PROFESSION_NAME
|
*Profession
*singular
*plural
| The generic name for members of this profession, at the creature level. In order to give members of specific castes different names for professions, use CASTE_PROFESSION_NAME instead.
|}

<div align="center">
{{alphabetical TOC}}
</div>

==R==
{| {{prettytable}}
|- bgcolor="#ddd"
! width="20%" | Token
! width="20%" | Arguments
! width="60%" | Description
|-
| RELSIZE
|
*BY_CATEGORY, BY_TYPE, BY_TOKEN
*body category, type, or token
*Relsize
| Specifies a new relative size for a part than what is stated in the body plan. For example, Dwarves have larger livers.

|-
| REMAINS_COLOR
|
|

|-
| REMAINS_ON_VERMIN_BITE_DEATH
|
| Leaves remains when its attack causes it to die? Seems to go with DIE_WHEN_VERMIN_BITE.

|-
| REMAINS_UNDETERMINED
|
|

|-
| REMOVE_MATERIAL
|
*material token
| Removes a material from a creature

|-
| REMOVE_TISSUE
|
*material token
| Removes a tissue from a creature.
|}

<div align="center">
{{alphabetical TOC}}
</div>

==S==
{| {{prettytable}}
|- bgcolor="#ddd"
! width="20%" | Token
! width="20%" | Arguments
! width="60%" | Description
|-
| SAVAGE
|
| Allows creature to show up on (and limits it to) "savage" maps.

|-
| SECRETION
|
*MATERIAL REF (eg LOCAL_CREATURE_MAT
*Material name
*Material State
*location secreted from (by_type, by_category, by_token)
*body part
*tissue layer
| creates a secreted material on given tissue on a given part of the body."

|-
| SELECT_ADDITIONAL_CASTE
|
*caste name
| adds an additional previously defined caste to the selection

|-
| SELECT_CASTE
|
*caste name, or ALL
| selects a previously defined caste

|-
| SELECT_MATERIAL
|
*MATERIAL NAME
| Selects the material. Can be ALL.

|-
| SELECT_TISSUE
|
*tissue token
| Selects a tissue for editing.

|-
| SELECT_TISSUE_LAYER
|
*TISSUE
*BY_CATEGORY, BY_TYPE, BY_TOKEN
*Location - category, type, or token | Selects a tissue at a location
* (optional) FRONT, BACK, LEFT, RIGHT, TOP, BOTTOM, AROUND.
| Selects a tissue layer for descriptor and cosmetic purposes.

|-
| SEMIMEGABEAST
|
| Appears as boss creature in quests. Makes history by rampaging around towns. Possibly inhabits non-mountain caves.

|-
| SET_BP_GROUP
|
*selection criteria BY_TYPE, BY_CATEGORY, BY_TOKEN
*category, type, or token
| selection token"

|-
| SET_TL_GROUP
|
*TISSUE
*BY_CATEGORY, BY_TYPE, BY_TOKEN
*Location - category, type, or token
*tissue
| begins a selection of tissue layers

|-
| SHEARABLE_TISSUE_LAYER
| ?
| Can be sheared for wool?

|-
| SKILL_LEARN_RATE
| {{L|skill_token}}:percentage
| The rate at which this creature learns this skill.

|-
| SKILL_LEARN_RATES
| percentage
| The rate at which this creature learns all skills.

|-
| SKILL_RATE
| {{L|skill_token}}:percentage:value:value:value
| As SKILL_RATES for individual skills.

|-
| SKILL_RATES
|
*% of improvement points you get
*unused counter rate
*rust counter rate
*demotion counter rate
| Affects skill gain and decay. Lower numbers in the last three slots make decay occur faster ([SKILL_RATES:100:1:1:1] would cause rapid decay). The counter rates may also be replaced with NONE.
Default is [SKILL_RATES:100:8:8:16]. [SLOW_LEARNER] changes the 100 to a 50.

|-
| SKILL_RUST_RATE
| {{L|skill_token}}:value:value:value
| The rate at which this skill decays. Lower values cause the skill to decay faster.

|-
| SKILL_RUST_RATES
| {{L|skill_token}}:value:value:value
| The rate at which all skills decay. Lower values cause the skills to decay faster.

|-
| SLOW_LEARNER
|
| Similar to [CAN_LEARN], but slower; skills are gained at a fraction of the rate. Present in the entries for ogres and giants; can be applied to civ or player races.

|-
| SMALL_REMAINS
|
| If a creature has this token, it'll leave a small corpse that only rots once, and without miasma.

|-
| SOLDIER_ALTTILE
| 'character' or tile number
| If this creature is active in its civilization's military, it will blink between its default tile and this one.

|-
| SPEC_HEAT
| value
| Amount of energy required for the creature to heat up or cool down.

|-
| SPECIALATTACK_INJECT_EXTRACT
|
*material source, eg. LOCAL_CREATURE_MAT, INORGANIC
*MATERIAL eg.POISON,
*MATTERSTATE (ALL_SOLID, LIQUID, GAS)
*min:max
| attack type addition that injects a material into the victim.

|-
| SPECIALATTACK_SUCK_BLOOD
| min:max
| Successful attack draws out an amount of blood randomized between the min and max value.

|-
| SPEECH
| speech file
| Boasting speeches relating to killing this creature. Examples include dwarf.txt and elf.txt in the Speech folder in Data.u

|-
| SPEED
| value
| Sets the creatures' movement and work speed, 1000/[100 + SPEED X] is the resulting effect on creatures movement and work rates from default. See [http://df.magmawiki.com/index.php/Speed/ Speed] for more information.

|-
| SPHERE
|
*sphere name
| Sets what religious spheres the creature is aligned to, for purposes of being worshipped via the [POWER] token. Also affects the layout of hidden fun stuff, and the creature's name.

|-
| SPOUSE_CONVERSION_TARGET
|
| This creature can be converted by a night creature with SPOUSE_CONVERTED.

|-
| SPOUSE_CONVERTER
|
| Enables the creature to convert SPOUSE_CONVERSION_TARGETs into CONVERTED_SPOUSE castes of its species. The creature won't actually actively do this unless it also has NIGHT_CREATURE_HUNTER, however.

|-
| SWIM_SPEED
|
*speed
| How fast the creature swims. Typically 2500 (0.38 times the default speed).

|-
| SWIMS_INNATE
|
| The creature naturally knows how to swim, as opposed to [SWIMS_LEARNED] below. Currently, an AI bug prevents this from being useful on PC races in fortress mode.

|-
| SWIMS_LEARNED
|
| The creature doesn't know how to swim unless it has learned the skill. Requires [CAN_LEARN], obviously.

|-
| SYN_AFFECTED_CLASS
|
| adds a class of creatures to those affected, such as CREATURE_CLASS:GENERAL_POISON

|-
| SYN_AFFECTED_CREATURE
| Creature Name
| adds a specific creature to those affected.

|-
| SYN_CONTACT
|
| syndrome can be contracted on contact.

|-
| SYN_IMMUNE_CREATURE
|
| creates an exception for the creature so that it not affected by the syndrome.

|-
| SYN_INHALED
|
| syndrome can be contracted by inhalation, eg. poison dust.

|-
| SYN_INJECTED
|
| syndrome can be contracted by injection, eg. snake bite.

|-
| SYN_NAME
| text
| defines the name of the syndrome

|-
| SYNDROME
|
| begins definition of a syndrome for poison use
|}

<div align="center">
{{alphabetical TOC}}
</div>

==T==
{| {{prettytable}}
|- bgcolor="#ddd"
! width="20%" | Token
! width="20%" | Arguments
! width="60%" | Description
|-
| TENDONS
|
*selection criteria. Often LOCAL_CREATURE_MAT, although other selection criteria may work too.
*selected tissue
*healing rate
| Defines the material and healing rare of tendons.

|-
| THICKWEB
|
| The creature's webs can catch larger creatures. May imply [AMBUSHPREDATOR].

|-
| TISSUE
| name
| Begins defining a tissue in the creature file.

|-
| TISSUE_LAYER
|
*BY_TYPE, BY_CATEGORY, BY_TOKEN
*TYPE,CATEGORY, or TOKEN
*TISSUE
*LOCATION
| Adds the tissue layer to wherever it is required.
Non-argument Locations can be FRONT, RIGHT, LEFT, TOP, BOTTOM. Argument locations are AROUND and CLEANS, requiring a further body part and a % of coverage/cleansing

|-
| TISSUE_LAYER_UNDER
|
*BY_TYPE, BY_CATEGORY, BY_TOKEN
*TYPE,CATEGORY, or TOKEN
*TISSUE
*LOCATION
| Adds the tissue layer under a given part ex. is Iron Man he has a gaseous poison within him and this tissue (GAS is its name) has the token [TISSUE_LEAKS] and its state is GAS so when you puncture the iron outside and damage this tissue it leaks gas (can have a syndrome by using a previous one in the creature sample.) [TISSUE_LAYER_UNDER:BY_CATEGORY:ALL:{tissue}] {tissue} is what will be under the TISSUE_LAYER here is an example Tissue from Iron Man
[TISSUE:GAS]
[TISSUE_NAME:gas:NP]
[TISSUE_MATERIAL:LOCAL_CREATURE_MAT:GAS]
[TISSUE_MAT_STATE:GAS]
[RELATIVE_THICKNESS:50]
[TISSUE_LEAKS]
[TISSUE_SHAPE:LAYER]

|-
| TISSUE_LAYER_APPEARANCE_MODIFIER
|
*QUALITY
*lowest:lower:low:median:high:higher:highest
| sets the range of qualities, including LENGTH, DENSE, HIGH_POSITION, CURLY, GREASY, WRINKLY

|-
| TISSUE_STYLE_UNIT
|
*tissue
*shaping
| sets tissue to be in a certain shape, mostly used with tissues HAIR, BEARD, MOUSTACHE, SIDEBURNS.

|-
| TL_COLOR_MODIFIER
| COLOR:freq:COLOR:freq etc
| Creates a list of color patterns, giving each a frequency.

|-
| TL_MAJOR_ARTERIES
|
| Gives Major Artery attribute to selected layers.

|-
| TL_PAIN_RECEPTORS
|
*new pain receptor number?
| Seems to set new number of pain receptors for selected tissue layers

|-
| TL_RELATIVE_THICKNESS
|
*new relative thickness?
| Seems to set new relative thickness for selected tissue layers

|-
| TL_VASCULAR
|
*new VASCULAR value?
| Seems to set new a VASCULAR value (which modulates bleeding) for selected tissue layers

|-
| TLCM_GENETIC_MODEL
|
| tissue layer color modifier is passed to offspring genetically?

|-
| TLCM_IMPORTANCE
|
*number
| Presumably modifies the importance of the tissue layer color modifier, for description purposes.
HOWEVER using this appears to remove all mention of colour from creature descriptions. It does not appear in any default creatures.

|-
| TLCM_NOUN
|
*name
*SINGULAR or PLURAL
| names the tissue layer color modifier, and determines the noun

|-
| TLCM_TIMING
|
*ROOT
*start change window years:days:end change window years:days
| determines the point in the creature's life where the color change begins

|-
| TRADE_CAPACITY
|
| How much the creature can carry when used by merchants.

|-
| TRAINABLE
|
| Implies both [TRAINABLE_HUNTING] and [TRAINABLE_WAR].

|-
| TRAINABLE_HUNTING
|
| Can be trained as hunting beasts by way of kennels.

|-
| TRAINABLE_WAR
|
| Can be trained as war beasts by way of kennels.

|-
| TRANCES
|
| Allows the creature to go into martial trances.

|-
| TRAPAVOID
|
| The creature is immune to traps. Probably every procedurally generated megabeast has this.

|-
| TRIGGERABLE_GROUP
| min:max
| A large swarm of vermin can be disturbed, usually in Adventure mode.{{verify}}

|-
| TSU_NOUN
|
*noun
*SINGULAR or PLURAL
| Noun for the TISSUE_STYLE_UNIT, used in the description of the tissue layer's style.
|}

<div align="center">
{{alphabetical TOC}}
</div>

==U==
{| {{prettytable}}
|- bgcolor="#ddd"
! width="20%" | Token
! width="20%" | Arguments
! width="60%" | Description

|-
| UBIQUITOUS
|
| Creature will occur in every region with the correct biome. Does not apply to evil/good tags.

|-
| UNDERGROUND_DEPTH
|
*mindepth
*maxdepth
| Depth the creature appears underground. Numbers can be from 1 to 5. Only magma creatures use 4 or 5 in the default raws. A single argument may be used instead of min and max. Dwarven civilizations will only export (via the embark screen or caravans) things that available at depth 1.

|-
| UNDERSWIM
|
| Creature swims under the water and can't be seen.{{verify}}

|-
| UNIQUE_DEMON
|
| Typically found on genned [[demon]]s; sets the creature as capable of "emerging from the underworld" and taking over during worldgen.

|-
| USE_CASTE
|
*caste token
|

|-
| USE_MATERIAL
|
*new material token
*old material id
| Uses a local creature mat to define a new material?{{verify}}

|-
| USE_MATERIAL_TEMPLATE
|
*new material token
*material template
| Loads a material, and gives it a shortname for later reference

|-
| USE_TISSUE
|
*new tissue token
*old tissue id
| Uses a local creature mat to define a new material?{{verify}}

|-
| USE_TISSUE_TEMPLATE
|
*new tissue token
*tissue template
| Loads a tissue template listed in OBJECT:TISSUE_TEMPLATE files, such as tissue_template_default.txt.

|-
| UTTERANCES
|
| Changes the language of the creature into an unintelligible mess.
|}

<div align="center">
{{alphabetical TOC}}
</div>

==V==
{| {{prettytable}}
|- bgcolor="#ddd"
! width="20%" | Token
! width="20%" | Arguments
! width="60%" | Description
|-
| VEGETATION
|
| unknown

|-
| VIEWRANGE
| value
| Value should determine how close you have to get to a critter before it attacks (or prevents adv mode travel etc.) Default is 20.

|-
| VERMIN_BITE
|
*amount
*verb (bitten, stung)
*LOCAL_CREATURE_MAT
*MATERIAL
| vermin bites, and injects something.

|-
| VERMIN_EATER
|
| Vermin can nibble food?{{verify}}

|-
| VERMIN_FISH
|
| Acts like a fish

|-
| VERMIN_GROUNDER
|
| The creature can be picked up if you stand over it. (Requires confirmation)
'I think this is a habitat flag like VERMIN_SOIL, VERMIN_CHASM, etc. It seems to appear on creatures that don't otherwise have one. – Peristarkawan 17:27, 24 May 2007 (EDT)'

|-
| VERMIN_HATEABLE
|
| Some dwarves will hate the creature and get unhappy thoughts when around it.

|-
| VERMIN_MICRO
|
| This makes the creature move in a swarm of creatures of the same race as it. I.E. Swarm of flies, swarm of ants, etc.

|-
| VERMIN_NOFISH
|
| The creature cannot be caught by fishing.

|-
| VERMIN_NOROAM
|
| The creature will not be observed randomly roaming about the map.

|-
| VERMIN_NOTRAP
|
| The creature cannot be caught by trappers or animal traps. However, this may not work in all cases, as both dragonflies and fairies can be caught by trappers. This is possibly overridden by the VERMIN_GROUNDER token, allowing trappers set to Catch a Live Land Animal to pick up and thus trap the animal. (speculation by Flippantelf 04:45, 15 June 2009 (UTC))

|-
| VERMIN_ROTTER
|
| Present on flies, knuckle worms, acorn flies, and blood gnats. Probably means either the creature is attracted to rot, the creature speeds rotting, or both.

|-
| VERMIN_SOIL
|
| The creature randomly appears near dirt or mud.

|-
| VERMIN_SOIL_COLONY
|
| The vermin will appear in a single tile cluster of many vermin, such as a colony of ants.

|-
| VERMINHUNTER
|
| A creature with this tag will hunt down vermin and kill them. Sometimes they will eat the vermin, but most of the time they will bring it to their owner. This tag also makes impossible to assign an owner to the animal. The animal chooses it's own owner instead (like a cat). If assigned to a playable race, members of that race will ONLY be able to eat vermin.

|-
| VESPERTINE
|
| Sets if the creature is active in evening.
|}

<div align="center">
{{alphabetical TOC}}
</div>

==W==
{| {{prettytable}}
|- bgcolor="#ddd"
! width="20%" | Token
! width="20%" | Arguments
! width="60%" | Description
|-
| WAGON_PULLER
|
| Allows the creature to pull caravan wagons.

|-
| WEBBER
|
*LOCAL_CREATURE_MAT
*MATERIAL (eg SILK)
| allows the creature to web, and defines what the webs are made of.

|-
| WEBIMMUNE
|
| The creature will not get caught in webs.
|}

{{Category|Modding}}
{{Category|Tokens}}

v0.31:Creature token

2011-02-21T07:40:04Z

Bohandas: Added minor clarification to POP_RATIO tag. Also added note for frequency tag that it is "Not to be confused with POP_RATIO"

{{av}}{{Quality|Exceptional}}

Tentative at best in some cases.

__NOTOC__

<div align="center">
{{alphabetical TOC}}
</div>

==A==
{| {{prettytable}}
|- bgcolor="#ddd"
! width="20%" | Token
! width="20%" | Arguments
! width="60%" | Description
|-
| ALCOHOL_DEPENDENT
|
| Creature needs alcohol to get through the working day.

|-
| ALL_ACTIVE
|
| Sets if the creature is active in day, night, and twilight. Seems to be a separate value from DIURNAL/NOCTURNAL/CREPUSCULAR, rather than implying them.

|-
| ALTTILE
|
| If set, the creature will blink between its [TILE] and its [ALTTILE].

|-
| AMBUSHPREDATOR
|
| Makes the creature start out hidden. Used by {{L|giant cave spider}}s. May make {{L|web}}s hidden too.

|-
| AMPHIBIOUS
|
| Allows a creature to breathe with or without {{L| water}}. Implies [AQUATIC].

|-
| APP_MOD_DESC_RANGE
| ?
| ?

|-
| APP_MOD_GENETIC_MODEL
|
|

|-
| APP_MOD_IMPORTANCE
|
*number
| Determines how important the appearance modifier is, for determining whether it shows up in the creature description.{{verify}}

|-
| APP_MOD_NOUN
|
*noun
*SINGULAR or PLURAL
| creates a noun for the appearance and whether it is singular or plural

|-
| APP_MOD_RATE
|
*Rate (integer)
*Scale (DAILY, YEARLY)
*min:max of growth
*start year:start day
*end year:end day
| setting the growth rate of the modifier. The last two tokens can be replaced by NO_END to have growth continue indefinitely.

|-
| APPLY_CREATURE_VARIATION
|
*CV TEMPLATE NAME
| Loads the Creature Variation Template specified.

|-
| APPLY_CURRENT_CREATURE_VARIATION
|
| Applies loaded Creature Variation

|-
| AQUATIC
|
| Allows a creature to breathe underwater, but causes it to "drown" out of {{L| water}}.

|-
| ARENA_RESTRICTED
|
| Does not appear in arena mode list

|-
| ARTIFICIAL_HIVEABLE
|
| Can be kept in artificial hives by beekeepers.

|-
| ATTACK
|
*token
*bodypart
*selection criteria
*location
| Defines the attack name, and the body part used.
'''Example:'''<br />
[ATTACK:GORE:BODYPART:BY_CATEGORY:HORN]<br />
''GORE'' : name of the attack<br />
''BODYPART:BY_CATEGORY:HORN'' : the horn is used to attack (presuming the creature has one)

|-
| ATTACK_CONTACT_PERC
|
*% value
| amount of available tissue used in attack

|-
| ATTACK_FLAG_CANLATCH
|
| Enables an attacker to occasionally latch on with the bodypart used by an attack when an attack with this flag in it's definition is made.

|-
| ATTACK_FLAG_EDGE
|
| attack type

|-
| ATTACK_FLAG_WITH
|
| In adventure mode, displays the name of the body part used by an attack when announcing the attack.

|-
| ATTACK_PENETRATION_PERC
|
*% value
| probably amount of material that makes contact when penetration is done

|-
| ATTACK_PRIORITY
|
*MAIN or SECOND
| use of the attack in combat. Secondary attacks are only used if main attacks are impossible.

|-
| ATTACK_SKILL
|
*skill used ({{L|Skill tokens}})
| defines the attack skill used

|-
| ATTACK_TRIGGER
| pop:exported wealth:created wealth{{verify}}
| stages when a megabeast will attack a site

|-
| ATTACK_VERB
| 2nd person:3rd person
| descriptive text for the attack

|-
| ATTACK_VELOCITY_MODIFIER
| number
| Modifies the attack velocity. Believed to be percent based (so 100 would be "normal"). May be on same scale as weapon velocity (where 1000 is "normal").

|}

<div align="center">
{{alphabetical TOC}}
</div>

==B==
{| {{prettytable}}
|- bgcolor="#ddd"
! width="20%" | Token
! width="20%" | Arguments
! width="60%" | Description
|-
| BABY
| integer
| age at which creature is considered a child. Default is zero. One can think of this as the duration of the baby stage.

|-
| BABYNAME
| singular:plural
| name at caste level

|-
| BEACH_FREQUENCY
|
| {{L|Whale}}s and {{L|Sea nettle jellyfish|jellyfish}} have this. Controls the beaching frequency of the creature.

|-
| BENIGN
|
| Determines whether creature can show up on "tame" maps (includes {{L|elephants}}), which will generally avoid dwarves, although they may chase and/or attack them if they get too close).

|-
| BIOME
|
* biome token
| Select a {{L|Biome}} the creature may appear in.

|-
| BLOOD, PUS, OTHER MATERIAL state definition
|
*selection criteria. Often LOCAL_CREATURE_MAT, although other selection criteria may work too.
*selected material
*matter state (LIQUID, GAS, ALL_SOLID)
| Controls bleeding behaviour

|-
| BODY
| body parts
| Draws body parts from OBJECT:BODY files (such as body_default.txt)
'''Example:'''<br />
[BODY:BODY_WITH_HEAD_FLAG:HEART:GUTS:BRAIN:MOUTH] <br />
This is the body from a {{L|Purring maggot}}. It creates a body with head, a heart, some guts, a brain, and a mouth. Thats all a maggot needs.

|-
| BODY_APPEARANCE_MODIFIER
|
*ATTRIBUTE
*lowest:lower:low:median:high:higher:highest
| These body modifiers give individual creatures different characteristics. In the case of HEIGHT, BROADNESS and LENGTH, the modifier is also a percentage change to the BODY_SIZE of the individual creature. The seven numbers afterward give a distribution of ranges. Each interval has an equal chance of occurring.
'''Example:'''<br />
[BODY_APPEARANCE_MODIFIER:LENGTH:90:95:98:100:102:105:110] <br />
''HEIGHT'' : marks the height to be changed <br />
''90:95:98:100:102:105:110'' : sets the range from the shortest (90% of the average height) to the tallest (110% of the average height) creature variation.

|-
| BODY_DETAIL_PLAN
| PlanName, PlanName:type:type:type:etc
| loads a plan listed OBJECT:BODY_DETAIL_PLAN files, such as b_detail_plan_default.txt. Mass applies USE_MATERIAL_TEMPLATE, mass alters RELSIZE, alters body part positions, and will allow tissue layers to be defined. Tissue layers are defined in order of skin to bone here.
'''Example:'''<br />
[BODY_DETAIL_PLAN:VERTEBRATE_TISSUE_LAYERS:SKIN:FAT:MUSCLE:BONE:CARTILAGE] <br />
This creates the detailed body of a {{L|fox}}, the skin, fat, muscle, bones and cartilage out of the vertebrate tissues.<br />
A {{L|Purring maggot|maggot}} would only need:<br />
''[BODY_DETAIL_PLAN:EXOSKELETON_TISSUE_LAYERS:SKIN:FAT:MUSCLE]''

|-
| BODY_SIZE
| years:days:size
| sets up size at a given time. Size is roughly equal to the creature's average weight in grams.
'''Example:'''<br />
[BODY_SIZE:0:0:10000]<br />
[BODY_SIZE:1:168:50000]<br />
[BODY_SIZE:12:0:220000]<br />
This describes the size of a {{L|minotaur}}. His birth size would be 10000 (~10 kg). With 1 year and 168 days he would be 50000 tall (~50 kg). As an adult (with 12 years) he would weight roughly 220 kg

|-
| BODYGLOSS
| gloss
| Substitutes body part text with replacement text. Draws gloss information from OBJECT:BODY files (such as body_default.txt)

|-
| BONECARN
|
| Creature 'eats' bones. Eating bones makes their happiness go up, but can cause death (suffocation){{verify}}. Implies CARNIVORE.

|-
| BP_APPEARANCE_MODIFIER
|
*QUALITY
*lowest:lower:low:median:high:higher:highest
| sets up the breadth of possibilities for appearance qualities for a selected BP group. EG. Eyes (CLOSE_SET, DEEP_SET, ROUND_VS_NARROW, LARGE_IRIS),Lips (THICKNESS), Nose (BROADNESS, LENGTH, UPTURNED, CONVEX), Ear (SPLAYED_OUT, HANGING_LOBES, BROADNESS, HEIGHT), Tooth (GAPS), Skull (HIGH_CHEEKBONES, BROAD_CHIN, JUTTING CHIN, SQUARE_CHIN), Neck (DEEP_VOICE, RASPY_VOICE), Head (BROADNESS, HEIGHT)

|-
| BUILDINGDESTROYER
| 1 or 2
| Allows a creature to destroy furniture and buildings. Value [1] targets mostly doors, hatches, furniture and the like. Value [2] targets anything not made with the b + C commands.
|}

<div align="center">
{{alphabetical TOC}}
</div>

==C==
{| {{prettytable}}
|- bgcolor="#ddd"
! width="20%" | Token
! width="20%" | Arguments
! width="60%" | Description

|-
| CAN_LEARN
|
| The creature gets skills and professions. Note that this token makes the creature unable to be butchered by an adventurer so it is not recommended for uncivilized monsters. Adventurers lacking this token can allocate but not increase attributes and skills. skills allocated will disappear on start.

|-
| CAN_SPEAK
|
| Can talk. Note that it is not necessary for a creature to gain social skills.

|-
| CANNOT_UNDEAD
|
| Cannot be turned into a zombie or skeletal undead

|-
| CANOPENDOORS
|
| Allows the creature to open doors.

|-
| CARNIVORE
|
| Creature ''only'' eats meat

|-
| CASTE
|
*name
| defines a caste

|-
| CASTE_ALTTILE
|
*tile number or "letter"
| Caste-specific alternate tile. Expects CASTE_TILE

|-
| CASTE_COLOR
|
*fg
*bg
*brightness
| Creature tile color of the caste.

|-
| CASTE_GLOWCOLOR
|
*fg
*bg
*brightness
| GLOWTILE color of the caste.

|-
| CASTE_GLOWTILE
|
*tile value or "letter"
| Caste-specific glowtile

|-
| CASTE_NAME
| singular:plural:adjective
| The name of the caste of the creature in the game.

|-
| CASTE_PROFESSION_NAME
|
*Profession
*singular
*plural
| alters the name of the given profession, caste-specific

|-
| CASTE_SOLDIER_ALTTILE
| 'character' or tile number
| Creatures of this caste active in their civilization's military will blink between their default tile and this one.

|-
| CASTE_SOLDIER_TILE
| 'character' or tile number
| Creatures of this caste active in their civilization's military will use this tile instead.

|-
| CASTE_SPEECH
| speech file?
| Possibly a caste-specific instance of the SPEECH token

|-
| CASTE_TILE
|
* tile number or "letter"
| Caste-specific creature tile.

|-
| CAVE_ADAPT
|
| Gives the creature a bonus in caves. Also causes [[Cave adaptation]].

|-
| CE_X
|
*SEV:<value> (severity, higher is worse)
*PROB:<value(1-100)> (probability)
*RESISTABLE (optional) allows resistance
*SIZE_DILUTES (optional) lessens effect based on size
Place effected:
*LOCALIZED (optional)
*VASCULAR_ONLY (optional)
*MUSCULAR_ONLY (optional)
*BP:(select BY_CATEGORY, BY_TYPE, or BY_TOKEN):category, type or token:tissues affected (specific or ALL) (optional)
Timeline:
*Start:effect start time
*Peak:effect peak time
*End:effect end time
| Specifies the way that a syndrome affects a creature -- more detail can be found on the [[Syndrome#Creature effect tokens|Syndromes page]]

|-
| CHANGE_BODY_SIZE_PERC
|
|

|-
| CHILD
| integer
| age at which creature is considered an adult. One can think of this as the duration of the child stage. Without this token, a creature will not reproduce in Fortress mode.

|-
| CHILD_BODYPART_GROUP
|
*master selection, BY_CATEGORY, BY_TYPE, BY_TOKEN.
*master location
*specific selection, BY_CATEGORY, BY_TYPE, BY_TOKEN.
*specific location
| selects all parts of a group to be used.

|-
| CHILDNAME
| singular:plural
| name at caste level

|-
| CLUSTER_NUMBER
|
*min
*max
| The minimum/maximum numbers of how many creatures per spawned cluster. Certain vermin fish use this token in combination with temperate ocean and river biome tokens to perform seasonal migrations.
e.g. [CLUSTER_NUMBER:1:3]

|-
|CLUTCH_SIZE
|
*min
*max
|Number of eggs laid in one sitting.

|-
| COLDDAM_POINT
| value
| The minimum temperature limit before the currently selected material will start receiving damage from freezing. Used mostly in material templates.

|-
| COLONY_EXTERNAL
|
| Caste hovers around colony.

|-
| COLOR
| foreground:background:brightness
| Color of the creature's tile.

|-
| COMMON_DOMESTIC
|
| Allows the creature to be brought with immigrants and when creating a new fortress, as long as the creature also includes at least one of the following tokens: PET, PACK_ANIMAL, WAGON_PULLER, MOUNT. In addition, the creature must be NATURAL rather than FANCIFUL

|-
| CONVERTED_SPOUSE
|
| Found only at caste level. Creatures of this caste's species with the SPOUSE_CONVERTER and NIGHT_CREATURE_HUNTER tokens will kidnap SPOUSE_CONVERSION_TARGETs of an appropriate sex and convert them into castes with CONVERTED_SPOUSE.

|-
| COOKABLE_LIVE
|
| Set this to allow the creature to be cooked in meals without first being butchered / fishcleaned.

|-
| COPY_TAGS_FROM
|
*CREATURE NAME
| Copies tags from another specified creature.

|-
| CREATURE
| name
| begins defining a new creature with the specified name.

|-
| CREATURE_CLASS
|
*classname
| Creature class. Can be anything, but only existing use is GENERAL_POISON. Appears to only be used for Syndromes. Supposedly can also be used for entity positions.

|-
| CREATURE_SOLDIER_TILE
| 'character' or tile number
| Creatures active in their civilization's military will use this tile instead.

|-
| CREATURE_TILE
| 'character' or tile number
| The symbol of the creature in ASCII mode.

|-
| CREPUSCULAR
|
| Sets if the creature is active at twilight. This tag functions as a combination of the two tags VESPERTINE and MATUTINAL.

|-
| CURIOUSBEAST_EATER
|
| Allows a creature to steal and eat edible items from a site.

|-
| CURIOUSBEAST_GUZZLER
|
| Allows a creature to (very quickly) drink your alcohol. Or spill the barrel to the ground. Also affects undead versions of the creature.

|-
| CURIOUSBEAST_ITEM
|
| Allows a creature to steal things (apparently the highest value it can find). Semimegabeast thievery is in Legends mode. Lightweight creatures can probably steal heavy items.

|-
| CV_ADD_TAG
|
*TAG NAME
| Adds a tag. Used in conjunction with creature variation templates.

|-
| CV_REMOVE_TAG
|
*TAG NAME
| Removes a tag. Used in conjunction with creature variation templates.
|}

<div align="center">
{{alphabetical TOC}}
</div>

==D==
{| {{prettytable}}
|- bgcolor="#ddd"
! width="20%" | Token
! width="20%" | Arguments
! width="60%" | Description

|-
| DEMON
|
| Typically found on genned [[demon]]s; sets the creature as a potential spawn for [[Hidden Fun Stuff]]

|-
| DESCRIPTION
| text
| A brief description of the creature type.

|-
| DIE_WHEN_VERMIN_BITE
|
| Dies upon attacking. Used for bee stings.

|-
| DIFFICULTY
| integer
| Toady: "Difficulty determines how deep it places them in adventure mode/reclaim caves, and the chance that they are wounded the first few river attacks." Also increases experience gain during adventure mode.

|-
| DIURNAL
|
| Sets if the creature is active in day.

|-
| DOES_NOT_EXIST
|
| Creature does not actually exist; used for fanciful creatures.

|-
| DRAGONFIREBREATH
|
| Creature breathes fire in a cone.
|}

<div align="center">
{{alphabetical TOC}}
</div>

==E==
{| {{prettytable}}
|- bgcolor="#ddd"
! width="20%" | Token
! width="20%" | Arguments
! width="60%" | Description

|-
| EGG_MATERIAL
|
*LOCAL_CREATURE_MAT
*EGGSHELL/EGG_WHITE/EGG_YOLK
*state (solid, liquid, or gas)
| Egg material. Eggs will be made out of eggshell. Edibility is determined by tags on whites or yolk, but they otherwise do not exist.

|-
| EGG_SIZE
|
*size
| Size of creature's egg?

|-
| EQUIPMENT_WAGON
|
| Makes the creature into a large 3x3 creature responsible for carrying trade goods, pulled by two [WAGON_PULLER]s and driven by a merchant.

|-
| EQUIPS
|
| Allows the creature to wear or wield items.

|-
| EVIL
|
| Determines whether creature can show up on "evil" maps

|-
| EXTRAVISION
|
| Creature can see regardless of whether it has working eyes.
|}

<div align="center">
{{alphabetical TOC}}
</div>

==F==
{| {{prettytable}}
|- bgcolor="#ddd"
! width="20%" | Token
! width="20%" | Arguments
! width="60%" | Description
|-
| FANCIFUL
|
| Makes every civilization know about the creature. The creature won't occur in regular material preference lists. The tag also adds some art value modifiers. Used for things like dragons and other legendary creatures.

|-
| FEATURE_ATTACK_GROUP
|
| Found on subterranean animalmen.

|-
| FEMALE
|
| Inside a female caste, sets femaleness. Outside of a caste, sets all individuals female unless overridden by caste.

|-
| FIREBREATH
|
| The creature breathes fire projectiles (as opposed to DRAGONFIREBREATH, which is in a cone).

|-
| FIREIMMUNE
|
| As of version v0.28.181.40d, the FIREIMMUNE token had no effect on a creature's resistance to flame or heat. However, it did affect ability to swim in magma in adventure mode, as well as display of "You are caught in a pool of magma!" warning messages. It is unknown if these effects persist in DF 2010.

|-
| FIREIMMUNE_SUPER
|
| The creature is immune to DRAGONFIREBREATH. Implies FIREIMMUNE.

|-
| FISHITEM
|
| Needs to be cleaned at a fishery

|-
| FIXED_TEMP
| temperature
| The natural heat generated by the creature.

|-
| FLEEQUICK
|
| Determines how soon a creature flees in a losing battle.

|-
| FLIER
|
| Allows a creature to fly. Fortress Mode pathfinding only partially incorporates pathfinding - flying dwarves need a land path to exist between them and an area in order to access it, but as long as one such path exists, they do not need to use it, instead being able to fly over intervening obstacles.

|-
| FREQUENCY
|
*number, max 100
| Determines the time between creature spawns in Fortress Mode. Higher is more occurrences per time unit. Creatures without a frequency statement default to 50. Almost all others have either [FREQUENCY:5] or [FREQUENCY:100]. Not to be confused with POP_RATIO
|}

<div align="center">
{{alphabetical TOC}}
</div>

==G==
{| {{prettytable}}
|- bgcolor="#ddd"
! width="20%" | Token
! width="20%" | Arguments
! width="60%" | Description
|-
| GENERAL_BABY_NAME
| singular:plural
| name at creature level

|-
| GENERAL_CHILD_NAME
| singular:plural
| name at creature level

|-
| GENERATED
|
| Found on procedurally generated creatures like [[Forgotten beast]]s, (biome name) titans and [[Demon]]s.

|-
| GETS_INFECTIONS_FROM_ROT
|
| creature can be infected by rot

|-
| GETS_WOUND_INFECTIONS
|
| creature can get infections from wounds

|-
| GLOWCOLOR
|
*foreground
*background
*brightness
| The colour of the GLOWTILE of the creature.

|-
| GLOWTILE
| ascii character
| If present, the being glows in the dark (generally used for Adventure Mode). The tile is what replaces the being's current tile when it is obscured from your sight by darkness. The default setting for kobolds (a yellow quotation mark) provides a nice "glowing eyes" effect. The game is also hardcoded to automatically convert quotation mark GLOWTILES into apostrophes if the creature has lost one eye. This works at the generic creature level - for caste-specific glow tiles, use CASTE_GLOWTILE instead.

|-
| GNAWER
| verb (gnawed)
| The creature chews on food barrels and bags.

|-
| GO_TO_END
|
| uncertain use, definitely refers to Creature Variants template

|-
| GO_TO_START
|
| uncertain use, definitely refers to Creature Variants template

|-
| GOOD
|
| Determines whether creature can show up on "good" areas. Eg. unicorn.

|-
| GRASSTRAMPLE
| value
| Determines the percentage chance of trampling and killing grass when a creature steps on it. Set [GRASSTRAMPLE:0] to make grass never trampled by the creature.

|-
| GRAVITATE_BODY_SIZE
|
| Creature Variants template command, alter body size.

|-
| GRAZER
|
*number
| Animals is a grazer. The higher the number, the less grass it needs.
|}

<div align="center">
{{alphabetical TOC}}
</div>

==H==
{| {{prettytable}}
|- bgcolor="#ddd"
! width="20%" | Token
! width="20%" | Arguments
! width="60%" | Description
|-
| HABIT
| type:probability
| Defines certain behaviors for the creature. The habit types are COLLECT_TROPHIES, COOK_PEOPLE, COOK_VERMIN, GRIND_VERMIN, COOK_BLOOD, GRIND_BONE_MEAL, EAT_BONE_PORRIDGE, USE_ANY_MELEE_WEAPON, and COLLECT_WEALTH. These may require the creature to have a lair to work properly.

|-
| HABIT_NUM
| number or TEST_ALL
| Unknown. All lists of HABITs are preceded by [HABIT_NUM:TEST_ALL]

|-
| HAS_NERVES
|
| This makes the creature susceptible to severed motor and sensory nerves when muscles are torn in limb, grasp and stance parts. Some butchering yields nervous tissue.

|-
| HEATDAM_POINT
| value
| The maximum temperature limit before the currently selected material will start receiving damage from heat. Used mostly in material templates.

|-
| HIVE_PRODUCT
|
*number
*time
*item tokens
| What product is harvested from beekeeping.

|-
| HOMEOTHERM
|
| Default 'NONE'. The creature's normal body [[DF2010:Temperature |temperature]]
|}

<div align="center">
{{alphabetical TOC}}
</div>

==I==
{| {{prettytable}}
|- bgcolor="#ddd"
! width="20%" | Token
! width="20%" | Arguments
! width="60%" | Description
|-
| IF_EXISTS_SET_BOILING_POINT
| value
| The temperature at which the creature boils into gases.

|-
| IF_EXISTS_SET_MELTING_POINT
| value
| The temperature at which the creature will melt into goo.

|-
| IGNITE_POINT
| value
| The temperature at which the creature will burst into flames.

|-
| IMMOBILE_LAND
|
| The creature is immobile while on land. Only works on AQUATIC creatures which can't breath on land.

|-
| IMMOLATE
|
| Will ignite, and potentially completely destroy, items the creature is standing on. Keep booze away from critters with this tag.

|-
| INSULATION
| value
| increases the insulation of a selected material (usually hair, feathers or skin)

|-
| INTELLIGENT
|
| Implies CAN_SPEAK and CAN_LEARN. CAN_LEARN probably means the creature gets skills and professions. Not recommended for uncivilized monsters.

|-
| ITEMCORPSE
|
* [[Item token]]
* subtype
NO_SUBTYPE
* matgloss token
* NO_RACEGLOSS
USE_RACEGLOSS USE_SHARPSTONE
| Determines if the creature leaves behind a non-standard corpse (i.e. wood, statue, bars, ash from ghost etc). The first parameter determines the item type; the second parameter is the subtype indicated in the raw file (such as WEAPON_WHIP); the third indicates the material type if the item type takes a specific material (e.g. ""IRON"" if the corpse type is ""STATUE""). USE_RACEGLOSS applies if the creature has a material glossary assigned by the ""HAS_RACEGLOSS:"" flag and will select necessary adjectives and material from that glossary.
As of 31_01, RACEGLOSS may no longer be in the game.{{verify}}

|-
| ITEMCORPSE_QUALITY
|
| The quality of an item-type corpse left behind; 5 is masterpiece-level.
|}

<div align="center">
{{alphabetical TOC}}
</div>

==L==
{| {{prettytable}}
|- bgcolor="#ddd"
! width="20%" | Token
! width="20%" | Arguments
! width="60%" | Description
|-
| LAIR
| type:probability
| Found on megabeasts, semimegabeasts, and night creatues. The creature will seek out sites of this type and take them as lairs. The lair types are SIMPLE_BURROW, SIMPLE_MOUND, SHRINE, and LABYRINTH.

|-
| LAIR_CHARACTERISTIC
| characteristic:probability
| Defines certain features of the creature's lair. The only known valid characteristic is HAS_DOORS.

|-
| LAIR_HUNTER
|
| This creature will actively hunt adventurers in its lair.

|-
| LAIR_HUNTER_SPEECH
| speech file
| What this creature says while hunting adventurers in its lair.

|-
| LARGE_PREDATOR
|
| Will attack things that are smaller than it (like dwarves). Only one group of "large predators" will appear on any given map (possibly two groups on "savage" maps). In adventure mode, large predators will try to ambush and attack you (and your party will attack them back). Also, they can be mentioned in the intro paragraph when starting a fortress e.g. "ere the wolves get hungry."

|-
| LARGE_ROAMING
|
| In Fortress Mode, spawns outdoors and is not a vermin creature.

|-
| LAYS_EGGS
|
| Creature lays eggs instead of giving birth to live young.

|-
| LAYS_UNUSUAL_EGGS
| Item tokens
| Creature lays a particular item instead of regular eggs. As of v0.31.19, this tag only makes the game crash.

|-
| LIGAMENTS
|
*selection criteria. Often LOCAL_CREATURE_MAT, although other selection criteria may work too.
*selected material. Almost always SINEW of the creature's materials.
*healing rate
| defines the material and healing rate of ligaments.

|-
| LIGHT_GEN
|
| The creature will generate light, such as in adventurer mode at night.

|-
| LIKES_FIGHTING
|
| The creature will attack enemies rather than flee from them. This tag has the same effect on player-controlled creatures - included modded dwarves.

|-
| LISP
|
| Creature multiplies 'S' when talking. Ex: "My name isss Recisssiz."

|-
| LITTERSIZE
|
* minumum
* maximum
| Determines the random chance of how many creatures are generated when giving birth. [LITTERSIZE:1:2]

|-
| LOCKPICKER
|
| Lets a creature open doors that are set to forbidden in Fortress Mode.

|-
| LOOSE_CLUSTERS
|
| The creatures will scatter if they have this tag, or form tight packs if they don't.
|}

<div align="center">
{{alphabetical TOC}}
</div>

==M==
{| {{prettytable}}
|- bgcolor="#ddd"
! width="20%" | Token
! width="20%" | Arguments
! width="60%" | Description

|-
| MAGMA_VISION
|
| Creature's able to see while covered in magma.

|-
| MALE
|
| all male

|-
| MANNERISM_??
|
*occassionally body part
| Adds a possible mannerism to the creature's profile.
Refer to {{L|Creature Token Mannerisms|Mannerisms}}

|-
| MATERIAL
|
*material id
| Begins defining a new material.{{verify}}

|-
| MATERIAL_BREATH_ATTACK
|
*MATERIAL TYPE (TISSUE, INORGANIC)
*MATERIAL NAME
*MATERIAL STATE (TRAILING_DUST_FLOW, TRAILING_VAPOR_FLOW, TRAILING_GAS_FLOW, SOLID_GLOB, LIQUID_GLOB, UNDIRECTED_GAS, UNDIRECTED_VAPOR, UNDIRECTED_DUST)
| Creates an attack referencing a material, using a given type of breath attack.

|-
| MAXAGE
| min:max
| range of time in which death from old age may occur

|-
| MEANDERER
|
| Gives a creature random movement.

|-
| MEGABEAST
|
| Appears on fortress territory in Fortress Mode occasionally. Implies SEMIMEGABEAST. Also can be worshipped

|-
|MENT_ATT_CAP_PERC
|
*ATTRIBUTE Token
*Cap %
|Default is 200. This means you can increase your attribute to 200% of its starting value (or the average value + your starting value if that is higher).

|-
| MENT_ATT_RANGE
|
*ATTRIBUTE
*lowest:lower:low:median:high:higher:highest | sets up a mental attribute's range of values. Max of 5000.

|-
| MENT_ATT_RATES
|
*ATTRIBUTE Token
*cost to improve
*unused counter rate
*rust counter rate
*demotion counter rate
| Attribute gain/decay rates. Defaults for are 500:2:3:2, except for RECUPERATION and DISEASE_RESISTANCE that don't have change rates. The last three slots may be replaced by NONE.

|-
| MILKABLE
|
*LOCAL_CREATURE_MAT:MILK:amount
| Allows the creature to be milked.

|-
| MISCHIEVIOUS
|
| Will pull any levers it comes across. Also makes creature spawn invisible and with several ranks in Ambusher. "They go on little missions to mess with various fortress buildings, not just levers."

|-
| MOUNT
|
| Creature may be used as a mount

|-
| MOUNT_EXOTIC
|
| You need the Dungeon master noble to mount the creature.

|-
| MULTIPLE_LITTER_RARE
|
| Makes litters with more than one offspring rare.

|-
| MULTIPLY_VALUE
|
*Multiplier
| multiplies value of materials

|-
| MUNDANE
|
| Marks if the creature is an actual real-life creature. Only used for age-names at present.
|}

<div align="center">
{{alphabetical TOC}}
</div>

==N==
{| {{prettytable}}
|- bgcolor="#ddd"
! width="20%" | Token
! width="20%" | Arguments
! width="60%" | Description
|-
| NAME
| singular:plural:adjective
| The generic name for any creature of this type - will be used when distinctions between caste are unimportant. For names for specific castes, use CASTE_NAME instead.

|-
| NATURAL
|
| Animal is considered to be natural.

|-
| NATURAL_SKILL
| skill:value
| The creature possesses this skill at this level inherently. It begins with this skill at this level, and the skill may never rust below this level.

|-
| NIGHT_CREATURE_BOGEYMAN
|
| Found on bogeymen. Presumably makes the creature attack the player at night in hordes like bogeymen do.

|-
| NIGHT_CREATURE_HUNTER
|
| If this creature has SPOUSE_CONVERTER, it will actively attempt to seek out potential conversion targets, abduct them, and convert them. Night creatures will seek out one SPOUSE_CONVERSION_TARGET of the opposite sex, convert them, and then have children with them. NIGHT_CREATURE_HUNTERs without SPOUSE_CONVERTER will not be placed.

|-
| NO_AUTUMN
|
| does not appear this season.

|-
| NO_DIZZINESS
|
| Creature cannot become dizzy

|-
| NO_DRINK
|
| Creature does not need to drink.

|-
| NO_EAT
|
| Creature does not need to eat.

|-
| NO_FEVERS
|
| Creature cannot suffer fevers

|-
| NO_SLEEP
|
| Creature does not need to sleep.

|-
| NO_SPRING
|
| does not appear this season.

|-
| NO_SUMMER
|
| does not appear this season.

|-
| NO_THOUGHT_CENTER_FOR_MOVEMENT
|
| Probably shorthand for movement being unaffected by damage in general.

|-
| NO_WINTER
|
| does not appear this season.

|-
| NOBONES
|
| Creature has no bones.

|-
| NOBREATHE
|
| Creature doesn't need to breathe or have [BREATHE] parts in body. Cannot drown or be strangled.

|-
| NOCTURNAL
|
| Sets if the creature is active in night.

|-
| NOEMOTION
|
| The creature has no emotions, and does not rage.

|-
| NOEXERT
|
| Creature can't become tired or over-exerted.

|-
| NOFEAR
|
| Creature doesn't feel fear and will never run away from battle.

|-
| NOMEAT
|
| Creature will not drop meat on butcher.

|-
| NONAUSEA
|
| Creature can't vomit.

|-
| NOPAIN
|
| Creature doesn't feel pain.

|-
| NOSKIN
|
| Creature will not drop skin on butcher.

|-
| NOSKULL
|
| Creature will not drop skull on butcher, rot, or decay of severed head.

|-
| NOSMELLYROT
|
| Does not produce miasma when rotting

|-
| NOSTUCKINS
|
| Weapons can't be stuck in creature.

|-
| NOSTUN
|
| Creature can't be stunned. Evidence suggests creatures with this tag never wake up from sleep in Fortress Mode.

|-
| NOT_BUTCHERABLE
|
| Cannot be butchered

|-
| NOTHOUGHT
|
| Creature doesn't think, or doesn't require a [BRAIN] body part.
|}

<div align="center">
{{alphabetical TOC}}
</div>

==P==
{| {{prettytable}}
|- bgcolor="#ddd"
! width="20%" | Token
! width="20%" | Arguments
! width="60%" | Description
|-
| PACK_ANIMAL
|
| Allows the creature to be used as a pack animal. Currently only used by merchants.

|-
| PARALYZEIMMUNE
|
| The creature is immune to all paralyzing special attacks.

|-
| PATTERNFLIER
|
|

|-
| PEARL
|
| Creature will generate pearls.

|-
| PENETRATEPOWER
| value
| Controls the ability of vermin to find a way into containers when they are eating food from your stockpiles. Wood and cloth objects roll a 0-9 and if it's greater than the penetrate power, their contents escape for the time being. Other objects roll a 0-99.

|-
| PERSONALITY
|
*ATTRIBUTE
*lowest:median:highest
| Determines the range and chance of personality traits. Standard is 0:50:100. See [[DF2010:Personality_trait|Personality traits]] for more info.

|-
| PET
|
| Allows the creature to be tamed.

|-
| PET_EXOTIC
|
| You need a Dungeon master noble in your fortress for the creature to be tamable (but any Animal trainer can do the taming).

|-
| PETVALUE
| value
| How valuable a tamed animal/pet is. Actual cost in points in the embarking screen is (PETVALUE/2)+1 for an untrained animal, PETVALUE+1 for a trained(War or Hunting) one. Note that for an animal to be selectable in this screen, it must have the COMMON_DOMESTIC token.

|-
|PHYS_ATT_CAP_PERC
|
*ATTRIBUTE Token
*Cap %
|Default is 200. This means you can increase your attribute to 200% of its starting value (or the average value + your starting value if that is higher).

|-
| PHYS_ATT_RANGE
|
*ATTRIBUTE
*lowest
*lower
*low
*median
*high
*higher
*highest
| sets up a physical attribute's range of values. Max of 5000.

|-
| PHYS_ATT_RATES
|
*ATTRIBUTE Token
*cost to improve
*unused counter rate
*rust counter rate
*demotion counter rate
| Attribute gain/decay rates. Defaults for are 500:2:3:2, except for RECUPERATION and DISEASE_RESISTANCE that don't have change rates. The last three slots may be replaced by NONE.

|-
| PLUS_BP_GROUP
|
*BY_TYPE, BY_CATEGORY, or BY_TOKEN
*body type, category, or token
| Adds a body part group to selected body part group.

|-
| PLUS_MATERIAL
|
*material
| Adds a material to selected materials.

|-
| PLUS_TISSUE_LAYER
|
*TISSUE
*BY_CATEGORY, BY_TYPE, BY_TOKEN
*Location - category, type, or token
| Adds a tissue to those selected

|-
| PLUS_TL_GROUP
|
*TISSUE
*BY_CATEGORY, BY_TYPE, BY_TOKEN
*Location - category, type, or token
*tissue
| continues a selection of tissue layers

|-
| POP_RATIO
|
| Weighted population of caste; Lower is rarer. Not to be confused with FREQUENCY.

|-
| POPULATION_NUMBER
| min:max
| The minimum/maximum numbers of how many of these creatures can show up on a map per year.

|-
|POWER
|
|Allows the being to represent itself as a deity. Requires CAN_SPEAK to actually do anything more than settle at a location.

|-
| PREFSTRING
| string
| Sets what other creatures like about this creature. "Urist likes dwarves for their beards." Multiple entries will be chosen from at random

|-
| PROFESSION_NAME
|
*Profession
*singular
*plural
| The generic name for members of this profession, at the creature level. In order to give members of specific castes different names for professions, use CASTE_PROFESSION_NAME instead.
|}

<div align="center">
{{alphabetical TOC}}
</div>

==R==
{| {{prettytable}}
|- bgcolor="#ddd"
! width="20%" | Token
! width="20%" | Arguments
! width="60%" | Description
|-
| RELSIZE
|
*BY_CATEGORY, BY_TYPE, BY_TOKEN
*body category, type, or token
*Relsize
| Specifies a new relative size for a part than what is stated in the body plan. For example, Dwarves have larger livers.

|-
| REMAINS_COLOR
|
|

|-
| REMAINS_ON_VERMIN_BITE_DEATH
|
| Leaves remains when its attack causes it to die? Seems to go with DIE_WHEN_VERMIN_BITE.

|-
| REMAINS_UNDETERMINED
|
|

|-
| REMOVE_MATERIAL
|
*material token
| Removes a material from a creature

|-
| REMOVE_TISSUE
|
*material token
| Removes a tissue from a creature.
|}

<div align="center">
{{alphabetical TOC}}
</div>

==S==
{| {{prettytable}}
|- bgcolor="#ddd"
! width="20%" | Token
! width="20%" | Arguments
! width="60%" | Description
|-
| SAVAGE
|
| Allows creature to show up on (and limits it to) "savage" maps.

|-
| SECRETION
|
*MATERIAL REF (eg LOCAL_CREATURE_MAT
*Material name
*Material State
*location secreted from (by_type, by_category, by_token)
*body part
*tissue layer
| creates a secreted material on given tissue on a given part of the body."

|-
| SELECT_ADDITIONAL_CASTE
|
*caste name
| adds an additional previously defined caste to the selection

|-
| SELECT_CASTE
|
*caste name, or ALL
| selects a previously defined caste

|-
| SELECT_MATERIAL
|
*MATERIAL NAME
| Selects the material. Can be ALL.

|-
| SELECT_TISSUE
|
*tissue token
| Selects a tissue for editing.

|-
| SELECT_TISSUE_LAYER
|
*TISSUE
*BY_CATEGORY, BY_TYPE, BY_TOKEN
*Location - category, type, or token | Selects a tissue at a location
* (optional) FRONT, BACK, LEFT, RIGHT, TOP, BOTTOM, AROUND.
| Selects a tissue layer for descriptor and cosmetic purposes.

|-
| SEMIMEGABEAST
|
| Appears as boss creature in quests. Makes history by rampaging around towns. Possibly inhabits non-mountain caves.

|-
| SET_BP_GROUP
|
*selection criteria BY_TYPE, BY_CATEGORY, BY_TOKEN
*category, type, or token
| selection token"

|-
| SET_TL_GROUP
|
*TISSUE
*BY_CATEGORY, BY_TYPE, BY_TOKEN
*Location - category, type, or token
*tissue
| begins a selection of tissue layers

|-
| SHEARABLE_TISSUE_LAYER
| ?
| Can be sheared for wool?

|-
| SKILL_LEARN_RATE
| {{L|skill_token}}:percentage
| The rate at which this creature learns this skill.

|-
| SKILL_LEARN_RATES
| percentage
| The rate at which this creature learns all skills.

|-
| SKILL_RATE
| {{L|skill_token}}:percentage:value:value:value
| As SKILL_RATES for individual skills.

|-
| SKILL_RATES
|
*% of improvement points you get
*unused counter rate
*rust counter rate
*demotion counter rate
| Affects skill gain and decay. Lower numbers in the last three slots make decay occur faster ([SKILL_RATES:100:1:1:1] would cause rapid decay). The counter rates may also be replaced with NONE.
Default is [SKILL_RATES:100:8:8:16]. [SLOW_LEARNER] changes the 100 to a 50.

|-
| SKILL_RUST_RATE
| {{L|skill_token}}:value:value:value
| The rate at which this skill decays. Lower values cause the skill to decay faster.

|-
| SKILL_RUST_RATES
| {{L|skill_token}}:value:value:value
| The rate at which all skills decay. Lower values cause the skills to decay faster.

|-
| SLOW_LEARNER
|
| Similar to [CAN_LEARN], but slower; skills are gained at a fraction of the rate. Present in the entries for ogres and giants; can be applied to civ or player races.

|-
| SMALL_REMAINS
|
| If a creature has this token, it'll leave a small corpse that only rots once, and without miasma.

|-
| SOLDIER_ALTTILE
| 'character' or tile number
| If this creature is active in its civilization's military, it will blink between its default tile and this one.

|-
| SPEC_HEAT
| value
| Amount of energy required for the creature to heat up or cool down.

|-
| SPECIALATTACK_INJECT_EXTRACT
|
*material source, eg. LOCAL_CREATURE_MAT, INORGANIC
*MATERIAL eg.POISON,
*MATTERSTATE (ALL_SOLID, LIQUID, GAS)
*min:max
| attack type addition that injects a material into the victim.

|-
| SPECIALATTACK_SUCK_BLOOD
| min:max
| Successful attack draws out an amount of blood randomized between the min and max value.

|-
| SPEECH
| speech file
| Boasting speeches relating to killing this creature. Examples include dwarf.txt and elf.txt in the Speech folder in Data.u

|-
| SPEED
| value
| Sets the creatures' movement and work speed, 1000/[100 + SPEED X] is the resulting effect on creatures movement and work rates from default. See [http://df.magmawiki.com/index.php/Speed/ Speed] for more information.

|-
| SPHERE
|
*sphere name
| Sets what religious spheres the creature is aligned to, for purposes of being worshipped via the [POWER] token. Also affects the layout of hidden fun stuff, and the creature's name.

|-
| SPOUSE_CONVERSION_TARGET
|
| This creature can be converted by a night creature with SPOUSE_CONVERTED.

|-
| SPOUSE_CONVERTER
|
| Enables the creature to convert SPOUSE_CONVERSION_TARGETs into CONVERTED_SPOUSE castes of its species. The creature won't actually actively do this unless it also has NIGHT_CREATURE_HUNTER, however.

|-
| SWIM_SPEED
|
*speed
| How fast the creature swims. Typically 2500 (0.38 times the default speed).

|-
| SWIMS_INNATE
|
| The creature naturally knows how to swim, as opposed to [SWIMS_LEARNED] below. Currently, an AI bug prevents this from being useful on PC races in fortress mode.

|-
| SWIMS_LEARNED
|
| The creature doesn't know how to swim unless it has learned the skill. Requires [CAN_LEARN], obviously.

|-
| SYN_AFFECTED_CLASS
|
| adds a class of creatures to those affected, such as CREATURE_CLASS:GENERAL_POISON

|-
| SYN_AFFECTED_CREATURE
| Creature Name
| adds a specific creature to those affected.

|-
| SYN_CONTACT
|
| syndrome can be contracted on contact.

|-
| SYN_IMMUNE_CREATURE
|
| creates an exception for the creature so that it not affected by the syndrome.

|-
| SYN_INHALED
|
| syndrome can be contracted by inhalation, eg. poison dust.

|-
| SYN_INJECTED
|
| syndrome can be contracted by injection, eg. snake bite.

|-
| SYN_NAME
| text
| defines the name of the syndrome

|-
| SYNDROME
|
| begins definition of a syndrome for poison use
|}

<div align="center">
{{alphabetical TOC}}
</div>

==T==
{| {{prettytable}}
|- bgcolor="#ddd"
! width="20%" | Token
! width="20%" | Arguments
! width="60%" | Description
|-
| TENDONS
|
*selection criteria. Often LOCAL_CREATURE_MAT, although other selection criteria may work too.
*selected tissue
*healing rate
| Defines the material and healing rare of tendons.

|-
| THICKWEB
|
| The creature's webs can catch larger creatures. May imply [AMBUSHPREDATOR].

|-
| TISSUE
| name
| Begins defining a tissue in the creature file.

|-
| TISSUE_LAYER
|
*BY_TYPE, BY_CATEGORY, BY_TOKEN
*TYPE,CATEGORY, or TOKEN
*TISSUE
*LOCATION
| Adds the tissue layer to wherever it is required.
Non-argument Locations can be FRONT, RIGHT, LEFT, TOP, BOTTOM. Argument locations are AROUND and CLEANS, requiring a further body part and a % of coverage/cleansing

|-
| TISSUE_LAYER_UNDER
|
*BY_TYPE, BY_CATEGORY, BY_TOKEN
*TYPE,CATEGORY, or TOKEN
*TISSUE
*LOCATION
| Adds the tissue layer under a given part ex. is Iron Man he has a gaseous poison within him and this tissue (GAS is its name) has the token [TISSUE_LEAKS] and its state is GAS so when you puncture the iron outside and damage this tissue it leaks gas (can have a syndrome by using a previous one in the creature sample.) [TISSUE_LAYER_UNDER:BY_CATEGORY:ALL:{tissue}] {tissue} is what will be under the TISSUE_LAYER here is an example Tissue from Iron Man
[TISSUE:GAS]
[TISSUE_NAME:gas:NP]
[TISSUE_MATERIAL:LOCAL_CREATURE_MAT:GAS]
[TISSUE_MAT_STATE:GAS]
[RELATIVE_THICKNESS:50]
[TISSUE_LEAKS]
[TISSUE_SHAPE:LAYER]

|-
| TISSUE_LAYER_APPEARANCE_MODIFIER
|
*QUALITY
*lowest:lower:low:median:high:higher:highest
| sets the range of qualities, including LENGTH, DENSE, HIGH_POSITION, CURLY, GREASY, WRINKLY

|-
| TISSUE_STYLE_UNIT
|
*tissue
*shaping
| sets tissue to be in a certain shape, mostly used with tissues HAIR, BEARD, MOUSTACHE, SIDEBURNS.

|-
| TL_COLOR_MODIFIER
| COLOR:freq:COLOR:freq etc
| Creates a list of color patterns, giving each a frequency.

|-
| TL_MAJOR_ARTERIES
|
| Gives Major Artery attribute to selected layers.

|-
| TLCM_GENETIC_MODEL
|
| tissue layer color modifier is passed to offspring genetically?

|-
| TLCM_IMPORTANCE
|
*number
| Presumably modifies the importance of the tissue layer color modifier, for description purposes.
HOWEVER using this appears to remove all mention of colour from creature descriptions. It does not appear in any default creatures.

|-
| TLCM_NOUN
|
*name
*SINGULAR or PLURAL
| names the tissue layer color modifier, and determines the noun

|-
| TLCM_TIMING
|
*ROOT
*start change window years:days:end change window years:days
| determines the point in the creature's life where the color change begins

|-
| TRADE_CAPACITY
|
| How much the creature can carry when used by merchants.

|-
| TRAINABLE
|
| Implies both [TRAINABLE_HUNTING] and [TRAINABLE_WAR].

|-
| TRAINABLE_HUNTING
|
| Can be trained as hunting beasts by way of kennels.

|-
| TRAINABLE_WAR
|
| Can be trained as war beasts by way of kennels.

|-
| TRANCES
|
| Allows the creature to go into martial trances.

|-
| TRAPAVOID
|
| The creature is immune to traps. Probably every procedurally generated megabeast has this.

|-
| TRIGGERABLE_GROUP
| min:max
| A large swarm of vermin can be disturbed, usually in Adventure mode.{{verify}}

|-
| TSU_NOUN
|
*noun
*SINGULAR or PLURAL
| Noun for the TISSUE_STYLE_UNIT, used in the description of the tissue layer's style.
|}

<div align="center">
{{alphabetical TOC}}
</div>

==U==
{| {{prettytable}}
|- bgcolor="#ddd"
! width="20%" | Token
! width="20%" | Arguments
! width="60%" | Description

|-
| UBIQUITOUS
|
| Creature will occur in every region with the correct biome. Does not apply to evil/good tags.

|-
| UNDERGROUND_DEPTH
|
*mindepth
*maxdepth
| Depth the creature appears underground. Numbers can be from 1 to 5. Only magma creatures use 4 or 5 in the default raws. A single argument may be used instead of min and max. Dwarven civilizations will only export (via the embark screen or caravans) things that available at depth 1.

|-
| UNDERSWIM
|
| Creature swims under the water and can't be seen.{{verify}}

|-
| UNIQUE_DEMON
|
| Typically found on genned [[demon]]s; sets the creature as capable of "emerging from the underworld" and taking over during worldgen.

|-
| USE_CASTE
|
*caste token
|

|-
| USE_MATERIAL
|
*new material token
*old material id
| Uses a local creature mat to define a new material?{{verify}}

|-
| USE_MATERIAL_TEMPLATE
|
*new material token
*material template
| Loads a material, and gives it a shortname for later reference

|-
| USE_TISSUE
|
*new tissue token
*old tissue id
| Uses a local creature mat to define a new material?{{verify}}

|-
| USE_TISSUE_TEMPLATE
|
*new tissue token
*tissue template
| Loads a tissue template listed in OBJECT:TISSUE_TEMPLATE files, such as tissue_template_default.txt.

|-
| UTTERANCES
|
| Changes the language of the creature into an unintelligible mess.
|}

<div align="center">
{{alphabetical TOC}}
</div>

==V==
{| {{prettytable}}
|- bgcolor="#ddd"
! width="20%" | Token
! width="20%" | Arguments
! width="60%" | Description
|-
| VEGETATION
|
| unknown

|-
| VIEWRANGE
| value
| Value should determine how close you have to get to a critter before it attacks (or prevents adv mode travel etc.) Default is 20.

|-
| VERMIN_BITE
|
*amount
*verb (bitten, stung)
*LOCAL_CREATURE_MAT
*MATERIAL
| vermin bites, and injects something.

|-
| VERMIN_EATER
|
| Vermin can nibble food?{{verify}}

|-
| VERMIN_FISH
|
| Acts like a fish

|-
| VERMIN_GROUNDER
|
| The creature can be picked up if you stand over it. (Requires confirmation)
'I think this is a habitat flag like VERMIN_SOIL, VERMIN_CHASM, etc. It seems to appear on creatures that don't otherwise have one. – Peristarkawan 17:27, 24 May 2007 (EDT)'

|-
| VERMIN_HATEABLE
|
| Some dwarves will hate the creature and get unhappy thoughts when around it.

|-
| VERMIN_MICRO
|
| This makes the creature move in a swarm of creatures of the same race as it. I.E. Swarm of flies, swarm of ants, etc.

|-
| VERMIN_NOFISH
|
| The creature cannot be caught by fishing.

|-
| VERMIN_NOROAM
|
| The creature will not be observed randomly roaming about the map.

|-
| VERMIN_NOTRAP
|
| The creature cannot be caught by trappers or animal traps. However, this may not work in all cases, as both dragonflies and fairies can be caught by trappers. This is possibly overridden by the VERMIN_GROUNDER token, allowing trappers set to Catch a Live Land Animal to pick up and thus trap the animal. (speculation by Flippantelf 04:45, 15 June 2009 (UTC))

|-
| VERMIN_ROTTER
|
| Present on flies, knuckle worms, acorn flies, and blood gnats. Probably means either the creature is attracted to rot, the creature speeds rotting, or both.

|-
| VERMIN_SOIL
|
| The creature randomly appears near dirt or mud.

|-
| VERMIN_SOIL_COLONY
|
| The vermin will appear in a single tile cluster of many vermin, such as a colony of ants.

|-
| VERMINHUNTER
|
| A creature with this tag will hunt down vermin and kill them. Sometimes they will eat the vermin, but most of the time they will bring it to their owner. This tag also makes impossible to assign an owner to the animal. The animal chooses it's own owner instead (like a cat). If assigned to a playable race, members of that race will ONLY be able to eat vermin.

|-
| VESPERTINE
|
| Sets if the creature is active in evening.
|}

<div align="center">
{{alphabetical TOC}}
</div>

==W==
{| {{prettytable}}
|- bgcolor="#ddd"
! width="20%" | Token
! width="20%" | Arguments
! width="60%" | Description
|-
| WAGON_PULLER
|
| Allows the creature to pull caravan wagons.

|-
| WEBBER
|
*LOCAL_CREATURE_MAT
*MATERIAL (eg SILK)
| allows the creature to web, and defines what the webs are made of.

|-
| WEBIMMUNE
|
| The creature will not get caught in webs.
|}

{{Category|Modding}}
{{Category|Tokens}}

Talk:Main Page/archive2

2011-02-21T07:05:38Z

Bohandas: /* Why is there no pages on Body Detail Plan Tokens or Creatue Variation Tokens? */ new section

{{Archive|
# [[Talk:Main Page/archive1|Archive 1]]
}}

== embiggen release notices? ==

I for one am hugely excited about the size of this release. Can we promote it a bit more?

== Page visit counter ==

Before the wiki move, (I think), every game article had a [http://en.wikipedia.org/wiki/Web_counter web counter] at the bottom of the page. It used to be pretty neat. You could create an article and then see how many hits it was getting down at the bottom. It was one incentive to expand on the article, knowing that thousands were reading it.

I think and vote that this should be brought back. --[[User:Richards|Richards]] 21:44, 27 November 2010 (UTC)
: The amount of load this causes on the servers is cost prohibitive. --[[User:Briess|Briess]] 01:46, 28 November 2010 (UTC)

== Two DF2010 main pages ==
Why are there two DF2010 main pages? When I check the wiki, I see the one with the missing hydra heads image, and the http://df.magmawiki.com/index.php/Main_Page address, but when I check the 40d version and go back to DF2010 main page, I get Belal's tileset image and the http://df.magmawiki.com/index.php/DF2010:Main_Page address. Then, when I check the discussion page and return to the main page, it's http://df.magmawiki.com/index.php/Main_Page again. Is redirecting messed up or what? --[[Special:Contributions/109.93.118.60|109.93.118.60]] 09:37, 4 June 2010 (UTC)
:There is only one main page for DF2010 - the image shown on it is '''randomly selected'''. The page [[DF2010:Main Page]] is just a redirect to [[Main Page]]. --[[User:Quietust|Quietust]] 12:36, 4 June 2010 (UTC)
Except that one shows "'''28.3 out of 100 quality rating for DF2010 namespace (approximate)'''" and the other shows: "'''29.8 out of 100 quality rating for DF2010 namespace (approximate)'''". Not to mention that the page that contains "''(Redirected from DF2010:Main Page)''" in the top left corner is ''http://df.magmawiki.com/index.php/DF2010:Main_Page'' It redirects to itself. Also, I get one image on the DF2010:Main_Page, and a different one one at Main_Page. When I check DF2010:Main_Page, it's the first picture again. I made sure that it isn't the same page already. Repeat the steps I mentioned in my first comment and see for yourself. It's not a redirect, those are two different pages. --[[Special:Contributions/109.93.118.60|109.93.118.60]] 17:05, 4 June 2010 (UTC)
::[http://df.magmawiki.com/index.php?title=DF2010:Main_Page&redirect=no DF2010:Main Page - Redirect page - Main Page]. It is a redirect. When you load a redirect page, it does not actually forward you to the destination page but simply displays it immediately, so the redirect's URL is still in the address bar. Either your web browser or the server itself is caching different versions of the page depending on whether or not you viewed it through the redirect. --[[User:Quietust|Quietust]] 17:31, 4 June 2010 (UTC)
Well, it stopped happening after the new-version change of the main page, whatever the cause was. Thanks anyway. --[[Special:Contributions/79.101.254.106|79.101.254.106]] 19:30, 4 June 2010 (UTC)

== HFS creatures ==
We don't seem to have any pages for them, shouldn't they have pages like normal creatures? --[[Special:Contributions/78.151.176.4|78.151.176.4]] 13:09, 11 April 2010 (UTC)
:Aren't they randomly generated during worldgen?--[[User:SanDiego|SanDiego]] 13:29, 11 April 2010 (UTC)
Oh right, didn't realise that. Thought that they were just lacking raws. --[[Special:Contributions/92.29.248.178|92.29.248.178]] 14:42, 11 April 2010 (UTC)

Well, you're both right :P. They're randomly generated, and they lack raws! --[[User:612DwarfAvenue|612DwarfAvenue]] 06:20, 18 April 2010 (UTC)

== Random page function ==

I'm not familiar with how the Special:Random function works, but would it be possible to restrict it to random pages from particular namespaces? Getting 23a, 40d and DF2010 pages returned isn't very helpful. [[User:Oddtwang of Dork|Oddtwang of Dork]] 16:27, 8 April 2010 (UTC)
:That would require (iirc) some fairly heavy editing to the mediawiki code. We're trying to avoid modding the code because that creates problems with updating the mediawiki software to new versions. [[user:Emi|<span style="color:#8a4e4e">Emi</span>]] [[user_talk:Emi|<span style="color:#6a3e4e">[T]</span>]] 18:51, 8 April 2010 (UTC)
::Just a little correction, you an get to just DF2010 pages by appending "/DF2010" to the end of special random.
:: For example. [[Special:Random/DF2010]], [[Special:Random/Utility]], ect.
:: Perhaps this link might be useful as a more available link? [[User:Mason11987|Mason]] <sup>([[User talk:Mason11987|T]]-[[Special:Contributions/Mason11987|C]])</sup> 00:19, 15 April 2010 (UTC)

== DF2010 Title needs changing ==

The new version is now df_31_01 and each article beginning with "DF2010" seems tacky. Any others agree it should be changed to df31 or something around like that? [[User:Richards|Richards]] 19:59, 1 April 2010 (UTC)
:The problem is that we version the wiki for each game-save compatibility change. Simply changing it to 31.01 would fix it now, but when 31.02 - 39.07 come out, and then finally 40.01 comes out that breaks save compatibility, we have much more work to do. Until we know the final version number in the series, it's not easy for us to just say "oh, this is it." --[[User:Briess|Briess]] 20:02, 1 April 2010 (UTC)
::And wtf is the precedent? In all the versions of the wiki I've seen, versions are always specified as the actual number. How is it more clear to use DF2010 instead of v0.31.01? --Peewee 09:57, 2 April 2010 (UTC)

:If you aren't planning to make more special version namespaces for a while, let's use the main namespace. Also, you guys really need to talk things out more before implementing giant sweeping changes. The more I see you describe your respective visions for the wiki, the more different they seem from each other. [[User:VengefulDonut|VengefulDonut]] 11:29, 2 April 2010 (UTC)

::Well. A solution would be to make every article title for the current version just say the article name, ex/ instead of "DF2010:Armor", make it "Armor", like last time. If a new version is released that is different, then archive it as whatever version it last applied to, like "40d:Armor, or 31.01:Armor". Is there any problem with this idea? [[User:Richards|Richards]] 14:28, 2 April 2010 (UTC)

Yes, there is. (Namely, the amount of labor you're talking about if pages are not set-up for that.)

Here's "The Plan", which was set up a couple months ago (and which has been discussed elsewhere, but we'll do it one more time)...
:* Old versions are clearly labeled and consistently linked internally. All 40d links bounce around only to 40d articles, so if a player is researching that version, it's all one package. ''(Same w/ 23a, the "2-D" version previous to that, but an ongoing and lower-priority project.)''
:* "New" versions are, likewise, consistent within themselves. Versionless search terms (like "[[stone]]" automatically default to "current version".
:* Future versions get their own version names, "current" becomes one-older, and the pattern continues.
The current PROBLEM is three-fold - the first is the changeover itself, when first time Editors start firing away at articles without the correct names or understanding The Plan. That is understandable, but compounded by the fact that we don't currently ''know'' the "proper" version number to use - is it 0.31.01, or 0.31, or 31.01 - when the first bugfix comes out, what will be changed and what kept? What part of that number constitutes/defines this as a "version"? There is no equiv of 23.a or 40.d - it's a new code, and we weren't given the codebook. (We're waiting on Three-toe/Toady for a response on that.) The 3rd problem is "DF2010" - which is wrong, but while popular and everyone is using it, it won't be very friendly later down the road.

So... we've got something that works now but won't in the future, and needs to be changed to be consistent so we don't bequeath future Admin and users the big bone. A diff between more work now and the sort of complete cluster that has gone on behind the scenes for the last 2 months preparing for this change - which is going SO MUCH SMOOTHER NOW (believe it or not!) because of that (thankless, ahem) preparation.

Once we know the correct version, all current articles will appear as that. Search terms will default to current version. Older articles will be consistent within their own namespace. AND we'll be setup for future version changes without quite so much trauma (which is ''why'' some of the more obscure of these changes are being implemented). Clear as mud?--[[User:Albedo|Albedo]] 19:06, 2 April 2010 (UTC)

:Are you basically trying to say that DF2010 is a convenient placeholder string that can be used to identify and move articles by bot when we get a stable version number from Toady? --[[User:Squirrelloid|Squirrelloid]] 19:20, 2 April 2010 (UTC)

::Dammit, if I could express myself in anything less than 500 words at a time, I would have! (Yes, that's basically what I'm saying.)--[[User:Albedo|Albedo]] 19:31, 2 April 2010 (UTC)

:::I'm not sure who wins the eloquence award here. Anyways, we're still waiting on information from ToadyOne before we rename DF2010 to something else more appropriate. --[[User:Briess|Briess]] 19:37, 2 April 2010 (UTC)

:::: Toady has already said that he plans to aim for possibly as often as a weekly bugfix release while the early issues of this release get ironed out. Trying to keep up with release number changes weekly would be an absolute nightmare. Until things calm down a bit I don't blame anyone here in the least for using DF2010 as a more general version name. [[User:Doctorzuber|Doctorzuber]] 15:54, 5 April 2010 (UTC)

:::::It ''is'' understood that Toady intends (ideally) for this to be both the last save-compat breaking version and the last major long-delay version... correct? Putting the entire Wiki in a namespace forever seems to me like a fairly terrible idea in any case, but it is intended for future versions to change much less of existing stuff as things go on (that is why this version took so long, in part, to get all the sweeping structural changes out of the way.) It is unlikely that there will ever be another version that would require reversioning the entire wiki, if, indeed, you think that even this one reached that level. While I'm not sure I'd agree that it was necessary to reversion the wiki for this version, the DF development plan is certainly intended to be such that revisioning the Wiki like this will never be necessary again. --[[User:Aquillion|Aquillion]] 03:47, 7 April 2010 (UTC)
:::::: All I'm saying is that for the immediate near future a large number of incremental bug fix releases are to be expected. To avoid driving people completely nuts trying to keep up with frequent version changes it makes sense to use the DF2010 title in the short term. After we see things settle down a bit I agree we should probably go ahead and return to an actual version number. [[User:Doctorzuber|Doctorzuber]] 17:27, 7 April 2010 (UTC)
:::::::With the new version numbering system being so much simpler, could we simply refer to the version as 31a? Then changing letters to account for bugfixes. I'm using 0.31 enough myself but the decimal point is awful. --[[User:Retro|Retro]] 17:40, 7 April 2010 (UTC)
::::::::Not really. We're mainly talking about the namespace's name. Changing a namespaces's name is a BIG headache (though it is the reason we're using the <nowiki>{{l|link}}</nowiki> stuff) because we did know that we'd be doing at least one change, and that gets rid of a decent portion of the headache. [[user:Emi|<span style="color:#8a4e4e">Emi</span>]] [[user_talk:Emi|<span style="color:#6a3e4e">[T]</span>]] 18:49, 7 April 2010 (UTC)
:::::::::I'm still waiting on ToadyOne to provide an official tagname for this series of releases. If we receive one, we will use it in the wiki. --[[User:Briess|Briess]] 19:02, 7 April 2010 (UTC)
::::::::::Toady's response to what to call this version. http://www.bay12forums.com/smf/index.php?topic=60554.msg1636714#msg1636714 (7th reply) probably not as satisfactory/definitive as hoped :) --[[User:Quatch|Quatch]] 16:26, 13 October 2010 (UTC)

== World Painter Page ==
The wiki has needed a page on the [[World Painter]] for a while, so I've started one. The information in there is decent, but I'm relatively new to wiki editing, so the formatting probably isn't. If someone wouldn't mind cleaning it up a bit for me I'd really appreciate it. --[[User:Timmeh|Timmeh]] 01:15, 3 April 2009 (UTC)

:Well I don't know if someone helped you already, but it looks fine to me. --[[User:frandude|frandude]]
:I changed the name into World Painter so it looked better (no more petty redirects!) [[User:Inawarminister|Inawarminister]] 12:01, 7 December 2009 (UTC)

== French language wiki ==

Can we have interlanguage links with the [http://www.dwarffortress.fr/wiki/ French wiki]? -[[User:Alan Trick|Alan Trick]] 17:48, 14 April 2009 (UTC)

== Add a CptnDuck page? ==

Captain Duck is a DF video tutorial maker, which an impressive collection of 40 videos on youtube (and a few extra videos of sieges and arenas and whatnot), and explains how to do most everything, from magma forges to Dwarven justice. He adds humor to it and he's the reason a lot of people understand the game...I think we should give him a page. <small>– [[template:unsigned|unsigned]] comment by [[User:Blackdoggie998|Blackdoggie998]]</small>

:As it is insanely easy for anyone to sign up for editing priviledges on this site (I managed to, after all), I see no need to make one for him when he could make one for himself. However, if you wish to add user:CptnDuck, or invite him to make one himself, feel free. He can link to all of his tutorials from his user page. They even be searchable through that lovely little box to the(my) left. (Who knows where it is on your skin.) -- [[User:Teres_Draconis|jaz]] ... on this day, at this time.

:P.S. Does it seem odd to you to have it say "unsigned comment by [username]"? Or is that just me? -- [[User:Teres_Draconis|jaz]] ... on this day, just a little after the previous one.
:: Clicking 'unsigned' gave me all the explanation I need, might want to do the same [[User:Kinzarr|Kinzarr]] 23:27, 25 November 2009 (UTC)

:We don't need a userpage for him, but a page with the assembled listing of all his (and others of equal quality) video tutorials wouldn't be a bad idea at all. -[[User:N9103|Edward]] 16:47, 23 June 2009 (UTC)

== Articles on Olivine and other generic stones ==

There is a current discussion as to whether or not [[Olivine]] (and perhaps some few other stones) are duly covered on the current [[stone]] page, or are truly worth having their own article/page. This relates to a larger question of how this wiki is organized, and "What deserves a page" in a general sense. Any interested are encouraged to chime in, if only with a "me too" post pro or con. See [[Talk:Olivine]] for an idea of the issue. I'd like to have the debate move from the specific Olivine page to here since this is a more general issue that affects many potential pages. --[[User:Senso|Senso]] 21:29, 19 May 2009 (UTC)

:I'm not really sure which way to go on this one. A lot of otherwise useless stones would need their own articles if the guidelines were expanded... and yet, there's a good amount of useful information that's not on the main pages, that would further clutter them if it were added; And permitting more individual pages would solve both those problems. I guess this ends up being a vote both ways, with provisions on each. -[[User:N9103|Edward]] 23:54, 19 May 2009 (UTC)

:My vote is, if someone can make it amusing, then sure. If someone is of the bent to enjoy making such a page, then again, sure... otherwise, leave it at the bottom of the pile of "things that someday we might get around to if we feel like it" and don't stress. The relevant data is covered (or will be when someone notices it's not), and everything else is gravy. Beside, what would you rather do, play the game, or figure out how to make a whole page of jokes about how gneiss nice is.... (or did I get that backwards?)... ? --[[User:Teres_Draconis|jaz]] ... on this day, at this time.

::All relevant information is covered, yes. But not necessarily on a relevant page. Before the Olivine page was made you couldn't learn that olivine may contain native platinum from any page related to olivine or stone in general.
::Another example is kaolinite. You can look it up in the table of Other Stone to see it can be found in sedimentary rock. But in order to see that it may itself contain alunite and marcasite you have to go through the entire table (or use the browser search function). Now, in order to see if it may contain anything else, you have to notice the note at the top of the page (just above the table of contents) that points to Metal Ore and Gem, whith another two tables you have to search through. (Kaolinite may contain turquoise). --[[User:Nahno|Nahno]] 21:44, 20 May 2009 (UTC)

:It's not just about "which stones" - it's a larger question of how the wiki is organized and presented. Should each separate and distinct item get its own page, like the current one- or two-line articles on [[vial]]s, [[instrument]]s or [[Restraint|chain]]s, (just as random parallel examples of some [[finished goods]] that have their very own, very short, very dull, and predictably repetitive articles.) Surely the [[Masons guild]] and [[miners guild]] don't deserve or need separate articles. Do we need a separate and largely redundant article for every trap weapon? What about the cookie-cutter articles on ''every'' individual animal? The GCS deserves its own, and many others, but one on each separate type of shark and hunting cat? There is no actual article there, only a template.

:Quivers and bolts are sub-sections of the [[crossbow]] article, and I think that's a ''great'' call. Olivine, talc and kaolinite are merely similar examples, distinct enough to warrant special treatment, but on the borderline of being so small to each only represent a stub. Ultimately, I don't think a functional formal definition would be easily achieved - rather guidelines and a fuzzy target, combining related info into groups with optimal size limitations (both lower end and upper end). Perhaps a template should not be forced on every lesser example, but they could be grouped into a table on their own article, "other stones of note" or "sharks" or "finished goods" or whatever.

:In many ways, our only current guidelines are "what has been done so far" - and that varies widely and wildly. Too often, pages are cobbled onto related ones, or split off just because its a new topic, if a brutally short one. Myself, I'd like to see most related articles of less than 4 lines or so get grouped into larger, more universally informative articles, and anything larger than maybe 5 full sub-sections be considered for splitting up. If an item stands out from the rest, it should stand out somewhere, in an article - but that doesn't mean it has to have its very own, or invite every similar item to do so as well.--[[User:Albedo|Albedo]] 03:30, 21 May 2009 (UTC)

:: Please check out the (no longer) current [[Chalk]] page and tell me what you think. ... which is to say, it doesn't /have/ to be a stub, does it? It can be rich and detailed and sadly unamusing. It would please me to continue to do all stones in this manner, or another manner of your choosing.... Thus negating fussing over "this one was done this way, that one was done that way" arguments. I'll get to them all, in the order they appear on the [[Stones]] page. ... assuming you guys are ok with that. --[[User:Teres Draconis]] 08:28, 21 May 2009 (UTC)
:: P.S. Who's the outpost manager of this place, anyways? I'd like to know to whom I should be pandering. --jaz

::: I think 1) you should take time to read, if not learn the wiki format guidelines, 2) you should sign with your REAL user name, and stop using a pseudonym, and 3) you should not break someone else's post with yours in between their paragraphs. As to the chalk page, I think it's over-enthusiastic and pays no attention to previous article style or formatting precedent - which may be a good thing or a bad thing, depending. --[[User:Albedo|Albedo]] 09:33, 21 May 2009 (UTC)

:::: 1) You're right, I'm sorry.
::::2) We've discussed user names on [[User_Talk:Teres_Draconis#Naming Conventions|my talks page]]. (Also, <nowiki>~~~</nowiki> still puts "jaz"... why bother with the link when it's just a P.S.?)
::::3) I'm sorry. I was (apparently) trained wrong, and that was a /long/ time ago. I was taught (20 years ago) that when responding, to do so in-line, so that people can tell what the response is actually relating to. (Like an actual conversation, except with a time warp. You say something, I respond, someone else adds, we all move on to the next topic.) It supposedly adds clarity. The style and curtesy rules of such things has changed. I can see I'll need to update myself. Thank you for pointing that out. =)
::::4) I was hasty. I had to have meatspace people explain to me why, as wiki-''writers'', you would not want so much detail on a page. Especially when, with every new game release, any given page on the wiki might need an over haul. I was only looking at it from the end-user perspective of "If I'm looking for information, I don't want a page that just tells me to go look at the three pages I've already looked at. I want a page that reduces the noise of the irrelevant, and distills to just that specific (sub-)topic." I /don't/ see the point of six pages that are identacle except for title, and all only three lines long. If it's got it's own page, it should have it's own page. If it just links back to the three pages that linked to it, and they all link to each other already, what's the point? If the only thing Chalk has going for it is that it's flux, why not just make a note on the [[Stone]] page reading, "These three rocks can be used as flux" and link to the flux page from there? Why should chalk have it's own page, if it's not going to be richly detailed and, you know, informative? - [[User:Teres Draconis|jaz]] 18:59, 22 May 2009 (UTC)

::::The templates are there because they are pretty, detailed, and condensed ways to display some key information. Rather than expanding existing information so that it takes up more space, it's more productive to add things that you think are lacking. [[User:VengefulDonut|VengefulDonut]] 12:15, 21 May 2009 (UTC)

::: I changed the other [[Stones]] table to allow for interesting minerals that are in other[[Stones]] to be posted.--[[User:Mrdudeguy|Mrdudeguy]] 22:17, 21 May 2009 (UTC)
:What would actually be helpful is a [[Geology]] primer, indicating how layers and inclusions are placed, where, and what the implications of "You have struck XXX" are. I know, now, that if it's olivine, I have a chance of finding veins of native platinum. One good page explaining what all of the geological processes mean would be a lot more useful then all of the various descriptions of exploratory mining. [[User:Decius|Decius]] 22:35, 21 May 2009 (UTC)
::That sounds like a great idea.--[[User:Mrdudeguy|Mrdudeguy]] 22:46, 21 May 2009 (UTC)

:::I agree! But I have no idea how to write it. Most of what I know about geology I learned from looking at the raws. Everything else is "OMG, is that a ''rock''?! I've heard of those!" - [[User:Teres Draconis|jaz]] 18:59, 22 May 2009 (UTC)

::"More useful" to some, but I agree it would be a great addition. Also, the more I think about it, the more I like what MrDG did with the table in Other Stone - tables could condense any and all small, individual articles into single pages w/ (sortable?) tables where all these various similar objects could be compared/contrasted at a glance. Templates are perfect when there is a lot of various info, but if the different topics (semi-generic stones, animals, finished goods) all differ only in one or two details, and there is just not that many variables to begin with, a Table would be (imo) preferable. ''(And imo that table now covers such stones as Olivine well, to get back to the original example that sparked this discussion.)''

::As an additional example of how current stub-articles could be combined into a simple table, I've made this page - [[Example - some fish]] - which could be a model for such. (A page/table with all the "Sea-creatures" would be more likely approp, but this was faster for now.) It would replace every stub-article on related "generic" items, but any truly noteworthy items would still have their own full articles for expanded information and commentary (here, "carp"). It still has 100% of the prev information, but also allows immediate comparison and contrast, and, if sortable, allows a User to more easily compare relations between similar aspects (like "biome", in this example.)--[[User:Albedo|Albedo]] 00:13, 22 May 2009 (UTC)

::: Is it possible to put the expandable version of the raw ("game object data (show)" seen at the bottom of the [[carp]] page) inside the table, instead of the whole thing? Or does the one preclude the other? - [[User:Teres Draconis|jaz]] 18:59, 22 May 2009 (UTC)

:::Actually, if someone finds it easy to extract that information from the .RAWs, I would find that an improvement on what [[Creatures]] currently has. [[User:Decius|Decius]] 17:52, 22 May 2009 (UTC)

::::If someone here knows PHP they may be able to write a new wiki hook that pulls information from raw entries. That would make many things much easier. [[User:VengefulDonut|VengefulDonut]] 22:22, 22 May 2009 (UTC)

:::Which information do you want extracted? I can probably do it for you, but you may have heard, I'm in the doghouse for not paying attention to style and formating rules. =/ Show me what there is, and one example of what you want, and I can probably do it for you with a minimum of stupid questions. ... ''Probably.'' - [[User:Teres Draconis|jaz]] 18:59, 22 May 2009 (UTC)

::::@ jaz, Dec - Did either of you look at this sample table? [[Example - some fish]] Does that cover what you were envisioning? It's just a rough idea - but it could work the same way that the table on the [[stone]] page currently does, to cover all the generic, almost-identical objects. Same w/ finished goods, weapon traps, probably many other sim categories of like items.--[[User:Albedo|Albedo]] 22:52, 22 May 2009 (UTC)
I've read this sort of. My view is, wikis add value to the game far more for noobs than they do to legends who have been around since when the z-axis was just an idea. With this in mind, I reckon if everything with a name in the game had an article that would be *A Good Thing* (tm). Just my own opinion, feel free to disagree. Ideally, articles for things like stones should contain a template constructed from the raws, with prose/dialogue manually added.
Even things like [[screw pump]] could have a template driven section, advising what the components are / who makes it etc. Maybe <nowiki>{{building|Building Name|Component 1:Component 1 name|Component X| component X name|Constructed by|trade}}</nowiki> or similar.[[User:GarrieIrons|GarrieIrons]] 08:45, 30 May 2009 (UTC)

:I agree, probably, although that sounds like a lot of work. I think the stone templates and articles could do with a bit of a cleanup and more in-game information. I mostly use the articles to see if there's anything notable about a particular stone and then check out the wikipedia page. Some of the wikipedia links are broken or indirect now because disambiguity pages have been added since. Also, the wikipedia links are right at the bottom of very long boxes listing ores and gems and the like - I suggest adding drop down boxes to the templates that contain all that information but which are minimized by default. Or changing the template so that the wikipedia link wraps around the stone name at the top. --[[User:Harmonica|Harmonica]] 01:36, 2 July 2009 (UTC)

Way late to this party, apologies. Tables are no good (to me) if they aren't sortable. The World Ends With You (a Nintendo DS game) Wikia portal/wiki thing has an ''awesome'' method for adding sortable tables. Some gadget called [http://en.wikipedia.org/wiki/Semantic_MediaWiki Semantic MediaWiki] that hooks into the Wiki to automatically pull data out as you request it, then display it in easy-to-read and use sortable tables. The TWEWY Wikia has [http://twewy.wikia.com/wiki/The_World_Ends_With_You:Semantic_MediaWiki a page on it] for their editors, giving a few examples of how powerful it is. Their use of the tool is to easily pull information from a table of 304 items, each containing 30 attributes, to generate lists comparing and compiling various items. Hugely powerful, extremely flexible.

This type of tool would work wonderfully with a PHP RAW parser, or even simple dumps of the RAWs to the Wiki. Think of how easy it would be to update the entire Wiki across the board when new versions come out. New critters? Changes to existing critters? Update the information in one spot and it trickles down through the entire Wiki! That's in addition, of course, to being able to, say, generate tables listing how many bones each creature drops when killed, then sort to see which one drops the most. Pretty sweet stuff.

With some sort of system in place for wading through all the data on the wiki, one wouldn't have to worry about having too much information, right? -- [[User:Blank|Blank]] 04:44, 3 July 2009 (UTC)

Particularly for stone, I think that it would be a good idea to describe each individual stone relative to other, similar stones. Let's use [[sandstone]] as an example. Suppose that I read (either in its own article, or in a table) something along the lines of "Sandstone is a [[sedimentary]] layer. Unlike most sedimentary layers, it may contain [[aquifers]] or veins of [[native copper]]." If I already know what a sedimentary layer is (and how it differs from other types of layers), this information will be much easier to process and much more useful than a full list of everything that appears in sandstone. If I have no idea what a sedimentary layer is, this will tell me that there are several sedimentary layers and that they all have many things in common, which is again more useful than a list of everything that appears in sandstone. --[[User:LaVacaMorada|LaVacaMorada]] 08:56, 2 October 2009 (UTC)
:That's not the way this (any?) wiki is set up. The idea is that a lesser concept (here, "sandstone") need not include redundant info from a larger, parent concept (here, "sedimentary layer"). If you don't know what a sed'y layer is (or an aquifer or a vein or whatever) you click that link. If, then, you don't know what a "layer" is, you click that link. Sounds good at first, but if every lesser article included an explanation, even a quick synopsis, of the info for all relevant articles on broader, umbrella concepts, the articles, and this wiki as a whole, would explode beyond usefulness. --[[User:Albedo|Albedo]] 23:43, 2 October 2009 (UTC)
::Thanks for making my point for me. If you look at the current sandstone article, it lists everything contained in sandstone. Looking at just the ores and non-generic stones, we have: Native copper, Hematite, Limonite, Magnetite, Native platinum, Tetrahedrite, Bituminous coal, Lignite, Bauxite. All of these except for native copper appear in every sedimentary layer. That's not even counting all of the generic stone (especially gypsum with its five other types of generic stone contained in it) and (mostly low-value) gems. 95% of the text in this article is redundant, and could easily be summarized by "This layer is exactly like every other sedimentary layer except for these two differences". --[[User:LaVacaMorada|LaVacaMorada]] 09:06, 6 October 2009 (UTC)
:::Ah - ''that's'' your point. (When you said "describe", I thought you were advocating a narrative commentary on and verbal expansion of the info included in the sidebar.) When I was talking about not having redundant info, I was talking text - which is quite terse in this case, exactly because of the point you make. Those sidebars were designed to encapsulate the key info, an "at a glance" sort of thing, to avoid exactly what you're talking about in narrative form. Are the sidebars redundant? Often, yes. But they are the style this wiki has adopted for ''all'' stone. So you're talking not just about changing sed'y layers, but the style approach to all stone, since they would not then be consistent across the board. (Not how I would have personally designed the layout, but it's there and it works, and well. Any stone, same layout, same info in the same place, bam got it.) And when discussing presentation and usability issues, any article has to be taken both individually and in the context of others "like" it - here, any "stone" article is the same layout, the same info at a glance, which (for now) trumps whatever redundancies exist. Perhaps a quick line such as you're stating would go well, since there is, indeed, very little unique to say about any one sub-type of sedimentary layer, and that is info in and of itself. (Take a look at any [[igneous extrusive]] except obsidian for something similar.)--[[User:Albedo|Albedo]] 16:46, 6 October 2009 (UTC)

A lot of people have been talking a lot of things about reorganizing the information on the stones pages. After browsing around on them for a while, I've found the information to be mostly scattered and difficult to draw conclusions from. For example, I wasn't aware that each geographic stone type had a base list of stones that can appear, while only some of them have a couple of unique stones that may appear along with that list. It wasn't until I began gathering all of that data together for myself, that I found the patterns. I had to work to tie it all together. So, I have a partially completed table of pulldown menus on my user page right now. If anyone's interested they could take a look and tell me what they think? (Yes, I know a lot of it is redundant. I have an idea on how to fix this, but I haven't completely decided yet) --Kydo 13:55, 25 October 2009 (UTC)

Lumping all the generic stones into one page is pretty much a labor saving device. There are a lot of different stones in DF most of which have no real differences other than color. So in one respect, I do see reasoning for saving some effort and dumping them in one place. On the other hand, it would be useful to me to see slightly more detailed information about each of the colored stones, for example, I know alunite looks a certain way before it is mined out, it's general color is bright white, when used to build trap components it is bright white in both the on and off position (many stones go to dark in the off position). In the same vein, when used to build tables and chairs, both will be bright white (many stones go to dark for chairs). If you're looking for a "certain look" and want to know a tiny bit more about the stone colors at present, that information simply isn't here as things are now. [[User:Doctorzuber|Doctorzuber]] 16:21, 5 April 2010 (UTC)

== Not a Roguelike ==

Dwarf Fortress only resembles a Roguelike in the sense that everything kills you. ASCII graphics haven't connoted Rogue-resemblance since Diablo came out with modern 3D graphics and was still considered a Roguelike.
[[User:LogicalDash|LogicalDash]] 22:08, 5 August 2009 (UTC)

I agree with you for Fortress mode, but adventurer mode is rogue like.--[[User:Mjo625|Mjo625]] 22:54, 5 August 2009 (UTC)

:DF is rogue-like like.<font face="FixedSys" color="#00FFFF">[[User:GarrieIrons|Gar]]</font>[[User Talk:GarrieIrons|rie]] 08:59, 2 September 2009 (UTC)

LogicalDash, Diablo is in 2D, not 3D. --[[User:612DwarfAvenue|612DwarfAvenue]] 05:10, 27 November 2009 (UTC)

What makes a rogue-like? too classic a question to pass up . ahem IMHO there three major elements, A dungeon crawl/ fantasy setting, ASCII and random as hell. That makes dwarf fortress three outta three hits for me. Close enough, i'd say, if it's not a rogue-like what other category could it go in? sure its not a great fit but a unique game has to go somewhere. Diablo is a dungeon crawl like rogue sure, but it lacks the depth and randomness of any of the other recognised roguelikes, ADOM, moria etc. So one outta three? The depth, randomness and spontaneity really make it, ever had a character eaten by a bear on the way to the village in ADOM? classic. --[[User:Pedantictype|Pedantictype]] 05:46, 20 March 2010 (UTC)
:I'm afraid I have to disagree with you, Pedantictype. A Rogue-like is defined by the original: Rogue. Rogue was, first and foremost, a dungeon-crawl with control of a single character, yes? I would postulate that that is one of the elements that is required to be defined as a rogue-like, which qualifies Adventure mode but not Fortress mode. --[[User:Eagle0600|Eagle0600]] 05:04, 5 April 2010 (UTC)
::Eagle's right. A roguelike game plays somewhat like Rogue and has ascii graphics. Fortress mode DF is a tactical/strategic/sandbox ascii game, not a roguelike. And isn't there general intent for it to have graphics one day, once it's out of the design stages? --Kydo 01:58, 8 April 2010 (UTC)

DF is closer to Civilisation than ADOM, at least in the Fortress regard. --KingAuggie

== Link to Add Quotes ==

To get help on how to add quotes to the main page, consult [[Talk:Main Page/Quote|this]] link.

== Incoming New Version ==

Guys. We might as well prepare for the new version that will be coming by the end of the year (maybe). What will need to change? Weapons and armor, the underground stuff... I don't know all of it. But it's extensive. Get ready.--[[User:Zchris13|Zchris13]] 17:02, 7 October 2009 (UTC)
:Well, we don't know all the details, and names of jobs/items can change before actual release. [[User:Kurokikaze|Kurokikaze]] 16:14, 8 October 2009 (UTC)
:I don't see what this has to do with anything, i guess it's nice of you to tell us. But what do you mean "get ready?"
: Gird your loins, gentlemen. Or something.
::It'll be hard to cover every page - if you edit, try to follow up on links, etc. Might also have to check the "oldest pages" listing to see that they've all been updated (except it's broken atm). The worst currently is that we ''still'' have legacy crap from earlier versions in obscure corners and comments that's not relevant to current version. Bonus.--[[User:Albedo|Albedo]] 06:11, 19 October 2009 (UTC)
:This might be useful: http://docs.google.com/Doc?docid=0AT8EQVUjrv96ZGc5cnBwOHZfMjgyY3FzZHFtanA&hl=en
:Are we just changing this wiki? (as opposed to forking with the new version, in case some people keep playing 40d?) [[Special:Contributions/206.45.111.58|206.45.111.58]] 22:39, 9 December 2009 (UTC)
::Forking sounds good to me. But I have no idea how well wikis handle forking. --[[User:Nahno|Nahno]] 14:11, 17 December 2009 (UTC)
:::In any case I think it would be a good idea to updated articles as is, and not wipe them out like in the wiki's switch to 3d which simply wiped out a lot of good information along with outdated text. Forking is a good route to take if people don't want to lose 40d inforamtion. [[User:Richards|Richards]] 19:40, 26 January 2010 (UTC)

== Interwiki ==

Correct link to Russian DF wiki, please.
Right link = www.dfwk.ru instead current www.dfwiki.ru --[[Special:Contributions/91.192.82.106|91.192.82.106]] 11:43, 4 December 2009 (UTC)
:It's done, so should we delete this conservation? (not that great at wiki myself) [[User:Inawarminister|Inawarminister]] 09:46, 7 December 2009 (UTC)
::They get archived at some point, so no need. [[User:Mason11987|Mason]] <sup>([[User talk:Mason11987|T]]-[[Special:Contributions/Mason11987|C]])</sup> 00:33, 15 April 2010 (UTC)

== Random page ==

Why is "Random page" only bringing me to "Count Consort"? :\ --[[Special:Contributions/99.33.67.9|99.33.67.9]] 22:33, 15 January 2010 (UTC)
:It seems "Random page" is only random daily... Is this intentional? --[[Special:Contributions/99.33.67.9|99.33.67.9]] 20:31, 2 February 2010 (UTC)
::There's probably something wrong with your browser cache settings - it works fine for me. --[[User:Quietust|Quietust]] 20:37, 2 February 2010 (UTC)

== Random images ==

Where are the images on the main page coming from? It's easy to find the quotes, but where are the images? [[User:MC Dirty|MC Dirty]] 15:14, 17 January 2010 (UTC)

:I have an image I'd like added... I'll put it on my userpage if anyone wants to take a look at it and see if it's acceptable for uploading. --[[User:Waladil|Waladil]] 06:40, 21 February 2010 (UTC)

== New Category Idea - Well Known Dwarves ==

After reading some stories on many of the most awesome dwarfs to show up in this game. (Namely Captain Ironblood, Morul, Tholtig) That a category, perhaps a sub one to Humor and Stories just for Dwarves that are very very clearly above the normal for the already outrageous(ly awesome) game of Dwarf Fortress. However do to the fact this is less on the game mechanics and such, the idea is first here so other's can figure if it's worth having a category. One thing that comes to mind is there really should be some sort of limit to what makes a Dwarf and Epic/Well Known Dwarf so as to prevent people from putting everyone they liked up there rather then the few '''everyone''' likes. Mostly asking as there is a handful of such dwarfs and that number is only going to (slowly) grow. Each said Dwarf I think deserves some sort of noting on a page for my two cents on the topic.
:I definitely thing that this is a great idea in the true spirit of DF.
::These should of course go under D for Dwarf.

== Images ==

So, what does everyone think? Would it be a good idea to have real-world images (or possibly sketches for fantasy, if applicable) of the following:
* Trees
* Fish
* Land animals
* Weapons and armor
* Stones
* Ores
* Land features (desert, savannah, etc.)
* Gems
* Metals
* Plants
We already have two pages with example images for a [[Pike_(weapon)#Pike|weapon]] and a [[Sandstone|stone]] for example. I find this very nice for visualizing my fortress and what's going on, since I'm not very familiar with many of the distinctions DF makes. I mean, I know what a fish looks like but I haven't got a clue what the difference between a pike and a char is, or a birch and alder, or even bronze and pewter to be honest.--[[User:Ar-Pharazon|Ar-Pharazon]] 22:42, 6 February 2010 (UTC)
:The normal issues with this kind of thing is REAL-WORLD publishers being annoying with copyright. I guess if we can find it from the real-world wiki then there is a good chance it is a public domain image.
:There is no way in the world it would hurt an article to have one of these. Although, for fantasy objects, materials, and creatures, there may well be some discussion about if the "Dragon" should be a European, Oriental, or some other dragon (and so on for the rest).
:<font face="FixedSys" color="#00FFFF">[[User:GarrieIrons|Gar]]</font>[[User Talk:GarrieIrons|rie]] 11:52, 7 February 2010 (UTC)
::Well, I've added pictures to some of the layer stones and vermin, as well as all the ores. If anyone is interested, you can link to files on wikimedia commons as if they were internal files now.--[[User:Ar-Pharazon|Ar-Pharazon]] 04:52, 8 February 2010 (UTC)
:::What if those of us with artistic skills were to produce original content for such pages? For example, I could easily do a few drawings depicting certain fantasy creatures as well as actual creatures. --Kydo 22:56, 24 February 2010 (UTC)
::::I don't see how that could even remotely hurt at all.--[[User:Ar-Pharazon|Ar-Pharazon]] 15:21, 12 March 2010 (UTC)
::Who says that the 'Dragon' as a creature isn't a generalization of any species? To be honest, with the graphics as they are, I think that most of Dwarf Fortress comes down to the way the user imagines it, rather than how it appears on screen. Rather like the old text based adventure games of old.--[[Special:Contributions/85.12.64.150|85.12.64.150]] 10:18, 4 March 2010 (UTC)
:::Whoever you are, that is why i don't use a tileset.<font face="FixedSys" color="#00FFFF">[[User:GarrieIrons|Gar]]</font>[[User Talk:GarrieIrons|rie]] 06:15, 6 March 2010 (UTC)
:As a rule of thumb, "graphics" are good things - eye candy, if nothing else. Purty. Use common sense and discretion when choosing (or creating) the image - avoid genre-specific images or anything that is copyrighted (like from an identifiable RPG, for instance), and perhaps add "artist's interpretation" under it, or a selection of (smaller) different images for something like a dragon (tho' I, personally, don't see dwarves with oriental dragons - ymmv.) --[[User:Albedo|Albedo]] 08:49, 6 March 2010 (UTC)
::Seeing as how this is a wiki and what not, why not simple add a western dragon, and if anyone objects to the bias they can add an oriental dragon, so we have two pictures and not only both sides are happy but everyone gets more pictures to look at?--[[User:Ar-Pharazon|Ar-Pharazon]] 15:21, 12 March 2010 (UTC)
:(Also, if you're interested enough to post in the Main Page Discussion, you might want to get an account. Meh.)--[[User:Albedo|Albedo]] 08:49, 6 March 2010 (UTC)

== No link to World Generation? ==

Home page needs a link to World Generation. I thought of adding it, but didn't want to upset the delicate symmetry happing in the menus. Thoughts as to where it could go? [[Special:Contributions/118.208.7.232|118.208.7.232]] 04:25, 19 February 2010 (UTC)

== Namespaces ==

As the subject has been mentioned on the forum:
some articles have been moved to a new 40d namespace. This is intended to make way for the "main" namespace to be reserved for the "current version", which ''real soon now'' will be DF2010.
For the full discussion see [[Dwarf Fortress Wiki:Versions]] and the talk page.
<font face="FixedSys" color="#00FFFF">[[User:GarrieIrons|Gar]]</font>[[User Talk:GarrieIrons|rie]] 10:32, 8 March 2010 (UTC)

Then bloody well move them. These blank 40d pages are making finding information that is supposed to be there very hard to find.

:Agreed..Plus I dont understand the site announcements so i pretty much can't contribute to the wiki right now. Hope you got a stable team to help and are done with it soon. Oh, and a better explanation would be great of course. --[[Special:Contributions/92.202.120.234|92.202.120.234]] 00:10, 4 April 2010 (UTC)
::When is the moving of things to the main namespace going to be complete? Having everything in DF2010 namespace is horribly annoying, and the 40d namespace screws up searches and makes it harder to find stuff via google searches and such. How long is it going to take to get the wiki fixed to the current version, delete all the old d40 stuff, and get rid of the namespaces? --[[User:Aquillion|Aquillion]] 03:40, 7 April 2010 (UTC)

== Tutorials clutter ==

Currently we have in the first box:
*About Dwarf Fortress
*'''Tutorials and guides'''
*'''Quickstart guide (recent)'''
*'''Frequently Asked Questions'''
*'''Your first fortress'''
*'''Video tutorials'''
*'''Important advice'''
*'''Indecisive's Illustrated Tutorial'''
*'''Get help from online chat'''
*Game development
*'''Non-Dwarf's Guide to Rock'''
*'''Starting builds'''

Bolded are the ones I think are redundant. Basically, we have the following categories of stuff:
*Tutorials for newbies: Step by step instructions where you follow what the guide says, without necessarily understanding why right away.
*Guides for newbies: General explanations of game concepts, such as z-level, how to set labors, how to farm, how to work the interface and install a graphical tileset, what the aim of the game is, etc.
*Guides for advanced players: These assume you know how to play the game, and are concerned with optimizing/pushing strategy. Embark build discussions which go beyond explaining the bare minimums you should take (such as "don't embark without a pick!", intended for newbies who may not know what they are doing), megaprojects, combat mechanics, computing, farming strategies, defense strategies, design strategies, macros, world generation parameter discussion and the like.
*FAQ, bugs and troubleshooting: The index of known problems and what to do about them, for when you have a clear question you want to figure out. This includes the FAQ, IRC channels and bugs to watch out for.
That makes 4 categories. Currently, we have 10 categories dealing with the same things. Moreover, the current break down makes no sense, and is obviously not maintained (I think that quickstart guide has been "recent" since early last summer). It's becoming confusing for the clueless first time player who was just linked to Bay12 and the wiki on a forum, and left to fend for itself. In fact, ideally, the tutorials and newbie guides should also be sorted from short to long, with datestamps.

I would rearrange the box myself, but I thought I'd ask what everyone else is thinking first. By the way, are there any tutorials for DF2010, or plans to write any? --[[User:Ar-Pharazon|Ar-Pharazon]] 02:07, 4 April 2010 (UTC)
::By the way, my proposal is to have the box look like this:
::'''Help with Dwarf Fortress'''
::*About Dwarf Fortress
::*How to set up and play Dwarf Fortress (Tutorials)
::*General game information (explanation of basics)
::*Advanced strategies (for experienced players)
::*Troubleshooting: FAQ, where to ask for help, known bugs and issues
::*Game development
::--[[User:Ar-Pharazon|Ar-Pharazon]] 02:14, 4 April 2010 (UTC)

::If [[40d:Quickstart guide]] is obsolete, you should definitely remove the links to it from the front page (both "Your first fortress" and "Quickstart guide" end up there). As a new player pointed at this wiki by the game, I wasted twenty minutes trying to load in the save game (was I being unlucky, or does it simply not work with the new version?) and gave up on trying to play Dwarf Fortress, as a result. --[[User:Gritspeck|Gritspeck]] 16:45, 12 April 2010 (UTC)

:I'm all for this, this is a terrible organization. I like your plan. Given further agreement (or at least no opposition) I say go for it. [[User:Mason11987|Mason]] <sup>([[User talk:Mason11987|T]]-[[Special:Contributions/Mason11987|C]])</sup> 00:38, 15 April 2010 (UTC)

Well, I went ahead and did my best.--[[User:Ar-Pharazon|Ar-Pharazon]] 22:13, 28 May 2010 (UTC)

:I think the frontpage would benefit from highlighting a couple well-written and important pages as well. A "featured article," perhaps. --[[User:Falldog|Falldog]] 01:16, 6 June 2010 (UTC)

::I think it does highlight important pages. See the blue boxes. A 'featured article' would (further) clutter the front page while not being of any value to viewers of the front page or users of this wiki in general. --[[User:Nahno|Nahno]] 17:33, 6 June 2010 (UTC)

::: Let me rephrase. The main page would benefit from the inclusion of links to the most often used reference pages (like the stone summary and the metal summary) than the section on "Playing Dwarf Fortress." It is redundant as there is already a Newbie section and an Advanced tutorials section. I think we agree about that. --[[User:Falldog|Falldog]] 21:22, 7 June 2010 (UTC)

== New modding guide ==
I'm not really sure what the process is for new guides and tutorials. I figured it would be of general community interest, so I'm posting this here; [[User:Tfaal/The Complete Dorf's Guide to Bodies]] --[[User:Tfaal|Tfaal]] 16:43, 5 April 2010 (UTC)

==Bug listings on the Wiki==
Given that the version number is expected to be changing quite rapidly in the near future as bugs are caught and killed, I think it's a good idea to always keep a version number associated with any bug reports we migrate into the wiki pages. This will hopefully minimize confusion as updates gradually remove these. If we could get one of those mini-version tags to use for this purpose or if someone can explain to me how to use that half-sized font for this purpose that would be helpful. Thanks. [[User:Doctorzuber|Doctorzuber]] 16:23, 6 April 2010 (UTC)
:There is already a template for this: [[Template:Version]]. You use it as follows.
:<nowiki>Example.{{version|0.23.130.23a}}</nowiki>
:results in:
:Example.{{version|0.23.130.23a}} --[[User:Soy|Soy]] 16:44, 6 April 2010 (UTC)
:: Thank you, that is all I needed. [[User:Doctorzuber|Doctorzuber]] 17:54, 6 April 2010 (UTC)

== What happened to the link to the dev changelog? ==

There used to be a link to the changelog and a link to the 31_01 release information, but now there's just a link to the release information labeled "changelog." Also the main page appears to use a funny template or something so the link's messed up throughout all of the mainpage history.
:-That's a link I used almost daily. While I realize I'm an idiot for not just bookmarking it, it is a little disconcerting for it to :be gone. Either way, I've always thought it was one of the most relevant links on the main page—it let's you know where the game :project is at ''right now''.
:Wow, forgot sig and indent. I'm amazing. :P ----[[User:Njero|Njero]] 01:03, 8 April 2010 (UTC)
Found the template in question, figured there was no reason for the changelog link not to be there so I put it back; it seemed like it was removed by mistake anyway. Also renamed the link to the release information so there wouldn't be two links entitled "changelog." --[[User:Untelligent|Untelligent]] 02:22, 8 April 2010 (UTC)

==Announcements Hider==
The announcement-hiding script on Briess's page no longer works--it's checking the contents of an id that no longer exists. Replacing the conditional with collapseTable(0) works, but sidesteps the original intent of the conditional, which I presume is to display the options if they've changed since last visit. Does that functionality still apply? While we're at it, is it possible to assign a named value to the collapsible table, so that it can be collapsed without referring to its position relative to other collapsible tables (which breaks the hider script on certain skins)? -[[User:Slitherrr|Slitherrr]]

==How will merging/splitting topics work for backward compatibility linking==
I got thinking about this when helping work on the military pages, we're branching this out into squads/military/schedule/etc. because of how much more complex things have suddenly got with the military system. It was a natural direction to take things. What's the correct way to handle backward compatibility links in this situation? And now that I'm thinking about it, how about page merging? If we decide to merge anything how will that be handled? [[User:Doctorzuber|Doctorzuber]] 03:59, 9 April 2010 (UTC)

== Game object date boxes ==

These boxes on the creature pages need some kind of text formatting to stop them expanding to far. Just an example try the [[dog|dog]] page. --[[User:AKAfreaky|AKAfreaky]] 12:54, 11 April 2010 (UTC)

== Carrying over saved games? ==

Hi, is it possible to carry over savegames from one version to the next, and if so, how do I do this? Thanks [[User:EddyP|EddyP]] 10:27, 13 April 2010 (UTC)
:It is possible - go to the /data folder and just copy the file called "save" to the /data folder in the new DF. You'll then have to edit the raws in each region folder (inside the save folder) to match the new raws in the main /raw folder (or just copy them over). --[[User:AKAfreaky|AKAfreaky]] 20:22, 13 April 2010 (UTC)
::As long as the "different versions" are within the same "generation" of Dwarf Fortress (i.e. 0.21 thru 0.23, 0.27 thru 0.28, or 0.31), this'll work. If you actually try to copy a saved game from 0.28.101.40d to 0.31.xx, expect it to fail in a very spectacular way. --[[User:Quietust|Quietust]] 20:51, 13 April 2010 (UTC)

==Quote wrong on main page==
The quote on the main page comes up with something to the effect that you cannot milk creatures. This was true for 40d, but not for the most recent edition.--[[User:Kwieland|Kwieland]] 12:23, 21 April 2010 (UTC)
: ''"The alert statuses (i.e., "Stay Indoors") have been entirely redone. You may set several custom alerts with user defined scheduling."''
: Is this really intended to be a main page quote? I thought the main pages quotes were usually . . . funny. [[User:Doctorzuber|Doctorzuber]] 02:38, 27 April 2010 (UTC)

== "Your ad here, free!" ==

What's up with another ad space on the bottom of every page? We're getting to a point where more ads just cause more annoyance, not more profit. {{unsigned|213.157.252.41}}
:There are ads? Where? *turns off adblock* OH HOLY CRAP *quickly turns adblock back on* Yeah, if there are more ads than page it kinda defeats the point doesn't it? [[User:Volatar|Volatar]] 14:00, 5 May 2010 (UTC)
::The ad stuff is trying to get a baseline for different types of ads. We're hoping the button ads perform well enough that we can get rid of the larger banner ads. In 5 or so days the number of ads will decrease depending on what we find. [[user:Emi|<span style="color:#8a4e4e">Emi</span>]] [[user_talk:Emi|<span style="color:#6a3e4e">[T]</span>]] 20:31, 5 May 2010 (UTC)
::Also, the "free" part is that ads with no bids can be obtained freely, but that'll disappear in the next few days as the ads establish a page view trend. (Which is why in 5 or so days we'll be getting rid of some ads.) [[user:Emi|<span style="color:#8a4e4e">Emi</span>]] [[user_talk:Emi|<span style="color:#6a3e4e">[T]</span>]] 20:33, 5 May 2010 (UTC)
:::Good enough. Thanks for the explanation! {{unsigned|213.157.252.41}}

::There are ads?? *switches to IE* oh, yeah, ads.. *switches back to opera* --[[Special:Contributions/92.202.79.42|92.202.79.42]] 11:48, 9 June 2010 (UTC)

== "The wiki currently has 3 articles. " ==

I'm assuming this has something to do with the recent namespace thing? --[[Special:Contributions/217.132.92.69|217.132.92.69]] 10:27, 6 May 2010 (UTC)
:Haha, yes, I'll get right on that. [[user:Emi|<span style="color:#8a4e4e">Emi</span>]] [[user_talk:Emi|<span style="color:#6a3e4e">[T]</span>]] 18:04, 6 May 2010 (UTC)
::Looks like someone beat me too it. :( [[user:Emi|<span style="color:#8a4e4e">Emi</span>]] [[user_talk:Emi|<span style="color:#6a3e4e">[T]</span>]] 18:05, 6 May 2010 (UTC)

== Quality ==
I really like how the bar is counting down to zero. Keep templating, rawing and tableing all you want, eventually you will have to face the truth: to make a helpful wiki you need to ''play'' the game and add ''content''. --[[Special:Contributions/68.161.167.37|68.161.167.37]] 02:09, 9 May 2010 (UTC)
:What are you objecting to? Someone said it would be a good idea to know "how close to 'complete' the wiki is", we did that. If you don't like it then you don't have to look at it. I'd also like to ask why you think you have such a right to critisize others work after your... 3 edits? [[User:Mason11987|Mason]] <sup>([[User talk:Mason11987|T]]-[[Special:Contributions/Mason11987|C]])</sup> 17:26, 10 May 2010 (UTC)
::I think the big problem is that the vast majority of 40d pages are still completely accurate or near-completely accurate to the new version, but little to no effort has been made to port them over. Now that the latest version has been out for a while, I think it's reasonable to say that it's obvious that 'nuking' the 40d version by forcing it into a separate namespace instead of just trying to update it normally was a terrible mistake -- as was setting up this wretched namespace system, given that this is intended to be the ''last'' such gap between releases. The change from 40d to 2010 wasn't nearly as sweeping in terms of underlying mechanics as some people on the Wiki thought it would be -- but now, because of the way the changeover was mishandled here, we're left basically rewriting or copy-pasting a bunch of pages for stuff that hasn't changed, and nobody actually wants to waste time doing that when perfectly good and accurate articles exist in 40d namespace. Look at [[Animal Trap]], say -- the 40d version is detailed and near-perfectly accurate to DF2010, while the DF2010 version is barely more than a stubby paragraph. This happens all over the place, because people were eager to rewrite (or create) the articles related to stuff that changed, but nobody wanted to waste time rewriting all the relatively accurate articles that were mindlessly pushed into a separate namespace in the botched shift. --[[User:Aquillion|Aquillion]] 16:51, 9 July 2010 (UTC)

== Legacy? SDL? ==
Could someone explain the difference between the legacy and SDL releases? Seems that information ought to be around here somewhere. Can't seem to find it if it is. --[[User:Doctorzuber|Doctorzuber]] 00:12, 21 June 2010 (UTC)
:From my guess, Legacy is the old version (without SDL), and the SDL... well you get it. --[[User:Hugna|Hugna]] 03:55, 21 June 2010 (UTC)
== New website==
I've got a new website up and running with drupal. It is about dwarf fortress and you can find it [http://darkcloudterrace.dyndns.info/drupal6/ Here darkcloudterrace] it has a forum for dwarf fortress

== Download Mirrors Working or Broken ==

I can't seem to download df_31_13 from any of the three mirrors on the front page. Is anyone else having a problem with them?
--[[Special:Contributions/208.81.12.34|208.81.12.34]] 12:55, 16 September 2010 (UTC)

== Unworthy Self-link ==

Would it be improper to add a link to [[Bentgirder]] on the home page?

== Dwarf Forttress Wiki Portable ==
Hello all.
I'm building a portable, well somewhat portable, version of the Dwarf Fortress Wiki site. It is being made with Personal Brain (www.thebrain.com) and I will be importing everything I can find.
Admittedly I will need some help with this project. Any volunteers?--[[User:SpyMaster356|SpyMaster356]] 20:58, 4 October 2010 (UTC)

And another note: The finished "Brain" can be used as a navigator for this wiki too.--[[User:SpyMaster356|SpyMaster356]] 21:00, 4 October 2010 (UTC)

I'm sorry to say at this rate, that finishing the first wiki is more helpful that creating a new one. -- KingAuggie

== Front Page Links ==
I recently added [[Industry]] as a front page link, as well as [[Important Advice]] and others, but I'm afraid that, for a helpful wiki, we need to group things better, into more "portal pages". This wiki is edited only by seasoned guys like us, but is sposed to be read by noobs. At the moment, there are far too many choices to make, even in the "New to DF" box. Any thoughts on thinning the herd? Maybe create a new page that can then direct people elsewhere? -- KingAuggie

* I vote for removing the 'New To Dwarf Fortress?' block, making a page with its contents and more, and linking to that page with a nice big link under the "Playing Dwarf Fortress" section. Something like "Beginners Go Here" centered and at the top of the section. [[User:Calite|Calite]] 17:43, 15 January 2011 (UTC)

== [[User:Esitowipefy]] ==

:{{gametext|Esitowipefy, Troll, has gone berserk!|4:1}}
Personal advice: <del>[[Unfortunate accident]]</del> ban. Please kick this user as far as you can and make a *warning sign* out of his skin. --[[Special:Contributions/212.201.74.67|212.201.74.67]] 23:04, 17 November 2010 (UTC)
:: I concur. Avast was warning me that the links were attempting to download a trojan horse, just making him worse. [[User:Neo Kabuto|Neo Kabuto]] 23:07, 17 November 2010 (UTC)
::: Done. --[[User:Quietust|Quietust]] 00:25, 18 November 2010 (UTC)
Same thing with http://df.magmawiki.com/index.php/User:Westhara. For one thing, he just changed the main page to nothing! Someone else fixed it. I would've, but DF wiki was dragging it's feet on sending me my confirmation e-mail. --[[User:Waladil|Waladil]] 15:27, 30 January 2011 (UTC)

== Please redirect... ==

...[[DF2010:Glob]] to [[DF2010:Fat]]. Anonymous page creation is currently prohibited. Thanks :). --[[Special:Contributions/217.225.113.232|217.225.113.232]] 23:41, 29 December 2010 (UTC)

== Flash Blind! ==
Gah! Dorf Fort has a black background. This site has a white background. Every time I switch from DF to magmawiki I get blinded by the light. Does anyone else have this problem? And if so, should we change it? [[Special:Contributions/76.21.249.47|76.21.249.47]] 03:33, 29 January 2011 (UTC)
:Ha! Sounds to me like you just need to turn down the brightness on your screen. Then again, the fawn background at the [http://www.uesp.net/wiki/Oblivion:Oblivion Oblivion wiki] is very attractive... Maybe you're onto something... [[User:Bognor|Bognor]] 05:15, 29 January 2011 (UTC)

== Why is there no pages on Body Detail Plan Tokens or Creatue Variation Tokens? ==

Can it really be that nobody other than Toady himself knows how these tokens actually work? And if not, why don't these types of tokens have their own wiki pages? I for one would put one in myself but I don't know how to create a new page or have much significant info on how these tokens work. But even a mostly empty page consisting only of a note asking for help from other wiki contributors would be better than the nothing that we have on these topics now.

v0.31:Position token

2011-02-20T00:07:47Z

Bohandas: Added Related Tokens section

{{av}}
These tokens define positions in entity_*.txt files. See {{l|Entity token}}.
==Position Tokens==
These tokens belong in an entity definition. These tokens apply to a position (such as monarch, dungeon master, etc) and should follow the [POSITION:POSITION_NAME] token.

{| {{prettytable}}
|- bgcolor="#ddd"
! Token
! Arguments
! Description

|-
| ALLOWED_CLASS
| ???
| Unknown. Found in String Dump. (May restrict position holders by CREATURE_CLASS???)

|-
| ALLOWED_CREATURE
| ???
| Unknown. Found in String Dump.

|-
| APPOINTED_BY
| position
| The position used as an argument selects creatures to fill the role in question. For example, the GENERAL is [APPOINTED_BY:MONARCH].

|-
| BRAG_ON_KILL
|
| A creature that kills this position will be sure to talk about it a lot.

|-
| CHAT_WORTHY
|
| In adventure mode, when referencing locations an NPC may mention this position holder living there or having done some deed there.

|-
| COLOR
| color
| Creatures of this position will have this colour, instead of their profession colour. e.g. [COLOR:5:0:1]

|-
| COMMANDER
| position:ALL
| This position will act as a commander of the specified position{{verify}}. E.g. GENERAL is [COMMANDER:LIEUTENANT:ALL]. Unknown if values other than ALL work.

|-
| CONQUERED_SITE
|
| This position will be available to creatures when the site has been taken over by another civilisation.

|-
| DEMAND_MAX
| number
| How many demands at one time the position can make of the population.

|-
| DETERMINES_COIN_DESIGN
|
| Coins minted will have images that reflect the personality of this position holder.

|-
| DO_NOT_CULL
|
| The position won't be culled during world generation.{{verify}}

|-
| DUTY_BOUND
|
| Members of this position will never agree to 'join' your character during adventure mode.

|-
| ELECTED
|
| The population will periodically select the creature to fill this position.

|-
| EXPORTED_IN_LEGENDS
|
| The various members who have filled this role will be listed in the civilisation's history.

|-
| FLASHES
|
| The creature holding this position will flash on the display.

|-
| GENDER
|
*MALE
*FEMALE
| The position can only be held by specified gender.

|-
| KILL_QUEST
|
| The position can assign quests to adventurers.

|-
| LAND_HOLDER
| number
| The position will arrive when the LAND_HOLDER_TRIGGER in the entity definition has been met.

|-
| LAND_NAME
| string
| The name the area takes on when under the control of a LAND_HOLDER. E.g. for the DUKE, [LAND_NAME:a duchy]

|-
| MANDATE_MAX
| number
| The maximum number of mandates the position can make at once.

|-
| MENIAL_WORK_EXEMPTION
|
| The position cannot be assigned labours, and will generally just lounge around like nobles do.

|-
| MENIAL_WORK_EXEMPTION_SPOUSE
|
| The lover of the position holder doesn't have to work, either.

|-
| NAME
| singular:plural
| The name of the position.

|-
| NAME_MALE
| singular:plural
| If the creature holding the position is male, this is the position's name. E.g. for MONARCH, [NAME_MALE:king:kings]

|-
| NAME_FEMALE
| singular:plural
| If the creature holding the position is female, this is the position's name. E.g. for MONARCH, [NAME_FEMALE:queen:queens]

|-
| NUMBER
|
* number
* AS_NEEDED
| How many of the position there should be. If the [SITE] token exists, this is per site, otherwise this is per civilisation.

|-
| PRECEDENCE
| number
| How important the position is in society; a lower number is more important. For MONARCH it's 1, for MILITIA_CAPTAIN it's 200. Unknown if it accepts values greater than 200.{{verify}}

|-
| PUNISHMENT_EXEMPTION
|
| The position holder will not be held accountable for his or her crimes.

|-
| REJECTED_CLASS
| ???
| Unknown. Found in String Dump. (May restrict position holders by CREATURE_CLASS???)

|-
| REJECTED_CREATURE
| ???
| Unknown. Found in String Dump.

|-
| REPLACED_BY
| position
| For when one position is a lesser form of another. For example, expedition leader is [REPLACED_BY:MAYOR].

|-
| REQUIRED_BEDROOM
| number
| The position holder requires a bedroom with at least this value.

|-
| REQUIRED_BOXES
| number
| The position holder requires at least this many boxes.

|-
| REQUIRED_CABINETS
| number
| The position holder requires at least this many cabinets.

|-
| REQUIRED_DINING
| number
| The position holder requires a dining room with at least this value.

|-
| REQUIRED_OFFICE
| number
| The position holder requires an office with at least this value.

|-
| REQUIRED_RACKS
| number
| The position holder requires at least this many weapon racks.

|-
| REQUIRED_STANDS
| number
| The position holder requires at least this many armour stands.

|-
| REQUIRED_TOMB
| number
| The position holder requires a tomb with at least this value.

|-
| REQUIRES_POPULATION
| number
| The position requires the population to be at least this number before it becomes available or before the position holder will move in.

|-
| RESPONSIBILITY
| responsibility
| See the table below for the available responsibility tokens. E.g. [RESPONSIBILITY:TAME_EXOTICS]

|-
| RULES_FROM_LOCATION
|
| Unknown{{verify}}

|-
| SITE
|
| The civilisation will attempt to have this position separate for each site.

|-
| SLEEP_PRETENSION
|
| The position holder will get upset if someone with a higher precedence holds quarters with a greater value than their own.{{verify}}

|-
| SPOUSE_FEMALE
| singular:plural
| The name of the position holder's spouse if they (the spouse) are female.

|-
| SPOUSE_MALE
| singular:plural
| The name of the position holder's spouse if they (the spouse) are male.

|-
| SQUAD
| number:singular:plural
| The position holder will be accompanied by this many whatevers; e.g. for HAMMERER, [SQUAD:10:royal guard:royal guards]

|-
| SUCCESSION
|
* BY_HEIR
* BY_POSITION:position
| How a new position holder is chosen.

|}

== Responsibilities ==
{| {{prettytable}}
|- bgcolor="#ddd"
! Argument
! Description

|-
| ACCOUNTING
| Found on bookkeeper. Position will keep track of stocks.

|-
| ATTACK_ENEMIES
| Found on elven ranger captain and human warrior. Effect{{verify}}

|-
| BUILD_MORALE
| Found on champion. Effect{{verify}}

|-
| COLLECT_TAXES
| Found on tax collector. Effect{{verify}}

|-
| EQUIPMENT_MANIFESTS
| Found on arsenal dwarf. Effect{{verify}}

|-
| ESCORT_TAX_COLLECTOR
| Found on hammerer. Position will accompiany the COLLECT_TAXES position{{verify}}

|-
| ESTABLISH_COLONY_TRADE_AGREEMENTS
| Found on outpost liaison. Position will make trade agreements with the civilisation's colonies.

|-
| EXECUTIONS
| Found on hammerer. Position will deliver beatings for great justice.

|-
| HEALTH_MANAGEMENT
| Found on chief medical dwarf. Enables the {{key|z}} menu health screen. Other effect{{verify}}

|-
| LAW_ENFORCEMENT
| Found on sheriff/captain of the guard. Position is in charge of imprisoning criminals.

|-
| LAW_MAKING
| Found on monarch/landholders. Effect{{verify}}

|-
| MAKE_INTRODUCTIONS
| Found on diplomat. Effect{{verify}}

|-
| MAKE_PEACE_AGREEMENTS
| Found on diplomat. Required for a civilisation to end a war{{verify}}

|-
| MAKE_TOPIC_AGREEMENTS
| Found on diplomat. Effect{{verify}}

|-
| MANAGE_PRODUCTION
| Found on manager. Position will verify work orders.

|-
| MEET_WORKERS
| Found on expedition leader/mayor. Dwarves want one of these around to complain to{{verify}}

|-
| MILITARY_GOALS
| Found on monarch/landholder/leaders. Effect{{verify}}

|-
| MILITARY_STRATEGY
| Found on general/militia commander. Effect{{verify}}

|-
| PATROL_TERRITORY
| Found on elven ranger captain and human warrior. Effect{{verify}}

|-
| RECEIVE_DIPLOMATS
| Found on monarch/landholder/leaders. Position will hold meetings with incoming diplomats/liaisons.

|-
| RELIGION
| Found on elven druid. Effect{{verify}}

|-
| SORT_AMMUNITION
| Found on arsenal dwarf. Effect{{verify}}

|-
| TAME_EXOTICS
| Found on dungeon master. Position will tame creatures with the [PET_EXOTIC] token.

|-
| TRADE
| Found on broker. Position will trade at the depot when set to broker only. When applied to other civilizations, the position will arrive with the caravan to make trade agreements.

|-
| UPGRADE_SQUAD_EQUIPMENT
| Found on arsenal dwarf. Effect{{verify}}

|}

== Related Tokens ==
The following two ENTITY tokens are not actually position tokens, but bear mentioning on this page because they can modify the way that a civilization's positions behave:

{| {{prettytable}}
|- bgcolor="#ddd"
! Token
! Arguments
! Description

|-
| 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.

|-
| VARIABLE_POSITIONS
| Position responsibility or ALL
| Allows a responsibility to be taken up by a dynamically generated position (such as Law-maker).

|}

== Why Won't My Positions Appear? ==
The way DF determines what positions will actually ''appear'' in your fortress is somewhat counterintuitive and fairly limiting. This guide should help you understand what you can do to actually get your positions working properly.

There are five tokens governing which positions appear in your fortress - LAND_HOLDER, REQUIRES_POPULATION, APPOINTED_BY, ELECTED, and REPLACED_BY. The first two determine when your fortress is eligible for a new position, the next two determine how a new position for which your fortress is eligible can be added, and the fifth allows you to clear up obsolete positions. Unfortunately, they also interact in some strange ways that makes creating interesting position structures difficult.

When you start a new fortress, DF compiles a list of your initial positions. To do this, it looks at the requirements for each position - any position whose only requirement is less than seven dwarves (either because they have no requirement tokens, or because their only requirement tokens are [REQUIRES_POPULATION: =< 7] or [LAND_HOLDER:some trigger whose only requirement is some number of dwarves equal to or less than 7]). Most importantly, ''any'' position whose only requirement is a LAND_HOLDER requirement, regardless of what the trigger for that requirement is, will be added if another eligible starting position is REPLACED_BY it. '''A non-LAND_HOLDER position that is REPLACED_BY a LAND_HOLDER position will never appear.''' With this list compiled, the game culls all positions that are REPLACED_BY another eligible position, and then culls all positions that have the APPOINTED_BY token. '''You may not embark with any appointed positions.''' Any remaining positions are then filled by a dwarf chosen at random.

'''Positions do not automatically appear when you reach their requirements.''' For example, if you remove the ELECTED token from the Mayor, then the Mayor will never appear, even once you reach his required number of dwarves. '''For a position that does not appear at embark to appear in your fortress, it must be APPOINTED_BY another position or ELECTED.'''

Naturally, this is more complicated than it looks. '''APPOINTED_BY positions must be appointed by another position already in your fortress, or a civ-level position. Only LAND_HOLDER positions may be appointed by civ-level positions.''' LAND_HOLDER positions that are APPOINTED_BY civ-level positions are inherently tied to civ-level tokens with the ESTABLISH_COLONY_TRADE_AGREEMENTS responsibility. If a fortress meets the LAND_HOLDER_TRIGGER for a new LAND_HOLDER tier when a caravan leaves, then the next time the outpost liaison or equivalent arrives, he will offer to make you an official colony, which will allow you to select all positions for that LAND_HOLDER level. '''Each time he appears, the outpost liaison will only promote your fortress one tier up the LAND_HOLDER track.''' The biggest problem with this system is that you may set your LAND_HOLDER_TRIGGERS such that you are eligible for the first tier of LAND_HOLDER positions at embark. '''If you are eligible for the first tier of LAND_HOLDER positions at embark, then all first-tier positions will appear twice - once at embark, and again when the outpost liaison comes to appoint you to the first tier.'''

{{Category|Modding}}
{{Category|Tokens}}

v0.31:Position token

2011-02-20T00:00:00Z

Bohandas: Added possible function for ALLOWED_CLASS and REJECTED_CLASS based on preliminary testing by D_E

{{av}}
These tokens define positions in entity_*.txt files. See {{l|Entity token}}.
==Position Tokens==
These tokens belong in an entity definition. These tokens apply to a position (such as monarch, dungeon master, etc) and should follow the [POSITION:POSITION_NAME] token.

{| {{prettytable}}
|- bgcolor="#ddd"
! Token
! Arguments
! Description

|-
| ALLOWED_CLASS
| ???
| Unknown. Found in String Dump. (May restrict position holders by CREATURE_CLASS???)

|-
| ALLOWED_CREATURE
| ???
| Unknown. Found in String Dump.

|-
| APPOINTED_BY
| position
| The position used as an argument selects creatures to fill the role in question. For example, the GENERAL is [APPOINTED_BY:MONARCH].

|-
| BRAG_ON_KILL
|
| A creature that kills this position will be sure to talk about it a lot.

|-
| CHAT_WORTHY
|
| In adventure mode, when referencing locations an NPC may mention this position holder living there or having done some deed there.

|-
| COLOR
| color
| Creatures of this position will have this colour, instead of their profession colour. e.g. [COLOR:5:0:1]

|-
| COMMANDER
| position:ALL
| This position will act as a commander of the specified position{{verify}}. E.g. GENERAL is [COMMANDER:LIEUTENANT:ALL]. Unknown if values other than ALL work.

|-
| CONQUERED_SITE
|
| This position will be available to creatures when the site has been taken over by another civilisation.

|-
| DEMAND_MAX
| number
| How many demands at one time the position can make of the population.

|-
| DETERMINES_COIN_DESIGN
|
| Coins minted will have images that reflect the personality of this position holder.

|-
| DO_NOT_CULL
|
| The position won't be culled during world generation.{{verify}}

|-
| DUTY_BOUND
|
| Members of this position will never agree to 'join' your character during adventure mode.

|-
| ELECTED
|
| The population will periodically select the creature to fill this position.

|-
| EXPORTED_IN_LEGENDS
|
| The various members who have filled this role will be listed in the civilisation's history.

|-
| FLASHES
|
| The creature holding this position will flash on the display.

|-
| GENDER
|
*MALE
*FEMALE
| The position can only be held by specified gender.

|-
| KILL_QUEST
|
| The position can assign quests to adventurers.

|-
| LAND_HOLDER
| number
| The position will arrive when the LAND_HOLDER_TRIGGER in the entity definition has been met.

|-
| LAND_NAME
| string
| The name the area takes on when under the control of a LAND_HOLDER. E.g. for the DUKE, [LAND_NAME:a duchy]

|-
| MANDATE_MAX
| number
| The maximum number of mandates the position can make at once.

|-
| MENIAL_WORK_EXEMPTION
|
| The position cannot be assigned labours, and will generally just lounge around like nobles do.

|-
| MENIAL_WORK_EXEMPTION_SPOUSE
|
| The lover of the position holder doesn't have to work, either.

|-
| NAME
| singular:plural
| The name of the position.

|-
| NAME_MALE
| singular:plural
| If the creature holding the position is male, this is the position's name. E.g. for MONARCH, [NAME_MALE:king:kings]

|-
| NAME_FEMALE
| singular:plural
| If the creature holding the position is female, this is the position's name. E.g. for MONARCH, [NAME_FEMALE:queen:queens]

|-
| NUMBER
|
* number
* AS_NEEDED
| How many of the position there should be. If the [SITE] token exists, this is per site, otherwise this is per civilisation.

|-
| PRECEDENCE
| number
| How important the position is in society; a lower number is more important. For MONARCH it's 1, for MILITIA_CAPTAIN it's 200. Unknown if it accepts values greater than 200.{{verify}}

|-
| PUNISHMENT_EXEMPTION
|
| The position holder will not be held accountable for his or her crimes.

|-
| REJECTED_CLASS
| ???
| Unknown. Found in String Dump. (May restrict position holders by CREATURE_CLASS???)

|-
| REJECTED_CREATURE
| ???
| Unknown. Found in String Dump.

|-
| REPLACED_BY
| position
| For when one position is a lesser form of another. For example, expedition leader is [REPLACED_BY:MAYOR].

|-
| REQUIRED_BEDROOM
| number
| The position holder requires a bedroom with at least this value.

|-
| REQUIRED_BOXES
| number
| The position holder requires at least this many boxes.

|-
| REQUIRED_CABINETS
| number
| The position holder requires at least this many cabinets.

|-
| REQUIRED_DINING
| number
| The position holder requires a dining room with at least this value.

|-
| REQUIRED_OFFICE
| number
| The position holder requires an office with at least this value.

|-
| REQUIRED_RACKS
| number
| The position holder requires at least this many weapon racks.

|-
| REQUIRED_STANDS
| number
| The position holder requires at least this many armour stands.

|-
| REQUIRED_TOMB
| number
| The position holder requires a tomb with at least this value.

|-
| REQUIRES_POPULATION
| number
| The position requires the population to be at least this number before it becomes available or before the position holder will move in.

|-
| RESPONSIBILITY
| responsibility
| See the table below for the available responsibility tokens. E.g. [RESPONSIBILITY:TAME_EXOTICS]

|-
| RULES_FROM_LOCATION
|
| Unknown{{verify}}

|-
| SITE
|
| The civilisation will attempt to have this position separate for each site.

|-
| SLEEP_PRETENSION
|
| The position holder will get upset if someone with a higher precedence holds quarters with a greater value than their own.{{verify}}

|-
| SPOUSE_FEMALE
| singular:plural
| The name of the position holder's spouse if they (the spouse) are female.

|-
| SPOUSE_MALE
| singular:plural
| The name of the position holder's spouse if they (the spouse) are male.

|-
| SQUAD
| number:singular:plural
| The position holder will be accompanied by this many whatevers; e.g. for HAMMERER, [SQUAD:10:royal guard:royal guards]

|-
| SUCCESSION
|
* BY_HEIR
* BY_POSITION:position
| How a new position holder is chosen.

|}

== Responsibilities ==
{| {{prettytable}}
|- bgcolor="#ddd"
! Argument
! Description

|-
| ACCOUNTING
| Found on bookkeeper. Position will keep track of stocks.

|-
| ATTACK_ENEMIES
| Found on elven ranger captain and human warrior. Effect{{verify}}

|-
| BUILD_MORALE
| Found on champion. Effect{{verify}}

|-
| COLLECT_TAXES
| Found on tax collector. Effect{{verify}}

|-
| EQUIPMENT_MANIFESTS
| Found on arsenal dwarf. Effect{{verify}}

|-
| ESCORT_TAX_COLLECTOR
| Found on hammerer. Position will accompiany the COLLECT_TAXES position{{verify}}

|-
| ESTABLISH_COLONY_TRADE_AGREEMENTS
| Found on outpost liaison. Position will make trade agreements with the civilisation's colonies.

|-
| EXECUTIONS
| Found on hammerer. Position will deliver beatings for great justice.

|-
| HEALTH_MANAGEMENT
| Found on chief medical dwarf. Enables the {{key|z}} menu health screen. Other effect{{verify}}

|-
| LAW_ENFORCEMENT
| Found on sheriff/captain of the guard. Position is in charge of imprisoning criminals.

|-
| LAW_MAKING
| Found on monarch/landholders. Effect{{verify}}

|-
| MAKE_INTRODUCTIONS
| Found on diplomat. Effect{{verify}}

|-
| MAKE_PEACE_AGREEMENTS
| Found on diplomat. Required for a civilisation to end a war{{verify}}

|-
| MAKE_TOPIC_AGREEMENTS
| Found on diplomat. Effect{{verify}}

|-
| MANAGE_PRODUCTION
| Found on manager. Position will verify work orders.

|-
| MEET_WORKERS
| Found on expedition leader/mayor. Dwarves want one of these around to complain to{{verify}}

|-
| MILITARY_GOALS
| Found on monarch/landholder/leaders. Effect{{verify}}

|-
| MILITARY_STRATEGY
| Found on general/militia commander. Effect{{verify}}

|-
| PATROL_TERRITORY
| Found on elven ranger captain and human warrior. Effect{{verify}}

|-
| RECEIVE_DIPLOMATS
| Found on monarch/landholder/leaders. Position will hold meetings with incoming diplomats/liaisons.

|-
| RELIGION
| Found on elven druid. Effect{{verify}}

|-
| SORT_AMMUNITION
| Found on arsenal dwarf. Effect{{verify}}

|-
| TAME_EXOTICS
| Found on dungeon master. Position will tame creatures with the [PET_EXOTIC] token.

|-
| TRADE
| Found on broker. Position will trade at the depot when set to broker only. When applied to other civilizations, the position will arrive with the caravan to make trade agreements.

|-
| UPGRADE_SQUAD_EQUIPMENT
| Found on arsenal dwarf. Effect{{verify}}

|}

== Why Won't My Positions Appear? ==
The way DF determines what positions will actually ''appear'' in your fortress is somewhat counterintuitive and fairly limiting. This guide should help you understand what you can do to actually get your positions working properly.

There are five tokens governing which positions appear in your fortress - LAND_HOLDER, REQUIRES_POPULATION, APPOINTED_BY, ELECTED, and REPLACED_BY. The first two determine when your fortress is eligible for a new position, the next two determine how a new position for which your fortress is eligible can be added, and the fifth allows you to clear up obsolete positions. Unfortunately, they also interact in some strange ways that makes creating interesting position structures difficult.

When you start a new fortress, DF compiles a list of your initial positions. To do this, it looks at the requirements for each position - any position whose only requirement is less than seven dwarves (either because they have no requirement tokens, or because their only requirement tokens are [REQUIRES_POPULATION: =< 7] or [LAND_HOLDER:some trigger whose only requirement is some number of dwarves equal to or less than 7]). Most importantly, ''any'' position whose only requirement is a LAND_HOLDER requirement, regardless of what the trigger for that requirement is, will be added if another eligible starting position is REPLACED_BY it. '''A non-LAND_HOLDER position that is REPLACED_BY a LAND_HOLDER position will never appear.''' With this list compiled, the game culls all positions that are REPLACED_BY another eligible position, and then culls all positions that have the APPOINTED_BY token. '''You may not embark with any appointed positions.''' Any remaining positions are then filled by a dwarf chosen at random.

'''Positions do not automatically appear when you reach their requirements.''' For example, if you remove the ELECTED token from the Mayor, then the Mayor will never appear, even once you reach his required number of dwarves. '''For a position that does not appear at embark to appear in your fortress, it must be APPOINTED_BY another position or ELECTED.'''

Naturally, this is more complicated than it looks. '''APPOINTED_BY positions must be appointed by another position already in your fortress, or a civ-level position. Only LAND_HOLDER positions may be appointed by civ-level positions.''' LAND_HOLDER positions that are APPOINTED_BY civ-level positions are inherently tied to civ-level tokens with the ESTABLISH_COLONY_TRADE_AGREEMENTS responsibility. If a fortress meets the LAND_HOLDER_TRIGGER for a new LAND_HOLDER tier when a caravan leaves, then the next time the outpost liaison or equivalent arrives, he will offer to make you an official colony, which will allow you to select all positions for that LAND_HOLDER level. '''Each time he appears, the outpost liaison will only promote your fortress one tier up the LAND_HOLDER track.''' The biggest problem with this system is that you may set your LAND_HOLDER_TRIGGERS such that you are eligible for the first tier of LAND_HOLDER positions at embark. '''If you are eligible for the first tier of LAND_HOLDER positions at embark, then all first-tier positions will appear twice - once at embark, and again when the outpost liaison comes to appoint you to the first tier.'''

{{Category|Modding}}
{{Category|Tokens}}