Dwarf Fortress Wiki - User contributions [en]

Werebeast

2015-07-12T03:43:11Z

ArKFallen: /* Infecting your entire fort */

{{Quality|Superior|18:31, 27 October 2013 (UTC)}}
{{av}}

'''Werebeasts''' {{Tile|Ñ|6:0}} are [[night creature|night creatures]] that are procedurally created during worldgen. [[Deity|Deities]] may curse sentient creatures (including any animal man) to transform into an animal form on the night of a full moon. Sentient creatures bitten by werebeasts are cursed to become werebeasts themselves.{{cite forum|126618}}

Werebeasts may take the form of mammals or reptiles, including animals that do not exist in Dwarf Fortress, like iguanas.

The behaviour of vanilla werebeasts in worldgen (i.e. fleeing town upon being cursed and conducting raids from their new lair) appears to be caused by the cursed individual's beast form having the [NIGHT_CREATURE_HUNTER] tag; removal of this tag from a generated werebeast extracted from a world.dat file and jimmied into the standard raws caused those cursed to behave no differently from any other unnaturally-immortal individual.

==Werebeasts in Fortresses==
In some regions, the full moon will herald the attack of werebeasts upon your fortress (triggering a message similar to the one that is shown when a Megabeast attacks), or instead the unwilling transformation of your own citizens into their bestial forms. The cursed will attack anyone they can find for the duration of the full moon, spreading their affliction even further.
Werebeasts of the same species will cooperate with each other and not normally fight, but those of different species will treat each other no differently than enemies.

==Defending your fort against werebeasts==

If you have not yet established a correct defensive perimeter and a steady, trained militia, it is quite likely that if a werebeast attacks, a dwarf will be attacked and bitten.

If a dwarf is attacked but not bitten, he will be just fine (if he survives the ordeal). If a dwarf has been bitten by a werebeast and survives, however, he has a high chance to change when the next full moon comes.

There is no cure. To protect your other dwarves you should either keep the infected dwarf in an inaccessible pit so he does not infect your whole fortress, or if you do not want to take care of him, just kill him.

Infected dwarves will not die of old age{{Verify}} and do not need food and drink. They may go mad, however, so if you want to make him work (or use him for a [[stupid dwarf trick]]) you should try to keep him happy. This can be difficult because werebeasts will not sleep or eat, though they will drink if alcohol is available.

Or maybe you want something exceedingly more [[fun]] instead? Try the following.

==Infecting your entire fort==

Yes, it is possible. Having only infected dwarves does not end your game.

'''Pros:'''
* Super-effective hospital service, your dwarves are fully healed once per month. No need for crutches or something.
* No need for food or drink, though you can keep alcohol around for happy thoughts and to avoid alcohol withdrawal
* No need for beds or bedrooms other than those for nobles
* When transformed, civilian dwarves are less vulnerable
* Dwarves will happily discard their old tattered clothing and pick up fresh clothes every month.
* Unhappy thoughts are less severe as the process of being bitten and biting others tends to make your dwarves very resilient to tragedy.
* Go for were-elephants or were-badgers for extra dwarven points
* Fun
'''Cons:'''
* Exceedingly difficult to set up, quite long as well
* May kill your most important dwarves
* When transformed, fortress activity grinds to a halt, and for a few days afterwards as civilians run around finding new clothing
* Werebeasts are building destroyers, so you'll constantly need to remake workshops and most furniture
* Trading is especially difficult
* <s>May</s> WILL cause issues with military when transformed : dwarf armor is too small for werebeasts, though they will hold onto their weapons and shields, and even quivers/bolts during transformation.
* May be exceedingly fun for [[Thought|dwarven]] [[Tantrum|sanity]]... but then again you ''were'' looking for fun in the first place

There are several ways to attempt to infect your whole fort, some with higher success rates than others. The trick is to have your uncursed dwarves be bitten but not die, and also to have your cursed dwarves survive any retribution.

One method is to equip a squad of dwarves with training weapons and send them to an isolated area with one or two of your werebeasts. Ideally the dwarves who get injured will back away while the others hold back the werebeast. In reality it can be hard to balance the battle, which leads to either the werebeast killing off the injured dwarves or being pummeled into submission without spreading his curse. The main problem is when an attack by either the werebeast or a dwarf happens at the moment of transformation, it is considered a dwarf on dwarf attack, which leads to a minor [[loyalty cascade]].

Another method is to simply lock a werebeast in a room with a civilian(s) and hope that the civilian survives long enough for the werebeast to turn back. This reduces (but does not eliminate) the chance of a loyalty cascade, because only the werebeast is attacking. The main problem is that werebeasts become legendary fighters/wrestlers very quickly and are more than capable of killing/fatally wounding half a dozen dwarves in a single transformation.

The most successful method discovered is to lock a werebeast in a room with civilians, but be sure the room is completely covered in cage traps. Many injuries inflicted by werebeasts can knock a dwarf unconscious due to pain or strangulation, and an unconscious dwarf will be trapped by a cage trap. In the cage, dwarves are free to recover from their wounds, safe from any further attacks. In addition, a dwarf who is released from a cage gets an enormous happiness boost that will help him cope with the loss of family and friends who were not so lucky. Further improvements to this technique, such as assigning the uncursed to squads with no uniform (or just a helmet) that replaces clothing in order to allow every bite to break the skin, have pushed successful conversion rates to near 50%. It is also recommended to release dwarves from their cages immediately (via constructing the cages and attaching them to a lever) to prevent insanity due to unhappiness.

==Werebeast Military==

A somewhat less drastic (though potentially even more [[fun]]) option is to start a Werebeast super-soldier breeding program. Some Werebeasts can hold and use weapons in Wereform, and whatever combat skills they have as dwarves also apply while transformed. Being infected gives dwarves a large increase to their physical attributes (which can still be increased further, unlike vampires), and they need not worry about being wounded in combat as long as they survive until their next transformation. Add to this the Wereform's large size of 80000 and inability to feel pain, which partially makes up for its lack of armor, and you end up with a potentially devastating military force, if you can manage to keep them from murdering each other and the rest of your fortress.

Were-soldiers are mostly useful when their Wereform is of the variety that can use weapons and preferrably also shields, which obviously requires hands of some sort. Weregophers for example can use either a shield or a one-handed weapon, but not both, and may even equip crossbows as well as quivers and bolts. It is unknown if dwarves in Wereform can wield weapons that are normally too large for them, such as pikes. If they cannot use weapons they may still be useful as soldiers if their Wereform is of the dangerous sort, for example in the case of werelions <s>and tigers and bears</s>.

Transformed military dwarves respect their stations, alerts and uniforms (when applicable) and ignore the civilian alert, but will still attack anything they regard as an enemy, such as their fellow dwarves or any destroyable buildings. They must therefore be kept away from the rest of the fortress with walls and bridges, as they will destroy any non-artifact doors. Note that as of 40.24 there is a nasty bug which lets sparring dwarves teleport through 1-tile walls, so make sure the walls to their prison are at least 2 tiles thick, and install two 1-tile bridges connected to one lever as a door. Bonus points if you also install a dump chute in the room to give them new weapons and booze. Designate a stockpile under the chute, set it to take from links only, disable bins and set it to allow booze, empty barrels, weapons, shields and possibly ammo. Supplying the were-soldiers with booze both keeps them happy and prevents them from wandering into your fortress to look for it. Be aware that they can and will jump out of a hole directly above them, so either make the chute at least 2 z-levels high and smooth the walls, or keep it firmly locked with a hatch cover.

Once their containment room has been built, add a piece of furniture, designate a large barracks from it and set them to train there. The were-soldiers will destroy the barracks while transformed unless it is an artifact, so wall it in after the room has been defined. Remember to use 2-tile thick walls because of the sparring bug above.

An important thing to remember is the following: If two or more transformed dwarves have any sort of active military order (either from an alert or direct orders), and can see each other at the moment they change ''back'' from Wereform, then they will instantly begin fighting to the death, causing a loyalty cascade. To avoid this, either train your were-soldiers alone in separate rooms (slower due to lack of sparring), or make sure to set their alert to Inactive and cancel all their orders before they change back to dwarves. Once they've changed back, they can be set to train or given orders again. If they do start fighting each other, canceling all their orders and setting them to Inactive will make them stop.

The soldiers will not train while transformed, but if they were sparring during the transformation they will continue to spar in wereform, which can be entertaining to watch. The combat log for sparring dwarves in wereform will be gray instead of the normal cyan.

==Transformation Dates==

There are exactly thirteen full moons in a Dwarven year, so werebeasts transform on exactly the same dates every year:

*25th granite
*23rd slate
*21st felsite
*19th hematite
*17th malachite
*15th galena
*13th limestone
*11th sandstone
*8th timber
*6th moonstone
*4th opal
*2nd obsidian
*28th obsidian

==Werebeasts in Adventure Mode==
In adventurer mode, werebeasts are usually found living in small lairs on the edges of civilization. Young adventurers will often be called upon to slay them, with instructions along the line of 'he assumes a bestial form' along with a description of what type of metal they are vulnerable to. However, as long as they are not visited on the night of their transformation, they are just common peasants, and can be dispatched easily. It would behoove these individuals to hide themselves among townsfolk, but what can ya do?

To become a werebeast, you must either happen upon a werebeast in its beastly form or seek one out on the night of their transformation. It is recommended to wear no armor except for your head as only bites that break the skin will infect you with the were-virus. Once bitten, you will not transform immediately.

'''Pros:'''
*Every full moon all injuries are instantly healed.
*Big strength and agility boost

'''Cons:'''
*Attacked if you visit any towns during your transformation.
*Having to re-equip yourself every transformation unless transformed size is similar enough to your race's size.

==Werebeast Characteristics==
All werebeasts are described as having glowing eyes of some random color, and are "crazed for blood and flesh" meaning they attack everything that is not their own race, including undead.

The transformation to a Werebeast seems to only affect physical attributes, mental attributes are not changed though the descriptions will be relative to the Wereform's average. A Werebeast never gets hungry, thirsty or drowsy, and will not drown when in Wereform. Werebeasts in Wereform are type 2 Building Destroyers, so doors and vertical bars will not contain them, however bridges or walls will.

When transforming to Wereform, all health regenerates, including missing limbs, and thirsty dwarves will have their thirst <s>replaced with bloodthirst</s> removed. The same happens when transforming back. Effects induced by insanity are not reversed, so berserking soldiers that transform will still not follow orders.

Infected dwarves are removed from any burrows when they transform, and cannot be burrowed while in Wereform. They will however still remember the civilian alert burrow, so issuing a civilian alert while a dwarf is transformed will send that dwarf straight to your <s>slaughterhouse</s> emergency room if they can path their way there.

If the Werebeast cannot use weapons in Wereform (i.e. no hands), only the natural abilities of the creature are available for combat. These abilities differ from creature to creature (Claws/Hooves/venomous Bite etc.), but only their bites cause the Werebeast curse to be transmitted. Thankfully, there have been no reports of Werebeasts arriving to the fortress ''armed''.

Dwarves that die in Wereform will not be available for burial and will not come back as ghosts, but you can engrave slabs for them.

