Dwarf Fortress Wiki - User contributions [en]

Helicoprion

2026-07-26T13:27:16Z

Quietust: add wikipedia link

{{Quality|Fine}}
{{Creaturelookup/0
|image=helicoprion_sprites.png
|portrait=helicoprion_portrait_anim.gif
|wiki=Helicoprion}}
{{av}}
{{creaturedesc}}

[[Helicoprion]] is an extinct cartilaginous fish(called a [[shark]] in its creature description, though it is closer to ratfish) from the [https://en.wikipedia.org/wiki/Permian Permian] period. It is characterized by its tooth whorl which is used for hunting prey. It is found in temperate and tropical [[oceans]].

As with all [[Extinction|real-world extinct creatures]], its spawning depends on settings chosen during world creation. A baby helicoprion is called a ''hatchling''.

As with all non-vermin sea creatures, capturing a helicoprion requires a modified [[drowning chamber]]. This can be used as a source of [[meat]], though it is to be noted that the helicoprion is a cartilaginous fish(similarly to sharks and rays), which means it has no [[bones]] and will instead drop useless [[cartilage]].

Some dwarves like helicoprion for their ''tooth whorl''.

{{gamedata}}
{{Creatures}}

Helicoprion

2026-07-26T13:26:32Z

Quietust:

{{Quality|Fine}}
{{Creaturelookup/0
|image=helicoprion_sprites.png
|portrait=helicoprion_portrait_anim.gif}}
{{av}}
{{creaturedesc}}

[[Helicoprion]] is an extinct cartilaginous fish(called a [[shark]] in its creature description, though it is closer to ratfish) from the [https://en.wikipedia.org/wiki/Permian Permian] period. It is characterized by its tooth whorl which is used for hunting prey. It is found in temperate and tropical [[oceans]].

As with all [[Extinction|real-world extinct creatures]], its spawning depends on settings chosen during world creation. A baby helicoprion is called a ''hatchling''.

As with all non-vermin sea creatures, capturing a helicoprion requires a modified [[drowning chamber]]. This can be used as a source of [[meat]], though it is to be noted that the helicoprion is a cartilaginous fish(similarly to sharks and rays), which means it has no [[bones]] and will instead drop useless [[cartilage]].

Some dwarves like helicoprion for their ''tooth whorl''.

{{gamedata}}
{{Creatures}}

Mythical substance

2026-07-25T19:22:23Z

Quietust: proper semicolon usage

{{av}}
{{minorspoiler}}
[[File:Healing globs moments before consumption.png|right|200px|thumb|An [[adventurer]] about to eat a healing [[glob]]. ''Art by Rumrusher.'']]
'''Mythical substances''' are procedurally-generated [[liquid]]s and [[glob]]s with [[Magic|magical]] properties. Each world has a number of differently-named substances, such as "odd jelly" or "peculiar broth," though currently, all of them carry the same [[syndrome]].

==Healing potion==
A [[mysterious dungeon]]'s [[Dungeon guardian|guardian]] carries a [[waterskin]] filled with a restorative substance that they can consume in combat. Ingesting it grants a powerful [[syndrome]] that cures nearly all [[wound]]s, even [[Syndrome#CE_REGROW_PARTS|regrowing limbs]] and [[Syndrome#CE_HEAL_NERVES|healing nerve damage]], but not blood loss; however, it can allow you to live through Titan fire long enough to stop you from melting. Even [[undead]] creatures benefit from it, to the point of removing any rot their bodies have, restoring them to perfect condition.

Creatures that are [[Construct creature|immune to poison]] (not ``GENERAL_POISON``) do not benefit from this substance.

[[File:substance_heal_preview.png|thumb|350px|center|The substance's effects.]]

==See also==
*[[Weather#Evil_weather]]
{{Scriptdata}}
{{V50 materials}}
[[Category:Globs]]
[[Category:Adventurer mode]]
[[Category:Myth]]
[[ru:Mythical substance]]

40d:Blizzard man

2026-07-24T22:04:19Z

Quietust:

{{Quality|Fine|08:11, 1 June 2010 (UTC)}}
{{40d creaturelookup/0|item=Puddle of [[water]]|wiki=no}}
{{av}}

'''Blizzard men''' are large predatory creatures that can be found in [[evil]] [[glacier]]s and [[tundra]]s. When killed, their bodies will melt, creating a small puddle of [[water]] which will quickly freeze into a chunk of ice.

{{gamedata}}
{{Creatures}}
{{Category|Humanoids}}

23a:Blizzard man

2026-07-24T22:03:46Z

Quietust:

{{quality|Fine|23:56, 13 August 2010 (UTC)}}
{{23a creaturelookup/0|item=Puddle of [[water]]|wiki=no}}
{{av}}

'''Blizzard men''' are large predatory creatures that can be found in [[evil]] [[glacier]]s and [[tundra]]s. When killed, their bodies will melt, creating a small puddle of [[water]] which will quickly freeze.

{{gamedata}}
{{Creatures}}
{{Category|Humanoids}}

40d:Blizzard man

2026-07-24T22:03:04Z

Quietust:

{{Quality|Fine|08:11, 1 June 2010 (UTC)}}
{{40d creaturelookup/0|item=Puddle of [[water]]|wiki=no}}
{{av}}

'''Blizzard men''' are large predatory creatures that can be found in [[evil]] [[glacier]]s and [[tundra]]s. When killed, their bodies will melt, creating a pool of [[water]], which will quickly freeze.

{{gamedata}}
{{Creatures}}
{{Category|Humanoids}}

Blizzard man

2026-07-24T21:57:47Z

Quietust: this is worth a back-reference

{{Quality|Exceptional}}
{{Creaturelookup/0
|image=blizzard_man_sprite.png
|portrait=blizzard_man_portrait.png
|vary=no
|contrib=yes
}}
{{av}}
{{creaturedesc}}

'''Blizzard men''' are a species of intelligent and very rare [[creature]] found in [[evil]]-aligned [[tundra]]s and [[glacier]]s, who spawn one at a time. Weighing more than a [[troll]], these beasts are aggressive and will attack any [[dwarf]] who approaches them with punches, kicks, scratches and bites, and should be disposed of with an equipped [[military]] squad or [[trap]]s. Despite being named in a similar fashion, they do not share many characteristics with [[construct creature]]s like the subterranean [[gabbro man]] or [[fire man]]. Fighting a blizzard man in [[adventurer mode]] grants more experience than other normal creatures because of their {{token|DIFFICULTY|c|2}} token.

Despite what their description may imply, blizzard men are not made of ice, instead being made of normal flesh. However, a note on their raw files states [[Main:Toady One|Toady One]] plans to make them be made out of ice in a future update (as they originally were in the [[40d:Blizzard man|distant past]]). Blizzard men possess the {{token|NO_THOUGHT_CENTER_FOR_MOVEMENT}} token, meaning that their limbs do not need to be connected to a brain in order to function (they do not have brains). Due to the aforementioned intelligence, dwarves will not [[butcher]], eat or use products made from blizzard men, limiting their use to occupying space in your [[refuse]] [[stockpile]], [[live training]] or putting them somewhere of your liking if you capture one in a [[cage]] trap.

Some dwarves [[Preferences|like]] blizzard men for their ''translucent skin'', their ''icicle teeth'', their ''glowing red eyes'' and their ''pointy ears''.

{{Translation| dwarven = zolak udos | elvish = ethela onino | goblin = xodu ngorûg | human = rismal abo}}
[[File:BlizzardMan.jpg|thumb|300px|center|A blizzard man, drawn in crayon by [[Main:Bay 12 Games|Bay 12 Games]].]]

{{D for Dwarf}}

It has been posited that the best way to keep blizzard men out of the fortress is with an exceptionally large [[wall]].


Blizzard men are often though to roll into spheres to attack, though this behavior has never been seen before. It is unknown how this idea came to be.
==Trivia==
*[[File:blizzard_men_sprites.png|right]]Initially, the premium version had a graphic for a child blizzard man sprite. It was later removed from the game, because blizzard men are adults at birth.
{{gamedata}}
{{Creatures}}
{{Category|Humanoids}}

Trading

2026-07-23T20:54:37Z

Quietust: /* Miscellaneous trading advice */ clarify bug

{{Quality|Exceptional}}
{{av}}
{{buggy}}
[[File:trading_icon_preview.png|right]]'''Trading''' in ''Dwarf Fortress'' allows your dwarves to trade with other friendly [[civilization]]s. They can barter their excess goods for items they need, possibly even items they can't otherwise acquire for themselves. Trade can make up for the lack of [[Industry|industries]] you neglected or don't find interesting, provide resources that aren't available where your dwarves settled, replace key tools you lost or accidentally destroyed, and allow you more freedom in selecting starting gear and skills at [[embark]]. Trading generally begins in the first [[Calendar|autumn]] after establishing your fortress, with the arrival of the [[dwarf|dwarven]] [[caravan]] from your home [[civilization]].

'''Trader''' is the generic term used at your [[trade depot]] to refer to your fortress representative (usually your [[broker]], although it can be anyone else in a pinch) when dealing with merchants in a visiting caravan. As a [[profession]], the term applies to visiting merchants and dwarves whose highest [[skill]] is [[Appraiser]].

To trade at all, you will need a [[trade depot]] and peaceful relations with at least one [[civilization]] that can reach your site. Appointing a citizen as a [[broker]] is not strictly necessary but is very helpful. Newly-founded fortresses begin the game at peace with their home civilization and will generally have at least that one trading partner each year, unless the parent civilization is [[Civilization#Dead and struggling civilizations|dead or dying]], or simply can't reach your site due to intervening mountains or open water. A [[civil war]] in your home civilization will also stop trade with them. Trading with your home civilization is quite important, as being visited by their caravans is part of attracting [[Immigration|immigrants]] after the first two waves. Trading can occur earlier than normal, as well as be strengthened between settlements, if the player sends a messenger to a settlement that is on peaceful terms with the player's fortress, and if that settlement is able to trade overall.

Graphically, merchants will always appear in white clothing.
==Trading flowchart ==
{{:Trading/Flowchart}}

{{Clear}}

== Trade depot ==

{{Dual image
|premium=File:DFwikiGraphicalTradeDepot.png
|classic=File:DFwikiASCIITradeDepot.png
|width=150px
|caption=A Trade Depot
}}

{{Main|Trade depot}}
Building a [[trade depot]] is a prerequisite for trade with caravans that arrive at your fortress. If traders can't access your trade depot when they show up, their caravans will simply bypass your fortress that year. While it may be convenient to build a depot outside at first, it is usually a good idea to move it inside, or secure it with [[wall]]s, [[bridge]]s and other fortifications, to protect incoming caravans and your goods from [[steals drink|thirsty animals]], [[thief|thieves]], and [[goblin]]s.

Everything that is on your map belongs to you, except:
* the items that are on merchants' animals and wagons
* the items that are in the trade depot and flagged for trading (they might belong to the caravan until they are moved out of it)
* items worn by creatures that are not [[citizen]]s of your fortress (initially forbidden, but can be claimed via unforbidding and dumping them)

== Trading ==
[[File:merchant_v50_preview.png|right]]
{{Dual image
|premium=File:DFwikiTradeScreen.png
|classic=File:DFwikiASCITradeScreen.png
|width=300px
|caption=Trading screen
}}

Before you can begin trading, you need to designate what goods to trade and have the fortress's representative trader located at the [[trade depot]]. Select the trade depot and then click either "Broker requested at depot" or "Anyone requested at depot" if you have no [[broker]] [[noble]] assigned. Be aware that without an assigned [[broker]], it's likely a random, probably unskilled dwarf will volunteer to conduct the trade. Next click "Move goods to/from depot" to be presented with a list of all items in your fortress that belong to you. Mark the goods you want to sell --insert clever advice--, and your dwarves will begin moving them to the depot. If you are unsure about which goods are in which containers, clicking the bin or barrel within the menu will show every item that is stored inside, along with its perceived value (using your broker's [[Appraisal]] skill). However, individual items cannot be marked if they are in a container. Note that during this step, we are just moving the goods physically to the trade depot, and that containers like [[barrels]] and [[bins]] must be moved with all of their contents (although for bins you will have an opportunity to specify which contained items you wish to trade).

Once the trade goods are moved to the depot and your trader has arrived, select the depot again and finally click the "Trade" button to enter the trade menu. In the trade menu, select the items to offer from the right and the desired items from the left. All caravans have a weight limit which cannot be exceeded (during trading, but it is possible to have a caravan exceed the weight limit after trading, ie. due to sold animal children growing up shortly afterwards), and the allowed additional weight is displayed in the lower left corner. If your trader has sufficient [[Appraisal]] skill, the value of all items will be displayed with reasonable accuracy. Once the proposal is ready, click the "Trade" button to propose the trade; merchants will not agree unless they make adequate profit. Clicking the "Offer as gift" button instead will make a gift of the selected items. Items from outside the embark area cannot be offered as gifts. The amount of acceptable profit is determined by the trader's [[Broker skills|skills]] and the merchant's mood, described below. Merchants may attempt to propose counteroffers if they do not accept the proposal, which can then be accepted, rejected, or further amended by the trader. A Trader Profit listed in red will always be rejected (if all items in the proposed trade are correctly appraised). If on the other hand the Trader Profit is listed in green rather than yellow or red the trade will always be accepted (unless unacceptable goods are offered in the trade). Take note that the latter is also true, if the goods traded are not properly appraised (ie. for some goods only an estimated value is given, expressed a tilde before the value), a profit shown in green will always be accepted. But if at least one item being selected (either for selling or buying) has either a preceding tilde or trailing question mark, then the displayed color of the trade will be the following:
a) the color will be displayed in red, if the calculated merchant profit is negative (either according to your traders value estimate or according to the "real" value, if the trader would have appraised all items precisely),
b) the color will be displayed in green, if the merchant would accept the trade and the color is not displayed in red (due to the calculated profit of your trader yielding a loss for the trader as the trader did not appraise all items in the trade precisely) and
c) the color will otherwise be displayed in yellow.
The above means that if any selected items in a trade is only given with an estimated value, then the merchant could possibly accept a proposed trade, allthough the profit is displayed in red, as the merchant will always accept a trade (assuming the proposed trade does not contain an unacceptable item) if the merchant profit is at least 50% (according to the "real" value).

With more experienced traders and pleased merchants, even marginally profitable trades can be successful, and counterproposals can be rejected safely, possibly offering the same trade again (but if the same trade is proposed again directly after refusing the counterproposal, then the chance of another counterproposal seems to be greatly increased). Note however that a low profit margin for the traders may not be desirable - it has been suggested that both export and profit numbers influence the size of next year's caravan and, in the case of the dwarven caravan, immigration numbers.{{Verify}} If a high-ranking and respected leader is at your fortress, merchants arriving to trade will bring better goods.

Note: Goods brought by caravans rarely have base quality higher than superior, and decorations on a good rarely exceed superior as well.

Note if you give or trade away an [[Artifact|artifact]], you will receive a special notification:
;[[File:Treasure_Gift.PNG|750px]]
;[[File:Treasure_Trade.PNG|750px]]

Note: If at the time of departure the caravan somehow ended up with a weight exceeding its capacity (ie. due to young animals being traded and some of them gaining weight before departure of the caravan), the caravan will still load everything belonging to them (and will leave nothing behind).

=== Items cue colors ===
{| class="wikitable"
! {{DFtext|Brown|6:0}}
| Items have been created or modified (e.g. [[Decoration|decorated]]) by your fortress. They can be traded away or offered as a "[[Trading#Offering_items|gift]]".
|-
! {{DFtext|Light gray|7:0}}
| Items were created by another source ''(e.g. items previously acquired from a previous trade, or enemy armor/weapons recovered after a siege)''. They can be traded, but ''not'' offered as a gift. If a group of items includes any such item, the entire selection cannot be gifted.
|-
! {{DFtext|Purple|5:0}}
| Items are under a no-export [[mandate]]. If they are traded away it will result in disciplinary action (see [[justice]]) against the dwarf that brought the item to the depot.
|-
! {{DFtext|Green|2:0}}
| Items have just been [[Trading#Offering_items|gifted]] to the caravan (and caravans will never trade such items back).
|-
! {{DFtext|Red|4:0}}
| Items have been [[Trading#Seizing_items|seized]] from another caravan and cannot be traded as is; you will need to [[Decoration|decorate]] them or turn them into other items ''(e.g. a log into a bed, or a barrel of meat into a meal, etc.)'' for them to become "valid" trading items.
|}

Note that containers (barrels, bins, etc.) will be displayed according to the origin of the ''container'', not the contents. So a foreign-sourced barrel holding locally-produced beer will display as foreign (light gray). Once you {{k|v}}iew the container, the locally-made contents are displayed as local (brown) - but it's awkward (read "impossible") to trade such contents without the container.

=== Seizing items ===

Clicking "Seize" from the trade menu will seize the selected items of the merchants. If you seize goods from a caravan, the merchant will respond "Take what you want. I can't stop you." and then leave immediately without the seized goods. Items cannot be seized from the dwarven caravan, and other races will not buy goods stolen from one of their caravans (then marked in red) unless they are tricked into asking for them via counteroffer, or the items are "laundered" by decoration or used to create other goods. Seizing goods will hurt diplomatic relations, but is not grounds for an automatic [[siege]].

Pressing the seize button while no goods are selected will result in the merchant interpreting your seizure as a joke. This apparently does nothing to benefit or hinder your trading.

As a side note, if you deconstruct your trade depot with a caravan in it, all the caravan's items will drop to the ground, to be readily hauled away by your dwarves. This does not mark the items as stolen, and the caravan will leave. However, ''next'' year's caravan is partly based on the profits from the previous year - so if you are relying on that race's caravans for needed items, you're hurting yourself in the long run.

Trying to interrogate a merchant can also cause a wagon to fall apart. Another way to steal without marking as stolen is to forbid the trade depot just before they leave, causing them to leave their goods at the depot.

If you're using the search plugin for [[Utility:DFHack|DFHack]] (e.g. from the [[Utility:Lazy Newb Pack|Lazy Newb Pack]]), be warned that {{K|s}} means "seize" and '''NOT''' "search", and there is '''no warning''' for it. Use {{K|q}} to search the merchant's goods and {{K|w}} to search yours.

Note that the civilization attached to a particular caravan will keep track of the value of items the caravan was carrying when they set out to trade, and they will compare this value with the value of items they return home with. Regardless of what method you use to confiscate items from a caravan, even if you came to possess the goods through no fault of your own (an [[ambush]] killed the traders and guards, for example) the parent civilization may decide that you stole from them and send a [[siege]] instead of a caravan the following year. It is prudent to take measures to protect caravans visiting your lands!

===Offering items===

You can also give away items, as gifts to the leaders of the [[civilization]] you are trading with. This presumably helps relations between yourself and the other faction, though there is not yet a clear correlation between the value of the offerings and the improvement to relations. The exact effects of offerings on trading are unknown but it is believed due to the offerings' net trade value being counted towards the merchants' profit, possibly with a modifier (possibly a multiplier of more than 1 as a bonus or less than 1 to compensate for the improved relations){{Verify}}, which in turn increases the quantity and variety of trade goods brought by next year's caravan. Also the [[Monarch]] requires offerings to be made before their arrival. You cannot offer items that were not made at your fortress; the merchants do not want your spare [[Goblinite]] clothes.

The value of an offering for the purpose of becoming the capital is adjusted by your current export agreement.

=== Trading with elves ===
Unless you are looking for extra [[fun]], '''''under no circumstances''''' should you offer or attempt to trade [[elves]] any items which involve [[wood]], dead [[animal]]s, or wood or animal products, or which used wood or animal parts at any step in their creation*, including [[decoration]]s. If you do not respect this cultural prohibition, the elves will immediately take offense, refuse that trade, end the entire trading session, and leave, possibly damaging relations enough to provoke a war between you and the elven civilization you traded with.

: (* e.g. This includes [[clear glass]] and [[crystal glass]] items, which require [[pearlash]] to produce, which in turn comes from [[potash]], which itself is produced by burning a log. Similarly, yarn and wool are unwelcome. Yes, they are ''that'' picky about it.)

However, they will accept live, caged animals, and their own "grown wood" items, products associated with milk, cheese and [[bees]], and some other exceptions without taking insult. [[Trading#Unacceptable items|See below]] and the [[elves]] article for more detailed information.

== Miscellaneous trading advice ==
* Thieves and thieving critters tend to follow caravans. Expect assaults and intruders.
* Create your trading depot inside your fort, preferably in the beginning. Place a 3-tile wide path (which must be free of obstructions such as stairways, traps, minecart tracks, and [[boulder]]s) to the entrance of the fort and position war-trained animals along it (chains do not block wagons); this will help to protect the traders and keep the depot close to your supplies.
* Avoid having multiple wagon paths to your depot. Caravan [[wagon]]s cannot move through each other, and if two wagons happen to meet at a fork they may become gridlocked against each other, resulting in the destruction of wagons and loss of trade opportunities.
* All caravans will bring extra food (meat and edible plants), wooden logs, and cloth/leather (for making clothes) if the supplies of your fortress are perceived to be low enough, independent of whether or not you requested them. This does not apply in the case that the weight limit is exceeded by (other) items you requested. The supply situation, as observed by traders, is based solely on the number of ''unforbidden'' items in your fortress, stockpiled or not; thus, it is possible to trick caravans into thinking your supplies are low by [[forbid]]ding all of your relevant stocks immediately prior to their arrival.
**In order to '''avoid''' this behavior, you should make sure that, for each dwarf in your fortress, you have the following ''unforbidden'' items:
*** 5 pieces of food (as indicated by the "Food" item in your [[Status]] bar); due to a bug, the values of the "Drink" and "Seeds" values count '''against''' this, even though they are no longer included in it {{bug|13530}}
*** 1 wood log
*** 5 pieces of ''[[wear|undamaged]]'' cloth, pieces of leather, or complete sets of [[wear|pristine]] clothing (shirt+pants+shoe)
**On top of this, caravans will also bring extra food (and not only meat and fish) for every ''carnivorous'' unit in your fortress, '''including pets''' (even though they currently don't need to eat), so immediately cooking all of your butchering yields may not be advised if you want a wide variety of trade goods.
* Caravans will only ever bring wooden logs if you explicitly request them via trade agreement or if the supplies of your fortress are low enough; otherwise, a caravan will never bring wooden logs.
* The very first caravan of every non-elven civilization will bring some cloth/leather. The following caravans of a civilization will only ever bring cloth/leather if either requested by a trade agreement (with that civilization) or if the supplies of cloth and leather (and finished untouched clothing) are low enough. Silk/Cloth threads are not covered by this, eg. caravans can bring threads even if they will not bring cloth/leather (as part of emergency supplies).
* Caravans will bring some food even if the fortress supplies for food are high enough. Having high food supplies only reduces the amount of food brought (not whether food is brought at all).
* Define your trade depot as a burrow. When traders arrive, you can add your broker or another dwarf, perhaps one you want to train in trading, to the burrow. They will head to the depot immediately, and stay there until you remove them from the burrow.
* Each trade you make (regardless of value) will increase your trader's skills by (about) 50, distributed among the subset of skills composed of Comedian, Judge of Intent, Negotiator, Persuader, Liar, Flatterer, and Intimdator, which can be learned by that dwarf (and depends on their personality values and personality facets). The skills Judge of Intent and Persuader (if learnable) will increase by the highest amount. The skill Negotiator will get 2/3 of the increase to Judge of Intent. And the other skills (Comedian, Flatterer, Intimidator and Liar) will get 1/3 of the amount given to the Judge of Intent skill. The sum will be at most 50, but might be slightly lower. This means a trader, who can learn Comedian and Intimidator, but cannot learn Liar, Flatterer or Persuader, will get 21 skill points in Judge of Intent, 14 skill points in Negotiator and 7 points (each) in Comedian and Intimidator, for a total of 49 skill points. A trader, who can learn Comedian, Intimdator and Persuader, but cannot learn the others, will get 15 points in Judge of Intent and Persuador, 10 points in Negotiator and 5 points in Comedian and Intimidator, for a total of 50 skill points. The skill gain occurs as soon as the "t" button is pressed - if the offer is rejected, the dwarf will still gain 50 points. If the same offer is subsequently accepted, no additional skill will be gained.
* Selecting "only broker may trade" ensures that you will start negotiations with a decently-skilled trader, but it may require a significant delay if your broker is far away (or is busy with other tasks). Selecting "anyone can trade" will ensure that you get the trading done quickly, but at the cost of all item trade values being extremely inaccurate. Once your fortress can produce enough goods to reliably buy out the whole caravan, waiting for your broker is less important; allowing your commoners to trade spreads out the trading skill gains and eliminates the micromanagement of trying to get your broker to the depot in a timely manner.
* *Any* civilization that's at peace with you and capable of trade will send caravans. Initially and by default it's one per race (three annually, including your own civilization) but you can increase that number by making peaceful contact with other civilizations in the world. Currently and strangely, the most surefire way is to send squads to human, elf and dwarven sites from civilizations with 'no contact' and make [[tribute]] demands. While arrogant this does not trigger an outright war even if it fails, and the site's parent civilization, simply by being aware of your existence, will automatically send caravans every year onwards. There is no apparent limit beyond the actual number of contactable friendly civilizations in the world so you can make your fort a very crowded trading hub indeed.
* The caravans weight limit solely depends on the amount of wagons (capacity 15000) and amount of pack animals (variable capacity) a caravan brings (allthough if an item pushed the current pack animal/wagon above its capacity the item will be still packed and the weight limit increased). Furthermore the amount of merchants - and with that the amount of wares (maximum 100 items per wagon and pack animal) - that a caravan tries to load (or bring) does depend on the status of your fortress and the overall trade sentiment (with "fantastic" being the highest trade sentiment). And the amount of merchants seems to no longer depend in any way on the amount of exports to the civilization. The "status" of your fortress mainly depends on whether your fortress has not yet a noble (eg. pre-barony) or is a barony, a county or a duchy or is the seat of the monarch (and has become a mountainhome). Ie. an elven caravan should bring seven merchants (and pack animals), if the trade sentiment is "fantastic" and the fortress is a barony.
* High profits for the merchants (if they do successfully leave the map with the trade goods) does increase trade sentiment and low profits (or even a net-loss for the caravan, ie. due to goods seizure or not all traded goods leaving the map with the merchants) do decrease the trade sentiment with that civilization. The relative profit in relation to the total initial value of goods (the caravan brought) does matter, but not the absolute profit. (It is not yet clear, whether only last years caravan's relative profit is taken into accout or the profits of a longer trade history).
* If your messengers have really high skill levels in negotiation and persuasion and another "haggle" skill (ie. Judge of Intent), then sending a messenger to the civilization once a year to improve trade (and ie. keep trade sentiments at "fantastic") might be better than giving a foreign caravan a huge profit (or even any profit at all). This option is not available for the caravan from your home civilization, still even the caravans from your home civilization are affected by trade sentiment, so you will either have to give the caravans from your home civilizations are profit or employ some other strategies (like requesting every second year only cheap items and giving them a very high profit, when they bring these items, and in the other years, when you have only requested high value items, giving them a minimum profit, while still buying about everything) to not let trade sentiments deteriorate.

== Types of Merchant Caravans==
By default, each friendly [[civilization]] (including your own) will send one merchant [[caravan]] per year. Each race always trades in a particular season: autumn for dwarves, spring for elves, and summer for humans. (No race trades in winter by default.) If you have friendly contact with multiple civilizations of the same race, you may even get multiple caravans in a single season. Each race brings different goods, and they sometimes have different trading preferences.

If your fortress was founded in spring, it is highly unlikely that you will receive an elven caravan that spring, and it is uncommon for a human caravan your first summer, so probably your first and only caravan your first year will be the dwarven one. Caravans will only show up if that race considers the fortress site accessible (as denoted on the embark screen) and "worth the effort" (as determined by the [[Entity token#PROGRESS_TRIGGER_POPULATION|[PROGRESS_TRIGGER_*]]] tokens in the entity definition), with the exception of dwarves, who always arrive unless they are [[extinct]].

=== Dwarven ===
{{quote|
: ''Greetings from the mountainhome. Your efforts are legend there. Let us trade!''
:: (Or, if your fort ''is'' the [[Fortress|mountainhome]]...)
: ''Greetings from the outer lands. Your efforts are legend there. Let us trade!}}

Typically, the first caravan you receive is the [[Dwarves|dwarven]] one from your home civilization, giving you at least 22 weeks to prepare (assuming you started mid-spring, the default). This does require that you are on the same continent as they are, and you are not isolated by mountains or bodies of water.

The dwarven caravan:
* arrives in [[Calendar|autumn]].
* carries metal bars, [[leather]], weapons and armor, food and booze, and more. Dwarves alone may bring [[steel]] and steel goods.
:* If the trading civilization does not have access to [[iron]], they can still bring steel (and steel goods) and [[pig iron]] bars, but will not bring iron products.
* usually carries a selection of books that your civilization has access to. This can include books written in previous forts of yours within the same civilization.
* is heavily guarded.

The dwarven caravan from your home civilization:
* sends a liaison who will speak with the [[Expedition leader]], [[Mayor]], [[Baron]], [[Count]], or [[Duke]] to negotiate an import-export agreement (unless the [[Monarch]] is present).
* influences the number of immigrants received (if the caravan leaves intact).
* will not cause sieges when repeatedly destroyed or lost.
* is usually the only caravan to arrive during a fortress' first year.
* always arrives, regardless of embark location, unless the dwarven civilization is [[extinct]].
* cannot have its goods seized from the trade menu.
* may not arrive if your civilization lacks any notable figures.
* cannot be offered goods if the monarch is present.

=== Elven ===
{{quote|Greetings. We are enchanted by your more ethical works. We've come to trade.}}
[[Image:Evil_elves.png|thumb|400px|A typical elven caravan.]]

Friendly [[elf|elven]] civilizations will each send a caravan sometime in [[Calendar|spring]], giving you about a full year before the first caravan arrives when starting at the default time.

The elven caravan:
* arrives in the [[Calendar|spring]].
* carries [[cloth]], [[rope]]s, various above-ground seeds, [[plant]]s and their byproducts, [[log]]s, [[wood]]en goods & [[weapon]]s, clothing and [[armor]], and may carry tame exotic [[creature]]s.
* does not use [[wagon]]s, only [[Creature#Domestic animals|pack animals]]
* is unguarded.
* will become angry and immediately leave if offered "unethical" wooden or animal products; see [[Trading#Unacceptable items|below]].

Elven caravans don't use wagons, instead bringing all of their goods on pack animals. This means that they don't need any special accommodation to get to the [[trade depot]]: any untrapped one-tile-wide path will suffice. However, this also means that elven caravans have a much lower weight limit, which means selling them heavy items like [[furniture]] or large [[stone]] goods can be problematic. Their caravans are also unguarded, and may need protection if your fortress is in a [[Surroundings|dangerous environment]] or [[Siege|under attack]].

Elves will only ever have goods made from above-ground plants, goods made from their special "grown" wood, or various exotic [[creature]]s or [[vermin]] in grown wooden [[cage]]s. The possibility of getting a breeding pair of [[giant tiger]]s is nice, although they might just bring something useless like [[raven]]s or [[Green tree frog|tree frog]]s instead. If you trade with elves for unusual [[plant]] [[crop]]s, you may be able to [[brew]] or [[Millstone|otherwise]] [[Farmer's workshop|process]] those plants for [[seed]]s you can later grow in your own [[Tile attributes|above-ground]] [[Farming|farm]]s, if you live in a compatible [[biome]]. Elves also wear and sell the same-sized [[clothing]] as dwarves, if you haven't gotten your [[textile industry]] going yet. Otherwise, food, logs, cloth, or miscellaneous wooden goods like [[cage]]s, [[barrel]]s, and [[bucket]]s can be useful.

Elves don't forge [[metal]]. All of their [[weapon]]s and [[armor]] are made from [[wood]], including item types that dwarves can't normally make from wood, like [[spear]]s or different [[sword]] varieties. These are even less useful than most arms and armor sold by caravans, as wooden weapons and armor are [[Material science#Material and item properties|basically useless in combat]]. Even metal-poor dwarves can cheaply make superior arms and armor from bone or leather. It's probably for the best that elves are so poorly armed, because offending them and damaging your [[Diplomacy|diplomatic relationship]] with their civilization is very easy.

Be also aware that the elves also value decorations differently than dwarves. Ie. they will essentially offer nothing for spike decorations (except the flat value increase due to high quality spike decoration), but offer more for image decorations which depict nature (oddly enough images of historic events depicting one of your dwarves are also valued slightly higher by elves and would also value image decorations depicting the historical event of a unicorn visiting a butcher's shop much higher than dwarves).

==== Unacceptable items ====
Elves [[Elf#Ethics|view]] living trees as sacred and dislike the killing of non-hostile animals; they're the only [[Ethic#Ethics of vanilla civilizations|unmodded civilization]] to do so. Offering them wood or animal-derived products, either as part of a trade or as a gift, will offend the merchant. The merchant will rebuke your broker and leave immediately. This offense reduces your [[civilization]]'s [[Diplomacy|diplomatic relationship]] with the elves' civilization, possibly leading to [[war]] after multiple infractions.

Examine your items carefully! Elf traders will reject [[Storage|container]]s holding a prohibited item, otherwise-acceptable items stored in a prohibited container, and all items «[[decoration|decorated]]» with a prohibited [[material]]. If you want to sell food or liquid to elves, it's best to use a [[large pot]] or one of their own grown wood barrels.

Note that elves only care about the items they are actually offered. It's perfectly allowable to use wooden [[bin]]s to haul items to the [[trade depot]], as long as you only offer the elves acceptable items from the bin and not the bins themselves.

Note: If you accidently did offer an unacceptable item as a trade, even if the elven trader does not outright refuse any further trades (and the offer only reduces the merchant's mood), one effect is, that the time the caravan would stay gets shortened, ie. you might get an announcement shortly after leaving the trade interface (and after unpausing the game), that the caravan will be leaving soon.

===== Items made from wood =====
{{quote|Once a beautiful tree, and now? It is a rude bauble, fit only for your kind.}}
Elves do not want to be offered items you made from wood, nor do they want most items that require wood as part of their creation process.
* All items made of or decorated with [[wood]]. This includes wood from [[Tree#Underground trees|tree-like subterranean fungus]], such as [[tower-cap]]s. Elves make an exception for the "grown" wood items they make themselves, but items made by other races using "grown" wooden logs are still not acceptable.
* All items made of or decorated with wood derivatives. This includes [[ash]], [[potash]], [[pearlash]], [[charcoal]], [[lye]], and tallow [[soap]]. Note the exceptions for plant-based soap and ash-[[glaze]]d [[earthenware]] below, however.
* Items made from or decorated with clear or crystal [[glass]], as these items require [[pearlash]] in their creation. Again, note the exception for raw or cut glass [[gem]]s below.
* [[Obsidian]] [[short sword]]s. These require wood in their production, for the handle.

===== Animal products =====
{{quote|I see your low race still revels in death. That poor, gentle creature...}}
Elves also reject the majority of animal products. (This taboo extends to items made from intelligent creatures, despite the fact that you may see elven [[historical figure]]s hypocritically wearing items made from the hair or bones of their enemies.)
* Items and decorations made from [[body parts]], such as [[hair]], [[bone]]/[[skull]], [[shell]], [[horn]]/hoof/antler, and [[ivory]]/[[tooth]]. It also includes items dwarves can't normally use for crafting, such as [[nail]]s, [[chitin]], and [[scale]]s.
* [[Leather]] or [[parchment]]/vellum, and all items made from them. These are made from [[skin]]s.
* [[Wool]] [[yarn]] and [[cloth]], as well as all items made from them. Elves have never heard of [[shearing]], so it doesn't matter how well you treat your [[sheep]]; they still associate animal products with death.
* [[Meat]] (including [[prepared organs]]), [[fish]] (both raw and prepared), [[fat]], and [[tallow]]
* [[Egg]]s. Elves aren't keen on keeping chickens, either.
* [[Prepared meals]] made using any of the above products.
* Tallow [[soap]]
* [[Corpse]]s and [[body parts]] themselves, although these are usually worthless anyway.
* [[Blood]], even if you somehow manage to get it into an elf-friendly container.

A distinct retort awaits dwarves who are so tactless as to offer goods made from both wood '''and''' animal products at the same time (such as tallow soap, or an item decorated with both wood and bone):
{{quote|You truly despise life, don't you? I am beside myself with grief. Perhaps we will show you how they suffered.}}

===== Acceptable items =====
Any item that isn't specifically prohibited above is acceptable to elves. A non-exhaustive list of items they accept:

* The "Feather Tree Egg Yolk" that the elves litter your trade depot with, can be traded back to them. Useful free trade items if you're looking to level another broker.
* Items made from or decorated with [[stone]], as well as raw [[clay]] or raw [[sand]]. This includes items made from [[petrified wood]], [[lignite]], or [[bituminous coal]]; elves aren't concerned with items that were plants or animals in a different geological age.
** [[Gizzard stone]]s are acceptable. Elves can't tell them from any other object made of stone.
* Items made from or decorated with [[metal]] (including [[steel]]), green [[glass]], or [[ceramic]]. Elves are content to assume your dwarves fuel their craft with [[coke]] and [[magma]] rather than [[charcoal]].
* All rough gems and cut gems, as well as items and decorations made from [[gem]] materials. Note that clear glass and crystal glass are not gem materials and are generally not acceptable, even though they can be used for [[Gem setting|gem decoration]]s and gem [[craft]]s.
** Due to a long-standing bug{{bug|919}}, elves do not examine the material rough gems or cut gems are made of. You can safely sell them raw clear or crystal glass, or cut gems made from clear or crystal glass, as long as you haven't used those gems for decorations. Be careful, because clear or crystal glass [[craft]]s from the "cut gems" job, including "large" gems, are still unacceptable.
* [[Block]]s made of any material, including wood or clear/crystal glass (due to the same bug as above).
* Bars of [[coke]] are acceptable, though it's unclear why you would ever want to trade them away.
* [[Plant]] and fungus products in general. Unless otherwise prohibited, all of these items are acceptable either as themselves or as the material for an item or decoration:
** Plant [[crop]]s, [[fruit]]/pods, [[seed]]s/nuts, and [[leaf|leaves]]/bulbs/flowers. Anything that can be grown on a [[farm plot]] or harvested with [[herbalism]] is one of these four. This includes non-wooden produce from trees.
** [[Plant fiber]] [[thread]] and [[cloth]], and all items made from them.
** Processed plant products. This includes (but isn't limited to) [[booze]], [[dye]], [[flour]], [[dwarven sugar]] and [[dwarven syrup]], [[oil]], [[press cake]], and [[paper]]. [[Papyrus]] sheets seem to be a notable exception.
* [[Silk]] [[thread]] and [[cloth]] and items made from them. Elves don't care if you're exploiting spiders.
* Products of the [[beekeeping industry]], including [[honey]], [[royal jelly]], [[mead]], [[wax]], and wax [[craft]]s.
* [[Cheese]] and [[milk]]
* [[Prepared meal]]s made entirely with allowed ingredients.
* "Grown" wood items. These can generally only be obtained from elves, and are made in keeping with elven ethics. Note that these items can still become unacceptable if they contain unacceptable items or are later decorated with unacceptable materials.
* Items made from [[Adamantine|certain]] [[Divine metal|spoiler]] [[Divine fabric|materials]], if you're willing to give these up.
* Live [[creature]]s or [[vermin]]. Since these can only be traded when in a [[cage]] or [[animal trap]], make sure the cage or trap is also made of acceptable materials.
* [[Soap]] made from [[oil]]. This may be a bug{{bug|8571}}, as even plant-based soap requires [[lye]], which is made from [[ash]].
* Otherwise-acceptable items are not disqualified by [[ash]] [[glaze]], which may be a bug{{bug|4652}}.

=== Human ===
{{quote|Greetings. The craftsdwarfship of the dwarves is unparalleled. Let's make a deal!}}

Assuming you do have friendly contact with [[human]]s, their first caravan will arrive sometime in summer, giving you well over a full year before they arrive.

The human caravan:
* arrives in [[Calendar|summer]]. (Usually your first caravan opportunity.)
* carries metal bars, sand, [[leather]], cloth, wood, food and booze, books, ropes, waterskins, quivers, backpacks, metal weapons and clothing and armor, cages and a few domestic animals.
* carries only large-sized clothing and armor, which is unusable by dwarves.
* is moderately guarded.
* sends a treasurer to negotiate import/export agreements (but only if the human civilization has the CUSTOM_OFFICIAL_3 position).

==== Good Humor ====
Choosing to seize goods from a human caravan without marking anything to be taken is treated as a joke, but this essentially does nothing (ie. the merchant mood is not raised).

=== Goblins and Kobolds ===
{{mod}}
{{main|modding#trade}}

A [[goblin]] caravan will only arrive if you mod the game, primarily because their entity lacks the [[entity token]]s needed to make use of pack animals and wagons - that, and that the token {{token|BABYSNATCHER|e}} makes them hostile to all non-goblin civilizations. The same caveats apply to [[kobold]]s (whose {{token|UTTERANCES|c}} and {{token|ITEM_THIEF|e}} tags, similarly, make them hostile to every civilization).

The goblin caravan:
*will arrive every season, four times per year
*is unguarded
*brings mostly food and cloth
*does not send a liaison or a guild representative
*does not make import/export agreements

== Merchant mood ==
If your trader has Novice or better [[Judge of intent]] skill, there will be a line added below the merchant's dialogue describing the caravan's attitude. Their attitude rises with successful trades (especially if they get lots of profit) and falls when you propose deals they don't like. You can never make a deal that's at a loss for the merchant, even if they are at the highest possible mood, but deals with exactly zero profit are possible.

The possible merchant displayed merchant moods are the following:

* {{DFtext|(trader) seems ecstatic with the trading.|2:1}}
* {{DFtext|(trader) seems very happy about the trading.|3:1}}
* {{DFtext|(trader) seems pleased with the trading.|1:1}}
* {{DFtext|(trader) seems willing to trade.|7:1}}
* {{DFtext|(trader) seems to be rapidly losing patience.|6:1}}
* {{DFtext|(trader) is not going to take much more of this.|4:1}}
* {{DFtext|(trader) is unwilling to trade.|5:1}}

Internally the merchant's mood is a variable with range 0-100. The merchant's mood always starts at 50. Only a merchant with mood 100 is ecstatic, between 80 and 99 very happy, between 60 and 79 happy, between 40 and 59 willing to trade, between 20 and 39 rapidly loosing patience, between 1 and 19 not going to take much more of this and with 0 unwilling to trade.

Proposed deals with a loss for a merchant are outright declined and do not affect a merchant's mood. If the merchant's profit is at least 0 then a proposed deal, if not accepted, will always be meet with a counter-offer. If the last deal was successful (and with that the current haggle fail count 0), such a counter-offer does not affect the merchant's mood (but internally a haggle fail count is incremented by 1). But if the haggle fail count is non-zero, then the merchant's mood will decrease by 10 (if haggle fail count is 1), by 20 if the haggle fail count is 2 and presumeably haggle fail count times 10 for even higher haggle fail count values. If a deal is accepted (either because the counter-offer was accepted or the proposed deal was outright accepted), then the merchant's mood is raised by at least 1, if the profit is at least 1 and also at least 1% - deals with zero profit or with less than 1% profit for the merchant do not raise the merchant's mood (but if accepted without counter-offer they also do not decrease the merchant's mood). A successful deal (including accepted counter-offers) also sets the haggle fail count back to 0 (if it was higher), even if the profit is 0. If a merchant's mood reaches the lowest level, no further trades will be possible (and the merchants will start to pack their things and leave).

The merchant's mood, along with your brokers "haggle" skills in comparison with the merchant's "haggle" skills (both weighted by the importance of the haggle skill), affect the likelyhood that a counter offer is made (and the deal is not outright accepted), when the profit margin is below 50% and also affects - in case of a counter-offer - how much the merchant might demand then (allthough there is randomness involved, ie. even with very high haggle skills of the broker compared to the merchant, it is possible that accepting a counter-offer of an ecastatic merchant would result in more than 50% profit for the merchant, allthough such occurances are unlikely).

An easy way to capitalize on the mood system is by first making cheap deals with at least 50% profit for the merchant (until the mood is high) and then being more aggressive with the trading. Allthough an even more effective way to capitalize on the mood system by proposing deals with minimum profit as long as the haggle fail count is 0 and if a counter-proposal is made, declining the deal and buying the cheapest item the merchant has for 50% profit (for the merchant).

But then, unless you want to send a messenger to increase the trade relations, low profits for the merchants might not be wanted, as of v53.13 the profit do affect the amount of goods brought in the next year.

== Trade Agreements and Liaisons ==
[[Outpost liaison]]s (from your own civilization) and foreign Merchant Nobles (if added with the [[Position token#TRADE|TRADE responsibility]]) will arrive with the caravan to speak to your [[noble]] dwarves (and they ''will'' speak to those dwarves, even if they have to wait at their bedside in the hospital for months after the caravan has left), appearing on the map edge at the same time as the caravan (though in a different location). Meeting with them allows you to request specific items for the next caravan to bring (at a premium price) or take requests for production for the next caravan (for which the merchants will pay a premium).

Current [[Trade agreement|trade agreements]] can be viewed through the Civilization menu ({{k|c}}). These trade agreements are cleared when a liaison of the corresponding civilization enters the screen, so they are generally not accessible after the caravan has arrived.

In the event that your leader is replaced, killed, or taken by a [[strange mood]], the liaison may decide to leave your fortress [[stymied|"unhappy"]].{{bug|576}} Curiously, this will '''not''' occur if your leader is otherwise unable to perform the "conduct meeting" task. You can currently lock a liaison in a room and they will wait years to attend the meeting your noble is constantly conducting (and all subsequent diplomats appear to wait in line for the first to finish); this behavior is presumably a bug.{{bug|8947}}

Whether having successfully met with your leader or given up, a liaison who has decided to leave but is prevented from reaching the map edge will eventually go [[insane]].

== Bugs ==

* Merchants who are attacked by enemies or even wild animals will sometimes become disconnected from the trade depot and refuse to pack of their things to leave the map, and these items will remain 'stuck' in the depot. Deconstructing the trade depot usually forces them to leave, presumably with the downside of causing those goods to be considered seized by the player.
* Aggressive, untrainable creatures (captured goblins, for example) cannot be traded; when a dwarf attempts to move the caged animal to the Depot, the creature is set free.
* When merchants leave with an animal, the merchants seem to be dragging their beast of burden instead of leading it. If the animal is incapacitated but not dead, the merchant will continue to walk at the same speed, dragging the unconscious beast.
* If a merchant's chosen map edge exit is guarded by a hostile creature (including those on a [[restraint]]), the merchant will wander back and forth repeatedly and eventually go insane rather than path to an alternate exit.
* Animals bought from merchants don't always become available for use.{{bug|10162}}

== Loyalty cascade ==
{{main|Faction#Loyalty cascade|l1=Faction}}
If you order your military to kill merchants from your own civilization, a bizarre result of the way loyalty is handled makes the members of your military who attacked the traders become enemies of your civilization, but remain members of your fort's government (dwarves of this [[faction]] are referred to as ''separatists''). As enemies, they attack your other dwarves (''citizens''), but as members of the fort, they still follow orders. Allowing citizen militia dwarves to attack the separatists will give them opposite loyalties of the separatists, (i.e. loyal to civ, not to fort), or ''loyalists'', who do '''not''' follow orders. And then, if a separatist or loyalist kill a citizen, they become enemies of the civ '''and''' fort, making them ''Renegades'', who are essentially complete enemies of the citizens.

To prevent the cascade from spreading, order the original separatists away from the fortress and let them fight amongst themselves. If the results are renegades, it is okay to allow other dwarves to kill them (by stationing them nearby). If the results are separatists/loyalists, then you will need to separate them, somehow.

== Exploits ==
*Deconstructing the depot will cause merchants to leave your fortress and abandon any goods in the Depot, though any animals they had caged will still belong to the merchants and only become Friendly (i.e. you won't actually own them). However, the merchant visit will be reported in history as having experienced "irregularities with their goods", harming trade relations exactly the same as if you had Seized them directly (though without the items themselves being marked as Stolen).
*If you wait until the merchants leave the map, you can "claim" caged animals by linking a lever to the cage and opening it, the animals will be released in a tamed state. Check the {{k|u}}nit screen before releasing them; if the creatures still show as Merchant creatures, they will wander off the map when released; if they show as Tame creatures, they will stay once released.
*If you lock them in your fortress for a minute or two (real time), the merchants '''may''' drop items and leave behind pack animals (both of which are yours for the taking!) Note: Results are not consistent.
* If [[Caravan#Destruction|spooked or attacked]] the merchants' caravan could leave their stuff behind as they attempt to flee the map, leaving the items free for the taking.

[[File:Bullock_Team_Wool_Wagon.jpg|thumb|400px|center|An old trading wagon from the 1880's.]]

== World level trade ==
During world generation, trade is established between sites. This probably determines growth.

{{Translation| dwarven = nish | elvish = lathì | goblin = otsmor | human = batow}}

{{Category|Trade| }}
[[ru:Trading]][[zh:Trading]]

Trading

2026-07-23T20:53:22Z

Quietust: /* Miscellaneous trading advice */

{{Quality|Exceptional}}
{{av}}
{{buggy}}
[[File:trading_icon_preview.png|right]]'''Trading''' in ''Dwarf Fortress'' allows your dwarves to trade with other friendly [[civilization]]s. They can barter their excess goods for items they need, possibly even items they can't otherwise acquire for themselves. Trade can make up for the lack of [[Industry|industries]] you neglected or don't find interesting, provide resources that aren't available where your dwarves settled, replace key tools you lost or accidentally destroyed, and allow you more freedom in selecting starting gear and skills at [[embark]]. Trading generally begins in the first [[Calendar|autumn]] after establishing your fortress, with the arrival of the [[dwarf|dwarven]] [[caravan]] from your home [[civilization]].

'''Trader''' is the generic term used at your [[trade depot]] to refer to your fortress representative (usually your [[broker]], although it can be anyone else in a pinch) when dealing with merchants in a visiting caravan. As a [[profession]], the term applies to visiting merchants and dwarves whose highest [[skill]] is [[Appraiser]].

To trade at all, you will need a [[trade depot]] and peaceful relations with at least one [[civilization]] that can reach your site. Appointing a citizen as a [[broker]] is not strictly necessary but is very helpful. Newly-founded fortresses begin the game at peace with their home civilization and will generally have at least that one trading partner each year, unless the parent civilization is [[Civilization#Dead and struggling civilizations|dead or dying]], or simply can't reach your site due to intervening mountains or open water. A [[civil war]] in your home civilization will also stop trade with them. Trading with your home civilization is quite important, as being visited by their caravans is part of attracting [[Immigration|immigrants]] after the first two waves. Trading can occur earlier than normal, as well as be strengthened between settlements, if the player sends a messenger to a settlement that is on peaceful terms with the player's fortress, and if that settlement is able to trade overall.

Graphically, merchants will always appear in white clothing.
==Trading flowchart ==
{{:Trading/Flowchart}}

{{Clear}}

== Trade depot ==

{{Dual image
|premium=File:DFwikiGraphicalTradeDepot.png
|classic=File:DFwikiASCIITradeDepot.png
|width=150px
|caption=A Trade Depot
}}

{{Main|Trade depot}}
Building a [[trade depot]] is a prerequisite for trade with caravans that arrive at your fortress. If traders can't access your trade depot when they show up, their caravans will simply bypass your fortress that year. While it may be convenient to build a depot outside at first, it is usually a good idea to move it inside, or secure it with [[wall]]s, [[bridge]]s and other fortifications, to protect incoming caravans and your goods from [[steals drink|thirsty animals]], [[thief|thieves]], and [[goblin]]s.

Everything that is on your map belongs to you, except:
* the items that are on merchants' animals and wagons
* the items that are in the trade depot and flagged for trading (they might belong to the caravan until they are moved out of it)
* items worn by creatures that are not [[citizen]]s of your fortress (initially forbidden, but can be claimed via unforbidding and dumping them)

== Trading ==
[[File:merchant_v50_preview.png|right]]
{{Dual image
|premium=File:DFwikiTradeScreen.png
|classic=File:DFwikiASCITradeScreen.png
|width=300px
|caption=Trading screen
}}

Before you can begin trading, you need to designate what goods to trade and have the fortress's representative trader located at the [[trade depot]]. Select the trade depot and then click either "Broker requested at depot" or "Anyone requested at depot" if you have no [[broker]] [[noble]] assigned. Be aware that without an assigned [[broker]], it's likely a random, probably unskilled dwarf will volunteer to conduct the trade. Next click "Move goods to/from depot" to be presented with a list of all items in your fortress that belong to you. Mark the goods you want to sell --insert clever advice--, and your dwarves will begin moving them to the depot. If you are unsure about which goods are in which containers, clicking the bin or barrel within the menu will show every item that is stored inside, along with its perceived value (using your broker's [[Appraisal]] skill). However, individual items cannot be marked if they are in a container. Note that during this step, we are just moving the goods physically to the trade depot, and that containers like [[barrels]] and [[bins]] must be moved with all of their contents (although for bins you will have an opportunity to specify which contained items you wish to trade).

Once the trade goods are moved to the depot and your trader has arrived, select the depot again and finally click the "Trade" button to enter the trade menu. In the trade menu, select the items to offer from the right and the desired items from the left. All caravans have a weight limit which cannot be exceeded (during trading, but it is possible to have a caravan exceed the weight limit after trading, ie. due to sold animal children growing up shortly afterwards), and the allowed additional weight is displayed in the lower left corner. If your trader has sufficient [[Appraisal]] skill, the value of all items will be displayed with reasonable accuracy. Once the proposal is ready, click the "Trade" button to propose the trade; merchants will not agree unless they make adequate profit. Clicking the "Offer as gift" button instead will make a gift of the selected items. Items from outside the embark area cannot be offered as gifts. The amount of acceptable profit is determined by the trader's [[Broker skills|skills]] and the merchant's mood, described below. Merchants may attempt to propose counteroffers if they do not accept the proposal, which can then be accepted, rejected, or further amended by the trader. A Trader Profit listed in red will always be rejected (if all items in the proposed trade are correctly appraised). If on the other hand the Trader Profit is listed in green rather than yellow or red the trade will always be accepted (unless unacceptable goods are offered in the trade). Take note that the latter is also true, if the goods traded are not properly appraised (ie. for some goods only an estimated value is given, expressed a tilde before the value), a profit shown in green will always be accepted. But if at least one item being selected (either for selling or buying) has either a preceding tilde or trailing question mark, then the displayed color of the trade will be the following:
a) the color will be displayed in red, if the calculated merchant profit is negative (either according to your traders value estimate or according to the "real" value, if the trader would have appraised all items precisely),
b) the color will be displayed in green, if the merchant would accept the trade and the color is not displayed in red (due to the calculated profit of your trader yielding a loss for the trader as the trader did not appraise all items in the trade precisely) and
c) the color will otherwise be displayed in yellow.
The above means that if any selected items in a trade is only given with an estimated value, then the merchant could possibly accept a proposed trade, allthough the profit is displayed in red, as the merchant will always accept a trade (assuming the proposed trade does not contain an unacceptable item) if the merchant profit is at least 50% (according to the "real" value).

With more experienced traders and pleased merchants, even marginally profitable trades can be successful, and counterproposals can be rejected safely, possibly offering the same trade again (but if the same trade is proposed again directly after refusing the counterproposal, then the chance of another counterproposal seems to be greatly increased). Note however that a low profit margin for the traders may not be desirable - it has been suggested that both export and profit numbers influence the size of next year's caravan and, in the case of the dwarven caravan, immigration numbers.{{Verify}} If a high-ranking and respected leader is at your fortress, merchants arriving to trade will bring better goods.

Note: Goods brought by caravans rarely have base quality higher than superior, and decorations on a good rarely exceed superior as well.

Note if you give or trade away an [[Artifact|artifact]], you will receive a special notification:
;[[File:Treasure_Gift.PNG|750px]]
;[[File:Treasure_Trade.PNG|750px]]

Note: If at the time of departure the caravan somehow ended up with a weight exceeding its capacity (ie. due to young animals being traded and some of them gaining weight before departure of the caravan), the caravan will still load everything belonging to them (and will leave nothing behind).

=== Items cue colors ===
{| class="wikitable"
! {{DFtext|Brown|6:0}}
| Items have been created or modified (e.g. [[Decoration|decorated]]) by your fortress. They can be traded away or offered as a "[[Trading#Offering_items|gift]]".
|-
! {{DFtext|Light gray|7:0}}
| Items were created by another source ''(e.g. items previously acquired from a previous trade, or enemy armor/weapons recovered after a siege)''. They can be traded, but ''not'' offered as a gift. If a group of items includes any such item, the entire selection cannot be gifted.
|-
! {{DFtext|Purple|5:0}}
| Items are under a no-export [[mandate]]. If they are traded away it will result in disciplinary action (see [[justice]]) against the dwarf that brought the item to the depot.
|-
! {{DFtext|Green|2:0}}
| Items have just been [[Trading#Offering_items|gifted]] to the caravan (and caravans will never trade such items back).
|-
! {{DFtext|Red|4:0}}
| Items have been [[Trading#Seizing_items|seized]] from another caravan and cannot be traded as is; you will need to [[Decoration|decorate]] them or turn them into other items ''(e.g. a log into a bed, or a barrel of meat into a meal, etc.)'' for them to become "valid" trading items.
|}

Note that containers (barrels, bins, etc.) will be displayed according to the origin of the ''container'', not the contents. So a foreign-sourced barrel holding locally-produced beer will display as foreign (light gray). Once you {{k|v}}iew the container, the locally-made contents are displayed as local (brown) - but it's awkward (read "impossible") to trade such contents without the container.

=== Seizing items ===

Clicking "Seize" from the trade menu will seize the selected items of the merchants. If you seize goods from a caravan, the merchant will respond "Take what you want. I can't stop you." and then leave immediately without the seized goods. Items cannot be seized from the dwarven caravan, and other races will not buy goods stolen from one of their caravans (then marked in red) unless they are tricked into asking for them via counteroffer, or the items are "laundered" by decoration or used to create other goods. Seizing goods will hurt diplomatic relations, but is not grounds for an automatic [[siege]].

Pressing the seize button while no goods are selected will result in the merchant interpreting your seizure as a joke. This apparently does nothing to benefit or hinder your trading.

As a side note, if you deconstruct your trade depot with a caravan in it, all the caravan's items will drop to the ground, to be readily hauled away by your dwarves. This does not mark the items as stolen, and the caravan will leave. However, ''next'' year's caravan is partly based on the profits from the previous year - so if you are relying on that race's caravans for needed items, you're hurting yourself in the long run.

Trying to interrogate a merchant can also cause a wagon to fall apart. Another way to steal without marking as stolen is to forbid the trade depot just before they leave, causing them to leave their goods at the depot.

If you're using the search plugin for [[Utility:DFHack|DFHack]] (e.g. from the [[Utility:Lazy Newb Pack|Lazy Newb Pack]]), be warned that {{K|s}} means "seize" and '''NOT''' "search", and there is '''no warning''' for it. Use {{K|q}} to search the merchant's goods and {{K|w}} to search yours.

Note that the civilization attached to a particular caravan will keep track of the value of items the caravan was carrying when they set out to trade, and they will compare this value with the value of items they return home with. Regardless of what method you use to confiscate items from a caravan, even if you came to possess the goods through no fault of your own (an [[ambush]] killed the traders and guards, for example) the parent civilization may decide that you stole from them and send a [[siege]] instead of a caravan the following year. It is prudent to take measures to protect caravans visiting your lands!

===Offering items===

You can also give away items, as gifts to the leaders of the [[civilization]] you are trading with. This presumably helps relations between yourself and the other faction, though there is not yet a clear correlation between the value of the offerings and the improvement to relations. The exact effects of offerings on trading are unknown but it is believed due to the offerings' net trade value being counted towards the merchants' profit, possibly with a modifier (possibly a multiplier of more than 1 as a bonus or less than 1 to compensate for the improved relations){{Verify}}, which in turn increases the quantity and variety of trade goods brought by next year's caravan. Also the [[Monarch]] requires offerings to be made before their arrival. You cannot offer items that were not made at your fortress; the merchants do not want your spare [[Goblinite]] clothes.

The value of an offering for the purpose of becoming the capital is adjusted by your current export agreement.

=== Trading with elves ===
Unless you are looking for extra [[fun]], '''''under no circumstances''''' should you offer or attempt to trade [[elves]] any items which involve [[wood]], dead [[animal]]s, or wood or animal products, or which used wood or animal parts at any step in their creation*, including [[decoration]]s. If you do not respect this cultural prohibition, the elves will immediately take offense, refuse that trade, end the entire trading session, and leave, possibly damaging relations enough to provoke a war between you and the elven civilization you traded with.

: (* e.g. This includes [[clear glass]] and [[crystal glass]] items, which require [[pearlash]] to produce, which in turn comes from [[potash]], which itself is produced by burning a log. Similarly, yarn and wool are unwelcome. Yes, they are ''that'' picky about it.)

However, they will accept live, caged animals, and their own "grown wood" items, products associated with milk, cheese and [[bees]], and some other exceptions without taking insult. [[Trading#Unacceptable items|See below]] and the [[elves]] article for more detailed information.

== Miscellaneous trading advice ==
* Thieves and thieving critters tend to follow caravans. Expect assaults and intruders.
* Create your trading depot inside your fort, preferably in the beginning. Place a 3-tile wide path (which must be free of obstructions such as stairways, traps, minecart tracks, and [[boulder]]s) to the entrance of the fort and position war-trained animals along it (chains do not block wagons); this will help to protect the traders and keep the depot close to your supplies.
* Avoid having multiple wagon paths to your depot. Caravan [[wagon]]s cannot move through each other, and if two wagons happen to meet at a fork they may become gridlocked against each other, resulting in the destruction of wagons and loss of trade opportunities.
* All caravans will bring extra food (meat and edible plants), wooden logs, and cloth/leather (for making clothes) if the supplies of your fortress are perceived to be low enough, independent of whether or not you requested them. This does not apply in the case that the weight limit is exceeded by (other) items you requested. The supply situation, as observed by traders, is based solely on the number of ''unforbidden'' items in your fortress, stockpiled or not; thus, it is possible to trick caravans into thinking your supplies are low by [[forbid]]ding all of your relevant stocks immediately prior to their arrival.
**In order to '''avoid''' this behavior, you should make sure that, for each dwarf in your fortress, you have the following ''unforbidden'' items:
*** 5 pieces of food (as indicated by the "Food" item in your [[Status]] bar); due to a bug, especially high "Drink" counts can cause this to malfunction {{bug|13530}}
*** 1 wood log
*** 5 pieces of ''[[wear|undamaged]]'' cloth, pieces of leather, or complete sets of [[wear|pristine]] clothing (shirt+pants+shoe)
**On top of this, caravans will also bring extra food (and not only meat and fish) for every ''carnivorous'' unit in your fortress, '''including pets''' (even though they currently don't need to eat), so immediately cooking all of your butchering yields may not be advised if you want a wide variety of trade goods.
* Caravans will only ever bring wooden logs if you explicitly request them via trade agreement or if the supplies of your fortress are low enough; otherwise, a caravan will never bring wooden logs.
* The very first caravan of every non-elven civilization will bring some cloth/leather. The following caravans of a civilization will only ever bring cloth/leather if either requested by a trade agreement (with that civilization) or if the supplies of cloth and leather (and finished untouched clothing) are low enough. Silk/Cloth threads are not covered by this, eg. caravans can bring threads even if they will not bring cloth/leather (as part of emergency supplies).
* Caravans will bring some food even if the fortress supplies for food are high enough. Having high food supplies only reduces the amount of food brought (not whether food is brought at all).
* Define your trade depot as a burrow. When traders arrive, you can add your broker or another dwarf, perhaps one you want to train in trading, to the burrow. They will head to the depot immediately, and stay there until you remove them from the burrow.
* Each trade you make (regardless of value) will increase your trader's skills by (about) 50, distributed among the subset of skills composed of Comedian, Judge of Intent, Negotiator, Persuader, Liar, Flatterer, and Intimdator, which can be learned by that dwarf (and depends on their personality values and personality facets). The skills Judge of Intent and Persuader (if learnable) will increase by the highest amount. The skill Negotiator will get 2/3 of the increase to Judge of Intent. And the other skills (Comedian, Flatterer, Intimidator and Liar) will get 1/3 of the amount given to the Judge of Intent skill. The sum will be at most 50, but might be slightly lower. This means a trader, who can learn Comedian and Intimidator, but cannot learn Liar, Flatterer or Persuader, will get 21 skill points in Judge of Intent, 14 skill points in Negotiator and 7 points (each) in Comedian and Intimidator, for a total of 49 skill points. A trader, who can learn Comedian, Intimdator and Persuader, but cannot learn the others, will get 15 points in Judge of Intent and Persuador, 10 points in Negotiator and 5 points in Comedian and Intimidator, for a total of 50 skill points. The skill gain occurs as soon as the "t" button is pressed - if the offer is rejected, the dwarf will still gain 50 points. If the same offer is subsequently accepted, no additional skill will be gained.
* Selecting "only broker may trade" ensures that you will start negotiations with a decently-skilled trader, but it may require a significant delay if your broker is far away (or is busy with other tasks). Selecting "anyone can trade" will ensure that you get the trading done quickly, but at the cost of all item trade values being extremely inaccurate. Once your fortress can produce enough goods to reliably buy out the whole caravan, waiting for your broker is less important; allowing your commoners to trade spreads out the trading skill gains and eliminates the micromanagement of trying to get your broker to the depot in a timely manner.
* *Any* civilization that's at peace with you and capable of trade will send caravans. Initially and by default it's one per race (three annually, including your own civilization) but you can increase that number by making peaceful contact with other civilizations in the world. Currently and strangely, the most surefire way is to send squads to human, elf and dwarven sites from civilizations with 'no contact' and make [[tribute]] demands. While arrogant this does not trigger an outright war even if it fails, and the site's parent civilization, simply by being aware of your existence, will automatically send caravans every year onwards. There is no apparent limit beyond the actual number of contactable friendly civilizations in the world so you can make your fort a very crowded trading hub indeed.
* The caravans weight limit solely depends on the amount of wagons (capacity 15000) and amount of pack animals (variable capacity) a caravan brings (allthough if an item pushed the current pack animal/wagon above its capacity the item will be still packed and the weight limit increased). Furthermore the amount of merchants - and with that the amount of wares (maximum 100 items per wagon and pack animal) - that a caravan tries to load (or bring) does depend on the status of your fortress and the overall trade sentiment (with "fantastic" being the highest trade sentiment). And the amount of merchants seems to no longer depend in any way on the amount of exports to the civilization. The "status" of your fortress mainly depends on whether your fortress has not yet a noble (eg. pre-barony) or is a barony, a county or a duchy or is the seat of the monarch (and has become a mountainhome). Ie. an elven caravan should bring seven merchants (and pack animals), if the trade sentiment is "fantastic" and the fortress is a barony.
* High profits for the merchants (if they do successfully leave the map with the trade goods) does increase trade sentiment and low profits (or even a net-loss for the caravan, ie. due to goods seizure or not all traded goods leaving the map with the merchants) do decrease the trade sentiment with that civilization. The relative profit in relation to the total initial value of goods (the caravan brought) does matter, but not the absolute profit. (It is not yet clear, whether only last years caravan's relative profit is taken into accout or the profits of a longer trade history).
* If your messengers have really high skill levels in negotiation and persuasion and another "haggle" skill (ie. Judge of Intent), then sending a messenger to the civilization once a year to improve trade (and ie. keep trade sentiments at "fantastic") might be better than giving a foreign caravan a huge profit (or even any profit at all). This option is not available for the caravan from your home civilization, still even the caravans from your home civilization are affected by trade sentiment, so you will either have to give the caravans from your home civilizations are profit or employ some other strategies (like requesting every second year only cheap items and giving them a very high profit, when they bring these items, and in the other years, when you have only requested high value items, giving them a minimum profit, while still buying about everything) to not let trade sentiments deteriorate.

== Types of Merchant Caravans==
By default, each friendly [[civilization]] (including your own) will send one merchant [[caravan]] per year. Each race always trades in a particular season: autumn for dwarves, spring for elves, and summer for humans. (No race trades in winter by default.) If you have friendly contact with multiple civilizations of the same race, you may even get multiple caravans in a single season. Each race brings different goods, and they sometimes have different trading preferences.

If your fortress was founded in spring, it is highly unlikely that you will receive an elven caravan that spring, and it is uncommon for a human caravan your first summer, so probably your first and only caravan your first year will be the dwarven one. Caravans will only show up if that race considers the fortress site accessible (as denoted on the embark screen) and "worth the effort" (as determined by the [[Entity token#PROGRESS_TRIGGER_POPULATION|[PROGRESS_TRIGGER_*]]] tokens in the entity definition), with the exception of dwarves, who always arrive unless they are [[extinct]].

=== Dwarven ===
{{quote|
: ''Greetings from the mountainhome. Your efforts are legend there. Let us trade!''
:: (Or, if your fort ''is'' the [[Fortress|mountainhome]]...)
: ''Greetings from the outer lands. Your efforts are legend there. Let us trade!}}

Typically, the first caravan you receive is the [[Dwarves|dwarven]] one from your home civilization, giving you at least 22 weeks to prepare (assuming you started mid-spring, the default). This does require that you are on the same continent as they are, and you are not isolated by mountains or bodies of water.

The dwarven caravan:
* arrives in [[Calendar|autumn]].
* carries metal bars, [[leather]], weapons and armor, food and booze, and more. Dwarves alone may bring [[steel]] and steel goods.
:* If the trading civilization does not have access to [[iron]], they can still bring steel (and steel goods) and [[pig iron]] bars, but will not bring iron products.
* usually carries a selection of books that your civilization has access to. This can include books written in previous forts of yours within the same civilization.
* is heavily guarded.

The dwarven caravan from your home civilization:
* sends a liaison who will speak with the [[Expedition leader]], [[Mayor]], [[Baron]], [[Count]], or [[Duke]] to negotiate an import-export agreement (unless the [[Monarch]] is present).
* influences the number of immigrants received (if the caravan leaves intact).
* will not cause sieges when repeatedly destroyed or lost.
* is usually the only caravan to arrive during a fortress' first year.
* always arrives, regardless of embark location, unless the dwarven civilization is [[extinct]].
* cannot have its goods seized from the trade menu.
* may not arrive if your civilization lacks any notable figures.
* cannot be offered goods if the monarch is present.

=== Elven ===
{{quote|Greetings. We are enchanted by your more ethical works. We've come to trade.}}
[[Image:Evil_elves.png|thumb|400px|A typical elven caravan.]]

Friendly [[elf|elven]] civilizations will each send a caravan sometime in [[Calendar|spring]], giving you about a full year before the first caravan arrives when starting at the default time.

The elven caravan:
* arrives in the [[Calendar|spring]].
* carries [[cloth]], [[rope]]s, various above-ground seeds, [[plant]]s and their byproducts, [[log]]s, [[wood]]en goods & [[weapon]]s, clothing and [[armor]], and may carry tame exotic [[creature]]s.
* does not use [[wagon]]s, only [[Creature#Domestic animals|pack animals]]
* is unguarded.
* will become angry and immediately leave if offered "unethical" wooden or animal products; see [[Trading#Unacceptable items|below]].

Elven caravans don't use wagons, instead bringing all of their goods on pack animals. This means that they don't need any special accommodation to get to the [[trade depot]]: any untrapped one-tile-wide path will suffice. However, this also means that elven caravans have a much lower weight limit, which means selling them heavy items like [[furniture]] or large [[stone]] goods can be problematic. Their caravans are also unguarded, and may need protection if your fortress is in a [[Surroundings|dangerous environment]] or [[Siege|under attack]].

Elves will only ever have goods made from above-ground plants, goods made from their special "grown" wood, or various exotic [[creature]]s or [[vermin]] in grown wooden [[cage]]s. The possibility of getting a breeding pair of [[giant tiger]]s is nice, although they might just bring something useless like [[raven]]s or [[Green tree frog|tree frog]]s instead. If you trade with elves for unusual [[plant]] [[crop]]s, you may be able to [[brew]] or [[Millstone|otherwise]] [[Farmer's workshop|process]] those plants for [[seed]]s you can later grow in your own [[Tile attributes|above-ground]] [[Farming|farm]]s, if you live in a compatible [[biome]]. Elves also wear and sell the same-sized [[clothing]] as dwarves, if you haven't gotten your [[textile industry]] going yet. Otherwise, food, logs, cloth, or miscellaneous wooden goods like [[cage]]s, [[barrel]]s, and [[bucket]]s can be useful.

Elves don't forge [[metal]]. All of their [[weapon]]s and [[armor]] are made from [[wood]], including item types that dwarves can't normally make from wood, like [[spear]]s or different [[sword]] varieties. These are even less useful than most arms and armor sold by caravans, as wooden weapons and armor are [[Material science#Material and item properties|basically useless in combat]]. Even metal-poor dwarves can cheaply make superior arms and armor from bone or leather. It's probably for the best that elves are so poorly armed, because offending them and damaging your [[Diplomacy|diplomatic relationship]] with their civilization is very easy.

Be also aware that the elves also value decorations differently than dwarves. Ie. they will essentially offer nothing for spike decorations (except the flat value increase due to high quality spike decoration), but offer more for image decorations which depict nature (oddly enough images of historic events depicting one of your dwarves are also valued slightly higher by elves and would also value image decorations depicting the historical event of a unicorn visiting a butcher's shop much higher than dwarves).

==== Unacceptable items ====
Elves [[Elf#Ethics|view]] living trees as sacred and dislike the killing of non-hostile animals; they're the only [[Ethic#Ethics of vanilla civilizations|unmodded civilization]] to do so. Offering them wood or animal-derived products, either as part of a trade or as a gift, will offend the merchant. The merchant will rebuke your broker and leave immediately. This offense reduces your [[civilization]]'s [[Diplomacy|diplomatic relationship]] with the elves' civilization, possibly leading to [[war]] after multiple infractions.

Examine your items carefully! Elf traders will reject [[Storage|container]]s holding a prohibited item, otherwise-acceptable items stored in a prohibited container, and all items «[[decoration|decorated]]» with a prohibited [[material]]. If you want to sell food or liquid to elves, it's best to use a [[large pot]] or one of their own grown wood barrels.

Note that elves only care about the items they are actually offered. It's perfectly allowable to use wooden [[bin]]s to haul items to the [[trade depot]], as long as you only offer the elves acceptable items from the bin and not the bins themselves.

Note: If you accidently did offer an unacceptable item as a trade, even if the elven trader does not outright refuse any further trades (and the offer only reduces the merchant's mood), one effect is, that the time the caravan would stay gets shortened, ie. you might get an announcement shortly after leaving the trade interface (and after unpausing the game), that the caravan will be leaving soon.

===== Items made from wood =====
{{quote|Once a beautiful tree, and now? It is a rude bauble, fit only for your kind.}}
Elves do not want to be offered items you made from wood, nor do they want most items that require wood as part of their creation process.
* All items made of or decorated with [[wood]]. This includes wood from [[Tree#Underground trees|tree-like subterranean fungus]], such as [[tower-cap]]s. Elves make an exception for the "grown" wood items they make themselves, but items made by other races using "grown" wooden logs are still not acceptable.
* All items made of or decorated with wood derivatives. This includes [[ash]], [[potash]], [[pearlash]], [[charcoal]], [[lye]], and tallow [[soap]]. Note the exceptions for plant-based soap and ash-[[glaze]]d [[earthenware]] below, however.
* Items made from or decorated with clear or crystal [[glass]], as these items require [[pearlash]] in their creation. Again, note the exception for raw or cut glass [[gem]]s below.
* [[Obsidian]] [[short sword]]s. These require wood in their production, for the handle.

===== Animal products =====
{{quote|I see your low race still revels in death. That poor, gentle creature...}}
Elves also reject the majority of animal products. (This taboo extends to items made from intelligent creatures, despite the fact that you may see elven [[historical figure]]s hypocritically wearing items made from the hair or bones of their enemies.)
* Items and decorations made from [[body parts]], such as [[hair]], [[bone]]/[[skull]], [[shell]], [[horn]]/hoof/antler, and [[ivory]]/[[tooth]]. It also includes items dwarves can't normally use for crafting, such as [[nail]]s, [[chitin]], and [[scale]]s.
* [[Leather]] or [[parchment]]/vellum, and all items made from them. These are made from [[skin]]s.
* [[Wool]] [[yarn]] and [[cloth]], as well as all items made from them. Elves have never heard of [[shearing]], so it doesn't matter how well you treat your [[sheep]]; they still associate animal products with death.
* [[Meat]] (including [[prepared organs]]), [[fish]] (both raw and prepared), [[fat]], and [[tallow]]
* [[Egg]]s. Elves aren't keen on keeping chickens, either.
* [[Prepared meals]] made using any of the above products.
* Tallow [[soap]]
* [[Corpse]]s and [[body parts]] themselves, although these are usually worthless anyway.
* [[Blood]], even if you somehow manage to get it into an elf-friendly container.

A distinct retort awaits dwarves who are so tactless as to offer goods made from both wood '''and''' animal products at the same time (such as tallow soap, or an item decorated with both wood and bone):
{{quote|You truly despise life, don't you? I am beside myself with grief. Perhaps we will show you how they suffered.}}

===== Acceptable items =====
Any item that isn't specifically prohibited above is acceptable to elves. A non-exhaustive list of items they accept:

* The "Feather Tree Egg Yolk" that the elves litter your trade depot with, can be traded back to them. Useful free trade items if you're looking to level another broker.
* Items made from or decorated with [[stone]], as well as raw [[clay]] or raw [[sand]]. This includes items made from [[petrified wood]], [[lignite]], or [[bituminous coal]]; elves aren't concerned with items that were plants or animals in a different geological age.
** [[Gizzard stone]]s are acceptable. Elves can't tell them from any other object made of stone.
* Items made from or decorated with [[metal]] (including [[steel]]), green [[glass]], or [[ceramic]]. Elves are content to assume your dwarves fuel their craft with [[coke]] and [[magma]] rather than [[charcoal]].
* All rough gems and cut gems, as well as items and decorations made from [[gem]] materials. Note that clear glass and crystal glass are not gem materials and are generally not acceptable, even though they can be used for [[Gem setting|gem decoration]]s and gem [[craft]]s.
** Due to a long-standing bug{{bug|919}}, elves do not examine the material rough gems or cut gems are made of. You can safely sell them raw clear or crystal glass, or cut gems made from clear or crystal glass, as long as you haven't used those gems for decorations. Be careful, because clear or crystal glass [[craft]]s from the "cut gems" job, including "large" gems, are still unacceptable.
* [[Block]]s made of any material, including wood or clear/crystal glass (due to the same bug as above).
* Bars of [[coke]] are acceptable, though it's unclear why you would ever want to trade them away.
* [[Plant]] and fungus products in general. Unless otherwise prohibited, all of these items are acceptable either as themselves or as the material for an item or decoration:
** Plant [[crop]]s, [[fruit]]/pods, [[seed]]s/nuts, and [[leaf|leaves]]/bulbs/flowers. Anything that can be grown on a [[farm plot]] or harvested with [[herbalism]] is one of these four. This includes non-wooden produce from trees.
** [[Plant fiber]] [[thread]] and [[cloth]], and all items made from them.
** Processed plant products. This includes (but isn't limited to) [[booze]], [[dye]], [[flour]], [[dwarven sugar]] and [[dwarven syrup]], [[oil]], [[press cake]], and [[paper]]. [[Papyrus]] sheets seem to be a notable exception.
* [[Silk]] [[thread]] and [[cloth]] and items made from them. Elves don't care if you're exploiting spiders.
* Products of the [[beekeeping industry]], including [[honey]], [[royal jelly]], [[mead]], [[wax]], and wax [[craft]]s.
* [[Cheese]] and [[milk]]
* [[Prepared meal]]s made entirely with allowed ingredients.
* "Grown" wood items. These can generally only be obtained from elves, and are made in keeping with elven ethics. Note that these items can still become unacceptable if they contain unacceptable items or are later decorated with unacceptable materials.
* Items made from [[Adamantine|certain]] [[Divine metal|spoiler]] [[Divine fabric|materials]], if you're willing to give these up.
* Live [[creature]]s or [[vermin]]. Since these can only be traded when in a [[cage]] or [[animal trap]], make sure the cage or trap is also made of acceptable materials.
* [[Soap]] made from [[oil]]. This may be a bug{{bug|8571}}, as even plant-based soap requires [[lye]], which is made from [[ash]].
* Otherwise-acceptable items are not disqualified by [[ash]] [[glaze]], which may be a bug{{bug|4652}}.

=== Human ===
{{quote|Greetings. The craftsdwarfship of the dwarves is unparalleled. Let's make a deal!}}

Assuming you do have friendly contact with [[human]]s, their first caravan will arrive sometime in summer, giving you well over a full year before they arrive.

The human caravan:
* arrives in [[Calendar|summer]]. (Usually your first caravan opportunity.)
* carries metal bars, sand, [[leather]], cloth, wood, food and booze, books, ropes, waterskins, quivers, backpacks, metal weapons and clothing and armor, cages and a few domestic animals.
* carries only large-sized clothing and armor, which is unusable by dwarves.
* is moderately guarded.
* sends a treasurer to negotiate import/export agreements (but only if the human civilization has the CUSTOM_OFFICIAL_3 position).

==== Good Humor ====
Choosing to seize goods from a human caravan without marking anything to be taken is treated as a joke, but this essentially does nothing (ie. the merchant mood is not raised).

=== Goblins and Kobolds ===
{{mod}}
{{main|modding#trade}}

A [[goblin]] caravan will only arrive if you mod the game, primarily because their entity lacks the [[entity token]]s needed to make use of pack animals and wagons - that, and that the token {{token|BABYSNATCHER|e}} makes them hostile to all non-goblin civilizations. The same caveats apply to [[kobold]]s (whose {{token|UTTERANCES|c}} and {{token|ITEM_THIEF|e}} tags, similarly, make them hostile to every civilization).

The goblin caravan:
*will arrive every season, four times per year
*is unguarded
*brings mostly food and cloth
*does not send a liaison or a guild representative
*does not make import/export agreements

== Merchant mood ==
If your trader has Novice or better [[Judge of intent]] skill, there will be a line added below the merchant's dialogue describing the caravan's attitude. Their attitude rises with successful trades (especially if they get lots of profit) and falls when you propose deals they don't like. You can never make a deal that's at a loss for the merchant, even if they are at the highest possible mood, but deals with exactly zero profit are possible.

The possible merchant displayed merchant moods are the following:

* {{DFtext|(trader) seems ecstatic with the trading.|2:1}}
* {{DFtext|(trader) seems very happy about the trading.|3:1}}
* {{DFtext|(trader) seems pleased with the trading.|1:1}}
* {{DFtext|(trader) seems willing to trade.|7:1}}
* {{DFtext|(trader) seems to be rapidly losing patience.|6:1}}
* {{DFtext|(trader) is not going to take much more of this.|4:1}}
* {{DFtext|(trader) is unwilling to trade.|5:1}}

Internally the merchant's mood is a variable with range 0-100. The merchant's mood always starts at 50. Only a merchant with mood 100 is ecstatic, between 80 and 99 very happy, between 60 and 79 happy, between 40 and 59 willing to trade, between 20 and 39 rapidly loosing patience, between 1 and 19 not going to take much more of this and with 0 unwilling to trade.

Proposed deals with a loss for a merchant are outright declined and do not affect a merchant's mood. If the merchant's profit is at least 0 then a proposed deal, if not accepted, will always be meet with a counter-offer. If the last deal was successful (and with that the current haggle fail count 0), such a counter-offer does not affect the merchant's mood (but internally a haggle fail count is incremented by 1). But if the haggle fail count is non-zero, then the merchant's mood will decrease by 10 (if haggle fail count is 1), by 20 if the haggle fail count is 2 and presumeably haggle fail count times 10 for even higher haggle fail count values. If a deal is accepted (either because the counter-offer was accepted or the proposed deal was outright accepted), then the merchant's mood is raised by at least 1, if the profit is at least 1 and also at least 1% - deals with zero profit or with less than 1% profit for the merchant do not raise the merchant's mood (but if accepted without counter-offer they also do not decrease the merchant's mood). A successful deal (including accepted counter-offers) also sets the haggle fail count back to 0 (if it was higher), even if the profit is 0. If a merchant's mood reaches the lowest level, no further trades will be possible (and the merchants will start to pack their things and leave).

The merchant's mood, along with your brokers "haggle" skills in comparison with the merchant's "haggle" skills (both weighted by the importance of the haggle skill), affect the likelyhood that a counter offer is made (and the deal is not outright accepted), when the profit margin is below 50% and also affects - in case of a counter-offer - how much the merchant might demand then (allthough there is randomness involved, ie. even with very high haggle skills of the broker compared to the merchant, it is possible that accepting a counter-offer of an ecastatic merchant would result in more than 50% profit for the merchant, allthough such occurances are unlikely).

An easy way to capitalize on the mood system is by first making cheap deals with at least 50% profit for the merchant (until the mood is high) and then being more aggressive with the trading. Allthough an even more effective way to capitalize on the mood system by proposing deals with minimum profit as long as the haggle fail count is 0 and if a counter-proposal is made, declining the deal and buying the cheapest item the merchant has for 50% profit (for the merchant).

But then, unless you want to send a messenger to increase the trade relations, low profits for the merchants might not be wanted, as of v53.13 the profit do affect the amount of goods brought in the next year.

== Trade Agreements and Liaisons ==
[[Outpost liaison]]s (from your own civilization) and foreign Merchant Nobles (if added with the [[Position token#TRADE|TRADE responsibility]]) will arrive with the caravan to speak to your [[noble]] dwarves (and they ''will'' speak to those dwarves, even if they have to wait at their bedside in the hospital for months after the caravan has left), appearing on the map edge at the same time as the caravan (though in a different location). Meeting with them allows you to request specific items for the next caravan to bring (at a premium price) or take requests for production for the next caravan (for which the merchants will pay a premium).

Current [[Trade agreement|trade agreements]] can be viewed through the Civilization menu ({{k|c}}). These trade agreements are cleared when a liaison of the corresponding civilization enters the screen, so they are generally not accessible after the caravan has arrived.

In the event that your leader is replaced, killed, or taken by a [[strange mood]], the liaison may decide to leave your fortress [[stymied|"unhappy"]].{{bug|576}} Curiously, this will '''not''' occur if your leader is otherwise unable to perform the "conduct meeting" task. You can currently lock a liaison in a room and they will wait years to attend the meeting your noble is constantly conducting (and all subsequent diplomats appear to wait in line for the first to finish); this behavior is presumably a bug.{{bug|8947}}

Whether having successfully met with your leader or given up, a liaison who has decided to leave but is prevented from reaching the map edge will eventually go [[insane]].

== Bugs ==

* Merchants who are attacked by enemies or even wild animals will sometimes become disconnected from the trade depot and refuse to pack of their things to leave the map, and these items will remain 'stuck' in the depot. Deconstructing the trade depot usually forces them to leave, presumably with the downside of causing those goods to be considered seized by the player.
* Aggressive, untrainable creatures (captured goblins, for example) cannot be traded; when a dwarf attempts to move the caged animal to the Depot, the creature is set free.
* When merchants leave with an animal, the merchants seem to be dragging their beast of burden instead of leading it. If the animal is incapacitated but not dead, the merchant will continue to walk at the same speed, dragging the unconscious beast.
* If a merchant's chosen map edge exit is guarded by a hostile creature (including those on a [[restraint]]), the merchant will wander back and forth repeatedly and eventually go insane rather than path to an alternate exit.
* Animals bought from merchants don't always become available for use.{{bug|10162}}

== Loyalty cascade ==
{{main|Faction#Loyalty cascade|l1=Faction}}
If you order your military to kill merchants from your own civilization, a bizarre result of the way loyalty is handled makes the members of your military who attacked the traders become enemies of your civilization, but remain members of your fort's government (dwarves of this [[faction]] are referred to as ''separatists''). As enemies, they attack your other dwarves (''citizens''), but as members of the fort, they still follow orders. Allowing citizen militia dwarves to attack the separatists will give them opposite loyalties of the separatists, (i.e. loyal to civ, not to fort), or ''loyalists'', who do '''not''' follow orders. And then, if a separatist or loyalist kill a citizen, they become enemies of the civ '''and''' fort, making them ''Renegades'', who are essentially complete enemies of the citizens.

To prevent the cascade from spreading, order the original separatists away from the fortress and let them fight amongst themselves. If the results are renegades, it is okay to allow other dwarves to kill them (by stationing them nearby). If the results are separatists/loyalists, then you will need to separate them, somehow.

== Exploits ==
*Deconstructing the depot will cause merchants to leave your fortress and abandon any goods in the Depot, though any animals they had caged will still belong to the merchants and only become Friendly (i.e. you won't actually own them). However, the merchant visit will be reported in history as having experienced "irregularities with their goods", harming trade relations exactly the same as if you had Seized them directly (though without the items themselves being marked as Stolen).
*If you wait until the merchants leave the map, you can "claim" caged animals by linking a lever to the cage and opening it, the animals will be released in a tamed state. Check the {{k|u}}nit screen before releasing them; if the creatures still show as Merchant creatures, they will wander off the map when released; if they show as Tame creatures, they will stay once released.
*If you lock them in your fortress for a minute or two (real time), the merchants '''may''' drop items and leave behind pack animals (both of which are yours for the taking!) Note: Results are not consistent.
* If [[Caravan#Destruction|spooked or attacked]] the merchants' caravan could leave their stuff behind as they attempt to flee the map, leaving the items free for the taking.

[[File:Bullock_Team_Wool_Wagon.jpg|thumb|400px|center|An old trading wagon from the 1880's.]]

== World level trade ==
During world generation, trade is established between sites. This probably determines growth.

{{Translation| dwarven = nish | elvish = lathì | goblin = otsmor | human = batow}}

{{Category|Trade| }}
[[ru:Trading]][[zh:Trading]]

Material token

2026-07-23T17:41:14Z

Quietust: /* Hardcoded Materials */ for completeness, add the internal ID numbers for creature/histfig/plant materials

{{Quality|Exceptional}}
{{av}}
:''For the tokens that define an individual material's properties, see [[Material definition token]].''
{{Modding}}

Material tokens are used to refer to various types of materials in a wide variety of places. They can take the following forms below.
{{clear}}

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

|-
| {{text anchor|INORGANIC}}
| MATERIAL_NAME
| Specifies a standalone inorganic material defined in the raws, generally a stone or metal. For example, INORGANIC:IRON refers to [[iron]], and INORGANIC:CERAMIC_PORCELAIN refers to [[porcelain]]. The material name can be substituted with USE_LAVA_STONE to randomly select a suitable [[Inorganic material definition token|lava stone]], which is normally [[obsidian]]. Specify NONE or NO_MATGLOSS to instead select [[magma]].

|-
| {{text anchor|STONE}}
| MATERIAL_NAME
| Alias for INORGANIC:MATERIAL_NAME, intended for backwards compatibility.

|-
| {{text anchor|METAL}}
| MATERIAL_NAME
| Alias for INORGANIC:MATERIAL_NAME, intended for backwards compatibility.

|-
| {{text anchor|COAL}}
| CHARCOAL, COKE, or NO_MATGLOSS
| Specifies a material that can be used as fuel - charcoal or coke. Specifying NO_MATGLOSS ('''not''' NONE) will make it accept "refined coal" in general, matching both charcoal and coke.

|-
| {{text anchor|CREATURE_MAT}}
| CREATURE_ID:MATERIAL_NAME or CREATURE_ID:INDEX###
| Specifies a material associated with a specific creature. Examples: CREATURE_MAT:DWARF:SKIN refers to [[dwarf]] skin. Can also specify "INDEX" followed by a 3-digit number to select a material by index instead of by name, where 000 is the first material in that creature.

|-
| {{text anchor|LOCAL_CREATURE_MAT}}
| MATERIAL_NAME or INDEX###
| Alias for CREATURE_MAT:'''CREATURE_ID''':MATERIAL_NAME (or CREATURE_MAT:'''CREATURE_ID''':INDEX###), where CREATURE_ID is the creature currently being defined; as such, it can only be used in creature definitions.

|-
| {{text anchor|PLANT_MAT}}
| PLANT_ID:MATERIAL_NAME
| Specifies a material associated with a specific plant. Example: PLANT_MAT:BUSH_QUARRY:LEAF refers to [[quarry bush]] leaves. Unlike CREATURE_MAT, "INDEX###" is '''not''' permitted.

|-
| {{text anchor|LOCAL_PLANT_MAT}}
| MATERIAL_NAME
| Alias for PLANT_MAT:'''PLANT_ID''':MATERIAL_NAME, where PLANT_ID is the plant currently being defined; as such, it can only be used in plant definitions. Unlike LOCAL_CREATURE_MAT, "INDEX###" is '''not''' permitted.

|-
| {{text anchor|GET_MATERIAL_FROM_REAGENT}}
| REAGENT_ID:REACTION_PRODUCT_ID
| Specifies a material related to a reagent's material within a [[reaction]]. REAGENT_ID must match a [REAGENT], and REACTION_PRODUCT_ID must either match a [MATERIAL_REACTION_PRODUCT] belonging to the reagent's material or be equal to "NONE" to use the reagent's material itself.

|-
| {{text anchor|MATERIAL_NAME}}
| NONE (ignored)
| Specifies one of the hardcoded materials listed below. Note that this goes in the token itself, not arguments (i.e GLASS_GREEN:NONE, not MATERIAL_NAME:GLASS_GREEN).
|}

Several types of [[Item token|items]] expect a creature ID and caste ID (e.g. [[Ant|ANT:SOLDIER]]) in place of the material token.

=== Internal Material IDs ===

It should be noted when using the table below, that you do not place (MATERIAL_NAME:(Your material here)). For example, green glass will be (GLASS_GREEN:NONE).

{| {{prettytable}} class="sortable"
|- bgcolor="#ddd"
! # !! Token !! Information
|-
| -1 || {{text anchor|NONE}} || [[Unknown material]] (light gray, solid), acts as a placeholder for any material.
|-
| 0 || {{text anchor|INORGANIC}} || [[Magma]] when specified with subtype NONE or NO_MATGLOSS, otherwise a user-defined inorganic material.
|-
| 1 || {{text anchor|AMBER}} || [[Amber]]
|-
| 2 || {{text anchor|CORAL}} || [[Coral]]
|-
| 3 || {{text anchor|GLASS_GREEN}} || [[Green glass]]
|-
| 4 || {{text anchor|GLASS_CLEAR}} || [[Clear glass]]
|-
| 5 || {{text anchor|GLASS_CRYSTAL}} || [[Crystal glass]]
|-
| 6 || {{text anchor|WATER}} || [[Water]], when placed in [[bucket]]s or when mining out [[ice]].
|-
| 7 || {{text anchor|COAL}} || [[Coal]] - subtype is either COKE or CHARCOAL (or NO_MATGLOSS to match either).
|-
| 8 || {{text anchor|POTASH}} || [[Potash]]
|-
| 9 || {{text anchor|ASH}} || [[Ash]]
|-
| 10 || {{text anchor|PEARLASH}} || [[Pearlash]]
|-
| 11 || {{text anchor|LYE}} || [[Lye]]
|-
| 12 || {{text anchor|MUD}} || [[Mud]]
|-
| 13 || {{text anchor|VOMIT}} || [[Vomit]]
|-
| 14 || {{text anchor|SALT}} || [[Salt]]
|-
| 15 || {{text anchor|FILTH_B}} || [[Filth]] (brown, solid)
|-
| 16 || {{text anchor|FILTH_Y}} || [[Filth]] (yellow, liquid)
|-
| 17 || {{text anchor|UNKNOWN_SUBSTANCE}} || [[Unknown substance]] (light gray, liquid)
|-
| 18 || {{text anchor|GRIME}} || [[Grime]]
|-
| 19 - 218 || {{text anchor|CREATURE_1}} thru CREATURE_200 || Materials attached to specific types of [[creature]]s. Cannot be specified directly within raws, only used internally.
|-
| 219 - 418 || {{text anchor|HIST_FIG_1}} thru HIST_FIG_200 || Creature materials bound to specific historical figures (e.g. for [[vampire]] blood). Cannot be specified directly within raws, only used internally
|-
| 419 - 618 || {{text anchor|PLANT_1}} thru PLANT_200 || Materials attached to specific types of [[plant]]s. Cannot be specified directly within raws, only used internally
|-
| 619 - 658 || {{text anchor|UNUSED01}} thru UNUSED40 || Placeholders for new hardcoded materials. Cannot be specified directly within raws.
|}

{{Category|Modding}}
{{Category|Tokens}}
[[ru:Material token]]

Plant token

2026-07-23T13:50:32Z

Quietust: /* Environment tokens */ make it clear that you can add as many [BIOME:whatever] tokens as you want

{{Quality|Fine}}
{{av}}
{{Modding}}
The <code>[OBJECT:PLANT]</code> [[token]] begins the definition of a [[plant]] [[raw file]]. Following this, each new plant definition begins with the <code>[PLANT:plant_ID]</code> token, where plant_ID is a unique identifier for the plant, and that plant's properties are then defined using the tokens listed below.

__TOC__
{{clear}}

==Basic tokens==
These tokens are specified for all plants and define their most basic characteristics.

{| {{prettytable}}
|- style='background-color:#ddd'
! width="20%" | Token
! width="20%" | Arguments
! width="60%" | Description

|-
| {{text anchor|NAME}}
|
*name
| The singular form of the plant's name as seen in-game.

|-
| {{text anchor|NAME_PLURAL}}
|
*name
| The plural form of the plant's name as seen in-game.

|-
| {{text anchor|ADJ}}
|
*adjective
| The word or phrase used to describe items made from this plant.

|-
| {{text anchor|ALL_NAMES}}
|
*name
| Sets the NAME, NAME_PLURAL, and ADJ to the specified string.

|-
| {{text anchor|PREFSTRING}}
|
*reason
| What dwarves can like this object for (e.g. "Urist likes plump helmets for their rounded tops.")

|-
| {{text anchor|MATERIAL}}
|
*material_name
| Starts defining a new local plant material with the given name. Must be followed with [[material definition token]]s defining the material's properties. A maximum of 200 materials can be defined on any given plant.

|-
| {{text anchor|USE_MATERIAL}}
|
*material_name
*local_material
| Starts defining a new local plant material with the given name and using the properties of another local plant material. May be followed with material definition tokens to further define its properties or change the properties imported from the local plant material. A maximum of 200 materials can be defined on any given plant.

|-
| {{text anchor|USE_MATERIAL_TEMPLATE}}
|
*material_name
*template_name
| Starts defining a new local plant material with the name ''material_name'' and using the properties of the specified MATERIAL_TEMPLATE with the name ''template_name''. May be followed with material definition tokens to further define its properties or change the properties imported from the template material. A maximum of 200 materials can be defined on any given plant.

|-

| {{text anchor|SELECT_MATERIAL}}{{version|50.13}}
|
*material_name
| Selects a previously defined local plant material for subsequent modification. Unlike with [[creature token]]s, "ALL" ''cannot'' be specified here.

|-
| {{text anchor|BASIC_MAT}}
|
* [[Material token|material]]
| Sets the basic material of the plant. This defines what is harvested when the plant itself, rather than a growth, is picked. According to Toady, you can use other materials (for instance, iron) but the game may hiccup on plants that aren't structurally plants. For crops, said material should have [STRUCTURAL_PLANT_MAT] to permit proper stockpiling. Generally, this should be "LOCAL_PLANT_MAT:material_name", using a material defined using MATERIAL, USE_MATERIAL, or USE_MATERIAL_TEMPLATE. The only way to remove the plant's basic material entry (e.g. "soybean plant") from every stockpile category is to remove this token, but this will cause problems with farming the plant in a farm plot and harvesting the whole wild plant if that's possible.
|}

==Environment tokens==
These tokens, also applicable to all plants, specify where the plants grow.

{| {{prettytable}}
|- style='background-color:#ddd'
! width="20%" | Token
! width="20%" | Arguments
! width="60%" | Description

|-
| {{text anchor|UNDERGROUND_DEPTH}}
|
*minimum
*maximum
| Designates the highest and lowest cavern levels that the plant can appear in if its [[biome token|biome]] is subterranean. Dwarven civilizations will only export (via the embark screen or caravans) things that are available at depth 1. Defaults to 0:0 (surface only).

|-
| {{text anchor|GOOD}}
|
| Restricts the plant to growing in Good regions. Cannot be combined with [EVIL].

|-
| {{text anchor|EVIL}}
|
| Restricts the plant to growing in Evil regions. Cannot be combined with [GOOD].

|-
| {{text anchor|SAVAGE}}
|
| Restricts the plant to growing in Savage regions (regardless of alignment).

|-
| {{text anchor|FREQUENCY}}
|
*freq (0-100)
| How frequently this plant is generated in a particular area. Defaults to 50. Plants with valid [[biome token]]s and [FREQUENCY:0] will not grow in the wild, but will still be available for entity use and farm plots.

|-
| {{text anchor|WET}}
|
| Restricts the plant to growing near natural water features. A plant with [WET] may be very common or very rare in an area, depending on how many water features that area has. Note that they will not grow next to dwarf-filled channels, since it explicitly checks the tile type (e.g. "River", "River Source", "Brook", "Murky Pool", and variants thereof). Combining this with [DRY] causes it to be ignored.

|-
| {{text anchor|DRY}}
|
| Restricts the plant to growing away from natural water features. Combining this with [WET] causes it to be ignored.

|-
| {{text anchor|BIOME}}
|
*biome
| Allows the plant to grow in the specified [[biome token|biome]]. Can be specified multiple times to add multiple biomes.

|}

==Growth tokens==
These tokens are used for all plants, and specify growths growing on a plant. Edible or otherwise usable growths should have [STOCKPILE_PLANT_GROWTH] in their [[material definition token|material definitions]] for proper stockpiling. This also lets them be collected from plant gathering and farming jobs.

{| {{prettytable}}
|- style='background-color:#ddd'
! width="20%" | Token
! width="20%" | Arguments
! width="60%" | Description

|-
| {{text anchor|GROWTH}}
|
*name
| Defines a plant growth, taking the below tokens as arguments.

|-
| {{text anchor|SELECT_GROWTH}}{{version|50.13}}
|
*name
| Selects a previously-defined plant growth. Any tokens which follow this will further modify the selected growth.

|-
| {{text anchor|GROWTH_NAME}}
|
*singular
*plural (STP for standard plural)
| The name of a plant growth.

|-
| {{text anchor|GROWTH_ITEM}}
|
* [[item token]]
* [[material token]]
| Specifies what item this growth is and what it is made of. Generally, the item type should be PLANT_GROWTH:NONE.

If multiple growths point to the same material with [STOCKPILE_PLANT_GROWTH] then only the first will appear correctly in the stockpile menu, with latter growths appearing as "Plant Growth (?)"

|-
| {{text anchor|GROWTH_HOST_TILE}}
|
*plant part
| Specifies on which part of the plant or tree the growth appears, usually for multi-tile [[tree]]s. Valid tokens are:
*TWIGS
*BRANCHES_AND_TWIGS / LIGHT_BRANCHES_AND_TWIGS
*BRANCHES / LIGHT_BRANCHES
*ALL_BRANCHES_AND_TWIGS
*HEAVY_BRANCHES / DIRECTED_BRANCHES
*HEAVY_BRANCHES_AND_TRUNK / DIRECTED_BRANCHES_AND_TRUNK
*TRUNK
*ROOTS
*CAP
*SAPLING

|-
| {{text anchor|GROWTH_TRUNK_HEIGHT_PERC}}
|
*start percent (0-100+)
*end percent (0-100+)
| Controls the height on the trunk between which the growth begins to appear. The first value is the percent of the trunk height where the growth begins appearing: 0 will cause growths to appear starting above the first tile; 100 will cause growths to appear only at the topmost trunk tile. Can be larger than 100 for trees that have growths on branches extending higher than the trunk.

A value of -1 for the second number appears to make the growths extend all the way to the top of the trunk.

|-
| {{text anchor|GROWTH_DENSITY}}
|
*integer
| Currently has no effect.

|-
| {{text anchor|GROWTH_TIMING}}
|
*[[time]] start:end (0-403200)
| Specifies at which part of the year the growth appears. Default is all year round.

A single growth can only have one GROWTH_TIMING tag. If multiple are declared, the last one will be used. To make a growth appear multiple times during the year, you need to create a different growth for every GROWTH_TIMING interval. By using the same material for all of the duplicate growths, all of them will be stockpiled together and be eligible for the same reactions. Edible/brewable growths will have separate entries in the kitchen menu, though.

There is no known way to declare a growth timing that lasts from winter into spring. Including numbers below 0 or above 403200 in the range will make the growth available at all times, as though you hadn't defined a growth timing at all. So will including a range for which the start time is later than the end time.

This has no effect on farmed growths; all eligible growths that have [STOCKPILE_PLANT_GROWTH] in their materials will be harvested, regardless of if they are currently within their growth timing or not.

|-
| {{text anchor|GROWTH_PRINT}}
|
*overworld tile
*item tile
*color
*time (0-403200) start:end, ALL, or NONE
*priority
| Specifies the appearance of the growth. Can be specified more than once, for example for autumn leaves. Transitions between different timing periods will happen gradually over the course of 2000 ticks.

Priority seems to control what to display when there would be multiple symbols on a tile in ASCII mode. A higher number takes priority over a lower number. Example: if a LEAVES growth has a priority of 1 and a FRUIT growth has a priority of 3, the fruit growth will be the symbol shown when it is present.

The GROWTH_PRINT tile will only be displayed when the growth in question is actually present, even if its timing parameter is ALL.

In graphics mode, any growth being displayed will cause the GROWTH/SHRUB graphic to be used, and no growths available will display the GROWTH_PICKED/SHRUB_PICKED graphic.

|-
| {{text anchor|GROWTH_HAS_SEED}}
|
| The growth drops a seed if eaten raw.

|-
| {{text anchor|GROWTH_DROPS_OFF}}
|
| Growths drop from the plant, producing a cloud of items which fall on the ground, which [[herbalist]]s can collect.
|-
| {{text anchor|GROWTH_DROPS_OFF_NO_CLOUD}}
|
| Growths drop collectable items from the plant without producing item clouds.

|}

==Tree tokens==
These tokens are used only for trees.

{| {{prettytable}}
|- style='background-color:#ddd'
! width="20%" | Token
! width="20%" | Arguments
! width="60%" | Description

|-
| {{text anchor|TREE}}
|
* [[Material token|material]] or NONE
| Makes the plant into a [[tree]]. Cutting down the tree will yield logs made of this material. Setting the material to NONE will give no wood from this tree.

|-
| {{text anchor|TRUNK_NAME}}
|
*name
| What the trunk of the tree is named.

|-
| {{text anchor|MAX_TRUNK_HEIGHT}}
|
*1-8
| The maximum z-level height of a mature tree's trunk, starting from about two z-levels above ground and going up.

|-
| {{text anchor|MAX_TRUNK_DIAMETER}}
|
*1-3
| Upper limit of trunk thickness, in tiles. Counted separately for all branching trunks. Has a geometric effect on log yield.

|-
| {{text anchor|TRUNK_PERIOD}}
|
*integer
| The number of years the trunk takes to grow one Z-level upward.{{verify}}

|-
| {{text anchor|TRUNK_WIDTH_PERIOD}}
|
*integer
| The number of years the trunk takes to grow another tile wider.

|-
| {{text anchor|LIGHT_BRANCHES_NAME}}
|
*name
| What thin branches of the tree are named.

|-
| {{text anchor|BRANCH_DENSITY}} / {{text anchor|LIGHT_BRANCHES_DENSITY}}
|
*integer
| How dense the branches grow on this tree.

|-
| {{text anchor|BRANCH_RADIUS}} / {{text anchor|LIGHT_BRANCH_RADIUS}}
|
*integer
| The radius to which branches can reach. Appears to never reach further than seven tiles from the centre. Does not depend on the trunk branching amount or where trunks are. The values used in the game go from 0-3. Higher values than that can cause crashes. {{bug|10419}}

|-
| {{text anchor|HEAVY_BRANCHES_NAME}} / {{text anchor|DIRECTED_BRANCHES_NAME}}
|
*name
| What thick branches of the tree are named.

|-
| {{text anchor|HEAVY_BRANCH_DENSITY}} / {{text anchor|DIRECTED_BRANCH_DENSITY}}
|
*integer
| Similar to [[Plant_token#BRANCH_DENSITY|BRANCH_DENSITY]] for thick branches.

|-
| {{text anchor|HEAVY_BRANCH_RADIUS}} / {{text anchor|DIRECTED_BRANCH_RADIUS}}
|
*integer
| Similar as [[Plant_token#BRANCH_RADIUS|BRANCH_DENSITY]] for thick branches. Values outside 0-3 can cause crashes. {{bug|10419}}

|-
| {{text anchor|TRUNK_BRANCHING}}
|
*integer
| How much the trunk branches out. 0 makes the trunk straight.

|-
| {{text anchor|ROOT_NAME}} / {{text anchor|ROOTS_NAME}}
|
*name
| What the roots of the tree are named.

|-
| {{text anchor|ROOT_DENSITY}}
|
*integer
| Density of the root growth.

|-
| {{text anchor|ROOT_RADIUS}}
|
*integer
| How wide the roots reach out.

|-
| {{text anchor|TWIGS_NAME}}
|
*name
| What the twigs of the tree are named.

|-
| {{text anchor|TWIGS_SIDE_BRANCHES}}
|
*boolean (0 or 1)
| Twigs appear on the side of branches. Defaults to 1.

|-
| {{text anchor|TWIGS_ABOVE_BRANCHES}}
|
*boolean (0 or 1)
| Twigs appear above branches. Defaults to 1.

|-
| {{text anchor|TWIGS_BELOW_BRANCHES}}
|
*boolean (0 or 1)
| Twigs appear below branches. Defaults to 0.

|-
| {{text anchor|TWIGS_SIDE_HEAVY_BRANCHES}}
|
*boolean (0 or 1)
| Twigs appear on the side of heavy branches. Defaults to 0.

|-
| {{text anchor|TWIGS_ABOVE_HEAVY_BRANCHES}}
|
*boolean (0 or 1)
| Twigs appear above heavy branches. Defaults to 0.

|-
| {{text anchor|TWIGS_BELOW_HEAVY_BRANCHES}}
|
*boolean (0 or 1)
| Twigs appear below heavy branches. Defaults to 0.

|-
| {{text anchor|TWIGS_SIDE_TRUNK}}
|
*boolean (0 or 1)
| Twigs appear on the side of the trunk. Defaults to 0.

|-
| {{text anchor|TWIGS_ABOVE_TRUNK}}
|
*boolean (0 or 1)
| Twigs appear above the trunk. Defaults to 0.

|-
| {{text anchor|TWIGS_BELOW_TRUNK}}
|
*boolean (0 or 1)
| Twigs appear below the trunk. Defaults to 0.

|-
| {{text anchor|TREE_HAS_MUSHROOM_CAP}}
|
| The tree has a rounded cap-hood like a giant mushroom. This severely stunts a tree's maximum height. {{bug|7313}}

|-
| {{text anchor|CAP_NAME}}
|
*name
| What this mushroom-cap is called. Only makes sense with TREE_HAS_MUSHROOM_CAP.

|-
| {{text anchor|CAP_PERIOD}}
|
*integer
| Similar to the other PERIOD tags, influences the rate of the mushroom cap growth. Only makes sense with TREE_HAS_MUSHROOM_CAP.

|-
| {{text anchor|CAP_RADIUS}}
|
*integer
| The radius of a mushroom cap. Only makes sense with TREE_HAS_MUSHROOM_CAP.

|-
| {{text anchor|STANDARD_TILE_NAMES}}
|
| Uses the standard names for the tree components (roots, trunk, branches, etc.)

|-
| {{text anchor|TREE_TILE}}
|
*tile
| The tile used for trees of this type on the world map. Defaults to 24 (↑).

|-
| {{text anchor|DEAD_TREE_TILE}}
|
*tile
| The tile used for (un)dead trees and deciduous trees (generally in winter) of this type. Defaults to 198 (╞).

|-
| {{text anchor|SAPLING_TILE}}
|
*tile
| The tile used for saplings of this tree. Defaults to 231 (τ).

|-
| {{text anchor|DEAD_SAPLING_TILE}}
|
*tile
| The tile used for dead saplings of this tree. Defaults to 231 (τ).

|-
| {{text anchor|TREE_COLOR}}
|
*foreground
*background
*bright
| The [[color]] of the tree on the map. Defaults to 2:0:0 (dark green).

|-
| {{text anchor|DEAD_TREE_COLOR}}
|
*foreground
*background
*bright
| The [[color]] of the tree on the map when (un)dead. Defaults to 0:0:1 (dark gray).

|-
| {{text anchor|SAPLING_COLOR}}
|
*foreground
*background
*bright
| The [[color]] of saplings of this tree. Defaults to 2:0:0 (dark green).

|-
| {{text anchor|DEAD_SAPLING_COLOR}}
|
*foreground
*background
*bright
| The [[color]] of dead saplings of this tree. Defaults to 0:0:1 (dark gray).

|-
| {{text anchor|SAPLING_DROWN_LEVEL}}
|
*depth
| The sapling of this tree will drown once the water on its tile reaches this level. Defaults to 4.

|-
| {{text anchor|TREE_DROWN_LEVEL}}
|
*depth
| The water depth at which this tree will drown. Exact behavior is unknown. Defaults to 7.

|-
| {{text anchor|SAPLING}}
|
| Makes young versions of the tree be called "[tree name] sapling"; otherwise, they are called "young [tree name]".

|}

==Shrub tokens==
These tokens are used for non-grass, non-tree plants.

{| {{prettytable}}
|- style='background-color:#ddd'
! width="20%" | Token
! width="20%" | Arguments
! width="60%" | Description

|-
| {{text anchor|SPRING}}, {{text anchor|SUMMER}}, {{text anchor|AUTUMN}}, {{text anchor|WINTER}}
|
| Allows the plant to grow in farm plots during the given season.

Wild shrubs will die during transitions to seasons which are not specified, but new shrubs will still appear even if they are out of season.{{bug|12940}}

|-
| {{text anchor|GROWDUR}}
|
*time
| How long the plant takes to grow to harvest in a farm plot. Unit hundreds of ticks, See [[Time]]. There are 1008 GROWDUR units in a season. Defaults to 300.

|-
| {{text anchor|VALUE}}
|
*value
| Has no known effect. Previously set the value of the harvested plant.

|-
| {{text anchor|PICKED_TILE}}
|
*tile
| The tile used when the plant is harvested whole, or is ready to be picked from a farm plot. May either be a cp437 tile number, or a character between single quotes. See [[Main:character table|character table]]. Defaults to 231 (τ).

|-
| {{text anchor|DEAD_PICKED_TILE}}
|
*tile
| The tile used when a plant harvested whole has wilted. Defaults to 169 (⌐).

|-
| {{text anchor|SHRUB_TILE}}
|
*tile
| The tile used to represent this plant when it is wild, alive, and has no growths. Defaults to 34 (").

|-
| {{text anchor|DEAD_SHRUB_TILE}}
|
*tile
| The tile used to represent this plant when it is dead in the wild. Defaults to 34 (").

|-
| {{text anchor|CLUSTERSIZE}}
|
*size
| The maximum stack size collected when gathered via herbalism (but ''not'' farm plots). Defaults to 5. CLUSTERSIZE must be greater than or equal to 1+ the number of instances of [STOCKPILE_PLANT_GROWTH] in the plant's raws. For plants like vanilla cabbage, clustersize of 1, which is less than 1+[one instance]=2, will prevent citizens from gathering the plant. Best to set all cluster sizes to 2 or higher for safety.

|-
| {{text anchor|PICKED_COLOR}}
|
*foreground
*background
*bright
| The color of the plant when it has been picked whole, or when it is ready for harvest in a farm plot. Defaults to 2:0:0 (dark green).

|-
| {{text anchor|DEAD_PICKED_COLOR}}
|
*foreground
*background
*bright
| The [[color]] of the plant when it has been picked whole, but has wilted. Defaults to 0:0:1 (dark gray).

|-
| {{text anchor|SHRUB_COLOR}}
|
*foreground
*background
*bright
| The [[color]] of the plant when it is alive, wild, and has no growths. Defaults to 2:0:0 (dark green).

|-
| {{text anchor|DEAD_SHRUB_COLOR}}
|
*foreground
*background
*bright
|The [[color]] of the plant when it is dead in the wild. Defaults to 6:0:0 (brown).

|-
| {{text anchor|SHRUB_DROWN_LEVEL}}
|
*depth
| The shrub will drown once the water on its tile reaches this level. Defaults to 4.

|-
| {{text anchor|DRINK}}
|
* [[Material token|material]]
| Names a [[alcohol|drink]] made from the plant, allowing it to be used in entity resources. Previously also permitted brewing the plant into [[alcohol]] made of this material. Now, a MATERIAL_REACTION_PRODUCT of type DRINK_MAT should be used on the proper plant material.

|-
| {{text anchor|MILL}}
|
* [[Material token|material]]
| Permits milling the plant at a [[quern]] or [[millstone]] into a powder made of this material and allows its use in entity resources. Said material should have [POWDER_MISC_PLANT] to permit proper stockpiling. This token makes the whole plant harvestable regardless of which material is designated for milling. For plants with millable ''growths'', use only MATERIAL_REACTION_PRODUCT or ITEM_REACTION_PRODUCT tokens to define the milling products.

|-
| {{text anchor|THREAD}}
|
* [[Material token|material]]
| Permits processing the plant at a [[farmer's workshop]] to yield threads made of this material and allows its use in entity resources. Said material should have [THREAD_PLANT] to permit proper stockpiling.

|-
| {{text anchor|SEED}}
|
*name
*name_plural
*foreground
*background
*bright
*[[Material token|material]]
| Causes the plant to yield plantable seeds made of this material and having these properties. Said material should have [SEED_MAT] to permit proper stockpiling.

|-
| {{text anchor|EXTRACT_STILL_VIAL}}
|
* [[Material token|material]]
| Permits processing the plant into a [[vial]] at a [[still]] to yield extract made of this material. Said material should have [EXTRACT_STORAGE:FLASK].

|-
| {{text anchor|EXTRACT_VIAL}}
|
*[[Material token|material]]
| Permits processing the plant into a [[vial]] at a [[farmer's workshop]] to yield extract made of this material. Said material should have [EXTRACT_STORAGE:FLASK].

|-
| {{text anchor|EXTRACT_BARREL}}
|
* [[Material token|material]]
| Permits processing the plant into a [[barrel]] at a [[farmer's workshop]] to yield extract made of this material. Said material should have [EXTRACT_STORAGE:BARREL].

|}

==Grass tokens==
These tokens are used only for [[grass]]es.

{| {{prettytable}}
|- style='background-color:#ddd'
! width="20%" | Token
! width="20%" | Arguments
! width="60%" | Description

|-
| {{text anchor|GRASS}}
|
| Makes the plant behave as a type of grass. This allows animals to graze on it, and prevents it and its growths from being picked by herbalists. (Grass growths can still be picked in adventure mode, however.)

|-
| {{text anchor|GRASS_TILES}}
|
*tile
*tile
*tile
*tile
| Specifies the 4 tiles used to represent grass of this type. If VARIED_GROUND_TILES is disabled in [[Settings#Feature_toggles|settings]], these are ignored, always using ".". Defaults to 46:44:96:39 (.,`').

|-
| {{text anchor|ALT_PERIOD}}
|
*period
*offset
| How often the grass switches between its main tiles and alternate tiles. The "period" value determines how quickly (in frames) the grass animates, and the "offset" value specifies how much of that time is spent displaying the alternate tiles. If the "offset" value is greater than or equal to the "period" value, the grass will only display using the alternate tiles.{{verify}} Defaults to 0:0.

|-
| {{text anchor|ALT_GRASS_TILES}}
|
*tile
*tile
*tile
*tile
| When used with ALT_PERIOD, specifies the 4 alternate tiles used to represent grass of this type. Defaults to 46:44:96:39 (.,`'). Dead grass does not animate.

|-
| {{text anchor|GRASS_COLORS}}
|
*color 1 (fore:back:bright)
*color 2 (fore:back:bright)
*dry color (fore:back:bright)
*dead color (fore:back:bright)
| Specifies the color of this grass. Defaults to 2:0:1:2:0:0:6:0:1:6:0:0 (light green, dark green, yellow, brown).
|}

{{Category|Modding}}
{{Category|Tokens}}
[[ru:Plant token]]

Onion

2026-07-23T13:45:30Z

Quietust: tag reference

{{Quality|Superior}}
{{plantlookup
|graphic=onion_shrub_sprite.png
|seedimage=onion_seeds_sprite.png
|uses=
*[[Food]]
}}
{{av}}

'''Onions''' are an [[aboveground]] [[crop|garden vegetable]]. They can be planted in all seasons, and the bulb is edible raw or [[cooking|cooked]]. Bulbs also can be processed in a [[dyer's shop]] into orange [[dye]].

Some [[Dwarf|dwarves]] [[preferences|like]] onion plants for their ''bulbs''.

[[File:ARS red onion.jpg|thumb|center|300px|Admired for its ''bulbs''.]]

{{D for Dwarf}}


Some [[ogre]]s like onion plants for their ''layers''. [[Donkey]]s usually prefer cake or parfait.

{{Translation
| dwarven = anön
| elvish = mecifa
| goblin = nubkam
| human = peklod
}}

{{gamedata}}
{{Plants}}

[[Category:Dye sources]]

Butcher

2026-07-22T16:31:14Z

Quietust: /* Detailed butchering yields calculations */ formatting tweaks

{{Quality|Masterwork}}
{{v50_skill
| color = 6:0
| graphic = [[File:farmer_sprite_icon.png]]
| graphicmargin = 106px
| skill = Butcher
| profession = [[Farmer]]
| job name = [[Butchery]]
| tasks =
* Butcher [[animal]]
| workshop =
* [[Butcher's shop]]
| attributes =
* Strength
* Agility
* Endurance
* Kinesthetic Sense
}}
{{av}}
[[File:dwarf_butcher_preview.jpg|thumb|210px|right|When he smells like dead lamb, you know he didn't miss work.]]'''Butchers''' do the dirty job of killing tame animals and processing animal [[corpse]]s, skeletons and body parts for [[meat]], [[fat]], [[skin]], [[bone]]s, [[skull]]s, and many other objects, at the [[Butcher's Shop]].

==Fortress mode==
The work of a butcher is divided into two categories: '''slaughtering''' and '''butchering'''. While both produce the same results (food and raw materials), they have distinctly different inputs - butchering is done on dead wild creatures (and takes a significant amount of time to perform), while slaughtering is done on live tame/trained creatures (and is instantaneous).

Most dwarves do not mind the grim work, but some get an unhappy [[thought]] from it, and a few even feel happy about it. Check the thoughts of a butcher immediately after a creature was slaughtered or butchered. It is a bit of micromanagement to find a dwarf who is "satisfied after slaughtering an animal", but few fortresses can afford wasting possible good thoughts.

=== Slaughtering ===
To slaughter an animal, go to the {{Menu icon|u}} ([[Creatures]]) screen, then the [[Unit_list#Pets.2FLivestock_Tab|Pets/Livestock tab]] and click on [[File:Df steam butcher button.png|The slaughter button]] to flag (or un-flag) for slaughtering. Assuming you have enabled "Slaughter any marked animal" in your [[Standing_orders#Automated_Workshops|standing orders]], a {{DFtext|Slaughter {name of the animal} (Tame)|3:1}} job will be queued to the next available [[Butcher's Shop]]. A butcher will then take the job and walk up to the animal, lead it to the butcher's shop, then strike down the creature. As mentioned above, slaughtering living animals is ''instantaneous'' - the moment the dwarf sets foot in the workshop, the animal dies and its body is split into individual parts. If "No automatic slaughter" is ''enabled'' in standing orders, then nothing at all will happen, since the "slaughter animal" job cannot be added manually. If multiple creatures are flagged for slaughtering, only one slaughter job ''per workshop'' at a time will be created. Only tame/trained creatures can be slaughtered.

=== Butchering ===
If "Automatically butcher carcasses" is enabled in your [[Standing_orders#Automated_Workshops|standing orders]], then any valid corpse located either in a stockpile or within 43 squares of a butcher's shop, will be automatically queued for butchering. During this job, the butcher will pick up the corpse, haul it to the workshop, and then slowly process it into individual parts at a speed based on skill level and [[clutter]] (which can take a long time for particularly large creatures such as [[forgotten beast]]s). If a [[Ambusher|hunter]] successfully kills their target, they will haul the corpse and place it directly inside an appropriate butcher's shop, but unless your butcher happens to be idle at the moment, the corpse will likely be removed from the workshop and placed in a stockpile.

Certain exceptionally [[Size|large]] species of [[vermin]], like [[creepy crawler]]s, can also be butchered for a small amount of meat. Any caught live ones are automatically queued for butchering: a dwarf will carry an [[animal trap]] containing one to a butcher's shop and butcher the vermin inside as if it were a corpse. Only live untamed vermin can be butchered this way, dwarves will not butcher [[tame]] ones or the [[remains]] of one.

Dwarves will not butcher the corpses of sapient creatures (due in part to the {{token|EAT_SAPIENT_OTHER|ethics|UNTHINKABLE}} [[ethics|ethic]]), and the corpses of tame creatures cannot be butchered (they must be slaughtered while still alive).

The type and number of objects produced from butchering a creature varies greatly, since not all creatures have the same parts. See each animal's page for a breakdown of what each animal can produce. Note that while a butcher's shop also has the "Extract from dead animal" task, this requires a certain type of living trapped vermin, and it is not done by a butcher, but by an [[animal dissector]].

==Adventurer mode==
How to butcher in [[adventurer mode]]:

# If the corpse is in your inventory, {{adv menu icon|d}} drop it or equip it by {{adv menu icon|r}} removing it. If the corpse is on the ground, move onto its tile.
# Equip a cutting implement or, alternatively, drop it on your tile. This can be any object with a sharp edge (i.e.has an EDGE attack type), from bladed [[Weapon|weapons]] and [[Tool|tools]], up to [[Bolt|bolts]] and [[Knapper|sharpened rocks]].
# Press {{adv menu icon|x}} to open the action menu. Then select {{k|a}} "Butcher", select the corpse that you want to butcher, pick the tool that you want to use. 

The adventurer will then proceed to butcher the corpse, dropping all of the products on their tile; also note that small animals, like [[raven]]s, cannot be butchered. The tool used for butchery (''as was stated, any object with a sharp edge'') will also be covered in the [[blood]] of the creature being butchered. Ergo, butchering [[Titan|certain]] [[Forgotten beast|creatures]] can have [[Syndrome|fun]] results.

==Effect of skill==
A butcher's skill affects the speed of butchery, which can be important for processing a large number of corpses before they begin to [[rot]]. Note that butcher shops can become [[clutter|cluttered]] quickly, because most animals create a large number of different items of different categories when butchered, so make sure that you have nearby stockpiles for [[refuse]], raw [[skin|hide]]s, [[meat]], prepared organs and [[fat]]. To minimize the amount of [[miasma]] created, in case the rotting parts are not removed fast enough, a butcher's shop should always be blocked by a [[door]].

Of course, placing the butcher's shop outside will prevent any and all miasma generated by rotting, but the dwarves won't haul the inedible parts away unless their global orders allow "Workers gather outdoor refuse" ({{menu icon|y}} -> Standing orders -> Refuse and dumping, second option)

==Troubleshooting==
If your butcher keeps cancelling jobs with "Needs butcherable unrotten nearby item", check the following:

*The corpse isn't rotten
*The corpse is in a stockpile, or within 20 tiles of the butcher shop
*The corpse is large enough for butchering{{bug|0874}}
*The corpse wasn't sapient, tame or trained
*Your butcher can access the corpse and workshop
*The corpse isn't currently tasked for a job (such as hauling to a stockpile)
*The butcher workshop isn't restricted to taking from a stockpile that doesn't contain the corpse

==Butchering sapients==
{{mod}}

In the current version of the game, it isn't possible to butcher sapient creatures due to dwarven ethics forbidding it. In addition, the game is currently programmed to force the player (regardless of race or game mode) to not be able to use the returns of a butchered sapient creature (i.e. you can't eat [[goblin]] meat in adventurer mode, regardless of if you're playing a dwarf or an [[elf]] or an [[alligator man]]){{bug|9171}}. Butchered undead are not subject to this restriction. Discussion on the subject may be found in this [http://www.bay12forums.com/smf/index.php?topic=161408.90 Bay 12 forums thread].

While it is possible to mod ethics to allow the butchering of sapients for the dwarven civilization, ethics itself only plays its role during world generation, meaning you still won't get the option to butcher sapients in actual gameplay. The only way to reliably butcher sapients and use their returns is with the utility [[DFHack]], as demonstrated [http://www.bay12forums.com/smf/index.php?topic=161408.msg7455623#msg7455623 here]. Or you can simply eat the bones if the corpse has rotted away.

==Detailed butchering yields calculations==

Yields are calculated on a per part, per layer basis. Each tissue layer on a part is considered individually, even if multiple layers of the same part are made of the exact same materials. (footnote 1)

Step 1: Get the base volume of the tissue layer

The base volume of a tissue layer is based on what percent of its body part volume it represents (based on the layer's RELATIVE_THICKNESS compared to the RELATIVE_THICKNESS of all other layers), which is based on what percent of the whole body's unmodified base volume (defined with BODY_SIZE) that the part represents (based on the part's RELSIZE compared to the RELSIZE of all other parts).

Only these aspects - the relsizes of body parts, the base body size, and the relative thickness of a tissue layer compared to others on its part - are what are considered at this stage. Things like whether the layer thickens with strength, if the part has size modifiers, etc. aren't factored in here. This is an important thing to note: they have no impact on the relative base volumes of parts in this calculation! (footnote 2)

Even if a layer is now missing (like fat having melted off), its defined relative thickness is still factored in to the calculations - the volume of muscle on a part doesn't suddenly increase because the fat layer is gone or anything like that.

Step 2: Apply modifiers to each tissue layer's base volume to get its modified volume
There are multiple different modifiers that affect the base volume to get the modified volume. Because these modifications happen after relsizes and such have been considered, they don't impact the volume / yields of any of the other layers on its body part, or any other body parts.

Each of these modifiers is applied as a multiplier to the base volume.

=== Body Modifiers ===
The HEIGHT, BROADNESS, and LENGTH of the creature's whole body is used as a modifier. The values for these can be set using the BODY_APPEARANCE_MODIFIER token (whenever these tokens are omitted, the default values are 100).

Modifier = (Body Height / 100) * (Body Broadness / 100) * (Body Length / 100)

=== Body Part Modifiers ===
The HEIGHT, BROADNESS, and LENGTH of the body part are used as a modifier. The values for these can be set using the BP_APPEARANCE_MODIFIER token after selecting the part (whenever these tokens are omitted, the default values are 100).

Modifier = (Part Height / 100) * (Part Broadness / 100) * (Part Length / 100)

Stronk and chonk - THICKENS_ON_STRENGTH and THICKENS_ON_ENERGY_STORAGE

If the tissue has the THICKENS_ON_STRENGTH or THICKENS_ON_ENERGY_STORAGE tokens, modifiers based on the creature's stats are applied.

* If a layer has just THICKENS_ON_STRENGTH, the multiplier is the creature's STRENGTH/1000.
* If a layer has just THICKENS_ON_ENERGY_STORAGE, the multiplier is the creature's fat amount / 250,000. Because a creature's "normal" fat level is 500,000, you'll likely notice adding this token to a tissue will double the yields from that tissue, as that value gives a 2x multiplier.
* If a layer has both THICKENS_ON_STRENGTH and THICKENS_ON_ENERGY_STORAGE, the multiplier is the mean average of the two multipliers combined (so the multiplier is: (Strength/1000 + Fat amount/250,000) / 2). This means that it some cases, you could end up getting lower item yields having both tokens than just having one.

=== Other Modifiers ===
The amount of a layer that's remaining after some of it has been lost does have some impact on its yield volume, however I didn't purposely investigate it. I'd assume that the % of layer that's remaining is used as a modifier. I did test what happens when a layer is fully gone, however - it yields 0 of its item, regardless of the special clauses (see: later).

Step 3: Get the item yields
The number of items yielded from butchering the tissue layer is based on a simple formula (however, there are some special cases that can modify the number of items):

Number of items = Modified volume / 25,000 (rounded down)

In cases where the yield from this calculation is 0, there are two special clauses that can apply, based on the body part's size, and the modified volume of the tissue.

Volume Clause: If the modified volume of a layer is at least 260, any yield of 0 is changed to 1.
Part Size Clause: If the size of the body part that the tissue layer is a part of is at least 260, any yield of 0 is changed to 1. A layer could in practice represent even a tiny fraction of a volume unit, and yet still yield 1 item just because its part is 260 or bigger.

=== Butcher Items ===
What items are actually yielded from butchering a tissue layer is based on the material it's made from. There are some specially-coded cases based on the materials tokens - for example, materials with the MEAT token will yield meat, materials with the BONE token will yield bone. The token BUTCHER_SPECIAL can be used to set the item yield to be any particular item you desire.

The item count isn't at all impacted by the size of the item being produced. If a layer's modified volume is big enough to yield 40 items, it'll yield 40 meat or 40 statues all the same.
Items with standard dimensions (e.g. BARS, THREAD, CLOTH) seem to be produced at those standard dimensions. For example, with a BUTCHER_SPECIAL:THREAD:NONE material that has a modified volume large enough for an item yield of 10, a stack of 10 thread items will be produced, each item being at 15000 dimensions.

=== Extra Butcher Objects/NOMEAT, NOBONES etc. ===
Extra butcher objects don't impact the yields of butchering layers associated with the parts at all. They also don't care if the part they're attached to is big enough to yield at least 1 item if it was butchered regularly. So, an extra butcher object that's attached to a body part whose volume is below 260 will still drop its item, even if butchering the layers on that part might not yield anything.

So how do the creature tokens such as NOMEAT and the like factor into yields for their items? They don't at all. Perhaps the tokens affect fort-mode butchering, or the tokens are depreciated from an old version, or they're not supposed to have anything to do with butchering and handle something like whether entries show up in the stockpiles screen or not.

==Bugs==
*A dead tame animal that was not slaughtered cannot be butchered.{{bug|1180}} This includes tame animals killed due to age, starvation, or combat.
*Butchering returns of sentient creatures are unusable, regardless of the adventurer's ethics.{{bug|9171}}
*Some animals can be too small to be butchered, such as [[buzzard]]s, [[rabbit]]s, and [[barn owl]]s.{{bug|0874}}

==See also==
*[[Meat industry]]

{{Translation
| dwarven = lokast
| elvish = uwale
| goblin = slust
| human = rashcat
}}

{{Skills}}

DF2014:Alchemist

2026-07-22T15:19:48Z

Quietust: Rule T

{{Quality|Exceptional|01:03, 27 August 2014 (UTC)}}
{{Skill
| color = 3:0
| skill = Alchemist
| profession = ?
| job name = [[Alchemy]]
| tasks = None
| attributes =
* Agility
* Analytical Ability
* Creativity
* Intuition
}}
{{av}}

[[File:alchemy_preview.png|thumb|120px|right|View of a non-existent feature.]] The '''alchemist''' [[skill]] does not currently have any use in ''Dwarf Fortress''. It was originally included in the game alongside the [[alchemist's laboratory]] for making [[soap]], a function that has now been taken over by the dedicated [[soaper]]. The alchemist skill and [[alchemy]] [[labor]] have not served any function since version [[40d:Release information/0.28.181.39a|0.28.181.39a]] and have been removed from the visible game, but [[Main:Toady One|Toady One]] has [http://www.bay12games.com/media/df_talk_8_transcript.html shared some thoughts] regarding its use with [[reaction]]s in a future version of the game. This was the final version of Dwarf Fortress in which this skill existed - in version 50.01, all remaining traces of the skill were erased from the game.

Alchemy is unique in being one of the only unused skills that can be switched on and off in the labor menu, along with [[animal care|animal caretaking]]. Because of this, it is frequently used by [[Modding|modders]].

== IRL/Conjecture ==
In the real world, alchemy is a primitive precursor to chemistry, mingling some legitimate material science with a great deal of occultism. Alchemists were preoccupied with, among other things, transmuting metals, creating universal panaceas and solvents, and searching for the ''elixir vitae'' that would grant them immortality. More practically, real-world alchemists discovered [[wikipedia:phosphorus|phosphorus]], perfected [[Still|distillation]], researched [[smelting]] techniques, experimented with [[extracts]], created new [[Healthcare|medicines]], and identified or discovered a wide assortment of acids, salts, and other useful compounds. Some of these basic alchemical processes or products are already present in ''Dwarf Fortress'' to various degrees, but the individual functions fall under different skillsets.

Alchemy as implemented in the game could possibly have to do with [[extract]]s and [[reaction]]s and the creation of healing [[healthcare|medicines]] and military-usable [[syndrome|poison]]s. Transmutation is also possible, but is probably unlikely. Researching new materials and material applications is also a possibility.

{{Skills}}

v0.34:Alchemist

2026-07-22T15:19:34Z

Quietust: Rule T - this doesn't really belong here

{{quality|Exceptional|03:04, 28 June 2013 (UTC)}}{{Skill
| color = 3:0
| skill = Alchemist
| profession = ?
| job name = [[Alchemy]]
| tasks = None
| attributes =
* Agility
* Analytical Ability
* Creativity
* Intuition
}}
{{av}}

The '''alchemist''' [[skill]] does not currently have any use in Dwarf Fortress. It was originally included in the game alongside the [[alchemist's laboratory]] for making [[soap]], a function that has now been taken over by the dedicated [[soaper]]. The alchemist skill and [[alchemy]] [[labor]] have not served any function since version 0.28.181.39a and have been removed from the visible game, but [[Main:Toady One|Toady One]] has [http://www.bay12games.com/media/df_talk_8_transcript.html shared some thoughts] regarding its use with [[reaction]]s in a future version of the game; for now, though, the skill is likely to languish in the background.

Alchemy is unique in being the only unused skill that can be switched on and off in the labor menu. Because of this, it is frequently used by [[Modding|modders]].

== Conjecture ==
In the real world alchemy is a precursor to chemistry, mingling some legitimate material science with a great deal of occultism. Alchemists were preoccupied with, among other things, transmuting metals, creating universal panaceas and solvents, and searching for the elixir vitae that would grant them immortality. More practically, real-world alchemists discovered [[wikipedia:phosphorous|phosphorous]], perfected [[Still|distillation]], researched [[smelting]] techniques, experimented with [[extracts]], created new [[Healthcare|medicines]], and identified or discovered a wide assortment of acids, salts, and other useful compounds. Some of these basic alchemical processes or products are already present in Dwarf Fortress to various degrees, but the individual functions fall under different skillsets.

Alchemy as implemented in the game could possibly have to do with [[extract]]s and [[reaction]]s and the creation of healing [[healthcare|medicines]] and military-usable [[syndrome|poison]]s. Transmutation is also possible, but is probably unlikely. Researching new materials and material applications is also a possibility.

{{Skills}}

Giant

2026-07-22T15:13:57Z

Quietust: reorder references (Jack and the Beanstalk first, Skyrim second), also reword some bits

{{Quality|Superior}}
{{Creaturelookup/0
|image=giant_sprites.png
|portrait=giant_portrait.png
|wiki=Giant (mythology)
|vary=no}}
{{av}}
{{creaturedesc}}
''Not to be confused with the [[giant animal|giant versions of animals]]''

'''Giants''' are massive [[fanciful]] [[creature]]s resembling oversized [[human]]s, and the largest of all [[semi-megabeast]]s. They inhabit [[Lair#Burrow|burrows]] and will attack fortresses once a certain amount of [[wealth]] is accumulated. Female giants are known as ''giantesses''.

When assaulting a fort, giants will [[Building destroyer|destroy building]]s and pummel any [[dwarf]] civilian unlucky enough to get in their path into mush. However, they are less of a threat than the likes of an [[ettin]] or a [[minotaur]], due to lacking their immunity to stunning, and proficiency with [[weapon]]s, respectively. Giants are intelligent creatures but do not naturally possess [[skills]], and also only learn them at half the rate of a civilized creature (unlike any of their semi-megabeast cousins), meaning their only real weapon is generally brute strength. That being said, giants are still the largest of their semi-megabeast kin and should be dispatched accordingly.

Despite their huge size, giants are as vulnerable to a [[cage]] [[trap]] as any other creature. Since they are intelligent, dwarves will not [[Animal trainer|train]] or [[butcher]] them, limiting their use to [[live training]] or decorating the fort by placing them somewhere to your liking.

Beware of giants and other [[semi-megabeast]]s who ''have'' managed to substantially increase their skills, which, by the way, is something no [[megabeast]] is able to do.

Some dwarves [[Preferences|like]] giants for their ''height''.

[[File:giant_preview.jpg|thumb|250px|center|Might have a few inches on you.]]

{{D for Dwarf}}

Contrary to some [[human]] literature, giants in ''Dwarf Fortress'' do ''not'' live at the top of beanstalks.


Giants also do not herd [[Woolly mammoth|mammoths]], nor can they make mammoth [[cheese]]. They also lack the ability to smash their foes a million feet into the air, and their toes cannot be used as [[alchemy]] ingredients.

{{gamedata}}
{{Creatures}}
{{Category|Humanoids}}
{{Category|Semi-megabeasts}}

Plant token

2026-07-21T14:31:26Z

Quietust: /* Grass tokens */

{{Quality|Fine}}
{{av}}
{{Modding}}
The <code>[OBJECT:PLANT]</code> [[token]] begins the definition of a [[plant]] [[raw file]]. Following this, each new plant definition begins with the <code>[PLANT:plant_ID]</code> token, where plant_ID is a unique identifier for the plant, and that plant's properties are then defined using the tokens listed below.

__TOC__
{{clear}}

==Basic tokens==
These tokens are specified for all plants and define their most basic characteristics.

{| {{prettytable}}
|- style='background-color:#ddd'
! width="20%" | Token
! width="20%" | Arguments
! width="60%" | Description

|-
| {{text anchor|NAME}}
|
*name
| The singular form of the plant's name as seen in-game.

|-
| {{text anchor|NAME_PLURAL}}
|
*name
| The plural form of the plant's name as seen in-game.

|-
| {{text anchor|ADJ}}
|
*adjective
| The word or phrase used to describe items made from this plant.

|-
| {{text anchor|ALL_NAMES}}
|
*name
| Sets the NAME, NAME_PLURAL, and ADJ to the specified string.

|-
| {{text anchor|PREFSTRING}}
|
*reason
| What dwarves can like this object for (e.g. "Urist likes plump helmets for their rounded tops.")

|-
| {{text anchor|MATERIAL}}
|
*material_name
| Starts defining a new local plant material with the given name. Must be followed with [[material definition token]]s defining the material's properties. A maximum of 200 materials can be defined on any given plant.

|-
| {{text anchor|USE_MATERIAL}}
|
*material_name
*local_material
| Starts defining a new local plant material with the given name and using the properties of another local plant material. May be followed with material definition tokens to further define its properties or change the properties imported from the local plant material. A maximum of 200 materials can be defined on any given plant.

|-
| {{text anchor|USE_MATERIAL_TEMPLATE}}
|
*material_name
*template_name
| Starts defining a new local plant material with the name ''material_name'' and using the properties of the specified MATERIAL_TEMPLATE with the name ''template_name''. May be followed with material definition tokens to further define its properties or change the properties imported from the template material. A maximum of 200 materials can be defined on any given plant.

|-

| {{text anchor|SELECT_MATERIAL}}{{version|50.13}}
|
*material_name
| Selects a previously defined local plant material for subsequent modification. Unlike with [[creature token]]s, "ALL" ''cannot'' be specified here.

|-
| {{text anchor|BASIC_MAT}}
|
* [[Material token|material]]
| Sets the basic material of the plant. This defines what is harvested when the plant itself, rather than a growth, is picked. According to Toady, you can use other materials (for instance, iron) but the game may hiccup on plants that aren't structurally plants. For crops, said material should have [STRUCTURAL_PLANT_MAT] to permit proper stockpiling. Generally, this should be "LOCAL_PLANT_MAT:material_name", using a material defined using MATERIAL, USE_MATERIAL, or USE_MATERIAL_TEMPLATE. The only way to remove the plant's basic material entry (e.g. "soybean plant") from every stockpile category is to remove this token, but this will cause problems with farming the plant in a farm plot and harvesting the whole wild plant if that's possible.
|}

==Environment tokens==
These tokens, also applicable to all plants, specify where the plants grow.

{| {{prettytable}}
|- style='background-color:#ddd'
! width="20%" | Token
! width="20%" | Arguments
! width="60%" | Description

|-
| {{text anchor|UNDERGROUND_DEPTH}}
|
*minimum
*maximum
| Designates the highest and lowest cavern levels that the plant can appear in if its [[biome token|biome]] is subterranean. Dwarven civilizations will only export (via the embark screen or caravans) things that are available at depth 1. Defaults to 0:0 (surface only).

|-
| {{text anchor|GOOD}}
|
| Restricts the plant to growing in Good regions. Cannot be combined with [EVIL].

|-
| {{text anchor|EVIL}}
|
| Restricts the plant to growing in Evil regions. Cannot be combined with [GOOD].

|-
| {{text anchor|SAVAGE}}
|
| Restricts the plant to growing in Savage regions (regardless of alignment).

|-
| {{text anchor|FREQUENCY}}
|
*freq (0-100)
| How frequently this plant is generated in a particular area. Defaults to 50. Plants with valid [[biome token]]s and [FREQUENCY:0] will not grow in the wild, but will still be available for entity use and farm plots.

|-
| {{text anchor|WET}}
|
| Restricts the plant to growing near natural water features. A plant with [WET] may be very common or very rare in an area, depending on how many water features that area has. Note that they will not grow next to dwarf-filled channels, since it explicitly checks the tile type (e.g. "River", "River Source", "Brook", "Murky Pool", and variants thereof). Combining this with [DRY] causes it to be ignored.

|-
| {{text anchor|DRY}}
|
| Restricts the plant to growing away from natural water features. Combining this with [WET] causes it to be ignored.

|-
| {{text anchor|BIOME}}
|
*biome
| What [[biome token|biome]] this plant appears in.

|}

==Growth tokens==
These tokens are used for all plants, and specify growths growing on a plant. Edible or otherwise usable growths should have [STOCKPILE_PLANT_GROWTH] in their [[material definition token|material definitions]] for proper stockpiling. This also lets them be collected from plant gathering and farming jobs.

{| {{prettytable}}
|- style='background-color:#ddd'
! width="20%" | Token
! width="20%" | Arguments
! width="60%" | Description

|-
| {{text anchor|GROWTH}}
|
*name
| Defines a plant growth, taking the below tokens as arguments.

|-
| {{text anchor|SELECT_GROWTH}}{{version|50.13}}
|
*name
| Selects a previously-defined plant growth. Any tokens which follow this will further modify the selected growth.

|-
| {{text anchor|GROWTH_NAME}}
|
*singular
*plural (STP for standard plural)
| The name of a plant growth.

|-
| {{text anchor|GROWTH_ITEM}}
|
* [[item token]]
* [[material token]]
| Specifies what item this growth is and what it is made of. Generally, the item type should be PLANT_GROWTH:NONE.

If multiple growths point to the same material with [STOCKPILE_PLANT_GROWTH] then only the first will appear correctly in the stockpile menu, with latter growths appearing as "Plant Growth (?)"

|-
| {{text anchor|GROWTH_HOST_TILE}}
|
*plant part
| Specifies on which part of the plant or tree the growth appears, usually for multi-tile [[tree]]s. Valid tokens are:
*TWIGS
*BRANCHES_AND_TWIGS / LIGHT_BRANCHES_AND_TWIGS
*BRANCHES / LIGHT_BRANCHES
*ALL_BRANCHES_AND_TWIGS
*HEAVY_BRANCHES / DIRECTED_BRANCHES
*HEAVY_BRANCHES_AND_TRUNK / DIRECTED_BRANCHES_AND_TRUNK
*TRUNK
*ROOTS
*CAP
*SAPLING

|-
| {{text anchor|GROWTH_TRUNK_HEIGHT_PERC}}
|
*start percent (0-100+)
*end percent (0-100+)
| Controls the height on the trunk between which the growth begins to appear. The first value is the percent of the trunk height where the growth begins appearing: 0 will cause growths to appear starting above the first tile; 100 will cause growths to appear only at the topmost trunk tile. Can be larger than 100 for trees that have growths on branches extending higher than the trunk.

A value of -1 for the second number appears to make the growths extend all the way to the top of the trunk.

|-
| {{text anchor|GROWTH_DENSITY}}
|
*integer
| Currently has no effect.

|-
| {{text anchor|GROWTH_TIMING}}
|
*[[time]] start:end (0-403200)
| Specifies at which part of the year the growth appears. Default is all year round.

A single growth can only have one GROWTH_TIMING tag. If multiple are declared, the last one will be used. To make a growth appear multiple times during the year, you need to create a different growth for every GROWTH_TIMING interval. By using the same material for all of the duplicate growths, all of them will be stockpiled together and be eligible for the same reactions. Edible/brewable growths will have separate entries in the kitchen menu, though.

There is no known way to declare a growth timing that lasts from winter into spring. Including numbers below 0 or above 403200 in the range will make the growth available at all times, as though you hadn't defined a growth timing at all. So will including a range for which the start time is later than the end time.

This has no effect on farmed growths; all eligible growths that have [STOCKPILE_PLANT_GROWTH] in their materials will be harvested, regardless of if they are currently within their growth timing or not.

|-
| {{text anchor|GROWTH_PRINT}}
|
*overworld tile
*item tile
*color
*time (0-403200) start:end, ALL, or NONE
*priority
| Specifies the appearance of the growth. Can be specified more than once, for example for autumn leaves. Transitions between different timing periods will happen gradually over the course of 2000 ticks.

Priority seems to control what to display when there would be multiple symbols on a tile in ASCII mode. A higher number takes priority over a lower number. Example: if a LEAVES growth has a priority of 1 and a FRUIT growth has a priority of 3, the fruit growth will be the symbol shown when it is present.

The GROWTH_PRINT tile will only be displayed when the growth in question is actually present, even if its timing parameter is ALL.

In graphics mode, any growth being displayed will cause the SHRUB graphic to be used, and no growths available will display the SHRUB_PICKED graphic.

|-
| {{text anchor|GROWTH_HAS_SEED}}
|
| The growth drops a seed if eaten raw.

|-
| {{text anchor|GROWTH_DROPS_OFF}}
|
| Growths drop from the plant, producing a cloud of items which fall on the ground, which [[herbalist]]s can collect.
|-
| {{text anchor|GROWTH_DROPS_OFF_NO_CLOUD}}
|
| Growths drop collectable items from the plant without producing item clouds.

|}

==Tree tokens==
These tokens are used only for trees.

{| {{prettytable}}
|- style='background-color:#ddd'
! width="20%" | Token
! width="20%" | Arguments
! width="60%" | Description

|-
| {{text anchor|TREE}}
|
* [[Material token|material]] or NONE
| Makes the plant into a [[tree]]. Cutting down the tree will yield logs made of this material. Setting the material to NONE will give no wood from this tree.

|-
| {{text anchor|TRUNK_NAME}}
|
*name
| What the trunk of the tree is named.

|-
| {{text anchor|MAX_TRUNK_HEIGHT}}
|
*1-8
| The maximum z-level height of a mature tree's trunk, starting from about two z-levels above ground and going up.

|-
| {{text anchor|MAX_TRUNK_DIAMETER}}
|
*1-3
| Upper limit of trunk thickness, in tiles. Counted separately for all branching trunks. Has a geometric effect on log yield.

|-
| {{text anchor|TRUNK_PERIOD}}
|
*integer
| The number of years the trunk takes to grow one Z-level upward.{{verify}}

|-
| {{text anchor|TRUNK_WIDTH_PERIOD}}
|
*integer
| The number of years the trunk takes to grow another tile wider.

|-
| {{text anchor|LIGHT_BRANCHES_NAME}}
|
*name
| What thin branches of the tree are named.

|-
| {{text anchor|BRANCH_DENSITY}} / {{text anchor|LIGHT_BRANCHES_DENSITY}}
|
*integer
| How dense the branches grow on this tree.

|-
| {{text anchor|BRANCH_RADIUS}} / {{text anchor|LIGHT_BRANCH_RADIUS}}
|
*integer
| The radius to which branches can reach. Appears to never reach further than seven tiles from the centre. Does not depend on the trunk branching amount or where trunks are. The values used in the game go from 0-3. Higher values than that can cause crashes. {{bug|10419}}

|-
| {{text anchor|HEAVY_BRANCHES_NAME}} / {{text anchor|DIRECTED_BRANCHES_NAME}}
|
*name
| What thick branches of the tree are named.

|-
| {{text anchor|HEAVY_BRANCH_DENSITY}} / {{text anchor|DIRECTED_BRANCH_DENSITY}}
|
*integer
| Similar to [[Plant_token#BRANCH_DENSITY|BRANCH_DENSITY]] for thick branches.

|-
| {{text anchor|HEAVY_BRANCH_RADIUS}} / {{text anchor|DIRECTED_BRANCH_RADIUS}}
|
*integer
| Similar as [[Plant_token#BRANCH_RADIUS|BRANCH_DENSITY]] for thick branches. Values outside 0-3 can cause crashes. {{bug|10419}}

|-
| {{text anchor|TRUNK_BRANCHING}}
|
*integer
| How much the trunk branches out. 0 makes the trunk straight.

|-
| {{text anchor|ROOT_NAME}} / {{text anchor|ROOTS_NAME}}
|
*name
| What the roots of the tree are named.

|-
| {{text anchor|ROOT_DENSITY}}
|
*integer
| Density of the root growth.

|-
| {{text anchor|ROOT_RADIUS}}
|
*integer
| How wide the roots reach out.

|-
| {{text anchor|TWIGS_NAME}}
|
*name
| What the twigs of the tree are named.

|-
| {{text anchor|TWIGS_SIDE_BRANCHES}}
|
*boolean (0 or 1)
| Twigs appear on the side of branches. Defaults to 1.

|-
| {{text anchor|TWIGS_ABOVE_BRANCHES}}
|
*boolean (0 or 1)
| Twigs appear above branches. Defaults to 1.

|-
| {{text anchor|TWIGS_BELOW_BRANCHES}}
|
*boolean (0 or 1)
| Twigs appear below branches. Defaults to 0.

|-
| {{text anchor|TWIGS_SIDE_HEAVY_BRANCHES}}
|
*boolean (0 or 1)
| Twigs appear on the side of heavy branches. Defaults to 0.

|-
| {{text anchor|TWIGS_ABOVE_HEAVY_BRANCHES}}
|
*boolean (0 or 1)
| Twigs appear above heavy branches. Defaults to 0.

|-
| {{text anchor|TWIGS_BELOW_HEAVY_BRANCHES}}
|
*boolean (0 or 1)
| Twigs appear below heavy branches. Defaults to 0.

|-
| {{text anchor|TWIGS_SIDE_TRUNK}}
|
*boolean (0 or 1)
| Twigs appear on the side of the trunk. Defaults to 0.

|-
| {{text anchor|TWIGS_ABOVE_TRUNK}}
|
*boolean (0 or 1)
| Twigs appear above the trunk. Defaults to 0.

|-
| {{text anchor|TWIGS_BELOW_TRUNK}}
|
*boolean (0 or 1)
| Twigs appear below the trunk. Defaults to 0.

|-
| {{text anchor|TREE_HAS_MUSHROOM_CAP}}
|
| The tree has a rounded cap-hood like a giant mushroom. This severely stunts a tree's maximum height. {{bug|7313}}

|-
| {{text anchor|CAP_NAME}}
|
*name
| What this mushroom-cap is called. Only makes sense with TREE_HAS_MUSHROOM_CAP.

|-
| {{text anchor|CAP_PERIOD}}
|
*integer
| Similar to the other PERIOD tags, influences the rate of the mushroom cap growth. Only makes sense with TREE_HAS_MUSHROOM_CAP.

|-
| {{text anchor|CAP_RADIUS}}
|
*integer
| The radius of a mushroom cap. Only makes sense with TREE_HAS_MUSHROOM_CAP.

|-
| {{text anchor|STANDARD_TILE_NAMES}}
|
| Uses the standard names for the tree components (roots, trunk, branches, etc.)

|-
| {{text anchor|TREE_TILE}}
|
*tile
| The tile used for trees of this type on the world map. Defaults to 24 (↑).

|-
| {{text anchor|DEAD_TREE_TILE}}
|
*tile
| The tile used for (un)dead trees and deciduous trees (generally in winter) of this type. Defaults to 198 (╞).

|-
| {{text anchor|SAPLING_TILE}}
|
*tile
| The tile used for saplings of this tree. Defaults to 231 (τ).

|-
| {{text anchor|DEAD_SAPLING_TILE}}
|
*tile
| The tile used for dead saplings of this tree. Defaults to 231 (τ).

|-
| {{text anchor|TREE_COLOR}}
|
*foreground
*background
*bright
| The [[color]] of the tree on the map. Defaults to 2:0:0 (dark green).

|-
| {{text anchor|DEAD_TREE_COLOR}}
|
*foreground
*background
*bright
| The [[color]] of the tree on the map when (un)dead. Defaults to 0:0:1 (dark gray).

|-
| {{text anchor|SAPLING_COLOR}}
|
*foreground
*background
*bright
| The [[color]] of saplings of this tree. Defaults to 2:0:0 (dark green).

|-
| {{text anchor|DEAD_SAPLING_COLOR}}
|
*foreground
*background
*bright
| The [[color]] of dead saplings of this tree. Defaults to 0:0:1 (dark gray).

|-
| {{text anchor|SAPLING_DROWN_LEVEL}}
|
*depth
| The sapling of this tree will drown once the water on its tile reaches this level. Defaults to 4.

|-
| {{text anchor|TREE_DROWN_LEVEL}}
|
*depth
| The water depth at which this tree will drown. Exact behavior is unknown. Defaults to 7.

|-
| {{text anchor|SAPLING}}
|
| Makes young versions of the tree be called "[tree name] sapling"; otherwise, they are called "young [tree name]".

|}

==Shrub tokens==
These tokens are used for non-grass, non-tree plants.

{| {{prettytable}}
|- style='background-color:#ddd'
! width="20%" | Token
! width="20%" | Arguments
! width="60%" | Description

|-
| {{text anchor|SPRING}}, {{text anchor|SUMMER}}, {{text anchor|AUTUMN}}, {{text anchor|WINTER}}
|
| Allows the plant to grow in farm plots during the given season.

Wild shrubs will die during transitions to seasons which are not specified, but new shrubs will still appear even if they are out of season.{{bug|12940}}

|-
| {{text anchor|GROWDUR}}
|
*time
| How long the plant takes to grow to harvest in a farm plot. Unit hundreds of ticks, See [[Time]]. There are 1008 GROWDUR units in a season. Defaults to 300.

|-
| {{text anchor|VALUE}}
|
*value
| Has no known effect. Previously set the value of the harvested plant.

|-
| {{text anchor|PICKED_TILE}}
|
*tile
| The tile used when the plant is harvested whole, or is ready to be picked from a farm plot. May either be a cp437 tile number, or a character between single quotes. See [[Main:character table|character table]]. Defaults to 231 (τ).

|-
| {{text anchor|DEAD_PICKED_TILE}}
|
*tile
| The tile used when a plant harvested whole has wilted. Defaults to 169 (⌐).

|-
| {{text anchor|SHRUB_TILE}}
|
*tile
| The tile used to represent this plant when it is wild, alive, and has no growths. Defaults to 34 (").

|-
| {{text anchor|DEAD_SHRUB_TILE}}
|
*tile
| The tile used to represent this plant when it is dead in the wild. Defaults to 34 (").

|-
| {{text anchor|CLUSTERSIZE}}
|
*size
| The maximum stack size collected when gathered via herbalism (but ''not'' farm plots). Defaults to 5. CLUSTERSIZE must be greater than or equal to 1+ the number of instances of [STOCKPILE_PLANT_GROWTH] in the plant's raws. For plants like vanilla cabbage, clustersize of 1, which is less than 1+[one instance]=2, will prevent citizens from gathering the plant. Best to set all cluster sizes to 2 or higher for safety.

|-
| {{text anchor|PICKED_COLOR}}
|
*foreground
*background
*bright
| The color of the plant when it has been picked whole, or when it is ready for harvest in a farm plot. Defaults to 2:0:0 (dark green).

|-
| {{text anchor|DEAD_PICKED_COLOR}}
|
*foreground
*background
*bright
| The [[color]] of the plant when it has been picked whole, but has wilted. Defaults to 0:0:1 (dark gray).

|-
| {{text anchor|SHRUB_COLOR}}
|
*foreground
*background
*bright
| The [[color]] of the plant when it is alive, wild, and has no growths. Defaults to 2:0:0 (dark green).

|-
| {{text anchor|DEAD_SHRUB_COLOR}}
|
*foreground
*background
*bright
|The [[color]] of the plant when it is dead in the wild. Defaults to 6:0:0 (brown).

|-
| {{text anchor|SHRUB_DROWN_LEVEL}}
|
*depth
| The shrub will drown once the water on its tile reaches this level. Defaults to 4.

|-
| {{text anchor|DRINK}}
|
* [[Material token|material]]
| Names a [[alcohol|drink]] made from the plant, allowing it to be used in entity resources. Previously also permitted brewing the plant into [[alcohol]] made of this material. Now, a MATERIAL_REACTION_PRODUCT of type DRINK_MAT should be used on the proper plant material.

|-
| {{text anchor|MILL}}
|
* [[Material token|material]]
| Permits milling the plant at a [[quern]] or [[millstone]] into a powder made of this material and allows its use in entity resources. Said material should have [POWDER_MISC_PLANT] to permit proper stockpiling. This token makes the whole plant harvestable regardless of which material is designated for milling. For plants with millable ''growths'', use only MATERIAL_REACTION_PRODUCT or ITEM_REACTION_PRODUCT tokens to define the milling products.

|-
| {{text anchor|THREAD}}
|
* [[Material token|material]]
| Permits processing the plant at a [[farmer's workshop]] to yield threads made of this material and allows its use in entity resources. Said material should have [THREAD_PLANT] to permit proper stockpiling.

|-
| {{text anchor|SEED}}
|
*name
*name_plural
*foreground
*background
*bright
*[[Material token|material]]
| Causes the plant to yield plantable seeds made of this material and having these properties. Said material should have [SEED_MAT] to permit proper stockpiling.

|-
| {{text anchor|EXTRACT_STILL_VIAL}}
|
* [[Material token|material]]
| Permits processing the plant into a [[vial]] at a [[still]] to yield extract made of this material. Said material should have [EXTRACT_STORAGE:FLASK].

|-
| {{text anchor|EXTRACT_VIAL}}
|
*[[Material token|material]]
| Permits processing the plant into a [[vial]] at a [[farmer's workshop]] to yield extract made of this material. Said material should have [EXTRACT_STORAGE:FLASK].

|-
| {{text anchor|EXTRACT_BARREL}}
|
* [[Material token|material]]
| Permits processing the plant into a [[barrel]] at a [[farmer's workshop]] to yield extract made of this material. Said material should have [EXTRACT_STORAGE:BARREL].

|}

==Grass tokens==
These tokens are used only for [[grass]]es.

{| {{prettytable}}
|- style='background-color:#ddd'
! width="20%" | Token
! width="20%" | Arguments
! width="60%" | Description

|-
| {{text anchor|GRASS}}
|
| Makes the plant behave as a type of grass. This allows animals to graze on it, and prevents it and its growths from being picked by herbalists. (Grass growths can still be picked in adventure mode, however.)

|-
| {{text anchor|GRASS_TILES}}
|
*tile
*tile
*tile
*tile
| Specifies the 4 tiles used to represent grass of this type. If VARIED_GROUND_TILES is disabled in [[Settings#Feature_toggles|settings]], these are ignored, always using ".". Defaults to 46:44:96:39 (.,`').

|-
| {{text anchor|ALT_PERIOD}}
|
*period
*offset
| How often the grass switches between its main tiles and alternate tiles. The "period" value determines how quickly (in frames) the grass animates, and the "offset" value specifies how much of that time is spent displaying the alternate tiles. If the "offset" value is greater than or equal to the "period" value, the grass will only display using the alternate tiles.{{verify}} Defaults to 0:0.

|-
| {{text anchor|ALT_GRASS_TILES}}
|
*tile
*tile
*tile
*tile
| When used with ALT_PERIOD, specifies the 4 alternate tiles used to represent grass of this type. Defaults to 46:44:96:39 (.,`'). Dead grass does not animate.

|-
| {{text anchor|GRASS_COLORS}}
|
*color 1 (fore:back:bright)
*color 2 (fore:back:bright)
*dry color (fore:back:bright)
*dead color (fore:back:bright)
| Specifies the color of this grass. Defaults to 2:0:1:2:0:0:6:0:1:6:0:0 (light green, dark green, yellow, brown).
|}

{{Category|Modding}}
{{Category|Tokens}}
[[ru:Plant token]]

Plant token

2026-07-21T14:18:34Z

Quietust: /* Shrub tokens */ this also affects surface shrubs, but you just don't notice because they all look the same

{{Quality|Fine}}
{{av}}
{{Modding}}
The <code>[OBJECT:PLANT]</code> [[token]] begins the definition of a [[plant]] [[raw file]]. Following this, each new plant definition begins with the <code>[PLANT:plant_ID]</code> token, where plant_ID is a unique identifier for the plant, and that plant's properties are then defined using the tokens listed below.

__TOC__
{{clear}}

==Basic tokens==
These tokens are specified for all plants and define their most basic characteristics.

{| {{prettytable}}
|- style='background-color:#ddd'
! width="20%" | Token
! width="20%" | Arguments
! width="60%" | Description

|-
| {{text anchor|NAME}}
|
*name
| The singular form of the plant's name as seen in-game.

|-
| {{text anchor|NAME_PLURAL}}
|
*name
| The plural form of the plant's name as seen in-game.

|-
| {{text anchor|ADJ}}
|
*adjective
| The word or phrase used to describe items made from this plant.

|-
| {{text anchor|ALL_NAMES}}
|
*name
| Sets the NAME, NAME_PLURAL, and ADJ to the specified string.

|-
| {{text anchor|PREFSTRING}}
|
*reason
| What dwarves can like this object for (e.g. "Urist likes plump helmets for their rounded tops.")

|-
| {{text anchor|MATERIAL}}
|
*material_name
| Starts defining a new local plant material with the given name. Must be followed with [[material definition token]]s defining the material's properties. A maximum of 200 materials can be defined on any given plant.

|-
| {{text anchor|USE_MATERIAL}}
|
*material_name
*local_material
| Starts defining a new local plant material with the given name and using the properties of another local plant material. May be followed with material definition tokens to further define its properties or change the properties imported from the local plant material. A maximum of 200 materials can be defined on any given plant.

|-
| {{text anchor|USE_MATERIAL_TEMPLATE}}
|
*material_name
*template_name
| Starts defining a new local plant material with the name ''material_name'' and using the properties of the specified MATERIAL_TEMPLATE with the name ''template_name''. May be followed with material definition tokens to further define its properties or change the properties imported from the template material. A maximum of 200 materials can be defined on any given plant.

|-

| {{text anchor|SELECT_MATERIAL}}{{version|50.13}}
|
*material_name
| Selects a previously defined local plant material for subsequent modification. Unlike with [[creature token]]s, "ALL" ''cannot'' be specified here.

|-
| {{text anchor|BASIC_MAT}}
|
* [[Material token|material]]
| Sets the basic material of the plant. This defines what is harvested when the plant itself, rather than a growth, is picked. According to Toady, you can use other materials (for instance, iron) but the game may hiccup on plants that aren't structurally plants. For crops, said material should have [STRUCTURAL_PLANT_MAT] to permit proper stockpiling. Generally, this should be "LOCAL_PLANT_MAT:material_name", using a material defined using MATERIAL, USE_MATERIAL, or USE_MATERIAL_TEMPLATE. The only way to remove the plant's basic material entry (e.g. "soybean plant") from every stockpile category is to remove this token, but this will cause problems with farming the plant in a farm plot and harvesting the whole wild plant if that's possible.
|}

==Environment tokens==
These tokens, also applicable to all plants, specify where the plants grow.

{| {{prettytable}}
|- style='background-color:#ddd'
! width="20%" | Token
! width="20%" | Arguments
! width="60%" | Description

|-
| {{text anchor|UNDERGROUND_DEPTH}}
|
*minimum
*maximum
| Designates the highest and lowest cavern levels that the plant can appear in if its [[biome token|biome]] is subterranean. Dwarven civilizations will only export (via the embark screen or caravans) things that are available at depth 1. Defaults to 0:0 (surface only).

|-
| {{text anchor|GOOD}}
|
| Restricts the plant to growing in Good regions. Cannot be combined with [EVIL].

|-
| {{text anchor|EVIL}}
|
| Restricts the plant to growing in Evil regions. Cannot be combined with [GOOD].

|-
| {{text anchor|SAVAGE}}
|
| Restricts the plant to growing in Savage regions (regardless of alignment).

|-
| {{text anchor|FREQUENCY}}
|
*freq (0-100)
| How frequently this plant is generated in a particular area. Defaults to 50. Plants with valid [[biome token]]s and [FREQUENCY:0] will not grow in the wild, but will still be available for entity use and farm plots.

|-
| {{text anchor|WET}}
|
| Restricts the plant to growing near natural water features. A plant with [WET] may be very common or very rare in an area, depending on how many water features that area has. Note that they will not grow next to dwarf-filled channels, since it explicitly checks the tile type (e.g. "River", "River Source", "Brook", "Murky Pool", and variants thereof). Combining this with [DRY] causes it to be ignored.

|-
| {{text anchor|DRY}}
|
| Restricts the plant to growing away from natural water features. Combining this with [WET] causes it to be ignored.

|-
| {{text anchor|BIOME}}
|
*biome
| What [[biome token|biome]] this plant appears in.

|}

==Growth tokens==
These tokens are used for all plants, and specify growths growing on a plant. Edible or otherwise usable growths should have [STOCKPILE_PLANT_GROWTH] in their [[material definition token|material definitions]] for proper stockpiling. This also lets them be collected from plant gathering and farming jobs.

{| {{prettytable}}
|- style='background-color:#ddd'
! width="20%" | Token
! width="20%" | Arguments
! width="60%" | Description

|-
| {{text anchor|GROWTH}}
|
*name
| Defines a plant growth, taking the below tokens as arguments.

|-
| {{text anchor|SELECT_GROWTH}}{{version|50.13}}
|
*name
| Selects a previously-defined plant growth. Any tokens which follow this will further modify the selected growth.

|-
| {{text anchor|GROWTH_NAME}}
|
*singular
*plural (STP for standard plural)
| The name of a plant growth.

|-
| {{text anchor|GROWTH_ITEM}}
|
* [[item token]]
* [[material token]]
| Specifies what item this growth is and what it is made of. Generally, the item type should be PLANT_GROWTH:NONE.

If multiple growths point to the same material with [STOCKPILE_PLANT_GROWTH] then only the first will appear correctly in the stockpile menu, with latter growths appearing as "Plant Growth (?)"

|-
| {{text anchor|GROWTH_HOST_TILE}}
|
*plant part
| Specifies on which part of the plant or tree the growth appears, usually for multi-tile [[tree]]s. Valid tokens are:
*TWIGS
*BRANCHES_AND_TWIGS / LIGHT_BRANCHES_AND_TWIGS
*BRANCHES / LIGHT_BRANCHES
*ALL_BRANCHES_AND_TWIGS
*HEAVY_BRANCHES / DIRECTED_BRANCHES
*HEAVY_BRANCHES_AND_TRUNK / DIRECTED_BRANCHES_AND_TRUNK
*TRUNK
*ROOTS
*CAP
*SAPLING

|-
| {{text anchor|GROWTH_TRUNK_HEIGHT_PERC}}
|
*start percent (0-100+)
*end percent (0-100+)
| Controls the height on the trunk between which the growth begins to appear. The first value is the percent of the trunk height where the growth begins appearing: 0 will cause growths to appear starting above the first tile; 100 will cause growths to appear only at the topmost trunk tile. Can be larger than 100 for trees that have growths on branches extending higher than the trunk.

A value of -1 for the second number appears to make the growths extend all the way to the top of the trunk.

|-
| {{text anchor|GROWTH_DENSITY}}
|
*integer
| Currently has no effect.

|-
| {{text anchor|GROWTH_TIMING}}
|
*[[time]] start:end (0-403200)
| Specifies at which part of the year the growth appears. Default is all year round.

A single growth can only have one GROWTH_TIMING tag. If multiple are declared, the last one will be used. To make a growth appear multiple times during the year, you need to create a different growth for every GROWTH_TIMING interval. By using the same material for all of the duplicate growths, all of them will be stockpiled together and be eligible for the same reactions. Edible/brewable growths will have separate entries in the kitchen menu, though.

There is no known way to declare a growth timing that lasts from winter into spring. Including numbers below 0 or above 403200 in the range will make the growth available at all times, as though you hadn't defined a growth timing at all. So will including a range for which the start time is later than the end time.

This has no effect on farmed growths; all eligible growths that have [STOCKPILE_PLANT_GROWTH] in their materials will be harvested, regardless of if they are currently within their growth timing or not.

|-
| {{text anchor|GROWTH_PRINT}}
|
*overworld tile
*item tile
*color
*time (0-403200) start:end, ALL, or NONE
*priority
| Specifies the appearance of the growth. Can be specified more than once, for example for autumn leaves. Transitions between different timing periods will happen gradually over the course of 2000 ticks.

Priority seems to control what to display when there would be multiple symbols on a tile in ASCII mode. A higher number takes priority over a lower number. Example: if a LEAVES growth has a priority of 1 and a FRUIT growth has a priority of 3, the fruit growth will be the symbol shown when it is present.

The GROWTH_PRINT tile will only be displayed when the growth in question is actually present, even if its timing parameter is ALL.

In graphics mode, any growth being displayed will cause the SHRUB graphic to be used, and no growths available will display the SHRUB_PICKED graphic.

|-
| {{text anchor|GROWTH_HAS_SEED}}
|
| The growth drops a seed if eaten raw.

|-
| {{text anchor|GROWTH_DROPS_OFF}}
|
| Growths drop from the plant, producing a cloud of items which fall on the ground, which [[herbalist]]s can collect.
|-
| {{text anchor|GROWTH_DROPS_OFF_NO_CLOUD}}
|
| Growths drop collectable items from the plant without producing item clouds.

|}

==Tree tokens==
These tokens are used only for trees.

{| {{prettytable}}
|- style='background-color:#ddd'
! width="20%" | Token
! width="20%" | Arguments
! width="60%" | Description

|-
| {{text anchor|TREE}}
|
* [[Material token|material]] or NONE
| Makes the plant into a [[tree]]. Cutting down the tree will yield logs made of this material. Setting the material to NONE will give no wood from this tree.

|-
| {{text anchor|TRUNK_NAME}}
|
*name
| What the trunk of the tree is named.

|-
| {{text anchor|MAX_TRUNK_HEIGHT}}
|
*1-8
| The maximum z-level height of a mature tree's trunk, starting from about two z-levels above ground and going up.

|-
| {{text anchor|MAX_TRUNK_DIAMETER}}
|
*1-3
| Upper limit of trunk thickness, in tiles. Counted separately for all branching trunks. Has a geometric effect on log yield.

|-
| {{text anchor|TRUNK_PERIOD}}
|
*integer
| The number of years the trunk takes to grow one Z-level upward.{{verify}}

|-
| {{text anchor|TRUNK_WIDTH_PERIOD}}
|
*integer
| The number of years the trunk takes to grow another tile wider.

|-
| {{text anchor|LIGHT_BRANCHES_NAME}}
|
*name
| What thin branches of the tree are named.

|-
| {{text anchor|BRANCH_DENSITY}} / {{text anchor|LIGHT_BRANCHES_DENSITY}}
|
*integer
| How dense the branches grow on this tree.

|-
| {{text anchor|BRANCH_RADIUS}} / {{text anchor|LIGHT_BRANCH_RADIUS}}
|
*integer
| The radius to which branches can reach. Appears to never reach further than seven tiles from the centre. Does not depend on the trunk branching amount or where trunks are. The values used in the game go from 0-3. Higher values than that can cause crashes. {{bug|10419}}

|-
| {{text anchor|HEAVY_BRANCHES_NAME}} / {{text anchor|DIRECTED_BRANCHES_NAME}}
|
*name
| What thick branches of the tree are named.

|-
| {{text anchor|HEAVY_BRANCH_DENSITY}} / {{text anchor|DIRECTED_BRANCH_DENSITY}}
|
*integer
| Similar to [[Plant_token#BRANCH_DENSITY|BRANCH_DENSITY]] for thick branches.

|-
| {{text anchor|HEAVY_BRANCH_RADIUS}} / {{text anchor|DIRECTED_BRANCH_RADIUS}}
|
*integer
| Similar as [[Plant_token#BRANCH_RADIUS|BRANCH_DENSITY]] for thick branches. Values outside 0-3 can cause crashes. {{bug|10419}}

|-
| {{text anchor|TRUNK_BRANCHING}}
|
*integer
| How much the trunk branches out. 0 makes the trunk straight.

|-
| {{text anchor|ROOT_NAME}} / {{text anchor|ROOTS_NAME}}
|
*name
| What the roots of the tree are named.

|-
| {{text anchor|ROOT_DENSITY}}
|
*integer
| Density of the root growth.

|-
| {{text anchor|ROOT_RADIUS}}
|
*integer
| How wide the roots reach out.

|-
| {{text anchor|TWIGS_NAME}}
|
*name
| What the twigs of the tree are named.

|-
| {{text anchor|TWIGS_SIDE_BRANCHES}}
|
*boolean (0 or 1)
| Twigs appear on the side of branches. Defaults to 1.

|-
| {{text anchor|TWIGS_ABOVE_BRANCHES}}
|
*boolean (0 or 1)
| Twigs appear above branches. Defaults to 1.

|-
| {{text anchor|TWIGS_BELOW_BRANCHES}}
|
*boolean (0 or 1)
| Twigs appear below branches. Defaults to 0.

|-
| {{text anchor|TWIGS_SIDE_HEAVY_BRANCHES}}
|
*boolean (0 or 1)
| Twigs appear on the side of heavy branches. Defaults to 0.

|-
| {{text anchor|TWIGS_ABOVE_HEAVY_BRANCHES}}
|
*boolean (0 or 1)
| Twigs appear above heavy branches. Defaults to 0.

|-
| {{text anchor|TWIGS_BELOW_HEAVY_BRANCHES}}
|
*boolean (0 or 1)
| Twigs appear below heavy branches. Defaults to 0.

|-
| {{text anchor|TWIGS_SIDE_TRUNK}}
|
*boolean (0 or 1)
| Twigs appear on the side of the trunk. Defaults to 0.

|-
| {{text anchor|TWIGS_ABOVE_TRUNK}}
|
*boolean (0 or 1)
| Twigs appear above the trunk. Defaults to 0.

|-
| {{text anchor|TWIGS_BELOW_TRUNK}}
|
*boolean (0 or 1)
| Twigs appear below the trunk. Defaults to 0.

|-
| {{text anchor|TREE_HAS_MUSHROOM_CAP}}
|
| The tree has a rounded cap-hood like a giant mushroom. This severely stunts a tree's maximum height. {{bug|7313}}

|-
| {{text anchor|CAP_NAME}}
|
*name
| What this mushroom-cap is called. Only makes sense with TREE_HAS_MUSHROOM_CAP.

|-
| {{text anchor|CAP_PERIOD}}
|
*integer
| Similar to the other PERIOD tags, influences the rate of the mushroom cap growth. Only makes sense with TREE_HAS_MUSHROOM_CAP.

|-
| {{text anchor|CAP_RADIUS}}
|
*integer
| The radius of a mushroom cap. Only makes sense with TREE_HAS_MUSHROOM_CAP.

|-
| {{text anchor|STANDARD_TILE_NAMES}}
|
| Uses the standard names for the tree components (roots, trunk, branches, etc.)

|-
| {{text anchor|TREE_TILE}}
|
*tile
| The tile used for trees of this type on the world map. Defaults to 24 (↑).

|-
| {{text anchor|DEAD_TREE_TILE}}
|
*tile
| The tile used for (un)dead trees and deciduous trees (generally in winter) of this type. Defaults to 198 (╞).

|-
| {{text anchor|SAPLING_TILE}}
|
*tile
| The tile used for saplings of this tree. Defaults to 231 (τ).

|-
| {{text anchor|DEAD_SAPLING_TILE}}
|
*tile
| The tile used for dead saplings of this tree. Defaults to 231 (τ).

|-
| {{text anchor|TREE_COLOR}}
|
*foreground
*background
*bright
| The [[color]] of the tree on the map. Defaults to 2:0:0 (dark green).

|-
| {{text anchor|DEAD_TREE_COLOR}}
|
*foreground
*background
*bright
| The [[color]] of the tree on the map when (un)dead. Defaults to 0:0:1 (dark gray).

|-
| {{text anchor|SAPLING_COLOR}}
|
*foreground
*background
*bright
| The [[color]] of saplings of this tree. Defaults to 2:0:0 (dark green).

|-
| {{text anchor|DEAD_SAPLING_COLOR}}
|
*foreground
*background
*bright
| The [[color]] of dead saplings of this tree. Defaults to 0:0:1 (dark gray).

|-
| {{text anchor|SAPLING_DROWN_LEVEL}}
|
*depth
| The sapling of this tree will drown once the water on its tile reaches this level. Defaults to 4.

|-
| {{text anchor|TREE_DROWN_LEVEL}}
|
*depth
| The water depth at which this tree will drown. Exact behavior is unknown. Defaults to 7.

|-
| {{text anchor|SAPLING}}
|
| Makes young versions of the tree be called "[tree name] sapling"; otherwise, they are called "young [tree name]".

|}

==Shrub tokens==
These tokens are used for non-grass, non-tree plants.

{| {{prettytable}}
|- style='background-color:#ddd'
! width="20%" | Token
! width="20%" | Arguments
! width="60%" | Description

|-
| {{text anchor|SPRING}}, {{text anchor|SUMMER}}, {{text anchor|AUTUMN}}, {{text anchor|WINTER}}
|
| Allows the plant to grow in farm plots during the given season.

Wild shrubs will die during transitions to seasons which are not specified, but new shrubs will still appear even if they are out of season.{{bug|12940}}

|-
| {{text anchor|GROWDUR}}
|
*time
| How long the plant takes to grow to harvest in a farm plot. Unit hundreds of ticks, See [[Time]]. There are 1008 GROWDUR units in a season. Defaults to 300.

|-
| {{text anchor|VALUE}}
|
*value
| Has no known effect. Previously set the value of the harvested plant.

|-
| {{text anchor|PICKED_TILE}}
|
*tile
| The tile used when the plant is harvested whole, or is ready to be picked from a farm plot. May either be a cp437 tile number, or a character between single quotes. See [[Main:character table|character table]]. Defaults to 231 (τ).

|-
| {{text anchor|DEAD_PICKED_TILE}}
|
*tile
| The tile used when a plant harvested whole has wilted. Defaults to 169 (⌐).

|-
| {{text anchor|SHRUB_TILE}}
|
*tile
| The tile used to represent this plant when it is wild, alive, and has no growths. Defaults to 34 (").

|-
| {{text anchor|DEAD_SHRUB_TILE}}
|
*tile
| The tile used to represent this plant when it is dead in the wild. Defaults to 34 (").

|-
| {{text anchor|CLUSTERSIZE}}
|
*size
| The maximum stack size collected when gathered via herbalism (but ''not'' farm plots). Defaults to 5. CLUSTERSIZE must be greater than or equal to 1+ the number of instances of [STOCKPILE_PLANT_GROWTH] in the plant's raws. For plants like vanilla cabbage, clustersize of 1, which is less than 1+[one instance]=2, will prevent citizens from gathering the plant. Best to set all cluster sizes to 2 or higher for safety.

|-
| {{text anchor|PICKED_COLOR}}
|
*foreground
*background
*bright
| The color of the plant when it has been picked whole, or when it is ready for harvest in a farm plot. Defaults to 2:0:0 (dark green).

|-
| {{text anchor|DEAD_PICKED_COLOR}}
|
*foreground
*background
*bright
| The [[color]] of the plant when it has been picked whole, but has wilted. Defaults to 0:0:1 (dark gray).

|-
| {{text anchor|SHRUB_COLOR}}
|
*foreground
*background
*bright
| The [[color]] of the plant when it is alive, wild, and has no growths. Defaults to 2:0:0 (dark green).

|-
| {{text anchor|DEAD_SHRUB_COLOR}}
|
*foreground
*background
*bright
|The [[color]] of the plant when it is dead in the wild. Defaults to 6:0:0 (brown).

|-
| {{text anchor|SHRUB_DROWN_LEVEL}}
|
*depth
| The shrub will drown once the water on its tile reaches this level. Defaults to 4.

|-
| {{text anchor|DRINK}}
|
* [[Material token|material]]
| Names a [[alcohol|drink]] made from the plant, allowing it to be used in entity resources. Previously also permitted brewing the plant into [[alcohol]] made of this material. Now, a MATERIAL_REACTION_PRODUCT of type DRINK_MAT should be used on the proper plant material.

|-
| {{text anchor|MILL}}
|
* [[Material token|material]]
| Permits milling the plant at a [[quern]] or [[millstone]] into a powder made of this material and allows its use in entity resources. Said material should have [POWDER_MISC_PLANT] to permit proper stockpiling. This token makes the whole plant harvestable regardless of which material is designated for milling. For plants with millable ''growths'', use only MATERIAL_REACTION_PRODUCT or ITEM_REACTION_PRODUCT tokens to define the milling products.

|-
| {{text anchor|THREAD}}
|
* [[Material token|material]]
| Permits processing the plant at a [[farmer's workshop]] to yield threads made of this material and allows its use in entity resources. Said material should have [THREAD_PLANT] to permit proper stockpiling.

|-
| {{text anchor|SEED}}
|
*name
*name_plural
*foreground
*background
*bright
*[[Material token|material]]
| Causes the plant to yield plantable seeds made of this material and having these properties. Said material should have [SEED_MAT] to permit proper stockpiling.

|-
| {{text anchor|EXTRACT_STILL_VIAL}}
|
* [[Material token|material]]
| Permits processing the plant into a [[vial]] at a [[still]] to yield extract made of this material. Said material should have [EXTRACT_STORAGE:FLASK].

|-
| {{text anchor|EXTRACT_VIAL}}
|
*[[Material token|material]]
| Permits processing the plant into a [[vial]] at a [[farmer's workshop]] to yield extract made of this material. Said material should have [EXTRACT_STORAGE:FLASK].

|-
| {{text anchor|EXTRACT_BARREL}}
|
* [[Material token|material]]
| Permits processing the plant into a [[barrel]] at a [[farmer's workshop]] to yield extract made of this material. Said material should have [EXTRACT_STORAGE:BARREL].

|}

==Grass tokens==
These tokens are used only for [[grass]]es.

{| {{prettytable}}
|- style='background-color:#ddd'
! width="20%" | Token
! width="20%" | Arguments
! width="60%" | Description

|-
| {{text anchor|GRASS}}
|
| Makes the plant behave as a type of grass. This allows animals to graze on it, and prevents it and its growths from being picked by herbalists. (Grass growths can still be picked in adventure mode, however.)

|-
| {{text anchor|GRASS_TILES}}
|
*tile
*tile
*tile
*tile
| Specifies the 4 tiles used to represent grass of this type. If VARIED_GROUND_TILES is disabled in [[Settings#Feature_toggles|settings]], these are ignored. Defaults to 46:44:96:39 (.,`').

|-
| {{text anchor|ALT_PERIOD}}
|
*period
*offset
| How often the grass switches between its main tiles and alternate tiles. The "period" value determines how quickly (in frames) the grass animates, and the "offset" value specifies how much of that time is spent displaying the alternate tiles. If the "offset" value is greater than or equal to the "period" value, the grass will only display using the alternate tiles.{{verify}} Defaults to 0:0.

|-
| {{text anchor|ALT_GRASS_TILES}}
|
*tile
*tile
*tile
*tile
| When used with ALT_PERIOD, specifies the 4 alternate tiles used to represent grass of this type. Defaults to 46:44:96:39 (.,`'). Dead grass does not animate.

|-
| {{text anchor|GRASS_COLORS}}
|
*color 1 (fore:back:bright)
*color 2 (fore:back:bright)
*dry color (fore:back:bright)
*dead color (fore:back:bright)
| Specifies the color of this grass. Defaults to 2:0:1:2:0:0:6:0:1:6:0:0 (light green, dark green, yellow, brown).
|}

{{Category|Modding}}
{{Category|Tokens}}
[[ru:Plant token]]

Therizinosaurus

2026-07-21T13:18:43Z

Quietust: fix capitalization, and move punctuation outside of the link

{{Quality|Tattered}}
{{Creaturelookup/0
|image=therizinosaurus_sprites.png
|portrait=therizinosaurus_portrait_anim.gif}}
{{av}}
{{creaturedesc}}
[[Therizinosaurus]] is a large, extinct herbivorous dinosaur from the [https://en.wikipedia.org/wiki/Cretaceous Cretaceous] period. It is characterized by [[feather|feathers]], a beaked mouth and three claws on each hand, which are mostly used for foraging but nevertheless can be used to skewer an unsuspecting dwarf. As with all real-world extinct creatures, they must be enabled during world creation to appear. A baby Therizinosaurus is called a hatchling.

When captured and tamed, they can be a good option for your [[meat industry]] due to their large mass and clutch size. As an added (but not very impactful) bonus, butchering one will reward you with a [[gizzard stone]].

Some dwarves [[Like|like]] Therizinosaurus for their ''giant claws'' and their ''feathers''

{{D for Dwarf}}

When tamed, its primary use is to tickle enemies. Tickling enemies immobilizes them for 20 seconds, then they are killed.


It's been rumoured that Therizinosaurus are (for whatever strange reason) innately hostile towards [[deer]] and will kill them on sight without provocation, but further observation is needed to confirm this.

{{gamedata}}
{{Creatures}}

Talk:Clay

2026-07-19T22:07:30Z

Quietust:

May want confirmation that clay can no longer be used for the stone polishing job, whether by workshop, order, or linked stockpile in v50

Collected clay can be used as floor, wall, and track (and likely other uses that I haven't tried / noticed), so the end of the article is incorrect regarding this (in v50).
:It looks like clay can only be used as a building material if it was naturally present at your embark region - if you use special methods (possibly involving DFHack) to ''give'' yourself clay boulders, then they will '''not''' be usable because they'll be considered "economic stone" and the Stone Restriction menu doesn't allow you to toggle that status for Clay types. --[[User:Quietust|Quietust]] ([[User talk:Quietust|talk]]) 22:07, 19 July 2026 (UTC)

Table

2026-07-18T11:58:56Z

Quietust: There are FIVE different personality checks - low gregariousness checks DECORUM and BASHFUL to choose between feeling embarrassment or irritation, while high gregariousness checks CHEER_PROPENSITY and ORDERLINESS to choose between feeling irritation, amusement, or jolliness

{{Quality|Superior}}
{{av}}

{{V50_furniture
|graphic=[[File:Table_Premium.png]]
|name=Table
|tile=╤
|wood=y
|stonecarve=y
|metal=y
|bars=3
|glass=y
|rooms=
* [[dining room|Dining Room]]
* [[meeting hall|Meeting Hall]]
|value=10
|size=30,000
}}

A '''table''' is a piece of [[furniture]] necessary for [[dwarf|dwarves]] to eat [[food]] in comfort. A table is also needed to define a [[dining room]] and serve as an operating surface in a [[hospital]]. Tables are also a component to build [[traction bench]]es.

Tables can be created from one [[wood]] log at a [[Carpenter's workshop]], one [[stone]] at a [[Mason's workshop]], three metal [[bar]]s at a [[Metalsmith's forge]], or one bag of [[sand]] at a [[Glass furnace]].

=== Dining ===
A table cannot be used without a chair, and a chair without a table is insufficient for avoiding a negative thought for "ate with no table".

If more than one chair is placed around a single table, other dwarves ''will'' sit down to eat but will receive [[thought]]s for "eating at a crowded table". Their reaction, positive or negative, depends on their [[Personality facet#GREGARIOUSNESS|gregariousness]], [[Personality facet#BASHFUL|bashfulness]], [[Personality facet#CHEER_PROPENSITY|cheerfulness]], [[Personality facet#ORDERLINESS|orderliness]], and [[Personality value#DECORUM|decorum]]. There is no corresponding thought for eating alone, so building tables with only one chair prevents potential [[stress]].

Dwarves primarily use tables to eat [[food]], avoiding the negative [[thought]] for eating without a proper table. Since dwarves first try to sit down and only then check whether there's a table to put their food on, the proper placement of chairs is more important for proper dining. Tables without an adjacent chair will simply not be used for eating; if two tables are adjacent to a single chair, one will go unused. Chairs without adjacent tables, however, will cause unhappy thoughts whenever dwarves sit on them to eat, and a single table with multiple adjacent chairs can also lead to unhappy thoughts if two dwarves sit on the chairs: only one can put their food on the table, the other will have to eat from their lap and will complain about having no table.

An unassigned [[dining room]] will be used by any dwarves without an assigned dining room, resulting in positive [[thought]]s scaled to the [[Zone#Quality_and_value|quality]] of the dining room. Creating a high-value dining room is one of the easiest ways to give your dwarves a happy thought. Note, however, that dwarves with a table (or chair) in their [[quarters]] may opt to eat there instead, so it is generally best to only to do so when [[Noble#Needs|required]] by [[noble]]s.

=== Other uses ===
In a [[hospital]] zone, tables are used during [[surgery]] as an operating surface. Multiple dwarves can be operated on at the same time on one table ''(this may be a bug).''

Tables are also used as an input, along with [[mechanism]] and [[rope]]s, at the [[Mechanic's workshop]] to make a [[traction bench]]. The quality of each component is not reflected in the quality of the traction bench, and only the material of the table is used as the material for the bench.

{{D for Dwarf}}

A [[noble]] might [[demand]] a [[glass]] table, so they can watch themselves while they are [[eating]].

{{Buildings}}
{{Category|Furniture}}

Velociraptor

2026-07-17T14:54:58Z

Quietust: please tag your references - not everybody knows where they came from

{{Quality|Tattered}}
{{Creaturelookup/0
|image=velociraptor_sprites.png
|portrait=velociraptor_portrait_anim.gif}}
{{av}}
{{creaturedesc}}

The [[Velociraptor]] is a small, extinct carnivorous dinosaur from the [[wikipedia:Cretaceous|Cretaceous]] period. It is found in savage tropical shrublands, badlands and rocky wastelands.
As with all real-world extinct creatures, they must be endabled during world creation to spawn. Velociraptors, unlike what some humans might try to convince you, have feathers. Baby Velociraptors are known as ''hatchlings''.

Velociraptors can do serious damage to dwarves, but are far from [[Giant kea|a fort-ending threat]]. Some might concider them as an alternative to chickens and turkeys due to their large clutch size, though they must beware of the [[catsplosion|dinosplosion]] that might ensue.

Some [[Dwarf|dwarves]] [[Preferences|like]] velociraptors for their ''scything claws'', their ''speed'' and their ''feathers''.

{{D for Dwarf}}
[[Cat]]s of royal lineage have been known to adopt these creatures as pets.


[[Human]] legends mention them possessing the ability to open doors to catch hiding prey. However, this has never been observed by [[Dwarf|dwarven]] scholars, and remains nothing more than a [[rumor]]. Many believe they encountered a [[velociraptor man]], instead.

{{gamedata}}
{{Creatures}}

Creature token

2026-07-17T11:47:47Z

Quietust: checked disassembly, and it still has the same effect as [SKILL_LEARN_RATES:50] in addition to setting the "SLOW_LEARNER" flag (but *not* CAN_LEARN)

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

The <code>[OBJECT:CREATURE]</code> [[token]] begins the definition of a ''Dwarf Fortress'' [[creature]] [[raw file]]. Each creature definition that follows begins with the {{token|creature|c|creature ID}} token, and the creature's exact properties and behavior are then specified by the use of further creature tokens. All known creature tokens are listed below.

Vanilla creature definitions can be found in <code>[[Game folder|<Dwarf Fortress>]]\data\vanilla\vanilla_creatures\</code>.
Creature ID is also used with [[graphics token]]s to make customizable [[graphics set]]s.

The [[caste]] tokens allow defining sub-species within the broader creature definition, including true biological castes and lesser variations, such as sexes. Creature tokens can either be 'Creature' or 'CASTE-only' type which can only be applied to creature or caste respectively, or 'CASTE' which can be applied to both. In the table bellow, creature type distinguishes tokens that can be applied to creature only, caste only, and both ('creature', 'CASTE-only', and 'CASTE' respectively)

__NOTOC__
{{clear}}
{{alphabetical TOC|style=margin: 1em auto;}}

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

|-
| {{text anchor|ADOPTS_OWNER}}
| Caste
|
| Prevents the tamed creature from being made available for adoption, instead allowing it to automatically adopt whoever it wants. The basic requirements for adoption are intact, and the creature will only adopt individuals who have a [[preference]] for their species. Used by [[cat]]s in the vanilla game. When {{k|v}}iewing a tame creature with this token, the message "This animal isn't interested in your wishes" will appear instead of "This [adorable] animal can't work" or "This animal is waiting to be trained".

|-
| {{text anchor|ALCOHOL_DEPENDENT}}
| Caste
|
| Makes the creature need [[alcohol]] to get through the working day; it will choose to drink booze instead of [[water]] if possible. Going sober for too long reduces speed.

|-
| {{text anchor|ALL_ACTIVE}}
| Caste
|
| When set, the creature will appear at any time of day. Overrides {{token|DIURNAL|c}}, {{token|NOCTURNAL|c}}, {{token|CREPUSCULAR|c}}, {{token|MATUTINAL|c}}, and {{token|VESPERTINE|c}}.

|-
| {{text anchor|ALTTILE}}
| Creature
|
*'character' or tile number
| If set, the creature will blink between its {{token|TILE|c}} and its ALTTILE.

|-
| {{text anchor|AMBUSHPREDATOR}}
| Caste
|
| Makes the creature start out hidden and remain near its original location until its prey draws near. When combined with {{token|WEBBER|c}}, causes them to lay gigantic webs near their spawn location, though only for creatures present during embark.

|-
| {{text anchor|AMPHIBIOUS}}
| Caste
|
| Allows a creature to breathe both in and out of [[water]] (unlike {{token|AQUATIC|c}}) - does not prevent drowning in [[magma]].

|-
| {{text anchor|APP_MOD_DESC_RANGE}}
| Appearance Modifier
|
*Range (6 values, low to high)
| Based on info from [http://www.bay12forums.com/smf/index.php?topic=113762.msg3473069#msg3473069 Wannabehero on the forums]: When used with an appearance modifier token (BP_APPEARANCE_MODIFIER or BODY_APPEARANCE_MODIFIER), tells the game what numeric ranges to map to which descriptors.

The game uses 7 descriptor levels for each modifier, with the center one generally being to omit the thing from the creature description entirely. The six values in APP_MOD_DESC_RANGE define the boundaries between each described range. If this is not specified it uses the numbers 10:50:95:105:150:190.

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

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

|-
| {{text anchor|APP_MOD_NOUN}}
| Appearance Modifier
|
*noun
*SINGULAR or PLURAL
| Creates a noun for the appearance, and whether it is singular or plural.

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

|-
| {{text anchor|APPLY_CREATURE_VARIATION}}
| Caste
|
*creature variation ID
*(optional) any amount of arbitrary arguments
| Applies the specified [[creature variation token|creature variation]]. See [[Creature_variation_token#Arguments_and_conditional_tokens]] for how the subsequent arguments may be used.

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

|-
| {{text anchor|AQUATIC}}
| Caste
|
| Enables the creature to breathe in water, but causes it to air-drown on dry land.

|-
| {{text anchor|ARENA_RESTRICTED}}
| Caste
|
| Causes the creature to be excluded from the [[object testing arena]]'s creature spawning list. Typically applied to spoileriffic creatures.

|-
| {{text anchor|ARTIFICIAL_HIVEABLE}}
| Creature
|
| Enables the creature to be kept in artificial [[hive]]s by [[beekeeper]]s.

|-
| {{text anchor|AT_PEACE_WITH_WILDLIFE}}
| Caste
|
| Prevents the creature from attacking or frightening creatures with the {{Token|NATURAL|c}} tag.

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

|-
| {{text anchor|ATTACK_TRIGGER}}
| Caste
|
*population
*exported wealth
*created wealth
| Specifies when a [[megabeast]] or [[semi-megabeast]] will attack the fortress. The attacks will start occurring when all of the requirements are met. Setting a value to 0 disables the trigger.

|}

{{alphabetical TOC|style=margin: 1em auto;}}

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

|-
| {{text anchor|BABY}}
| Caste
|
*integer
| Age at which creature is considered a child, the default is zero. One can think of this as the duration of the baby stage.

|-
| {{text anchor|BABYNAME}}
| Caste
|
*singular
*plural
| Defines a new name for a creature in baby state at the caste level. For non-caste-specific baby names, see {{token|GENERAL_BABY_NAME|c}}.

|-
| {{text anchor|BEACH_FREQUENCY}}
| Caste
|
*integer
| Creature may be subject to [[beaching]], becoming stranded on [[Beach|shores]], where they will eventually air-drown. The number indicates the frequency of the occurrence. Presumably requires the creature to be {{token|AQUATIC|c}}. Used by [[orca]]s, [[sperm whale]]s and [[sea nettle jellyfish]] in the vanilla game.

|-
| {{text anchor|BENIGN}}
| Caste
|
| The creature is non-aggressive by default, and will never automatically be engaged by companions or soldiers, running away from any creatures that are not friendly to it, and will only defend itself if it becomes enraged. Can be thought of as the counterpoint of the {{token|LARGE_PREDATOR|c}} tag. When tamed, animals with this tag will be useless for fortress defense.

This and {{token|TRADE_CAPACITY|c}} are required for {{token|PACK_ANIMAL|c}} to function properly, if an animal contains the aforementioned requirements without this tag: items loaded by the merchants will be dropped upon departure.

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

|-
| {{text anchor|BLOOD}}
| Caste
|
* <[[material token]]>
* <[[Material_definition_token#Material_States|material state]]>
| Specifies what the creature's blood is made of.

|-
| {{text anchor|BLOODSUCKER}}
| Caste
|
| Causes [[vampire]]-like behaviour; the creature will suck the [[Creature_token#BLOOD|blood]] of unconscious victims when its [[Syndrome#TIME_SINCE_SUCKED_BLOOD|thirst for blood]] grows sufficiently large. When controlling the creature in adventure mode, this can be done at will. Seems to be required to make the creature denouncable (in-world) as a creature of the night.

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

The body parts need to be listed in an order such that any parent part appears before its connected children. For example [BODY:HEART:BODY_WITH_HEAD_FLAG] produces a "Body Token Recognized But Could Not Connect: HEART" error because HEART can't find any UPPERBODY(s) to connect to. Switching the order to [BODY:BODY_WITH_HEAD_FLAG:HEART] fixes the problem because now the UPPERBODY is created before the HEART tries to connect to it.

'''If the body is left undefined, the creature (or caste) will be tagged as [DOES_NOT_EXIST].''' {{verify}}

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

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

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

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

|-
| {{text anchor|BONECARN}}
| Caste
|
| Creature eats bones. Implies {{token|CARNIVORE|c}}. Currently does not work due to a bug ({{Bug|11069}}).

|-
| {{text anchor|BP_ADD_TYPE}}
| Caste
|
| Adds a type to a body part - used with {{token|SET_BP_GROUP|c}}. In vanilla DF, this is used for adding the type '[[Body token#GELDABLE|GELDABLE]]' to the lower body of certain [[cat|creatures]].

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

|-
| {{text anchor|BP_REMOVE_TYPE}}
| Caste
|
| Removes a type from a body part. Used with {{token|SET_BP_GROUP|c}}.

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

{{alphabetical TOC|style=margin: 1em auto;}}

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

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

|-
| {{text anchor|CAN_LEARN}}
| Caste
|
| The creature gains [[skill]]s and can have [[labor|professions]]. If a member of a civilization (even a pet) has this token, it'll need to eat, drink and sleep. Note that this token makes the creature unable to be eaten 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. A creature with at least this token or the {{token|CAN_SPEAK|c}} token will be able to have [[Personality value|values]] and [[Personality goal|goals]].

|-
| {{text anchor|CAN_SPEAK}}
| Caste
|
| Can [[talking|talk]]. Note that this is not necessary for a creature to gain social skills but to make friends in fortress mode. A creature with at least this token or the {{token|CAN_LEARN|c}} token will be able to have [[Personality value|values]] and [[Personality goal|goals]].

|-
| {{text anchor|CANNOT_CLIMB}}
| Caste
|
| Creature cannot [[climber|climb]], even if it has free grasp parts.

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

|-
| {{text anchor|CANNOT_UNDEAD}}
| Caste
|
| Acts like {{token|NOT_LIVING|c}}, except that {{token|OPPOSED_TO_LIFE|c}} creatures will attack them.

|-
| {{text anchor|CANOPENDOORS}}
| Caste
|
| Defunct, as doors cannot be set as tightly closed anymore.

|-
| {{text anchor|CARNIVORE}}
| Caste
|
| Creature ''only'' eats [[meat]]. If the creature goes on rampages in worldgen, it will often devour the people/animals it kills.

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

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

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

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

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

|-
| {{text anchor|CASTE_NAME}}
| Caste
|
*singular
*plural
*adjective
| While {{token|NAME|c}} describes the name of the species, {{token|CASTE_NAME|c}} names individuals of the species. Unlike other caste-specific descriptions, this token is required, even for creatures without separate castes. If left undefined, the creature will not show up in the [[arena]] and members of the species will be labeled as "nothing".

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

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

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

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

|-
| {{text anchor|CAVE_ADAPT}}
| Caste
|
| Causes the creature to develop [[cave adaptation]].

Allows for creature's race to be involved in jokes that end in "And the [race] saw the sun and vomited on the spot!"

|-
| {{text anchor|CDI}}
| Caste
|
*Varies
| Specifies interaction details following a {{token|CAN_DO_INTERACTION|c}} token. See [[interaction token]].

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

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

|-
| {{text anchor|CHILD}}
| Caste
|
*integer
| Age at which creature is considered an adult - one can think of this as the duration of the [[children|child]] stage. Allows the creature's offspring to be rendered fully tame if [[animal trainer|trained]] during their childhood.

|-
| {{text anchor|CHILDNAME}}
| Caste
|
*singular
*plural
| Defines a new name for a creature in the child state at the caste level. For non-caste-specific child names, see {{token|GENERAL_CHILD_NAME|c}}.

|-
| {{text anchor|CLUSTER_NUMBER}}
| Creature
|
*min
*max
| The minimum/maximum numbers of how many creatures per spawned cluster. Vermin fish with this token in combination with temperate ocean and river biome tokens [http://www.bay12forums.com/smf/index.php?topic=51864.msg1122319#msg1122319 will perform seasonal migrations]. Defaults to 1:1 if not specified.

|-
| {{text anchor|CLUTCH_SIZE}}
| Caste
|
*min
*max
|Number of [[egg]]s laid in one sitting.

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

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

|-
| {{text anchor|COMMON_DOMESTIC}}
| Caste
|
| When combined with any of {{token|PET|c}}, {{token|PACK_ANIMAL|c}}, {{token|WAGON_PULLER|c}} and/or {{token|MOUNT|c}}, the creature is guaranteed to be domesticated by any [[civilization]] with {{token|COMMON_DOMESTIC_PET|e}}, {{token|COMMON_DOMESTIC_PACK|e}}, {{token|COMMON_DOMESTIC_PULL|e}} and/or {{token|COMMON_DOMESTIC_MOUNT|e}} respectively. Such civilizations will always have access to the creature, even in the absence of wild populations. This token is invalid on {{token|FANCIFUL|c}} creatures.

|-
| {{text anchor|CONVERTED_SPOUSE}}
| Caste
|
| Creatures of this caste's species with the {{token|SPOUSE_CONVERTER|c}} and {{token|NIGHT_CREATURE_HUNTER|c}} tokens will kidnap {{token|SPOUSE_CONVERSION_TARGET|c}}s of an appropriate sex and convert them into castes with CONVERTED_SPOUSE.

|-
| {{text anchor|COOKABLE_LIVE}}
| Caste
|
| Set this on a vermin creature to allow it to be cooked in meals while it is still alive, as well as when it's dead but not yet [[fishery|cleaned]]. Used by some water-dwelling vermin such as [[mussel]]s, [[oyster]]s, and [[cave lobster]]s. Currently does not work correctly when applied to non-{{token|FISHITEM|c}} vermin.{{bug|13200}}

|-
| {{text anchor|CRAZED}}
| Caste
|
| Creature is '[[insanity|berserk]]' and will attack all other creatures, except members of its own species that '''also''' have the CRAZED tag. It will show {{DFtext|Berserk|4:1}} in the [[unit list]]. Berserk creatures go on rampages during [[world generation|worldgen]] much more frequently than non-berserk ones.

|-
| {{text anchor|COPY_TAGS_FROM}}
| Special
|
*creature ID
| Copies another specified creature. This will override any definitions made before it; essentially, it makes this creature identical to the other one, which can then be modified. Often used in combination with {{token|APPLY_CREATURE_VARIATION|c}} to import standard variations from a file. The vanilla [[giant animal]]s and [[animal person|animal people]]s are examples of this token combination.

|-
| {{text anchor|CREATURE}}
| Creature
|
*creature ID
| A unique, arbitrary identifier that begins the definition of each new creature, and is used to reference the creature in other tokens and raws.

|-
| {{text anchor|CREATURE_CLASS}}
| Caste
|
*classname
| An arbitrary creature classification. Can be set to anything, but the only vanilla uses are GENERAL_POISON (used in syndromes), EDIBLE_GROUND_BUG (used as targets for {{token|GOBBLE_VERMIN_CLASS|c}}), MAMMAL, and POISONOUS (both used for kobold pet eligibility). If a creature has the REAL_WORLD_EXTINCT class, they can be customized in how they appear during world generation, and will also have another class creature class to denote what prehistoric period they existed in. A single creature can have multiple classes.

The full list of tokens that use creature classes is:

* Creature tokens: {{token|GOBBLE_VERMIN_CLASS|c}}, {{token|GOBBLE_VERMIN_CLASS|c}}
* Interaction tokens: {{token|IT_AFFECTED_CLASS|in}}, {{token|IT_IMMUNE_CLASS|in}}
* Animal definition (Entity) tokens: {{token|ANIMAL_CLASS|e}}, {{token|ANIMAL_FORBIDDEN_CLASS|e}}
* Position (Entity) token: {{token|ALLOWED_CLASS|po}}
* Syndrome tokens: {{token|SYN_AFFECTED_CLASS|sy}}, {{token|SYN_IMMUNE_CLASS|sy}}, {{token|CE_SENSE_CREATURE_CLASS|sy}}
* Extinction tokens: CAMBRIAN, CARBONIFEROUS, CENOZOIC, CRETACEOUS, DEVONIAN, JURASSIC, ORDOVICIAN, PERMIAN, SILURIAN, TRIASSIC [Todo: add token links]
|-
| {{text anchor|CREATURE_SOLDIER_TILE}}
| Creature
|
*'character' or tile number
| Creatures active in their civilization's [[military]] will use this tile instead.

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

|-
| {{text anchor|CREPUSCULAR}}
| Caste
|
| When set, the creature will appear at dawn (between 4:30 AM and 6:00 AM) and in the evening (between 8:00 PM and 10:05 PM) in [[Adventurer mode]].

|-
| {{text anchor|CURIOUSBEAST_EATER}}
| Caste
|
| Allows a creature to [[Steals food|steal and eat edible items]] from a site. It will attempt to grab a food item and immediately make its way to the map's edge, where it will disappear with it. If the creature goes on rampages during worldgen, it will often steal food instead of attacking. Trained and tame instances of the creature will no longer display this behavior.

|-
| {{text anchor|CURIOUSBEAST_GUZZLER}}
| Caste
|
| Allows a creature to (very quickly) [[Steals drink|drink your alcohol]]. Or spill the barrel to the ground. Also affects undead versions of the creature. Unlike food or item thieves, drink thieves will consume your alcohol on the spot rather than run away with one piece of it. Trained and tame instances of the creature will no longer display this behavior.

|-
| {{text anchor|CURIOUSBEAST_ITEM}}
| Caste
|
| Allows a creature to [[Steals items|steal things]] (apparently, of the highest value it can find). It will attempt to grab an item of value and immediately make its way to the map's edge, where it will disappear with it. If a creature with any of the CURIOUSBEAST tokens carries anything off the map, even if it is a caravan's pack animal, it will be reported as stealing everything it carries. If the creature goes on rampages in worldgen, it will often steal items instead of attacking - [[kea]] birds are infamous for this. Trained and tame instances of the creature will no longer display this behavior. Also, makes the creature unable to drop hauled items until it enters combat.

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

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

{{alphabetical TOC|style=margin: 1em auto;}}

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

|-
| {{text anchor|DEMON}}
| Caste
|
| Found on generated [[demon]]s.

At least 1 demon generated, or custom must have the {{token|FLIER|c}} token in order for the [[Underworld|horrifying screams]] event to trigger.

|-
| {{text anchor|DESCRIPTION}}
| Caste
|
*text
| A brief description of the creature type, as displayed when viewing the creature's description/[[Thoughts and preferences|thoughts & preferences]] screen.

|-
| {{text anchor|DIE_WHEN_VERMIN_BITE}}
| Caste
|
| Causes the creature to die upon attacking. Used by [[honey bee]]s to simulate them dying after using their stingers.

|-
| {{text anchor|DIFFICULTY}}
| Caste
|
*integer
| Increases experience gain during adventure mode. Creatures with a difficulty of 11 or higher are not assigned for quests in adventure mode. Vanilla [[semimegabeast]]s have a difficulty of 5 and [[megabeast]]s have a difficulty of 10.

|-
| {{text anchor|DIURNAL}}
| Caste
|
| When set, the creature will only appear during the day (between 6:00 AM and 8:00 PM) in [[Adventurer mode]].

|-
| {{text anchor|DIVE_HUNTS_VERMIN}}
| Caste
|
| The creature hunts vermin by diving from the air. On tame creatures, it has the same effect as {{token|HUNTS_VERMIN|c}}. Found on [[peregrine falcon]]s.

|-
| {{text anchor|DOES_NOT_EXIST}}
| Creature
|
| Adding this token to a creature prevents it from appearing in generated worlds (unless it's marked as [[Entity_token#ANIMAL_ALWAYS_PRESENT|always present]] for a particular civilisation). For example, adding it to [[dog]]s will lead to worlds being generated without dogs in them. Also removes the creature from the [[object testing arena]]'s spawn list. If combined with {{token|FANCIFUL|c}}, artistic depictions of the creature will occur regardless. Used by [[centaur]]s, [[chimera]]s and [[griffon]]s in the vanilla game.

Note: a creature tagged as DOES_NOT_EXIST can still be [[Interaction_token#I_EFFECT|summoned]] successfully, as long as it has a body defined in its raws [http://www.bay12forums.com/smf/index.php?topic=165213.msg8086938#msg8086938], or, another creature can [[Syndrome#CE_BODY_TRANSFORMATION|transform]] into it.
|}

{{alphabetical TOC|style=margin: 1em auto;}}

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

|-
| {{text anchor|EBO_ITEM}}
| Caste
|
*[[item token]]
*[[material token]] (ANY_HARD_STONE can be used for the material)
| Defines the item that the creature drops upon being [[butcher|butchered]]. Used with {{token|EXTRA_BUTCHER_OBJECT|c}}.

|-
| {{text anchor|EBO_SHAPE}}
| Caste
|
*gem shape
| The shape of the creature's extra [[butcher|butchering]] drop. Used with {{token|EXTRA_BUTCHER_OBJECT|c}}.

|-
| {{text anchor|EGG_MATERIAL}}
| Caste
|
* <[[material token]]>
* <[[Material_definition_token#Material_States|material state]]>
| Defines the material composition of [[egg]]s laid by the creature. [[creature_token#LAYS_EGGS|Egg-laying]] creatures in the default game define this 3 times, using LOCAL_CREATURE_MAT:EGGSHELL, LOCAL_CREATURE_MAT:EGG_WHITE, and then LOCAL_CREATURE_MAT:EGG_YOLK. Eggs will be made out of eggshell. Edibility is determined by tags on whites or yolk, but they otherwise do not exist.

|-
| {{text anchor|EGG_SIZE}}
| Caste
|
*size
| Determines the size of laid [[egg]]s. Doesn't affect hatching or cooking, but bigger eggs will be heavier, and may take longer to be hauled depending on the hauler's strength.

|-
| {{text anchor|EQUIPMENT_WAGON}}
| Creature
|
| Makes the creature appear as a large 3×3 [[wagon]] responsible for carrying trade goods, pulled by two {{token|WAGON_PULLER|c}} creatures and driven by a merchant.

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

|-
| {{text anchor|EVIL}}
| Creature
|
| The creature is considered evil and will only show up in evil biomes. Civilizations with {{token|USE_EVIL_ANIMALS|e}} can domesticate them regardless of exotic status. Has no effect on cavern creatures except to restrict taming. A civilization with evil creatures can colonize evil areas.

Civilizations which list evil creatures as one of their main population options will potentially emerge following an underworld mining disaster, with the added caveat that a demon will be in charge of the civ. The rules which govern which noble position the demon in charge adopts however, are unclear. It either picks one of the predefined positions, or simply makes its own.

|-
| {{text anchor|EXTRA_BUTCHER_OBJECT}}
| Caste
|
* [[Body token#CATEGORY|BY_CATEGORY]] or [[Body token#CONTYPE|BY_TYPE]] or [[Body token#BP|BY_TOKEN]]
* TYPE, CATEGORY, or TOKEN
| The creature drops an additional object when [[butcher|butchered]], as defined by {{token|EBO_ITEM|c}} and {{token|EBO_SHAPE|c}}. Used for [[gizzard stone]]s in default creatures. For some materials, needs to be defined after caste definitions with SELECT_CASTE:ALL{{Bug|6355}}

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

|-
| {{text anchor|EXTRAVISION}}
| Caste
|
| The creature can see regardless of whether it has working eyes and has full 360 degree vision, making it impossible to strike the creature from a blind spot in combat. Invisible creatures will also be seen, namely [[intelligent undead]] using a "vanish" power.
|}

{{alphabetical TOC|style=margin: 1em auto;}}

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

|-
| {{text anchor|FANCIFUL}}
| Creature
|
| The creature is a thing of legend and known to all civilizations. Its materials cannot be requested or preferred. The tag also adds some art value modifiers. Used by a [[Fanciful|number of creatures]]. Conflicts with {{token|COMMON_DOMESTIC|c}}.

|-
| {{text anchor|FEATURE_ATTACK_GROUP}}
| Caste
|
| Found on [[Animal people#Subterranean animal people|subterranean animal-man]] tribals. Currently defunct. In previous versions{{verify}}, it caused these creatures to crawl out of chasms and underground rivers.

|-
| {{text anchor|FEATURE_BEAST}}
| Caste
|
| Found on [[forgotten beast]]s. Presumably makes it act as such, initiating underground attacks on fortresses, or leads to the pop-up message upon encountering one{{verify}}. Displays the creature's {{token|DESCRIPTION|c}} in its [[legends mode]] entry and hides the creature from displaying in a world_sites_and_pops file. Does not create historical figures like generated forgotten beasts do.

Requires specifying a {{token|BIOME|c}} in which the creature will live, and both surface and subterranean biomes are allowed. Does not stack with {{token|LARGE_ROAMING|c}} and if both are used the creature will not spawn. Appears to be incompatible with {{token|DEMON|c}} even if used in separate castes.

|-
| {{text anchor|FEMALE}}
| Caste
|
| Makes the creature biologically female, enabling her to [[Breeding|bear young]]. Usually specified inside a caste.

|-
| {{text anchor|FIREIMMUNE}}
| Caste
|
| Makes the creature immune to [[Interaction_token#FIREBALL|FIREBALL]] and [[Interaction_token#FIREJET|FIREJET]] attacks, and allows it to path through high temperature zones, like lava or fires, but does not, by itself, make the creature immune to the damaging effects of burning in [[fire]], and does not prevent general heat damage or melting on its own (this would require adjustments to be made to the creature's body [[Material_definition_token|materials]] - see the [[Dragon/raw|dragon raws]] for an example).

|-
| {{text anchor|FIREIMMUNE_SUPER}}
| Caste
|
| Like {{token|FIREIMMUNE|c}}, but also renders the creature immune to [[Interaction_token#DRAGONFIRE|DRAGONFIRE]] attacks.

|-
| {{text anchor|FISHITEM}}
| Caste
|
| The creature's corpse is a single [[Item_token#FISH_RAW|FISH_RAW]] food item that needs to be cleaned (into a [[Item_token#FISH|FISH]] item) at a [[fishery]] to become edible. Before being cleaned the item is referred to as "raw". The food item is categorized under "fish" on the food and stocks screens, and when uncleaned it is sorted under "raw fish" in the stocks (but does not show up on the food screen).
Without this or {{token|COOKABLE_LIVE|c}}, [[fishing|fished]] vermin will turn into food the same way as non-vermin creatures, resulting in multiple units of food (meat, brain, lungs, eyes, spleen etc.) from a single fished vermin. These units of food are categorized as meat by the game.

|-
| {{text anchor|FIXED_TEMP}}
| Caste
|
*temperature
| The creature's body is constantly at this temperature, heating up or cooling the surrounding area. Alters the temperature of the creature's inventory and all adjacent tiles, [[Temperature|with all the effects that this implies]] - may trigger wildfires at high enough values. Also makes the creature immune to extreme heat or cold, as long as the temperature set is not harmful to the materials that the creature is made from. Corpses and body parts of creatures with a fixed temperature maintain their temperature even after death.

Note that temperatures of 12000 and higher may cause [[path|pathfinding]] issues in fortress mode.

|-
| {{text anchor|FLEEQUICK}}
| Caste
|
| If engaged in combat, the creature will flee at the first sign of resistance. Used by [[kobold]]s in the vanilla game.

|-
| {{text anchor|FLIER}}
| Caste
|
| Allows a creature to fly, independent of it having wings or not. Fortress Mode pathfinding only partially incorporates flying - flying creatures need a land path to exist between them and an area in order to access it, but as long as one such path exists, they do not need to use it, instead being able to fly over intervening obstacles. Winged creatures with this token can lose their ability to fly if their wings are crippled or severed. Winged creatures without this token will be unable to fly. (A 'wing' in this context refers to any body part with its own [[Body_token#FLIER|FLIER]] token).

At least 1 [[Demon]] must have the flier token in order for the [[Underworld|horrifying screams]] event to trigger.

|-
| {{text anchor|FREQUENCY}}
| Creature
|
*number, max 100
| The {{token|FREQUENCY|c}} value plays two separate roles. The first is in determining the initial distribution of creatures across the world map. Each creature is randomly assigned a single x, y co-ordinate on the world map, which act as the epicenter for that creature's distribution. A square is drawn around that x, y co-ordinate with a Manhattan radius equal to the {{token|FREQUENCY|c}} value divided by 100 times the world map size. For example, in a 256 by 256 size world map, the [[lion]] might be assigned 14, 112. The [[lion]] has {{token|FREQUENCY:5|c}}, and so a square is drawn by moving 13 tiles in each direction from the [[lion]]'s x, y co-ordinate. This is the [[lion]]'s "territory".

Each sub-region in the world will attempt to fill lists of wildlife. There are five lists - {{token|VERMIN_GROUNDER|c}}, {{token|VERMIN_SOIL|c}}, {{token|VERMIN_SOIL_COLONY|c}}, {{token|LARGE_ROAMING|c}}, and {{token|LARGE_PREDATOR|c}}, corresponding with the relevant tokens. The game will attempt to place seven creatures in each list for each sub-region. The game will select the seven nearest valid creatures. Creatures are valid for sub-region's list if they have the requisite token for that list, if they have the valid token for that sub-region's biome (for example, the [lion] can only be selected for {{token|BIOME:SAVANNA_TROPICAL|c}}, {{token|BIOME:GRASSLAND_TROPICAL|c}}, and {{token|BIOME:SHRUBLAND_TROPICAL|c}}, and if their "territory" as defined by their random epicenter and {{token|FREQUENCY|c}} radius overlaps with that sub-region. These lists then determine the creatures that can actually appear within that sub-region during gameplay.

There are some exceptions to the above. If the game was not capable of filling all seven entries in a list, it will drop the overlapping territory requirement, and simply pull the nearest creature which has the correct token and biome availability. Conversely, if a creature has an epicenter but has not appeared on any of the list for any of the world map's sub-regions, the creature will be assigned to the relevant list for the nearest appropriate sub-region - meaning it is occasionally possible to have lists of eight creatures or more. This is more common in smaller worlds where there are less possible sub-regions to be assigned towards. Creatures with the {{token|GOOD|c}} and {{token|EVIL|c}} tokens ignore the epicenter distribution system altogether. They are always capable of appearing in appropriate biomes which are {{token|GOOD|b}} or {{token|EVIL|b}} respectively. This is not true for {{token|SAVAGE|c}}, which acts more like the biome tokens. Creatures with {{token|UBIQUITOUS|c}} have a "territory" which covers the entire map, regardless of their epicenter (although they can still fail to be chosen if there are 7 creatures which are eligible and have nearer epicenters to the sub-region in question).

The second use for {{token|FREQUENCY|c}} is to determine how often a creature actually appears on map. In Fortress Mode, the game will try and spawn large wildlife (creatures with {{token|LARGE_ROAMING|c}} or {{token|LARGE_PREDATOR|c}} in fairly regular waves. These waves include {{token|LARGE_ROAMING|c}}, {{token|LARGE_ROAMING|c}} combined with {{token|FLIER|c}}, {{token|LARGE_PREDATOR|c}}, and {{token|CURIOUS_BEAST|c}} - so a [[lion]] does not compete for selection with a [[gazelle]]. When the game decides it needs to spawn in a fresh wave of e.g. {{token|LARGE_ROAMING|c}} creatures, it will select one of the creatures available to it from the lists for that sub-region at random, with all creatures weighted equally. Once it has selected a creature, it then effectively rolls a d100 against the relevant creature's {{token|FREQUENCY|c}}. If the d100 is equal to the creature's {{token|FREQUENCY|c}} or less, that creature is then spawned in. If the d100 is above the creature's {{token|FREQUENCY|c}}, the game returns to the relevant list and selects again. {{token|UBIQUITOUS|c}} acts as {{token|FREQUENCY:100|c}} for these purposes - in other words, the creature cannot fail the d100 check and will always be spawned in if it is selected from the list.

Defaults to 50.

|}

{{alphabetical TOC|style=margin: 1em auto;}}

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

|-
| {{text anchor|GAIT}}
| Caste
|
* <gait type>
* <gait name>
* <max [[Gait#Speed|speed]]>
* <build up time>
* <max turning [[Gait#Speed|speed]]>
* <start [[Gait#Speed|speed]]>
* <energy expenditure>
* <gait flag(s)>
| Defines a gait by which the creature can move. See [[Gait]] for more information. Specifically, you likely want to use one of the existing STANDARD_X_GAITS creature variations, as described in [[Gait#Gaits_and_Modding|this subsection]].

* <max speed> indicates the maximum [[Gait#Speed|speed]] achievable by a creature using this gait
* <start speed> indicates the creature's speed when it starts moving using this gait
* <build up time> indicates how long it will take for a creature using this gait to go from <start speed> to <max speed>. For example, a value of 10 means that it should be able to reach the maximum speed by moving 10 [[tile]]s in a straight line over even terrain.
* <max turning speed> indicates the maximum speed permissible when the creature suddenly changes its direction of motion. The creature's speed will be reduced to <max turning speed> if travelling at a higher speed than this before turning.
* <energy expenditure> indicates how energy-consuming the gait is. Higher values cause the creature to tire out faster. Persistent usage of a high-intensity gait will eventually lead to exhaustion and [[Status_icon#Non-flashing|collapse]].

'''NO_BUILD_UP''' can be specified instead of a <start speed> value to make the <max speed> instantly achievable upon initiating movement (this is equivalent to a <build up time> of 0). Note that <build up time> and <max turning speed> are both ignored if specified alongside this (as NO_BUILD_UP trumps <build up time> and preserves <max speed> whilst turning, and <max turning speed> cannot exceed <max speed>) so it is permissible to omit them so long as they are '''both''' omitted together.

It's possible to specify a <start speed> greater than the <max speed>; the moving creature will decelerate towards its <max speed> in this case.

'''valid gait types:'''
*'''WALK''' 
Used for moving normally over ground tiles.

*'''CRAWL''' 
Used for moving over ground tiles whilst [[Status_icon#Non-flashing|prone]].

*'''SWIM''' 
Used for moving through tiles containing [[water]] or [[magma]] at a [[Water#Depth|depth]] of at least 4/7.

*'''FLY''' 
Used for moving through [[open space]].

*'''CLIMB''' 
Used for moving whilst [[Climber|climbing]].

'''valid gait flags:'''
* '''AGILITY''' 
Speeds/slows movement depending on the creature's [[Attribute#Agility|Agility]] stat.

* '''STRENGTH''' 
Speeds/slows movement depending on the creature's [[Attribute#Strength|Strength]] stat.

* '''LAYERS_SLOW''' 
Makes [[Tissue_definition_token#THICKENS_ON_ENERGY_STORAGE|THICKENS_ON_ENERGY_STORAGE]] and [[Tissue_definition_token#THICKENS_ON_STRENGTH|THICKENS_ON_STRENGTH]] tissue layers slow movement depending on how thick they are. Adding the STRENGTH gait flag counteracts the impact of the latter layer.

* '''STEALTH_SLOWS:'''<percentage> 
Slows movement by the specified percentage when the creature is [[Ambusher|sneaking]].

|-
| {{text anchor|GENERAL_BABY_NAME}}
| Creature
|
*singular
*plural
| Like {{token|BABYNAME|c}}, but applied regardless of caste.

|-
| {{text anchor|GENERAL_CHILD_NAME}}
| Creature
|
*singular
*plural
| Like {{token|CHILDNAME|c}}, but applied regardless of caste.

|-
| {{text anchor|GENERAL_MATERIAL_FORCE_MULTIPLIER}}
| Caste
|
*value A
*value B
| Has the same function as {{token|MATERIAL_FORCE_MULTIPLIER|c}}, but applies to all attacks instead of just those involving a specific material. Appears to be overridden by MATERIAL_FORCE_MULTIPLIER ([[werebeast]]s, for example, use both tokens to provide resistance to all materials, with one exception to which they are especially vulnerable).

|-
| {{text anchor|GENERATED}}
| Creature
|
| Found on procedurally generated creatures like [[forgotten beast]]s, [[titan]]s, [[demon]]s, [[angel]]s, and [[night creature]]s. Cannot be specified in user-defined raws.

|-
| {{text anchor|GETS_INFECTIONS_FROM_ROT}}
| Caste
|
| Makes the creature get [[Health_care#Infection|infections]] from necrotic tissue.

|-
| {{text anchor|GETS_WOUND_INFECTIONS}}
| Caste
|
| Makes the creature's wounds become [[Health_care#Infection|infected]] if left untreated for too long.

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

|-
| {{text anchor|GLOWTILE}}
| Creature
|
*ascii character
| If present, the being glows in the dark (generally used for Adventurer 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 {{token|CASTE_GLOWTILE|c}} instead.

|-
| {{text anchor|GNAWER}}
| Caste
|
*verb
| The creature can and will gnaw its way out of [[animal trap]]s and [[cage]]s using the specified verb, depending on the material from which it is made (normally wood).

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

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

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

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

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

|-
| {{text anchor|GOOD}}
| Creature
|
| Creature is considered good and will only show up in good biomes - [[unicorn]]s, for example. Civilizations with {{token|USE_GOOD_ANIMALS|e}} can domesticate them regardless of exotic status. Has no effect on cavern creatures except to restrict taming. A civilization that has good creatures can colonise good areas in world-gen.

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

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

|-
| {{text anchor|GRAZER}}
| Caste
|
*number
| The creature is a grazer - if tamed in fortress mode, it needs a pasture to survive. The higher the number, the less frequently it needs to eat in order to live. Not used since 0.40.12, replaced by {{token|STANDARD_GRAZER|c}} to fix {{bugl|4113}}.
|}

{{alphabetical TOC|style=margin: 1em auto;}}

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

|-
| {{text anchor|HABIT}}
| Caste
|
*type
*probability
| Defines certain behaviors for the creature. The habit types are:
*COLLECT_TROPHIES
*COOK_PEOPLE
*COOK_VERMIN
*GRIND_VERMIN
*COOK_BLOOD
*GRIND_BONE_MEAL
*EAT_BONE_PORRIDGE
*USE_ANY_MELEE_WEAPON
*GIANT_NEST
*COLLECT_WEALTH.
These require the creature to have a {{token|LAIR|c}} to work properly, and also don't seem to work on creatures who are not a {{token|SEMIMEGABEAST|c}}, {{token|MEGABEAST|c}}, or{{token|NIGHT_CREATURE_HUNTER|c}}.

|-
| {{text anchor|HABIT_NUM}}
| Caste
|
*number or TEST_ALL
| "If you set HABIT_NUM to a number, it should give you that exact number of habits according to the weights.".{{cite forum|60554/1719248}} All lists of HABITs are preceded by [HABIT_NUM:TEST_ALL]

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

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

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

|-
| {{text anchor|HOMEOTHERM}}
| Caste
|
*number or NONE
| Default 'NONE'. The creature's normal body [[temperature]]. Creature ceases maintaining temperature on death unlike fixed material temperatures. Provides minor protection from environmental temperature to the creature.

|-
| {{text anchor|HUNTS_VERMIN}}
| Caste
|
| Creature hunts and kills nearby [[vermin]], randomly walking between places with food laying on the ground or in stockpiles, to check for possible [VERMIN_EATER] vermin, but they'll kill any other vermin too. Do not include this creature token on an intelligent entity that you intend to play as in fortress mode because it will prevent them from feeding themselves.

|}

{{alphabetical TOC|style=margin: 1em auto;}}

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

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

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

|-
| {{text anchor|IMMOLATE}}
| Caste
|
| The creature radiates [[fire]]. It will ignite, and potentially completely destroy, items the creature is standing on. Also gives the vermin a high chance of escaping from [[animal trap]]s and [[cage]]s made of any flammable materials (specifically ones that could be ignited by magma).

|-
| {{text anchor|INTELLIGENT}}
| Caste
|
| Alias for {{token|CAN_SPEAK|c}} + {{token|CAN_LEARN|c}}.

|-
| {{text anchor|ITEMCORPSE}}
| Caste
|
* [[item token]]
* [[material token]]
| Determines if the creature leaves behind a non-standard corpse (i.e. wood, statue, bars, stone, pool of liquid, etc.). [[Ethics]] may prevent actually using the item in jobs or reactions.

|-
| {{text anchor|ITEMCORPSE_QUALITY}}
| Caste
|
* number
| The [[quality]] of an item-type corpse left behind. Valid values are: 0 for ordinary, 1 for well-crafted, 2 for finely-crafted, 3 for superior, 4 for exceptional, 5 for masterpiece.
|}

{{alphabetical TOC|style=margin: 1em auto;}}

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

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

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

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

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

|-
| {{text anchor|LARGE_PREDATOR}}
| Caste
|
| Will attack other creatures that are smaller than it. Tamed large predators will still attack wildlife. In [[fortress mode]], only one group of "large predators" (possibly two groups on "savage" maps) will appear on any given map. In [[adventurer mode]], large predators will try to ambush and attack you (and your party will attack them back). When tamed, large predators tend to be much more aggressive to enemies than non-large predators, making them a good choice for an animal army. They may go on rampages in worldgen, and adventurers may receive quests to kill them. Also, they can be mentioned in the intro paragraph when starting a fortress e.g. "ere the wolves get hungry."
A single biome supports 7 large predator species, picking randomly and rolling a d100 under its {{token|FREQUENCY|c}} to add it until all 7 slots are filled.

Incompatible with {{token|PACK_ANIMAL|c}} on a technicality, if included: hauled items are likely to be dropped upon entering the map (even if {{token|TRADE_CAPACITY|c}} is present) in contrast to when the merchants depart.

|-
| {{text anchor|LARGE_ROAMING}}
| Creature
|
| This is the core requisite tag allowing the creature to spawn as a wild animal in the appropriate biomes. Requires specifying a {{token|BIOME|c}} in which the creature will spawn. Does not require specifying a frequency, population number, or cluster number.

This tag stacks with {{token|MEGABEAST|c}}, {{token|SEMIMEGABEAST|c}}, or {{token|NIGHT_CREATURE_HUNTER|c}}; if used with one of these tags, the creature will spawn as both a boss and as a wild animal. This tag does not stack with {{token|FEATURE_BEAST|c}} and if both are used the creature will not spawn. This tag is unaffected by {{token|DEMON|c}}.
Large roamers are not able to spawn in Pool biomes as they do not connect to the edge of the map and are too small, Lake biomes are a suitable alternative.

|-
| {{text anchor|LAYS_EGGS}}
| Caste
|
| Creature lays [[egg]]s instead of giving birth to live young.

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

|-
| {{text anchor|LIGAMENTS}}
| Caste
|
* [[material token]]
*healing rate
| The creature has ligaments in its {{token|CONNECTIVE_TISSUE_ANCHOR|td}} tissues (bone or chitin by default). Cutting the bone/chitin tissue severs the ligaments, disabling motor function if the target is a limb.

|-
| {{text anchor|LIGHT_GEN}}
| Caste
|
| A vermin featuring this tag will remain visible to an adventurer even at night.

Subterranean vermin which feature this token will flicker in unexposed and unrevealed cavern layers while playing in Fortress Mode.

|-
| {{text anchor|LISP}}
| Caste
|
| Creature uses "sssssnake talk" (multiplies 'S' when talking - "My name isss Recisssiz."). Used by [[Serpent man|serpent men]] and [[Reptile man|reptile men]] in the vanilla game. C's with the same pronunciation (depending on the word) are not affected by this token.

|-
| {{text anchor|LITTERSIZE}}
| Caste
|
* minimum
* maximum
| Determines the number of offspring per one birth; default 1-3, not used in vanilla raws. See also {{token|MULTIPLE_LITTER_RARE|c}}.

|-
| {{text anchor|LOCAL_POPS_CONTROLLABLE}}
| Creature
|
| Allows you to play as a wild animal of this species in adventurer mode. Prevents trading of (tame) instances of this creature in caravans.

|-
| {{text anchor|LOCAL_POPS_PRODUCE_HEROES}}
| Creature
|
| Wild animals of this species may occasionally join a civilization. Prevents trading of (tame) instances of this creature in caravans.

|-
| {{text anchor|LOCKPICKER}}
| Caste
|
| Lets a creature open [[door]]s that are set to forbidden in fortress mode.

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

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

{{alphabetical TOC|style=margin: 1em auto;}}

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

|-
| {{text anchor|MAGICAL}}
| Caste
|
| According to Toady One, this is completely interchangeable with {{token|AT_PEACE_WITH_WILDLIFE|c}} and might have been used in very early versions of the game by wandering wizards, or the ent-type tree creatures that used to be animated by elves. [http://www.bay12forums.com/smf/index.php?topic=169696.msg8316954#msg8316954]

|-
| {{text anchor|MAGMA_VISION}}
| Caste
|
| The creature is able to see while submerged in [[magma]].

|-
| {{text anchor|MALE}}
| Caste
|
| Makes the creature biologically male; usually declared inside a caste.

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

|-
| {{text anchor|MATERIAL}}
| Creature
|
*material id
| Begins defining a new local material. Follow this with standard material definition tokens to define the material. A maximum of 200 materials can be defined on any given creature.

|-
| {{text anchor|MATERIAL_FORCE_MULTIPLIER}}
| Caste
|
*[[Material token]]
*value A
*value B
| When struck with a weapon made of the specified material, the force exerted will be multiplied by A/B, thus making the creature more or less susceptible to this material. For example, if A is 2 and B is 1, the force exerted by the defined material will be doubled. If A is 1 and B is 2, it will be halved instead. See also {{token|GENERAL_MATERIAL_FORCE_MULTIPLIER|c}}, which can be used to make this sort of effect applicable to all materials.

|-
| {{text anchor|MATUTINAL}}
| Caste
|
| When set, the creature will only appear at dawn (between 4:30 AM and 6:00 AM) in [[Adventurer mode]].

|-
| {{text anchor|MAXAGE}}
| Caste
|
*min
*max
| Determines the creature's natural lifespan, using the specified minimum and maximum age values (in years). Each individual creature with this token is generated with a predetermined date (calculated down to the exact [[time|tick]]!) between these values, at which it is destined to die of old age, should it live long enough. Note that the probability of death at any given age does not increase as the creature gets older [http://i.imgur.com/A1A4aA9.png].
Creatures which lack this token are naturally immortal. The [[Syndrome#CE_ADD_TAG|NO_AGING]] syndrome tag will prevent death by old age from occurring. Also note that, among civilized creatures, castes which lack this token will refuse to marry others with it, and vice versa.

|-
| {{text anchor|MEANDERER}}
| Caste
|
| Makes the creature slowly stroll around, unless it's in combat or performing a job. If combined with {{token|CAN_LEARN|c}}, will severely impact their [[pathfinding]] and lead the creature to move extremely slowly when not performing any task. <s>Problematically applies to animal people based on the animal, and war trained animals{{bug|9588}}</s> As of version 52.05, meandering behavior no longer applies to animal people and to animals that are trained for war or hunting..

|-
| {{text anchor|MEGABEAST}}
| Caste
|
| A 'boss' creature; a small number of those are created during worldgen, their histories and descendants (if any) will be tracked in worldgen (as opposed to simply 'spawning'), and they will occasionally go on rampages, potentially leading to worship if they attack the same place multiple times. Their presence and number will also influence world age names. When appearing in fortress mode, they will have a pop-up message announcing their arrival. They will remain hostile to the fortress military even after being tamed.{{bug|10731}} See [[megabeast]] page for more details.

Requires specifying a {{token|BIOME|c}} in which the creature will live. Subterranean biomes appear to not be allowed. Does stack with {{token|LARGE_ROAMING|c}} and if both are used the creature will spawn as both historical bosses and as wild animals.

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

|-
| {{text anchor|MENT_ATT_RANGE}}
| Caste
|
*[[Attribute|ATTRIBUTE]]
*lowest
*lower
*low
*median
*high
*higher
*highest
| Sets up a [[Attribute#Soul_attributes|mental attribute]]'s range of values (0-5000). All mental attribute ranges default to 200:800:900:1000:1100:1300:2000.

|-
| {{text anchor|MENT_ATT_RATES}}
| Caste
|
*[[Attribute|ATTRIBUTE]] Token
*cost to improve
*unused counter rate
*rust counter rate
*demotion counter rate
| [[Attribute#Soul_attributes|Mental attribute]] gain/decay rates. Lower numbers in the last three slots make decay occur faster. Defaults are 500:4:5:4.

|-
| {{text anchor|MILKABLE}}
| Caste
|
* [[material token]]
* frequency
| Allows the creature to be [[milk]]ed in the [[farmer's workshop]]. The frequency is the amount of [[time|ticks]] the creature needs to "recharge" (i.e. how much time needs to pass before it can be milked again). Does not work on [[#CAN_LEARN|sentient]] creatures, regardless of [[ethics]].

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

|-
| {{text anchor|MISCHIEVOUS}}
| Caste
|
| The creature spawns [[stealth]]ed and will attempt to path into the fortress, pulling any [[lever]]s it comes across. It will be invisible on the map and [[unit list]] until spotted by a citizen, at which point the game will pause and recenter on the creature. Used by [[gremlin]]s in the vanilla game. "They go on little missions to mess with various fortress buildings, not just levers."

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

|-
| {{text anchor|MOUNT}}
| Caste
|
| Creature may be used as a [[mount]]. No use for the player in fortress mode, but enemy sieging forces may arrive with cavalry. Mounts are usable in adventure mode.

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

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

|-
| {{text anchor|MULTIPLE_LITTER_RARE}}
| Caste
|
| Makes the species usually produce a single offspring per birth, with a 1/500 chance of using the {{token|LITTERSIZE|c}} as usual. Requires {{token|FEMALE|c}}.

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

{{alphabetical TOC|style=margin: 1em auto;}}

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

|-
| {{text anchor|NAME}}
| Creature
|
*singular
*plural
*adjective
| The generic name for any creature of this type - will be used for referring to the species in the abstract, such as the default material prefix. For labeling individual creatures, {{token|CASTE_NAME|c}} is necessary. If left undefined, the creature will be labeled as "nothing" by the game.

Some examples of adjective use:
* "super''dwarven'' strength"
* "the ''dwarven'' hillocks of X"
* Deity species as in "''feline'' deity"
* Megabeast attacks in worldgen. One with multiple dragons being a "''draconic'' rampage"

|-
| {{text anchor|NATURAL}}
| Caste
|
| Animal is considered to be natural. NATURAL animals will not engage creatures tagged with {{token|AT_PEACE_WITH_WILDLIFE|c}} in combat unless they are members of a hostile entity and vice-versa.

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

|-
| {{text anchor|NATURAL_SKILL}}
| Caste
|
*[[Skill_token|Skill token]]
*value
| The creature possesses the specified [[skill]] at this level inherently - that is, it begins with the skill at this level, and the skill may never rust below that. A value of 15 is legendary.

|-
| {{text anchor|NIGHT_CREATURE}}
| Caste
|
| Creatures with this token can appear as [[experiment|experiments]]. Causes the creature to count as {{token|NOT_LIVING|c}}.

Killing a creature featuring this token provides one point of "hero" reputation. Adds the creature's description as part of the initial summary of their historical figure in legends mode. People will react to creatures with this token as a night creature (natch). In adventure mode, ambushes involving these units will say "Night creature!" instead of "Ambush!"

Prevents creature behavior enabled by {{token|LARGE_PREDATOR|c}}.

Removes the high nature value check imposed by {{token|LOCAL_POPS_PRODUCE_HEROES|c}}.

Prevents the AI from using ANIMATE interactions, unless the newly-animated{{token|OPPOSED_TO_LIFE|c}}undead will not attack them. The check for this is specifically whether the unit is:
*a ghost
*an animated unit
*a unit with the {{token|NO_AGING|c}} token added via {{token|CE_ADD_TAG|c}}. (This allows for the default exclusion of elves and goblins, unless raised as intelligent undead.)

|-
| {{text anchor|NIGHT_CREATURE_BOGEYMAN}}
| Caste
|
| Creatures with this token can appear in [[bogeyman|bogeyman ambushes]] in [[adventure mode]], where they adopt classical bogeyman traits such as stalking the adventurer and vaporising when dawn breaks. Such traits do not manifest if the creature is encountered outside of a bogeyman ambush (for instance, as a megabeast or a civilised being). In addition, their corpses and severed body parts turn into [[smoke]] after a short while. Note that setting the "Number of Bogeyman Types" in [[advanced world generation]] to 0 will only remove randomly-generated bogeymen.

|-
| {{text anchor|NIGHT_CREATURE_EXPERIMENTER}}
| Caste
|
| Found on some [[necromancer]]s. Creatures with this tag may periodically "perform horrible experiments" offscreen, during which they can use creature-targeting interactions with an <code>[[Interaction_token#I_SOURCE|[I_SOURCE:EXPERIMENT]]]</code> tag on living creatures in their area. Worlds are generated with a list of procedurally-generated experiments, allowing necromancers to turn living people and animals into [[Infected_ghoul|ghouls]] and [[Experiment|other experimental creatures]], and these will automatically be available to all experimenters; it does not appear possible to prevent this. You can mod in your own custom experiment interactions, but these are used very infrequently due to the large number of generated experiments.

|-
| {{text anchor|NIGHT_CREATURE_HUNTER}}
| Caste
|
| Found on [[night troll]]s and [[werebeast]]s. Implies that the creature is a [[night creature]], and shows its description in [[legends mode]] entry. The creature is always hostile and will start [[no quarter]] combat with any nearby creatures, except for members of its own race. Note that this tag does not override the creature's normal behavior in [[fortress mode]] except for the aforementioned aggression, and doesn't prevent the creature from fleeing the battles it started. It also removes the creature's materials from stockpile settings list, making them be stored there regardless of settings.

Does stack with {{token|LARGE_ROAMING|c}} and if both are used the creature will spawn as both historical hunters and as wild animals; this requires specifying a {{token|BIOME|c}} in which the creature will live, and subterranean biomes are allowed.

This tag causes the usual behaviour of werebeasts in worldgen, that is, fleeing towns upon being cursed and conducting raids from a lair. If this tag is absent from a deity curse, the accursed will simply be driven out of towns in a similar manner to [[vampire]]s. When paired with SPOUSE_CONVERTER, a very small population of the creature will be created during worldgen (sometimes only a single individual will be created), and their histories will be tracked (that is, they will not spawn spontaneously later, they must either have children or convert other creatures to increase their numbers). The creature will settle in a lair and go on rampages during worldgen. It will actively attempt to seek out potential conversion targets to abduct, convert, and have children with (if possible).

|-
| {{text anchor|NIGHT_CREATURE_NIGHTMARE}}
| Caste
|
| Found on [[nightmare]]s. Corpses and severed body parts derived from creatures with this token turn into [[smoke]] after a short while.

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

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

|-
| {{text anchor|NO_DIZZINESS}}
| Caste
|
| Creature cannot become [[Symptom#Dizziness|dizzy]].

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

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

|-
| {{text anchor|NO_FEVERS}}
| Caste
|
| Creature cannot suffer [[Symptom#Fever|fevers]].

|-
| {{text anchor|NO_GENDER}}
| Caste
|
| The creature is biologically sexless, making it unable to [[breeding|breed]].

|-
| {{text anchor|NO_PHYS_ATT_GAIN}}
| Caste
|
| The creature cannot raise any [[Attribute#Body_attributes|physical attributes]].

|-
| {{text anchor|NO_PHYS_ATT_RUST}}
| Caste
|
| The creature cannot lose any [[Attribute#Body_attributes|physical attributes]].

|-
| {{text anchor|NO_SLEEP}}
| Caste
|
| Creature does not need to sleep, but can still be rendered unconscious by other means.

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

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

|-
| {{text anchor|NO_THOUGHT_CENTER_FOR_MOVEMENT}}
| Caste
|
| The bodyparts of this creature don't need to be connected to an organ with the {{token|THOUGHT|body}} tag in order to have motor function. Generally used on creatures that don't have brains. If a creature doesn't have a thought part and doesn't have this token, it will be unable to grasp or stand. Nautilus men experience this issue in vanilla.

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

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

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

|-
| {{text anchor|NOBONES}}
| Caste
|
| Creature cannot be picked up for worldgen fell moods and cannot be made a skeleton deity.

|-
| {{text anchor|NOBREATHE}}
| Caste
|
| Creature doesn't need to breathe or have {{token|BREATHE|body}}parts in its body, nor can it drown or be strangled. Creatures living in magma must have this tag, otherwise they will drown.

|-
| {{text anchor|NOCTURNAL}}
| Caste
|
| When set, the creature will only appear at night (after 10:05 PM and before 4:30 AM) in [[Adventurer mode]].

|-
| {{text anchor|NOEMOTION}}
| Caste
|
| Creature has no emotions, thus; it is immune to the effects of [[stress]] and unable to rage, and its [[need]]s cannot be fulfilled in any way. Used on [[undead]] in the vanilla game.

|-
| {{text anchor|NOEXERT}}
| Caste
|
| Creature can't become tired or over-exerted from taking too many combat actions, or moving at full speed for extended periods of time.

|-
| {{text anchor|NOFEAR}}
| Caste
|
| Creature doesn't feel fear and will never flee from battle, and will be immune to [[ghost]]s' attempts to 'scare it to death'. Additionally, it causes [[bogeyman|bogeymen]] and [[nightmare]]s to become friendly towards the creature.

|-
| {{text anchor|NOMEAT}}
| Caste
|
| Creature will not be hunted or fed to wild beasts.

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

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

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

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

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

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

|-
| {{text anchor|NOSTUN}}
| Caste
|
| Creature can't be stunned and knocked unconscious by pain or head injuries. Creatures with this tag never wake up from sleep in Fortress Mode. If this creature needs to sleep while playing, it will die.

|-
| {{text anchor|NOT_BUTCHERABLE}}
| Caste
|
| Corpses from this creature cannot be [[butcher|butchered]]. Does not prevent the creature from being slaughtered while alive, however.

|-
| {{text anchor|NOT_LIVING}}
| Caste
|
| Cannot be raised from the dead by necromancers or evil clouds. Implies the creature is not a normal living being. Used by [[vampire]]s, [[Mummy|mummies]] and inorganic creatures like the [[amethyst man]] and [[bronze colossus]]. Creatures who are {{token|OPPOSED_TO_LIFE|c}} (undead) will be docile towards creatures with this token.

|-
| {{text anchor|NOTHOUGHT}}
| Caste
|
| Creature doesn't require a {{token|THOUGHT|body}} body part to survive. Has the added effect of preventing speech, though directly controlling creatures that would otherwise be capable of speaking allows them to engage in conversation.
|}

{{alphabetical TOC|style=margin: 1em auto;}}

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

|-
| {{text anchor|ODOR_LEVEL}}
| Caste
|
*number
| How easy the creature is to [[smell]]. The higher the number, the easier the creature is to sniff out. Defaults to 50. Vanilla creatures have values from 0 (undetectable) to 90 (noticeable by humans and dwarves).

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

|-
| {{text anchor|OPPOSED_TO_LIFE}}
| Caste
|
| Is hostile to all creatures except undead and other non-living ones and will show {{DFtext|Opposed to life|0:1}} in the [[unit list]]. Used by [[undead]] in the vanilla game. Functions without the {{token|NOT_LIVING|c}} token, and seems to imply said token as well. Undead will not be hostile to otherwise-living creatures given this token. Living creatures given this token will attack living creatures that lack it, while ignoring other living creatures that also have this token.

|-
| {{text anchor|ORIENTATION}}
| Caste
|
*MALE/FEMALE
*disinterested chance
*casual chance
*strong chance
| Determines caste's likelihood of having sexual attraction to certain sexes. Values default to 75:20:5 for the same sex and 5:20:75 for the opposite sex. The first value indicates how likely to be entirely uninterested in the sex, the second decides if the creature will be able to become lovers with that sex, the third decides whether they will be able to marry in worldgen and post-worldgen world activities (which implies being able to become lovers). Marriage seems to be able to happen in fort mode play regardless, as long as they are lovers first.

|-
| {{text anchor|OUTSIDER_CONTROLLABLE}}
| Caste
|
| Lets you play as an [[Adventurer_mode_character_creation#Outsider|outsider]] of this species in adventure mode.

|}

{{alphabetical TOC|style=margin: 1em auto;}}

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

|-
| {{text anchor|PACK_ANIMAL}}
| Caste
|
| Allows the creature to be used as a pack animal. Used by [[trading|merchants]] without wagons and adventurers. Also prevents creature from dropping hauled items on its own -- do ''not'' use for player-controllable creatures! May lead to the creature being domesticated during worldgen, even if it doesn't have {{token|COMMON_DOMESTIC|c}}.

Creatures with this tag but without {{token|BENIGN|c}}, and/or with {{token|LARGE_PREDATOR|c}} leads to hauled items being dropped.

|-
| {{text anchor|PARALYZEIMMUNE}}
| Caste
|
| The creature is immune to all [[Syndrome#CE_PARALYSIS|paralyzing]] special attacks.

|-
| {{text anchor|PATTERNFLIER}}
| Caste
|
| Used to control the bat riders with paralyze-dart blowguns that flew through the 2D chasm. Doesn't do anything now.

|-
| {{text anchor|PCG_LAYERING}}
| Creature
|
*[[Procedural graphics layer|Layering type]]
| Adds a layer to the current {{token|PROCEDURAL_CREATURE_GRAPHICS|c}} definition.

|-
| {{text anchor|PEARL}}
| Caste
|
| Does nothing.

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

Objects made of most materials (e.g. metal) roll a number from 0-100, and if the resulting number is greater than the penetrate power, their contents escape for the time being. Objects made of [[wood]], [[leather]], [[amber]], or [[coral]] roll 0-95, and items made of [[cloth]] roll 0-90.

|-
| {{text anchor|PERSONALITY}}
| Caste
|
*ATTRIBUTE
*lowest
*median
*highest
| Determines the range and chance of personality facets. Standard is 0:50:100. See [[personality facet]] for more info.

|-
| {{text anchor|PET}}
| Caste
|
| Allows the creature to be [[Animal_trainer|tamed]] in Fortress mode. Prerequisite for all other working animal roles. Civilizations that encounter it in worldgen will tame and domesticate it for their own use. Adding this to civilization members will classify them as pets instead of citizens, with all the [[Fun|problems]] that entails. However, you can solve these problems using the popular plugin [https://dffd.bay12games.com/file.php?id=13095| Dwarf Therapist], which is completely unaffected by the tag.

|-
| {{text anchor|PET_EXOTIC}}
| Caste
|
| Allows the creature to be [[Animal_trainer|tamed]] in Fortress mode. Prequisite for all other working animal roles. Civilizations cannot domesticate it in worldgen, with certain exceptions. More difficult to tame?{{verify}} Adding this to civilization members will classify them as pets instead of citizens, with all the [[Fun|problems]] that entails. ([[Gremlin|Example]]).

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

|-
| {{text anchor|PETVALUE_DIVISOR}}
| Caste
|
*value
| Divides the creature's {{token|PETVALUE|c}} by the specified number. Used by [[honey bee]]s to prevent a single hive from being worth a fortune.

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

|-
| {{text anchor|PHYS_ATT_RANGE}}
| Caste
|
*[[Attribute|ATTRIBUTE]]
*lowest
*lower
*low
*median
*high
*higher
*highest
| Sets up a [[Attribute#Body_attributes|physical attribute]]'s range of values (0-5000). All physical attribute ranges default to 200:700:900:1000:1100:1300:2000.

|-
| {{text anchor|PHYS_ATT_RATES}}
| Caste
|
*[[Attribute|ATTRIBUTE]] Token
*cost to improve
*unused counter rate
*rust counter rate
*demotion counter rate
| [[Attribute#Body_attributes|Physical attribute]] gain/decay rates. Lower numbers in the last three slots make decay occur faster. Defaults for STRENGTH, AGILITY, TOUGHNESS, and ENDURANCE are 500:3:4:3, while RECUPERATION and DISEASE_RESISTANCE default to 500:NONE:NONE:NONE.

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

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

|-
| {{text anchor|POP_RATIO}}
| Caste
|
*number (max 100000)
| Weighted population of caste; Lower is rarer. Not to be confused with {{token|FREQUENCY|c}}. A weight of 0 will{{version|51.06 experimental}} prevent a caste from spawning naturally. Regardless of pop ratio, [[Position token|Position]]s that only allow a certain caste can force it to spawn.

|-
| {{text anchor|POPULATION_NUMBER}}
| Creature
|
*min
*max
| The minimum/maximum numbers of how many of these creatures are present in each world map tile of the appropriate region. Defaults to 1:1 if not specified. If the creature's chosen {{token|CLUSTER_NUMBER|c}} happens to be larger, it will be used instead.

|-
| {{text anchor|POWER}}
| Caste
|
| Allows the being to represent itself as a deity, allowing it to become the leader of a civilized group. Not used by any creatures in the vanilla game. Requires {{token|CAN_SPEAK|c}} to actually do anything more than settle at a location (e.g. write books, lead armies, profane temples). Doesn't appear to do anything for creatures that are already civilized. Once the creature ascends to a position of leadership, it will proceed to act as a standard ruler for their entity and fulfill the same functions (hold tournaments, tame creatures, etc.).

|-
| {{text anchor|PREFSTRING}}
| Creature
|
*string
| Sets what other creatures [[Preferences|prefer]] about this creature. "Urist likes dwarves for their beards." Multiple entries will be chosen from at random. Creatures lacking a PREFSTRING token will never appear under another's preferences.

|-
| {{text anchor|PROCEDURAL_CREATURE_GRAPHICS}}
| Creature
|
* [[Graphics_token#Basic_creature_sprite_types|Sprite type]] or Caste then sprite type
| Makes the creature have procedural graphics built for it, like forgotten beasts/demons/titans/experiments. Must be associated with PCG_LAYERING tokens.

|-
| {{text anchor|PROFESSION_NAME}}
| Creature
|
*[[Unit type token]] (Profession)
*singular
*plural
| The generic name for members of this profession, at the creature level. In order to give members of specific castes different names for professions, use {{token|CASTE_PROFESSION_NAME|c}} instead.

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

|-
| {{text anchor|PUS}}
| Caste
|
* <[[material token]]>
* <[[Material_definition_token#Material_States|material state]]>
| The creature has pus. Specifies the stuff secreted by [[Health_care#Infection|infected wounds]].
|}

{{alphabetical TOC|style=margin: 1em auto;}}

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

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

|-
| {{text anchor|REMAINS}}
| Caste
|
*singular
*plural
| What the creature's [[remains]] are called.

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

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

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

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

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

|-
| {{text anchor|RETRACT_INTO_BP}}
| Caste
|
*BY_TYPE, BY_CATEGORY or BY_TOKEN
*body type, [[Body_token#CATEGORY|category]], or [[Body_token#BP|token]]
*Second person ("You") retract verb text
*Third person ("The giant snail") retract verb text
*Second person cancel retract text
*Third person cancel retract text
| The creature will retract into the specified body part(s) when threatened. It will be unable to move or attack, but enemies will only be able to attack the specified body part(s). When one of the specified body part is severed off, the creature automatically unretracts and cannot retract anymore. More than one body part can be selected by using BY_TYPE or BY_CATEGORY.

Second-person descriptions are used for adventurer mode natural ability. "<pro_pos>" can be used in the descriptions, being replaced with the proper pronoun (or lack thereof) in-game.

Undead curled up creatures are buggy, specifically those that retract into their upper bodies: [[echidna]]s, [[hedgehog]]s and [[pangolin]]s.{{bug|11463}}{{bug|10519}} The upper body is prevented from collapsing by a separate body part (the middle spine), which cannot be attacked when the creature is retracted. See {{token|PREVENTS_PARENT_COLLAPSE|bo}}. Living creatures eventually succumb to blood loss, but undead creatures do not. Giant creatures also take a very long time to bleed out.
|-
| {{text anchor|RETURNS_VERMIN_KILLS_TO_OWNER}}
| Creature
|
| Cat behavior. If it kills a vermin creature and has an owner, it carries the remains in its mouth and drops them at their feet. Requires {{token|HUNTS_VERMIN|c}}.

|-
| {{text anchor|ROOT_AROUND}}
| Caste
|
*BY_TYPE, BY_CATEGORY or BY_TOKEN
*body type, [[Body_token#CATEGORY|category]], or [[Body_token#BP|token]]
*Second person ("You") verb text
*Third person ("The hen") verb text
| Creature will occasionally root around in the grass, looking for insects. Used for flavor in Adventurer Mode, spawns vermin edible for this creature in Fortress Mode. Creatures missing the specified body part will be unable to perform this action. The action produces a message (visible in adventure mode) in the form:

{{DFtext|[creature] [verb text] the [description of creature's location].|6:0}}

In adventure mode, the "rooting around" ability will be included in the "natural abilities" menu, represented by its second person verb text.

|}

{{alphabetical TOC|style=margin: 1em auto;}}

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

|-
| {{text anchor|SAVAGE}}
| Creature
|
| The creature will only show up in "savage" biomes. Has no effect on cavern creatures. Cannot be combined with {{token|GOOD|c}} or {{token|EVIL|c}}.

|-
| {{text anchor|SECRETION}}
| Caste
|
*<[[material token]]>
*<[[Material_definition_token#Material_States|material state]]>
*BY_TOKEN / BY_CATEGORY / BY_TYPE
*<[[Body_token#BP|body part ID]]> / <[[Body_token#CATEGORY|category]]> or ALL / <type (e.g. [[Body_token#GRASP|GRASP]])>
*<[[Body_detail_plan_token#BP_LAYERS|tissue layer]]> or ALL
*<trigger>
| Causes the specified tissue layer(s) of the indicated body part(s) to secrete the designated material. A size 100 ('covering') [[contaminant]] is created over the affected body part(s) in its specified material state (and at the temperature appropriate to this state) when the trigger condition is met, as long as one of the secretory tissue layers is still intact. Valid triggers are:
*'''CONTINUOUS'''
Secretion occurs once every 40 [[time|ticks]] in [[fortress mode]], and every tick in [[adventurer mode]].
*'''EXERTION'''
Secretion occurs continuously (at the rate described above) whilst the creature is at minimum {{Tile|Tired|6:1}} following physical exertion. Note that this cannot occur if the creature has {{token|NOEXERT|c}}.
*'''EXTREME_EMOTION'''
Secretion occurs continuously (as above) whilst the creature is distressed. Cannot occur in creatures with {{token|NOEMOTION|c}}.

|-
| {{text anchor|SELECT_ADDITIONAL_CASTE}}
| Creature
|
*<caste>
| Adds an additional previously defined caste to the selection. Used after {{token|SELECT_CASTE|c}}.

|-
| {{text anchor|SELECT_CASTE}}
| Creature
|
*<caste> or ALL
| Selects a previously defined caste

|-
| {{text anchor|SELECT_MATERIAL}}
| Creature
|
*<[[material token]]>
| Selects a locally defined material. Can be ALL.

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

|-
| {{text anchor|SEMIMEGABEAST}}
| Caste
|
| Essentially the same as {{token|MEGABEAST|c}}, but more of them are created during worldgen. See the [[semi-megabeast]] page for details.

|-
| {{text anchor|SENSE_CREATURE_CLASS}}
| Caste
|
* <[[Creature_token#CREATURE_CLASS|creature class]]>
* [[Tilesets|<tile value or character>]]
* [[Color#Color_values|<foreground color>:<background color>:<foreground brightness>]]
| Gives the creature the ability to sense creatures belonging to the specified [[Creature_token#CREATURE_CLASS|creature class]] even when they lie far beyond line of sight, including through walls and floors. It also appears to reduce or negate the combat penalty of [[Wound#Blindness|blind]] units when fighting creatures they can sense. In [[adventure mode]], the specified tile will be used to represent sensed creatures when they cannot be seen directly.

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

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

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

|-
| {{text anchor|SKILL_RATE}}
| Caste
|
*[[skill_token]]
*<% of improvement points gained>
*<unused counter rate>
*<rust counter rate>
*<demotion counter rate>
| Like {{token|SKILL_RATES|c}}, but applies to individual skills instead. Requires {{token|CAN_LEARN|c}} or {{token|INTELLIGENT|c}} to function.

|-
| {{text anchor|SKILL_RATES}}
| Caste
|
*<% of improvement points gained>
*<unused counter rate>
*<rust counter rate>
*<demotion counter rate>
| Affects skill gain and decay. Lower numbers in the last three slots make decay occur faster ([SKILL_RATES:100:1:1:1] would cause rapid decay). The counter rates may also be replaced with NONE.
Default is [SKILL_RATES:100:8:16:16]. Requires {{token|CAN_LEARN|c}} or {{token|INTELLIGENT|c}} to function.

|-
| {{text anchor|SKILL_RUST_RATE}}
| Caste
|
*[[skill_token]]
*value
*value
*value
| The rate at which this skill decays. Lower values cause the skill to decay faster. Requires {{token|CAN_LEARN|c}} or {{token|INTELLIGENT|c}} to function.

|-
| {{text anchor|SKILL_RUST_RATES}}
| Caste
|
*value
*value
*value
| The rate at which all skills decay. Lower values cause the skills to decay faster. Requires {{token|CAN_LEARN|c}} or {{token|INTELLIGENT|c}} to function.

|-
| {{text anchor|SLAIN_CASTE_SPEECH}}
| Caste
|
*[[Speech file|text set]]
| Caste-specific {{token|SLAIN_SPEECH|c}}.

|-
| {{text anchor|SLAIN_SPEECH}}
| Creature
|
*[[Speech file|text set]]
| Boasting speeches relating to killing this creature. Examples include [[text_dwarf.txt/raw|text_dwarf.txt]] (<code>[SLAIN_SPEECH:SLAIN_DWARF]</code>) and text_elf.txt (<code>[SLAIN_SPEECH:SLAIN_ELF]</code>) in data\vanilla\vanilla_creatures\objects.

|-
| {{text anchor|SLOW_LEARNER}}
| Caste
|
| Allows the creature to learn skills without making the creature be considered sapient, though only at half of the normal rate (equivalent to {{token|SKILL_LEARN_RATES|c|50}}). All creatures that use this token in vanilla use it alongside {{token|CAN_LEARN|c}}, so it is not well known what it does by itself. Used by a number of 'primitive' creatures (like [[ogre]]s, [[giant]]s and [[troglodyte]]s) in the vanilla game. Prevents a player from recruiting nobility, even basic ones. (clarify?) Creatures with this token combined with {{token|EVIL|c}} can become domesticated by civilizations with {{token|USE_EVIL_ANIMALS|e}}, as seen commonly with goblin civilizations domesticating [[troll]s.

|-
| {{text anchor|SMALL_REMAINS}}
| Caste
|
| Creature leaves "[[item token#REMAINS|remains]]" instead of a corpse. Used by [[vermin]].

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

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

|-
| {{text anchor|SOUND}}
| Caste
|
* Sound application (currently accepts ALERT or PEACEFUL_INTERMITTENT)
* Sound range (in tiles)
* Sound delay (lower values = sound is produced more often)
* VOCALIZATION or NONE (determines whether the sound requires breathing or not)
* First-person description
* Third-person description
* Description when out of sight
| Creature makes sounds periodically, which can be heard in Adventure mode.
* First-person reads "You '''bark'''"
* Third-person reads "The [[capybara]] '''barks'''"
* Out of sight reads "You hear '''a loud bark'''"
with the text in bold being the description arguments of the token.

|-
| {{text anchor|SOURCE_HFID}}
| Creature
|
*Integer
| Found on generated [[angel]]s. This is the historical figure ID of the deity with which the angel is associated. Since HFIDs are not predictable before worldgen, this isn't terribly usable in non-lua mods.

|-
| {{text anchor|SPECIFIC_FOOD}}
| Caste
|
* PLANT or CREATURE
* Plant/creature ID
| Creature will only appear in biomes with this plant or creature available. Grazers given a specific type of grass (such as [[panda]]s and [[bamboo]]) will only eat that grass and nothing else, risking starvation if there's none available.

|-
| {{text anchor|SPHERE}}
| Creature
|
* [[Sphere#Available_spheres|sphere]]
| Sets what religious spheres the creature is aligned to, for purposes of being worshipped via the {{token|POWER|c}} token. Affects the creature's name. Creatures with spheres opposed to Death (ie: HEALING, LONGEVITY, YOUTH) will be much less likely to pursue the secrets of life and death.

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

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

|-
| {{text anchor|SPREAD_EVIL_SPHERES_IF_RULER}}
| Caste
|
| If the creature rules over a [[site]], it will cause the local landscape to be corrupted into [[Surroundings#Evil|evil surroundings]] associated with the creature's [[Creature_token#SPHERE|sphere]]s. The creature must have at least one of the following [[sphere]]s for this to take effect: BLIGHT, DEATH, DISEASE, DEFORMITY, NIGHTMARES. The first three kill vegetation, while the others sometimes do. The last two get [[Plant_token#EVIL|evil plants]] and [[Creature_token#EVIL|evil animals]] sometimes. NIGHTMARES gets [[bogeyman|bogeymen]]. [http://www.bay12forums.com/smf/index.php?topic=169696.msg8162224#msg8162224] Used by [[demon]]s in the vanilla game.

|-
| {{text anchor|STANCE_CLIMBER}}
| Caste
|
| Caste does not require <code>[[Body_token#GRASP|[GRASP]]]</code> body parts to climb -- it can climb with <code>[[Body_token#STANCE|[STANCE]]]</code> parts instead.

|-
| {{text anchor|STANDARD_GRAZER}}
| Caste
|
| Acts as {{token|GRAZER|c}} but set to 20000*G*(max size)^(-3/4), where G defaults to 100 but can be set in d_init, and the whole thing is trapped between 150 and 3 million. Used for all grazers in the default creature raws.

|-
| {{text anchor|STRANGE_MOODS}}
| Caste
|
| The creature will get [[strange mood]]s in fortress mode and can produce artifacts.

|-
| {{text anchor|SUPERNATURAL}}
| Caste
|
| Gives the creature knowledge of any secrets with <code>[[Interaction_token#IS_SECRET|[SUPERNATURAL_LEARNING_POSSIBLE]]]</code> that match its [[Creature_token#SPHERE|spheres]] and also prevents it from becoming a [[vampire]] or [[werebeast]]. Other effects are unknown.

|-
| {{text anchor|SWIMS_INNATE}}
| Caste
|
| The creature naturally knows how to swim perfectly and does not use the [[swimmer]] skill, as opposed to {{token|SWIMS_LEARNED|c}} below. However, Fortress mode AI never paths into water anyway, so it's less useful there.

|-
| {{text anchor|SWIMS_LEARNED}}
| Caste
|
| The creature swims only as well as their present [[Swimmer|swimming skill]] allows them to.

|-
| {{text anchor|SYNDROME_DILUTION_FACTOR}}
| Caste
| <[[Syndrome#SYN_IDENTIFIER|syndrome identifier]]>:<percentage>
| Dilutes the effects of syndromes which have the specified identifier. A percentage of 100 is equal to the regular syndrome effect severity, higher percentages reduce severity.
|}

{{alphabetical TOC|style=margin: 1em auto;}}

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

|-
| {{text anchor|TENDONS}}
| Caste
|
* [[material token]]
*healing rate
| The creature has tendons in its {{token|CONNECTIVE_TISSUE_ANCHOR|td}} tissues (bone or chitin by default). Cutting the bone/chitin tissue severs the tendons, disabling motor function if the target is a limb.

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

|-
| {{text anchor|TISSUE}}
| Creature
|
*name
| Begins defining a tissue in the creature file. Follow this with standard tissue definition tokens to define the tissue properties.

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

|-
| {{text anchor|TISSUE_LAYER_OVER}}
| Caste
|
*BY_TYPE, BY_CATEGORY, BY_TOKEN
*TYPE,CATEGORY, or TOKEN
*TISSUE
*LOCATION
| Alias for TISSUE_LAYER

|-
| {{text anchor|TISSUE_LAYER_UNDER}}
| Caste
|
*BY_TYPE, BY_CATEGORY, BY_TOKEN
*TYPE,CATEGORY, or TOKEN
*TISSUE
| Adds the tissue layer under a given part.
For example, an [[iron man]] has a gaseous poison within, and this tissue (GAS is its name) has the token [TISSUE_LEAKS] and its state is GAS, so when you puncture the iron outside and damage this tissue it leaks gas (can have a syndrome by using a previous one in the creature sample.) [TISSUE_LAYER_UNDER:BY_CATEGORY:ALL:{tissue}] {tissue} is what will be under the TISSUE_LAYER; here is an example Tissue from the 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]

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

|-
| {{text anchor|TRADE_CAPACITY}}
| Caste
|
*number
| How much the creature can carry when used by merchants. 1000 by default. Completely ignored if the animal does not also have PACK_ANIMAL or WAGON, instead using BODY_SIZE^(2/3)/20, even if they're a pack animal due to ANIMAL_ALWAYS_PACK_ANIMAL.

|-
| {{text anchor|TRAINABLE}}
| Caste
|
| Shortcut for {{token|TRAINABLE_HUNTING|c}} + {{token|TRAINABLE_WAR|c}}.

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

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

|-
| {{text anchor|TRANCES}}
| Caste
|
| Allows the creature to go into [[martial trance]]s. Used by dwarves in the vanilla game.

|-
| {{text anchor|TRAPAVOID}}
| Caste
|
| The creature will never trigger [[trap]]s it steps on. Used by a [[Trapavoid|number of creatures]]. Doesn't make the creature immune to remotely activated traps (like retractable spikes being triggered while the creature is standing over them). TRAPAVOID creatures lose this power if they're immobilized while standing in a trap, be it by stepping on thick web, being paralyzed or being knocked unconscious.

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

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

{{alphabetical TOC|style=margin: 1em auto;}}

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

|-
| {{text anchor|UBIQUITOUS}}
| Creature
|
| Creature will occur in every region with the correct biome. Does not apply to {{token|EVIL|c}}/{{token|GOOD|c}} tags. Supersedes {{token|FREQUENCY|c}} for the purposes of distributing populations through the map, they are present in every part of the valid biome. Respects {{token|FREQUENCY|c}} for the frequency of unit [[Creature token#CLUSTER_NUMBER|cluster]] spawns being of this species.

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

|-
| {{text anchor|UNDERSWIM}}
| Caste
|
| The creature is displayed as blue when in [[Water#Depth|7/7 water]]. Used on fish and amphibious creatures which swim under the water.

|-
| {{text anchor|UNIQUE_DEMON}}
| Caste
|
| Found on generated [[demon]]s; causes the game to create a single named instance of the demon, per caste, which will emerge from the underworld and take over civilizations during worldgen.

|-
| {{text anchor|USE_CASTE}}
| Creature
|
*new caste token
*old caste token
| Defines a new caste derived directly from a previous caste. The new caste inherits all properties of the old one. The effect of this tag is automatic if one has not yet defined any castes: "Any caste-level tag that occurs before castes are explicitly declared is saved up and placed on any caste that is declared later, unless the caste is explicitly derived from another caste."
Roostre: "When DF detects duplicate tokens in the raws of the same object, a failsafe seems to kick in; it takes the bottom-most of the duplicates, and disregards the others. In the case of tokens added by a mod, it prioritizes the duplicate in the mod." This means that if a tag is defined in the base-caste and redefined in the derived caste, the derived tag overwrites the base tag.

|-
| {{text anchor|USE_MATERIAL}}
| Creature
|
*new material ID
*old material ID
| Defines a new local creature material and populates it with all properties defined in the specified local creature material. A maximum of 200 materials can be defined on any given creature.

|-
| {{text anchor|USE_MATERIAL_TEMPLATE}}
| Creature
|
*new material token
*material template
| Defines a new local creature material and populates it with all properties defined in the specified template. A maximum of 200 materials can be defined on any given creature.

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

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

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

{{alphabetical TOC|style=margin: 1em auto;}}

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

|-
| {{text anchor|VEGETATION}}
| Caste
|
| Like {{token|AT_PEACE_WITH_WILDLIFE}}, but also makes the creature more valued in artwork by civilisations with the PLANT [[sphere]]. [http://www.bay12forums.com/smf/index.php?topic=169696.msg8316954#msg8316954] Used by [[grimeling]]s in the vanilla game.

|-
| {{text anchor|VERMIN_BITE}}
| Caste
|
*chance of occurrence{{verify}}
*verb (bitten, stung, etc.)
* [[material token]]
* [[Material_definition_token#Material_States|material state]]
| Enables vermin to bite other creatures, injecting the specified material. See {{token|SPECIALATTACK_INJECT_EXTRACT|c}} for details about injection - this token presumably works in a similar manner.{{verify}}

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

|-
| {{text anchor|VERMIN_FISH}}
| Creature
|
| The vermin appears in [[water]] and will attempt to swim around. Required to catch the vermin with [[fishing]] or [[Fishery|capturing a live fish]].

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

|-
| {{text anchor|VERMIN_HATEABLE}}
| Caste
|
| Some dwarves will [[Preferences|hate]] the creature and get unhappy thoughts when around it. See the [[Hateable|list of hateable vermin]] for details.

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

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

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

|-
| {{text anchor|VERMIN_NOTRAP}}
| Caste
|
| The creature cannot be caught in baited [[animal trap]]s; however, a "[[Trapper|catch live land animal]]" task may still be able to capture one if a dwarf finds one roaming around.

|-
| {{text anchor|VERMIN_ROTTER}}
| Creature
|
| The vermin are attracted to rotting stuff and loose food left in the open and cause unhappy thoughts to dwarves who encounter them. Present on flies, knuckle worms, acorn flies, and blood gnats.

|-
| {{text anchor|VERMIN_SOIL}}
| Creature
|
| The creature randomly appears near dirt or mud, and may be uncovered by creatures that have the {{token|ROOT_AROUND|c}} interaction such as [[goose|geese]] and [[chicken]]s. Dwarves will ignore the creature when given the "Capture live land animal" task.

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

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

|-
| {{text anchor|VESPERTINE}}
| Caste
|
| When set, the creature will only appear in the evening (between 8:00 PM and 10:05 PM) in [[Adventurer mode]].

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

|-
| {{text anchor|VISION_ARC}}
| Caste
|
*binocular vision arc
*non-binocular vision arc
| The width of the creature's vision arcs, in degrees (i.e. 0 to 360). The first number is binocular vision, the second is non-binocular vision. Binocular vision has a minimum of about 10 degrees, monocular, a maximum of about 350 degrees. Values past these limits will be accepted, but will default to ~10 degrees and ~350 degrees respectively. Defaults are 60:120.
|}

{{alphabetical TOC|style=margin: 1em auto;}}

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

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

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

|-
| {{text anchor|WEBIMMUNE}}
| Caste
|
| The creature will not get caught in thick [[web]]s. Used by creatures who can shoot thick webs (such as [[giant cave spider]]s) in order to make them immune to their own attacks.
|}

==Attack Tokens==

Attacks can use four different part selection criteria. Except for TISSUE_LAYER, the base game makes use of all of these in its attacks.

{| {{prettytable}}
|- bgcolor="#ddd"
! width="20%" | Part type token
! width="30%" | Arguments
! width="60%" | Description

|-
| {{text anchor|BODYPART}}
|
* BY_TYPE/BY_TOKEN/BY_CATEGORY
* type/token/category
| This attack uses a particular body part; for example, ATTACK:PUNCH:BODYPART:BY_TYPE:GRASP will make it use any part that can hold onto an object.

|-
| {{text anchor|TISSUE_LAYER}}
|
* BY_TYPE/BY_TOKEN/BY_CATEGORY
* type/token/category
* tissue layer
| This attack uses a specific tissue layer on a specific body part; ATTACK:SCRATCH:TISSUE_LAYER:BY_TYPE:GRASP:BONE will make it use the bone of the hands.

|-
| {{text anchor|CHILD_BODYPART_GROUP}}
|
* BY_TYPE/BY_TOKEN/BY_CATEGORY
* type/token/category
* BY_TYPE/BY_TOKEN/BY_CATEGORY
* type/token/category
| Uses a body part that is subordinate to another; ATTACK:SLAP:CHILD_BODYPART_GROUP:BY_CATEGORY:ARM_LOWER:BY_TYPE:GRASP will make it use every hand attached to each lower arm (so it will generate one attack per lower arm, each of which will use every hand on that arm, assuming there are multiple hands per arm).

|-
| {{text anchor|CHILD_TISSUE_LAYER_GROUP}}
|
* BY_TYPE/BY_TOKEN/BY_CATEGORY
* type/token/category
* BY_TYPE/BY_TOKEN/BY_CATEGORY
* type/token/category
* tissue layer
| As CHILD_BODYPART_GROUP, but specifying a tissue, too; ATTACK:BITE:CHILD_BODYPART_GROUP:BY_CATEGORY:HEAD:BY_CATEGORY:TOOTH

|}

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

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

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

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

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

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

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

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

|-
| {{text anchor|ATTACK_FLAG_WITH}}
| Caste
|
| Displays the name of the body part used to perform an attack while announcing it, e.g. "The weaver punches the bugbat with his right hand".

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

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

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

|-
| {{text anchor|ATTACK_FLAG_INDEPENDENT_MULTIATTACK}}
| Caste
|
| Multiple strikes with this attack can be performed with no penalty. The creature will use all attacks with this token at once.

|-
| {{text anchor|SPECIALATTACK_INJECT_EXTRACT}}
| Caste
|
*<[[material token]]>
*<[[Material_definition_token#Material_States|material state]]>
*<min quantity>
*<max quantity>
| When added to an attack, causes the attack to inject the specified material into the victim's bloodstream. Once injected, the material will participate in [[temperature|thermal]] exchange within the creature - injecting something like molten [[iron]] (INORGANIC:IRON:LIQUID) would cause most unmodded creatures to melt (note that some of the injected material also [[contaminant|splatters]] over the bodypart used to carry out the attack, so it should be protected appropriately). If the injected material has an associated [[syndrome]] with the [[Syndrome#SYN_INJECTED|[SYN_INJECTED]]] token, it will be transmitted to the victim. If the attack is blunt, the injected material lacks the [[Material definition token#ENTERS_BLOOD|[ENTERS_BLOOD]]] token, the attacked bodypart has no [[Tissue_definition_token#VASCULAR|[VASCULAR]]] tissues, or the victim is bloodless, the material will splatter over the attacked body part instead.

|-
| {{text anchor|SPECIALATTACK_INTERACTION}}
| Caste
|
*interaction
| When this attack lands successfully, a specified interaction will take effect on the target creature. The attack must break the target creature's skin in order to work. This will take effect in worldgen as well. If the attack would break skin, the interaction will occur '''before the attack actually lands'''.

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

==Tissue Layer Tokens==
Tissue layers are added to a creature's body parts by the creature tokens [[#TISSUE_LAYER|TISSUE_LAYER]], [[#TISSUE_LAYER_OVER|TISSUE_LAYER_OVER]], [[#TISSUE_LAYER_UNDER|TISSUE_LAYER_UNDER]], and the body detail plan token [[#TL_LAYERS|TL_LAYERS]].

These tissue layers are not the same thing as tissues, which are defined at creature level, but rather applications of the tissues. If the SKIN tissue of a creature is the more general and abstract notion of what skin is for that creature, then a tissue layer may be the "actual" skin on the creature's nose, head, or second toe. As most creatures have more than one body part, tissue layers are normally selected en masse.

Some tissue layer tokens are analogous to tissue definition tokens, e.g. [[#TL_CONNECTS|TL_CONNECTS]] to [[tissue_definition_token#CONNECTS|CONNECTS]].

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

|-
| {{text anchor|SELECT_TISSUE_LAYER}}
| Caste
|
*TISSUE
*BY_CATEGORY, BY_TYPE, BY_TOKEN
*Location - category, type, or token | Selects a tissue at a location
* (optional) FRONT, BACK, LEFT, RIGHT, TOP, BOTTOM, AROUND.
| Begins a selection of tissue layers.
[SELECT_TISSUE_LAYER:HEART:BY_TYPE:HEART]

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

|-
| {{text anchor|SET_TL_GROUP}}
| Caste
|
*TISSUE
*BY_CATEGORY, BY_TYPE, BY_TOKEN
*Location - category, type, or token
*tissue
| Begins a selection of tissue layers. Only usable for descriptor and cosmetic purposes.

Research has implied it may be redundant with SELECT_TISSUE_LAYER, as the latter allows for cosmetics as well as "functional" tokens such as TL_MAJOR_ARTERIES. Vanilla raws still use SET_TL_GROUP though, for all cosmetic purposes. More research is needed on this subject.

|-
| {{text anchor|PLUS_TL_GROUP}}
| Caste
|
*BY_CATEGORY, BY_TYPE, BY_TOKEN
*Location - category, type, or token
*tissue
| Adds tissue layers to those selected. Like SET_TL_GROUP, it may be redundant even if used in the vanilla raws.

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

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

|-
| {{text anchor|TISSUE_LAYER_APPEARANCE_MODIFIER}}
| Caste
|
*QUALITY
*lowest
*lower
*low
*median
*high
*higher
*highest
| Sets the range of qualities, including LENGTH, DENSE, HIGH_POSITION, CURLY, GREASY, WRINKLY

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

|-
| {{text anchor|TL_COLOR_MODIFIER}}
| Caste
|
*COLOR
*freq
*COLOR
*freq etc.
| Creates a list of colors/color patterns, giving each a relative frequency. If the given color or pattern does not exist, the tissue is described as being "transparent".

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

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

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

|-
| {{text anchor|TLCM_TIMING}}
| Caste
|
*ROOT
*start change window years
*days
*end change window years
*days
| Determines the point in the creature's life when the color change begins and ends.

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

|-
| {{text anchor|TL_HEALING_RATE}}
| Caste
|
*value
| Changes the HEALING_RATE of the selected tissue layers.

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

|-
| {{text anchor|TL_PAIN_RECEPTORS}}
| Caste
|
*value
| Changes the number of pain receptors for selected tissue layers.

|-
| {{text anchor|TL_RELATIVE_THICKNESS}}
| Caste
|
*value
| Changes the relative thickness for selected tissue layers.

|-
| {{text anchor|TL_VASCULAR}}
| Caste
|
*value
| Sets a new VASCULAR value (which modulates bleeding) for selected tissue layers.

|}

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

{{Category|Modding}}
{{Category|Tokens}}
[[ru:Creature token]]

Swimmer

2026-07-16T13:40:03Z

Quietust:

{{Quality|Exceptional}}
{{av}}
{{Skill
| color = 3:0
| skill = Swimmer
| specialty = Peasant
| profession = None
| job name = None
| tasks =
* Getting in and out of water
* Staying calm underwater
| attributes =
* Strength
* Agility
* Endurance
* Willpower
* Spatial Sense
* Kinesthetic Sense}}
'''Swimmer''' is a [[skill]] used by [[creature]]s to move through [[tile]]s containing [[depth|deep]] liquid (primarily [[water]]), and generally avoid drowning. Creatures may have a {{token|GAIT|c}} [[creature token]] that defines their movement [[gait|speed]] while swimming. However, a creature's effective swimming speed can be modified by its Swimmer skill level, up to its maximum gait limit at Legendary skill.

== Drowning ==
[[File:octopus_drowning.gif|thumb|284px|right|Octopus man drowning in air.]]
[[Dwarves]] with Dabbling (level 0) or no [[experience]] as Swimmers will start drowning immediately upon contact with deep surface [[water]] (i.e. surface water of 7/7 depth). Those of Novice (level 1) experience or greater can be in deep surface water without drowning. Any dwarf will start drowning in 7/7 water if there is more water on levels above them (e.g. at the bottom of a two-level-deep cistern, or the bottom of the ocean). A [[bridge]] (or, presumably, any other building that prevents access to the air above the water) will also cause non-aquatic/amphibious creatures to begin drowning in 7/7 water--this can be useful for disposing of trolls in a [[drowning chamber|drowning]] [[pit trap|pit]].

A way to delay the drowning of a dwarf (allowing them to survive long enough to become a Novice swimmer) is to drain a tiny amount of water, so that some tiles in the body of water are 6/7. If one of these 6/7 tiles strays over the dwarf, their drowning timer will be reset.

Any conscious, uninjured, non-stunned dwarf finding themselves in water of depth 4/7 or greater will try to leave, if they can find a path out of around 20 tiles in length or less.[http://www.bay12forums.com/smf/index.php?topic=116764.0] If they can't find an exit within that distance, they won't move. This even goes for babies and/or dwarves that cannot walk and are laying prone - they are able to breathe regardless until they learn enough swimming to crawl out.

Dabbling swimmers require a [[ramp]] or [[stairs|stairway]] within 20 tiles to have any chance of getting out of deep water. Fortunately, every natural shallow body of water has ramps.

Novice swimmers are able to get out of deep water safely without needing a ramp or stairway, but they will start drowning if [[Status_icons|stunned]]. Once that happens, it can be difficult to get them out, as they lose the ability to exit anywhere and behave just like an untrained or dabbling swimmer. Everyone is stunned by falling into water, rather than entering it calmly, which is what normally happens when they aren't entering it of their [[Carp|own free will]]. Adequate (level 2) swimmers do not panic and start drowning in that situation, even when attacked, so training to this level is highly recommended - higher levels only increase speed while swimming. Note that you can drown in [[magma]] as well, but most creatures tend to melt first.

== Teaching swimming ==
[[File:swimming_preview.png|thumb|230px|right|Water's level: 7 Swimming skill: Novice]]
It can be useful to teach swimming to your dwarves, especially your [[military]], to help them survive avoidable death (such as [[dodging]] into a [[murky pool]] or a [[river]]). Dwarves will normally refuse to enter tiles with more than 3/7 water, and a depth of 4/7 (but less than 7/7, lest they drown) is necessary to train the skill, but with a specially designed [[swimming pool]] it can easily be done.

[[Animal person|Animal people]] can't learn swimming due to a bug.{{Bug|9853}} Creatures who are innate swimmers (for example, fish like [[carp]]) do not build up Swimmer skill, as they have no use for it.

== Other Activities ==
Dwarves cannot fight while swimming - adults won't initiate most activities, but they may continue what they were doing before being submerged - even sleeping underwater, and gaining swimming experience for it!

Dwarves trapped in a swimming pool will often try to [[climb]] up a wall to escape the water, which is relatively safe for the climbing dwarf, as the water will cushion their fall - maybe not so for any dwarves that they [[Gravity|land]] on.

== Adventure Mode ==
In [[adventurer mode]], as a novice swimmer or better, by standing next to a body of water and moving carefully ({{k|alt}}+direction) in the direction of the water (falling 1 or 2 z-levels is not an issue), you can swim about and train your skill. To get out, {{k|alt}}-move against a shoreline and select the option to move above it, or simply move toward the shore if it has ramps. You can also {{k|h}}old onto a (non-smooth) rock wall or tree above the water's edge in order to climb out, even without any skill in [[Climber|climbing]]. It is advisable to train your skill in swimming above novice because getting stunned, winded, or tired will make you flounder and, most likely, die, even if you're just one or two tiles from a ramp. While floundering, there is a small chance to successfully move, so you might get lucky enough to make it out of the water, but don't count on it.

Swimmers can also dive and rise through the [[z-axis]] by pressing {{k|>}} and {{k|<}} respectively. Note that air-breathers will be unable to breathe without air in the tile above them, and without returning to the surface will eventually drown. (Sadly, there's no oxygen meter as of yet (Unless you're using DFhack!), so you'll never know when they're about to expire. Don't linger too long.)

In adventure mode, water preference can be switched between "when possible" and "necessary" by pressing {{k|m}}.

=== How long can you hold your breath? ===
The time before you drown is based on the following formula:

ticks = ((ES+TS) / 4) + 200

Where:
* ES = Endurance score
* TS = Toughness score
* ticks = ticks before you drown

The scores are based on the following table, using the dwarven average:
{| class=wikitable style="width:600px;"
! Endurance
! Toughness
! Drowning Ticks
|-
| absolutely inexhaustible || basically unbreakable || 1262-2700
|-
| indefatigable || incredibly tough || 1137-1262
|-
| very slow to tire || quite durable || 1012-1137
|-
| slow to tire || tough || 887-1012
|-
| (no description) || (no description) || 638-887
|-
| quick to tire || flimsy || 513-637
|-
| very quick to tire || very flimsy || 388-512
|-
| extremely quick to tire || remarkably flimsy || 263-387
|-
| truly quick to tire || shockingly fragile || 200-262
|}

Example: a dwarf with an average score of endurance and toughness will have 762 ticks to get out of the water, or drown.

However, keep in mind that drowning '''rapidly''' trains Endurance and Toughness, so by the time your dwarf drowns they might've trained both attributes slightly, giving you a few more ticks of leeway.

===Training your party===
To teach companions to swim, some patience is necessary. Enter a body of water until they follow you inside, then immediately get out. They will flounder around and attempt to get out before they drown, but as long as they make it back on land, they will gain swimming experience - repeat until they manage to swim without drowning. Drowning itself can also be beneficial, as certain attributes (notably toughness and endurance), greatly benefit from the strain caused by the experience. Provided that this experience does not reach its fatal conclusion, the toughness of your band should reach a point where it can only be exceeded by the larger or more powerful supernatural entities.

If the temperature (press {{k|P}}) is "cold" or "freezing" and it's close to sundown, get out of the water as quickly as you can - if you don't, the water may '''freeze''' while you are swimming, instantly killing you and leaving your frozen corpse encased in [[ice]] - a valuable find for archaeologists.

{{Skills}}

Swimmer

2026-07-16T13:39:50Z

Quietust: /* Training your party */

{{Quality|Exceptional}}
{{av}}
{{Skill
| color = 3:0
| skill = Swimmer
| specialty = Peasant
| profession = None
| job name = None
| tasks =
* Getting in and out of water
* Staying calm underwater
| attributes =
* Strength
* Agility
* Endurance
* Willpower
* Spatial Sense
* Kinesthetic Sense}}
'''Swimmer''' is a [[skill]] used by [[creature]]s to move through [[tile]]s containing [[depth|deep]] liquid (primarily [[water]]), and generally avoid drowning. Creatures may have a {{token|GAIT|c}} [[creature token]] that defines their movement [[gait|speed]] while swimming. However, a creature's effective swimming speed can be modified by its Swimmer skill level, up to its maximum gait limit at Legendary skill.

== Drowning ==
[[File:octopus_drowning.gif|thumb|284px|right|Octopus man drowning in air.]]
[[Dwarves]] with Dabbling (level 0) or no [[experience]] as Swimmers will start drowning immediately upon contact with deep surface [[water]] (i.e. surface water of 7/7 depth). Those of Novice (level 1) experience or greater can be in deep surface water without drowning. Any dwarf will start drowning in 7/7 water if there is more water on levels above them (e.g. at the bottom of a two-level-deep cistern, or the bottom of the ocean). A [[bridge]] (or, presumably, any other building that prevents access to the air above the water) will also cause non-aquatic/amphibious creatures to begin drowning in 7/7 water--this can be useful for disposing of trolls in a [[drowning chamber|drowning]] [[pit trap|pit]].

A way to delay the drowning of a dwarf (allowing them to survive long enough to become a Novice swimmer) is to drain a tiny amount of water, so that some tiles in the body of water are 6/7. If one of these 6/7 tiles strays over the dwarf, their drowning timer will be reset.

Any conscious, uninjured, non-stunned dwarf finding themselves in water of depth 4/7 or greater will try to leave, if they can find a path out of around 20 tiles in length or less.[http://www.bay12forums.com/smf/index.php?topic=116764.0] If they can't find an exit within that distance, they won't move. This even goes for babies and/or dwarves that cannot walk and are laying prone - they are able to breathe regardless until they learn enough swimming to crawl out.

Dabbling swimmers require a [[ramp]] or [[stairs|stairway]] within 20 tiles to have any chance of getting out of deep water. Fortunately, every natural shallow body of water has ramps.

Novice swimmers are able to get out of deep water safely without needing a ramp or stairway, but they will start drowning if [[Status_icons|stunned]]. Once that happens, it can be difficult to get them out, as they lose the ability to exit anywhere and behave just like an untrained or dabbling swimmer. Everyone is stunned by falling into water, rather than entering it calmly, which is what normally happens when they aren't entering it of their [[Carp|own free will]]. Adequate (level 2) swimmers do not panic and start drowning in that situation, even when attacked, so training to this level is highly recommended - higher levels only increase speed while swimming. Note that you can drown in [[magma]] as well, but most creatures tend to melt first.

== Teaching swimming ==
[[File:swimming_preview.png|thumb|230px|right|Water's level: 7 Swimming skill: Novice]]
It can be useful to teach swimming to your dwarves, especially your [[military]], to help them survive avoidable death (such as [[dodging]] into a [[murky pool]] or a [[river]]). Dwarves will normally refuse to enter tiles with more than 3/7 water, and a depth of 4/7 (but less than 7/7, lest they drown) is necessary to train the skill, but with a specially designed [[swimming pool]] it can easily be done.

[[Animal person|Animal people]] can't learn swimming due to a bug.{{Bug|9853}} Creatures who are innate swimmers (for example, fish like [[carp]]) do not build up Swimmer skill, as they have no use for it.

== Other Activities ==
Dwarves cannot fight while swimming - adults won't initiate most activities, but they may continue what they were doing before being submerged - even sleeping underwater, and gaining swimming experience for it!

Dwarves trapped in a swimming pool will often try to [[climb]] up a wall to escape the water, which is relatively safe for the climbing dwarf, as the water will cushion their fall - maybe not so for any dwarves that they [[Gravity|land]] on.

== Adventure Mode ==
In [[adventurer mode]], as a novice swimmer or better, by standing next to a body of water and moving carefully ({{k|alt}}+direction) in the direction of the water (falling 1 or 2 z-levels is not an issue), you can swim about and train your skill. To get out, {{k|alt}}-move against a shoreline and select the option to move above it, or simply move toward the shore if it has ramps. You can also {{k|h}}old onto a (non-smooth) rock wall or tree above the water's edge in order to climb out, even without any skill in [[Climber|climbing]]. It is advisable to train your skill in swimming above novice because getting stunned, winded, or tired will make you flounder and, most likely, die, even if you're just one or two tiles from a ramp. While floundering, there is a small chance to successfully move, so you might get lucky enough to make it out of the water, but don't count on it.

Swimmers can also dive and rise through the [[z-axis]] by pressing {{k|>}} and {{k|<}} respectively. Note that air-breathers will be unable to breathe without air in the tile above them, and without returning to the surface will eventually drown. (Sadly, there's no oxygen meter as of yet (Unless you're using DFhack!), so you'll never know when they're about to expire. Don't linger too long.)

In adventure mode, water preference can be switched between "when possible" and "necessary" by pressing {{k|m}}.

=== How long can you hold your breath? ===
The time before you drown is based on the following formula:

ticks = ((ES+TS) / 4) + 200

Where:
* ES = Endurance score
* TS = Toughness score
* ticks = ticks before you drown

The scores are based on the following table, using the dwarven average:
{| class=wikitable style="width:600px;"
! Endurance
! Toughness
! Drowning Ticks
|-
| absolutely inexhaustible || basically unbreakable || 1262-2700
|-
| indefatigable || incredibly tough || 1137-1262
|-
| very slow to tire || quite durable || 1012-1137
|-
| slow to tire || tough || 887-1012
|-
| (no description) || (no description) || 638-887
|-
| quick to tire || flimsy || 513-637
|-
| very quick to tire || very flimsy || 388-512
|-
| extremely quick to tire || remarkably flimsy || 263-387
|-
| truly quick to tire || shockingly fragile || 200-262
|}

Example: a dwarf with an average score of endurance and toughness will have 762 ticks to get out of the water, or drown.

However, keep in mind that drowning '''rapidly''' trains Endurance and Toughness, so by the time your dwarf drowns they might've trained both attributes slightly, giving you a few more ticks of leeway.

===Training your party===
To teach companions to swim, some patience is necessary. Enter a body of water until they follow you inside, then immediately get out. They will flounder around and attempt to get out before they drown, but as long as they make it back on land, they will gain swimming experience - repeat until they manage to swim without drowning. Drowning itself can also be beneficial, as certain attributes (notably toughness and endurance), greatly benefit from the strain caused by the experience. Provided that this experience does not reach its fatal conclusion, the toughness of your band should reach a point where it can only be exceeded by the larger or more powerful supernatural entities.

If the temperature (press {{k|P}}) is "cold" or "freezing" and it's close to sundown, get out of the water as quickly as you can - if you don't, the water may '''freeze'' while you are swimming, instantly killing you and leaving your frozen corpse encased in [[ice]] - a valuable find for archaeologists.

{{Skills}}

Afrovenator

2026-07-15T13:48:32Z

Quietust: where on earth did that nonsense grammar come from?

{{Quality|Fine}}
{{Creaturelookup/0
|image=afrovenator_sprites.png
|portrait=afrovenator_portrait_anim.gif}}
{{av}}
{{creaturedesc}}
'''Afrovenators''' are [[extinct]] megalosaurid theropod dinosaur [[creature]]s from the [[wikipedia:Jurassic|Jurassic]] era, that can be found in [[savage]] versions of [[tropical]] [[shrubland]]s, tropical [[savanna]]s and [[badlands]]. They are horrendously large, intimidating and deadly dinosaurs with a vicious bite attack, as well as the ability to whip their tails. Their size is slightly less than double that of a bull [[moose]]. A young afrovenator is called an ''afrovenator hatchling''.

If captured, they can be trained for both hunting and combat, and they are also an [[exotic mount]]. Being reptiles, they are a decent source of eggs.

Some [[Dwarf|dwarves]] like afrovenators for their ''graceful movement''.

[[File:Afrovenator Abakensis by PaleoGeek.jpg|thumb|500px|center|Artist rendition of the creature.]]
{{gamedata}}
{{Creatures}}

File:Scorpion-panel2-col.png

2026-07-14T12:59:43Z

Quietust: link to original source for this image (if I did it wrong, please update it)

Giant desert scorpion versus its natural enemy.

From the saga of [https://lparchive.org/Dwarf-Fortress-Headshoots/Update%2014/ Headshoots]

Jaekelopterus

2026-07-13T13:23:06Z

Quietust:

{{Quality|Tattered}}
{{Creaturelookup/0
|image=jaekelopterus_sprites.png
|portrait=jaekelopterus_portrait_anim.gif
|wiki=Jaekelopterus rhenaniae}}
{{av}}
{{creaturedesc}}
'''Jaekelopterus''' is an [[extinct]] [[aquatic]] arthropod from the [[wikipedia:Silurian|Silurian]] era, found in [[temperate]] freshwater or brackish [[lake]]s and [[river]]s. Despite their size, they are not butcherable or fishable, although they have the {{token|COOKABLE_LIVE|creature}} token (which serves no purpose, as they are not classified as vermin).

Some dwarves [[Preferences|like]] jaekelopterus for their ''beauty''.

{{D for Dwarf}}
Scientists say that it might have a taste for human flesh. Its preferences for dwarven flesh, or lack there of, are unknown as of now.

{{gamedata}}
{{Creatures}}

Spinosaurus

2026-07-13T13:21:26Z

Quietust:

{{av}}
'''Spinosaurus''' is a large, semi-aquatic extinct carnivorous dinosaur from the Cretaceous period. There are two species of Spinosaurus in Dwarf Fortress:

*[[Spinosaurus aegyptiacus]]
*[[Spinosaurus mirabilis]]

{{disambig}}

Wiwaxia

2026-07-11T02:45:11Z

Quietust:

{{Quality|Tattered}}
{{verminlookup/0
|image=wiwaxia_sprites.png
|portrait=wiwaxia_portrait_anim.gif
|wiki=Wiwaxia corrugata}}
{{av}}
{{creaturedesc}}
'''Wiwaxia''' is an [[extinct]] [[aquatic]] [[vermin]] from the [[wikipedia:Cambrian|Cambrian]] era, found in [[tropical]] oceans or saltwater [[pool]]s. They are not butcherable or fishable, although they have the {{token|COOKABLE_LIVE|creature}} token.

Some dwarves [[Preferences|like]] wiwaxia for their ''spines''.
{{gamedata}}
{{Vermin}}

Tullimonstrum

2026-07-11T02:45:09Z

Quietust:

{{Quality|Tattered}}
{{verminlookup/0
|image=tullimonstrum_sprites.png
|portrait=tullimonstrum_portrait_anim.gif}}
{{av}}
{{creaturedesc}}

{{gamedata}}
{{Vermin}}

Sharovipteryx

2026-07-11T02:45:07Z

Quietust:

{{Quality|Tattered}}
{{verminlookup/0
|image=sharovipteryx_sprites.png
|portrait=sharovipteryx_portrait_anim.gif}}
{{av}}
{{creaturedesc}}

{{gamedata}}
{{Vermin}}

Pterodactylus

2026-07-11T02:45:05Z

Quietust:

{{Quality|Tattered}}
{{verminlookup/0
|image=pterodactylus_sprites.png
|portrait=pterodactylus_portrait_anim.gif}}
{{av}}
{{creaturedesc}}

{{gamedata}}
{{Vermin}}

Procompsognathus

2026-07-11T02:45:03Z

Quietust:

{{Quality|Tattered}}
{{verminlookup/0
|image=procompsognathus_sprites.png
|portrait=procompsognathus_portrait_anim.gif}}
{{av}}
{{creaturedesc}}

{{gamedata}}
{{Vermin}}

Ostenocaris

2026-07-11T02:45:01Z

Quietust:

{{Quality|Tattered}}
{{verminlookup/0
|image=ostenocaris_sprites.png
|portrait=ostenocaris_portrait_anim.gif}}
{{av}}
{{creaturedesc}}

{{gamedata}}
{{Vermin}}

Opabinia

2026-07-11T02:44:59Z

Quietust:

{{Quality|Tattered}}
{{verminlookup/0
|image=opabinia_sprites.png
|portrait=opabinia_portrait_anim.gif
|wiki=Opabinia regalis}}
{{av}}
{{creaturedesc}}
'''Opabinia''' is an [[extinct]] [[aquatic]] [[vermin]] from the [[wikipedia:Cambrian|Cambrian]] era, found in [[tropical]] oceans or saltwater [[pool]]s. They are not butcherable or fishable, although they have the {{token|COOKABLE_LIVE|creature}} token.

Some dwarves [[Preferences|like]] opabinia for their ''eyes'' and ''grasping proboscis''.
{{gamedata}}
{{Vermin}}

Oestocephalus

2026-07-11T02:44:56Z

Quietust:

{{Quality|Tattered}}
{{verminlookup/0
|image=oestocephalus_sprites.png
|portrait=oestocephalus_portrait_anim.gif}}
{{av}}
{{creaturedesc}}

{{gamedata}}
{{Vermin}}

Mimetaster

2026-07-11T02:44:54Z

Quietust:

{{Quality|Tattered}}
{{verminlookup/0
|image=mimetaster_sprites.png
|portrait=mimetaster_portrait_anim.gif
|wiki=Mimetaster}} 
{{av}}
{{creaturedesc}}
'''Mimetaster''' is an [[extinct]] [[aquatic]] [[vermin]] from the [[wikipedia:Devonian|Devonian]] era, found in [[temperate]] [[ocean]]s and saltwater [[pool]]s. They might be{{verify|they might not be big enough}} usable for the [[fishing industry]], but only by [[Fishery|capturing a live fish]], rather than normal fishing, and also [[Kitchen|cookable]] without cleaning.

Some dwarves [[Preferences|like]] mimetaster for their ''tilted walk''.
{{gamedata}}
{{Vermin}}

Meganeura

2026-07-11T02:44:52Z

Quietust:

{{Quality|Tattered}}
{{verminlookup/0
|image=meganeura_sprites.png
|portrait=meganeura_portrait_anim.gif}}
{{av}}
{{creaturedesc}}

{{gamedata}}
{{Vermin}}

Linhenykus

2026-07-11T02:44:48Z

Quietust:

{{Quality|Tattered}}
{{verminlookup/0
|image=linhenykus_sprites.png
|portrait=linhenykus_portrait_anim.gif}}
{{av}}
{{creaturedesc}}

{{gamedata}}
{{Vermin}}

Jeholopterus

2026-07-11T02:44:37Z

Quietust:

{{Quality|Tattered}}
{{verminlookup/0
|image=jeholopterus_sprites.png
|portrait=jeholopterus_portrait_anim.gif}}
{{av}}
{{creaturedesc}}

{{gamedata}}
{{Vermin}}

Hallucigenia

2026-07-11T02:44:31Z

Quietust:

{{Quality|Tattered}}
{{verminlookup/0
|image=hallucigenia_sprites.png
|portrait=hallucigenia_portrait_anim.gif
|wiki=Hallucigenia sparsa}}
{{av}}
{{creaturedesc}}
'''Hallucigenia''' is an [[extinct]] [[aquatic]] [[vermin]] from the [[wikipedia:Cambrian|Cambrian]] era, found in [[tropical]] oceans or saltwater [[pool]]s. They are not butcherable or fishable, although they have the {{token|COOKABLE_LIVE|creature}} token.

Some dwarves [[Preferences|like]] hallucigenia for their ''spines'' and ''lobopods''.

{{D for Dwarf}}

In addition to its regular Biomes, Hallucigenia can also be found beneath The Tree. Dedicate your heart.

{{gamedata}}
{{Vermin}}

Haikouichthys

2026-07-11T02:44:22Z

Quietust:

{{Quality|Tattered}}
{{verminlookup/0
|image=haikouichthys_sprites.png
|portrait=haikouichthys_portrait_anim.gif
|wiki=haikouichthys ercaicunensis}}
{{av}}
{{creaturedesc}}
'''Haikouichthys''' is an [[extinct]] [[aquatic]] [[vermin]] from the [[wikipedia:Cambrian|Cambrian]] era, found in [[tropical]] oceans or saltwater [[pool]]s. They are not fishable, and too small to butcher.

Some dwarves [[Preferences|like]] haikouichthys for their ''extra eyes'' and ''fins''.
{{gamedata}}
{{Vermin}}

Drepanopterus

2026-07-11T02:44:11Z

Quietust:

{{Quality|Tattered}}
{{verminlookup/0
|image=drepanopterus_sprites.png
|portrait=drepanopterus_portrait_anim.gif
|wiki=Drepanopterus}} 
{{av}}
{{creaturedesc}}
'''Drepanopterus''' is an [[extinct]] [[aquatic]] [[vermin]] from the [[wikipedia:Devonian|Devonian]] era, found in [[temperate]] freshwater or brackish [[lake]]s and [[river]]s. They are usable for the [[fishing industry]], but only by [[Fishery|capturing a live fish]], rather than normal fishing, and also [[Kitchen|cookable]] with out cleaning.

Some dwarves [[Preferences|like]] drepanopterus for their ''broad heads''.
{{gamedata}}
{{Vermin}}

Archaeopteryx

2026-07-11T02:44:03Z

Quietust:

{{Quality|Tattered}}
{{verminlookup/0
|image=archaeopteryx_sprites.png
|portrait=archaeopteryx_portrait_anim.gif}}
{{av}}
{{creaturedesc}}

{{gamedata}}
{{Vermin}}

Anomalocaris

2026-07-11T02:43:38Z

Quietust: Now that I think about it, these should be using {{verminlookup/0}} as well

{{Quality|Tattered}}
{{verminlookup/0
|image=anomalocaris_sprites.png
|portrait=anomalocaris_portrait_anim.gif
|wiki=Anomalocaris canadensis}}
{{av}}
{{creaturedesc}}
'''Anomalocaris''' is an [[extinct]] [[aquatic]] [[vermin]] from the [[wikipedia:Cambrian|Cambrian]] era, found in [[tropical]] oceans or saltwater [[pool]]s. They are not butcherable or fishable, although they have the {{token|COOKABLE_LIVE|creature}} token.

Some dwarves [[Preferences|like]] anomalocaris for their ''frontal appendages''.
{{gamedata}}
{{Vermin}}

Save version

2026-07-10T16:36:24Z

Quietust: add save versions for 53.13 + 53.14 + 53.15 - notably, 53.14 did NOT change the save version

Every world in ''Dwarf Fortress'' contains an internal '''save version''' ID number to denote the version in which it was last saved, as well as the version in which it was originally generated. When a world is loaded, the game uses this value to determine how to process all of the data it reads - data which didn't exist at the time is generated from scratch (e.g. [[v0.34:minecart|hauling routes]], added in version 0.34.08), and data which is no longer used (e.g. [[DF2014:thought|basic thoughts]], replaced with emotions in version 0.42.01) gets skipped.

Not all ''Dwarf Fortress'' releases actually incremented the save version number (especially those which only fixed bugs), and some releases incremented it multiple times (once for each piece of new data stored).

This number normally isn't visible during gameplay, but various tools (such as [[DFHack]]) can be used to query it.

{| class=wikitable
!Version number
!Save version code
|-
| [[Release information/53.15|53.15]]
| 3600
|-
| [[Release information/53.14|53.14]]
| 3547
|-
| [[Release information/53.13|53.13]]
| 3547
|-
| [[Release information/53.12|53.12]]
| 3544
|-
| [[Release information/53.11|53.11]]
| 3543
|-
| [[Release information/53.10|53.10]]
| 3543
|-
| [[Release information/53.09|53.09]]
| 3543
|-
| [[Release information/53.08|53.08]]
| 3543
|-
| [[Release information/53.07|53.07]]
| 3543
|-
| [[Release information/53.06|53.06]]
| 3537
|-
| [[Release information/53.05|53.05]]
| 3535
|-
| [[Release information/53.04|53.04]]
| 3535
|-
| [[Release information/53.03|53.03]]
| 3535
|-
| [[Release information/53.02|53.02]]
| 3534
|-
| [[Release information/53.01|53.01]]
| 3534
|-
| [[Release information/52.05|52.05]]
| 3021
|-
| [[Release information/52.04|52.04]]
| 3021
|-
| [[Release information/52.03|52.03]]
| 3021
|-
| [[Release information/52.02|52.02]]
| 3015
|-
| [[Release information/52.01|52.01]]
| 3015
|-
| [[Release information/51.13|51.13]]
| 3015
|-
| [[Release information/51.12|51.12]]
| 3015
|-
| [[Release information/51.11|51.11]]
| 3014
|-
| [[Release information/51.10|51.10]]
| 3013
|-
| [[Release information/51.09|51.09]]
| 3013
|-
| [[Release information/51.08|51.08]]
| 3013
|-
| [[Release information/51.07|51.07]]
| 3013
|-
| [[Release information/51.06|51.06]]
| 3013
|-
| [[Release information/51.05|51.05]]
| 3013
|-
| [[Release information/51.04|51.04]]
| 3013
|-
| [[Release information/51.03|51.03]]
| 3013
|-
| [[Release information/51.02|51.02]]
| 3013
|-
| [[Release information/51.01|51.01]]
| Various (beta)
|-
| [[Release information/50.15|50.15]]
| 2082
|-
| [[Release information/50.14|50.14]]
| 2082
|-
| [[Release information/50.13|50.13]]
| 2082
|-
| [[Release information/50.12|50.12]]
| 2081
|-
| [[Release information/50.11|50.11]]
| 2081
|-
| [[Release information/50.10|50.10]]
| 2081
|-
| [[Release information/50.09|50.09]]
| 2081
|-
| [[Release information/50.08|50.08]]
| 2081
|-
| [[Release information/50.07|50.07]]
| 2081
|-
| [[Release information/50.06|50.06]]
| 2081
|-
| [[Release information/50.05|50.05]]
| 2081
|-
| [[Release information/50.04|50.04]]
| 2080
|-
| [[Release information/50.03|50.03]]
| 2080
|-
| [[Release information/50.02|50.02]]
| 2079
|-
| [[Release information/50.01|50.01]]
| 2078
|-
| [[DF2014:Release information/0.47.05|0.47.05]]
| 1716
|-
| [[DF2014:Release information/0.47.04|0.47.04]]
| 1715
|-
| [[DF2014:Release information/0.47.03|0.47.03]]
| 1712
|-
| [[DF2014:Release information/0.47.02|0.47.02]]
| 1711
|-
| [[DF2014:Release information/0.47.01|0.47.01]]
| 1710
|-
| [[DF2014:Release information/0.44.12|0.44.12]]
| 1625
|-
| [[DF2014:Release information/0.44.11|0.44.11]]
| 1623
|-
| [[DF2014:Release information/0.44.10|0.44.10]]
| 1620
|-
| [[DF2014:Release information/0.44.09|0.44.09]]
| 1614
|-
| [[DF2014:Release information/0.44.08|0.44.08]]
| 1613
|-
| [[DF2014:Release information/0.44.07|0.44.07]]
| 1612
|-
| [[DF2014:Release information/0.44.06|0.44.06]]
| 1611
|-
| [[DF2014:Release information/0.44.05|0.44.05]]
| 1604
|-
| [[DF2014:Release information/0.44.04|0.44.04]]
| 1603
|-
| [[DF2014:Release information/0.44.03|0.44.03]]
| 1600
|-
| [[DF2014:Release information/0.44.02|0.44.02]]
| 1597
|-
| [[DF2014:Release information/0.44.01|0.44.01]]
| 1596
|-
| [[DF2014:Release information/0.43.05|0.43.05]]
| 1556
|-
| [[DF2014:Release information/0.43.04|0.43.04]]
| 1555
|-
| [[DF2014:Release information/0.43.03|0.43.03]]
| 1553
|-
| [[DF2014:Release information/0.43.02|0.43.02]]
| 1552
|-
| [[DF2014:Release information/0.43.01|0.43.01]]
| 1551
|-
| [[DF2014:Release information/0.42.06|0.42.06]]
| 1542
|-
| [[DF2014:Release information/0.42.05|0.42.05]]
| 1537
|-
| [[DF2014:Release information/0.42.04|0.42.04]]
| 1534
|-
| [[DF2014:Release information/0.42.03|0.42.03]]
| 1533
|-
| [[DF2014:Release information/0.42.02|0.42.02]]
| 1532
|-
| [[DF2014:Release information/0.42.01|0.42.01]]
| 1531
|-
| [[DF2014:Release information/0.40.24|0.40.24]]
| 1481
|-
| [[DF2014:Release information/0.40.23|0.40.23]]
| 1480
|-
| [[DF2014:Release information/0.40.22|0.40.22]]
| 1479
|-
| [[DF2014:Release information/0.40.21|0.40.21]]
| 1478
|-
| [[DF2014:Release information/0.40.20|0.40.20]]
| 1477
|-
| [[DF2014:Release information/0.40.19|0.40.19]]
| 1474
|-
| [[DF2014:Release information/0.40.18|0.40.18]]
| 1473
|-
| [[DF2014:Release information/0.40.17|0.40.17]]
| 1472
|-
| [[DF2014:Release information/0.40.16|0.40.16]]
| 1471
|-
| [[DF2014:Release information/0.40.15|0.40.15]]
| 1470
|-
| [[DF2014:Release information/0.40.14|0.40.14]]
| 1469
|-
| [[DF2014:Release information/0.40.13|0.40.13]]
| 1462
|-
| [[DF2014:Release information/0.40.12|0.40.12]]
| 1459
|-
| [[DF2014:Release information/0.40.11|0.40.11]]
| 1456
|-
| [[DF2014:Release information/0.40.10|0.40.10]]
| 1452
|-
| [[DF2014:Release information/0.40.09|0.40.09]]
| 1451
|-
| [[DF2014:Release information/0.40.08|0.40.08]]
| 1449
|-
| [[DF2014:Release information/0.40.07|0.40.07]]
| 1448
|-
| [[DF2014:Release information/0.40.06|0.40.06]]
| 1446
|-
| [[DF2014:Release information/0.40.05|0.40.05]]
| 1445
|-
| [[DF2014:Release information/0.40.04|0.40.04]]
| 1444
|-
| [[DF2014:Release information/0.40.03|0.40.03]]
| 1443
|-
| [[DF2014:Release information/0.40.02|0.40.02]]
| 1442
|-
| [[DF2014:Release information/0.40.01|0.40.01]]
| 1441
|-
| [[v0.34:Release information/0.34.11|0.34.11]]
| 1404
|-
| [[v0.34:Release information/0.34.10|0.34.10]]
| 1403
|-
| [[v0.34:Release information/0.34.09|0.34.09]]
| 1402
|-
| [[v0.34:Release information/0.34.08|0.34.08]]
| 1400
|-
| [[v0.34:Release information/0.34.07|0.34.07]]
| 1383
|-
| [[v0.34:Release information/0.34.06|0.34.06]]
| 1382
|-
| [[v0.34:Release information/0.34.05|0.34.05]]
| 1378
|-
| [[v0.34:Release information/0.34.04|0.34.04]]
| 1377
|-
| [[v0.34:Release information/0.34.03|0.34.03]]
| 1376
|-
| [[v0.34:Release information/0.34.02|0.34.02]]
| 1374
|-
| [[v0.34:Release information/0.34.01|0.34.01]]
| 1372
|-
| [[v0.31:Release information/0.31.25|0.31.25]]
| 1362
|-
| [[v0.31:Release information/0.31.24|0.31.24]]
| 1361
|-
| [[v0.31:Release information/0.31.23|0.31.23]]
| 1360
|-
| [[v0.31:Release information/0.31.22|0.31.22]]
| 1359
|-
| [[v0.31:Release information/0.31.21|0.31.21]]
| 1354
|-
| [[v0.31:Release information/0.31.20|0.31.20]]
| 1353
|-
| [[v0.31:Release information/0.31.19|0.31.19]]
| 1351
|-
| [[v0.31:Release information/0.31.18|0.31.18]]
| 1341
|-
| [[v0.31:Release information/0.31.17|0.31.17]]
| 1340
|-
| [[v0.31:Release information/0.31.16|0.31.16]]
| 1327
|-
| [[v0.31:Release information/0.31.15|0.31.15]]
| 1326
|-
| [[v0.31:Release information/0.31.14|0.31.14]]
| 1325
|-
| [[v0.31:Release information/0.31.13|0.31.13]]
| 1323
|-
| [[v0.31:Release information/0.31.12|0.31.12]]
| 1311
|-
| [[v0.31:Release information/0.31.11|0.31.11]]
| 1310
|-
| [[v0.31:Release information/0.31.10|0.31.10]]
| 1305
|-
| [[v0.31:Release information/0.31.09|0.31.09]]
| 1304
|-
| [[v0.31:Release information/0.31.08|0.31.08]]
| 1300
|-
| [[v0.31:Release information/0.31.07|0.31.07]]
| Unknown
|-
| [[v0.31:Release information/0.31.06|0.31.06]]
| 1297
|-
| [[v0.31:Release information/0.31.05|0.31.05]]
| 1295
|-
| [[v0.31:Release information/0.31.04|0.31.04]]
| 1292
|-
| [[v0.31:Release information/0.31.03|0.31.03]]
| 1289
|-
| [[v0.31:Release information/0.31.02|0.31.02]]
| 1288
|-
| [[v0.31:Release information/0.31.01|0.31.01]]
| 1287
|-
| [[40d:Release information/0.28.181.40d|0.28.181.40d]]
| 1268
|-
| [[40d:Release information/0.28.181.40c|0.28.181.40c]]
| 1267
|-
| [[40d:Release information/0.28.181.40b|0.28.181.40b]]
| 1266
|-
| [[40d:Release information/0.28.181.40a|0.28.181.40a]]
| 1265
|-
| [[40d:Release information/0.28.181.39f|0.28.181.39f]]
| 1261
|-
| [[40d:Release information/0.28.181.39e|0.28.181.39e]]
| 1260
|-
| [[40d:Release information/0.28.181.39d|0.28.181.39d]]
| 1259
|-
| [[40d:Release information/0.28.181.39c|0.28.181.39c]]
| 1256
|-
| [[40d:Release information/0.28.181.39b|0.28.181.39b]]
| 1255
|-
| [[40d:Release information/0.28.181.39a|0.28.181.39a]]
| 1254
|-
| [[40d:Release information/0.27.176.38c|0.27.176.38c]]
| 1235
|-
| [[40d:Release information/0.27.176.38b|0.27.176.38b]]
| 1234
|-
| [[40d:Release information/0.27.176.38a|0.27.176.38a]]
| 1231
|-
| [[40d:Release information/0.27.173.38a|0.27.173.38a]]
| 1223
|-
| [[40d:Release information/0.27.169.33g|0.27.169.33g]]
| 1216
|-
| [[40d:Release information/0.27.169.33f|0.27.169.33f]]
| 1215
|-
| [[40d:Release information/0.27.169.33e|0.27.169.33e]]
| 1213
|-
| [[40d:Release information/0.27.169.33d|0.27.169.33d]]
| 1212
|-
| [[40d:Release information/0.27.169.33c|0.27.169.33c]]
| 1211
|-
| [[40d:Release information/0.27.169.33b|0.27.169.33b]]
| 1209
|-
| [[40d:Release information/0.27.169.33a|0.27.169.33a]]
| 1206
|-
| [[40d:Release information/0.27.169.32a|0.27.169.32a]]
| 1205
|-
| [[23a:Release information/0.23.130.23a|0.23.130.23a]]
| 1169
|-
| [[23a:Release information/0.23.125.23b|0.23.125.23b]]
| 1168
|-
| [[23a:Release information/0.23.125.23a|0.23.125.23a]]
| 1167
|-
| [[23a:Release information/0.22.123.23a|0.22.123.23a]]
| 1165
|-
| [[23a:Release information/0.22.121.23b|0.22.121.23b]]
| 1161
|-
| [[23a:Release information/0.22.121.23a|0.22.121.23a]]
| 1160
|-
| [[23a:Release information/0.22.120.23b|0.22.120.23b]]
| 1159
|-
| [[23a:Release information/0.22.120.23a|0.22.120.23a]]
| 1151
|-
| [[23a:Release information/0.22.110.23c|0.22.110.23c]]
| 1148
|-
| [[23a:Release information/0.22.110.23b|0.22.110.23b]]
| 1148
|-
| [[23a:Release information/0.22.110.23a|0.22.110.23a]]
| 1148
|-
| [[23a:Release information/0.22.110.22f|0.22.110.22f]]
| 1137
|-
| [[23a:Release information/0.22.110.22e|0.22.110.22e]]
| 1134
|-
| [[23a:Release information/0.22.110.22d|0.22.110.22d]]
| 1133
|-
| [[23a:Release information/0.22.110.22c|0.22.110.22c]]
| 1133
|-
| [[23a:Release information/0.22.110.22b|0.22.110.22b]]
| 1131
|-
| [[23a:Release information/0.22.110.22a|0.22.110.22a]]
| 1131
|-
| [[23a:Release information/0.22.107.21a|0.22.107.21a]]
| 1128
|-
| [[23a:Release information/0.21.105.21a|0.21.105.21a]]
| 1128
|-
| [[23a:Release information/0.21.104.21c|0.21.104.21c]]
| 1128
|-
| [[23a:Release information/0.21.104.21b|0.21.104.21b]]
| 1125
|-
| [[23a:Release information/0.21.104.21a|0.21.104.21a]]
| 1123
|-
| [[23a:Release information/0.21.104.19d|0.21.104.19d]]
| 1121
|-
| [[23a:Release information/0.21.104.19c|0.21.104.19c]]
| 1121
|-
| [[23a:Release information/0.21.104.19b|0.21.104.19b]]
| 1119
|-
| [[23a:Release information/0.21.104.19a|0.21.104.19a]]
| 1119
|-
| [[23a:Release information/0.21.102.19a|0.21.102.19a]]
| 1117
|-
| [[23a:Release information/0.21.101.19d|0.21.101.19d]]
| 1114
|-
| [[23a:Release information/0.21.101.19c|0.21.101.19c]]
| 1114
|-
| [[23a:Release information/0.21.101.19b|0.21.101.19b]]
| 1114
|-
| [[23a:Release information/0.21.101.19a|0.21.101.19a]]
| 1113
|-
| [[23a:Release information/0.21.100.19a|0.21.100.19a]]
| 1110
|-
| [[23a:Release information/0.21.95.19c|0.21.95.19c]]
| 1110
|-
| [[23a:Release information/0.21.95.19b|0.21.95.19b]]
| 1108
|-
| [[23a:Release information/0.21.95.19a|0.21.95.19a]]
| 1108
|-
| [[23a:Release information/0.21.93.19c|0.21.93.19c]]
| 1108
|-
| [[23a:Release information/0.21.93.19b|0.21.93.19b]]
| 1108
|-
| [[23a:Release information/0.21.93.19a|0.21.93.19a]]
| 1107
|}
[[Category:Game development]]
[[Category:Release information]]

Dodo

2026-07-07T17:35:04Z

Quietust:

{{Quality|Tattered}}
{{Creaturelookup/0
|image=dodo_sprites.png
|portrait=dodo_portrait_anim.gif
|wiki=Dodo}}
{{av}}
{{creaturedesc}}

{{D for dwarf}}

Small groups of dodos can be found on [[island]] [[beach]]es, where they were domesticated first by a lost population of terribly malformed [[troglodyte|humans]]. [[Animal trainer]]s traditionally first knock the dodo unconscious, then feed it purple berries or tiny [[Cook#Prepared Meal|biscuits]] to earn its trust.

{{gamedata}}
{{Creatures}}

Talk:Strange mood

2026-07-07T17:15:42Z

Quietust: /* Metalworker bar requirement */ another possibility

== Stonecutting ==

Stonecutting appears to be a moodable skill that will produce a stone craft. This does not appear in the current page.

Actually, I did some testing on Moodable Skills using DFHack, and found that Stonecutting is NOT a moodable skill (anymore).
A dwarf with Novice Stonecutter as his only skill will sometimes produce a stone craft, since the game still chooses Stone Crafter as one of the random crafting skills when the dwarf has no moodable skill. It's definitely selecting Stone Crafter, however, since a Fey Mood will give the dwarf Legendary Stone Crafter as a result, NOT Legendary Stonecutter.
[[User:Drake1500|Drake1500]] ([[User talk:Drake1500|talk]]) 01:18, 18 February 2024 (UTC)

== Bone requirement ==

At least in my testing, when the dwarf asks for bones, it won't just take random bone (stacks) from rotted parts from battle or random wild animals(for example).

I had to build a butcher's workshop and butcher an animal for the bone stack to count, so I think it's worth clarifying in case other people run into it, or I'm just completely misunderstanding how bone stacks work (in which case, again, I think it's worth explaining on this wiki page how to deal with this.

== Metalworker bar requirement ==

The wiki currently states a metalworker may demand a bar of a preferred metal IF you've smelted it already. However, it seems like they can also demand them if you have ore available (or, they might just demand whatever their preference is and me having ore on hand was just coincidence). I have exactly one copper toy so it's possible I either previously smelted a bar of copper or imported one, which if there is a restriction on what they can demand might be how the dwarf "knows" I can in theory provide copper. I also have steel, billum, and iron bars available, so it's not a lack of metal bars generally. It seems like the restriction listed here about what bars metalworkers demand is either wrong, or has some weird corner case.
[[Special:Contributions/24.56.251.207|24.56.251.207]] 08:37, 26 January 2023 (UTC)

Following up on this, I've got a dwarf with a secretive mood who according to DFHack (perhaps its installation plays a role in this bug? I don't know what changes it makes to Strange Mood Logic if any) is looking for 2 Nickel bars. At the point that the Strange Mood was instantiated I had only smelted Iron Bars, and currently have not managed to find a layer of Gabbro, let alone actually smelted any Nickel. I did just uncover my first cavern layer that included a number of pathways down to the next layer, so perhaps there is Garnierite technically available to a dwarf to walk to, but if that's the case that's deeply unfair.

--[[Special:Contributions/31.52.237.218|31.52.237.218]] 21:52, 6 July 2026 (UTC)
:Strange moods were never intended to be "fair" - you're '''supposed''' to have dwarves go insane and die when they demand items you can't obtain. That said, it's possible your game experienced memory corruption which resulted in the numbers corresponding to ``BAR:NONE:INORGANIC:NICKEL`` being added to the "itemmade" vectors (which is the same thing that caused some people to get strange moods demanding bars of '''ores''' instead of metals) - if you upload your savegame to the DF File Depot (or somewhere else), someone might be able to analyze it and see if that's what happened. Alternatively, it's possible you purchased a boulder of Garnierite from a Dwarven caravan, smelted it, used up the nickel bars, then forgot about it. --[[User:Quietust|Quietust]] ([[User talk:Quietust|talk]]) 16:50, 7 July 2026 (UTC)

== Kiln-related Strange mood never exist? ==

I just found that Kiln-related mood labor such as Glazer and Potter has never been said on this page, that's quite odd. Is Kiln-related Strange mood never implemented in Dwarf Fortress? I mean It does produce ceramic goods, does earthenware not an intriguing product at all?

Strange moods are based on the hardcoded production jobs, while pottery is done entirely by raw-based [[reaction]]s. That probably would explain why the strange mood code was left alone when pottery was implemented.

[[User:DPhKraken|DPhKraken]] ([[User talk:DPhKraken|talk]]) 04:04, 16 April 2024 (UTC)

== Fell moods - Require Updating ==

Toady answered a question on future of the fortress that revealed some information on fell moods.
http://www.bay12forums.com/smf/index.php?topic=169696.msg8481803#msg8481803

If a fell mood dwarf grabs an intelligent HFS person that uses a material considered "other", then the dwarf will use its material for constructing (shell) SCALED items. No matter what "other" materials the creature is made out of.

The only materials I've found on intelligent HFS creatures in the base game which haven't satisfied a fell mood dwarf thus far have been fluids. However, snow, which is a form of water, as a contaminant, can be a found as the primary material of HFS creatures, and this can be used. The resultant artifact produced from a snow creature will be listed as being made of ice.

Interestingly, ice artifacts produced from snow will not possess a fixed mat temperature unlike with artifacts produced from creature_mat fire materials, and will consequently physically melt / be destroyed if they are worn, or if the environment has a temperature above freezing.

Oddly though, a dwarf will not become a legendary bonecarver or leatherworker when producing an artifact from "other" materials, but will instead become a legendary woodcrafter. This may be due to a bug, or a possible oversight.

Also, fell mood dwarves can absolutely grab intelligent non-citizens for their artifact, based on lots of testing. So this also needs to be updated.

Although, I'm not certain about the range of creatures that can be grabbed during a fell mood. As its been suggested that [INTELLIGENT] isn't necessarily required, only some combination of [CAN_SPEAK] and [CAN_LEARN]. I'm unaware of the specifics though.

== Stonecutter / Stone Carver no longer moodable ==

I did a bunch of testing through DFHack to check if the moodable skills are still accurate, here was my process and results:

1) select a dwarf that hadn't gotten a mood before
2) Use DFHack assign-skills --reset to clear their skills
3) Use DFHack assign-skills to modify his skills such that no skill he had was the same rank as any other
4) Force a mood with strangemood --unit --force --type fey (so that it's the one dwarf I selected, and it would be a fey mood so I could see the XP gain)
5) Check which skill became Legendary
6) rinse, repeat

I checked every skill in the following Professions:
-Miner
-Woodworker
-Stoneworker
-Ranger
-Farmer
-Fishery Worker
-Metalsmith
-Jeweler
-Craftsdwarf
-Engineer

For skills that I suspected weren't Moodable, I intentionally gave them a higher rank than the skill I was expecting to have a Mood for (nothing higher than rank 10, Accomplished). I did this for every skill that wasn't previously Moodable.
In order to verify that my results weren't being skewed by the dwarf's previous profession (since the profession name didn't update immediately), I checked with a known Moodable skill on a dwarf with another Profession.
End result was that the current list was accurate, EXCEPT that Stonecutter and Stone Carver did NOT get a Mood.
In order to verify that the DFHack utility wasn't interfering with the skill selected for the Mood, I reset to my start point and modified EVERY Dwarf's skills so that they were ALL Master Stone Carvers and then let the game run until I got my next Mood. Result: unfortunately, a dwarf got Possessed, so no XP gain, but they did claim a Stoneworker's Workshop and craft an artifact Scepter, so it looks like Stone Crafting was used.

Therefore, I'm editing the main page to reflect my results. If anyone disagrees with my methodology, please feel free to correct me. I'm posting this here as evidence for why I'm making this change.
[[User:Drake1500|Drake1500]] ([[User talk:Drake1500|talk]]) 01:48, 18 February 2024 (UTC)
: The DFHack "strangemood" command is based on '''reverse-engineered''' logic from the game itself, and it has ''not'' been updated to match the behavior in the current version, so further research might be necessary. At the very least, I'll be taking a closer look at the current version and seeing what needs to be updated in the plugin. --[[User:Quietust|Quietust]] ([[User talk:Quietust|talk]]) 14:39, 18 February 2024 (UTC)
:: After taking a closer look, I can confirm that CUT_STONE and CARVE_STONE '''are''' moodable skills, and dwarves having them will be assigned the same "Strange Mood" job as Miners and Masons (which is what decides the type of workshop they claim), thus I have reverted your changes to the article. The flaw in your methodology lies in the fact that the DFHack "strangemood" command actually decides which skill is going to be boosted at the end of the mood, and because the plugin wasn't recognizing those skills as moodable, your test units never gained experience in them. Furthermore, both of those skills are '''new''' to version 50.xx, so it would be quite strange for them to have been removed already. --[[User:Quietust|Quietust]] ([[User talk:Quietust|talk]]) 18:12, 18 February 2024 (UTC)
::: Thanks for looking into this, I hadn't expected Stone Carving to operate like Mining. As stated, I did try to account for that by allowing a "natural" mood after modifying skills, but since it was a possession, I couldn't see which skill was actually used. Thanks again for the correction! [[User:Drake1500|Drake1500]] ([[User talk:Drake1500|talk]]) 22:05, 19 February 2024 (UTC)

== Contradiction on skill gained ==

In the "Skills and workshops" section it says that "completion of the artifact grants roughly 10,000 experience in that skill. This will transform a previously unskilled dwarf to one of Accomplished-level (on average)." However, later on it says that "the mood will raise the dwarf to Legendary in the chosen skill". Which is correct?
--[[User:Zzedar|Zzedar]] ([[User talk:Zzedar|talk]]) 18:49, 30 December 2025 (UTC)
:The first one is (supposedly) correct - the second one '''used''' to be correct back in version 0.47.05 and earlier (when strange moods granted 20,000 points of experience). --[[User:Quietust|Quietust]] ([[User talk:Quietust|talk]]) 22:16, 30 December 2025 (UTC)
::Actually a two-year old dwarven child (with a fey mood) did just get 20,000 exp in mining for the completion of an artifact. Boosting her skill level from adequate (with 16 exp on that level and some rust) to "legendary1" and 1116 exp. [[Special:Contributions/87.143.77.206|87.143.77.206]] 03:33, 14 January 2026 (UTC)
:::So, this is interesting - I just took at look at version 53.08, and that version grants the same 20,000 experience points as the game always has. So now I'm rather confused - why are people reporting that they give less experience now? --[[User:Quietust|Quietust]] ([[User talk:Quietust|talk]]) 03:54, 14 January 2026 (UTC)
::::I've come to the conclusion that the [https://dwarffortresswiki.org/index.php?title=Strange_mood&diff=295681&oldid=294708 original edit] in which the experience gain was dropped to 10,000 was '''erroneous''', possibly resulting from somebody using a game mod that they didn't understand. The related changes have been reverted. --[[User:Quietust|Quietust]] ([[User talk:Quietust|talk]]) 12:41, 14 January 2026 (UTC)
:: Playing vanilla, just had a moody dabbling weaponsmith jump from skill 0 to Lvl 16(+), which [[Experience#Reported_Experience|exactly fits with 20,000 xp]], in support of that figure. --[[User:Albedo|Albedo]] ([[User talk:Albedo|talk]]) 06:29, 17 January 2026 (UTC)

Talk:Strange mood

2026-07-07T16:50:47Z

Quietust: /* Metalworker bar requirement */

== Stonecutting ==

Stonecutting appears to be a moodable skill that will produce a stone craft. This does not appear in the current page.

Actually, I did some testing on Moodable Skills using DFHack, and found that Stonecutting is NOT a moodable skill (anymore).
A dwarf with Novice Stonecutter as his only skill will sometimes produce a stone craft, since the game still chooses Stone Crafter as one of the random crafting skills when the dwarf has no moodable skill. It's definitely selecting Stone Crafter, however, since a Fey Mood will give the dwarf Legendary Stone Crafter as a result, NOT Legendary Stonecutter.
[[User:Drake1500|Drake1500]] ([[User talk:Drake1500|talk]]) 01:18, 18 February 2024 (UTC)

== Bone requirement ==

At least in my testing, when the dwarf asks for bones, it won't just take random bone (stacks) from rotted parts from battle or random wild animals(for example).

I had to build a butcher's workshop and butcher an animal for the bone stack to count, so I think it's worth clarifying in case other people run into it, or I'm just completely misunderstanding how bone stacks work (in which case, again, I think it's worth explaining on this wiki page how to deal with this.

== Metalworker bar requirement ==

The wiki currently states a metalworker may demand a bar of a preferred metal IF you've smelted it already. However, it seems like they can also demand them if you have ore available (or, they might just demand whatever their preference is and me having ore on hand was just coincidence). I have exactly one copper toy so it's possible I either previously smelted a bar of copper or imported one, which if there is a restriction on what they can demand might be how the dwarf "knows" I can in theory provide copper. I also have steel, billum, and iron bars available, so it's not a lack of metal bars generally. It seems like the restriction listed here about what bars metalworkers demand is either wrong, or has some weird corner case.
[[Special:Contributions/24.56.251.207|24.56.251.207]] 08:37, 26 January 2023 (UTC)

Following up on this, I've got a dwarf with a secretive mood who according to DFHack (perhaps its installation plays a role in this bug? I don't know what changes it makes to Strange Mood Logic if any) is looking for 2 Nickel bars. At the point that the Strange Mood was instantiated I had only smelted Iron Bars, and currently have not managed to find a layer of Gabbro, let alone actually smelted any Nickel. I did just uncover my first cavern layer that included a number of pathways down to the next layer, so perhaps there is Garnierite technically available to a dwarf to walk to, but if that's the case that's deeply unfair.

--[[Special:Contributions/31.52.237.218|31.52.237.218]] 21:52, 6 July 2026 (UTC)
:Strange moods were never intended to be "fair" - you're '''supposed''' to have dwarves go insane and die when they demand items you can't obtain. That said, it's possible your game experienced memory corruption which resulted in the numbers corresponding to ``BAR:NONE:INORGANIC:NICKEL`` being added to the "itemmade" vectors (which is the same thing that caused some people to get strange moods demanding bars of '''ores''' instead of metals) - if you upload your savegame to the DF File Depot (or somewhere else), someone might be able to analyze it and see if that's what happened. --[[User:Quietust|Quietust]] ([[User talk:Quietust|talk]]) 16:50, 7 July 2026 (UTC)

== Kiln-related Strange mood never exist? ==

I just found that Kiln-related mood labor such as Glazer and Potter has never been said on this page, that's quite odd. Is Kiln-related Strange mood never implemented in Dwarf Fortress? I mean It does produce ceramic goods, does earthenware not an intriguing product at all?

Strange moods are based on the hardcoded production jobs, while pottery is done entirely by raw-based [[reaction]]s. That probably would explain why the strange mood code was left alone when pottery was implemented.

[[User:DPhKraken|DPhKraken]] ([[User talk:DPhKraken|talk]]) 04:04, 16 April 2024 (UTC)

== Fell moods - Require Updating ==

Toady answered a question on future of the fortress that revealed some information on fell moods.
http://www.bay12forums.com/smf/index.php?topic=169696.msg8481803#msg8481803

If a fell mood dwarf grabs an intelligent HFS person that uses a material considered "other", then the dwarf will use its material for constructing (shell) SCALED items. No matter what "other" materials the creature is made out of.

The only materials I've found on intelligent HFS creatures in the base game which haven't satisfied a fell mood dwarf thus far have been fluids. However, snow, which is a form of water, as a contaminant, can be a found as the primary material of HFS creatures, and this can be used. The resultant artifact produced from a snow creature will be listed as being made of ice.

Interestingly, ice artifacts produced from snow will not possess a fixed mat temperature unlike with artifacts produced from creature_mat fire materials, and will consequently physically melt / be destroyed if they are worn, or if the environment has a temperature above freezing.

Oddly though, a dwarf will not become a legendary bonecarver or leatherworker when producing an artifact from "other" materials, but will instead become a legendary woodcrafter. This may be due to a bug, or a possible oversight.

Also, fell mood dwarves can absolutely grab intelligent non-citizens for their artifact, based on lots of testing. So this also needs to be updated.

Although, I'm not certain about the range of creatures that can be grabbed during a fell mood. As its been suggested that [INTELLIGENT] isn't necessarily required, only some combination of [CAN_SPEAK] and [CAN_LEARN]. I'm unaware of the specifics though.

== Stonecutter / Stone Carver no longer moodable ==

I did a bunch of testing through DFHack to check if the moodable skills are still accurate, here was my process and results:

1) select a dwarf that hadn't gotten a mood before
2) Use DFHack assign-skills --reset to clear their skills
3) Use DFHack assign-skills to modify his skills such that no skill he had was the same rank as any other
4) Force a mood with strangemood --unit --force --type fey (so that it's the one dwarf I selected, and it would be a fey mood so I could see the XP gain)
5) Check which skill became Legendary
6) rinse, repeat

I checked every skill in the following Professions:
-Miner
-Woodworker
-Stoneworker
-Ranger
-Farmer
-Fishery Worker
-Metalsmith
-Jeweler
-Craftsdwarf
-Engineer

For skills that I suspected weren't Moodable, I intentionally gave them a higher rank than the skill I was expecting to have a Mood for (nothing higher than rank 10, Accomplished). I did this for every skill that wasn't previously Moodable.
In order to verify that my results weren't being skewed by the dwarf's previous profession (since the profession name didn't update immediately), I checked with a known Moodable skill on a dwarf with another Profession.
End result was that the current list was accurate, EXCEPT that Stonecutter and Stone Carver did NOT get a Mood.
In order to verify that the DFHack utility wasn't interfering with the skill selected for the Mood, I reset to my start point and modified EVERY Dwarf's skills so that they were ALL Master Stone Carvers and then let the game run until I got my next Mood. Result: unfortunately, a dwarf got Possessed, so no XP gain, but they did claim a Stoneworker's Workshop and craft an artifact Scepter, so it looks like Stone Crafting was used.

Therefore, I'm editing the main page to reflect my results. If anyone disagrees with my methodology, please feel free to correct me. I'm posting this here as evidence for why I'm making this change.
[[User:Drake1500|Drake1500]] ([[User talk:Drake1500|talk]]) 01:48, 18 February 2024 (UTC)
: The DFHack "strangemood" command is based on '''reverse-engineered''' logic from the game itself, and it has ''not'' been updated to match the behavior in the current version, so further research might be necessary. At the very least, I'll be taking a closer look at the current version and seeing what needs to be updated in the plugin. --[[User:Quietust|Quietust]] ([[User talk:Quietust|talk]]) 14:39, 18 February 2024 (UTC)
:: After taking a closer look, I can confirm that CUT_STONE and CARVE_STONE '''are''' moodable skills, and dwarves having them will be assigned the same "Strange Mood" job as Miners and Masons (which is what decides the type of workshop they claim), thus I have reverted your changes to the article. The flaw in your methodology lies in the fact that the DFHack "strangemood" command actually decides which skill is going to be boosted at the end of the mood, and because the plugin wasn't recognizing those skills as moodable, your test units never gained experience in them. Furthermore, both of those skills are '''new''' to version 50.xx, so it would be quite strange for them to have been removed already. --[[User:Quietust|Quietust]] ([[User talk:Quietust|talk]]) 18:12, 18 February 2024 (UTC)
::: Thanks for looking into this, I hadn't expected Stone Carving to operate like Mining. As stated, I did try to account for that by allowing a "natural" mood after modifying skills, but since it was a possession, I couldn't see which skill was actually used. Thanks again for the correction! [[User:Drake1500|Drake1500]] ([[User talk:Drake1500|talk]]) 22:05, 19 February 2024 (UTC)

== Contradiction on skill gained ==

In the "Skills and workshops" section it says that "completion of the artifact grants roughly 10,000 experience in that skill. This will transform a previously unskilled dwarf to one of Accomplished-level (on average)." However, later on it says that "the mood will raise the dwarf to Legendary in the chosen skill". Which is correct?
--[[User:Zzedar|Zzedar]] ([[User talk:Zzedar|talk]]) 18:49, 30 December 2025 (UTC)
:The first one is (supposedly) correct - the second one '''used''' to be correct back in version 0.47.05 and earlier (when strange moods granted 20,000 points of experience). --[[User:Quietust|Quietust]] ([[User talk:Quietust|talk]]) 22:16, 30 December 2025 (UTC)
::Actually a two-year old dwarven child (with a fey mood) did just get 20,000 exp in mining for the completion of an artifact. Boosting her skill level from adequate (with 16 exp on that level and some rust) to "legendary1" and 1116 exp. [[Special:Contributions/87.143.77.206|87.143.77.206]] 03:33, 14 January 2026 (UTC)
:::So, this is interesting - I just took at look at version 53.08, and that version grants the same 20,000 experience points as the game always has. So now I'm rather confused - why are people reporting that they give less experience now? --[[User:Quietust|Quietust]] ([[User talk:Quietust|talk]]) 03:54, 14 January 2026 (UTC)
::::I've come to the conclusion that the [https://dwarffortresswiki.org/index.php?title=Strange_mood&diff=295681&oldid=294708 original edit] in which the experience gain was dropped to 10,000 was '''erroneous''', possibly resulting from somebody using a game mod that they didn't understand. The related changes have been reverted. --[[User:Quietust|Quietust]] ([[User talk:Quietust|talk]]) 12:41, 14 January 2026 (UTC)
:: Playing vanilla, just had a moody dabbling weaponsmith jump from skill 0 to Lvl 16(+), which [[Experience#Reported_Experience|exactly fits with 20,000 xp]], in support of that figure. --[[User:Albedo|Albedo]] ([[User talk:Albedo|talk]]) 06:29, 17 January 2026 (UTC)