If you become a werebeast and transform in adventure mode, you can pick up your weapon and shield that were dropped in the transformation, but, seeing as werebeasts seem to have minimum body size of about 80000, armor will become too [[Clothing#Size|small]] for you to fit in. Hauled items will also be dropped on Fast Travel.

Werebeasts also tend to change back into humanoid form at the worst moment, like when they are charging a group of axedwarves. Sometimes a werebeast's humanoid form is more dangerous than the werebeast form, most obviously for [[Serpent man|snake man]] werebeasts.

Even if the werebeast is dispatched while in animal form, werebeast kills are listed as being of the original race.

Baby werecreatures are neutral, and while you can order your military to kill them the order will not be followed.

{{D for Dwarf}}
Sometimes a werebeast arrives in humanoid form, and the game then announces the arrival of a normal, intelligent creature as if it was some terrible beast. The naked, confused creature usually runs away, probably scared by your dwarves' laughter.

Entity token

2014-08-05T05:09:23Z

ArKFallen: Removed START_GROUP_NUMBER because using now throws an errorlog

{{Quality|Fine|14:56, 27 July 2014 (UTC)}}
{{Migrated_article}}
{{av}}
'''Entity tokens''' define entities, or civilizations, in entity_*.txt files.

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

|-
| {{text anchor|ADVENTURE_TIER}}
| order
| Allows adventure mode for entities with sites. Dwarves, Elves, and Humans take up tier 3, 2, and 1 respectively. Order doesn't need to be maintained; a custom creature can have a tier of 3000 and still work even if it's the only custom creature.
[ADVENTURE_TIER:4]

|-
| {{text anchor|INDIV_CONTROLLABLE}}
|
| Allows the race to be played as an "outsider" in adventure mode. Not having this specified in one of the entities will cause the Adventure mode option to disappear. Note that ADVENTURE_TIER is not required if this token is included, and that this cannot be applied to civilizations that were not in an entity_*.txt file during world gen.

|-
| {{text anchor|CIV_CONTROLLABLE}}
|
| Allows fortress mode. If multiple entities have the CIV_CONTROLLABLE token, than in embark mode the specific civs can be chosen by + or - on the civ list screen (by pressing tab), though it will not state what entity the civs belong to. To check which one, tab to the neighbors screen: the entity's race will be at the top. At least one civilization must have this token.

|-
| {{text anchor|CREATURE}}
| creature
|The type of creature that will inhabit the civilization. If multiple creature types are specified, each civilization will randomly choose one of the creatures.
[CREATURE:DWARF]

|-
| {{text anchor|CREATURE_HFID}}
| integer (or generic token?)
| Found on generated [[angel]] entities. Appears to draw from creatures with this HFID, which associates the entity with a historical figure of the same ID corresponding to a [[deity]].

|}

== Placement ==

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

|-
| {{text anchor|BIOME_SUPPORT}}
|
* [[Biome token|biome]]
* frequency
| Frequency goes from 0 to 10. Higher numbers make the entity more likely to settle there.
[BIOME_SUPPORT:ANY_GRASSLAND:4]

|-
| {{text anchor|START_BIOME}}
| [[Biome token|biome]]
| Birth of the civilization can be performed on this biome.
[START_BIOME:ANY_FOREST]

|-
| {{text anchor|EXCLUSIVE_START_BIOME}}
| [[Biome token|biome]]
| Birth of the civilization only occurs in this biome.
[EXCLUSIVE_START_BIOME:MOUNTAIN]

|-
| {{text anchor|SETTLEMENT_BIOME}}
| [[Biome token|biome]]
| This civ will create small settlements on this biome, not too far from the EXCLUSIVE_START_BIOME. Used for dwarven hillocks.
[SETTLEMENT_BIOME:ANY_GRASSLAND]

|-
| {{text anchor|DEFAULT_SITE_TYPE}}
| site type
| Valid site types are DARK_FORTRESS (π), CAVE (•), CAVE_DETAILED (Ω), TREE_CITY (î), and CITY (#). Also recognizes PLAYER_FORTRESS, and MONUMENT, though these likely will not work. FORTRESS is no longer a valid entry, instead castles are controlled by BUILDS_OUTDOOR_FORTIFICATIONS. Defaults to CITY. Selecting CAVE causes the classic kobold behavior of not showing of on the "neighbors" section of the site selection screen.
[DEFAULT_SITE_TYPE:CAVE_DETAILED]

|-
| {{text anchor|LIKES_SITE}}
| site type
| Most residents will try to move to this site type, unless already at one.
[LIKES_SITE:CAVE_DETAILED]

|-
| {{text anchor|TOLERATES_SITE}}
| site type
| Some residents will try to move to this site type, unless already at one.
[TOLERATES_SITE:CITY]

|-
| {{text anchor|WORLD_CONSTRUCTION}}
| construction
| Controls which constructions the civ will build on the world map. Valid constructions are ROAD, TUNNEL, BRIDGE, and WALL.
[WORLD_CONSTRUCTION:BRIDGE]
[WORLD_CONSTRUCTION:ROAD]
[WORLD_CONSTRUCTION:TUNNEL]
[WORLD_CONSTRUCTION:WALL]

|}

== Population ==

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

|-
| {{text anchor|MAX_POP_NUMBER}}
| number
| Max population '''per entity'''. Multiply this by max starting civ to get the total population of the species. Defaults to 500.
[MAX_POP_NUMBER:500]

|-
| {{text anchor|MAX_SITE_POP_NUMBER}}
| number
| Max population per individual site. Generic site types will not hold any more than this number of entities. Must be at least 80 for towns to be generated. In general, lower pop numbers mean more sprawl, and higher numbers mean more needing to crawl when entering town stores, which are not affected by this cap. Defaults to 50.
[MAX_SITE_POP_NUMBER:200]

|-
| {{text anchor|MAX_STARTING_CIV_NUMBER}}
| number
| Max number of entities to spawn at world generation. Worldgen picks civs in some sequential order from the raws. Once it reaches the end of the list, it will begin again at the top. Setting this number lower than 100, like say, 7, will cause worldgen to skip over this civ for placement if there are already 7 civs of this type. Note that if all civs are set to lower numbers, and the number of starting civs is set higher than the maximum possible amount of civs in total, it will gracefully stop placing civs and get down to the history aspect of worldgen. Defaults to 3.
[MAX_STARTING_CIV_NUMBER:3]

|}

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

|-
| {{text anchor|PERMITTED_BUILDING}}
| building name
| The named, custom building can be built by a civilization in Fortress Mode.
[PERMITTED_BUILDING:SOAP_MAKER]

|-
| {{text anchor|PERMITTED_JOB}}
| [[Unit type token|profession]]
| Allows this job type to be selected. This applies to worldgen creatures, in the embark screen, and in play. Certain professions also influence the availability of materials for trade.
[PERMITTED_JOB:MINER]

|-
| {{text anchor|PERMITTED_REACTION}}
| reaction name
| Allows this reaction to be used by a civilization. It is used primarily in Fortress Mode, but also allow certain resources, such as [[steel]], to be available to a race. When creating custom reactions, this token MUST be present or the player will not be able to use the reaction in Fortress Mode.
[PERMITTED_REACTION:TAN_A_HIDE]

|-
| {{text anchor|CURRENCY_BY_YEAR}}
|
| Causes the civ's currency to be numbered with the year it was minted.

|-
| {{text anchor|CURRENCY}}
|
* inorganic material
* value
| What kind of metals the civ uses for coin minting as well as the value of the coin.
[CURRENCY:SILVER:5]

|-
| {{text anchor|ART_FACET_MODIFIER}}
|
* type
* number
| OWN_RACE, FANCIFUL, EVIL, GOOD
Number goes from 0 to 25600 where 256 is the default.
[ART_FACET_MODIFIER:OWN_RACE:512]

|-
| {{text anchor|ART_IMAGE_ELEMENT_MODIFIER}}
|
* item
* number
| CREATURE, PLANT, TREE, SHAPE, ITEM<br />0-25600

Determines the chance of each image occurring in that entity's artwork, such as engravings and on artifacts, for default (non-historical) artwork.

[ART_IMAGE_ELEMENT_MODIFIER:TREE:512]

|-
| {{text anchor|ITEM_IMPROVEMENT_MODIFIER}}
|
* item
* number
| ART_IMAGE, COVERED or GLAZED, RINGS_HANGING, BANDS, SPIKES, ITEMSPECIFIC, THREAD, CLOTH, SEWN_IMAGE<br />0-25600

Determines the chance of the entity using that particular artwork method, such as "encircled with bands" or "menaces with spikes".

[ITEM_IMPROVEMENT_MODIFIER:SPIKES:0]

This also seems to change the amount that the entity will pay for items that are improved in the ways in their tokens.

|-
| {{text anchor|TRANSLATION}}
| language
| What language raw the entity uses.
* If an entity lacks this tag, translations appear to be drawn randomly from all translation files{{verify}}.
[TRANSLATION:DWARF]

|-
| {{text anchor|SELECT_SYMBOL}}
|
* noun
* symbol
| ALL, REMAINING, CIV, SITE, VESSEL, RELIGION, MILITARY_UNIT, TEMPLE, WAR, BATTLE, SIEGE, ROAD, BRIDGE, TUNNEL, WALL
Causes the entity to more often use these symbols in the particular SYM set.
[SELECT_SYMBOL:ALL:PEACE]

|-
| {{text anchor|SUBSELECT_SYMBOL}}
|
* noun
* symbol
| Causes the symbol set to be prefered as adjectives by the civilization. Used in vanilla to put violent names in sieges and batttles.
[SELECT_SYMBOL:SIEGE:NAME_SIEGE]
[SUBSELECT_SYMBOL:SIEGE:VIOLENT]

|-
| {{text anchor|CULL_SYMBOL}}
|
* noun
* symbol
| Causes the entity to not use the words in these SYM sets.
[CULL_SYMBOL:ALL:UGLY]

|-
| {{text anchor|FRIENDLY_COLOR}}
| see [[color]]
|
The color of this entity's civilization settlements in the world gen and embark screens. Defaults to 7:0:1.
[FRIENDLY_COLOR:1:0:1]

|}

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

|-
| {{text anchor|RELIGION}}
| type
|
* REGIONAL_FORCE: The creatures will worship a single force associated with their spheres. Currently hardcoded to only be associated with rivers and nature.
* PANTHEON: The creatures will worship a group of gods, each aligned with their spheres and other appropriate ones as well.

[RELIGION:PANTHEON]

|-
| {{text anchor|RELIGION_SPHERE}}
| sphere
| Can by any available [[Sphere]]. Multiple entries are possible. Choosing a religious sphere will automatically make its opposing sphere not possible for the species to have: adding WATER, for example, means the species will never get FIRE as a religious sphere.

[RELIGION_SPHERE:FORTRESSES]

|-
| {{text anchor|SPHERE_ALIGNMENT}}
|
* type
* number
|
This token forces an entity to favor or disfavor particular religious spheres, causing them to acquire those spheres more often when generating a pantheon.

[SPHERE_ALIGNMENT:TREES:512]

|}

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

|-
| {{text anchor|POSITION}}
| string
| Defines a leader/noble position for a civilization. These replace previous tags such as [MAYOR] and [CAN_HAVE_SITE_LEADER] and so on. To define a position further, see [[Position token]].

|-
| {{text anchor|LAND_HOLDER_TRIGGER}}
|
* land holder number
* population
* wealth exported
* created wealth
| Defines when a particular land-holding noble (baron, count, duke in vanilla) will arrive at a fortress.

|-
| {{text anchor|SITE_VARIABLE_POSITIONS}}
| Position responsibility or ALL
| Allows a site responsibility to be taken up by a dynamically generated position (usually lord). Also appears to cause site disputes.{{Verify}}

|-
| {{text anchor|VARIABLE_POSITIONS}}
| Position responsibility or ALL
| Allows a responsibility to be taken up by a dynamically generated position (such as Law-maker).

|}

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

|-
| {{text anchor|ETHIC}}
|
*behavior
*reaction
| Sets the civ's view of [[ethic]]s (certain behaviors), from capital punishment to completely acceptable. This also causes the civ to look upon opposing ethics with disfavor, if their reaction to it is opposing, and when at extremes (one ACCEPTABLE, another civ UNTHINKABLE for example) they will often go to war over it.
[ETHIC:EAT_SAPIENT_KILL:ACCEPTABLE]

|-
| {{text anchor|VALUE}}
|
*value
*number
| Sets the civ's cultural values. Numbers range from -50 (completely anathema) to 0 (neutral) to 50 (highly valued).
[VALUE:CRAFTSMANSHIP:50]

|-
| {{text anchor|WILL_ACCEPT_TRIBUTE}}
|
| Makes the civ's traders accept offered goods.

|-
| {{text anchor|WANDERER}}, {{text anchor|BEAST_HUNTER}}, {{text anchor|SCOUT}}
|
| The civ will send out these sorts of adventurers in worldgen. This seems to increase Tracker skill.

|-
| {{text anchor|ABUSE_BODIES}}
|
| The civilization will mutilate bodies when they are the victors in history-gen warfare, such as hanging bodies from trees, putting them on spikes, and so forth. Adventurers killed in Adventurer mode will sometimes be impaled on spikes wherever they died, with or without this token, and regardless of whether they actually antagonized the townspeople.

|-
| {{text anchor|ACTIVE_SEASON}}
| season
| the season when the civ is most active: when they will trade, interact with you via diplomats, and/or invade you. Civs can have multiple season entries. Note: If multiple caravans arrive at the same time, you are able to select which civ to trade with at the depot menu. ACTIVE_SEASON tags may be changed for a currently active fort.
[ACTIVE_SEASON:AUTUMN]

|-
| {{text anchor|AMBUSHER}}
|
| When invading sneaks around and shoots at straggling members of your society. They will spawn on the edge of the map and will only be visible when one of their party are spotted; this can be quite dangerous to undefended trade depots.

|-
| {{text anchor|AT_PEACE_WITH_WILDLIFE}}
|
| Will not attack wildlife, and will not be attacked by them, even if you have them in your party. This can be somewhat disconcerting when attacked by bears in the forest and your elven ally sits back and does nothing.

|-
| {{text anchor|BABYSNATCHER}}
|
| Sends thieves to steal babies. Also sends ambush parties to harass your civilization. Without this tag, enemy civs will only siege, and will siege as early as they would otherwise babysnatch. This can happen as early as the first year of the fort! In addition, babysnatcher civs will snatch children during worldgen, allowing them to become part of the civ if they do not escape.

Note: If the playable civ in Fortress Mode has this tag (i.e. you add BABYSNATCHER to the Dwarf entity) then the roles will be reversed and elves and humans will siege and ambush and goblins will trade with you.

|-
| {{text anchor|BUILDS_OUTDOOR_FORTIFICATIONS}}
|
| Makes the civilization build castles.

|-
| {{text anchor|BUILDS_OUTDOOR_TOMBS}}
|
| Makes the civilization build tombs.

|-
| {{text anchor|BANDITRY}}
| percentage
| Sets a percentage of the entity population to be used as bandits.

|-
| {{text anchor|DIPLOMAT_BODYGUARDS}}
|
| Visiting diplomats are accompanied by a pair of soldiers. Does not work due to a bug.{{bug|5854}}

|-
| {{text anchor|GENERATED}}
|
| Found on generated divine "HF Guardian Entities". Cannot be used in user-defined raws.

|-
| {{text anchor|INVADERS_IGNORE_NEUTRALS}}
|
| Causes invaders to ignore visiting caravans and other neutral creatures.{{verify}}

|-
| {{text anchor|ITEM_THIEF}}
|
| Sends thieves to steal items. This will also occur in history generation, and thieves will have the "thief" profession. Items stolen in history gen will be scattered around that creature's home.

|-
| {{text anchor|LOCAL_BANDITRY}}
|
| Causes the entity to send out patrols that can ambush adventurers. Will cause cities to be hostile to adventurers whenever they enter, regardless of race or nationality. Adding this tag to playable entities will also make adventurers with this token willing to move-attack non-hostile villagers, rather than having to make an aimed attack.

|-
| {{text anchor|MERCHANT_BODYGUARDS}}
|
| Caravan merchants are accompanied by soldiers.

|-
| {{text anchor|MERCHANT_NOBILITY}}
|
| Effect unknown - in previous versions, this resulted in the civ having a Guild Representative / Merchant Baron / Merchant Prince, but now this is controlled solely by positions.

|-
| {{text anchor|PROGRESS_TRIGGER_POPULATION}}
| level
| 0 to 5, civ will come to site once population at site has reached that level. If multiple progress triggers exist for a civ, it will come when any one of them is fulfilled instead of waiting for all of them to be reached. A value of 0 disables the trigger. 1 corresponds to 20 dwarves, 2 to 50 dwarves, 3 to 80, 4 to 110, and 5 to 140. Progress triggers may be changed, added, or deleted for a currently active fort. Note: hostile civs require that the population trigger be fulfilled as well as at least one other trigger before attacking.

|-
| {{text anchor|PROGRESS_TRIGGER_PRODUCTION}}
| level
| 0 to 5, civ will come to site once created wealth has reached that level. If multiple progress triggers exist for a civ, it will come when any one of them is fulfilled instead of waiting for all of them to be reached. A value of 0 disables the trigger. 1 corresponds to 5000☼ created wealth, 2 to 25000☼, 3 to 100000☼, 4 to 200000☼, and 5 to 300000☼. Progress triggers may be changed, added, or deleted for a currently active fort.

|-
| {{text anchor|PROGRESS_TRIGGER_TRADE}}
| level
| 0 to 5, civ will come to site once exported goods has reached that level. If multiple progress triggers exist for a civ, it will come when any one of them is fulfilled instead of waiting for all of them to be reached. A value of 0 disables the trigger. 1 corresponds to 500☼ exported wealth, 2 to 2500☼, 3 to 10000☼, 4 to 20000☼, and 5 to 30000☼. Progress triggers may be changed, added, or deleted for a currently active fort.

|-
| {{text anchor|PROGRESS_TRIGGER_POP_SIEGE}}
| level
| 0 to 5, civ will begin to send sieges against the player civ when this level is reached if it is hostile.

If multiple progress triggers exist for a civ, it will come when any one of them is fulfilled instead of waiting for all of them to be reached. A value of 0 disables the trigger.

|-
| {{text anchor|PROGRESS_TRIGGER_PROD_SIEGE}}
| level
| 0 to 5, civ will begin to send sieges against the player civ when this level is reached if it is hostile.

|-
| {{text anchor|PROGRESS_TRIGGER_TRADE_SIEGE}}
| level
| 0 to 5, civ will begin to send sieges against the player civ when this level is reached if it is hostile.

|-
| {{text anchor|SIEGER}}
|
| Will start campfires and wait around at the edge of your map for a month or two before rushing in to attack.

|-
| {{text anchor|SITE_GUARDIAN}}
|
| Guards certain special sites, such as a [[vault]] belonging to a [[demon]] allied with a [[deity]]. Used in generated divine entities.

|-
| {{text anchor|SKULKING}}
|
| This makes the severity of attacks depend on the extent of item/baby thievery rather than the passage of time. Makes trade impossible with the related civilization.

|-
| {{text anchor|TREE_CAP_DIPLOMACY}}
|
| Visiting diplomats impose tree cutting quotas; without this, they will simply compliment your fortress and leave. Also causes the diplomat to make unannounced first contact at the very beginning of the first Spring after your fortress becomes a Barony.

|-
| {{text anchor|LAYER_LINKED}}
|
| Defines if a civilization is a hidden subterranean entity, such as batman civilizations.

|-
| {{text anchor|UNDEAD_CANDIDATE}}
|
| Unknown. Possibly makes this creature available as a "Corpse" (e.g. Human Corpse) for necromancers in adventure mode.

|}

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

|-
| {{text anchor|AMMO}}
| item token
|
[AMMO:ITEM_AMMO_BOLTS]

|-
| {{text anchor|ARMOR}}
|
* item token
* rarity
|Rarity is optional. Permitted rarity values are RARE, UNCOMMON, FORCED (anything else is treated as COMMON).
[ARMOR:ITEM_ARMOR_PLATEMAIL:COMMON]

|-
| {{text anchor|DIGGER}}
| item token
|
[DIGGER:ITEM_WEAPON_PICK]

|-
| {{text anchor|GLOVES}}
|
* item token
* rarity
| Rarity is optional. Permitted rarity values are RARE, UNCOMMON, FORCED (anything else is treated as COMMON).
[GLOVES:ITEM_GLOVES_GLOVES:COMMON]

|-
| {{text anchor|HELM}}
|
* item token
* rarity
| Rarity is optional. Permitted rarity values are RARE, UNCOMMON, FORCED (anything else is treated as COMMON).
[HELM:ITEM_HELM_HELM:COMMON]

|-
| {{text anchor|INSTRUMENT}}
| item token
|
[INSTRUMENT:ITEM_INSTRUMENT_FLUTE]

|-
| {{text anchor|PANTS}}
|
* item token
* rarity
| Rarity is optional. Permitted rarity values are RARE, UNCOMMON, FORCED (anything else is treated as COMMON).
[PANTS:ITEM_PANTS_PANTS:COMMON]

|-
| {{text anchor|SHIELD}}
| item token
|
[SHIELD:ITEM_SHIELD_SHIELD]

|-
| {{text anchor|SHOES}}
|
* item token
* rarity
| Rarity is optional. Permitted rarity values are RARE, UNCOMMON, FORCED (anything else is treated as COMMON).
[SHOES:ITEM_SHOES_SHOES:COMMON]

|-
| {{text anchor|SIEGEAMMO}}
| item token
|
[SIEGEAMMO:ITEM_SIEGEAMMO_BALLISTA]

|-
| {{text anchor|TOOL}}
| item token
|
[TOOL:ITEM_TOOL_NEST_BOX]

|-
| {{text anchor|TOY}}
| item token
|
[TOY:ITEM_TOY_PUZZLEBOX]

|-
| {{text anchor|TRAPCOMP}}
| item token
|
[TRAPCOMP:ITEM_TRAPCOMP_GIANTAXEBLADE]

|-
| {{text anchor|WEAPON}}
| item token
|
[WEAPON:ITEM_WEAPON_AXE_BATTLE]

|-
| {{text anchor|USE_ANIMAL_PRODUCTS}}
|
| Allows civilization to use products made from animals. All relevant creatures will be able to provide wool, silk, and extracts (including milk and venom) for trade, and non-sentient creatures (unless ethics state otherwise) will be able to provide eggs, caught fish, meat, leather, bone, shell, pearl, horn, and ivory.

|-
| {{text anchor|USE_ANY_PET_RACE}}
|
| Any creature in the civilization's list of usables (from the surrounding 7x7 or so of squares and map features in those squares) which has PET or PET_EXOTIC will be available as a pet, pack animal (with PACK_ANIMAL), wagon puller (with WAGON_PULLER), mount (with MOUNT or MOUNT_EXOTIC), or siege minion (with TRAINABLE_WAR and ''without'' CAN_LEARN). This notion of the initial usable creature list, which then gets pared down or otherwise considered, applies below as well. All common domestic and equipment creatures are also added to the initial list.

|-
| {{text anchor|USE_CAVE_ANIMALS}}
|
| If they don't have it, creatures with exclusively subterranean biomes are skipped. If they have it, cave creatures with PET will also be available as pets, pack animals (with PACK_ANIMAL), wagon pullers (with WAGON_PULLER), mounts (with MOUNT or MOUNT_EXOTIC), and siege minions (with TRAINABLE_WAR and ''without'' CAN_LEARN).

|-
| {{text anchor|USE_EVIL_ANIMALS}}
|
| Don't have it -> EVIL creatures skipped. If they have it, evil creatures with SLOW_LEARNER or ''without'' CAN_LEARN will be also available as pets (with PET), pack animals (with PACK_ANIMAL), wagon pullers (with WAGON_PULLER), mounts (with MOUNT or MOUNT_EXOTIC), and siege minions (with TRAINABLE_WAR or SLOW_LEARNER).

|-
| {{text anchor|USE_EVIL_PLANTS}}
|
| As EVIL creatures for all uses of plants.

|-
| {{text anchor|USE_EVIL_WOOD}}
|
| As EVIL creatures for all uses of wood.

|-
| {{text anchor|USE_GOOD_ANIMALS}}
|
| Don't have it -> GOOD creatures skipped. If they have it, good creatures ''without'' CAN_LEARN will also be available as pets (with PET), pack animals (with PACK_ANIMAL), wagon pullers (with WAGON_PULLER), mounts (with MOUNT or MOUNT_EXOTIC), and siege minions (with TRAINABLE_WAR).

|-
| {{text anchor|USE_GOOD_PLANTS}}
|
| As GOOD creatures for all uses of plants.

|-
| {{text anchor|USE_GOOD_WOOD}}
|
| As GOOD creatures for all uses of wood.

|-
| {{text anchor|USE_MISC_PROCESSED_WOOD_PRODUCTS}}
|
| If the relevant professions are permitted, controls availability of lye (LYE_MAKING), charcoal (BURN_WOOD), and potash (POTASH_MAKING).

|-
| {{text anchor|COMMON_DOMESTIC_MOUNT}}
|
| Gives the civilization access to creatures with COMMON_DOMESTIC and MOUNT. Additionally, all available (based on USE_ANY_PET_RACE, USE_CAVE_ANIMALS, USE_GOOD_ANIMALS, and USE_EVIL_ANIMALS) creature with MOUNT and PET will be allowed for use as mounts during combat.

|-
| {{text anchor|COMMON_DOMESTIC_PACK}}
|
| Gives the civilization access to creatures with COMMON_DOMESTIC and PACK_ANIMAL. Additionally, all available (see above) creatures with PACK_ANIMAL and PET will be allowed for use during trade as pack animals.

|-
| {{text anchor|COMMON_DOMESTIC_PET}}
|
| Gives the civilization access to creatures with COMMON_DOMESTIC and PET. Additionally, all available (see above) creatures with PET will be allowed for use as pets.

|-
| {{text anchor|COMMON_DOMESTIC_PULL}}
|
| Gives the civilization access to creatures with COMMON_DOMESTIC and WAGON_PULLER. Additionally, all available (see above) creatures with WAGON_PULLER and PET will be allowed for use during trade to pull [[wagon]]s.

|-
| {{text anchor|RIVER_PRODUCTS}}
|
| Allow civ to use river products in the goods it has available for trade.

|-
| {{text anchor|OCEAN_PRODUCTS}}
|
| Allow civ to use ocean products (including [[amber]] and [[coral]]) in the goods it has available for trade. Without OCEAN_PRODUCTS, civilizations will not be able to trade ocean fish even if they are ''also'' available from other sources (e.g. [[sturgeon]]s and [[stingray]]s).

|-
| {{text anchor|INDOOR_FARMING}}
|
| Allow civ to use underground plant products in the goods it has available for trade.

|-
| {{text anchor|OUTDOOR_FARMING}}
|
| Allow civ to use outdoor plant products in the goods it has available for trade.

|-
| {{text anchor|INDOOR_GARDENS}}
|
| Allow civ to use underground plant growths (quarry bush leaves in unmodded games) in the goods it has available for trade.

|-
| {{text anchor|OUTDOOR_GARDENS}}
|
| Allow civ to use outdoor plant growths in the goods it has available for trade.

|-
| {{text anchor|OUTDOOR_ORCHARDS}}
|
| Allows civ to use outdoor tree growths in the goods it has available for trade.

|-
| {{text anchor|CLOTHING}}
|
| Civ members will attempt to wear clothing.

|-
| {{text anchor|SUBTERRANEAN_CLOTHING}}
|
| Will wear things made of spider silk and other subterranean materials.

|-
| {{text anchor|EQUIPMENT_IMPROVEMENTS}}
|
| Adds decorations to equipment based on the level of the generated unit. Also improves item quality.

|-
| {{text anchor|IMPROVED_BOWS}}
|
| Adds decorations to weapons generated for bowman and master bowman. An elf hack.

|-
| {{text anchor|METAL_PREF}}
|
| Allows metal materials to be used to make cages (inexpensive metals only) and crafts.

|-
| {{text anchor|STONE_PREF}}
|
| Allows the civilization to make use of nearby stone types. If the FURNACE_OPERATOR job is permitted, also allows ore-bearing stones to be smelted into metals.

|-
| {{text anchor|WOOD_WEAPONS}}
|
| The civilization can make traditionally metallic weapons such as swords and spears from wood. An elf hack.

|-
| {{text anchor|WOOD_ARMOR}}
|
| The civilization can make traditionally metallic armor such as mail shirts and helmets from wood. An elf hack.

|-
| {{text anchor|GEM_PREF}}
|
| Enables creatures of this entity to bring gems in trade.

|-
| {{text anchor|INDOOR_WOOD}}
|
| Allow civ to use subterranean wood types, such as tower-cap and fungiwood logs.

|-
| {{text anchor|OUTDOOR_WOOD}}
|
| Allow civ to use outdoor wood types, such as mangrove and oak.

|-
| {{text anchor|GEM_SHAPE}}
| [[Descriptor shape token|shape]]
| Precious gems cut by this civilization's jewelers can be of this shape.

|-
| {{text anchor|STONE_SHAPE}}
| [[Descriptor shape token|shape]]
| Ordinary non-gem stones cut by this civilization's jewelers can be of this shape.

|-
| {{text anchor|DIVINE_MAT_CLOTH}}
|
| Allows civ to use materials with [DIVINE] for clothing. Used for generated divine entities.

|-
| {{text anchor|DIVINE_MAT_WEAPONS}}
|
| Allows civ to use metals with [DIVINE] for weapons. Used for generated divine entities.

|-
| {{text anchor|DIVINE_MAT_ARMOR}}
|
| Allows civ to use metals with [DIVINE] for armour. Used for generated divine entities.

|}

== Tissue Styling Related Tokens ==
{| {{prettytable}}
|- bgcolor="#ddd"
! Token
! Arguments
! Description

|-
| {{text anchor|TISSUE_STYLE}}
| tissue style unit ID
| Select tissue layer which have the ID attached using TISSUE_STYLE_UNIT token in unit raws. This allows setting further cultural style parameters for selected tissue layer.

|-
| {{text anchor|TS_MAINTAIN_LENGTH}}
|
* minimum length?
* maximum length?
| Presumably sets culturally preferred tissue length for selected tissue. Needs testing.
Dwarves have their beards set to 100:NONE by default.

|-
| {{text anchor|TS_PREFERRED_SHAPING}}
| styling token
| Valid tokens are NEATLY_COMBED, BRAIDED, DOUBLE_BRAIDS, PONY_TAILS, CLEAN_SHAVEN and STANDARD_HAIR/BEARD/MOUSTACHE/SIDEBURNS_SHAPINGS.
Presumably sets culturally preferred tissue shapings for selected tissue. Needs testing.

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

DF2014 Talk:Skill token

2014-07-12T19:04:27Z

ArKFallen:

Climbing[http://dwarffortresswiki.org/index.php/DF2014:Climber] needs to be added to this. Are the numbers on the list for the table part of an organization system (I.E. skill token ID Numbers), I haven't put it on because uncertainty in format. -Arkfallen

DF2014 Talk:Skill token

2014-07-12T19:02:18Z

ArKFallen: Created page with "Climbing[http://dwarffortresswiki.org/index.php/DF2014:Climber] needs to be added to this. Are the numbers on the list for the table part of an organization system (I.E. skill..."

Skill

2014-07-12T18:51:28Z

ArKFallen: /* Skills */ added Climbing/Climber and moved Discipline into Misc

{{Migrated_article}}
{{quality|unrated}}
''See also: [[Combat skill]]''

'''Skills''' are used by dwarves to accomplish almost every task. Higher skills allow dwarves to accomplish tasks more quickly and more effectively (for example, mining and crafting). Whenever a skill is used [[experience]] is gained for that skill, allowing the dwarf to reach higher skill levels.

If a dwarf does not use a skill for a prolonged period of time, the skill will be labeled "rusty." If the rusty skill continues to remain unused, it will eventually be labeled "very rusty," or "V rusty" in game. Skills remaining at very rusty for prolonged periods of time will gradually suffer permanent experience loss. It is not possible in-game to know whether a given skill has suffered level loss, but any utility capable of reading exact XP levels will show a skill with a lost level as being at 100% of the XP required to take it to the next skill level. See [[#Skill Rust|Rust]] below for more details.

To determine what skills a dwarf has, press {{K|v}} and highlight the dwarf, then press {{K|g}} to ensure you are on the general information page. The skills will be grouped into three toggleable types: {{K|c}}ombat, la{{K|b}}or and {{K|m}}iscellaneous skills. Included on the list are the levels of each skill, and, if applicable, "rusty" or "V rusty" notifications.

Skill levels are as follows:

:*Dabbling
:*Novice
:*Adequate
:*Competent
:*Skilled
:*Proficient
:*Talented
:*Adept
:*Expert
:*Professional
:*Accomplished
:*Great
:*Master
:*High Master
:*Grand Master
:*Legendary

==Skill penalties==
Dwarves that are [[Status icon|hungry, tired, or thirsty]] will work slower and produce lower quality goods. This is unimportant for some tasks such as wood cutting or furnace operating but you may want to halt construction of [[aluminum]] [[statue]]s if your [[blacksmith]] is famished and hollow-eyed from lack of sleep.

==Skills==

{| style="margin: 0 auto"
|-
| valign='top' |

{{Skill Box|Miner|7:0|7:0|
* [[Miner]]
}}

{{Skill Box|[[Woodworker]]|6:1|6:1|
* [[Bowyer]]
* [[Carpenter]]
* [[Wood cutter]]
}}

{{Skill Box|[[Stoneworker]]|7:1|7:1|
* [[Engraver]]
* [[Mason]]
}}

{{Skill Box|[[Ranger]]|2:0|2:0|
* [[Ambusher]]
* [[Animal caretaker]]
* [[Animal dissector]]
* [[Animal trainer]]
* [[Trapper]]
}}

{{Skill Box|[[Doctor]]|5:0|5:0|
* [[Bone doctor]]
* [[Crutch-walker]]
* [[Diagnostician]]
* [[Surgeon]]
* [[Suturer]]
* [[Wound dresser]]
}}

| valign='top' |

{{Skill Box|[[Farmer]]|6:0|6:0|
* [[Beekeeper]]
* [[Brewer]]
* [[Butcher]]
* [[Cheese maker]]
* [[Cook]]
* [[Dyer]]
* [[Grower]]
* [[Herbalist]]
* [[Lye maker]]
* [[Milker]]
* [[Miller]]
* [[Potash maker]]
* [[Presser]]
* [[Shearer]]
* [[Soaper]]
* [[Spinner]]
* [[Tanner]]
* [[Thresher]]
* [[Wood burner]]
}}

{{Skill Box|[[Fishery worker]]|1:0|1:0|
* [[Fish cleaner]]
* [[Fish dissector]]
* [[Fisherdwarf]]
}}

{{Skill Box|[[Metalsmithing|Metalsmith]]|0:1|0:1|
* [[Armorsmith]]
* [[Furnace operator]]
* [[Metal crafter]]
* [[Blacksmith|Metalsmith]]
* [[Weaponsmith]]
}}

| valign='top' |

{{Skill Box|[[Jeweler]]|2:1|2:1|
* [[Gem cutter]]
* [[Gem setter]]
}}

{{Skill Box|[[Craftsdwarf]]|1:1|1:1|
* [[Bone carver]]
* [[Clothier]]
* [[Glassmaker]]
* [[Glazer]]
* [[Leatherworker]]
* [[Potter]]
* [[Stone crafter]]
* [[Strand extractor]]
* [[Wax worker]]
* [[Weaver]]
* [[Wood crafter]]
}}

{{Skill Box|[[Engineer]]|4:1|4:1|
* [[Mechanic]]
* [[Pump operator]]
* [[Siege engineer]]
* [[Siege operator]]
}}

{{Skill Box|Other Jobs|3:0|3:0|
* [[Alchemy|Alchemist]]
* [[Knapper]]
* [[Swimmer]]
}}

{{Skill Box|[[Administrator]]|5:0|5:0|
* [[Appraiser]]
* [[Building designer]]
* [[Organizer]]
* [[Record keeper]]
}}

| valign='top' |

{{Skill Box|[[Military]]|0:1|0:0|
* [[Archer]]
* [[Armor user]]
* [[Axeman]]
* [[Biter]]
* [[Blowgunner]]
* [[Bowman]]
* [[Crossbowman]]
* [[Dodger]]
* [[Fighter]]
* [[Hammerman]]
* [[Kicker]]
* [[Knife user]]
* [[Lasher]]
* [[Maceman]]
* [[Misc. object user]]
* [[Pikeman]]
* [[Shield user]]
* [[Spearman]]
* [[Striker]]
* [[Swordsman]]
* [[Thrower]]
* [[Wrestler]]
}}

{{Skill Box|[[Broker]]|3:0|3:0|
* [[Comedian]]
* [[Conversationalist]]
* [[Flatterer]]
* [[Intimidator]]
* [[Judge of intent]]
* [[Liar]]
* [[Negotiator]]
* [[Persuader]]
}}

| valign='top' |

{{Skill Box|Miscellaneous|3:0|3:0|
* [[Climber]]
* [[Concentration]]
* [[Consoler]]
* [[Discipline]]
* [[Leader]]
* [[Observer]]
* [[Pacifier]]
* [[Reader]]
* [[Student]]
* [[Teacher]]
}}

{{Skill Box|Unused|3:0|3:0|
* [[Balance]]
* [[Coordination]]
* [[Druid]]
* [[Military tactics]]
* [[Poet]]
* [[Speaker]]
* [[Tracker]]
* [[Wordsmith]]
* [[Writer]]
}}
|}

==Skills, Attributes and Traits==
*'''Skills''':
**are trained by being used in some activity.
**train '''[[attribute]]s'''.
**the same [[attribute]] can be trained by various skills.
**it's assumed that the skills also use some of the [[attribute]]s that they train.
**certain skills are required or important for certain [[noble]], [[military]] and civilian professions.
**certain professions require several skills.
**the same skill can be used by various professions.
**are increased by [[Preferences]], but capped, so the dwarf will make items beyond its skill level but won't affect the chances of making more high value items at the highest skill level.

*'''[[Personality trait|Traits]]''':
**cannot be modified in-game.{{verify}}
**affect which [[social skill]]s gain experience ''(if the dwarf has X trait it will not gain experience in X skill)'' at all.
**have other in-game effects that can be useful for certain professions.
**give [[thought]]s when performing certain activities.

To summarize it goes like this:
Trait --> Skill <--> Attribute
| ^
v |
effect |
| v
'--> Profession

Since the same skills can be used by various professions, and the same [[attribute]]s are trained by various skills, this allows for [[cross-training]].

Being [[Personality trait|traits]] the unmodifiable{{verify}}, limiting factor on which skills can be learned or having useful effects, and certain professions requiring various skills, the need arises to:
*avoid appointing a dwarf that will never learn a certain skill to a profession that uses it:
**''appointing a [[Personality trait|straightforward]] dwarf as a [[broker]] will result in a [[consoler]], non-[[flatterer]], non-[[liar]] [[broker]]''.
*appoint a dwarf with a useful effect given by a [[Personality trait|trait]] to a profession that benefits from it:
**''appointing an [[Personality trait|undisciplined]] dwarf to an important job will result in [[fun|fun]]''.
**''appointing an [[Personality trait|angry]] dwarf to [[soldier]] will result in more [[Status_icon|enraged]] bonuses.

==Skill Rust==
Every skill has the following set of improvement and decay counters, which are caste specific:

{{token|SKILL_RATE|c}} (Default is {{token|SKILL_RATE|cr|100:8:16:16}})
* % of improvement points you get (Default 100)
* unused counter rate (Default 8)
* rust counter rate (Default 16)
* demotion counter rate (Default 16)

The unused counter starts incrementing while a dwarf isn't using a skill. Once it reaches the cap, it will reset to zero, and the rust counter rate will increment by 1. This continues until the rust counter's cap is reached, and then the demotion counter is incremented by 1, and the rust counter is reset to zero. When the demotion counter finally reaches its cap, a 'layer' of rust is added to the skill, and the demotion counter is reset to zero.

The {{DFtext|Rusty}} and {{DFtext|V.Rusty}} descriptions which are appended to a skill within Dwarf Fortress are determined by the following conditions:

*Rusty: A skill level greater than 0 and less than 4, and the skill level * 0.5 <= the number of rust layers.
*Very Rusty: A skill level greater than or equal to 4, and the skill level * 0.75 <= the number of rust layers.

For example, a level 3 skill with 4 layers of rust: 3 * 0.5 = 1.5 which is less than the 4 layers of rust, so it's a Rusty skill. A level 8 with 6 layers of rust: 8 * 0.75 = 6 which is equal to the layers of rust, so it's a Very Rusty skill.

In testing it appears that the layers of rust are limited to a maximum of 6. If the counters reach the maximum and it attempts to increase to a 7th layer of rust, all counters are stopped, and the 'Rusty' and 'V. Rusty' descriptions are erroneously removed from the skill descriptions within Dwarf Fortress.

v0.31:Body detail plan token

2011-11-13T08:46:46Z

ArKFallen: Added mention of the ARG# limit to BP_LAYERS and minor change

{{quality|Exceptional|17:58, 28 April 2011 (UTC)}}{{av}}

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

|-
| ADD_MATERIAL
|
* identifier
* material template
| Adds a new material to the creature based on the specified template and assigned to the specified identifier.

|-
| ADD_TISSUE
|
* identifier
* tissue template
| Adds a new tissue to the creature based on the specified template and assigned to the specified identifier.

|-
| BODY_DETAIL_PLAN
|
| Begins defining a body detail plan for use in creature raws

|-
| BP_LAYERS
|
*BY_CATEGORY or BY_TYPE or BY_TOKEN
*body part
*tissue name or tissue ARG# for innermost tissue
*tissue thickness
*tissue name or tissue ARG# for second innermost tissue
*tissue thickness
*tissue name or tissue ARG# for third innermost tissue
*tissue thickness
etc...
| Defines a series of tissue layers. Alternatively to specifying a tissue, variable arguments can be entered (numbered arbitrarily to a max of 5) to be filled with tissues when the plan is called in the creature entry. The SELECT_TISSUE creature token with TL_RELATIVE_THICKNESS can change tissue thickness, but tissue ''layering'' is hard to do without a new detail plan.

|-
| BP_LAYERS_OVER
|
| Works like BP_LAYERS, but defines layers over existing layers?

|-
| BP_LAYERS_UNDER
|
| Works like BP_LAYERS, but defines layers under existing layers?

|-
| BP_POSITION
|
*BY_CATEGORY or BY_TYPE or BY_TOKEN
*body part
*position token
| Defines a position for the specified body part (the nose is assigned the position FRONT, as it's on the front of the face). This has some effects on combat, attacks and the like. Valid position tokens are FRONT, BACK, SIDES, TOP and BOTTOM.

|-
| BP_RELATION
|
*BY_CATEGORY or BY_TYPE or BY_TOKEN
*body part to be affected
*relation token
*BY_CATEGORY or BY_TYPE or BY_TOKEN
*parent body part
*coverage
| Defines a positional relationship between one body part and another (the right eyelid is AROUND the right eye with coverage 50, as it only partially covers the eye). This has some effects on combat, attacks and the like. Valid relation tokens are AROUND, SURROUNDED_BY, ABOVE, BELOW, IN_FRONT, BEHIND, CLEANS, and CLEANED_BY. The lattermost two tokens are used when specifying parts that clean each other (such as eyelids to eyes).

|-
| BP_RELSIZE
|
*BY_CATEGORY (or, presumably, BY_TYPE or BY_TOKEN)
*body part
*relsize
| Defines a relsize for the selected body part for the current body detail plan

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

v0.31:Creature token

2011-07-20T03:59:54Z

ArKFallen: Cleared up a confusion with the NIGHT_CREATURE_HUNTER tag

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

A full list of all known creature tokens.

__NOTOC__

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

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

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

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

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

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

|-
| AMBUSHPREDATOR
|
| Makes the creature start out hidden.{{verify}}

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

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

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

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

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

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

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

|-
| APPLY_CURRENT_CREATURE_VARIATION
|
| Applies loaded Creature Variation

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

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

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

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

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

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

|}

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

|-
| CASTE
|
*name
| defines a caste

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

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

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

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

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

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

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

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

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

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

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

|-
| CHANGE_BODY_SIZE_PERC
|
|

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

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

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

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

|-
| COLONY_EXTERNAL
|
| Caste hovers around colony.

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

|-
| DEMON
|
| Found on generated {{L|demon}}s; sets the creature as potential {{L|hell}} spawn

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

|-
| FEATURE_ATTACK_GROUP
|
| Found on subterranean animalmen.

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

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

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

|-
| FIREIMMUNE
|
| ?

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

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

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

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

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

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

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

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

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

|-
| GENERATED
|
| Found on procedurally generated creatures like {{L|Forgotten beast}}s, (biome name) {{L|titan}}s, {{L|Demon}}s, and {{L|night creature}}s.

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

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

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

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

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

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

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

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

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

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

|-
| GRAVITATE_BODY_SIZE
| target value
| Used in Creature Variants. This token changes the body size to the average of the old body size and the target value. Unknown how it interacts with growth stages.{{verify}}

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

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

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

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

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

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

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

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

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

|}

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

|-
| LAYS_UNUSUAL_EGGS
|
* {{L|item token}}
* {{L|material token}}
| Creature lays a particular item instead of regular eggs.

|-
| LIGAMENTS
|
* {{L|material token}}
*healing rate
| Defines the material and healing rate of ligaments.

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

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

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

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

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

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

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

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

|-
| MAGICAL
|
| Unknown.

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

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

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

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

|-
| MATERIAL_BREATH_ATTACK
|
* {{L|material token}}
* breath attack type (TRAILING_DUST_FLOW, TRAILING_VAPOR_FLOW, TRAILING_GAS_FLOW, SOLID_GLOB, LIQUID_GLOB, UNDIRECTED_GAS, UNDIRECTED_VAPOR, UNDIRECTED_DUST)
| Creates an attack referencing a material, using a given type of breath attack.

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

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

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

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

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

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

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

|-
| MILKABLE
|
* {{L|material token}}
* frequency
| Allows the creature to be milked.

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

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

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

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

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

|-
| MULTIPLY_VALUE
|
*Multiplier
| Multiplies value of materials.

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

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

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

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

|-
| NATURAL_SKILL
| skill:value
| The creature possesses this skill at this level inherently. It begins with this skill at this level, and the skill may never rust below this level. Requires CAN_LEARN or INTELLIGENT to function (changed in .25 or earlier that CAN_LEARN is no longer required).

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

|-
| NIGHT_CREATURE_HUNTER
|
| If this creature has SPOUSE_CONVERTER, it will actively attempt to seek out potential conversion targets, abduct them, and convert them. Night creatures will seek out one SPOUSE_CONVERSION_TARGET <s>of the opposite sex</s>(seems to choose anyone of any sex of the caste/s that have the CONVERTED_SPOUSE tag), convert them, and then have children with them(if possible). NIGHT_CREATURE_HUNTERs without SPOUSE_CONVERTER will not be placed. Setting the number of night creatures to zero in the world gen parameters will remove only the randomly-generated night creatures.

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

|-
| NO_DIZZINESS
|
| Creature cannot become dizzy

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

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

|-
| NO_FEVERS
|
| Creature cannot suffer fevers

|-
| NO_GENDER
|
| Creature has no gender.

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

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

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

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

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

|-
| NOBONES
|
| Creature has no bones.

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

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

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

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

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

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

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

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

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

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

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

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

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

|-
| NOT_BUTCHERABLE
|
| Cannot be butchered

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

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

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

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

|-
| PATTERNFLIER
|
|

|-
| PEARL
|
| Creature will generate pearls.

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

|-
| REMAINS_UNDETERMINED
|
| Unknown.

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

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

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

|}

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

|-
| SMALL_REMAINS
|
| If a creature has this token, it'll leave "remains" instead of a corpse.

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

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

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

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

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

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

|-
| SPEED
| value
| Sets the creatures' movement and work speed, 1000/[100 + SPEED X] is the resulting effect on creatures movement and work rates from default. See {{L|Speed}} for more information.

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

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

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

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

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

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

|}

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

|-
| UNIQUE_DEMON
|
| Typically found on generated {{L|demon}}s; causes the game to create a single named instance of the demon which will emerge from the underworld and take over civilizations during worldgen. Cannot be used for modder-defined creatures.

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

|-
| VERMIN_NOTRAP
|
| The creature cannot be caught in baited animal traps; however, a "catch live land animal" task may still be able to capture one if a dwarf finds one roaming around.

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

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

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

|-
| VERMINHUNTER
|
| Implies AT_PEACE_WITH_WILDLIFE, RETURNS_VERMIN_KILLS_TO_OWNER, HUNTS_VERMIN, and ADOPTS_OWNER.

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

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

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

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

|-
| WEBBER
|
* {{L|material token}}
| Allows the creature to create webs, and defines what the webs are made of.

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

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

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

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

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

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

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

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

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

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

|-
| ATTACK_FLAG_EDGE
|
| attack type

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

|}

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

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

v0.31:Raw file

2011-07-17T01:54:28Z

ArKFallen: Undo revision 151400 by ArKFallen (Talk)

{{av}}
{{Quality|Fine}}
'''Raw files''' are text files found in the '''\raw\objects''' subfolder of Dwarf Fortress (used for {{L|world generation}}) and in '''\data\save\<region-name>\raw\objects''' (for already generated worlds). These files can be looked through to discover various specifics of game items, materials, and creatures, and can be changed to alter how the game behaves. They are sometimes referred to by players as just "the raws".

The '''\raw\graphics''' subfolder of Dwarf Fortress is used to store user-customizable {{L|graphics sets|graphics sets}}.

Dwarf Fortress is not an open source program, so most {{L|modding|modding}} of the game is limited to altering the raws or doing {{L|memory hacking}}.

Duplicating the raw files can cause several bugs, and even crashes. The game gets very messy and buggy when you do it.

==Syntax of raw files==

filename

[OBJECT:TYPE]

[TYPE:ID]
<...contents...>

ID is an unique identificator for your type to use (i.e. [CREATURE:DOG], ID=DOG or [ITEM:ITEM_WEAPON_SWORD], ID=ITEM_WEAPON_SWORD).

===Types of content:===
*BODY - body parts and structures
*BODY_DETAIL_PLAN - similar to CREATURE_VARIATION, but used for defining tokens related to body parts (specifically materials, tissues, the assignment thereof, and body part positions, relative sizes, etc.)
*BUILDING - custom workshops
*CREATURE - creatures
*CREATURE_VARIATION - variations that can be applied to creatures (eg, making them giants, or anthropomorphic). Technically a series of tokens that are added to or removed from the creature (essentially a set of templated changes)
*DESCRIPTOR_COLOR - named colours for use with DESCRIPTOR_PATTERN objects (other purposes unknown)
*DESCRIPTOR_PATTERN - patterns with colour combinations for use with creatures (other purposes unknown)
*DESCRIPTOR_SHAPE - shapes with descriptions and variations. Previous versions used this for engravings, but their use in the current version is unverified as of yet.
*ENTITY - civilization types, with assigned race, language, culture, ethics, and social structure.
*GRAPHICS - graphic tiles for creatures
*INORGANIC - inorganic material definitions.
*ITEM - items ranging from ammunition to food types, has secondary types for the purposes of [TYPE:ID]
**ITEM_AMMO - ammunition for ranged weapons
**ITEM_ARMOR - body clothing, including armour
**ITEM_FOOD - prepared food definitions
**ITEM_GLOVES - hand clothing, including armour
**ITEM_HELM - head clothing, including armour
**ITEM_INSTRUMENT - instrument definitions
**ITEM_PANTS - lower body clothing, including armour
**ITEM_SHIELD - shields (always armour?)
**ITEM_SHOES - foot clothing, including armour
**ITEM_SIEGEAMMO - ammunition for siege weapons (only ballista?)
**ITEM_TOY - toy definitions
**ITEM_TRAPCOMP - components that can be used in weapon traps (two special tags define trapcomps that can be used in other constructions: IS_SCREW and IS_SPIKE)
**ITEM_WEAPON - weapons that are used by soldiers, as well as digging tools
*LANGUAGE - word definitions for the languages used by ENTITY objects
**Entries beginning with [SYMBOL:ID] sort words into symbolic/poetic groups to be referenced by ENTITY preferences
**Entries beginning with [WORD:ID] define words and their alternate forms (in english)
*MATERIAL_TEMPLATE - definitions of information common to groups of materials (referenced all over the place)
*PLANT - definitions of plants, their materials, and their derivitives
*REACTION - reactions/custom workshop jobs (turn items into other items though dwarven effort)
*TISSUE_TEMPLATE - defines templated tissues for use with BODY_DETAIL_PLAN objects or in creatures

Usually empty strings are used to divide different types of structures like the fine name and [OBJECT:] or different entries, however everything which is not a token besides the 1st string (which is the filename) is understood as comments and is not considered.

The tokens are enclosed in square brackets ([TOKEN:VALUES]).

When a world is generated, the raw files are copied from <game folder>/raw/ to <game folder>/data/save/REGION/raw/. It is currently unknown how much these can then be changed without breaking the save.

A list of tokens can be seen at [[:Category:Tokens]].

[[Category:Files]]
{{Category|Modding}}

v0.31:Raw file

2011-07-17T01:53:41Z

ArKFallen: Undo revision 151407 by ArKFallen (Talk)

{{av}}
{{Quality|Fine}}
'''Raw files''' are text files found in the '''\raw\objects''' subfolder of Dwarf Fortress (used for {{L|world generation}}) and in '''\data\save\<region-name>\raw\objects''' (for already generated worlds). These files can be looked through to discover various specifics of game items, materials, and creatures, and can be changed to alter how the game behaves. They are sometimes referred to by players as just "the raws".

The '''\raw\graphics''' subfolder of Dwarf Fortress is used to store user-customizable {{L|graphics sets|graphics sets}}.

Dwarf Fortress is not an open source program, so most {{L|modding|modding}} of the game is limited to altering the raws or doing {{L|memory hacking}}.

Duplicating the raw files can cause several bugs, and even crashes. The game gets very messy and buggy when you do it.

==Syntax of raw files==

filename

[OBJECT:TYPE]

[TYPE:ID]
<...contents...>

ID is an unique identificator for your type to use (i.e. [CREATURE:DOG], ID=DOG or [ITEM:ITEM_WEAPON_SWORD], ID=ITEM_WEAPON_SWORD).

===Types of content:===
*BODY - body parts and structures
*BODY_DETAIL_PLAN - similar to CREATURE_VARIATION, but used for defining tokens related to body parts (specifically materials, tissues, the assignment thereof, and body part positions, relative sizes, etc.)
*BUILDING - custom workshops
*CREATURE - creatures
*CREATURE_VARIATION - variations that can be applied to creatures (eg, making them giants, or anthropomorphic). Technically a series of tokens that are added to or removed from the creature (essentially a set of templated changes)
*DESCRIPTOR_COLOR - named colours for use with DESCRIPTOR_PATTERN objects (other purposes unknown)
*DESCRIPTOR_PATTERN - patterns with colour combinations for use with creatures (other purposes unknown)
*DESCRIPTOR_SHAPE - shapes with descriptions and variations. Shapes are used in engravings and as civ symbols. One of their adjectives will describe the shape.
*ENTITY - civilization types, with assigned race, language, culture, ethics, and social structure.
*GRAPHICS - graphic tiles for creatures
*INORGANIC - inorganic material definitions.
*ITEM - items ranging from ammunition to food types, has secondary types for the purposes of [TYPE:ID]
**ITEM_AMMO - ammunition for ranged weapons
**ITEM_ARMOR - body clothing, including armour
**ITEM_FOOD - prepared food definitions
**ITEM_GLOVES - hand clothing, including armour
**ITEM_HELM - head clothing, including armour
**ITEM_INSTRUMENT - instrument definitions
**ITEM_PANTS - lower body clothing, including armour
**ITEM_SHIELD - shields (always armour?)
**ITEM_SHOES - foot clothing, including armour
**ITEM_SIEGEAMMO - ammunition for siege weapons (only ballista?)
**ITEM_TOY - toy definitions
**ITEM_TRAPCOMP - components that can be used in weapon traps (two special tags define trapcomps that can be used in other constructions: IS_SCREW and IS_SPIKE)
**ITEM_WEAPON - weapons that are used by soldiers, as well as digging tools
*LANGUAGE - word definitions for the languages used by ENTITY objects
**Entries beginning with [SYMBOL:ID] sort words into symbolic/poetic groups to be referenced by ENTITY preferences
**Entries beginning with [WORD:ID] define words and their alternate forms (in english)
*MATERIAL_TEMPLATE - definitions of information common to groups of materials (referenced all over the place)
*PLANT - definitions of plants, their materials, and their derivitives
*REACTION - reactions/custom workshop jobs (turn items into other items though dwarven effort)
*TISSUE_TEMPLATE - defines templated tissues for use with BODY_DETAIL_PLAN objects or in creatures

Usually empty strings are used to divide different types of structures like the fine name and [OBJECT:] or different entries, however everything which is not a token besides the 1st string (which is the filename) is understood as comments and is not considered.

The tokens are enclosed in square brackets ([TOKEN:VALUES]).

When a world is generated, the raw files are copied from <game folder>/raw/ to <game folder>/data/save/REGION/raw/. It is currently unknown how much these can then be changed without breaking the save.

A list of tokens can be seen at [[:Category:Tokens]].

[[Category:Files]]
{{Category|Modding}}

v0.31:Raw file

2011-07-17T01:51:51Z

ArKFallen: Undo revision 151403 by Quietust (Talk)

{{av}}
{{Quality|Fine}}
'''Raw files''' are text files found in the '''\raw\objects''' subfolder of Dwarf Fortress (used for {{L|world generation}}) and in '''\data\save\<region-name>\raw\objects''' (for already generated worlds). These files can be looked through to discover various specifics of game items, materials, and creatures, and can be changed to alter how the game behaves. They are sometimes referred to by players as just "the raws".

The '''\raw\graphics''' subfolder of Dwarf Fortress is used to store user-customizable {{L|graphics sets|graphics sets}}.

Dwarf Fortress is not an open source program, so most {{L|modding|modding}} of the game is limited to altering the raws or doing {{L|memory hacking}}.

Duplicating the raw files can cause several bugs, and even crashes. The game gets very messy and buggy when you do it.

==Syntax of raw files==

filename

[OBJECT:TYPE]

[TYPE:ID]
<...contents...>

ID is an unique identificator for your type to use (i.e. [CREATURE:DOG], ID=DOG or [ITEM:ITEM_WEAPON_SWORD], ID=ITEM_WEAPON_SWORD).

===Types of content:===
*BODY - body parts and structures
*BODY_DETAIL_PLAN - similar to CREATURE_VARIATION, but used for defining tokens related to body parts (specifically materials, tissues, the assignment thereof, and body part positions, relative sizes, etc.)
*BUILDING - custom workshops
*CREATURE - creatures
*CREATURE_VARIATION - variations that can be applied to creatures (eg, making them giants, or anthropomorphic). Technically a series of tokens that are added to or removed from the creature (essentially a set of templated changes)
*DESCRIPTOR_COLOR - named colours for use with DESCRIPTOR_PATTERN objects (other purposes unknown)
*DESCRIPTOR_PATTERN - patterns with colour combinations for use with creatures (other purposes unknown)
*DESCRIPTOR_SHAPE - shapes with descriptions and variations. Shapes are used in engravings and as civ symbols. One of their adjectives will describe the shape.
*ENTITY - civilization types, with assigned race, language, culture, ethics, and social structure.
*GRAPHICS - graphic tiles for creatures
*INORGANIC - inorganic material definitions.
*ITEM - items ranging from ammunition to food types, has secondary types for the purposes of [TYPE:ID]
**ITEM_AMMO - ammunition for ranged weapons
**ITEM_ARMOR - body clothing, including armour
**ITEM_FOOD - prepared food definitions
**ITEM_GLOVES - hand clothing, including armour
**ITEM_HELM - head clothing, including armour
**ITEM_INSTRUMENT - instrument definitions
**ITEM_PANTS - lower body clothing, including armour
**ITEM_SHIELD - shields (always armour?)
**ITEM_SHOES - foot clothing, including armour
**ITEM_SIEGEAMMO - ammunition for siege weapons (only ballista?)
**ITEM_TOY - toy definitions
**ITEM_TRAPCOMP - components that can be used in weapon traps (two special tags define trapcomps that can be used in other constructions: IS_SCREW and IS_SPIKE)
**ITEM_WEAPON - weapons that are used by soldiers, as well as digging tools
*LANGUAGE - word definitions for the languages used by ENTITY objects
**Entries beginning with [SYMBOL:ID] sort words into symbolic/poetic groups to be referenced by ENTITY preferences
**Entries beginning with [WORD:ID] define words and their alternate forms (in english)
*MATERIAL_TEMPLATE - definitions of information common to groups of materials (referenced all over the place)
*PLANT - definitions of plants, their materials, and their derivitives
*REACTION - reactions/custom workshop jobs (turn items into other items though dwarven effort)
*TISSUE_TEMPLATE - defines templated tissues for use with BODY_DETAIL_PLAN objects or in creatures

* usually the empty strings are used to divide different types of structures like the fine name
and [OBJECT:] or different entries, however everything which is not a token besides the 1st string
(which is the filename) is understood as comments and is not considered.

The tokens are enclosed in square brackets ([TOKEN:VALUES]).

When a world is generated, the raw files are moved from <game folder>/raw/ to <game folder>/data/save/REGION/raw/. It is currently unknown how much these can then be changed without breaking the save.

A list of tokens can be seen at [[:Category:Tokens]].

[[Category:Files]]
{{Category|Modding}}

v0.31:Raw file

2011-07-16T22:46:35Z

ArKFallen: /* Types of content: */

{{av}}
{{Quality|Fine}}
'''Raw files''' are text files found in the '''\raw\objects''' subfolder of Dwarf Fortress (used for {{L|world generation}}) and in '''\data\save\<region-name>\raw\objects''' (for already generated worlds). These files can be looked through to discover various specifics of game items, materials, and creatures, and can be changed to alter how the game behaves. They are sometimes referred to by players as just "the raws".

The '''\raw\graphics''' subfolder of Dwarf Fortress is used to store user-customizable {{L|graphics sets|graphics sets}}.

Dwarf Fortress is not an open source program, so most {{L|modding|modding}} of the game is limited to altering the raws or doing {{L|memory hacking}}.

Duplicating the raw files can cause several bugs, and even crashes. The game gets very messy and buggy when you do it.

==Syntax of raw files==

filename

[OBJECT:TYPE]

[TYPE:ID]
<...contents...>

ID is an unique identificator for your type to use (i.e. [CREATURE:DOG], ID=DOG or [ITEM:ITEM_WEAPON_SWORD], ID=ITEM_WEAPON_SWORD).

===Types of content:===
*BODY - body parts and structures
*BODY_DETAIL_PLAN - similar to the following creature variation file type, but used for defining tokens related to body parts (specifically materials, tissues, the assignment thereof, and body part positions, relative sizes, etc.)
*BUILDING - custom workshops
*CREATURE - creatures
*CREATURE_VARIATION - variations that can be applied to creatures (eg, making them giants, or anthropomorphic). Technically a series of tokens that are added to or removed from the creature (essentially a set of templated changes)
*DESCRIPTOR_COLOR - named colours for use with DESCRIPTOR_PATTERN objects (other purposes unknown)
*DESCRIPTOR_PATTERN - patterns with colour combinations for use with creatures (other purposes unknown)
*DESCRIPTOR_SHAPE - shapes with descriptions and variations. Shapes are used in engravings and as civ symbols. One of their adjectives will describe the shape.
*ENTITY - civilization types, with assigned race, language, culture, ethics, and social structure.
*GRAPHICS - graphic tiles for creatures
*INORGANIC - inorganic material definitions.
*ITEM - items ranging from ammunition to food types, has secondary types for the purposes of [TYPE:ID]
**ITEM_AMMO - ammunition for ranged weapons
**ITEM_ARMOR - body clothing, including armour
**ITEM_FOOD - prepared food definitions
**ITEM_GLOVES - hand clothing, including armour
**ITEM_HELM - head clothing, including armour
**ITEM_INSTRUMENT - instrument definitions
**ITEM_PANTS - lower body clothing, including armour
**ITEM_SHIELD - shields (always armour?)
**ITEM_SHOES - foot clothing, including armour
**ITEM_SIEGEAMMO - ammunition for siege weapons (only ballista?)
**ITEM_TOY - toy definitions
**ITEM_TRAPCOMP - components that can be used in weapon traps (two special tags define trapcomps that can be used in other constructions: IS_SCREW and IS_SPIKE)
**ITEM_WEAPON - weapons that are used by soldiers, as well as digging tools
*LANGUAGE - word definitions for the languages used by ENTITY objects
**Entries beginning with [SYMBOL:ID] sort words into symbolic/poetic groups to be referenced by ENTITY preferences
**Entries beginning with [WORD:ID] define words and their alternate forms (in english)
*MATERIAL_TEMPLATE - definitions of information common to groups of materials (referenced all over the place)
*PLANT - definitions of plants, their materials, and their derivitives
*REACTION - reactions/custom workshop jobs (turn items into other items though dwarven effort)
*TISSUE_TEMPLATE - defines templated tissues for use with BODY_DETAIL_PLAN objects or in creatures

* usually the empty strings are used to divide different types of structures like the fine name
and [OBJECT:] or different entries, however everything which is not a token besides the 1st string
(which is the filename) is understood as comments and is not considered.

The tokens are enclosed in square brackets ([TOKEN:VALUES]).

When a world is generated, the raw files are moved from <game folder>/raw/ to <game folder>/data/save/REGION/raw/. It is currently unknown how much these can then be changed without breaking the save.

A list of tokens can be seen at [[:Category:Tokens]].

[[Category:Files]]
{{Category|Modding}}

v0.31:Thought

2011-06-26T16:44:41Z

ArKFallen: /* Unhappy Thoughts */

{{quality|Fine|08:00, 22 May 2010 (UTC)}}{{av}}

'''Thoughts''' are the reported observations and sentiments of the {{l|Dwarves}} in {{l|Dwarf fortress mode|Fortress Mode}}. Over the course of play, a dwarf will experience things that make them more or less happy, with each experience recorded and displayed as a Thought. The rate at which a dwarf gains certain thoughts is controlled by {{l|personality}}.

Dwarven psychology is relatively simple. There are Good Thoughts and Bad Thoughts. Lots of Good Thoughts will make your dwarves ecstatic {{l|party|party animals}} who have lots of {{l|children}}. Too many Bad Thoughts and your dwarvese will throw {{L|tantrum|tantrums}}. Too many tantrums and the Bad Thoughts will {{l|Fun|spread}}. If you wish to avoid Bad Thoughts, please consult ways of {{L|keeping your dwarves happy}}.

The change in {{L|Status icon|status}} that triggers bad thoughts about thirst, hunger, and fatigue can also slow the speed at which a dwarf works and moves. To view a dwarf's recent thoughts and current happiness level, press {{key|k}}, move the cursor to the dwarf, and press {{key|enter}} twice. (Or {{key|v}}, move to the dwarf, then {{key|z}} and {{key|enter}}.) Now you will see a page describing the dwarf's feelings and thoughts, physical description, and a set of phrases describing personality traits. A dwarf's level of happiness will affect the type of {{L|strange mood}} they fall into should they be chosen for one.

Below are thoughts your dwarves may experience over the course of a game. For a full list of the game's programmed thoughts (whether or not they appear in gameplay), please see the {{l|List of Dwarven Thoughts}}.

==Happy Thoughts==
{| border = "1"
|-
!Thought
!Triggered by
|-
|Slept in a (good quality) {{L|bedroom}} recently
|doesn't have to be the dwarf's assigned quarters
|-
|Dined in a (good quality) {{L|dining room}} lately
|self-explaining
|-
|Admired a (good quality) (object) lately
|Passed right next to or over a constructed piece of {{L|furniture}} and noticed it. Influenced by value, not quality as implied by the thought <sub>(what are the chances of noticing an object?)</sub>
|-
|Talked with a spouse lately
|Married dwarves idling in the same room
|-
|Talked with a friend lately
|Idling in the same room with a friend
|-
|Talked with a child recently
|When talking to the dwarf's own son or daughter (whether a child or adult)
|-
|Made a friend recently
|Idling in the same room with a dwarf who prefers socializing
|-
|Had a {{L|soap|nice bath}} recently
|usually from {{L|healthcare|Clean Patient}}
|-
|Was comforted by a lovely {{L|waterfall}} lately
|Sprayed by mist from a waterfall.
|-
|Was comforted by a wonderfull {{L|creature}} in a {{L|cage}} recently
|Passed near a caged favorite creature.
|-
|Was glad to have {{L|justice|punishment}} (delayed/reduced) recently
|No one around to execute the dwarf's punishment
|-
|Satisfied at work lately
|When the dwarf works with materials, items or animals he/she likes.
|-
|Took someone to {{L|hospital|bed}} recently
|Moved an unconscious (usually injured) dwarf to a bed.
|-
|Enjoyed throwing something recently
|Threw an item during a {{L|tantrum}}
|-
|Enjoyed smashing a building recently
|Destroyed a building or piece of furniture during a {{L|tantrum}}
|-
|Enjoyed starting a fist fight recently
|Attacked another dwarf during a {{L|tantrum}}
|-
|Is quite pleased with making an {{L|artifact}}
|Crafted an artifact
|-
|Took joy in slaughter lately
|Have killed another creature
|-
|Adopted a new pet recently
|self-explaining
|-
|Was pleased to have been able to give somebody (food/water) lately
|When a dwarf with a kind personality feeds or gives water to another.
|-
|Gave somebody (food/water) lately
|When a dwarf feeds or gives water to another.
|-
|Ate a legendary meal lately
|Dwarf ate a prepared meal of Legendary quality. Might be influenced by preferences.
|-
|Was able to rest and recuperate lately
|Self-explanatory
|-
|Had a (fine/truly decadent) {{L|booze|drink}} lately
|Dwarf drank alcohol they have a {{L|preference}} for. The thought is happier if the booze is home-brewed.
|-
|Beat somebody recently
|Administering {{L|Justice}}
|}

==Unhappy Thoughts==
{| border = "1"
|-
!Thought
!Triggered by
|-
|Dummy|Complained of (hunger/thirst) lately
|Got hungry/thirsty and didn't eat or drink soon enough (actual time unmeasured).
|-
|Has been (starving/dehydrated) recently
|Has not had food or drink for a long time and will soon {{l|death|die}}.
|-
|Forced to eat vermin to survive lately
|Dwarf hunted vermin for food due to starvation. Will still die soon without real food.
|-
|Complained about the nasty water lately
|Got thirsty and had to drink from open water because no alcohol or at least a {{l|well}} was available
|-
|Was forced to drink vomit lately
|A tainted water source causes this little gem.
|-
|Disgusted by a miasma recently
|Dwarf was exposed to {{l|miasma}}
|-
|Accidentally killed somebody in a fit of rage lately
|Killed a dwarf or someone's pet during a {{l|tantrum}}
|-
|Has been (tired/exhausted) lately
|Became sleepy but wasn't able to {{l|sleep}} because a task had to be completed. Exhaustion is extreme tiredness and may come from over-exertion.
|-
|Was (put off/flustered/upset/very upset/greatly upset/angered/enraged/shattered/traumatized/utterly traumatized) by a lesser's pretentious (office/sleeping/dining/burial) arrangements recently
|{{l|Noble}} dwarf is jealous of a lower-ranked dwarf's room and will soon go {{l|insanity|insane}}.
|-
|Slept in a (poor/very poor/awful/horrible/horribly substandard) bedroom recently
|Noble dwarf has slept in an unsatisfactory {{l|bedroom}}. Increasing levels of badness.
|-
|Conducted a meeting in a (poor/very poor/awful/horrible/horribly substandard) setting recently
|Noble dwarf hates the {{l|office}} provided them for meetings.
|-
|Dined in a (poor/very poor/awful/horrible/horribly substandard) dining room recently
|Stupid noble wants a better {{l|dining room}}.
|-
|Worried greatly about not having a tomb after gaining another year
|Noble dwarf is upset about lacking a {{l|tomb}} on their birthday.
|-
|Worried about having a (poor/very poor/awful/horrible/horribly substandard) tomb after gaining another year
|As above, but the dwarf has a tomb, just one that isn't good enough
|-
|Was (very/greatly) angered at the state of demands recently
|Noble dwarf {{l|demand|demanded}} something that wasn't provided.
|-
|Upset by having a mandate ignored lately
|Noble issued a {{l|mandate}} that went unfulfilled.
|-
|Upset that a criminal could not be properly punished
|A dwarf became a criminal without an established {{l|Justice}} system present.
|-
|Upset by not having enough (chests/cabinets/weapon racks/armor stands) lately
|Noble doesn't have enough of their position's furniture requirements.
|-
|Attacked/Haunted by the dead lately
|Dwarf was frightened or injured by an unacquainted ghost. Hauntings aren't as bad as attacks for the dwarven psyche.
|-
|Attacked/Haunted by a dead (spouse/lover/sibling/and still annoying acquaintance) lately
|Dwarf was frightened or injured by an acquainted ghost, somewhat worse than the above thought.
|-
|Attacked/Haunted by own dead (mother/father/child) lately
|Dwarf was frightened or injured by a closely-related ghost. This is a very bad thought.
|-
|Yelled at somebody in charge lately (but only got angrier)
|Dwarf yelled at a Leader/Mayor and felt worse afterward.
|-
|Cried on somebody in charge lately (but only felt more depressed)
|Like above, but for dwarves less prone to anger/more prone to depression.
|-
|Complained of the lack of chairs lately
|Was eating and couldn't find an unoccupied {{L|chair}}.
|-
|Complained of the crowded tables lately
|Tried to eat at a table someone else was already eating at.
|-
|Complained of the lack of dining tables lately
|Was eating and couldn't find an unused {{L|table}} next to the chair it sat on while eating.
|-
|Depressed about being confined
|Dwarf is in {{l|jail|prison}}.
|-
|Slept uneasily due to noise lately
|Was sleeping in the zone of influence of a {{L|noise}} source.
|-
|Woken by noise while sleeping recently
|As above, but a worse thought from being closer to noise.
|-
|Slept without a proper room recently
|Was sleeping and couldn't find a bed designated as a {{L|bedroom}} not assigned to someone else.
|-
|Slept in the (mud/dirt/grass/rocks/ice/a ('rough stone') floor) recently
|Could not find any {{L|bed}} for sleeping, or Dwarf is a {{l|ambusher|Hunter}}. The thought may be worse with certain terrain.
|-
|Slept on rocks/pebbles/ice/a floor/a pile of driftwood) recently
|Like above. May or may not be a slightly better thought.
|-
|Caught in the rain recently
|Went outside while it was {{L|weather|raining}}
|-
|(Irritated/Nauseated) by the sun lately
|Is suffering from {{L|cave adaptation}} and went outside. Nausea indicates a more serious case.
|-
|Annoyed by flies
|Shared a tile with {{l|fly|flies}}.
|-
|Accosted by terrible vermin
|Exposed to {{L|vermin}} that the dwarf particularly hates.
|-
|Saw something unpleasant in a cage recently
|Dwarf examined a cage containing hated vermin
|-
|Killed somebody by accident while sparring recently
|Sparring dwarf accidentally(?) kills another. Defunct now that sparring is now totally safe, whatever weapons are used.
|-
|Had a miscarriage recently
|Pregnant dwarves that lose their baby before birth (like female military getting too much damage to the lower body)
|-
|Attacked recently
|Dwarf was assaulted by a hostile creature.
|-
|Witnessed death
|Present while another dwarf died.
|-
|Lost a (friend/pet) to tragedy recently
|A dwarf with relationship status "Friend" or a pet died.
|-
|Lost a (family member) to tragedy recently
|Someone related to the dwarf has died. Worse thought than above.
|-
|Forced to endure the decay of a (friend/pet/family member/annoying acquaintance)
|Dwarf was exposed to the {{l|miasma|rotten}} corpse of a companion, loved one or rival.
|-
|Unable to find somebody in charge to cry on lately
|Dwarf couldn't complain to the Expedition Leader/Mayor, either because they are inaccessible or busy. This may also include other nobles.
|-
|Upset that a criminal could not be properly punished
|Crimes always have an "injured" party (the noble who assigns the mandate), and a "criminal" party (the dwarf who breaks the mandate). The injured party gets this thought if the criminal goes unpunished.
|-
|Was (very) embarrassed to have to conduct an official meeting in a (dining room/bedroom)
|Noble dwarf had to meet a diplomat without an office (or any dining room, if the bedroom was used).
|-
|Incredibly embarrassed not to have any rooms lately
|Noble dwarf went without any kind of room to conduct a meeting in.
|-
|Beaten recently
|{{L|Justice}} served.
|-
|(Irritated at/Unhappy at/Suffered the pain of) having to haul somebody to bed lately
|Selfish dwarves will be annoyed at needing to help others.
|-
|(Irritated at/Unhappy at/Suffered the pain of) having to give somebody (food/water) lately
|As above, with bringing food or drink to others.
|-
|Sustained (minor/major) injuries recently
|Dwarf recently suffered torn arteries and/or broken bones.
|-
|Knocked out during a cave-in lately
|Being caught in a {{l|cave-in}}. May or may not be coupled with the above thought.
|-
|Choked on smoke/dust underground lately
|Dwarf was exposed to either smoke from a {{l|fire}} or {{l|dust}} from a cave-in.
|-
|Suffered the travesty of art defacement
|Loss of a masterpiece, (usually destroyed or stolen). This is a pretty major hit. Can include mining through an engraved wall or allowing a masterful meal to rot away.
|-
|Complained about the draft lately
|Newly drafted into a [[military]] squad as a recruit.
|-
|Upset about being relieved from duty
|Military dwarf without civilian skills is removed from active duty.
|-
|(Complained about/Enraged by/Depressed by) long patrol duty
|Military dwarf has active order (or training) for more than one month (one for complaining, two for growing enraged/depressed if the dwarf is slow to anger).
|}

==Negative Thought Modifiers==
* "is quick to tire"

==Positive Thought Modifiers==

==Effects of Thoughts==

== The mechanics of thoughts ==

A dwarf's emotional state is quantified in a single number which is influenced by recent thoughts in an unknown manner.

{| border="1" cellpadding="4" style="border-collapse:collapse"
! Number
! Happiness
|-
| 151 or more || ecstatic
|-
| 126 to 150 || happy
|-
| 76 to 125 || quite content
|-
| 51 to 75 || fine
|-
| 26 to 50 || unhappy
|-
| 1 to 25 || very unhappy
|-
| 0 || miserable
|}

{{Category|Thoughts}}